Migrating from earlier versions of Plesk Panel

To migrate objects from Plesk v. 7.5 using Plesk Backup Manager, you should create backup on source server 7.5 and then convert it to version 8 with the backup-convert utility. Refer to the following article for details: http://kb.parallels.com/en/1727. After that, you may convert the backup to version 9 with the pre9-backup-convert utility and then restore it through Backup Manager in the control panel.

Alternatively, you may migrate from 7.5 to 8.6 using Plesk Migration Manager, create backup on Plesk 8.6, convert it to 9 with the pre9-backup-convert utility and restore on destination Parallels Plesk Panel 9.

To migrate from earlier versions of Plesk Panel for Linux/Unix:

1. On the source server, run the command that creates a server backup.

   # /usr/local/psa/bin/pleskbackup all /dump.psa

   Note: For details on creating selective backup, refer to Backup Documentation of the required version available at Parallels Technology Network.

2. Upload the backup (dump.psa) to the destination server.
3. Proceed as described in Migrating to Parallels Plesk Panel 9.3 for Linux/Unix.

To migrate from earlier versions of Plesk Panel for Windows:

1. On the source server, create the server backup using the backup manager GUI.

   >"%plesk_bin%\backup.exe"

   Note: For details, refer to the Plesk Backup Guide of the required version available at Parallels Technology Network.

2. Upload the backup (dump.psa) to the destination server.
3. Proceed as described in Migrating to Parallels Plesk Panel 9.3 for Windows.

Migrating to PPP 9.3 for Linux/Unix

To restore data:

1. On the destination server, run the command that converts the backup to Plesk 9 format.

   # /usr/local/psa/bin/pre9-backup-convert convert -d /var/lib/psa/dumps /dump.psa

   If the operation succeeds, Plesk places the converted backup to backups repository (located in the /var/lib/psa/dumps/ folder) and displays the name assigned to the backup. You must use the backup name issued by Plesk for restore purposes.

2. Restore the backup from the repository.

   You can restore the backup in two ways:

   • Using Plesk GUI
   • Using Plesk CLI

To restore the whole server data through Plesk CLI:

Use the following command:

# /usr/local/psa/bin/pleskrestore --restore /var/lib/psa/dumps/<BACKUP NAME> -level server

Note: For more information on options available if restoring backups using command line, refer to the Backup and Restore Utilities Administrator's Guide available at PPP Documentation page.

To restore the whole server data through Plesk GUI:

1. Go to Home > Backup Manager.
2. Click the backup file name.
3. Specify the following settings:
   • Types of data to be restored. Select all check boxes.
   • Suspend domain (Web site) until restoration task is completed. Select this if you want to avoid possible conflicts that may occur when users modify site content or settings while they are being restored.
   • Send an e-mail notice when restoration task is completed. Type your e-mail address if you want to be notified when restoring is completed.
4. Define conflicts resolution policy. Specify what to do if any conflicts occur during restoration.
5. Click Restore.

To restore a client through Plesk GUI:

1. Log in to Parallels Plesk Panel as administrator and create new client with the same login as of migrated client.
2. Access local backup repository of the new client: Select Clients > <CLIENT NAME> > Backup Manager.

   Because login of the created client coincides with the login of client from the dump, the converted backup should be shown in the repository.

3. Click the backup name to enter the Backup Details page.
4. Select the required restoration options (see the procedure above, Steps 3-4).
5. Click Restore.

To restore a domain through Plesk GUI:

1. Log in to Parallels Plesk Panel as administrator and create new domain with the same name as of migrated domain.
2. Access local backup repository of the new domain: Select Domains > <Domain NAME> > Backup Manager.

   Because name of the created domain coincides with the name of domain from the dump, the converted backup should be shown in the repository.

3. Click the backup name to enter the Backup Details page.
4. Select the required restoration options (see the procedure above, Steps 3-4).
5. Click Restore.

Migrating to PPP 9.3 for Windows

To restore data:

1. On the destination server, run the command that converts the backup to the required format.

   >"%plesk_bin%\pre9-backup-convert" --source=<ABSOLUTE PATH TO BACKUP> --destination="%plesk_dir%\Backup"

   If the operation succeeds, Plesk places the converted backup to backups repository (located in the %plesk_dir%\Backup\ folder) and displays the name assigned to the backup. You must use the backup name issued by Plesk for restore purposes.

2. Restore the backup from the repository

   You can restore the backup in two ways:

   • Using Plesk GUI
   • Using Plesk CLI

To restore the backup from Plesk CLI:

Use the following command:

>"%plesk_bin%"\pleskrestore --restore "%plesk_dir%\<BACKUP NAME>" -level server

Note: For more information on options available if restoring backups using command line, refer to the Backup and Restore Utilities Administrator's Guide available at PPP Documentation page.

To restore the whole server data through Plesk GUI:

1. Go to Home > Backup Manager.
2. Click the backup file name.
3. Specify the following settings:
   • Types of data to be restored. Select all check boxes.
   • Suspend domain (Web site) until restoration task is completed. Select this if you want to avoid possible conflicts that may occur when users modify site content or settings while they are being restored.
   • Send an e-mail notice when restoration task is completed. Type your e-mail address if you want to be notified when restoring is completed.
4. Define conflicts resolution policy. Specify what to do if any conflicts occur during restoration.
5. Click Restore.

To restore a client account through Plesk GUI:

1. Log in to Parallels Plesk Panel as administrator and create new client with the same login as of migrated client.
2. Access local backup repository of the new client: Select Clients > <CLIENT NAME> > Backup Manager.

   Because login of the created client coincides with the login of client from the dump, the converted backup should be shown in the repository.

3. Click the backup name to enter the Backup Details page.
4. Select the required restoration options (see the procedure above, Steps 3-4).
5. Click Restore.

To restore a domain through Plesk GUI:

1. Log in to Parallels Plesk Panel as administrator and create new domain with the same name as of migrated domain.
2. Access local backup repository of the new domain: Select Domains > <Domain NAME> > Backup Manager.

   Because name of the created domain coincides with the name of domain from the dump, the converted backup should be shown in the repository.

3. Click the backup name to enter the Backup Details page.
4. Select the required restoration options (see the procedure above, Steps 3-4).
5. Click Restore.