Workspace and Development Tools

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.

onap

.m2

apache-maven-3.3.9

camunda-modeler

eclipse-jee-neon-3-linux-gtk-x86_64

jdk1.8.0_131

workspace

SO

chef-repo

docker-config

libs

so

so-config

Java

Download the latest Java_8_SE_Development_Kit from Oracle. Select a Linux x64 package.

Unpack it.

Maven

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

Unpack it.

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.

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 EE Developers. Oxygen seems to be the latest version. These instructions were written for Neon. Unpack it.

In the eclipse directory, edit eclipse.ini

Add (or change) the -vm setting so that it points to your JDK.

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

Example:

../_images/Workspace_and_Development_Tools.png

Eclipse Settings

Configure eclipse to use your external maven 3.3.9 installation:

Go to Window→Preferences→Maven→Installations

Click “Add” and browse to your apache-maven-3.3.9 directory. Click “OK” to select it.

Click “Finish”

../_images/Workspace_and_Development_Tools_2.png

Make sure the external installation is selected:

../_images/Workspace_and_Development_Tools_3.png
Configure eclipse to use your settings.xml

Go to Window→Preferences→Maven→User Settings

Type the full path to your settings.xml file into the “User Settings” box and click “OK”.

../_images/Workspace_and_Development_Tools_4.png