Download and Installation version 2.5.1 ("Version 2")

From Geoikia-english

Jump to: navigation, search

> Main Page > Download and Installation > Download and Installation Installation version 2.5.1 ("Version 2")

Contents

Introduction

The instructions below include download and installation of Geoide Service, Geoide Author and OpenJUMP (including deegree and Geoide plugin).

> See also New Geoide Environment

> See also Geoide Installation Example

Download

> Download geoide-x-gdi-v2.5.1.zip ("Version 2").

Release Notes

> Release Notes Geoide Base Application

Prerequisites:

1. Adobe Flash Player version 9 or above is required to run the Geoide Author. Go to Flash Player download page.

2. Running installation of:

☐ Java version 5 or above.
> Go to Java download page.
☐ Apache Tomcat 5.5 or 6.
> Go to TomCat Download Page
☐ PostgreSQL version 8.2 or above with corresponding PostGIS version (for Oracle version 9i or above is supported)
Image:tip.png The PostGIS version should match with the PostgreSQL version!
> Go to PostgreSQL download page.
> Go to PostGIS download page.
☐ Ant 1.7.1 (apache-ant-1.7.1.-bin.zip) can be downloaded
> Go to apache ant -bin.zip download page.
☐ Ensure that the environment variables JAVA_HOME and ANT_HOME are set up correctly.
> Go to general information on Environment Variables
☐ Set the search path for Java and Ant executables (see system environment variable "path").


3. Ensure you have a server name or domain name available to access the services, e.g. "gis.idgis.nl"

4. The server hosting the Geoide server components must have access to the Internet through http (port 80)

Installation set

☐ a: unzip the file geoide-x-gdi-v2.5.1.zip on a rollout directory on the file system.
☐ b: Open a command window and navigate to the rollout root directory.
☐ c: Show Ant targets by typing 'ant -p' on the command line. ⇒ A list of ant targets will be displayed if ant was installed correctly.

Installation Steps

1. Adapt Tomcat configuration:

  • Change the Tomcat user configuration in TOMCAT_HOME$/conf/tomcat-users.xml (make sure to stop Tomcat first). It is recommended to use an xml editor for changing xml files, e.g. jEdit:
☐ a: add new roles author (privilege to use Geoide Author) and editor (privilege to edit layer data).
☐ b: change the password of user tomcat (e.g. "tomcat"). The user tomcat will be used for the configuration tools in OpenJump.
☐ c: assign role manager to user tomcat.
☐ d: create new user idgis and assign a password (e.g. "idgis"), and roles author and editor. The user idgis will be used for the Geoide Author and editing.
☐ e: create new user latlon and assign a password (e.g. "latlon"), and role editor (to test editing authorization).
☐ f: (optional) create other users with roles author and/or editor as needed.
☐ g: (optional) remove unnecessary tomcat users.


