Search for:

Available article translations:

[How to] I am restoring Plesk backup with Plesk Backup Manager. What is the map file and how do I use it correctly?

Article ID: 6164, created on Mar 18, 2009, last review on Nov 16, 2014

  • Plesk 12.0 for Linux
  • Plesk 11.5 for Linux
  • Plesk 10.4 for Linux/Unix


Create a Parallels Plesk Panel (Plesk) backup with the pleskbackup utility on the old server.

For example:

~# /usr/local/psa/bin/pleskbackup clients CLIENT.LOGIN <backup_file>

Then, move the backup to the new server and restore it using the Plesk CLI utility pleskrestore. Note that the old server and the new server can be the same. During backup restoration, a special map file is required by the pleskrestore utility. This provides mapping between old and new IP addresses and database servers.

You can create a map file with the option "--create-map" (or "--conflicts-resolution" in Plesk version 9.x) in the pleskrestore utility:

~# /usr/local/psa/bin/pleskrestore --create-map <backup_file> -map <map_file>
WARNING: Backup file has wrong signature for this server

[For Plesk 9.x]: The notification "WARNING: Backup file has wrong signature for this server" is shown if the backup is restored on a different server than the one it was created on.

If the file does not exist, it will be created. The map file looks like this:

~# cat map_file
# Unchanged IP addresses:
# Please review default IP addresses mapping below: shared    -> shared

# NOTE : It's not recommended to modify this section


~# is the IP address of the old server where the backup was created. is the IP address of the new server where the backup is being restored. To restore the backup with "-level domains", reconfigure the map file and replace the old IP address ( with the new one ( in all objects:

~# cat map_file
# Unchanged IP addresses:
# Please review default IP addresses mapping below: shared    -> shared

# NOTE : It's not recommended to modify this section



It is not necessary to modify the map file if you are going to use "-level clients" or "-level server" flags during the restoration process. IP address mapping is performed with the line " shared -> shared".

Note that the type of the old IP address should be the same as the type of the new IP address: either " shared -> shared" or " exclusive -> exclusive". If the type of the new IP address does not match the old one, change it in the Plesk interface (Server > IP Addresses > > IP type).

Verify that the map file is valid:

~# /usr/local/psa/bin/pleskrestore --validate-map map_file
Map file is valid

Once the validity of the map file is verified, use it to restore data:

~# /usr/local/psa/bin/pleskrestore --restore <backup_file> -level clients -filter list:CLIENT.LOGIN -map <map_file>

Get the full list of the parameters that can be provided to the pleskrestore utility using the "--help" option.

For more information about related functionality refer to Transferring Data Through Backup Files.

Search words:

StreamXMLReader->sub(string 'conflicts-description'

tar: Unexpected EOF in archive tar: Error is not recoverable: exiting now

backup restore

a914db3fdc7a53ddcfd1b2db8f5a1b9c 29d1e90fd304f01e6420fbe60f66f838 56797cefb1efc9130f7c48a7d1db0f0c 01bc4c8cf5b7f01f815a7ada004154a2 0a53c5a9ca65a74d37ef5c5eaeb55d7f dd0611b6086474193d9bf78e2b293040 2a5151f57629129e26ff206d171fbb5f e335d9adf7edffca6a8af8039031a4c7 e8756e9388aeca36710ac39e739b2b37

Was this article helpful?
Tell us how we may improve it.
Yes No
Server Virtualization
- Odin Cloud Server
- Odin Containers for Windows 6.0
- Odin Virtuozzo Containers
- Odin Automation
- Odin Automation for Cloud Infrastructure
- Odin Business Automation Standard
- Odin Virtual Automation
- Odin Plesk Panel Suite
- Web Presence Builder
- Odin Plesk Automation
- Odin Small Business Panel
- Value-added Services for Hosters
- Odin Partner Storefront
Services & Resources
- Cloud Acceleration Services
- Professional Services
- Support Services
- Training & Certification