Search

Language:  
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?

APPLIES TO:
  • Parallels Plesk 12.0 for Linux
  • Parallels Plesk 11.5 for Linux
  • Parallels Plesk 10.4 for Linux/Unix
  • Parallels Plesk 11.5 for Windows

Resolution

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
[ip-map]
# Unchanged IP addresses:
# Please review default IP addresses mapping below:
192.168.34.80 shared    ->      192.168.34.88 shared

# NOTE : It's not recommended to modify this section
[CLIENT.LOGIN]
192.168.34.80

DOMAIN.TLD    192.168.34.80
mysql::@localhost:3306

~#

192.168.34.80 is the IP address of the old server where the backup was created. 192.168.34.88 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 (192.168.34.80) with the new one (192.168.34.88) in all objects:

~# cat map_file
[ip-map]
# Unchanged IP addresses:
# Please review default IP addresses mapping below:
192.168.34.80 shared    ->      192.168.34.88 shared

# NOTE : It's not recommended to modify this section
[CLIENT.LOGIN]
1192.168.34.88

DOMAIN.TLD    192.168.34.88
mysql::@localhost:3306

~#

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 "192.168.34.80 shared -> 192.168.34.88 shared".

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

backup restore

data redundancy check

man file

StreamXMLReader->sub(string 'conflicts-description'

domain service web




c81e59b61af9dca603ba03b14aabe968 9f8baf78266b4e54525d1c6bf06305a5 56797cefb1efc9130f7c48a7d1db0f0c 1bb40a2897c5fbbe5c9bd20451105ddc 824237ce663843af86f93897fbd8e2f8 1d151d16e47c6f92bbf62d50eb32c4a2 b44a1557287d8f5170deff96e25c511a 16524e1e2541cde3c382708b52ad207f 276b42158818c83055d6dfa6371d4e4b 42844a8183c58f5bd71c7d59929707e6 51438e1dfe1e98e6ad3bf2ff9709bbbb f4c89357a6ff7298f273cb70f9d95452

FEEDBACK
Was this article helpful?
Tell us how we may improve it.
Yes No
 
 
 
 
 
 
Desktop Virtualization
- Parallels Desktop 9 for Mac
- Parallels Transporter
- Parallels Desktop Switch to Mac Edition
- Parallels Desktop for Mac Enterprise Edition
- Parallels Management-Mac for Microsoft SCCM
Server Virtualization
- Parallels Cloud Server
- Parallels Containers for Windows 6.0 Beta
- Parallels Virtuozzo Containers
Automation
- Parallels Automation
- Parallels Automation for Cloud Infrastructure
- Parallels Business Automation Standard
- Parallels Virtual Automation
- Parallels Plesk Panel Suite
- Web Presence Builder
- Parallels Plesk Automation
- Parallels Small Business Panel
- Value-added Services for Hosters
- Parallels Partner Storefront
Services & Resources
- Cloud Acceleration Services
- Professional Services
- Support Services
- Training & Certification