Installing¶

PostGIS.app¶

PostGIS ships as a self-contained application. Start by double-clicking PostGIS.app. You will see a “Welcome” window the first time the application is launched.

PostGIS Welcome dialog

You can check the PostgreSQL server status and perform other tasks from the PostGIS icon in the OS X menu bar.

PostGIS menu

GeoServer.app¶

GeoServer also ships as a self-contained application. Start by double-clicking GeoServer.app. You will see a “Welcome” window the first time the application is launched.

GeoServer Welcome dialog

You can check the server status and perform other tasks from the GeoServer icon in the OS X menu bar.

GeoServer menu

Once the server has fully started up a web browser will open and display the OpenGeo dashboard.

PostGIS Utilities¶

The PostGIS Utilities package contains utility applications for working with PostGIS and PostgreSQL:

• pgAdmin - A database manager for PostgreSQL
• pgShapeLoader - A graphical Shapefile loader/dumper

Double-click to run the applications.

pgAdmin PostgreSQL Manager

PostGIS Shapefile Loader

GeoServer extensions¶

Extensions to GeoServer are available in a folder called GeoServer Extensions.

Double-click to open this folder and you will see individual folders for each extension.

To install an extension:

1. Select Open Webapps Directory from the GeoServer menu.

   Note

   GeoServer must be running to see this menu.

   

   Opening the webapps directory from the GeoServer menu

2. In the Finder window that appears, navigate to geoserver/WEB-INF/lib.

3. For a given extension, copy the contents of that folder (not the folder itself) into geoserver/WEB-INF/lib.

   

   Selecting the files for the WPS extension...

   Note

   You can use the labeling or tagging feature of the Finder to color or tag extensions, respective to each type of extension, before copying them to geoserver/WEB-INF/lib. This allows you to quickly find them later if you wish to remove them from GeoServer.

   

   ...and copying the files to geoserver/WEB-INF/lib

4. Quit and re-open GeoServer.

   

   Quitting GeoServer

CLI tools¶

The CLI tools package contains all the command line tools for OpenGeo Suite:

• Boundless SDK
• PostGIS data conversion utilities such as shp2pgsql
• GDAL/OGR format translation utilities (including Python modules)
• PDAL tools for working with LIDAR point cloud data

To install the CLI Tools:

1. Double-click the OpenGeo CLI Tools.pkg file.

   

   OpenGeo Suite Command Line Tools Installer

2. Work through the installer dialogs accepting the defaults.

3. The CLI Tools package installs everything into /usr/local/opengeo. This directory must be added to the PATH. Add the following line to your ~/.profile:

   export PATH=/usr/local/opengeo/bin:$PATH
   

   Note

   Alternatively you can run the /usr/local/opengeo/bin/opengeo-clitools-doctor utility which will create symlinks for all the tools into /usr/local/bin. Use this method with caution as it may conflict with different versions of the same tools already installed on the system.

4. Adding the CLI Tools Python modules to PYTHONPATH

   The GDAL/OGR and other Python module utilities will be installed in /usr/local/opengeo/lib/python2.7/site-packages. To add this to your PYTHONPATH you will need to open ~/.profile in a text editor and add the following to the bottom of the file:

   export PYTHONPATH=/usr/local/opengeo/lib/python2.7/site-packages:$PYTHONPATH
   

   Warning

   If you have the QGIS community version installed, and the /Libraries/Frameworks/GDAL.framework exists, you will need to remove gdal-py2.7.pth and numpy-override.pth from /Library/Python/2.7/site-packages as they manipulate sys.path and will always be found first.