Training Content

The purpose of this section is to provide attendees with basic information on the structure and content of this training.

We have strived to provide a self-contained package comprising the various executables as well as the data used throughout the training itself in order to ease the life of the attendees by requiring minimal installation effort.

In order to allow us to separately update the training documentation from the downloadable package itself, the documentation is usually available separately for download, while the online version can be viewed at this link. We advise to unzip the documentation inside the uncompressed training package side-by-side with the other folders we are going to describe afterwards.

Note

The zip package ships an embedded pre installed JRE 7 version, using those packages you implicitly accept this license. For more details visit this page.

Training Content

Here below the content of the training package is described.

  1. README.txt

    Contains legal notes

  2. data

    Contains all the data used for the demo, the GeoServer plugins as well as the GeoWebCache data directory.

  3. geoserver_data

    The GeoServer data dir.

  4. setenv.bat

    Used by most of the script to setup the environment, to change the used Java version, the GeoServer data dir and most of the other environment settings, edit this file.

  5. jdk

    The embedded Java Virtual Machine.

  6. postgres

    The standalone PostgreSQL-9.2 + PostGIS-2.0 installation folder (contains the ‘data’ directory with the databases).

  7. pgAdmin.bat

    Starts the PostgreSQL PgAdmin III admin interface.

  8. postgis_setup.bat

    Optional script to recreate the postgres database. (uses setenv.bat).

  9. postgis_start.bat

    Starts the postgres server (uses setenv.bat).

  10. postgis_stop.bat

    Stops the postgres server (uses setenv.bat).

  11. tomcat-7.0.72

    Contains three differents instances of tomcat.

  12. tomcat_start_1.bat

    Starts the first tomcat instance (uses setenv.bat).

    Used by the main Geoserver and the Map application

  13. tomcat_start_2.bat

    Starts the second tomcat instance (uses setenv.bat)

    Used by the another Geoserver for clustering

  14. tomcat_start_3.bat

    Starts the third tomcat instance (uses setenv.bat)

    Used by activemqBroker for clustering

  15. tomcat_stop_1.bat

    Stops the first tomcat instance (uses setenv.bat)

  16. tomcat_stop_2.bat

    Stops the second tomcat instance (uses setenv.bat)

  17. tomcat_stop_3.bat

    Stops the third tomcat instance (uses setenv.bat)

  18. udig

    Contains the udig standalone installation

  19. udig.bat

    Starts uDig

  20. Additional tools needed in different training sections
    Apache2.2
    apache-jmeter-2.9
    gdal
    ldap
    libjpeg-turbo
    npp
    Python26

As you can see this package contains all that you need to have a fully functional environment to run GeoServer, GIS tools and clients on your datasets.

Important

postgis_setup should never be used. If postgres database fails to work, then the postgres directory inside the training must be manually removed and then postgis_setup must be launched.

Getting Started

In order to quickly get started with the training the attendee can perform the following steps:

  1. Explode the training package into a local folder to a path with no spaces (for safety reasons).
  2. Download and unzip the material inside the exploded directory for the training package
  3. Enter the docs directory and double click on the index.html. This should open up the start page in your default browser.
  4. Double click on postgis_start.bat to start PostGIS, then wait a few seconds. A DOS CMD window should pop up and remain open to signal that PostGIS is working (a sentence that says “PostgreSQL is starting” should be visible, that’s what we expect).
  5. Double click on tomcat_start_1.bat, this will start an instance of GeoServer. A DOS CMD window should pop up and remain open to signal that GeoServer is working; wait until the logging inside the CMD Windows is done then point your browser to this link which will open up the GeoServer user interface.

Warning

If Tomcat or PostgreSQL fail to start check the logs and make sure the required ports on your computer (5434, 8083, 8009, 80) are not busy. Make sure Skype is not running as sometimes it silently occupies ports which we need for GeoServer.