Installing Open Foris Geospatial Toolkit

From Open Foris Wiki

Jump to: navigation, search
m
 
Line 1: Line 1:
-
OpenForisToolkit comes with an installer which is frequently updated. '''OpenForisToolkit.run'''
+
The Open Foris Geospatial Toolkit comes with an installer which is frequently updated. It is named '''OpenForisToolkit.run'''.
 +
To run the installer:
-
The installer has been tested with various [http://www.ubuntu.com Ubuntu Linux] versions ans it should work with other [http://www.debian.org/ Debian] based distros as well.
+
== Linux: debian-based distributions (Ubuntu, Debian, etc.) ==
 +
The installer has been tested with various [http://www.ubuntu.com Ubuntu Linux] versions and it should work with other [http://www.debian.org/ Debian] based distros as well.
-
To run the installer:
+
#First make sure that you have installed all the necessary gdal and gsl libraries and tools. If you do not have them then download and install them by using following commands:
 +
##<pre>sudo apt-get install gcc g++ gdal-bin libgdal1-dev libgsl0-dev libgsl0ldbl libproj-dev python-gdal python-scipy python-tk python-qt4 perl</prE>
 +
#Then download the OpenForisToolkit.run installer  
 +
##<pre>wget http://foris.fao.org/static/geospatialtoolkit/releases/OpenForisToolkit.run</pre>
 +
##<pre>sudo chmod u+x OpenForisToolkit.run</pre>
 +
##<pre>sudo ./OpenForisToolkit.run</pre>
 +
::To accept the license terms type 1 and hit enter
-
# if you do not have gdal libraries and tools installed, download and install them using commands:
+
== Linux: rpm-based systems (PCLinuxOS, RedHat, SuSE, etc.) ==
-
## sudo apt-get install gdal-bin
+
Open Foris Toolkit is tested on and we recommend [http://www.pclinuxos.com 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''.
-
## sudo apt-get install python-gdal
+
# If you do not have gdal and gsl libraries and tools installed, install them via Synaptic:
-
# download the OpenForisToolkit-X.XX.run installer (don't forget to replace X.XX with the appropriate version numbers)
+
## 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
-
# chmod u+x OpenForisToolkit-X.XX.run
+
## Click ''Apply'' to install them
-
# sudo ./OpenForisToolkit-X.XX.run
+
# Download the OpenForisToolkit.run installer <pre>wget http://foris.fao.org/static/geospatialtoolkit/releases/OpenForisToolkit.run</pre>
 +
# In order to make the installer executable open a Terminal and enter the command: <pre>chmod u+x OpenForisToolkit.run</pre>
 +
# Install OpenForisToolkit, enter the command: <pre>su -c './OpenForisToolkit.run'</pre>
-
You can check the current version info with the command <pre>toolkitinfo.bash</pre>
+
== Mac OS-X: Lion ==
 +
# Download [https://techtach.s3.amazonaws.com/files/wget wget], make it executable, and copy it into the system: open a Terminal and enter the command: <pre>chmod a+x wget; sudo cp wget /usr/bin/</pre>
 +
# Download and install the latest version of the ''gsl-framework'' and ''gdal-complete'' from [http://www.kyngchaos.com/software/frameworks kyngchaos]:
 +
# Download the OpenForisToolkit.run installer <pre>wget http://foris.fao.org/static/geospatialtoolkit/releases/OpenForisToolkit.run</pre>
 +
# To make the installer executable open a Terminal and enter the command: <pre>chmod u+x OpenForisToolkit.run</pre>
 +
# Amend the $PATH environment for the installation, enter the command: <pre>export PATH=/Library/Frameworks/GSL.framework/Programs:$PATH</pre>
 +
# Install OpenForisToolkit, enter the command: <pre> sudo ./OpenForisToolkit.run</pre>
-
After you have installed teh Toolkit for the first time, you can update is using command <pre>ofupdate.bash</pre>
 
-
and uninstall it with
+
==Windows Cygwin installation==
-
<pre>ofuninstall.bash</pre>
+
'''WARNING'''
-
<pre>http://dl.dropbox.com/u/4143957/OpenForisToolbox/OpenForisToolkit.run</pre>
+
'''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 [http://www.virtualbox.org VIRTUAL BOX] AND [http://www.ubuntu.com UBUNTU 12.04] WHERE ADMINISTRATIVE RIGHTS WILL BE REQUESTED ONLY FOR THE INSTALLATION.
-
In case you want to test the installer and the software, please contact anssi.pekkarinen at fao.org
+
The [http://www.cygwin.com/ Cygwin] project provides a Linux terminal in Windows.
 +
# Download either [http://cygwin.com/setup-x86.exe setup-x86.exe] or [http://cygwin.com/setup-x86_64.exe setup-x86_64.exe]
 +
# Run it as admin (right-click on setup.exe and Run as [admin credentials])
 +
# Click Next
 +
# Choose Install from Internet
 +
# You may leave the destination folder as C:\cygwin (for All Users)
 +
# Choose any local package directory (it will be used for future storage of installers)
 +
# Select Direct Connection (unless your connection requirements are different)
 +
# Choose a download site, basing on site country domain or known availability, or add your own preferite
 +
# 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)
 +
# 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)
 +
## under Devel
 +
### ''gcc-g++''
 +
### ''make''
 +
## under Net
 +
### ''wget''
 +
## under Libs
 +
### ''gsl''
 +
### ''gsl-apps''
 +
### ''gsl-devel''
 +
### ''gsl-doc''
 +
# Click Next
 +
# Flag "Select required packages" and click Next to resolve the related dependencies
 +
# Click Next
 +
# The installation may take some time
 +
# Choose whether or not to create a Desktop and a Start Menu icon
 +
# Click Finish
 +
To compile the Open Foris Geospatial Toolkit you need to compile GDAL manually.
 +
# Download the installer from the [http://trac.osgeo.org/gdal/wiki/DownloadSource gdal official repository] (e.g. [http://download.osgeo.org/gdal/1.10.1/gdal-1.10.1.tar.gz gdal-1.10.1.tar.gz])
 +
# Save it in your CygWin home folder (e.g. ''C:\cygwin\home'' or ''C:\cygwin64\home'') or in another destination of your choice
 +
# Run CygWin ('''NOTE: FOR INSTALLATION, RUN CYGWIN AS ADMIN; Right click on Start > (All) Programs > CygWin > CygWin Terminal and Run as [admin credentials]''')
 +
# Install GDAL using the following commands (the last two can take some time to complete)
 +
<pre>
 +
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
 +
</pre>
 +
Now you can install OpenForis. Still in CygWin, run the following commands:
 +
<pre>
 +
wget http://foris.fao.org/static/geospatialtoolkit/releases/OpenForisToolkit.run
 +
chmod u+x OpenForisToolkit.run
 +
./OpenForisToolkit.run
 +
</pre>
 +
 +
== Get Info, Update, Unistall Open Foris Toolkit ==
 +
#After the first installation, you can check the '''current version info''' with the command <pre>oft-info.bash</pre>
 +
#and '''update''' to the latest version using command <pre>sudo oft-update.bash</pre>
 +
#You can also '''uninstall''' all the tools. To do that, enter the command:<pre>sudo oft-uninstall.bash</pre>
 +
# In case you do not need further CygWin packages, you can delete the folder created at step 6
 +
 +
-----
 +
 +
 +
----
 +
 +
 +
----
 +
[[Open Foris Geospatial Toolkit|Back to Open Foris Toolkit Main Page]]
----
----
-
[[OpenForisToolkit|Back to Open Foris Toolkit Main Page]]
+
<google1 style="3"></google1>
 +
<facelikebutton style="1" showsend="0"></facelikebutton>

Current revision as of 07:58, 27 July 2014

Personal tools