☐ Image:tip.png Make sure that $TOMCAT_HOME/common/lib (Tomcat 5) or $TOMCAT_HOME/lib (Tomcat 6) contains the jdbc driver for the database used by Geoide Author (ojdbc*.jar for Oracle or postgresql*jdbc3.jar for PostgreSQL). These jar files can be found in the libs folder of the downloaded Geoide distribution, see Download above.
☐ If you are using a new Tomcat instance, then make sure that the "crossdomain.xml" file from the distribution zip (folder "webapps/geoide-x-gdi" has been placed in the folder "ROOT" of the Tomcat "webapps" folder.
  • Make sure that Tomcat runs with enough memory:
For Windows: open the Tomcat monitor application and click the tab Java.
☐ a: value of maximum memory pool must be preferably 1024 MB
☐ b: in the "Java Options" box add the following line:
-XX:MaxPermSize=256m
☐ c: in the "Java Options" box add and change to your settings the following lines if a proxy server is used:
  • Dhttp.proxySet=true
  • Dhttp.proxyHost={hostname}
  • Dhttp.proxyPort={port}
Note! When installing in a Windows environment it might be necessary (in case the user is not automatically logged-on to the proxy server) to run Tomcat on a domain account that has access to the proxy server. This can be accomplished in the following manner:
  • Go to services (Control-Panel → Administrative Tools → Services)
  • Right-click on 'Apache Tomcat' → Choose 'Properties'
  • Goto tab 'Log On'
  • Choose 'This account:'
  • Input the credentials of the domain account
  • Click OK
  • Reboot 'Apache Tomcat' service
For UNIX:
☐ Enter the following line before starting tomcat in an UNIX environment
'export CATALINA_OPTS="-client -server -Xms128M -Xmx1500M"'

2. Adapt Geoide configuration to your environment

☐ a: Create a folder on the file system as location for the geoide server configuration (e.g. "geoide-server-config"). The Tomcat service must have read access to this folder.
☐ b: Adapt at least the following settings in the config.properties file in your rollout root folder
(Image:tip.png You will find useful information on settings as comments in the "config.properties' file):
  • database connections (*.dbserver.* variables; we suggest database names 'hauskoordinaten', 'x-border' and 'x-gdi-author'.)
  • geoide server configuration location (config.base). Note: the location as choosen in step 2a.
  • webserver information (webserver.* variables). Note: hostname and port of Tomcat instance
  • location and login for the Tomcat Manager (cfg.webserver.* variables)


☐ c: Uncomment the right version (PostgreSQL or Oracle):
In the config.properties one PostgreSQL version (default) and one Oracle version off settings are available for the x-border and the geoide_author databases.
For Oracle:
When using Oracle databases, uncomment the Oracle settings and comment the postgreSQL settings.
Image:tip.png When working with Oracle set the variable hauskoordinaten.dbserver.enabled "false", because there is no Oracle version of the hauskoordinaten database available.

3. Prepare databases

For PostgreSQL / PostGIS:
Create (if necessary) the databases configured in the previous steps. The hauskoordinaten and x-border databases have to be spatially enabled. We suggest database names 'hauskoordinaten', 'x-border' and 'x-gdi-author'. These database names should match the names configured in the 'config.properties' file in step 2a.
☐ a: Start pgAdmin
☐ b: Double-click on database server
☐ c: Right-click on databases and select 'New database...'
☐ d: Fill in 'Name'
☐ e: Choose 'Encoding': 'UTF8'
☐ f: For the spatially enabled databases ('hauskoordianten' and 'x-border'): Choose template: 'template_postgis'. (For the 'x-gdi-author' database, no template is needed).
For Oracle:
The different database schema's (x_border and geoide_author) are to be installed in different tablespaces. In order to be able to point the application to the correct tablespace a separate user has to be created for every tablespace. We suggest to use tablespace names x_border and geoide_author and usernames x_border and geoide_author. The usernames should match the names configured during step 2.
☐ a: Connect as the database as DBA
☐ b: Create tablespace using sql command:
CREATE TABLESPACE tablespace name
DATAFILE 'path on server/tablespace name.dbf' SIZE 10M AUTOEXTEND ON NEXT 5M MAXSIZE 50M
☐ c: Create a user with the appropriate rights granted:
CREATE USER username IDENTIFIED BY username
DEFAULT TABLESPACE tablespace name
QUOTA UNLIMITED ON tablespace name
GRANT CONNECT TO username
GRANT CREATE VIEW TO username
GRANT CREATE TABLE TO username
GRANT CREATE SEQUENCE TO username
GRANT CREATE TRIGGER TO username

4. Create databases

☐ a: Open a command window and navigate to the rollout root directory.
☐ b: Create all database schemas and tables by typing on the command line 'ant create-db-schemas'

5. Create Geoide server configuration files

☐ a: Open a command window and navigate to the rollout root directory.
☐ b: Run 'ant config'. As a result a new folder named "dist/config" containing three sub folders "cfg", "geoide-wfs" and " geoide-x-gdi" will be created.
☐ c: Copy the sub folders created in the previous step to the location as set in 2a as "geoide-server-config" location.
☐ d: Make sure the Tomcat service has read access to the "geoide-server-config" folder, e.g. on Linux: sudo chown -RFV tomcat6: nogroup /path_to/geoide-server-config

6. Prepare and deploy application:

☐ a: Open a command window and navigate to the rollout root directory.
☐ b: Create wars (readily configured for deployment) by typing on the command line 'ant build-all-wars'
☐ c: Deploy all wars ('geoide-x-gdi.war', 'geoide-wfs.war' and 'cfg.war') created in folder 'dist' into TomCat:
  • Stop the TomCat service
  • Copy the *.war files to the webapps directory of TomCat
  • Start TomCat service

7. Open geoide-x-gdi application:

☐ a: Point your browser to the geoide-x-gdi application (http://<server:port>/geoide-x-gdi/) e.g. http://localhost:8080/geoide-x-gdi (URL depends on your tomcat installation)

8. Make backups:

Image:tip.png It is recommended to make backups from your databases on a regular bases (e.g. for PostgreSQL databases with the pgAdminIII Backup option)

OpenJUMP

  • Start OpenJUMP using \bin\openjump.bat

OpenJUMP (including the deegree and Geoide plug-in) is part of the installation files but can be downloaded seperately as well:

Download the latest version of OpenJUMP

Retrieved from "http://geoikia.idgis.eu/wiki-english/index.php/Download_and_Installation_version_2.5.1_%28%22Version_2%22%29"
Personal tools