Using the Windows Package¶
In order to quickly get started with the training you can follow the steps below:
- Download and unzip the training package into a local folder avoiding spaces in the path (for safety reasons).
- Double click on postgis_start.bat to start PostGIS, then wait for a few seconds. A DOS CMD window should pop up and remains open pointing out that PostGIS is running well (“PostgreSQL is starting” should be visible).
- Double click on tomcat_start_1.bat, this will start an instance of GeoServer. A DOS CMD window should pop up and remains open highlighting that GeoServer is working well; 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 that the required ports on your computer (5434, 8083, 8009, 80) are not busy. Make sure that Skype is not running as sometimes it silently occupies ports which we need for GeoServer.
Training Content¶
Here below the contents of the training package are described.
README.txt
Contains legal notes.
data
Contains all the data used for the demo, the GeoServer plugins as well as the GeoWebCache data directory.
geoserver_data
The GeoServer data dir.
setenv.bat
Used by most of the script to setup the environment, to change the Java version and the GeoServer data dir. This file can be edited appropriately.
jdk
The embedded Java Virtual Machine.
OSGeo4W.bat
Used to open a GDAL shell needed to run all the GDAL/OGR processing scripts encountered in the training.
postgres
The standalone PostgreSQL + PostGIS installation folder (contains the ‘data’ directory with the databases).
pgAdmin.bat
Starts the PostgreSQL PgAdmin admin interface.
postgis_setup.bat
Optional script to recreate the Postgres database (makes use of setenv.bat).
postgis_start.bat
Starts the postgres server (makes use of setenv.bat).
postgis_stop.bat
Stops the postgres server (makes use of setenv.bat).
tomcat
Contains three differents instances of tomcat.
tomcat_start_1.bat
- Starts the first tomcat instance (makes use of setenv.bat).
Used by the main Geoserver and the Map application.
tomcat_start_2.bat
- Starts the second tomcat instance (makes use of setenv.bat).
Used by the another Geoserver for clustering.
tomcat_start_3.bat
- Starts the third tomcat instance (makes use of setenv.bat).
Used by activemqBroker for clustering.
tomcat_stop_1.bat
Stops the first tomcat instance (makes use of setenv.bat).
tomcat_stop_2.bat
Stops the second tomcat instance (makes use of setenv.bat).
tomcat_stop_3.bat
Stops the third tomcat instance (makes use of setenv.bat).
udig
Contains the udig standalone installation.
udig.bat
Starts uDig.
- Additional tools needed in different training sections:
- Apache-httpdapache-jmetergdalldaplibjpeg-turbonppPython
As you can see this package contains all that you need to have a fully functional environment to run GeoServer and GIS tools 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¶
- Start the tomcat_start_1.bat file, open the browser and go to the GeoServer administration page (username: admin, password: Geos)
- The GeoServer administration page should load.
Note
On low spec hosts GeoServer can take up to 5 minutes to start up.
- Click on “Layer Preview”, search for Boulder and, for example, open the layer “BoulderCityLimits” with OpenLayers:
- An interactive map of the current layer should open in a new tab.
- Start the pgAdmin.bat file (in case of error check the version of the Microsoft Visual C++ Redistributable installed on your machine) then create a new connection with the following parameters:
- Host: localhost
- Port: 5434
- Username: postgres
- Password: postgres
- Open the new connection.
- A list of databases should open.