Installation

Table of Contents

This quick tutorial will show you how to download IGMAS+ and how to install and run it on different platforms1.

Download

IGMAS+ is distributed in a form of a Java .jar installation package via the open GFZ GitLab repository IGMAS+ Releases.

You can also pick an older release if necessary.
Track the history of releases here.

Install

Before installation, please check that the correct version of Java Runtime Environment is installed (see requirements).

Install on Windows

  1. Browse to the folder that contains the downloaded installation package file IGMAS-install.jar
  2. Execute the installer by double clicking on the file
  3. The installer starts, select language and follow the instructions of the installer
If the installer doesn’t start after double-clicking check troubleshooting or use the command-line installation.
During installation step 8, mark the appropriate checkbox to create desktop shortcuts, if needed.

Installation using command line:

  1. Open Windows Command Prompt (cmd) or PowerShell
  2. Change directory to the one that contains the installation package file IGMAS-install.jar
  3. Run command:
java -jar IGMAS-install.jar
  1. The installer starts, select language and follow the instructions of the installer.

After installation is completed, IGMAS+ is ready for use with no need to restart the computer.

Install on Linux

to be added

Install on macOS1

to be added

Run

When you run IGMAS+ for the first time you will be asked to choose a layout theme and install a license certificate.

See more information on how to setup IGMAS+

Run on Windows

On Windows start IGMAS+ with a desktop icon or with the app icon in the start menu.

Alternatively:

  1. In Windows Explorer navigate to the bin folder in the home directory where IGMAS+ has been installed, e.g. C:\Users\user\IGMAS+\bin
  2. This folder should contain the file igmas-process-wrapper.jar
  3. Open Windows Command Prompt (type cmd in the Windows Explorer path)
  4. Run the following command in the opened terminal:
javaw -cp ./igmas-process-wrapper.jar; igmas.process.StartIGMASProcess

Run on Linux

to be added

Run on macOS1

to be added

Uninstall

Uninstalling IGMAS+ before installing a new version of the software is generally not required. You can just install the new version on top of the old one. The license status as well as all preferences will remain.

IGMAS+ should not be running during updating/uninstalling.

Uninstall on Windows

To uninstall IGMAS+ simply delete the folders IGMAS+ and .IGMAS+ in the home directory where it was installed, e.g.:

  • C:\Users\user\IGMAS+
  • C:\Users\user\.IGMAS+

IGMAS+ preferences remain in the Windows Registry. When re-installing IGMAS+, these preferences will be applied to the newly installed version of IGMAS+.

To delete the registry directory related to IGMAS+, run Windows Registry Editor (simply type regedit in the start menu or in the Windows Command Prompt) and delete this folder:

Computer\HKEY_CURRENT_USER\Software\JavaSoft\Prefs\igmas

Uninstall on Linux

to be added

Uninstall on macOS

to be added

  1. IGMAS+ supports only macOS versions older than 10.14.
    See more information in requirements. ↩︎ ↩︎ ↩︎

Last updated on Sep 4, 2023