How to run Documentum Extractor with dfc.jar. [Cognite Official]

With the introduction of the Documentum Extractor version 2.0.0 onwards, it’s required to add the dfc.jar file into the lib folder. So to be able to run as a jar file user must add the dfc.jar file into the lib folder. The newly introduced Documentum Extractor is built against version 7.2.0180.0170 of DFC.

Issue users might face when running the jar file with the below command

java -jar path/to/documentum-extractor-<version>.jar path/to/config.yaml

If a user tried to run the Documentum Extractor with the dfc.jar file with the above command as mentioned in this guide, the user will receive an error message similar to the:

Main  - Documentum Extractor failed:
java.lang.NoClassDefFoundError: com/documentum/fc/common/DfException

This is due to the fact that the Documentum Extractor jar is not identifying the main classpath.

Workaround to run the Documentum Extractor with the dfc.jar file.

As a workaround users could specify the classpath to include the extractor and run it as shown below. With this workaround, we manually specify the classpath to include the extractor. 

Windows:

java -cp cognite-documentum-extractor-2.0.1.jar;lib/\* com.cognite.connector.dctm.Main config.yml

Linux:

java -cp cognite-documentum-extractor-2.0.1.jar:lib/\* com.cognite.connector.dctm.Main config.yml