Page tree
Skip to end of metadata
Go to start of metadata

This document is for a previous release of cPanel & WHM. To view our latest documentation, visit our Home page.

For cPanel & WHM 11.44

(Home >> Transfers >> Copy an Account From Another Server with Account Password)

Overview

This feature will attempt to copy an account from a remote server with an account other than the root account.

Warning

  • Only use this feature as a last resort. We strongly recommend that you use the Transfer Tool interface (Home >> Transfers >> Transfer Tool) or perform the following steps:
    1. Generate a backup file on the source server
    2. Copy the backup file to the target server.
    3. Restore the backup file with the Restore a Full Backup/cpmove File interface (Home >> Backup >> Restore a Full Backup/cpmove File).
  • The remote server must have the following features:

    • A working copy of Perl.
    • CGI enabled.
    • An unmodified cPanel configuration.

Note:

If you experience problems with session timeouts, increase the number of seconds in the Number of seconds an SSH connection related to an account transfer may be inactive before timing out setting in the System section of the Tweak Settings interface (Home >> Server Configuration >> Tweak Settings). 

How to transfer a single account

Settings

This section of the interface is where you specify information about the server that currently hosts the account.

  1. In the Domain Name text box, enter the domain name of the site that you wish to transfer.
  2. In the Server to copy from text box, enter the IP address or fully-qualified domain name of the remote server.
    • FQDN example — host.example.com

      Notes:

      • The FQDN does not require the trailing dot.
      • You must specify FQDNs in lowercase letters.
    • IP address example — 127.0.0.1

     

  3. In the Username to copy text box, enter the username that owns the site.

  4. In the User's password text box, enter the user's password.

  5. If you wish to give the account a dedicated IP address on the target server, select Give new account an IP address.

Copy Account

After you make your selections, click Copy Account to begin the transfer process. The Account Transfer interface will appear.

About streaming transfers

When you use WHM to copy an account from another server, the system automatically queries the remote server to determine whether streaming is a viable option.

Streaming provides a faster and less resource-intensive transfer of accounts between cPanel & WHM servers.

The streaming process occurs as follows:

  1. The pkgacct utility packages and transfers the account without the /home directory on the remote server.
  2. During account restoration, the target server retrieves the /home directory.
  3. The target server copies the /home directory via a network connection directly from the remote server.

To enable streaming transfers, the following must be true:

  • The target server must be able to connect to the remote server via port 2086 (or port 2087 if you prefer to use SSL).
  • The user who begins the transfer must be able to log in to the remote server's WHM interface with root privileges.

Compatibility issues

Because of changes to the backup system and other system features (for example, Horde), there are several compatibility issues in the restoration process.

MySQL and PostgreSQL database passwords

In cPanel & WHM version 11.42 and later, the system will restore MySQL® and PostgreSQL databases to the account, but the system will not restore the user's password and it will lock the user out of the databases.

To refresh the user's privileges and restore access, the user must navigate to the phpPgAdmin interface (Home >> Databases >> phpPgAdmin) or the phpMyAdmin interface (Home >> Databases >> phpMyAdmin).

Horde

Because of changes to Horde's MySQL database, you cannot restore Horde data from cPanel & WHM version 11.42 or later to a server that runs version 11.40 or earlier.

Also, some backups do not include global Horde files. Read our Backup Tarball Contents documentation and Guide to Horde Data Behavior for more information.