Page Comparison

We recognize that there are different ways to set up a workspace and different tools that may be chosen.  This is just one way to set things up.

Suggested Directory Structure

NOTE: You may have different versions of eclipse and java.

...

workspace

SO

docker-config

libs

so

Java

Download the latest Java 8 SE Development Kit from Oracle.   Select a Linux x64 package.

Unpack it.

Maven

Maven Setup

Download the Apache Maven 3.3.9 binary.  NOTE: 3.3.9 is the recommended version, even though much higher versions are available.

...

Create an .m2 directory for maven and put settings.xml in it.  Edit the local repository path in settings.xml to make it correct for your environment.  Everything else should be OK.

Maven Run JUnit Tests

# Run Tests
mvn clean test


# Run A Specific Test
mvn clean -Dtest=MsoVnfPluginAdapterImplTest test -e
# mvn clean -Dtest=<Java Class Name> test -e
# #### '-e' turns on Error Stack Traces


# Remote Debug A Specific Test - Setup IDE to connect to 5005
# #### Be sure to open port 5005 on your build system
mvn -Dmaven.surefire.debug -Dtest=MsoVnfPluginAdapterImplTest test -e


# Attach remote Debugger
## Eclipse https://dzone.com/articles/how-debug-remote-java-applicat 
## IntelliJ https://stackoverflow.com/questions/21114066/attach-intellij-idea-debugger-to-a-running-java-process

See https://maven.apache.org/surefire/maven-surefire-plugin/examples/debugging.html for more info.

Camunda Modeler

Download the Camunda Modeler.  Select the Linux x64 package.

Unpack it.

Eclipse

Download Eclipse for Linux.  Select the 64-bit Eclipse IDE for Java Developers.  Oxygen seems to be the latest version. These instructions were written for Neon.

...

Adjust the maximum heap space (2GB is recommended).

Example:

Eclipse Settings

Configure eclipse to use your external maven 3.3.9 installation:

...