How to Move all cPanel Accounts from One Server to Another

For cPanel & WHM version 11.40


This document explains how to migrate your cPanel accounts, SSL certificates and main server IP address from one server to another. This is typically done when you need to replace your server.

PICK Important:Your websites will likely experience downtime during this process.

Migrate Your cPanel Accounts

To migrate your cPanel accounts to a replacement server, follow these steps:

Step 1: Install cPanel & WHM on your new server

You should install cPanel & WHM on your new server before you start the transfer of accounts. To do so, follow the steps in our Installation Guide.

note Note: You need to contact customer service for a temporary license. Your permanent cPanel license will be transferred to the new server in the migration process.

During the installation process, you will select a hostname and main shared IP address for the new server. You must choose a different IP address from your old server. You may choose the same hostname as your old server.

Step 2: Copy all accounts to the new server

note Note: Before you begin step 2, make sure the server’s shared IP address and DNS server are configured. This is important because restored accounts will have DNS zones configured with those DNS servers. You can do this in WHM's Basic cPanel & WHM Setup.

Once you have installed cPanel & WHM on your new server, copy each account from your old server to your new server. To move all of your accounts from one server to another, follow the steps listed in the Copy Multiple Accounts/Packages from Another Server feature.

PICK Remember: You should make sure to copy all SSL certificates before you switch servers. SSL certificates and keys are available in the /etc/ssl directory.

Step 3: Disable your old server

Once you copy your accounts to the new server, you can disable your old server. Before you disable your server, you should remove the old server from the DNS cluster.

Step 4: Change the new server’s main IP address to the old server’s IP address

Once your old server has been powered off, you can change the new server’s main IP address to the IP address of your old server. This should be done via the command line in a local session. A local session allows you to make changes, restart the network service and stay connected to the server. To change the server's main IP address, follow these steps :

  1. Open the /etc/sysconfig/network-scripts/ifcfg-eth0 file.
  2. Edit the IPADDR and GATEWAY lines to the IP address and gateway of your old server.
  3. Open the /etc/ips file.
  4. Add your old server's primary IP address, net mask, and gateway to the file.
    • note Note: Remove the new server’s primary IP from this file if it is present.
  5. Restart the network service. Run the service network restart command.
  6. Run the /scripts/mainipcheck command. This command adds the IP address to the /var/cpanel/mainip file.
  7. Run the /scripts/fixetchost command. This command adds the IP address and hostname of your server to the /etc/host file.

Step 5: Change the IP address of all accounts to the correct IP address

When you transfer the accounts to the new server, the IP addresses for the accounts will be the new server’s original main IP address. You must change the IP address of each account to the current IP address.

Step 6: Join the new server to the DNS cluster

You installed cPanel on your new server in step 1. Now, you must to join your new server to the DNS cluster. To add the new server to the DNS cluster, follow these steps:

  1. Navigate to the WHM Configure Cluster screen (Home >> Cluster/Remote Access >> Configure Cluster).
  2. Select Enable DNS Clustering.
  3. Click Change.
  4. Click Return to Cluster Status.
  5. Specify which server to add to the cluster from the Add a new server to the cluster menu.
  6. Click the Configure button.

Step 7: Reinstall all SSL certificates

You can add an existing SSL certificate for your site to your new server. To upload an existing SSL certificate to your server, follow these steps:
  1. Navigate to the Install a SSL Certificate and Setup the Domain screen. (Home >> SSL/TLS >> Install an SSL Certificate and Setup the Domain).
  2. Paste the certificate into the text box, or upload a *.crt file with the Fetch button.
  3. Click the Submit button to install the certificate onto the server.

Step 8: Confirm your cPanel license is valid

Once you have moved all accounts to your new server, you need to confirm that your cPanel license is valid. To do so, go to our license verification page.

All of your accounts should now be on your new server.

Topic revision: r4 - 18 Oct 2013 - 17:08:25 - Main.LaurenceSimon