Using the Windows Package

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. 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).
  4. 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.

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.

Verify Everything Works Correctly

  1. Start the tomcat_start_1.bat file, open the browser and go to the GeoServer administration page
  • The GeoServer administration page should load

Note

On low spec hosts GeoServer can take up to 5 minutes to start up

  1. Click on “Layer Preview”, search for Boulder and open the layergroup “Boulder”
  • The preview should load
  1. Start the pgAdmin.bat file and create a new connection with the following parameters:
  • Host: localhost
  • Port: 5434
  • Username: postgres
  • Password: postgres
  1. Open the new connection
  • A list of databases should open