(Home >> Transfers >> Transfer Tool )
This interface copies multiple accounts from a remote server to your cPanel & WHM server. To transfer accounts, you must obtain the following:
root-level privileges with the
To transfer accounts from Plesk, first change any forwarded domains to physical hosting accounts. To do this, run the following command as the
/usr/local/psa/bin/domain --update example.com -hst_type phys -login "example" -hosting true -ip 127.0.0.1 -passwd "12345luggage"
example.comrepresents the forwarding domain.
examplerepresents the new account's username.
127.0.0.1represents the new account's IP address.
12345luggagerepresents the new account's password.
If you need to convert several forwarding domains into hosting accounts, open a support ticket and our migration team will contact you.
This section of the Transfer Tool interface allows you to specify information about the server from which to transfer accounts.
FQDN example —
In this case, the FQDN does not require the trailing dot.
In the Remote SSH port text box, specify the port to use.
The default value for SSH is port
In this section of the Transfer Tool interface, specify the authentication method with which to log in to the remote server.
To specify an authentication method, perform the following steps:
Select whether to log in as the
root user or with a specific username.
If you select SSH Public Key, select the key to use during authentication. Make certain that you installed the appropriate key in WHM's Manage root's SSH Keys interface (Home >> Security >> Manage root's SSH Keys).
If you encrypted your account's SSH public key, enter the SSH Key Passphrase.
rootpassword in the Root Password text box.
In this section of the Transfer Tool interface, select whether to use the Restricted Restore feature or copy reseller privileges.
In this section of the Transfer Tool interface, select advanced options for the transfer. Click Show to display the list of options.
To select the advanced options, perform the following steps:
Select Unencrypted to use an unencrypted session to transfer the files.
Select Low Priority to use less CPU and input/output (I/O) on the remote server.
This option reduces the impact on performance on the remote server, but increases the duration of the transfer session.
Select Use Incremental Backups speed-up to decrease the amount of time that the system uses to package the account on the source server. If a daily incremental backup exists, WHM uses that backup as a starting point. The system then updates the package before transfer.
Select Use custom account packaging modules from /var/cpanel/lib/Whostmgr/Pkgacct to use packaging scripts in that directory.
The system does not create the
cPanel & WHM always prioritizes custom restore modules in the
Enter the number of transfer threads to use in the Number of Transfer Threads text box.
You may enter a maximum of five transfer threads.
Enter the number of restore threads to use in the Number of Restore Threads text box.
You may enter a maximum of five restore threads.
After you make your selections, click Fetch Account List. A new interface will appear.
The top of the Account List interface displays the hosting software and version of the remote server. If any of this information appears incorrect, click Reanalyze Remote Server.
Below the remote server information, the interface displays if any available IP addresses exist.
If no available IP addresses exist on the target server, accounts on the remote server that use a dedicated IP address will not transfer.
In this section of the Account List interface, select the configurations on the source server that you wish to copy over to a destination server.
To select your desired configurations, perform the following steps:
Select the configurations that you wish to transfer to your local server.
Click Copy. The system will display the progress interface.
The summary bar displays the transferred or restored configurations.
A MultiPHP user's PHP-FPM setting does not transfer. When you use this interface, the system will transfer the PHP-FPM
.yaml configurations, but will not restore it. This is due to an undetermined status of PHP and FPM services. Instead, the system copies the PHP-FPM
.yaml configuration file to the
To restore the PHP-FPM
.yaml configuration file manually, perform the following steps:
Run the following command:
The system restores your account's PHP-FPM
.yaml configuration file.
On March 31, 2017, Red Hat® will deprecate all CentOS 5 systems. cPanel, Inc. will no longer provide maintenance and security updates for CentOS 5 systems. The Transfer Tool interface can assist you in your migration from CentOS 5 systems to a higher version of CentOS. We strongly recommend that you migrate to a CentOS 7 server.
To migrate your CentOS 5 server to a CentOS 7 server, perform the following steps:
rootuser and navigate to the Transfer Tool interface.
Perform the steps in the Configuration section above.
We strongly recommend that you migrate your accounts and configurations separately. Migrate your configurations first.
Verify that your server operates as expected. For more information on one method to do this, read our Service Manager documentation.
Use the Transfer Tool interface to migrate the desired accounts.
In this section of the Account List interface, select the packages on the remote server to copy to your local server.
The Transfer Tool feature transfers features lists for the packages that you select.
To copy a package, perform the following steps:
In this section of the Account List interface, search for and select accounts to transfer to your local server.
To toggle an option for all accounts, select the checkbox at the top of the appropriate column in the table header.
To copy accounts, perform the following steps:
Specify the copied account's new username and enter the new username in the User text box.
The User text boxes use the following colors as warning indicators:
Select the accounts to which the system will assign dedicated IP addresses under the Dedicated IP Address heading.
|The interface does not allow you to assign more dedicated IP addresses than the number of available IP addresses on your server. If you select an account with a dedicated IP address on the remote server but an available IP address does not exist on your server, the transfer fails.|
Use the Filter text box to filter the list of accounts by the Domain, User, or Reseller columns.
Accounts will retain their mailbox format settings from the source server. For example, if an account uses maildir format on the source server, it will use maildir format on the target server.
Select the accounts that will retain their reseller privileges under the Copy Reseller Privileges heading.
This option is not available if you selected the Restricted Restore feature in the Security section of the previous interface.
Select the accounts that will transfer their bandwidth data under the Copy Bandwidth Data heading.
If you transfer an account from cPanel & WHM version 11.50 to an earlier version, the account loses its bandwidth data.
Select accounts for express transfer under the Express transfer heading.
For more information, read the Express transfer section of this document.
After you click Copy, the Account Transfer interface will appear.
When you use the Transfer Tool interface to transfer accounts, the system performs the following actions:
The system compares the DNS zone file from the account's backup file with the template-generated zone file that the system generated during account creation.
The Transfer Tool feature does not transfer DNS zone templates. If custom DNS zone templates exist on the source server, the system ignores these zone templates when it recreates the account on the destination server.
domainNS records to match the target server's zone templates and comments out any duplicate
domainNS records from the source server.
The system updates ftp.domain A, AAAA, and CNAME records to match the target server's DNS templates and comments out any identical
ftp.domain records from the source server.
cPanel & WHM uses the IP address in the destination server's
The system checks whether the template-generated zone file uses an MX preference of
0, and then performs the following actions:
If the zone file's MX preference is
0 and the zone file is
0and the zone file is not
mail.$PRIMARY_DOMAIN(a non-standard mail configuration), the system merges the generated templates and comments out templates from the source server.
For example, when the zone template's MX record defines an external mail service, the system prefers that entry over the record in the backup.
The system comments out duplicate records.
$ORIGINdirective for an additional domain, the system will not update that additional domain's records.
Ensure that the source server controls the authoritative name servers for the domain before you use this feature. Failure to comply may cause the DNS to not resolve, which can cause downtime for your sites.
An express transfer performs the following actions on the remote server:
Adds a redirect for the Account Moved page (
cgi-sys/movingpage.cgi) for the following file extensions:
.dynamiccontent .pl .plx .perl .cgi .php .php4 .php5 .php6 .php3 .shmtl
The system performs changes on the source server in the