I.4. Migrate Data to New Server

The simplest way to migrate the data to the new server is to use the backup and restore process.

  1. Backup the data from the old system using the Admin Web App, or see the instructions at Section C.4.6, “db-export and db-export-to” for the command-line variant.

  2. Copy the backup zip file created in the backup step onto the new server.

  3. Stop the SavaPage Server by running the stop script. See Section C.5, “Stopping and Starting the Server”.

  4. Restore the data from the old system into SavaPage on the new server by following the Database Import instructions. The import commands need to be run as the savapage user.

  5. Migrate the database Encryption Keys by copying the encryption.properties file at location /opt/savapage/server/data/ from the old server to the same location on the new server. Overwrite the existing file on the new server. Make sure this file is owned by savapage , and restrict access by executing:

    sudo chown savapage:savapage encryption.properties
    sudo chmod 600 encryption.properties
  6. If present, migrate the User Name Aliases and Internal Groups by copying the username-aliases.txt and internal-groups.txt files at location /opt/savapage/server/data/conf/ from the old server to the same location on the new server. If the alias file depends on users from a User Source on the local Unix system, be sure that these users also exist on the new server.

  7. If present, migrate any messages in the email outbox by copying the files at location /opt/savapage/server/data/email-outbox/ from the old server to the same location on the new server.

  8. If present migrate the Document Store from the old server to the same location on the new server.

  9. Migrate all customization files to the new server. See Chapter 20, Customization and Appendix K, PPD Extensions.

  10. Start the SavaPage Server by running the start script. See Section C.5, “Stopping and Starting the Server”.

  11. Check that all data has been migrated correctly and the system works as expected by comparing Users and Documents data in the old and new Admin Web App.