Working with OpenGeo Suite for Ubuntu Linux

This document contains information about various tasks specific to OpenGeo Suite for Ubuntu Linux.

Starting and stopping OpenGeo services

OpenGeo Suite is comprised of two main services:

  1. The Tomcat web server that contains all the OpenGeo web applications such as GeoServer, GeoWebCache, and GeoExplorer.
  2. The PostgreSQL database server with the PostGIS spatial extensions.

Controlling the Tomcat service

To start/stop/restart the Tomcat service:

/etc/init.d/tomcat6 start|stop|restart

Controlling the PostgreSQL service

To start/stop/restart the PostgreSQL service:

/etc/init.d/postgresql start|stop|restart

Note

If you have multiple versions of PostgresSQL installed you can specify which version to control with a third argument. For example:

/etc/init.d/postgresql start 9.3

Service port configuration

The Tomcat and PostgreSQL services run on ports 8080 and 5432 respectively. These ports can often conflict with existing services on the systemk, in which case the ports must be changed.

Changing the Tomcat port

To change the Tomcat port:

  1. Edit the file /etc/tomcat6/server.xml.
  2. Search for 8080 (around line 71) and change the port attribute to the desired value.
  3. Restart Tomcat.

Changing the PostgreSQL port

To change the PostgreSQL port:

  1. Edit the file /etc/postgresql/9.3/main/postgresql.conf.
  2. Search or the port property (around line 63) and change it to the desired value.
  3. Restart PostgreSQL.

GeoServer Data Directory

The GeoServer Data Directory is the location on the file system where GeoServer stores all of its configuration, and (optionally) file-based data. By default, this directory is located at: /var/lib/opengeo/geoserver.

To point GeoServer to an alternate location:

  1. Edit the file /usr/share/opengeo/geoserver/WEB-INF/web.xml.
  2. Search for GEOSERVER_DATA_DIR and change its value accordingly.
  3. Restart Tomcat.

PostgreSQL Configuration

PostgreSQL configuration is controlled within the postgresql.conf file. This file is located at /etc/postgresql/9.3/main/postgresql.conf.

You will want to ensure you can connect to the database, and that you have a user to work with. Please see the section on Connecting to PostgreSQL on Linux for the first time.