Upgrading on Ubuntu Linux¶

Warning

This section describes how to upgrade from a previous major version of OpenGeo Suite. A “major” version upgrade is defined as when the first number in the version changes (for example: from 3.x to 4.y)

Do not use these instructions if upgrading on a minor release. (for example: from 4.x to 4.y). Instead, follow the standard new installation process.

Warning

This upgrade is not-backward compatible. Irreversible changes are made to the data so that they can’t be used with versions 3.x and below of OpenGeo Suite.

Back up PostGIS databases¶

Note

The commands in this section require root privileges.

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

Change to the root user:
```
sudo su -
```
Ensure PostgreSQL is running.
```
service postgresql start
```
Change to the postgres user:
```
su - postgres
```
To backup a PostGIS upgrade utility is used. Download the archive and extract it to a temporary directory. By default, the backup files created from using this script will be saved into this same directory:
```
mkdir -p /tmp/opengeo_backup/pg_backup
cd /tmp/opengeo_backup/pg_backup
wget http://repo.opengeo.org/suite/releases/pgupgrade/postgis_upgrade-4.0.zip
unzip postgis_upgrade-4.0.zip
```
Warning

The /tmp directory is not recommended for long term backups, as it can often be purged as part of normal system activity.
Run the backup command:
```
perl postgis_upgrade.pl backup
```
Note

For more information about supported options run perl postgis_upgrade.pl --help.
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
Exit back to the root user:
```
exit
```
The PostGIS data backup process is complete.

Back up GeoServer data directory¶

The next step is to back up the GeoServer data directory, located at /var/lib/opengeo/geoserver.

Shutdown the Tomcat service:
```
service tomcat6 stop
```

Copy the old data directory to /tmp:

cp -r /var/lib/opengeo/geoserver /tmp/opengeo_backup

Uninstall old version¶

You may now uninstall the old version of OpenGeo Suite. For example, if the full package opengeo was used, run the following command:

apt-get remove opengeo

Install new version¶

You may now install the new version of OpenGeo Suite. See Installation on Ubuntu Linux for details.

Restore PostGIS databases¶

Ensure PostgreSQL is running:
```
service postgresql start
```
Change to the postgres user:
su - postgres
Restore your PostGIS data by running the upgrade utility again with the “restore” argument:
```
cd /tmp/opengeo_backup/pg_backup
perl postgis_upgrade.pl restore
```
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¶

The default GeoServer data directory location for OpenGeo Suite 4.x is located at /var/lib/opengeo/geoserver.

Go back to the root account:
```
exit
```
Stop the Tomcat service:
```
service tomcat6 stop
```

Rename the new default data directory:

mv /var/lib/opengeo/geoserver /var/lib/opengeo/geoserver.old

Restore the original data directory:

cp -r /tmp/opengeo_backup/geoserver /var/lib/opengeo/geoserver

Ensure proper permissions on the restored copy:
```
chown -R tomcat6 /var/lib/opengeo/geoserver
```
Start the Tomcat service:
```
service tomcat6 start
```