If you are working with Documentum for quite some time, you are probably familiar with the logback.xml file that can be used to configure the D2 logs. In this blog, I will be talking only about the Content Server side of this configuration. As you probably know, Documentum upgraded the JMS to use JBoss 7.1.1\u00a0“recently” (several years already)\u00a0and even WildFly9.0.1 with the CS 7.3+. On this blog, I will only use “JBoss” but it refers to both JBoss\u00a0and WildFly versions.\u00a0\u00a0With these recent versions, the logback.xml file stopped working on linux environments (I’m not sure about Windows, I only work on linux). Therefore you will face an issue: the D2 JMS logs cannot really be configured properly, by default. Of course you will still be able to configure the JBoss and JMS logs properly because that is done through the logging.properties file (for the boot.log), through the standalone.xml file (for the server.log) and through all log4j.properties files for each JMS Applications (ServerApps, ACS, BPM, aso…). But if you are using D2, then all the D2 JMS logs (previously stored on D2-JMS.log) will also be added to the server.log as well a console output.<\/p>\n
Unfortunately for us, the D2 JMS logs are using DEBUG by default for everything so it might represent some big files at the end of the day as soon as you start working more than XXX concurrent users. Worse than that, the D2 JMS logs, which are in DEBUG, are considered as INFO from the JBoss point of view and therefore, if you are using JBoss with INFO log level, it will print all the DEBUG information from the D2 JMS logs. Of course you could still set the JBoss level to WARN so it would remove all the DEBUG but in this case, you will also be missing the INFO from the JBoss as well as the D2 JMS sides which might include some pretty important information like for example the assurance that the D2.Lockbox can be read properly (no problems with the passwords and\/or fingerprint).<\/p>\n
So what to do about it? Well there is a JVM parameter that can actually be used to force the JBoss Server to read and use a specific logback.xml file. For that, simply update the startMethodServer.sh script as done below. I will use the logback.xml file that is present by default right under ServerApps.ear and that I will customize to get the best out of it.<\/p>\n
First of all, I’m updating the content to add some things. Here is a template for this file:<\/p>\n
[dmadmin@content_server_01 ~]$ cd $DOCUMENTUM_SHARED\/wildfly9.0.1\/server\/\n[dmadmin@content_server_01 server]$ logback_file=\"$DOCUMENTUM_SHARED\/wildfly9.0.1\/server\/DctmServer_MethodServer\/deployments\/ServerApps.ear\/logback.xml\"\n[dmadmin@content_server_01 server]$ \n[dmadmin@content_server_01 server]$ # Here I'm updating the content of the default file to add custom patterns, log level, console output, aso...\n[dmadmin@content_server_01 server]$ vi ${logback_file}\n[dmadmin@content_server_01 server]$ \n[dmadmin@content_server_01 server]$ cat ${logback_file}\n<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n\n<configuration scan=\"true\" scanPeriod=\"60 seconds\">\n\n <appender class=\"ch.qos.logback.core.rolling.RollingFileAppender\" name=\"RootFileAppender\">\n <file>\/tmp\/D2-JMS.log<\/file>\n <append>true<\/append>\n <filter class=\"ch.qos.logback.classic.filter.ThresholdFilter\">\n <level>debug<\/level>\n <\/filter>\n <rollingPolicy class=\"ch.qos.logback.core.rolling.TimeBasedRollingPolicy\">\n <fileNamePattern>\/tmp\/D2-JMS-%d{yyyy-MM-dd}.log.zip<\/fileNamePattern>\n <MaxHistory>5<\/MaxHistory>\n <\/rollingPolicy>\n <layout class=\"ch.qos.logback.classic.PatternLayout\">\n <pattern>%d{\"yyyy-MM-dd HH:mm:ss,SSS z\"} [%-5p] (%t) - %-45(%C{44}) : %m%n<\/pattern>\n <\/layout>\n <\/appender>\n\n <appender class=\"ch.qos.logback.core.ConsoleAppender\" name=\"RootConsoleAppender\">\n <layout>\n <pattern>[%-5p] - %-45(%C{44}) : %m%n<\/pattern>\n <\/layout>\n <\/appender>\n\n <root>\n <level value=\"${logLevel:-info}\"\/>\n <appender-ref ref=\"RootFileAppender\"\/>\n <appender-ref ref=\"RootConsoleAppender\"\/>\n <\/root>\n\n<\/configuration>\n[dmadmin@content_server_01 server]$<\/pre>\n <\/p>\n
Then once you have your template logback.xml file, you need to force JBoss to load and use it otherwise it will just be ignored. As mentioned above, here is the JVM parameter to be added:<\/p>\n
[dmadmin@content_server_01 server]$ \n[dmadmin@content_server_01 server]$ grep \"JAVA_OPTS=\" startMethodServer.sh\nJAVA_OPTS=\"$USER_MEM_ARGS -Djboss.server.base.dir=$JBOSS_BASE_DIR -Dorg.apache.coyote.http11.Http11Protocol.SERVER=MethodServer\"\n[dmadmin@content_server_01 server]$ \n[dmadmin@content_server_01 server]$ sed -i 's,^JAVA_OPTS=\"[^\"]*,& -Dlogback.configurationFile=$JBOSS_BASE_DIR\/deployments\/ServerApps.ear\/logback.xml,' startMethodServer.sh\n[dmadmin@content_server_01 server]$ \n[dmadmin@content_server_01 server]$ grep \"JAVA_OPTS=\" startMethodServer.sh\nJAVA_OPTS=\"$USER_MEM_ARGS -Djboss.server.base.dir=$JBOSS_BASE_DIR -Dorg.apache.coyote.http11.Http11Protocol.SERVER=MethodServer -Dlogback.configurationFile=$JBOSS_BASE_DIR\/deployments\/ServerApps.ear\/logback.xml\"\n[dmadmin@content_server_01 server]$<\/pre>\n <\/p>\n
Once done, you can customize some values like the path and name of the log file, the number of files to keep, the log level you want to use, aso. Here are some commands to do just that:<\/p>\n
[dmadmin@content_server_01 server]$ \n[dmadmin@content_server_01 server]$ d2_log=\"$DOCUMENTUM_SHARED\/wildfly9.0.1\/server\/DctmServer_MethodServer\/logs\/D2-JMS.log\"\n[dmadmin@content_server_01 server]$ \n[dmadmin@content_server_01 server]$ # Commands to update some values on this pattern file using the ${d2_log} variable\n[dmadmin@content_server_01 server]$ sed -i \"s,<file>.*<\/file>,<file>${d2_log}<\/file>,\" ${logback_file}\n[dmadmin@content_server_01 server]$ sed -i \"s,<fileNamePattern>.*<\/fileNamePattern>,<fileNamePattern>${d2_log}-%d{yyyy-MM-dd}.zip<\/fileNamePattern>,\" ${logback_file}\n[dmadmin@content_server_01 server]$ sed -i \"s,<MaxHistory>.*<\/MaxHistory>,<MaxHistory>180<\/MaxHistory>,\" ${logback_file}\n[dmadmin@content_server_01 server]$ sed -i \"s,<level>.*<\/level>,<level>info<\/level>,\" ${logback_file}\n[dmadmin@content_server_01 server]$<\/pre>\n <\/p>\n
With the above done, you can just restart the JMS and afterwards, you will have a new file created D2-JMS.log at the location specified and with the log level specified.<\/p>\n
[dmadmin@content_server_01 server]$ $JMS_HOME\/server\/stopMethodServer.sh\n{\"outcome\" => \"success\"}\n[dmadmin@content_server_01 server]$\n[dmadmin@content_server_01 server]$\n[dmadmin@content_server_01 server]$\n[dmadmin@content_server_01 server]$ $JMS_HOME\/server\/startJMS.sh\nStarting the JMS...\nThe JMS process has been started.\n[dmadmin@content_server_01 server]$ sleep 30\n[dmadmin@content_server_01 server]$ \n[dmadmin@content_server_01 server]$ cat ${d2_log}\n2018-06-16 17:16:48,652 UTC [INFO ] (default task-6) - com.emc.d2.api.methods.D2Method : D2Method Main method com.emc.d2.api.methods.D2SubscriptionMethod arguments: {-user_name=dmadmin, -method_trace_level=0, -dcbase_name=Repo1.Repo1, -class_name=com.emc.d2.api.methods.D2SubscriptionMethod, -job_id=080f123450001612}\n2018-06-16 17:16:49,668 UTC [INFO ] (default task-6) - com.emc.d2.api.methods.D2Method : ==== START ======================================================================\n2018-06-16 17:16:49,670 UTC [INFO ] (default task-6) - com.emc.d2.api.methods.D2Method : D2-API v4.7.0070 build 186\n2018-06-16 17:16:49,674 UTC [INFO ] (default task-6) - com.emc.d2.api.methods.D2Method : DFC version : 7.3.0040.0025\n2018-06-16 17:16:49,675 UTC [INFO ] (default task-6) - com.emc.d2.api.methods.D2Method : file.encoding : ANSI_X3.4-1968\n2018-06-16 17:16:49,676 UTC [INFO ] (default task-6) - com.emc.d2.api.methods.D2Method : Arguments : {-user_name=dmadmin, -method_trace_level=0, -docbase_name=Repo1.Repo1, -class_name=com.emc.d2.api.methods.2SubscriptionMethod, -job_id=080f123450001612}\n[dmadmin@content_server_01 server]$<\/pre>\n <\/p>\n
Here you have a working D2-JMS.log file with INFO only information and no DEBUG.<\/p>\n
<\/p>\n
Some tips regarding the logback.xml configuration (I put an example of each in the template configuration file above):<\/p>\n
<\/p>\n
You might be wondering why this JVM parameter is not added by default by the Documentum installer since it is a valid solution for this issue, right? Well, I would simply reply that it’s Documentum. \ud83d\ude09<\/p>\n
<\/p>\n","protected":false},"excerpt":{"rendered":"
If you are working with Documentum for quite some time, you are probably familiar with the logback.xml file that can be used to configure the D2 logs. In this blog, I will be talking only about the Content Server side of this configuration. As you probably know, Documentum upgraded the JMS to use JBoss 7.1.1\u00a0“recently” […]<\/p>\n","protected":false},"author":20,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[197,525],"tags":[1392,1393,443,564,118,890,1100],"type_dbi":[],"class_list":["post-11395","post","type-post","status-publish","format-standard","hentry","category-application-integration-middleware","category-enterprise-content-management","tag-7-1-1","tag-9-0-1","tag-d2","tag-debug","tag-jboss","tag-log","tag-wildfly"],"acf":[],"yoast_head":"\n