Skip to content

Software Configuration

Jump to bottom
Florent Garin edited this page Oct 1, 2019 · 110 revisions

Introduction

Once the prerequisite software have been installed, it's time to deploy the application itself. This part is explained in this page.

You can either build the EAR from source or you can download it from DocDokuPLM website and jump to the configuration part.

Build for DocDokuPLM 2.5.X version

To build the DocDokuPLM software you will need a specific build automation tool called MAVEN. Don't forget to set the MAVEN_HOME environment variable.

Note

  1. An enterprise application archive (ear) named "eplmp-server-ear.ear" will be generated.
  2. EPLMP must be built before docdokuplm. There is a one-way dependency between docdokuplm and EPLMP: docdokuplm needs some compiled files archives (.jar) from EPLMP to compile.

Build Process

First, execute these commands lines in a shell in order to build EPLMP:

git clone https://github.com/polarsys/eplmp.git
cd eplmp
git checkout remotes/origin/develop
mvn install
cd ..

Then, you can proceed and build docdokuplm using the following command lines:

git clone https://github.com/docdoku/docdoku-plm
cd docdoku-plm
git checkout remotes/origin/dev
mvn install
cd ../eplmp/eplmp-server/eplmp-server-ear/target/

Now check in directory eplmp/eplmp-server/eplmp-server-ear/target if eplmp-server-ear.ear file is present.

Deployment for DocDokuPLM 2.5.X version

First if you don't have payara server, download it from the following URL (fish.payara.distributions:payara:4.1.2.181). Unzip it and create a domain as describe here.

Using the administrator console

To deploy the modified eplmp-server-ear.ear, we have to start the payara server and log into the admin console (http://localhost:4848/). Then click on "Applications> Enterprise Applications> Deploy", browse your local drive to select the "eplmp-server-ear.ear" file and upload it to the server. By default, the port is 8080, but you can change it from there: Configurations > server-config > Network Config > Network Listeners > http-listener-1

Using the command line

{payara install dir}/bin/asadmin stop-domain {domainName};// If not already stopped
cp {ear dir}/eplmp-server-ear.ear {payara install dir}/glassfish/domains/{domainName}/autodeploy/;
{payara install dir}/bin/asadmin set server.http-service.http-listener.http-listener-1.port={port};
{payara install dir}/bin/asadmin start-domain {domainName};

Plugins

You can deploy some plugins. A plugin is an ear file. Copy the ear file corresponding to the plug-in to the autodeploy folder ({payara install dir}/glassfish/domains/<domain_name>/autodeploy), or use asadmin command.

Plugins available:

  • docdoku-plm/converter-all/converter-all-ear/target/converter-all-ear-2.5.X.ear
  • docdoku-plm/converter-dae/converter-dae-ear/target/converter-dae-ear-2.5.X.ear
  • docdoku-plm/converter-ifc/converter-ifc-ear/target/converter-ifc-ear-2.5.X.ear
  • docdoku-plm/converter-obj/converter-obj-ear/target/converter-obj-ear-2.5.X.ear
  • docdoku-plm/converter-step/converter-step-ear/target/converter-step-ear-2.5.X.ear
  • docdoku-plm/importer-attributes/importer-attributes-ear/target/importer-attributes-ear-2.5.X.ear
Clone this wiki locally