Skip to main content

Requirements

Minimum Requirements​

The Simudyne SDK is a set of libraries in Java/Scala that will require the following to run:

  1. Java JDK 25 (Adoptium Temurin recommended)
  2. Maven
  3. IDE (recommend IntelliJ)

Getting Access​

A free 7-day trial is available for the Simudyne SDK and can be accessed via the AWS Marketplace. More info in the sections below.

Simudyne SDK Free Trial

This AWS instance comes complete with the Simudyne SDK installed, license and access token set up, and a sample project so that you can immediately begin development. Pricing information and AMI options are available below:

Explore Simudyne AMI Options

Note that for purchases via AWS Marketplace, a single additional developer license can be provided for working locally, please contact support@simudyne.com to receive this after purchasing.

Purchasing via Simudyne​

To purchase directly, please contact support@simudyne.com for a quote.

Downloading Options​

If you have purchased an AMI via AWS, the Simudyne SDK will come preinstalled and is ready for development.

If you have purchased the SDK directly you will need to download the required SDK libraries via one of the two methods:

  1. Maven (recommended): Add the Simudyne repository and your credentials to your settings.xml, then declare the SDK dependencies in your pom.xml. A firewall can block authentication and fetching of Maven libraries — check your firewall settings if Maven is being blocked.
  2. Offline Installer: If your security restrictions will not allow Maven to reach the internet, an offline installer is available. Contact support@simudyne.com for access.

Windows​

JDK 25​

It is strongly recommended to download the 64-bit JDK (if your system supports it). Only the 64-bit version allows you to customise the available JVM memory via flags like -Xms and -Xmx.

Download and install Adoptium Temurin JDK 25 from adoptium.net. Select the JDK package for Windows x64.

The Adoptium Termurin JDK is an OpenJDK, thus allowing usage for production and distribution. It is comparable to the Oracle 25 JDK and if you are an enterprise user and allowed to work with and distribute your software you are welcome to install and use the Oracle JDK. Please consult your legal department on correct usage.

The JDK 25 installation path is set by the installer and can be noted from there.

Maven​

  1. Visit the Maven repository and download the latest release.
  2. Extract the file and save it in the C:\Program Files directory.
  3. Right click on the Windows button, in the lower left corner of the screen, and open "Settings".
  4. In the search field, search for and select "Edit the system environment variables".
  5. On the "Advanced" tab, click "Environment Variables".
  6. In "System Variables", add the following variables if they do not exist. Otherwise, edit them accordingly.
Name Value
JAVA_HOME JDK 25 installation path
M2_HOME C:\Program Files\apache-maven-x.x.x
MAVEN_HOME C:\Program Files\apache-maven-x.x.x
PATH Add "%M2_HOME%\bin" to existing variable

To add the Maven home location to the PATH system variable:

  1. Select the PATH system variable.
  2. Underneath the list of system variables, click "Edit".
  3. In the dialog that appears, click "New."
  4. Enter "%M2_HOME%\bin" into the next empty PATH variable row.
  5. Hit "Enter" to save the value.

Finally, check whether the install was successful by running the following command.

mvn -v

If it returns Apache Maven X.X.X, the install was successful.

JVM Module Flags (Runtime — Spark users)​

If your model uses Spark for distributed computation, JDK 25 requires certain JVM module-access flags. These are applied to the JVM that runs your simulation, not to the Maven build itself. Add the following to your MAVEN_OPTS environment variable or to the JVM args of your run configuration:

--add-opens=java.base/java.lang=ALL-UNNAMED
--add-opens=java.base/java.lang.invoke=ALL-UNNAMED
--add-opens=java.base/java.lang.reflect=ALL-UNNAMED
--add-opens=java.base/java.io=ALL-UNNAMED
--add-opens=java.base/java.net=ALL-UNNAMED
--add-opens=java.base/java.nio=ALL-UNNAMED
--add-opens=java.base/java.util=ALL-UNNAMED
--add-opens=java.base/java.util.concurrent=ALL-UNNAMED
--add-opens=java.base/java.util.concurrent.atomic=ALL-UNNAMED
--add-opens=java.base/sun.nio.ch=ALL-UNNAMED
--add-opens=java.base/sun.nio.cs=ALL-UNNAMED
--add-opens=java.base/sun.security.action=ALL-UNNAMED
--add-opens=java.base/sun.util.calendar=ALL-UNNAMED
--sun-misc-unsafe-memory-access=allow
--enable-native-access=ALL-UNNAMED

Hadoop winutils (Data export on Windows)​

If your model uses data export features (Parquet, ORC, CSV, JSON output), Spark requires the Hadoop native libraries on Windows. Download the winutils package:

https://simudynecontent.blob.core.windows.net/$web/hadoop-winutils-3.5.0.zip

Extract to a location such as C:\hadoop, then set the environment variable:

NameValue
HADOOP_HOMEC:\hadoop (or wherever you extracted the archive)
PATHAdd "%HADOOP_HOME%\bin" to existing variable

IDE​

Simudyne recommends using IntelliJ IDEA. This IDE also manages builds, so it is not necessary to install a separate build tool, however it is recommended that the Maven build tool be installed.

Mac OS​

JDK 25​

Run the following command in a terminal to check whether JDK 25 is already installed.

java -version

If the command returns a version number starting with 25, the system already has the proper JDK. Otherwise, download and install Adoptium Temurin JDK 25 from adoptium.net.

Alternatively, install via Homebrew:

brew install --cask temurin@25

Set JAVA_HOME in your shell profile (.zshrc or .bash_profile):

export JAVA_HOME=$(/usr/libexec/java_home -v 25)

Maven​

Make sure Homebrew is installed, then run:

brew install maven

IDE​

Simudyne recommends using IntelliJ IDEA. This IDE also manages builds, so it is not necessary to install a separate build tool, however it is recommended that the Maven build tool be installed.

Linux​

JDK 25​

Install Adoptium Temurin JDK 25. On Ubuntu/Debian:

wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo apt-key add -
echo "deb https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" \
  | sudo tee /etc/apt/sources.list.d/adoptium.list
sudo apt-get update
sudo apt-get install temurin-25-jdk

Verify:

java -version

Maven​

$ apt-cache search maven
$ sudo apt-get install maven

IDE​

Simudyne recommends using IntelliJ IDEA. This IDE also manages builds, so it is not necessary to install a separate build tool, however it is recommended that the Maven build tool be installed.

Last updated on