Documentum : Diagnostic DFC configuration, localization log4j.propeties, dfc.properties

Hello,

CLIENT SIDE
Everybody has already been confronted with problem of localization of log4j.properties or dfc.properties files used on runtime. The DFC configuration files like log4j.properties and dfc.properties are located through the classpath found in WAR files and EAR files. More, for information, there are several possibilities to point to dfc.properties file:

• Include Statement
  A dfc.properties can contain an include statement pointing at the external configuration:
  #include d:/projects/javalu/config/dfc.properties:

  It is also possible to use hybrid approaches by including several files and/or appending/overwriting the parameters in application’s dfc.properties:
  #include d:/projects/javalu/config/common/dfc.properties
#include d:/projects/javalu/config/specific/dfc.properties # may or may not override
# may or may not override

   
• Set the system property in code
  view source

  print?

  1	// Set dfc.properties file

  2	System.setProperty("dfc.properties.file","d:/projects/javalu/config/dfc.properties");

  3

  4	// Create client object

  5	IDfClient client = DfClient.getLocalClient(); // new DfClient();

  6

  // ...

   

• Set the system property in the command line (or in VM arguments in IDE Eclipse)
  view source

  print?

  1	C:\>java -classpath "..." –Ddfc.properties.file=d:/projects/javalu/config/dfc.properties ...

   

• Set the system property in Application Server Configuration
  For Tomcat, the configuration file is catalina.bat:
  view source

  print?

  1

  ...

  2	rem ============= ADD MEMORY

  3	SET JAVA_OPTS=%JAVA_OPTS% -Xms1024m -Xmx1024m -XX:MaxPermSize=128m

  4

  ...

  5	rem ============= SET DFC DIAGNOSTIC

  6	SET JAVA_OPTS=%JAVA_OPTS% –Ddfc.properties.file=d:/projects/javalu/config/dfc.properties

   

So, there is a simple way to find out what configuration files are used in DFC CLIENT application : set Java system property dfc.diagnose_config to true in order to print out the file paths of log4j, dfc, and dbor configuration files to the standard output stream like the following:

or

 
There are several ways to set the Java system property:

• Set the system property in code
  view source

  print?

  1	// Set the diagnostic mode

  2	System.setProperty("dfc.diagnose_config","true");

  3

  4	// Create client object

  5	IDfClient client = DfClient.getLocalClient(); // new DfClient();

  6

  // ...

   

• Set the system property in the command line (or in VM arguments in IDE Eclipse)
  This system property must be added to the command line of during DFC invocation:
  view source

  print?

  1	C:\>java -classpath "..." -Ddfc.diagnose_config=true

   

• Set the system property in Application Server Configuration
  For Tomcat, this file is catalina.bat:
  view source

  print?

  1

  ...

  2	rem ============= ADD MEMORY

  3	SET JAVA_OPTS=%JAVA_OPTS% -Xms1024m -Xmx1024m -XX:MaxPermSize=128m

  4

  ...

  5	rem ============= SET DFC DIAGNOSTIC

  6	SET JAVA_OPTS=%JAVA_OPTS% -Ddfc.diagnose_config=true

   

 
 
SERVER SIDE
On server side, there is also dfc.properties for example in Java Server Method (JMS):

• UNIX : /opt/dctm/product/7.1/dfc_shared/jboss7.1.1/server/
  DctmServer_MethodServer/deployments/ServerApps.ear/APP-INF/classes
• WINDOWS : D:\Documentum\jboss7.1.1\server\
  DctmServer_MethodServer\deployments\ServerApps.ear\APP-INF\classes

 
…this dfc.properties contains an include statement pointing at the external configuration:
#include /opt/dctm/product/7.1/dfc_shared/config/dfc.properties

 
… the pointed dfc.properties in /opt/dctm/product/7.1/dfc_shared/config/dfc.properties contains the parameters:

That’s all!!!

Huseyin OZVEREN