DocDokuPLM has a modularized architecture that makes it possible to extend the core feature set easily. For instance, the CAD files converters are provided as plugins.

Converters are EARs that must be deployed under the same payara domain than the eplmp-server-ear.ear file. You can build them individually or you can build all of them by running mvn clean install at the project root directory.

Converter list:

• converter-all
• converter-dae
• converter-ifc
• converter-obj
• converter-step

Each converter rely on some binaries that must be available on your system. You have to install the following binaries/libraries.

To convert most of the 3D formats, we use meshconv. Please refer to this page to install it on your server.

By default DocdokuPLM will try to use file located to following path

/opt/meshconv/meshconv

If you don't want to use default configuration you must override this path in the configuration file, you need to modify the following properties file :

com/docdoku/server/converters/all/conf.properties

Supported formats are dxf,obj,off,ply,stl,3ds,wrl

To convert Step and Iges files, we use Freecad.

The converter relies on a python interpreter and the Freecad API. To install Freecad API on your system, refer to this page You may also need to edit the file depending on the location of FreeCad API : com/docdoku/server/converters/obj/conf.properties:

freeCadLibPath=/usr/lib/freecad/lib

Supported formats are stp,step,igs,iges

To convert IFC files to, we use IfcOpenShell.

The converter relies on IfcOpenShell CLI. To install it on your system, refer to this page. You may also need to edit the file depending on the location of IfcOpenShell executable :

com/docdoku/server/converters/ifc/conf.properties:

ifc_convert_path=/opt/ifcconvert/IfcConvert

To convert other 3D formats, we use assimp. It works with most of collada files, but may fail with other formats.

To install assimp on your system, please refer to this page.

On ubuntu simply run

sudo apt-get intall assimp-utils

By default DocdokuPLM will try to use

assimp

To override this path, you need to modify the following properties file :

com/docdoku/server/converters/dae/conf.properties

Supported formats are dae,ifc,lwo,x,ac,cob,scn,ms3d

These plugins can convert SolidWorks and CATIA geometry and assembly files. They both need a licence key, please contact us to get a licence.

To generate 3 LODS, we use a program based on OpenMesh.

To install OpenMesh on your system, please refer to this page. Make sure ton install OpenMesh in release mode (Requirements : Qt 5.3.0, gcc 4.9.1)

Then you need to copy the decimater binaries from docdoku-openmesh-decimater folder or to build it yourself. Place the binary in

/opt/decimater/

To override this path, you need to modify the following properties file :

com/docdoku/server/converters/utils/conf.properties

If you plan to build the sources yourself, you will need to install Qt and gcc. On ubuntu systems, please refer to this page

Open a terminal and enter the following commands

cd docdoku-openmesh-decimater/src
qmake OpenMeshDecimater.pro
make
mv lod.o /opt/decimater/lod.o
mv main.o /opt/decimater/main.o
mv OpenMeshDecimater /opt/decimater/OpenMeshDecimater