Initial setup or how the Jetty bundle was built

1) Download Jetty as zip from -> stable-8 (tested with 8.1.16)

Unzip to a location on your computer. The location will be referenced as {JETTY_HOME}.

2) Cleanup the initial-content:

  • Remove files under {JETTY_HOME}/contexts/
  • Remove files under {JETTY_HOME}/webapps/
  • Remove {JETTY_HOME}/contexts-available
  • Remove {JETTY_HOME}/javadoc
  • Remove {JETTY_HOME}/overlays

3) Add the PostgreSQL driver (and optional JNDI support)

  • Download the driver .jar-file from (tested withJDBC41 Postgresql Driver, Version 9.4-1201)
  • Place the driver in {JETTY_HOME}/lib/ext/[postgresql-9.4-1201.jdbc41.jar]
  • (OPTIONAL) Add "jndi" to the OPTIONS-list in {JETTY_HOME}/start.ini

4) Add configuration to serve Oskari frontend files

  • add oskari-front.xml to {JETTY_HOME}/contexts/
  • run 'git clone' in {JETTY_HOME}
  • after clone you have for example a file in {JETTY_HOME}/oskari/
  • optionally modify 'resourceBase' in oskari-front.xml to point to a location where Oskari frontend files are located

5) Configuring oskari-map as root webapp

  • add oskari-map.xml to {JETTY_HOME}/contexts/
  • add to {JETTY_HOME}/resources/
  • (OPTIONAL, requires JNDI support in step 3) configure the database connection parameters (user/password) for OskariPool in oskari-map.xml
  • NOTE! even if JNDI pool has been configured the same connection params are needed in the database creation requires this dual configuration for now.

6) (OPTIONAL) Install and start Redis (required by transport and statistical maps)

  • Download Redis from
  • Start redis-server with default config (localhost:6379)
  • (optional, inherited from if not present) add to {JETTY_HOME}/resources/

7) (OPTIONAL) Install geoserver (required for my places/userlayers/analysis)

  • Download geoserver -> Web archive (.war-file)
  • Unzip the downloaded war-file (produces a folder geoserver with for example folder WEB-INF inside)
  • Copy the folder to {JETTY_HOME}/webapps/geoserver

  • Download WPS-plugin ->

  • Unzip the plugins package to {JETTY_HOME}/webapps/geoserver/WEB-INF/lib

  • Check 'How to update backend code' above in this document (part To update geoserver extensions)

  • Preconfigured Geoserver data dir is available and pre-configured for use in {JETTY_HOME}/geoserver_data. This includes SLDs for myplaces/analysis/userlayers and configurations for the default database values needed by these services.

8) Start the Jetty by running the command in {JETTY_HOME}

java -jar start.jar

This creates the basic database structure (if it doesn't exist) with initial content based on a json file in webapp-map resources.

Last modified: Fri Apr 06 2018 18:04:26 GMT+0300 (EEST)