Updating a major version¶

System requirements¶

The following Windows versions are supported:

• Windows Vista
• Windows 7
• Windows 8
• Windows 10
• Windows Server 2008
• Windows Server 2012

OpenGeo Suite has the following system requirements:

• Memory: 1GB minimum (2GB recommended)
• Disk space: 1.2GB minimum (plus extra space for data)
• Browser: Internet Explorer, Firefox, Chrome
• Permissions: Administrative rights
• Software: .NET Framework 4.5 (Download)

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. Make sure that the PostgreSQL bin directory is on your path. By default, this is C:\Program Files\OpenGeo\OpenGeo Suite\pgsql\9.1\bin though your installation may vary. To test that this is set up correctly, open a Command Prompt and type:

   psql --version
   

   If you receive an error, type the following to temporarily add the above directory to your path:

   set "PATH=%PATH%;C:\Program Files\OpenGeo\OpenGeo Suite\pgsql\9.1\bin"
   

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.

4. Run the backup command:

   postgis_upgrade.exe backup --port 5432
   

   Note

   For more information about supported options run postgis_upgrade.exe --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.

Back up GeoServer data directory¶

Uninstalling OpenGeo Suite 3.x will not remove any of the GeoServer configuration so there is no need to make a back up. It can be copied into the correct location during restore.

For OpenGeo Suite 3.x and earlier the default the data directory is located at <user_home_directory>\.opengeo\data_dir.

For OpenGeo Suite 4.x and above the default data directory is located at C:\ProgramData\Boundless\OpenGeo\geoserver.

Uninstall old version¶

The next step of the process is to uninstall the existing OpenGeo Suite. The uninstaller can be run directly from the Windows Start Menu.

Install new version¶

You are now ready to install the new version of OpenGeo Suite. To do so follow the instructions in the Installing section.

In order to run the PostGIS restore script you must select the PostGIS client tools as part of the new install.

Installing PostGIS client tools

Restore PostGIS databases¶

1. Ensure the OpenGeo PostgreSQL service is running.

2. Ensure the PostGIS/PostgreSQL commands are on the path. From a command prompt, type the command:

   psql --version
   

   If you receive an error re-run the installer and install the PostGIS client tools, as described in the previous section.

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

   postgis_upgrade.exe 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. Stop the OpenGeo Jetty service if it is running.
2. Restore the GeoServer data directory:
   1. Delete or rename the new default data directory, located at C:\ProgramData\Boundless\OpenGeo\geoserver.
   2. Copy the existing contents of <user_home_directory>\.opengeo\data_dir to C:\ProgramData\Boundless\OpenGeo\geoserver.
3. Restart the OpenGeo Jetty service.

After update¶

The update is now complete. Please see the section on After installation: Working with OpenGeo Suite for Windows to continue.