Build From Sources
Documentation > Download
Publish the bundles:
First time setup 🔗
Prerequisites 🔗You will need the following tools to get a local copy of OpenMOLE running:
A Java 11 (or higher) JDK (N.B. not only the JRE!). Check your version by typing
javac -versionin a terminal.
- The git software and the LFS extension.
- SBT, the Scala Building Tool.
- npm, library required to build the website.
Get the project 🔗Clone the OpenMOLE repository by typing the following in your command shell (prompt $>):
$> git lfs install $> git lfs clone email@example.com:openmole/openmole.git
Build the OpenMOLE application 🔗
Build from sources 🔗
For the first timeTo build the OpenMOLE application for the first time after cloning it, execute the
build.shscript inside the OpenMOLE directory that you just cloned.
Upon successful completion, the executable is placed under openmole/bin/openmole/target/assemble and is launched as any executable via the
$> cd openmole $> ./build.sh
./openmolecommand. The app should then pop up in your default web browser, the URL should be something like
Re-build the project after an updateIn order to apply the changes after you updated your OpenMOLE version (by doing a
git pullof the project for instance), you need to run successively the
$> ./clean.sh $> ./build.sh
Create a standalone archive 🔗You can create a standalone archive of your fresh OpenMOLE build and ship it around by using
sbt openmole:tar. You will find the resulting archive in bin/openmole/target/openmole.tar.gz.
Publish the bundles:
$> cd build-system $> sbt publish $> cd ../libraries $> sbt publish $> cd ../openmole $> sbt publish
Compile within Docker 🔗An easy way to get an OpenMOLE compilation environment up and running is to use Docker. Once Docker is installed on your machine you can do:
You can now find the compiled OpenMOLE app in /a/local/path/on/your/system/openmole/openmole/bin/openmole/target/assemble/.
$> 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