CentOS 7 Migration

This page describes the migration procedure for moving a Toolkit installation from a CentOS 6 to a CentOS 7 host. It assumes both hosts have the same version of perfSONAR Toolkit installed. If you do not wish to keep any existing data from the CentOS 6 host you may ignore this section and do a normal clean installation. For existing users wishing to migrate their configuration and data to the CentOS 7 installation see the steps below:

1. Login in to your CentOS 6 host via SSH or the terminal as a user with superuser privileges or that can promote itself to superuser with the sudo command

2. Upgrade your CentOS 6 host to the same version of perfSONAR as the CentOS 7 host if you have not already done so.

3. Run the command below to create a backup of all relevant configuration files in ~/ps-toolkit-backup.tgz

   /usr/lib/perfsonar/scripts/ps-toolkit-migrate-backup.sh ~/ps-toolkit-backup.tgz

   If you also wish to migrate the measurement databases add the --data paremeter

   /usr/lib/perfsonar/scripts/ps-toolkit-migrate-backup.sh --data ~/ps-toolkit-backup.tgz

4. Copy the backup file ~/ps-toolkit-backup.tgz from your CentOS 6 host to a safe location. We will need to copy this to our new installation later. If you will be overwriting the CentOS 6 host with the new installation, make sure this file is stored safely on another system, so it can be copied to the new installation later.

5. Logout of the CentOS 6 host

6. Perform a clean installation of the Toolkit on a CentOS 7 host using the same Toolkit version that was installed on a CentOS 6 host. You may choose to install on the existing CentOS 6 hardware or a completely new host. If it is the former, make sure you have downloaded your CentOS 6 backup file to a safe location.

7. Copy the file ~/ps-toolkit-backup.tgz from the location chosen in step 3 to your new system. The exact command to do this will depend on where you placed the file (e.g. use scp).

8. Login to your new CentOS 7 Toolkit installation via SSH or the terminal

9. Run the command below to restore your configuration

   /usr/lib/perfsonar/scripts/ps-toolkit-migrate-restore.sh ~/ps-toolkit-backup.tgz

   To also restore the measurements databases add the --data paremeter

   /usr/lib/perfsonar/scripts/ps-toolkit-migrate-restore.sh --data ~/ps-toolkit-backup.tgz

10. Reboot your host:

    reboot

Your host should now be migrated.