Appendix H. Upgrading from a Previous Version

Table of Contents

H.1. Upgrading the Server
H.2. Upgrading Client Printer Drivers
H.3. Testing the Upgrade

This appendix describes the SavaPage standard upgrade procedure.

H.1. Upgrading the Server

SavaPage supports upgrades using a simple install-over-the-top procedure. We recommend reviewing all steps prior to commencing the upgrade procedure.

  1. Download the SavaPage installer for your platform. In accordance with best practice we recommend that you archive your install programs just in case you need to reinstall in the future or roll back to a previous version.

  2. Take some time to read the release notes for this version as they may highlight considerations during upgrades.

  3. Schedule approximately 10 minutes downtime. It is suggested to choose a time of day with minimal network activity. If there is a large volume of data in the system (for example if the system has been running for more than a year, or there are several thousands of users) the upgrade may take longer. With very large installations it may be appropriate to schedule an hour or more of downtime.

  4. Take a point-in-time backup of the data by pressing the Backup Now located under OptionsBackups. This will ensure you have a copy of the important data.

  5. As a precaution on very large systems, we recommend backing up the whole SavaPage install directory. Existing overnight backups may have taken care of this task, however take a few moments to grab an up-to-date backup now. For example, create a zip archive of the directory /opt/savapage

  6. Run the installer downloaded in step 1 and install into the same location as the existing install, like /opt/savapage.

  7. After the install has completed allow a few minutes before accessing the system. The system may need to perform a database upgrade and this will be performed in the background. If you try to access the application while a database upgrade is in progress a message displaying the upgrade status will be displayed.

Important

Do not shutdown the application while an upgrade is in progress. Wait for the upgrade to complete.

Note

Sometimes a new SavaPage version performs changes on the database schema. In that case a database backup is performed automatically before the upgrade. The backup file is located at /opt/savapage/server/data/backups/. The file name is formatted as schema-[nn]-upgrade-backup-[timestamp].zip, where [nn] is the database schema version before the upgrade.