To ensure that the domains migrated from the source server are operational on the destination, it is necessary to change their configuration so that they use the IP addresses present on the destination server. This procedure is called IP mapping, and it can be performed either automatically or manually.
Ideally, you should have a shared IP address on the destination server for every shared IP address on the source server. The same goes for dedicated IP addresses.
Once the migration is finished, you can review the IP addresses assigned by the Migrator and re-assign them, as necessary.
Automatic IP Mapping
By default, IP mapping is performed automatically during the course of a migration (no user input required). Plesk Migrator attempts to re-assign the domains being migrated to the IP addresses on the destination server according to the following rules:
- An unallocated dedicated IP address is assigned to domains that were assigned a dedicated IP address on the source server, if possible. Otherwise (for example, if there are no unallocated dedicated IP addresses remaining on the destination server), the default shared IP address is used instead.
- Plesk Migrator attempts to assign all domains that used the same shared IP address on the source server to a separate shared IP address on the destination server, if possible. Otherwise (for example, if there are fewer shared IP addresses on the destination server than on the source server), the default shared IP address is used instead.
IP mapping can also be performed manually, either with the help of the IP mapping file, or the migration list file.
Note: It is possible to combine different ways of mapping. For example, you can specify common mapping rules using the migration list, and then set specific addresses for some particular domains using the mapping file.
IP Mapping Using the Mapping File
An IP mapping file is a simple plain text file containing two columns of IP addresses separated by the whitespace character. The IP addresses in the left column are those present on the source server, and they are matched to the corresponding IP addresses from the destination server in the right column. The file should contain nothing except the IP addresses (no comments and such). Blank lines are allowed.
Here are the contents of a sample IP mapping file:
192.168.1.10 10.52.1.16 192.168.1.11 10.52.1.17 192.168.1.12 10.52.1.17
In this example, domains using the IP address
192.168.1.10 will be
assigned the IP address
10.52.1.16. Those using the IP addresses
192.168.1.12, will be assigned the IP address
Once you have prepared the mapping file, you can pass it to the Plesk Migrator using the following option:
IP_MAPPING_FILE is the path to the mapping file (either
absolute or relative to the current working directory).
IP Mapping Using the Migration List File
This method of IP mapping is more complicated, but gives a greater degree of control over IP address assignment. The procedure for generating the migration list file is described in the Migrating from Plesk Servers topic. Once the file has been generated, edit it, using the samples below as reference:
IPv4: 10.52.1.16 domain1.tld domain2.tld IPv4: 10.52.1.17 domain3.tld
domain2.tld will be assigned the
domain3.tld will be assigned the
IPv4: shared domain1.tld domain2.tld
Here, both domains will be assigned a shared IP address.
IPv4: dedicated domain1.tld domain2.tld
Here, each domain will be assigned a dedicated IP address chosen at random (there must be at least two unallocated dedicated IP addresses on the destination server).
IPv4: auto domain1.tld domain2.tld
Here, each domain will be assigned an IP address according to the automatic IP mapping rules.
IPv6: none domain1.tld domain2.tld
Here, no IPv6 address will be assigned to either domain; however, IPv4 addresses can still be assigned (as a domain cannot be created without an IP address).
You can use the migration list file to assign IPv6 IP addresses to
domains, as well as IPv4 ones. Any domain can be assigned an IPv4
address, an IPv6 address, or both. When specifying IP address to assign
to a domain, you can use a specific address, or the
IPv4: 10.52.1.16 IPv6: 2002:5bcc:18fd:d:904c:9277:339a:ce56 domain1.tld
Here, the domain will be assigned both the IPv4 and the IPv6 addresses.
IP addresses assigned to resellers are propagated to all domains belonging to customer accounts under a specific reseller and the reseller’s own domains.
Reseller: res1 IPv4: 10.52.1.16 domain1.tld Customer: cust1 domain2.tld Reseller: res2 domain3.tld
domain2.tld will be assigned the
10.52.1.16, while the IP address for the domain
domain3.tld will be assigned according to the automatic IP mapping
Note: When assigning an IP address to a reseller manually, the IP address must be either free or already included in the reseller’s IP pool. With automatic IP mapping, only free IP addresses can be assigned to resellers.