D2 v4.5 Installation Checklist

I finally got D2 v4.5 installed on a VMware image running Content Server 7.2.  I don’t think I’ve experienced a smooth D2 installation yet — they are very tedious.  If you are struggling with a D2 v4.5 install and want to quickly check that you have some of the key files in the correct locations and have the configurations properly made, I offer the following checklist from my install.

Big thanks to Shoeb Haque for helping me with the install and for reviewing this post.

UPDATE:  Here are some good Lockbox troubleshooting references.

Environment

  • Windows Server 2008
  • Tomcat 7.0.39
  • Java SE 1.7.0_79
  • SQL Server 2012
  • Documentum Content Server 7.2
  • DFS and DFS SDK 7.2
  • DA 7.0 (There seems to be an issue with D2 v4.5 and DA v7.2 residing on the same Tomcat instance.  See here for details:  https://community.emc.com/message/896022).
  • Note:  If you are using Tomcat 8 with Content Server v7.1 and/or DFS v7.1, see Ch 16 of the EMC Documentum D2 version 4.5 Installation Guide for additional configurations.  Or here:  https://community.emc.com/thread/216846.

Lockbox Files

  • C:\Documentum\D2\Lockbox\D2.lockbox
  • C:\Documentum\D2\Lockbox\LB.jar
  • C:\Documentum\D2\Lockbox\LBJNI.jar
  • C:\Documentum\D2\Lockbox\<platform files>

JMS Files

  • C:\Documentum\jboss7.1.1\server\DctmServer_MethodServer\deployments\ServerApps.ear\APP-INF\classes\D2.lockbox
  • C:\Documentum\jboss7.1.1\server\DctmServer_MethodServer\deployments\ServerApps.ear\APP-INF\classes\D2-JMS.properties
  • C:\Documentum\jboss7.1.1\server\DctmServer_MethodServer\deployments\ServerApps.ear\logback.xml
  • C:\Documentum\jboss7.1.1\server\DctmServer_MethodServer\deployments\ServerApps.ear\lib\C6-Common.jar
  • C:\Documentum\jboss7.1.1\server\DctmServer_MethodServer\deployments\ServerApps.ear\lib\D2-API.jar
  • C:\Documentum\jboss7.1.1\server\DctmServer_MethodServer\deployments\ServerApps.ear\lib\D2-Widget-API.jar
  • C:\Documentum\jboss7.1.1\modules\emc\d2\lockbox\main\module.xml
  • C:\Documentum\jboss7.1.1\modules\emc\d2\lockbox\main\LB.jar
  • C:\Documentum\jboss7.1.1\modules\emc\d2\lockbox\main\LBJNI.jar

…ServerApps.ear\logback.xml

<?xml version="1.0" encoding="UTF-8"?>
  <configuration scan="true" scanPeriod="60 seconds">
    <appender class="ch.qos.logback.core.rolling.RollingFileAppender" name="RootFileAppender">
      <file>C:/logs/D2-JMS.log</file>
      <append>true</append>
      <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
        <level>debug</level>
      </filter>
      <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <fileNamePattern>C:/Documentum/D2/logs/D2-JMS-%d{yyyy-MM-dd}.log.zip</fileNamePattern>
        <MaxHistory>5</MaxHistory>
      </rollingPolicy>
      <layout class="ch.qos.logback.classic.PatternLayout">
        <pattern>%-27(%date{yyyy-MM-dd HH:mm:ss} [%-5level]) - %-40(%C{18}[%-20(%mdc{methodName})]) : %message%n</pattern>
      </layout>
    </appender>
    <root>
      <level value="debug"/>
      <appender-ref ref="RootFileAppender"/>
    </root>
  </configuration>

…modules\emc\d2\lockbox\main\module.xml

<?xml version="1.0"?>
<module xmlns="urn:jboss:module:1.1" name="emc.d2.lockbox">
   <resources>
     <resource-root path="LB.jar" />
     <resource-root path="LBJNI.jar" />
   </resources>
</module>

D2 Files

  • C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\D2\WEB-INF\classes\D2FS.properties
  • C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\D2\WEB-INF\classes\logback.xml
  • C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\D2\WEB-INF\lib\C6-Commons-4.5.0.jar
  • C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\D2\WEB-INF\lib\D2-API-4.5.0.jar
  • C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\D2\WEB-INF\lib\D2FS-4.5.0.jar
  • C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\D2\WEB-INF\lib\D2FS-API-4.5.0.jar
  • C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\D2\WEB-INF\lib\D2-Widget-API-4.5.0.jar
  • C:\Program Files\EMC\D2\C6-Common.jar
  • C:\Program Files\EMC\D2\D2.jar
  • C:\Program Files\EMC\D2\D2-API.jar
  • C:\Program Files\EMC\D2\D2-Widget-API.jar
  • C:\Program Files\EMC\D2\LB.jar
  • C:\Program Files\EMC\D2\LBJNI.jar

…D2\WEB-INF\classes\D2FS.properties

  • lockboxPath=C:/Documentum/D2/Lockbox

…D2\WEB-INF\classes\logback.xml

<?xml version="1.0" encoding="UTF-8"?>
  <configuration scan="true" scanPeriod="60 seconds">
    <appender class="ch.qos.logback.core.rolling.RollingFileAppender" name="RootFileAppender">
      <file>C:/logs/D2.log</file>
      <append>true</append>
      <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
        <level>debug</level>
      </filter>
      <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <fileNamePattern>C:/Documentum/D2/logs/D2-JMS-%d{yyyy-MM-dd}.log.zip</fileNamePattern>
        <MaxHistory>5</MaxHistory>
      </rollingPolicy>
      <layout class="ch.qos.logback.classic.PatternLayout">
        <pattern>%-27(%date{yyyy-MM-dd HH:mm:ss} [%-5level]) - %-40(%C{18}[%-20(%mdc{methodName})]) : %message%n</pattern>
      </layout>
    </appender>
    <root>
      <level value="debug"/>
      <appender-ref ref="RootFileAppender"/>
    </root>
  </configuration>

C:\Program Files\EMC\D2\logback.xml

<?xml version="1.0" encoding="UTF-8"?>
  <configuration scan="true" scanPeriod="60 seconds">
    <appender class="ch.qos.logback.core.rolling.RollingFileAppender" name="RootFileAppender">
      <file>C:/logs/D2-CS.log</file>
      <append>true</append>
      <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
        <level>debug</level>
      </filter>
      <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <fileNamePattern>C:/Documentum/D2/logs/D2-JMS-%d{yyyy-MM-dd}.log.zip</fileNamePattern>
        <MaxHistory>5</MaxHistory>
      </rollingPolicy>
      <layout class="ch.qos.logback.classic.PatternLayout">
        <pattern>%-27(%date{yyyy-MM-dd HH:mm:ss} [%-5level]) - %-40(%C{18}[%-20(%mdc{methodName})]) : %message%n</pattern>
      </layout>
    </appender>
    <root>
      <level value="debug"/>
      <appender-ref ref="RootFileAppender"/>
    </root>
  </configuration>

D2-Config Files

  • C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\D2-Config\WEB-INF\classes\D2-Config.properties
  • C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\D2-Config\WEB-INF\classes\logback.xml
  • C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\D2-Config\WEB-INF\lib\C6-Common-4.5.0.jar
  • C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\D2-Config\WEB-INF\lib\D2-API-4.50.jar
  • C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\D2-Config\WEB-INF\lib\D2FS-4.5.0.jar
  • C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\D2-Config\WEB-INF\lib\D2FS-API-4.5.0.jar
  • C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\D2-Config\WEB-INF\lib\D2-Widget-API-4.50.jar

D2-Config.properties

  • lockboxPath=C:/Documentum/D2/Lockbox

…D2-Config\WEB-INF\classes\logback.xml

<?xml version="1.0" encoding="UTF-8"?>
  <configuration scan="true" scanPeriod="60 seconds">
    <appender class="ch.qos.logback.core.rolling.RollingFileAppender" name="RootFileAppender">
      <file>C:/logs/D2-Config.log</file>
      <append>true</append>
      <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
        <level>debug</level>
      </filter>
      <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <fileNamePattern>C:/Documentum/D2/logs/D2-JMS-%d{yyyy-MM-dd}.log.zip</fileNamePattern>
        <MaxHistory>5</MaxHistory>
      </rollingPolicy>
      <layout class="ch.qos.logback.classic.PatternLayout">
        <pattern>%-27(%date{yyyy-MM-dd HH:mm:ss} [%-5level]) - %-40(%C{18}[%-20(%mdc{methodName})]) : %message%n</pattern>
      </layout>
    </appender>
    <root>
      <level value="debug"/>
      <appender-ref ref="RootFileAppender"/>
    </root>
  </configuration>

C:\Program Files\Apache Software Foundation\Tomcat 7.0\conf\catalina.properties

  • common.loader=${catalina.base}/lib,${catalina.base}/lib/*.jar,${catalina.home}/lib,${catalina.home}/lib/*.jar,c:/documentum/config,c:/Program Files/Apache Software Foundation/Tomcat 7.0/webapps/D2-Config/WEB-INF/classes,c:/Program Files/Apache Software Foundation/Tomcat 7.0/webapps/D2/WEB-INF/classes,c:/Documentum/D2/Lockbox/win_vc80_x64,c:/program files/emc/d2/d2.jar

Environment Variables

  • CLASSPATH=%CLASSPATH%;c:\Documentum\dctm.jar;c:\Documentum\config;c:\Documentum\product\7.2\dctm-server.jar;c:\program files\emc\d2\d2.jar
  • PATH=%PATH%;c:\Documentum\Shared;c:\Documentum\product\7.2\bin;c:\Documentum;c:\Program Files\Java\jdk1.7.0_79\bin;c:\Documentum\D2\Lockbox\lib\native\win_vc80_x64;c:\Documentum\D2\Lockbox

 

Advertisements

About Scott
I have been implementing Documentum solutions since 1997. In 2005, I published a book about developing Documentum solutions for the Documentum Desktop Client (ISBN 0595339689). In 2010, I began this blog as a record of interesting and (hopefully) helpful bits of information related to Documentum, and as a creative outlet.

4 Responses to D2 v4.5 Installation Checklist

  1. Pingback: Barcode Widget for D2 | dm_misc: Miscellaneous Documentum Information

  2. Pingback: ESA for D2 Fail Open Vulnerability | dm_misc: Miscellaneous Documentum Information

  3. Pingback: Documentum D2 – Thoughts on the Content Library Use Case | TSG Blog

  4. Pingback: D2 Starter Project | Armedia Blog

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: