modeler

An eclipse GEF-based graphical modeler with Neo4J as storage

Overview

Development status

file:https://travis-ci.org/steinarb/modeler.png

Building locally

I'm only giving the instructions for how to install on debian or ubuntu or similar (e.g. mint) GNU/linux systems.

Figuring out the commands for how to install the software on non-APT GNU/linux systems, macs or windows boxes, are left as an exercise for the reader (but the same software packages are required for development).

Prerequites

git and maven

All commands below are shown run as root on debian. Prefix the commands with sudo if running on ubuntu.

Instructions:

Install git, on a debian/ubuntu GNU/linux distribution, this is done by giving the following command as root:

Eclipse and tycho

apt install git
Install java SDK, on a debian/ubuntu GNU/linux distribution, this is done by giving the following command as root:
apt install openjdk-11-jdk
Install maven, on a debian/ubuntu GNU/linux distribution, this is done by giving the following command as root:
apt install maven

The eclipse packaged by debian is too old and buggy to use.

Instead, follow the instructions below (should work for all GN/linux distros). All commands are run as a regular user.

Clone the modeler project:

#+BEGIN_EXAMPLE cd $HOME mkdir -p workspaces/ws01 cd workspaces/ws01 git clone https://github.com/steinarb/modeler.git #+END_EXAMPLE

Download the eclipse installer:

#+BEGIN_EXAMPLE cd /tmp wget https://mirrors.dotsrc.org/eclipse//oomph/epp/2019-06/R/eclipse-inst-linux64.tar.gz #+END_EXAMPLE

For windows or mac, download and run the appropriate installer from https://www.eclipse.org/downloads/packages/installer

Unpack and start the installer:

#+BEGIN_EXAMPLE cd /tmp tar xvfz eclipse-inst-linux64.tar.gz cd eclipse-installer ./eclipse-inst #+END_EXAMPLE

In the "eclipseinstaller" dialog:

In type filter text, type:

rcp
Click on "Eclipse for RCP and RAP developers"
Click on the button "INSTALL" (keep all defaults)
In the dialog "Oomph License Confirmation":
Check off "Remember accepted licenses"
Click on the button "Accept"
In the dialog "Certificates":
Click the button "Select All"
Click the button "Accept selected"
Click the button "LAUNCH"
In the dialog "Eclipse IDE Launcher":
In the Workspace field replace "eclipse-workspace" with:
workspaces/ws01
Click the button "Launch"
In eclipse IDE:
Uncheck "Always show Welcome view on startup"
Close the welcome view
Select the menu Window->Preferences
In the dialog "Preferences":
Select "Maven"
Change the settings to be:

| | Offline | | x | Do not automatically update dependencies from remote repositories | | | Debug output | | x | Download artifact sources | | x | Download artifact javadoc | | x | Download repository index on startup | | x | Update maven projects on startup | | x | Automatically update Maven projects configuration (experimental) | | x | Hide folders of physically nested modules (experimental) |

Click the button "Apply"

Select Maven->Discovery

Click the button "Open Catalog"

In the dialog "m2e catalog":

In "Find", type:

tycho
Tick the checkbox of "Tycho Configurator"
Click the button "Finish"
In the dialog "Install":
Click the button "Next>"
Click the button "Next>"
Select "I accept the terms of the license agreement"
Click the button "Finish"
In the dialog "Security Warning":
Click the button "Install anyway"
In the dialog "Software updates"
Click the button "Restart Now"

Import the source code in eclipse

Instructions:
1. In the restarted "Eclipse IDE"
2. Select the menu File->Import...
3. In the dialog "Import":
4. Select Maven->Existing Maven Projects
5. Click the button "Next>"
6. Click the button "Browse..."
7. In the dialog "Select Root Folder":
8. Browse to the workspaces/ws01 subdirectory of your home directory
9. Click the button "Open"
10. Click the button "Deselect All"
11. Select the pom files:
12. modeler.target/pom.xml
13. modeler.feature/pom.xml
14. modeler.core/pom.xml
15. modeler.core.test/pom.xml
16. modeler.test/pom.xml
17. Click the button "Finish"

Neo4J server

The modeller need a Neo4J server.

For installing on other systems than debian based GNU/linux systems, see the Neo4J documentation.

For [[https://neo4j.com/docs/operations-manual/current/installation/linux/debian/#debian-add-repository][installing on debian or ubuntu]], do:
1. Add the Neo4J APT repository, do the following commands as root:
#+BEGIN_EXAMPLE wget -O - https://debian.neo4j.org/neotechnology.gpg.key | apt-key add - echo 'deb https://debian.neo4j.org/repo stable/' | tee -a /etc/apt/sources.list.d/neo4j.list apt update #+END_EXAMPLE
2. Install neo4j community edition:
#+BEGIN_EXAMPLE echo "neo4j-enterprise neo4j/question select I ACCEPT" | debconf-set-selections echo "neo4j-enterprise neo4j/license note" | debconf-set-selections apt install neo4j=1:3.5.8 #+END_EXAMPLE