Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Notes

  • MariaDB 10.3 should be installed and running, before continuing the installation.

  • ${INSTALLATION_ROOT} represents the installation set of GlobalID.

  • sen${DB_USERNAME} represents the username of the MariaDB Database User.

  • ${DB_PASSWORD} represents the password for the MariaDB Database User.

  • ${DB_HOST_ADDRESS} represents the host address and port for the MariaDB database.

  • ${HOST} represents the home IP address and Port e.g. 192.168.0.1:1234

  • *.war files provided with this installation in the folder /GlobalID/WebApps

  • mysql-connector-java-8.0.22.jar file provided with this installation in the folder /GlobalID/DBConnect

1. Add Required Libraries and Configuration

Copy all libraries and configuration from the ${INSTALLATION_ROOT}/lib folder to the Tomcat library folder /usr/share/tomcat/lib/

...

The APIName and APIKey are used for authenticaton of Camunda Process services against GlobalID. Use the values from the API Key section in 5.3 Admin UI - Settings - API Key

Change the <name> and <key> to an encrypted value.

...

Code Block
globalid.url=https://<host>:8443/GlobalID
globalid.service.account.api.name=<name>
globalid.service.account.api.key=<key>
camunda.encryption.salt=<random>
camunda.encryption.password=<random>

2. Add BPM Bootstrap Server Listener

Add this entry before GlobalResourcesLifecycleListener in /usr/share/tomcat/conf/server.xml. This class is responsible for starting and stopping the Camunda BPM platform as Tomcat is started and stopped.

Code Block
<Server port="9005" shutdown="SHUTDOWN">  
  ...  
  <Listener className="org.camunda.bpm.container.impl.tomcat.TomcatBpmPlatformBootstrap" />  
  ...

3. Configure a JDBC and BPM Resources

To configure a Resource, edit the file /usr/share/tomcat/conf/server.xml. To initialize the connection with MariaDB MySQL Server, you have to add the following:

...

 Pay attention to line 11. If using 127.0.0.1 SSL may be set to “false”.

4. Add bpm-platform.xml

Copy the file ${INSTALLATION_ROOT}/GlobalID/conf/bpm-platform.xml to the folder /usr/share/tomcat/conf.

5. Add WebApps files to Tomcat

Copy the files in ${INSTALLATION_ROOT}/GlobalID/webapps to /usr/share/tomcat/webapps.

Remember to include subfolder(s).

6. Configure SSL and start Tomcat

Edit /etc/tomcat/server.xml and add the following connector:

...

Start Tomcat using: systemctl start tomcat

7. Activate Basic Authentication on REST API

Open /usr/share/tomcat/webapps/engine-rest/WEB-INF/web.xml.

...

Verify it works by accessing the URL https://<host>:8443/engine-rest/incident/count. It should display a validation window where you have to enter the credentials of the newly created user from the previous step. Considering there is no process deployed, it should return the value 0.

8. Configure Camunda User Base

Access the URL https://<host>:8443/camunda/. Accessing the link for the first time will give the user creation page. Type in all relevant information. Remember the credentials you used as you will need them later on.

...

Link to the camanuda documentation regarding the LDAP plugin : https://docs.camunda.org/manual/7.14/user-guide/process-engine/identity-service/#activate-the-ldap-plugin

9. Verify Camunda Cockpit

Access the URL https://<host>:8443/camunda/app/cockpit. Please verify that the GlobalID processes are deployed.

10. Secure access to Swagger

To be done.