The Camunda Community Edition is the default version built into SO. With the Community Edition, you can see process definitions, but you cannot inspect running or completed process instances, which is an essential debugging capability. This capability is available only in the Enterprise Edition and requires a commercial license. If you have such a license, you can build SO with the Enterprise Edition. Your use must be compatible with the terms of your license, of course.
With the Enterprise Edition cockpit, you can:
- See a trace of tasks executed by a running or completed process instance.
- Look at execution variables in a running or completed process instance.
- Look at called subprocesses in a running or completed process instance.
Maven Repository for Camunda EE Artifacts
To build with Camunda EE, you will need a maven repository containing those artifacts. This can be a nexus repository or a local repository in your filesystem.
To construct a local repository, start with this structure for the 7.7.3-ee version of Camunda:
NOTE: the zip archive does not contain the actual Enterprise Edition JAR and WAR artifacts. It contains zero-length files as placeholders. You will need to replace the zero-length files with artifacts you obtain from Camunda. The archive does contain all the poms, checksums, and metadata required to make it a functional maven repository.
Here's the minimum set of artifacts you need to build the SO Amsterdam release software:
camunda-engine-7.7.3-ee.jar
camunda-webapp-7.7.3-ee-classes.jar
camunda-webapp-7.7.3-ee.war
camunda-webapp-ee-jboss-standalone-7.7.3-ee.war
camunda-engine-cdi-7.7.3-ee.jar
camunda-engine-rest-7.7.3-ee-classes.jar
camunda-engine-plugin-spin-7.7.3-ee.jar
camunda-engine-plugin-connect-7.7.3-ee.jar
camunda-engine-rest-core-7.7.3-ee.jar
camunda-engine-feel-api-7.7.3-ee.jar
camunda-engine-feel-juel-7.7.3-ee.jar
camunda-engine-dmn-7.7.3-ee.jar
camunda-engine-spring-7.7.3-ee.jar
camunda-bpmn-model-7.7.3-ee.jar
camunda-xml-model-7.7.3-ee.jar
camunda-dmn-model-7.7.3-ee.jar
camunda-cmmn-model-7.7.3-ee.jar
Maven settings.xml
Add a profile to your maven settings.xml to include the repository containing your Camunda EE artifacts.
Example:
<profile> <!-- profile for artifacts not in public repositories --> <id>my-local-artifacts</id> <repositories> <repository> <!-- Local repository for Camunda Enterprise Edition --> <!-- YOU MUST HAVE A VALID LICENSE TO USE THIS --> <id>camunda-ee</id> <name>camunda-ee</name> <url>file:///home/john/onap/camunda-ee-repository</url> </repository> </repositories> </profile> </profiles>
Also add the repository to the list of active profiles in your settings.xml
<activeProfiles>
<activeProfile>my-local-artifacts</activeProfile>
<activeProfile>openecomp-staging</activeProfile>
<activeProfile>openecomp-public</activeProfile>
<activeProfile>openecomp-release</activeProfile>
<activeProfile>openecomp-snapshots</activeProfile>
<activeProfile>opendaylight-release</activeProfile>
<activeProfile>opendaylight-snapshots</activeProfile>
</activeProfiles>
Building
Add these options to the mvn command line when you build "so"
-Dcamunda.version=7.7.3-ee -Dcamunda.bpm.webapp.artifact=camunda-webapp-ee-jboss-standalone
Installation
The cockpit is part of the SO image. There are no special installation requirements. When you log in, you will need to enter your license information. Alternatively, you can insert your license directly into the camundabpmn database before you log in:
INSERT INTO camundabpmn.ACT_GE_PROPERTY VALUES ('camunda-license-key','YOUR-LICENCE-KEY-HERE',1);
Logging In
Because port 8080 on the docker host machine is forwarded to port 8080 in the SO docker container you can log into the Enterprise Edition cockpit by browsing to this URL:
http://dockerhost:8080/camunda
Where dockerhost is the docker host system.
If you can use a browser on the docker host system, then use a localhost address:
The user is "admin" and the password is the same as the jboss admin password, which is not displayed here.
