Updating a major version¶

Back up PostGIS databases¶

The first step of the update process is to back up your existing PostGIS data.

1. Ensure the old (3.x) version of OpenGeo Suite is running.

2. Open up the Terminal application and make sure that the PostgreSQL bin directory is on your path. By default, this is located at /opt/opengeo/pgsql/9.1/bin. Use the command psql --version to verify:

   export PATH=$PATH:/opt/opengeo/pgsql/9.1/bin
   psql --version
   

3. To backup, a specialized PostGIS update utility is used. Download this utility, and extract the archive to a temporary directory. To avoid permissions issues, it is best to put this directory on your desktop or in your home directory. By default, the backup files created from using this script will be saved into this directory.

   mkdir -p opengeo_backup/pg_backup; cd opengeo_backup/pg_backup
   curl -O http://repo.opengeo.org/suite/releases/pgupgrade/postgis_upgrade-4.0.zip
   unzip postgis_upgrade-4.0.zip
   

4. Run the backup command:

   perl postgis_upgrade.pl backup --port 5432
   

   Note

   For more information about supported options run perl postgis_upgrade.pl --help.

5. The script will run and create a number of files:

   • Compressed dump files for every database backed up (<database>.dmp)
   • SQL output of server roles

6. The PostGIS data backup process is complete. You may now shut down OpenGeo Suite 3.x.

Install new version¶

You may now install the new version of OpenGeo Suite. See Installing for details. In order to run the PostGIS restore script you must install the OpenGeo Client Tools package.

Restore PostGIS databases¶

1. Ensure PostGIS.app is running.

2. Ensure the PostGIS/PostgreSQL command line tools are on the PATH. If you did not install the OpenGeo Client Tools` package in the previous section do so now. From a command prompt, type the command:

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

3. Restore your PostGIS data by running the upgrade utility again with the “restore” argument:

   cd opengeo_backup/pg_backup
   perl postgis_upgrade.pl restore
   

4. Your databases and roles will be restored. You can verify that the databases were created and data restored by running psql -l on the command line.

Restore GeoServer data directory¶

1. Quit GeoServer.app.

2. Restore the GeoServer data directory:

   cd ~/Library/Application\ Support/GeoServer
   mv data_dir data_dir.old
   cp -R ~/Library/Containers/com.boundlessgeo.geoserver/Data/Library/Application\ Support/GeoServer .
   

3. Restart GeoServer.app.

Uninstall old version¶

You may now uninstall the previous version of OpenGeo Suite. The uninstaller is located at /Applications/OpenGeo/OpenGeo Suite Uninstaller.app.