1. What do I need to run TerraAmazon?

TerraAmazon needs a client-server configuration. It is required to have TerraAmazon installed and a database management system (DBMS) set up. However, different set ups are possible.

a. For trying out TerraAmazon or for learning purposes
If you intend to try TerraAmazon and find out what you can do with it or if you intend to learn how it works, you may have both client and server applications running in the same computer. You can use a regular desktop or a laptop running Windows XP or above. TerraAmazon has been homologated running Windows XP Professional with Intel R 2.66GHz (4 processors).

b. For project development purposes
If you intend to develop projects with a large amount of data set up for multi-user work inside a corporate environment, then a server is necessary, along with a client computer for each user. In this set up, client computers can be either desktops or laptops. TerraAmazon has been homologated as below.

i. Client computers: Windows XP Professional Intel R 2.66GHz (4 processors)
ii. Main Server can run Windows or Linux. DBMS for homologation was PostgreSQL 8.4.7/ 32-bit or PostgreSQL 8.4.8/ 64-bit and PostGIS 1.5 for PostgreSQL 8.4.
iii. Server running Windows: Windows Server 2008 R2 Enterprise Intel Xeon 4Gb 64-bit 2.0GHz (2 processors)
vi. Server running Linux: Mandriva Intel Xeon 4Gb 32-bit 1.6GHz (2 processors)

2. Which DBMS should I use?

TA has been homologated using PostgreSQL and PostGIS

It accepts other database management systems supported by TerraLib: Access, SQL Server, OracleADO, MySQL, Oracle Spatial and Oracle OCI. However, it is possible that some of these will not accept the creation of the Conceptual Model.

3. How do I know which PostGIS version I have installed?

Open the SQL window in pgAdmin and run the sql line:

select postgis_version()

If this line returns an error, then you do not have PostGIS installed.

4. How do I backup and restore databases?

Consider the use of PostgreSQL. For other DBMSs, please refer to their respective help tools to obtain their backup&restore procedures.

a. Backup

When working with PostgreSQL, open pgAdmin, right-click on the database and select Backup. Type the file name and click Ok.

b. Restore

Open pgAdmin and create a new database. Right-click on it and select Restore. Search for the backup file and click Ok. After the restoration is finished, open the SQL window and run the following line replacing "name_of_your_DB" with the name of the DB you have previously created for the restoration:

ALTER DATABASE "name_of_your_DB" SET search_path=public, sisprodes, terralib, raster;

5. Why can´t TerraAmazon list the existing databases?

There are several situations that can cause TerraAmazon not to connect to the databases or even show the list of the existing ones.

a. The server is down

When the server´s service is stoped it is not possible to access the databases. There are several situations that can stop the service, such as an undesired restart on the server due to power failure, Windows automatic updates and so on. To start the service again, locate PostgreSQL on the start menu and click on Start Server. It is necessary to login directly on the server computer to be able to do this.

b. The firewall is blocking the port used by the DBMS

When first installing a DBMS on the server, it might be needed to configure the Firewall not to block the port used by the DBMS. When working with PostgreSQL, this port is defined during the installation. To find the port number, open pgAdmin and locate the server in the servers tree: the port number is informed along with the database name and host.

Access the Windows Firewall and configure it to open the port by informing it´s number. Each Windows has a different way to do that, please refer to Windows´ help pages for the procedures. It is necessary to login directly on the server computer to be able to do this.

c. Network connection is down

When working on corporate environment, network configurations can be very complex. At first, check if the network cable is correctly plugged in. If so, contact IT personnel to locate possible failures. When working locally, with both client and server applications running on the same machine, disconsider this situation.

d. For other situations, please refer to the DBMS´s help pages.

6. Can I have more than one version of TerraAmazon installed?

Yes. There is no problem with having different TerraAmazon versions installed in the same computer.


7. Can I run more than one TerraAmazon simultaneously? What if they are different versions?

Yes. You can run more than one TerraAmazon simultaneously. However, if they are different versions it might not be possible to use them to connect to the same database, depending on to the upgrades made.

8. When implementing a database, can I import several vector data at once?

No. TerraAmazon does not yet provide a tool for multi vector import.

9. When implementing a database, can I import several images at once?

Yes. The Import Raster tool accepts single or multiple raster files at once. Please refer to the Administrator User Guide for instructions.

10. What is the Conceptual Model? Why is it not created automatically?

The Conceptual Model represents the internal structure of tables which enables every multi-user and project configuration. This structure is not native on TerraLib.

The conceptual model is not automatically created because TerraAmazon must be able to connect to databases built by other TerraFamily applications, such as TerraView, without causing them changes. For that reason, TerraAmazon requires that the conceptual model is intentionally created when needed

11. When do I need the Conceptual Model?

The creation of the conceptual model is required only when user control is needed or if there is the intention of performing vectorial editions through projects in the database. Please refer to the Administrator User Guide for more details.

12. Does the Conceptual Model define a projection for the database?

No. The Conceptual Model DOES NOT define a projection for the database. The Conceptual Model defines only the projection of the cell layer and, as a consequence, the projection that the layers involved in the classification process should have. Such layers are the ones defined by the rules active on the project.

13. How do I define a projection for the database?

TerraAmazon does not use the concept of a projection for the database. Each data is stored in the database in its own projection. TerraAmazon manipulates data as they are, only reprojecting data during some specific activities, such as visualization and some spatial operations, but only for processing purposes: the data´s original projection remains unchanged.

14. Once the Conceptual Model is created, is it possible to change the cell layer?

Yes. Cell layers can be created any time. Check the procedure in the Administrator User Guide. It should be clear that the cell layer is used by the classification process before storing the data in the output layer and when applying rules that have a cell column informed. This means that these layers (outputs and rule layers that have cell column informed) need their cell column updated to meet the ones from the new cell layer.

15. Is it possible to copy data directly from one database to another?

Yes. The Copy Data tool sends a copy of the selected layers directly into another database without having to export/import data. The involved databases may be hosted in different servers. Check the Administrator User Guide for the procedures. Databases created with different versions of TerraAmazon may not be compatible for data copy between them.

16. How do I reproject data?

Data can be reprojected in two ways:

a. Creating a New Layer (vector and raster)

To reproject data by creating a new layer, first create a theme pointing to the original layer and then right click on it to select the option Create Layer From Theme. Type a name for the new layer and select the projection.

b. Using the DIP plugin (raster only)

To reproject a raster file, open the DIP plugin and go to Image Processing Raster Remap. Select the desired projection in the tab Projection and type the name of the resulting layer in the Output tab.

17. Why is it that sometimes I cannot visualize the themes generated by a Project View?

The Project View creates themes visible only within the scale range of 1/1 to 1/1000000. To remove this setup, right-click on each theme, select Visualization Scale and uncheck the Set Scale box.

18. Why can´t TerraAmazon export vector layers that will result in shapefiles larger than 2Gb?

Shapefile files have a size limitation of 2Gb for each of its component files. This is not a TerraAmazon limitation, but a characteristic of the file type. Component file´s have the following extensions: .shp, .shx, .dbf. Notice that each file is individually subject to this limitation and that the sum of the file sizes may exceed 2Gb. If a vector layer created in TerraAmazon should result in a shapefile larger than this limit once exported, it is necessary to tile it into parts of smaller size and then export each one individually or define smaller groups of data using Vectorial Themes Export or Vectorial Grouping Export and so allow the vectorial exportation.