Documentation Home> AllDocumentation/WHMDocs>WHMHomeScreen>WhmTransfersEditAttach

Copy Multiple Accounts/Packages from Another Server

For WHM version 11.38

(Home >> Transfers >> Copy Multiple Accounts/Packages from Another Server)

This feature enables you to copy multiple accounts from a remote server to your web server. You will need to know certain information about the remote server to use this feature. The interface is divided into 2 main sections. In order to transfer accounts, you will need ssh access to the remote server and be able to obtain root privileges by either su or sudo.

Remote Server Info

This area of the Copy Multiple Accounts interface is where you will specify information about the server from which accounts will be transferred. To complete this process, you will need to:

  1. Specify the Remote Server Type. From the pull-down menu, select the web control panel that the remote server is running. You have the following options:
    • WHM/cPanel
    • WebPanel
    • Pl*sk
    • Zer*ex's dXm'
    • En*im
    • Alab*nza
    • CIH*st/Spectr*
    • DA
    • Sp*era
  2. Specify the Remote Server Address. This value can be in the form of an IP address or a Fully Qualified Domain Name (FQDN).
    • FQDN example — host.example.com
      • note Note: In this case, the FQDN will not require the trailing dot. You must specify FQDNs in lowercase letters.
    • IP address example — 127.0.0.1
  3. Specify the Remote SSH port you wish to use — by default, SSH runs on port 22.
  4. If you wish, click the Check SSH Connection button to test your ability to connect to the remote server.
  5. If you wish, you may choose to leave the transfer uncompressed by selecting the Don't Compress Transfers checkbox.
  6. Selecting the Use SSL checkbox will encrypt the information during transfer.
  7. Selecting the Use Incremental Backups speed-up checkbox will decrease the amount of time it takes to package the account on the source server. If a daily incremental backup is available, WHM will use that backup as a starting point. The system will then update the package before it is transferred.
  8. Selecting the Allow Override checkbox allows you to override the usual transfer process in favor of a customized script. The custom script must reside in /var/cpanel/lib/Whostmgr/Pkgacct on the server to which the account will be copied (local machine).

Authentication

This section allows you to specify login information for the remote server. To complete this process, you must:

  1. Specify the Login method. You are able to specify the username and password for the account you wish to transfer, or log into the remote server as the root user.
    • If you select Root, you will simply need to enter the root password in the Root Password field, below.
    • If you select User, you will need to:
      1. Specify the remote account's Username in the appropriate field.
      2. Specify the remote account's Password in the appropriate field.
  2. Select the Authentication Method you wish to use. Here, you must specify whether you will be using a password or a public key to authenticate to the remote server.
    • If you choose Password, the password you entered under the Username field will suffice.
      • When you select this option, you will also need to specify a Root Escalation Method. You will need root level privileges to transfer the account.
        • Selecting su will require the root user's password.
        • Selecting sudo will require that the user be included in the remote machine's sudoers file.
    • If you choose Public Key, you will need to select the key you wish to use during authentication. You will need to be sure the appropriate key has been installed at the Home >> Security >> Manage SSH Keys interface.
      • If necessary, you will need to enter the SSH Key Password. This password should correspond to the key you are using for authentication.
      • When you select this option, you will not need to select a Root Escalation Method. Simply continue filling out the form.
  3. Select the Use FTP to Transfer checkbox if you would like to use FTP to complete the transfer.
  4. When you have finished making your selections, click the Fetch Account List button.

The Account List Page

After clicking the Fetch Account List button, you will see a new page. This page is divided into 2 sections.

The first of the 2 sections is the Packages section. From here, you can select which packages on the remote server you would like to copy to your local server.

The second section of the Account List Page is the Accounts section. This area allows you to search for and select accounts that you would like to transfer to your local server.

Copying Packages

Packages are limitations placed on accounts regarding disk space and bandwidth. You are able to copy packages from a remote server if you choose to do so.

