{"id":9101,"date":"2016-12-20T08:00:24","date_gmt":"2016-12-20T07:00:24","guid":{"rendered":"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/"},"modified":"2016-12-20T08:00:24","modified_gmt":"2016-12-20T07:00:24","slug":"documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log","status":"publish","type":"post","link":"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/","title":{"rendered":"Documentum story \u2013 How to avoid \u201cDFC_FILE_LOCK_ACQUIRE_WARN\u201d messages in Java Method Server (jms) LOG"},"content":{"rendered":"<p>After upgrading from 6.7.x to 7.2, the following warning message is logged in JMS log files: com.documentum.fc.common.DfNewInterprocessLockImpl &#8211; [DFC_FILE_LOCK_ACQUIRE_WARN] Failed to acquire lock proceeding ahead with no lock java.nio.channels.OverlappingFileLockException at sun.nio.ch.SharedFileLockTable.checkList FileLockTable.java:255)<\/p>\n<p>By default ACS and ServerApp dfc.properties are pointing to $DOCUMENTUM_SHARED\/config\/dfc.properties.<\/p>\n<p>Adding separate &#8216;dfc.data.dir&#8217; cache folder location in ACS and ServerApp dfc.properties.<br \/>\nAfter JAVA Method Server restart, two separate cache folders are created inside $DOCUMENTUM_SHARED\/jboss7.1.1\/server and then, WARNING messages had gone from acs.log.<\/p>\n<p>In fact, this is just a warning that someone else has acquired lock on the physical file (in this case it is dfc.keystore).\u00a0 Since ServerApps (Method Server) and ACS are invoking DFC simultaneously and both try to acquire lock on dfc.keystore file and Java throws OverlappingFileLockException. Then DFC warns that it could not lock the file and proceeds without lock. Ideally this should be just info message in this case, where file lock is acquired for read-only. But the same logic is used by other functionality like registry update and BOF Cache update, where this failure should be treated as genuine warning or error. Going forward, engineering will have to correct this code by taking appropriate actions for each functionality. There is no functional impact to use different data directory folder.<\/p>\n<p>Please proceed as below to solve It:<\/p>\n<ul>\n<li>Login to the Content Server<\/li>\n<li>Change the current user to dmadmin :(administrator account)<\/li>\n<li>Create some folders using:<\/li>\n<\/ul>\n<pre class=\"brush: shell; gutter: true; first-line: 1\"> mkdir $DOCUMENTUM_SHARED\/acs\n mkdir $DOCUMENTUM_SHARED\/ServerApps\n mkdir $DOCUMENTUM_SHARED\/bpm<\/pre>\n<p>&nbsp;<\/p>\n<ul>\n<li>Update all necessary dfc.properties files (with vi editor):<\/li>\n<\/ul>\n<p>===============================================================================================================================<\/p>\n<h5>$DOCUMENTUM_SHARED\/jboss7.1.1\/server\/DctmServer_MethodServer\/deployments\/acs.ear\/lib\/configs.jar\/dfc.properties<\/h5>\n<p>\u21d2 Add at the end of this file the following line:<\/p>\n<pre class=\"brush: actionscript3; gutter: true; first-line: 1\">dfc.data.dir=$DOCUMENTUM_SHARED\/acs<\/pre>\n<p>===============================================================================================================================<\/p>\n<h5>$DOCUMENTUM_SHARED\/jboss7.1.1\/server\/DctmServer_MethodServer\/deployments\/ServerApps.ear\/APP-INF\/classes\/dfc.properties<\/h5>\n<p>\u21d2 Add at the end of this file the following line:<\/p>\n<pre class=\"brush: shell; gutter: true; first-line: 1\">dfc.data.dir=$DOCUMENTUM_SHARED\/ServerApps<\/pre>\n<p>===============================================================================================================================<\/p>\n<h5>$DOCUMENTUM_SHARED\/jboss7.1.1\/server\/DctmServer_MethodServer\/deployments\/bpm.ear\/APP-INF\/classes\/dfc.properties<\/h5>\n<p>\u21d2 Add at the end of this file the following line:<\/p>\n<pre class=\"brush: shell; gutter: true; first-line: 1\">dfc.data.dir=$DOCUMENTUM_SHARED\/bpm<\/pre>\n<p>===============================================================================================================================<\/p>\n<ul>\n<li>Verify that the recently created folders are empty using:<\/li>\n<\/ul>\n<pre class=\"brush: shell; gutter: true; first-line: 1\">cd $DOCUMENTUM_SHARED\nls -l acs\/ ServerApps\/ bpm\/<\/pre>\n<p>&nbsp;<\/p>\n<ul>\n<li>Restart the JMS using:<\/li>\n<\/ul>\n<pre class=\"brush: shell; gutter: true; first-line: 1\">sh -c \"cd $DOCUMENTUM_SHARED\/jboss7.1.1\/server;.\/stopMethodServer.sh\"\nsh -c \"$DOCUMENTUM_SHARED\/jboss7.1.1\/server\/startMethodServer.sh\"<\/pre>\n<p>&nbsp;<\/p>\n<h3>Verification<\/h3>\n<ul>\n<li>Verify that the recently created folders are now populated with default files and folders using:<\/li>\n<\/ul>\n<pre class=\"brush: shell; gutter: true; first-line: 1\">cd $DOCUMENTUM_SHARED\nls -l acs\/ ServerApps\/ bpm\/<\/pre>\n<p>Files must not be empty now.<\/p>\n<ul>\n<li>Disconnect from the Content Server.<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<p>Using this procedure, you won&#8217;t see this WARNING message anymore.<br \/>\nRegards,<\/p>\n","protected":false},"excerpt":{"rendered":"<p>After upgrading from 6.7.x to 7.2, the following warning message is logged in JMS log files: com.documentum.fc.common.DfNewInterprocessLockImpl &#8211; [DFC_FILE_LOCK_ACQUIRE_WARN] Failed to acquire lock proceeding ahead with no lock java.nio.channels.OverlappingFileLockException at sun.nio.ch.SharedFileLockTable.checkList FileLockTable.java:255) By default ACS and ServerApp dfc.properties are pointing to $DOCUMENTUM_SHARED\/config\/dfc.properties. Adding separate &#8216;dfc.data.dir&#8217; cache folder location in ACS and ServerApp dfc.properties. After JAVA [&hellip;]<\/p>\n","protected":false},"author":40,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[525],"tags":[129,960,903,481,44,961],"type_dbi":[],"class_list":["post-9101","post","type-post","status-publish","format-standard","hentry","category-enterprise-content-management","tag-documentum","tag-java-method-server","tag-jms","tag-lock","tag-troubleshooting","tag-warn"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v27.2 (Yoast SEO v27.2) - https:\/\/yoast.com\/product\/yoast-seo-premium-wordpress\/ -->\n<title>Documentum story \u2013 How to avoid \u201cDFC_FILE_LOCK_ACQUIRE_WARN\u201d messages in Java Method Server (jms) LOG - dbi Blog<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Documentum story \u2013 How to avoid \u201cDFC_FILE_LOCK_ACQUIRE_WARN\u201d messages in Java Method Server (jms) LOG\" \/>\n<meta property=\"og:description\" content=\"After upgrading from 6.7.x to 7.2, the following warning message is logged in JMS log files: com.documentum.fc.common.DfNewInterprocessLockImpl &#8211; [DFC_FILE_LOCK_ACQUIRE_WARN] Failed to acquire lock proceeding ahead with no lock java.nio.channels.OverlappingFileLockException at sun.nio.ch.SharedFileLockTable.checkList FileLockTable.java:255) By default ACS and ServerApp dfc.properties are pointing to $DOCUMENTUM_SHARED\/config\/dfc.properties. Adding separate &#8216;dfc.data.dir&#8217; cache folder location in ACS and ServerApp dfc.properties. After JAVA [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/\" \/>\n<meta property=\"og:site_name\" content=\"dbi Blog\" \/>\n<meta property=\"article:published_time\" content=\"2016-12-20T07:00:24+00:00\" \/>\n<meta name=\"author\" content=\"Middleware Team\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Middleware Team\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/\"},\"author\":{\"name\":\"Middleware Team\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/8d8563acfc6e604cce6507f45bac0ea1\"},\"headline\":\"Documentum story \u2013 How to avoid \u201cDFC_FILE_LOCK_ACQUIRE_WARN\u201d messages in Java Method Server (jms) LOG\",\"datePublished\":\"2016-12-20T07:00:24+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/\"},\"wordCount\":410,\"commentCount\":0,\"keywords\":[\"Documentum\",\"Java Method Server\",\"jms\",\"lock\",\"Troubleshooting\",\"WARN\"],\"articleSection\":[\"Enterprise content management\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/\",\"url\":\"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/\",\"name\":\"Documentum story \u2013 How to avoid \u201cDFC_FILE_LOCK_ACQUIRE_WARN\u201d messages in Java Method Server (jms) LOG - dbi Blog\",\"isPartOf\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#website\"},\"datePublished\":\"2016-12-20T07:00:24+00:00\",\"author\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/8d8563acfc6e604cce6507f45bac0ea1\"},\"breadcrumb\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accueil\",\"item\":\"https:\/\/www.dbi-services.com\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Documentum story \u2013 How to avoid \u201cDFC_FILE_LOCK_ACQUIRE_WARN\u201d messages in Java Method Server (jms) LOG\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#website\",\"url\":\"https:\/\/www.dbi-services.com\/blog\/\",\"name\":\"dbi Blog\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.dbi-services.com\/blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/8d8563acfc6e604cce6507f45bac0ea1\",\"name\":\"Middleware Team\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/secure.gravatar.com\/avatar\/ddcae7ba0f9d1a0e7ae707f0e689e4a9c95bb48ec49c8e6d9cc86d43f4121cb6?s=96&d=mm&r=g\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/ddcae7ba0f9d1a0e7ae707f0e689e4a9c95bb48ec49c8e6d9cc86d43f4121cb6?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/ddcae7ba0f9d1a0e7ae707f0e689e4a9c95bb48ec49c8e6d9cc86d43f4121cb6?s=96&d=mm&r=g\",\"caption\":\"Middleware Team\"},\"url\":\"https:\/\/www.dbi-services.com\/blog\/author\/middleware-team\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Documentum story \u2013 How to avoid \u201cDFC_FILE_LOCK_ACQUIRE_WARN\u201d messages in Java Method Server (jms) LOG - dbi Blog","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/","og_locale":"en_US","og_type":"article","og_title":"Documentum story \u2013 How to avoid \u201cDFC_FILE_LOCK_ACQUIRE_WARN\u201d messages in Java Method Server (jms) LOG","og_description":"After upgrading from 6.7.x to 7.2, the following warning message is logged in JMS log files: com.documentum.fc.common.DfNewInterprocessLockImpl &#8211; [DFC_FILE_LOCK_ACQUIRE_WARN] Failed to acquire lock proceeding ahead with no lock java.nio.channels.OverlappingFileLockException at sun.nio.ch.SharedFileLockTable.checkList FileLockTable.java:255) By default ACS and ServerApp dfc.properties are pointing to $DOCUMENTUM_SHARED\/config\/dfc.properties. Adding separate &#8216;dfc.data.dir&#8217; cache folder location in ACS and ServerApp dfc.properties. After JAVA [&hellip;]","og_url":"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/","og_site_name":"dbi Blog","article_published_time":"2016-12-20T07:00:24+00:00","author":"Middleware Team","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Middleware Team","Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/#article","isPartOf":{"@id":"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/"},"author":{"name":"Middleware Team","@id":"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/8d8563acfc6e604cce6507f45bac0ea1"},"headline":"Documentum story \u2013 How to avoid \u201cDFC_FILE_LOCK_ACQUIRE_WARN\u201d messages in Java Method Server (jms) LOG","datePublished":"2016-12-20T07:00:24+00:00","mainEntityOfPage":{"@id":"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/"},"wordCount":410,"commentCount":0,"keywords":["Documentum","Java Method Server","jms","lock","Troubleshooting","WARN"],"articleSection":["Enterprise content management"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/","url":"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/","name":"Documentum story \u2013 How to avoid \u201cDFC_FILE_LOCK_ACQUIRE_WARN\u201d messages in Java Method Server (jms) LOG - dbi Blog","isPartOf":{"@id":"https:\/\/www.dbi-services.com\/blog\/#website"},"datePublished":"2016-12-20T07:00:24+00:00","author":{"@id":"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/8d8563acfc6e604cce6507f45bac0ea1"},"breadcrumb":{"@id":"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.dbi-services.com\/blog\/documentum-story-how-to-avoid-dfc_file_lock_acquire_warn-messages-in-java-method-server-jms-log\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Accueil","item":"https:\/\/www.dbi-services.com\/blog\/"},{"@type":"ListItem","position":2,"name":"Documentum story \u2013 How to avoid \u201cDFC_FILE_LOCK_ACQUIRE_WARN\u201d messages in Java Method Server (jms) LOG"}]},{"@type":"WebSite","@id":"https:\/\/www.dbi-services.com\/blog\/#website","url":"https:\/\/www.dbi-services.com\/blog\/","name":"dbi Blog","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.dbi-services.com\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/8d8563acfc6e604cce6507f45bac0ea1","name":"Middleware Team","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/ddcae7ba0f9d1a0e7ae707f0e689e4a9c95bb48ec49c8e6d9cc86d43f4121cb6?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/ddcae7ba0f9d1a0e7ae707f0e689e4a9c95bb48ec49c8e6d9cc86d43f4121cb6?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/ddcae7ba0f9d1a0e7ae707f0e689e4a9c95bb48ec49c8e6d9cc86d43f4121cb6?s=96&d=mm&r=g","caption":"Middleware Team"},"url":"https:\/\/www.dbi-services.com\/blog\/author\/middleware-team\/"}]}},"_links":{"self":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/posts\/9101","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/users\/40"}],"replies":[{"embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/comments?post=9101"}],"version-history":[{"count":0,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/posts\/9101\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/media?parent=9101"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/categories?post=9101"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/tags?post=9101"},{"taxonomy":"type","embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/type_dbi?post=9101"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}