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.
Here below the content of the training package is described.
Contains legal notes
Contains all the data used for the demo, the GeoServer plugins as well as the GeoWebCache data directory.
The GeoServer data dir.
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.
The embedded Java Virtual Machine.
The standalone PostgreSQL-9.2 + PostGIS-2.0 installation folder (contains the ‘data’ directory with the databases).
Starts the PostgreSQL PgAdmin III admin interface.
Optional script to recreate the postgres database. (uses setenv.bat).
Starts the postgres server (uses setenv.bat).
Stops the postgres server (uses setenv.bat).
Contains three differents instances of tomcat.
- Starts the first tomcat instance (uses setenv.bat).
Used by the main Geoserver and the Map application
- Starts the second tomcat instance (uses setenv.bat)
Used by the another Geoserver for clustering
- Starts the third tomcat instance (uses setenv.bat)
Used by activemqBroker for clustering
Stops the first tomcat instance (uses setenv.bat)
Stops the second tomcat instance (uses setenv.bat)
Stops the third tomcat instance (uses setenv.bat)
Contains the udig standalone installation
- Additional tools needed in different training sections
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.
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.
In order to quickly get started with the training the attendee can perform the following steps:
- Explode the training package into a local folder to a path with no spaces (for safety reasons).
- Download and unzip the material inside the exploded directory for the training package
- Enter the docs directory and double click on the index.html. This should open up the start page in your default browser.
- 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).
- 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.
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.