User Tools

Site Tools

2. Installation

You can buy and download a binary distribution of Spatialytics ETL (or get its open source community edition - namely GeoKettle - for free) from

Different packages are available and are designed to make the installation process easier. Depending on your operating system, please choose the most appropriate:

  • spatialytics-etl-x.y.exe is the Spatialytics ETL installer dedicated to Windows platforms.
  • spatialytics-etl.deb is a Debian package that facilitates the installation of Spatialytics ETL on Debian based Linux distro (e.g. Ubuntu).
  • spatialytics-etl-x.y-1.noarch.rpm is a RPM package for easy installation on Red Hat based distributions (e.g. CentOS, Fedora, Oracle Linux, …).
  • spatialytics-etl-x.y.dmg is a Macintosh disk image that embbeds the Spatialytics ETL app for Mac OS X systems.
  • is the zip archive which contains the binary distribution of Spatialytics ETL. It aims at being used on platforms where other installers would not work or for performing a headless installation on a remote server.

The x.y sequence in the filenames refers to the version numbering of Spatialytics ETL (e.g. spatialytics-etl-3.0.exe for the Windows installer of Spatialytics ETL version 3.0).

Similar installation packages are available for GeoKettle. They are named according the following patern: geokettle-x.y.*.

2.1 Prerequisites

Spatialytics ETL requires a Java Runtime Environment (JRE) version 1.5 (also called 5.0 in some naming schemes) or newer. You can obtain a JRE for free from We recommend the use of the Java Runtime Environment from Oracle in production environments but Spatialytics ETL is also known to work with OpenJDK version 6 and 7.

From version 2.0, GeoKettle and Spatialytics ETL runs perfectly on 32 bits and 64 bits versions of Microsoft Windows. Please, visit this page to determine the operating system bit count and download the appropriate version of the Java Runtime Environment (JRE) at

2.2 Installation


Run the spatialytics-etl-x.y.exe file with Administrator privileges. In the first popup window that shows up, confirm you want to install the program by clicking the Yes button.

The installation process starts and a window allowing to choose in which language you want to perform the installation appears.

Select your language (French or English) and click on the OK button. The welcome screen of the installation wizard shows up.

Click on the Next button.

Click Next to continue the installation.

Choose the location where you want to install Spatialytics ETL and click Next to continue.

Select or create the start menu folder in which you would like to create the Spatialytics ETL's shortcuts and click Install.

The installation process starts. When completed, click Next.

Choose if you want to create a shortcut on the desktop and end the installation by clicking on the Finish button.

As illustrated in the figure above, copy the licence file you recieved during your order of Spatialytics ETL in the installation directory of the software (depending on your Windows flavour, C:\Program Files\Spatialytics ETL or C:\Program Files (x86)\Spatialytics ETL by default).


Two installation packages are available for Linux distributions:

  • A Debian package
  • A RPM package

In case your Linux distribution does not rely on one of these packaging systems, please follow instructions given in the Install from the zip archive section below.

Using the Debian package

To install Spatialytics ETL on a Debian based Linux distribution, open a terminal and type:

  sudo dpkg -i spatialytics-etl.deb

If you are not a sudoer or if your OS does not support this mechanism, log as root before isuing the dpkg command.

Copy the licence file you recieved in the installation directory of Spatialytics ETL (defaults to /opt/spatialytics-etl).

Using the RPM package

Installing Spatialytics ETL on a RPM based distro is as simple as on a Debian. Log in first as root and type in a terminal the following command:

  rpm -ivh spatialytics-etl-x.y-1.noarch.rpm

Copy the licence file you recieved in the installation directory of Spatialytics ETL (defaults to /opt/spatialytics-etl).


In the Finder, double click on the .dmg package. The disk image should be mounted automatically and should open as illustrated in the following figure.

Select the Spatialytics ETL app and drag and drop it into the Applications folder. The copy should start and after a few seconds, the Spatialytics ETL app should appear in the Applications folder.

Right-click on the Spatialytics ETL app and select the Show Package Contents item in the contextual menu that displays.

Navigate to the Contents/Resources/Java subdirectory and copy the licence file in this folder.

Install from the zip archive

Unpack the zip archive into a folder of your choice. In this documentation, we will refer the installation directory as spatialytics_etl.

On Unix-like operating systems, you will need to make the shell scripts executable by using the chmod command:

  cd spatialytics_etl
  chmod +x *.sh

On Windows, all batch files (*.bat) are already executable.

Copy the licence file at the root of the spatialytics_etl directory.

To launch the Spoon interface and then start to design a geospatial job or transformation, double-click on the Spoon.bat file on Windows or execute the script on Linux/Unix based systems. Mac OS X systems can also start Spoon by launching the spoon.command script.

2.3 Uninstallation

Uninstalling Spatialytics ETL is very easy but the process differs from an operating system to another.


Click the Uninstall Spatialytics ETL item in the Spatialytics ETL start menu folder and follow the instructions provided by the uninstall program.


On a Debian based distribution

Just type in a terminal:

  sudo apt-get purge spatialytics-etl

If you are not a member of the sudoer group or if your OS does not support this mechanism, log as root before isuing the apt-get command.

On a RPM based distribution

Log in first as root and type in a terminal the following command:

  rpm -e spatialytics-etl-x.y-1.noarch


Open a Finder window, go in Applications. Locate the Spatialytics ETL app and drag and drop it into the Trash.

Other systems

To uninstall Spatialytics ETL, you just have to delete the spatialytics-etl directory.

en/spatialytics_etl/002_installation.txt · Last modified: 2015/04/20 08:26 by lvaillancourt

Page Tools