Installation

Prerequisites

The OpenForis Geospatial Toolkit has been developed and tested with various Ubuntu Linux versions. The following installation instructions are targeted to those systems, but also provide information on how to install the OFGT on Mac and Windows (Cygwin).

For more information about how to install the most recent version of Ubuntu on your computer, refer to the Opens external link in new windowofficial Ubuntu documentation.

You first have to make sure to have all necessary gdal and gsl libraries and tools installed. Then you can download the installer and run the installation.

Open the terminal by going to Applications --> System Tools --> Konsole or by typing Crtl + Alt + T.

To make sure all libraries are installed, type:

sudo apt-get install gcc g++ gdal-bin libgdal1-dev libgsl0-dev libgsl0ldbl libproj-dev python-gdal python-scipy python-tk python-qt4 perl

Then download the installer called OpenForisToolkit.run and install it:

  1. wget foris.fao.org/static/geospatialtoolkit/releases/OpenForisToolkit.run
  2. sudo chmod u+x OpenForisToolkit.run
  3. sudo ./OpenForisToolkit.run

When asked to accept the license terms, type 1 and hit enter.

 

Open Foris Toolkit is tested on and we recommend PCLinuxOS. Always ensure that your system is fully updated: Open Synaptic, click Reload to get a current file list, click Mark All Upgrades, click Apply.

  1. If you do not have gdal and gsl libraries and tools installed, install them via Synaptic:
    1. Open Synaptic, click Reload, click Search, then search for the following packages and and mark them for installation: libgdal-devel, gdal, gdal-python, prom, gsl-devel, gsl-progs
    2. Click Apply to install them
  2. Download the OpenForisToolkit.run installer
    wget foris.fao.org/static/geospatialtoolkit/releases/OpenForisToolkit.run
  3. In order to make the installer executable open a Terminal and enter the command:
    chmod u+x OpenForisToolkit.run
  4. Install OpenForisToolkit, enter the command:
    su -c './OpenForisToolkit.run'

 

 

  1. Download wget, make it executable, and copy it into the system: open a Terminal and enter the command:
    chmod a+x wget; sudo cp wget /usr/bin/
  2. Download and install the latest version of the gsl-framework and gdal-complete from kyngchaos:
  3. Download the OpenForisToolkit.run installer
    wget foris.fao.org/static/geospatialtoolkit/releases/OpenForisToolkit.run
  4. To make the installer executable open a Terminal and enter the command:
    chmod u+x OpenForisToolkit.run
  5. Amend the $PATH environment for the installation, enter the command:
    export PATH=/Library/Frameworks/GSL.framework/Programs:$PATH
  6. Install OpenForisToolkit, enter the command:
     sudo ./OpenForisToolkit.run

 

WARNING

ADMINISTRATIVE PRIVILEGES ARE REQUIRED IN ORDER TO PERFORM THE INSTALLATIONS AND EVENTUALLY ALSO TO USE THE APPLICATION. USERS WITH STANDARD PRIVILEGES MAY WANT TO CREATE A VIRTUAL MACHINE WITH VIRTUAL BOX AND UBUNTU 14.04 WHERE ADMINISTRATIVE RIGHTS WILL BE REQUESTED ONLY FOR THE INSTALLATION.

The Cygwin project provides a Linux terminal in Windows.

  1. Download either setup-x86.exe or setup-x86_64.exe
  2. Run it as admin (right-click on setup.exe and Run as [admin credentials])
  3. Click Next
  4. Choose Install from Internet
  5. You may leave the destination folder as C:\cygwin (for All Users)
  6. Choose any local package directory (it will be used for future storage of installers)
  7. Select Direct Connection (unless your connection requirements are different)
  8. Choose a download site, basing on site country domain or known availability, or add your own preferite
  9. If it is a first time installation of CygWin, acknowledge the warning with OK or click on 'Skip' to activate them (if you already have CygWin installed, you could skip the installation or check how the installation may affect the existing version)
  10. During the installation, ensure to flag the following options under the Bin column (use the Search field for a faster retrieval of the needed components: type the package name in the field, expand the correct group, search for the package and click on "Skip" to see it changed to the version number)
    1. under Devel
      1. gcc-g++
      2. make
    2. under Net
      1. wget
    3. under Libs
      1. gsl
      2. gsl-apps
      3. gsl-devel
      4. gsl-doc
  11. Click Next
  12. Flag "Select required packages" and click Next to resolve the related dependencies
  13. Click Next
  14. The installation may take some time
  15. Choose whether or not to create a Desktop and a Start Menu icon
  16. Click Finish

To compile the Open Foris Geospatial Toolkit you need to compile GDAL manually.

  1. Download the installer from the gdal official repository (e.g. gdal-1.10.1.tar.gz)
  2. Save it in your CygWin home folder (e.g. C:\cygwin\home or C:\cygwin64\home) or in another destination of your choice
  3. Run CygWin (NOTE: FOR INSTALLATION, RUN CYGWIN AS ADMIN; Right click on Start > (All) Programs > CygWin > CygWin Terminal and Run as [admin credentials])
  4. Install GDAL using the following commands (the last two can take some time to complete)

cd [folder containing gdal-1.10.1.tar.gz] (e.g. cd C:/cygwin/home, mind the simple slash) 

tar -xvzf gdal-1.10.1.tar.gz

cd gdal-1.10.1

./configure

make

make install

Now you can install OpenForis. Still in CygWin, run the following commands:

wget foris.fao.org/static/geospatialtoolkit/releases/OpenForisToolkit.run 

chmod u+x OpenForisToolkit.run

./OpenForisToolkit.run

  1. After the first installation, you can check the current version info with the command
    oft-info.bash
  2. and update to the latest version using command
    sudo oft-update.bash
  3. You can also uninstall all tools from the geospatial toolkit. To do that, enter the command:
    sudo oft-uninstall.bash
  4. For Windows Cygwin users: In case you do not need further CygWin packages, you can delete the folder created at step 6