A mapping file is a text file comprising several sections. Each section describes entities (business objects) that should be restored and defines mapping rules. In addition to mapping rules, you can specify server administrator's credentials and server settings that should be used when restoring data on a server, where Plesk is installed but not configured.
Sections names are enclosed in brackets. Items and options within each line are separated by white spaces or tabulation. All comments in the file start with the # symbol.
The information about server's IP addresses is specified in the [init_conf:ips] section in the following format:
The default server's IP address is specified in the [init_conf:default_ip] section in the following format:
Server's hostname is specified in the [init_conf:hostname] section in the following format:
Server administrator's password is specified in the [init_conf:password] section in the following format:
Note: if you password contains the characters
", then you need to escape them, that is, you need to place a backslash (\) to the left of each character.
Administrator's contact information cannot be specified in the mapping file, however, you can type the line [init_conf:admin_account] in the mapping file if you want the administrator's contact information to be restored from the backup file.
Mapping of IP addresses is specified in the [ipmap] section in the following format:
10.58.97.31 -> 10.58.97.30
10.58.97.32 -> 10.58.97.35 exclusive
10.58.97.31 shared -> 10.58.97.36 exclusive
Specify the IP addresses that should be mapped (in the left part), place a hyphen and 'greater than' sign (->) and then specify existing IP addresses to map to (in the right part). 'Shared' and 'exclusive' attributes are optional.
Mapping of database servers is specified in the [db-servers] section in the following format:
type:login:password@hostname:port -> type:login:password@hostname:port
Only MySQL and PostgreSQL databases are currently supported. You should specify database types as follows: mysql, postgresql. If you do not specify a database server in the right part after the -> symbols, the utility will consider that the database server should be mapped to itself. If the specified database server is missing, it will be created. If you wish to assign a database server as default for serving customers' databases, specify the ':default' argument to the right of the port number.
mysql:admin:email@example.com:8306 -> mysql:admin:firstname.lastname@example.org:8306
Mapping of client accounts is specified as follows: a separate section is created for each client account. To specify mapping preferences for a client account:
domain_name1.com 10.1.36.100 -> 10.1.36.200
localhost:8306 -> 10.1.36.200:8306
In this case, the database server is specified in a short
hostname:port format. You should be sure that the specified database server exists on your server, or is specified in the global [db-servers] section, in the left part of a mapping entry. Note that domain_name2.com from the above example will be restored and hosted on the first IP address found in this client's pool, for example, 10.1.36.100.