OASP Installation on Ubuntu 16.10

oasp-ubuntu.md

OASP Installation on Ubuntu 16.10

Prerequisites

Install Git and Maven on your System.

Clone the oasp4j-ide-repo (e.g. into a temp dir):

git clone git@github.com:oasp/oasp4j-ide.git

Build the archives:

cd oasp4j-ide
mvn package

Create a project directory.

OASP installation

Create the directory workspaces/main/ in the project directory.

Clone the oasp4j and oasp4js repos:

cd workspaces/main
git clone --recursive https://github.com/oasp/oasp4j.git
git clone https://github.com/oasp/oasp4js.git

Software

Create a directory named software in your project directory. Install Eclipse, Java, Maven and Node.js into that directory. The layout should look like this:

 /software
   /eclipse
   /java
     /bin
   /maven
     /bin
   /nodejs
     /bin

You may install more tools like tomcat in that manner. Do not use version numbers in your directory names and restrict yourself to all-lowercase. If a software distribution contains a bin/-directory, it has to reside right beneath the top directory for that software, as in software/maven/bin/.
You also may add a config script called ide-config to a tool directory (like software/eclipse/) for custom initialization options.

Install Bower and Gulp via the Node Package Manager:

cd software/nodejs/bin
npm install -g bower
npm install -g gulp

Install the Eclipse plugins you need: https://github.com/oasp/oasp4j-ide/wiki/guide-software-package#eclipse

Scripts

Extract the archive oasp4j-ide/oasp4j-ide-scripts/target/oasp4j-ide-scripts-*current-version*-SNAPSHOT-linux.tar.gz into the project directory.

Settings

Extract oasp4j-ide-settings/target/oasp4j-ide-settings-*current-version*-SNAPSHOT.zip to workspaces/main/development/in your project directory.

First Eclipse Startup

Source env.sh into your shell session:

. env.sh

Run the update-all-workspaces script. You will now have a script called eclipse-main in the project directory. Run it to start Eclipse.

Import Maven projects if necessary.