Installation Guide
From Fenix
Contents
|
Installation requirements
The GIEWS Workstation 3.0 installer is currently available for Windows XP and GNU/Linux. The Linux installer works with all rpm-compatible GNU/Linux operating system such as: Red Hat, Fedora, Mandriva, Suse etc.
Installation on other platforms such as Windows NT, Windows Vista, Apple, Unix, etc. has not been tested but should present no problems. If you provide us with remote access, we will perform the installation for you.
To request installation on platforms other than XP or Linux, please contact the GIEWS Workstation team. You can also post any questions about this or other matters in the Forum.
Installation guide for Windows XP
The following instructions are for installation of the Workstation 3.0 for Windows XP. There are four main stages to the installation procedure:
- Downloading the application
- Installing the application
- Installing the database
- Downloading and installing the layers
It is advisable that Java Runtime Environment (JRE) is installed in your machine before proceeding with the GIEWS Workstation installation. If you do not have at least JRE version 1.5, you can download the latest JRE from this site http://www.java.com/getjava.
To check your Java version, click Verify Java version from here http://www.java.com/en/download/installed.jsp
Step 1 Downloading the installer
- Click here to go to the download window. Enter your organization's details and email address in the form and select the Windows option. Click "Download" to download the .zip file containing the installer.
- Extract the files to your folders, they will saved in the folder workstation-installer3.0
Step 2 Installing the application
- In the downloaded .zip file, double-click on the file workstation-installer3.0.exe to run the installer (this could take up to a few minutes on some machines), then follow the instructions as shown below.
- Click Next
- Click Next
- Select I accept the terms of this license agreement
- Click Next
- Please make sure there are no spaces in the installation path!
- Click Next
- Click Next
- Click Next
At this point, the installer for Postgres Database will be launched.
If you receive an error such as this below, for now, please click the "OK" button in order to proceed with the rest of the installation.
Step 3 Installing the database
Click here for the step-by-step instructions for installing PostGres and PostGIS.
- After completing the Database installation, the Workstation installer will continue its installation.
- Click Next
- Click Done. Congratulations, you have finished installing the Workstation!
Step 4 Post-Database Installation
After installing the database, these steps should be performed:
- Creating a user
- Creating the database
Creating a user
- From the Start Menu, click on Programs --> PostgreSQL 8.3 --> pgAdmin III.
- Click on PostgreSQL Database Server 8.3 (localhost:5432)
- Provide the Postgres superuser account's password which was entered in Step 9
- Create a new login role (right mouse click on login roles)
- Fill in details (password should be Qwaszx):
Creating the database
- Enter the details as shown below
Step 5 Starting the application
- From the Start Menu, select Programs --> GIEWS Workstation --> Startup server. This will run the server of GIEWS Workstation which was installed in your computer.
- In case you receive this message, simply click "Unblock"
A Tomcat Console Window will popup.
- Click on Start Workstation. This will open a browser and launch the welcome page with the url: http://[SERVER]:[PORT]/fenix-web
- You may now use the GIEWS Workstation. As a Beginners' Guide, please refer to our Help page here.
Step 6 Downloading and Importing Layers
GAUL0 and GAUL1 Layers are provided within the Workstation Installer. To request other GAUL Layers please contact Fabio Grita fabio.grita@fao.org or Michela Marinelli michela.marinelli@fao.org, stating the purpose for your request and the name of your organization.
You can download other non GAUL Layers here. One .xml file should be downloaded and imported for each .zip file.
Once you have downloaded the files, simply copy them in the following directory and restart the application:
[HOME DIRECTORY]\jakarta-tomcat\webapps\fenix-web\import
FAQs and known problems
- What do I do when I get the message The specified data directory is not empty
Solution:
- Uninstall Postgres installation.
- Delete C:\Program Files\PostgreSQL directory
- What do I do when I get the message User 'postgres'could not be created. The user account already exists!?
Solution: This might happen when a postgres user already exists. You can either delete the user or enter another name, such as postgresWorkstation. You can delete an existing user from Control Panel/Administrative Tools/Computer Management/Local Users > Groups/Users.
- Can I change the password for the database to make it more secure(it now uses a default password)?
Yes you can! Let us know in the Forum if this is a requirement and we will post instructions on how to do this.
- During installation this message pops up: The specified directory is not empty. If you have an existing database with the same major version number, you do not need to initialise a database cluster. If you have an existing database with a different major version you need to backup your old database and create a new one.
Solution: Apparently you already had installed a Postgres database cluster. At point 9.(initialise) of Step 4 Installing the database, deselect "initialise database cluster". This will allow you to continue installation using the previously existing database cluster.
Installation guide for Linux
The following instructions are for installation of the Workstation 3.0 for GNU/Linux
Step 1 Downloading the installer for Linux
- Click here to go to the download window. Enter your organization's details and email address in the form and select the Linux option. Click "Download" to download the .zip file containing installer. The installer works with all rpm-compatible GNU/Linux operating system such as: Red Hat, Fedora, Mandriva, Suse etc.
Step 2 Installing the application
Open a terminal and execute the following commands (all as root user):
1 tar xzvf workstation-3.0.1_installer_rhel5_x86.tgz
2 cd workstation_installer_3.0.1
3./install.sh [SERVER] [PORT] where [SERVER] is your server where the workstation is going to be installed (e.g. ldvapp07.fao.org) and port is the tomcat's port (between 1024 and 8090)
4. start tomcat by writing: /var/tomcat/bin/startup.sh
5. to start the application go to http://[SERVER]:[PORT]/fenix-web.
Step 3 Downloading and Importing Layers
GAUL0 and GAUL1 Layers are provided within the Workstation Installer. To request other GAUL Layers please contact Fabio Grita fabio.grita@fao.org or Michela Marinelli michela.marinelli@fao.org, stating the purpose for your request and the name of your organization.
You can download other non GAUL Layers here. One .xml file should be downloaded and imported for each .zip file.
Once you have downloaded the files, simply copy them in the following directory and restart the application:
/var/tomcat/webapps/fenix-web/import
