Installing GeoWebCache

Once the Java Servlet environment is in place:

  1. The geowebcache-war.zip Web ARchive (WAR) file can be downloaded from GeoWebCache.osgeo.org.

  2. Unpack the zip file and make sure to read the software License, and locate the geowebcache.war for deployment.

Option 1: Tomcat Administration Tool

  1. Navigate to http://localhost:8080 (or wherever your Tomcat instance resides) and click the Tomcat Manager on the left hand side.

  2. Find the section WAR file to deploy, and upload geowebcache.war you unpacked from the zip file.

  3. After the upload is complete, look for geowebcache in the Applications table.

  4. Once the application is started, GeoWebCache is available http://localhost:8080/geowebcache.

Option 2: Manual Installation

  1. Tomcat will need to be stopped before making any changes to the webapps directory.

    Ensure that the Tomcat process is stopped before proceeding, as the JVM does not always release file handles immediately.

  2. To manually deploy:

    • Copy the file geowebcache.war to <tomcat dir>/webapps.

      On startup Tomcat will deploy the application to the folder <tomcat dir>/webapps/geowebcache

    • If you wish, you can unpack this archive manually in this location. The geowebcache.war may be treated as a zip file and be unpacked to <tomcat dir>/webapps/geowebcache.

    This approach allows you to make configuration changes before restartig Tomcat.

  3. After restarting Tomcat, GeoWebCache is available http://localhost:8080/geowebcache.

Previous: MacOS X
Next: Upgrading