note Note: The Copy Multiple Accounts/Packages From Another Server feature will transfer any feature lists associated with the packages that you select.

To copy a package:

  1. Select the packages you would like to copy in the table beneath the Packages heading.
    • You may use the Select All button to copy all of the packages from the remote server.
  2. Click Copy.
    • PICK Remember: Select the accounts you would like to copy, if any, from the table below before clicking Copy.

Copying Accounts

To copy accounts:

  1. Select the accounts you wish to copy in the table under the Copy heading.
    • You are able to use the Select All button to copy all of the accounts on the remote server.
  2. If necessary, you may redefine the username you would like the copied account to use on the new server by keying it into the User field.
    • This may be necessary if you already have an account with that username on your server.
  3. Select the accounts that should be given dedicated IP addresses under the appropriate heading.
    • You are able to use the Select All button to give all of the accounts a dedicated IP on your server.
    • Make sure you have the correct amount of IP addresses specified in your IP address pool; otherwise transfers of accounts designated to receive dedicated IP addresses will fail when the system is out of IP addresses.
  4. Select which accounts will lose their reseller privileges by clicking the corresponding checkboxes beneath the Skip Reseller Privs heading.
  5. Select accounts for express transfer under the appropriate heading.
    • You can use the Select All button to transfer all of the accounts in this way.
    • Express transfer edits the DNS zone file on the remote server to include the new server’s DNS information. This will help speed up domain propagation times and email delivery, while preventing dynamic content from being loaded on the remote server, so that no content is lost. It will also suspend the remote account.
  6. Click Copy to finish.

Locating Accounts

The interface on this page also comes with a number of tools for locating specific accounts easily. These are basic search tools that allow you to search for accounts by user or by reseller.

The Users search function

  1. Type the username you would like to search for into the Users field.
    • This field is capable of accepting partial names, meaning that you do not necessarily have to enter the entire username to find the account you want.
  2. Click Select Matching Users or Deselect Matching Users to select and deselect, respectively, users matching your search criteria.
    • PICK Remember: Look over the list to be sure you are not transferring accounts unnecessarily, as this will lengthen the transfer process.

The Reseller search function

  1. Choose the reseller from the drop-down menu whose accounts you would like to select.
    • PICK Remember: This will select all of the accounts that are owned by the reseller.
  2. Click Select Matching Reseller Accounts or Deselect Matching Reseller Accounts to select and deselect accounts associated with the selected reseller.
    • PICK Remember: Look over the list to be sure you are not transferring accounts unnecessarily, as this will lengthen the transfer process.

Express transfers

An express transfer, in addition to transferring the requested cPanel account(s), performs the following actions on the remote server:

  1. Updates the account's A record to point to the destination server.
  2. Whenever appropriate, changes the domain's nameserver entry to point to the destination server.
  3. Updates the email routing configuration, so mail arrives at the destination server.
  4. 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
  5. Blocks SSH and FTP logins to the source server for accounts that were transferred.

note Note: Changes are handled on the source server via /usr/local/cpanel/scripts/xferpoint.

About streaming transfers

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

Streaming is a quicker, less resource-intensive method of transferring accounts between cPanel & WHM servers. The streaming process occurs as follows:

  1. The pkgacct utility packages and transfers the account without the /home directory.
  2. During account restoration, the destination server's WHM retrieves the /home directory.
  3. WHM copies the /home directory via a network connection directly from the source server.

To enable streaming transfers:

  • The destination server must be able to connect to the source server via port 2086 (or port 2087 if you prefer to use SSL).
  • The user effecting the transfer must be able to log into the source server's WHM interface with root privileges.

Edit | Attach | Print version | History: r18 < r17 < r16 < r15 < r14 | Backlinks | Raw View | More topic actions
Topic revision: r18 - 25 Jan 2013 - 23:01:53 - Main.LaurenceSimon