Installation - dice-project/DICE-Simulation GitHub Wiki

Option A: Download a pre-built package [RECOMMENDED]

From version 1.2.0 on, you can find pre-built packages ready to be executed in the releases section.

Just download the package for your platform (Windows, Linux, or MacOSX), decompress the ZIP/TAR.GZ file, and run the dice-simulation.exe / dice-simulation executable.

Pre-built packages also include a built-in JRE, so no previous installation of Java is required to execute the DICE Simulation tool.

NOTE for Mac OS X users: The pre-compiled package is an unsigned application, and as such, Gatekeeper may consider it unsafe. In such a case, run the following command to mark the application as trusted: xattr -d com.apple.quarantine Eclipse.app.

Option B: Installing from scratch

To install the DICE Simulation Tool from scratch you need the Eclipse installer.

IMPORTANT: The Eclipse installer installs everything on demand using your Internet connection. The installation may take a long time in slow connections and may be affected by traffic peaks in the Eclipse mirrors.

You have several alternative ways of using the Eclipse installer to install the DICE Simulation tool.

Option B1: Using the installer in portable mode

First, download the Eclipse installer and execute it. Then:

• If your OS supports drag & drop of links from your browser (e.g., Windows), you can simply drag any of the setup links below (depending on the version you want to install) and drop it over the title area of the installer.

  

• If your OS does not support drag & drop, simply copy any of the setup links below. While the link is in the clipboard, open the side menu of the installer (the three horizontal lines on the top right corner, or CTRL + M / COMMAND + M), and select the option APPLY CONFIGURATION. There is no need of pasting the link.

  Please note that the APPLY CONFIGURATION menu entry will appear ONLY if you copy the setup link BEFORE opening the side menu.

  

Setup links

NOTE: We strongly recommend installing a specific (numeric) version. Latest installation may break with unmet dependencies when upstream repositories are updated inadvertently.

• DICE Simulation Tools (1.3.0)

• DICE Simulation Tools (1.2.0)

• DICE Simulation Tools (1.1.1)

• DICE Simulation Tools (1.1.0)

• DICE Simulation Tools (1.0.0)

• DICE Simulation Tools (0.7.2)

• DICE Simulation Tools (0.7.1)

• DICE Simulation Tools (0.7.0)

• DICE Simulation Tools (latest)

Option B2: Using a persistent installer or registering the installer to be persistent

You can also opt for installing the installer in your system (if you have not done it before). This can be done by opening the side menu of the installer (the three horizontal lines on the top right corner, or CTRL + M / COMMAND + M), and enabling the option WEB LINKS.... The installer will ask for permission to register a handler for web links and to store itself in a permanent location.

Once you already have a permanent installer in your system, you can simply open any of the installation links with the eclipse+installer: protocol available at https://dice-project.github.io/DICE-Simulation/static/installation-links.html

Option C (only for advanced users): Installing on top of an existing Eclipse installation

In the running Eclipse instance, go to Help -> Install New Software... and use https://dice-project.github.io/DICE-Simulation/updates as the URL for the update site to install the latest version.

To install older versions, please check the list of Archived Update Sites and the compatibility between Eclipse and the DICE Simulation Tool versions.