Installation Guide RC3
From Fenix
Contents
|
Installation requirements
The GIEWS Workstation 3.0-RC3 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.
We strongly recommend that you use the Firefox2 web browser to download and run the application, other browsers may not support all the Workstation functions. If you do not have Firefox yet, you can download it here.
Installation guide for Windows XP
For New Installations
The following instructions are for installation of the Workstation 3.0 Release Candidate 2 for Windows XP. There are three main stages to the installation procedure:
- Downloading the application
- Installing the application
- Installing the database
Follow this link for the step-by-step instructions.
Special instructions for Upgrades from RC2 to RC3
At the moment, we do not support Upgrade of Workstation from Release Candidate 2 (RC2) to Release Candidate 3 (RC3). If you have installed RC2 and would like to install the latest Workstation, follow these instructions: * Uninstall GIEWS Workstation. * Follow the Installation Guide for downloading ([1]) and installing the application ([2]). * Once in Step 7, do not do anything in your installed Postgres.Click cancel.
Click Exit Setup. * Delete fenix database from Postgre using pgAdmin III.
* Recreate fenix database [3]. * Proceed to [4] Starting the application.
Step 1 Downloading the installer
Click here to download the installer into your local filesystem.
| Package | Description | Size | Downloads |
|---|---|---|---|
| workstation-installer3.0-RC3.exe | For installing the GIEWS Workstation application and Postgres database | 332 MB | Download |
Step 2 Installing the application
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, kindly 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
To run the installer, double-click on the file downloaded in Step 1. This could take up to a few minutes on some machines.
Follow the instructions as shown in the screenshots.
- 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
Follow the steps as shown in the screenshots.
- Click Next
- Click Next
This is the exciting part. You will be shown this screen:
- Select PostGis Spatial Extensions
- Select Entire feature will be installed on local hard drive. .
- Entire feature will be installed on your hard drive
- You will be shown this screen:
- Click Next
- You will be shown this screen:
- Name the service name and the account name as you like. Leave the other fields blank. This screen will come up
- The installer informs you that a password has been generated. Be sure to write down the account name and password for your own administration! Future upgrade may require it as well.
- In the next screen select the UTF-8 encoding and enter the password. Other defaults don't need to be changed. Please remember your Postgres user name and password as this will be used later on in the installation.
- Click Next
- Click Next
- Click Next
- Click Next
Image:Postgres installer step8.JPG
- Click Finish
- You have finished installing the database.
- 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.2 --> pgAdmin III.
- Click on PostgreSQL Database Server 8.2 (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.
A Tomcat Console Window will popup.
- We remind you to use Firefox web browser in order for the application to run smoothly. If you do not have Firefox yet, you can download it here.
- For users who have set Firefox as their default browsers, click on Start Workstation. This will open a browser and launch the welcome page Workstation
- For users who have Firefox but not set it as the default browser, open Firefox then type in the URL http://localhost:8087/fenix-web
You should be able to see this page in your browser:
FAQs and known problems
- 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 Release Candidate 2 for GNU/Linux
Step 1 Downloading the installer for Linux
Click here to download the installer for Linux. 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 xjvf workstation-installer3.0-RC3.tar.bz2
2 cd FenixInstaller
3./install_tomcat
4./install_postgreSQL
5 Open the file /var/lib/pgsql/data/pg_hba.conf and replace these lines:
local all all ident sameuser host all all 127.0.0.1/32 ident sameuser
with these:
local all all trust host all all 127.0.0.1/32 trust
6 start postgreSQL by writing: /etc/init.d/postgresql start
7 ./install_postGIS
7 su - postgres
8 createuser fenix -s
9 exit
10 ./installDB
11 ./install_Fenix
12 ./clean
13 start tomcat by writing: /usr/local/FenixTomcat/bin/startup.sh
