Installation

[Home] | [Installation] | [About]

---

• Requirements
• Windows native executable
• Linux native executable
• Mac OS X native application
• Multiplatform Jar file

Requirements

The SUMO package should be installed in order to GatcomSUMO can do the most of its functionalities.

Windows native executable

Requirements: Apart from SUMO, in Windows it is necessary the MS-Visual C++ 2010 redistributable runtime.

To install GatcomSUMO, download and execute the installer (e.g. GatcomSUMO-setup-1.0.exe) and follow the instructions.

To uninstall, execute Start > Programas > GatcomSUMO > Uninstall.

In case of installing a new version it is not necessary to uninstall it manually, as it will be uninstalled automatically.

Linux native executable

To install GatcomSUMO:
1. Download the installer (e.g. GatcomSUMO-setup-xxx.bin) to a path without blank spaces.
2. Check that the installer can be executed:

     $ chmod +x GatcomSUMO-setup-xxx.bin

1. Execute it and follow the instructions; it would be necessary to install it as root or using "sudo", depending of the choosen path:

     $ sudo ./GatcomSUMO-setup-xxx.bin

1. Write the installation path (/usr/local/GatcomSUMO by default) and press Intro; the path cannot contains blank spaces.
2. Optionally, you can create a shortcut in the desktop.
   For example, in Ubuntu or Linux Mint:
   5.a) Create a launcher (right-click on the desktop > Create launcher)
   5.b) Right-click > Properties > Drag an icon (.gif, .ico) to top-left of the "Basic" tap.

NOTE: for Linux 64-bit it is possible to obtain the following error:
"Exception in thread "main" java.lang.UnsatisfiedLinkError: exception occurred in JNI_OnLoad"
In this case it is necessary to install the package ia32-libs (ia32-libs-multiarch:i386) and other depending packages.

     $ sudo apt-get install ia32-libs

To uninstall, execute the Uninstall program:

     $ cd /usr/local/GatcomSUMO

     $ sudo Uninstall

Mac OS X native application

To install GatcomSUMO simply uncompress the file 'GatcomSUMO-mac-app-xxx.zip' in any location, for example, in the Applications folder. It contains a single application file (.app) that can be added to the Dock or to the desktop (creating an Alias previously).
This .app file works from Mac OS X Lion 10.8; for older versions you need to execute the JAR file (.jar), as explained below. Alternatively you can build yourself an Application (.app) from the JAR file with "Jar Bundler", including both the .jar file and the libraries that contains the dist folder.

To uninstall, simply drag the .app file to the Trash. Remove any shortcut from the Dock or Desktop too.

Multiplatform Jar file

Simply uncompress the 'GatcomSUMO-jar-file-xxx.zip' file (if needed) and execute it with:

java -jar "GatcomSUMO-xxx.jar" 

NOTE: the visualization of the map can be very slowly with the JAR file; this is why the native compiled executables are recommended.