team   partnership   copyright    search    on   search
+Installation Notes
TerraView  can be installed in both MS-Windows and Linux environments, if they meet the requirements described as follows:

              INSTRUCTIONS TO RUN TERRAVIEW IN MS-WINDOWS

- Download the installation file terraView*.exe (* depends on the version);
- Execute the installation file and follow the instructions presented on the screen;
- After installing, double click the TerraView  icon that has been created in the desktop.


CREATING A DATABASE WITH TERRAVIEW:

To create or connect to a database, you will need one of the following DBMS:

- Microsoft Jet Engine 4.0 (for MS ACCESS databases).
- MySQL server version >= 4.1.1 available at www.mysql.com
- Oracle Server version 10g with spatial extension (Oracle Spatial) together with the OCI (Oracle Call Interface) version 10.
- Oracle Server version 10g without the spatial extension, together with one of the interfaces below:

- ADO driver (ADO Oracle), or
- OCI (Oracle Call Interface) version 10.

- PosgreSQL ou PostGIS version 8.0 or later.
- SQLServer 2000 or later.
- SQLServer 2008 for spatial support.
- Firebird 2.1

NOTE: TerraView  has been tested in Windows 2000/NT/XP. We do not support other Windows versions.

              INSTRUCTIONS TO RUN TERRAVIEW FOR LINUX

The TerraView  application uses the following libraries:

- terralib (library of classes for GIS);
- tiff (standard library for images in the raster format);
- shapelib (library that allows the reading/writing for ESRI´s shapefiles);
- stat (library of classes for Statistics);
- libterralibpdi (library for image processing);
- Qt 3.2 or 3.3.8 (multiplataform toolkit in C++ for the development of graphic interfaces, implemented by Trolltech: www.trolltech.com)

TerraView  for Linux supports the following DBMS: MySQL, PostgreSQL, PostGIS, Oracle and Firebird.

TERRAVIEW REQUIREMENTS

- MySQL server version >= 4.1.1 available in www.mysql.com
- Oracle Server version 10g with spatial extension (Oracle Spatial) together with the OCI (Oracle Call Interface) version 10.
- Oracle Server version 10g without the spatial extension, together the OCI (Oracle Call Interface) version 10.
- PosgreSQL or PostGIS version 8.0 or later.
- Qt library version 3.2 or later;
- shapelib, tiff, stat, libterralibpdi, and terralib libraries provided with the TerraView ;

TERRAVIEW INSTALLATION

The structure of the directories of TerraView  are contained in the terraView*.tar.gz. (* depending of the version)
Supposing we will install TerraView  in the directory /usr/local, we have to uncompress and untar this file through the commands below:

% cd /usr/local
% tar xzvf terraView*.tar.gz

After the execution of these commands, the directory /usr/local/terraView*, that we will call the installation directory, will contain the following directory, files and links:

- csv: directory used for importation of tiff files;
- doc: directory containing the TerraView  help;
- GPL-CC-BR.html: GNU Public License in Portuguese;
- gpl.txt: GNU Public License;
- lglp.txt: GNU Lesser General Public License;
- libclntsh.so.10.1: Oracle library;
- libgcc_s.so.1: gcc library;
- libmysqlclient.so.15 : MySQL shared library;
- libnnz10.so: Oracle library;
- libqt-mt.so.3: Qt library;
- libshapelib.so.1: shapelib library;
- libstat.so.1: statistics library;
- libstdc++.so.6: C++ Standard Library;
- libterralib.so.1: terralib library;
- libterralibpdi.so.1: image processing library;
- libtiff.so.1: tiff library;
- README.txt: this file;
- terraView: the executable file for running TerraView ;
- terraView_pt.qm: binary file that will translate the interfaces to Portuguese during execution time;

ENVIRONMENT VARIABLES

TerraView  needs some environment variables to be set in a file in the user's login directory. If the shell the user is using is bash, the following environment variables should be included in the ".profile" or the ".bashrc" file of the user's login directory:

LD_LIBRARY_PATH=$LD_LIBRARY_PATH:. ; export LD_LIBRARY_PATH
GEOTIFF_CSV=./csv ; export GEOTIFF_CSV

If the shell the user is using is C-shell the environment variables should be set as below:

setenv LD_LIBRARY_PATH $LD_LIBRARY_PATH:.
setenv GEOTIFF_CSV /usr/local/terraView/csv

The LD_LIBRARY_PATH environment variable indicates where are the shared libraries TerraView  needs to run (in the present case in the directory /usr/local/terraView). The GEOTIFF_CSV environment variable indicates that the directory /usr/local/terraView/csv contains the files that are necessary to import tiff files.

The environment variable LANG is necessary if you want to run TerraView  in a different language than English. For example, if you want to run TerraView  with its interfaces and messages translated to Portuguese, you have to set LANG as indicated below:

LANG=pt; export LANG (bash shell)
setenv LANG pt (C-shell)

Actually, Portuguese is the only language besides English that is available in TerraView .


TERRAVIEW EXECUTION

For the TerraView  execution, the following commands should be given:

% cd /usr/local/terraView
% ./terraView

If for some reason the terraView could not be executed, verify whether some library is missing through the following command:

% ldd ./terraView

This command lists all the libraries needed to run terraView. If some library is not found, put the path of the missing library in the LD_LIBRARY_PATH environment variable in your .profile or .bashrc (bash environment), or .cshrc (C-shell) file.