You need three tools installed to get a local copy of OpenMOLE:

• A java 8 jdk or higher (N.B. not only the JRE). Check your version by typing javac -version in a terminal
• the git software and the LFS extension
• sbt , the scala building tool

As a suggestion, we recommand the IntelliJ IDE to edit the scala source code of the project.

1. Clone the OpenMOLE repository :

   git lfs clone git@github.com:openmole/openmole.git
   

2. Set the git submodules inside the openmole subdirectory

cd openmole
git submodule update --init --remote

3. Publish locally the content of the build-system and libraries subdirectory

 cd build-system
sbt publishLocal
 cd ../libraries/
sbt publishLocal

These commands may take some time (a few minutes at least).

To build the OpenMOLE application, use the sbt assemble command inside openmole subdirectory.

cd openmole
sbt assemble

Upon completion, the executable is placed under /openmole/openmole/bin/openmole/target/assemble and is launched as any executable : ./openmole Then, the app should pop up in your default web browser, the URL is something like http://localhost:44961/app

You can create a standalone archive of your fresh OpenMOLE build and ship it around by using the task openmole:tar:
sbt openmole:tar

You will find the resulting archive in bin/openmole/target/openmole.tar.gz.

cd build-system
sbt publish
cd ../libraries
sbt publish
cd ../openmole
sbt publish

An easy way to get an OpenMOLE compilation environment up and running is to use docker. Once docker is installed on you machine you can do:

git clone https://github.com/openmole/docker-build.git
cd docker-build
./run -v /a/local/path/on/your/system
# You should be in the docker container now, execute
clone
compile

You can now find the compile OpenMOLE in /a/local/path/on/your/system/openmole/openmole/bin/openmole/target/assemble/

The source code of the website and the OpenMOLE documentation are hosted along in the code repository. You might spot a typo/incorrect spelling/grammar mistake/bad wording or simply want to improve a part of the documentation you think is unclear. If so, you're more than welcome to correct our mistakes and improve the documentation. To check your changes locally before sending us a Pull Request, here is how to build a local copy of the website/documentation.

cd openmole/openmole
sbt

Once sbt is launched, use the buildSite command inside sbt to build the webpages. Location of the generated pages can be set via the --target option, e.g.

buildSite --target /tmp/

By default, pages are located in openmole/openmole/bin/org.openmole.site/jvm/target/site/ Updating the git submodules is mandatory the first time you set up your OpenMOLE development environment. It pulls the examples from the market place that are necessary to build the documentation website. Optionally you can use --no-test in order to disable the tests of the scripts, which is (really) time-consuming. The tests concerning the examples from the OpenMOLE market can in turn be disabled using --no-market-test.

Sources are located in openmole/openmole/bin/org.openmole.site/jvm/src/main/scalatex/openmole They are written using scalatex, a DSL to generate html content.

OpenMOLE repos are divided into three branches.

• dev contains the unstable, current version of the platform.
• #version-dev e.g. 7-dev , is the stabilized version of the dev branch
• master is the main branch, from which the two former branches are derived

OpenMOLE is made of three different projects:

• openmole/openmole: the main project containing the source code for the core and plugins
• openmole/libraries: contains the libraries which OpenMOLE depends on but are not available as OSGi bundles from their developers. This project takes all these dependencies, wraps them in OSGi projects and generates the corresponding bundles to be later imported by OpenMOLE's main project.
• openmole/build-system: As its name stands, that's the build system :) It's very unlikely that you'll have to modify this project.

The development version of the OpenMOLE site and software is compiled and distributed several times an hour at https://next.openmole.org/.

Please report bugs you may find in OpenMOLE on the bug tracker.

When you want to contribute to the project (code or documentation) we recommend that you to start by submitting an issue, so that the community can identify the nature of the potential caveat.
After that, send a pull request so that your potential changes can be discussed.

OpenMOLE applies a branching model derived from Vincent Driessen's. Some slight differences should be noted: