Download and Installation Geoide-Demo-Application

From Geoikia-english

Jump to: navigation, search

> Main Page > Download and Installation > Download and Installation Geoide-Demo-Application

Contents

Introduction

The instructions below describe download and installation of the Geoide Demo Application. The Geoide Demo Application consists of the Geoide Base Application Version 1.2 and prepared configuration for demonstration purposes. After successful installation of the Geoide Demo Application, you should have created an Geoide application as shown online:

> Geoide Demo Application online version

With the Geoide Author you can easily adapt the application and transform it to your own needs.

The instructions below include download and installation of the following components:

  • Geoide Base Application Version 1.2
  • Geoide Service
  • Geoide Author
> See also New Geoide Environment

The instructions below describe also the creation of two databases, which are needed for the Geoide Demo Application. The Geoide Author database will be prepared using an "ant" commando and filled using the import-export-tool. The Geoide Demo database will be created using PgAdmin and filled using the sql-file which comes with the installation.

Geoide Demo Application Functionality

The Geoide Demo Application has been configured to show the functionality of the Geoide Base Application using more or less arbitrary map data.

> View list of Geoide Functionality.

Image: tip.png The Map data as used in the Geoide Demo Application is meant for demonstration purposes only.

Download

> Download geoide-demo-app-v2.zip.

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.
Image:tip.png The PostGIS version should match 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 Windows Vista and Windows 7
> Go to general information on Environment Variables Windows XP
☐ Set the search path for Java and Ant executables (see system environment variable "path").


3. Ensure you know the URL for accessing the services from outside.

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-demo-app-v2.zip" on a rollout directory on the file system.
☐ b: navigate to the rollout directory.
☐ c: unzip the file "geoide-server-config.zip" on the file system as location for the geoide server configuration. The Tomcat service must have read access to this folder.
☐ d: unzip the file "geoide-import-export.zip" on the file system. (Used for importing data to Geoide Databases).
☐ e: Open a command window and navigate to the rollout root directory.
☐ f: 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 demo, geoide, author (privilege to use Geoide Author) and editor (privilege to edit layer data).
☐ b: create new user idgis and assign a password (e.g. "idgis"), and roles author, editor, geoide and demo. The user idgis will be used for the Geoide Author and editing.
☐ c: (optional) create other users with roles author and/or editor as needed.
☐ d: (optional) remove unnecessary tomcat users.

EXAMPLE 

<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
  <role rolename="demo"/>
  <role rolename="author"/>
  <role rolename="editor"/>
  <role rolename="geoide"/>
  <user username="demo" password="demo" roles="geoide,demo"/>
  <user username="idgis" password="idgis" roles="author,editor,geoide,demo"/>
</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 (postgresql-8.4-701.jdbc4.jar for PostgreSQL). This jar files can be found in the libs folder of the downloaded Geoide distribution, see above.
☐ If you are using a new Tomcat instance, then make sure that a "crossdomain.xml" has been placed in the folder "ROOT" of the Tomcat "webapps" folder.
> Read more about cross domain policy by Adobe.
> Download example file crossdomain.xml or copy past from: 
<?xml version="1.0"?>
<cross-domain-policy>
    <allow-access-from domain="*" />
    <allow-http-request-headers-from domain="*" headers="*" />
</cross-domain-policy>
  • 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}
Image:tip.png 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: Adapt at least the following settings in the "config.properties" file in your rollout root folder
  • webapp location (geoide.webapp.host) and port (geoide.webapp.port). Default 'geoide_demo_v2'.
  • geoide server configuration location (geoide.config.directory)). Note: the location as choosen above.
  • settings for Geoide Author database (geoide.authordb.*). Default 'geoide_demo_v2_author'.
  • You can leave the security settings as it is.
☐ b: Navigate to the folder "/geoide-server-config/geoide-demo-v2/wfs" and adapt in the "wfs_configuration.xml" the DefaultOnlineResource to your environment.

EXAMPLE 

<deegreewfs:DefaultOnlineResource xlink:href="http://localhost:8080/geoide_demo_v2/ogcwebservice"

3. Create Author Database

☐ a: Open a command window and navigate to the rollout root directory.
☐ b: Create author database by typing 'ant create-author'
Fill Author Database:
The import-export tool will be used to fill the database. In this case the export has been prepared, so only an import is necessary.
☐ c: Open a command window and navigate to the to the folder "geoide-import-export" (see above)
☐ d: Type the import command (adapt if necessary host name and port): 

java -jar geoide-author-import.jar import -h localhost -p 5432 geoide_demo_v2_author postgres postgres geoide-demo-v2-author.xml
> More information on the ImportExport tool

4. Create Geoide Demo Database

Create the database "geoide_demo_v2" database:
☐ a: Start pgAdmin
☐ b: Double-click on database server
☐ c: Right-click on databases and select New database...
☐ d: Fill in Name: 'geoide_demo_v2'
☐ e: Choose Encoding: 'UTF8'
☐ f: Choose template: 'template_postgis'
Fill the "geoide_demo_v2" database:
☐ g: Click on Database geoide_demo_v2
☐ h: Click on SQL in the pgAdmin menu
☐ i: Open file "geoide-demo-v2.sql" (located in folder "geoide-import-export")
☐ j: Execute query

5. Prepare and deploy application:

☐ a: Open a command window and navigate to the rollout root directory.
☐ b: Create war (readily configured for deployment) by typing on the command line 'ant'
Image:tip.png The geoide_demo_v2.war has been created in the folder "dist". A "geoide-config-geoide-demo-v2.zip" has been created as well. You can ignore this file (it is a basic "geoide-server-config" folder for building a Geoide Installation from scratch).
☐ c: Deploy the war ("geoide_demo_v2.war") created in folder 'dist' into Tomcat:
  • Stop the Tomcat service
  • Copy the "geoide_demo_v2.war" file to the webapps directory of TomCat
  • Start TomCat service

6. Adapt server locations

☐ a: Fire up the Geoide Author (http://<server:port>geoide_demo_v2/author/author.jsp) (URL depends on your Tomcat installation).

EXAMPLE 

http://localhost:8080/geoide_demo_v2/author/author.jsp
☐ b: Login using username: 'idgis' and password: 'idgis'
☐ c: Click on tab Servers
☐ d: Navigate to "Geoide_Demo-WFS" and check the "Online Source" and adapt if necessary to your environment

EXAMPLE (as installed for access via support.idgis.eu) 

http://support.idgis.eu/geoide_demo_v2/ogcwebservice?
☐ e: Navigate to 'Geoide-demo-GI' and adapt the 'Online Source' to your environment

EXAMPLE (as installed for access via support.idgis.eu) 

http://support.idgis.eu/geoide_demo_v2/giservlet?

6. Open Geoide Demo Application

☐ a: Fire up the Geoide Demo Application index page (http://<server:port>geoide_demo_v2/author/) e.g.

EXAMPLE 

http://localhost:8080/geoide_demo_v2/author/ (URL depends on your Tomcat installation)
This looks like:
☐ b: Choose a 'Map context' and 'GUI config' and click Start Geoide Viewer (use 'Ctrl'+ 'click' to open in a new tab)

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)

Retrieved from "http://geoikia.idgis.eu/wiki-english/index.php/Download_and_Installation_Geoide-Demo-Application"
Personal tools