Installation

Pre-built Binaries

Note

This is the recommended way of installing for normal users.

Pre-built binaries are available from Maven Central. Download sidmrom-cli-0.0 .jar from here.

Install from Source

Note

You only need to install from source if you want to develop SIMdrom in Java yourself.

There are two options of installing SIMdrom. The recommended way for most users is to download a prebuilt binary and is well-described in the Quickstart section. This section describes how to build SIMdrom from scratch.

Prequisites

For building SIMdrom, you will need

  1. Java JDK 8 or higher for compiling Jannovar,
  2. Maven 3 for building Jannovar, and
  3. Git for getting the sources.

Git Checkout

In this tutorial, we will download the SIMdrom sources and build them in ~/Development/SIMdrom.

~ # mkdir -p ~/SIMdrom
~ # cd ~/SIMdrom
SIMdrom # git clone https://github.com/visze/simdrom.git simdrom
SIMdrom # cd simdrom

Maven Proxy Settings

If you are behind a proxy, you will get problems with Maven downloading dependencies. If you run into problems, make sure to also delete ~/.m2/repository. Then, execute the following commands to fill ~/.m2/settings.xml.

simdrom # mkdir -p ~/.m2
simdrom # test -f ~/.m2/settings.xml || cat >~/.m2/settings.xml <<END
<settings>
  <proxies>
   <proxy>
      <active>true</active>
      <protocol>http</protocol>
      <host>proxy.example.com</host>
      <port>8080</port>
      <nonProxyHosts>*.example.com</nonProxyHosts>
    </proxy>
  </proxies>
</settings>
END

Building

You can build SIMdrom using mvn package. This will automatically download all dependencies, build SIMdrom, and run all tests.

simdrom # mvn package

In case that you have non-compiling test, you can use the -DskipTests=true parameter for skipping them.

simdrom # mvn install -DskipTests=true

Creating Eclipse Projects

Maven can be used to generate Eclipse projects that can be imported by the Eclipse IDE. This can be done calling mvn eclipse:eclipse command after calling mvn install:

simdrom # mvn install
simdrom # mvn eclipse:eclipse