Administration on Mac OS X

This document contains information about various tasks specific to Boundless Suite for Mac OS X.

Boundless services

Boundless Suite is comprised of two services:

  1. The Tomcat web server that contains all the web applications such as GeoServer and GeoWebCache.

  2. The PostgreSQL database server with the PostGIS spatial extensions.

    Note

    The Boundless PostgreSQL service is only available through the virtual machine.

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 system, in which case the ports must be changed.

Changing the Tomcat port

The Tomcat port can be changed on installation.

To change the Tomcat port after installation:

  1. Open the server.xml file, typically located in your Tomcat conf directory.

  2. Search for the following line:

    <Connector port="8080" protocol="HTTP/1.1"
    
  3. Change the port value.

  4. Save the file.

  5. Restart Tomcat.

Note

To change the port on the Boundless Suite virtual machine, connect to the virtual machine with a Terminal, and follow the Ubuntu instructions.

Changing the PostgreSQL port

Note

The Boundless PostgreSQL service is only available through the virtual machine. To change the port on the Boundless Suite Virtual Machine, connect to the virtual machine with a Terminal, and follow the Ubuntu instructions.

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 ~/Library/Application Support/GeoServer (or /Library/Application Support/GeoServer).

To point GeoServer to an alternate location:

  1. Edit the geoserver.xml file inside your Tomcat configuration.

  2. Define GEOSERVER_DATA_DIR with an appropriate value accordingly.

    <Parameter name="GEOSERVER_DATA_DIR"
      value="/Library/Application Support/GeoServer" override="false"/>