Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Migrate your cPanel accounts

...

Section


Column
width72px

Image RemovedImage Added 


Column

Install cPanel & WHM on your new server

Before you transfer the accounts, install cPanel & WHM on your new server. To do so, follow the steps in our Installation GuideHow to Move All cPanel Accounts from One Server to Another.

During the installation process, select a hostname and main IP address for the new server.

Warning
titleImportant:
  • You must select a main IP address that differs from your old server.
  • Select the same hostname, shared IP address, and nameservers that your old server uses. The system configures the DNS zone files of restored accounts with those settings. You can do this in WHM's Basic WebHost Manager Setup How to Move All cPanel Accounts from One Server to Another interface (WHM >> Home >> Server Configuration >> Basic WebHost Manager Setup).
  • Make certain that you copy your cPanel accounts' Apache configuration to the new server. To do so, follow the steps in our Customize your installation documetnation.


Note
titleNotes:
  • cPanel, Inc. automatically provides you with free 15-day trial license when you install cPanel & WHM on a new server. However, if the Trial License Interface shows that your IP address does not qualify for a trial license, contact Customer Service
  • The migration process will transfer your permanent license to the new server.



 

...

 

Section


Column
width72px

Image RemovedImage Added


Column

Copy all accounts to the new server.

Warning
titleImportant:

If you do not use a SNI-capable operating system, make certain to copy all SSL certificates before you transfer accounts between servers. SSL certificates and keys reside in the /etc/ssl/ directory.

After you install 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 in WHM's Transfer ToolHow to Move All cPanel Accounts from One Server to Another interface (WHM >> Home >> Transfers >> Transfer Tool ).

Warning
titleImportant:

 As of cPanel & WHM version 56, WHM's Transfer ToolHow to Move All cPanel Accounts from One Server to Another  interface ( WHM >> Home >> Transfers >> Transfer Tool ) allows you to transfer the following service configurations:

  • Backups
  • cPanel & WHM (whmconf),
  • EasyApache
  • Exim
  • MySQL® and PostgreSQL® databases
  • User Interface Themes.

Make certain that you transfer each account's EasyApache configurations, or your websites may experience issues.



 

...

 

Section


Column
width72px

Image RemovedImage Added


Column

Shut down your old server.

Warning
titleImportant:

Before you begin Step 3, if your old server belongs to a DNS cluster, delete the DNS clusters in WHM's DNS Cluster How to Move All cPanel Accounts from One Server to Another interface (WHM >> Home >> Clusters >> DNS Cluster).

After you copy your accounts to the new server, you can shut down your old server.


 

...

 

Section


Column
width72px

Image RemovedImage Added


Column

Change the new server’s main IP address to the old server’s IP address.

After you shut down your old server, change the new server’s main IP address to the IP address of your old server. Perform this action via the command line in a local session. A local session allows you to make changes, restart the network service, and remain connected to the server.

To change the server's main IP address, perform the following steps:

  1. Open the /etc/sysconfig/network-scripts/ifcfg-eth0 file.
  2. Edit the IPADDR and GATEWAY lines to use the IP address and gateway of your old server.
  3. Open the /etc/ips file with a text editor.
  4. Add your old server's primary IP address, net mask, and gateway to the file.

    Note
    titleNote:

    Remove the new server’s primary IP address from this file.


  5. Restart the network service with the following commands:
    • For CentOS 6 and earlier, CloudLinux™ 6 and earlier, and Red Hat® Enterprise Linux (RHEL) 6 and earlier, and Amazon® Linux, run the  service network restart command.

      Note
      titleNote:

      Amazon Linux always runs in a NAT configuration. 


    • For CentOS 7 and later, CloudLinux 7 and later, and RHEL 7 and later, run the systemctl restart network command.
  6. Run the /scripts/mainipcheck command to add the IP address to the /var/cpanel/mainip file.
  7. Run the /scripts/fixetchosts command to add the IP address and hostname of your server to the /etc/hosts file.


 

...

 

Section


Column
width72px

Image RemovedImage Added


Column

Change the IP address of all accounts to the correct IP address.

After you transfer the accounts to the new server, the system may have set the IP addresses of the accounts to the new server’s original main IP address. You must change each account's IP address to the current IP address with WHM's IP Migration Wizard How to Move All cPanel Accounts from One Server to Another interface (WHM >> Home >> IP Functions >> IP Migration Wizard).


 

...

 

Section


Column
width72px

Image RemovedImage Added


Column

Add the new server to the DNS cluster.

Note
titleNote:

If your server does not belong to a DNS Cluster, proceed to Step 7.

To add the new server to the DNS cluster, perform the following steps:

  1. Navigate to WHM's DNS Cluster How to Move All cPanel Accounts from One Server to Another interface (WHM >> Home >> Clusters >> DNS Cluster).
  2. Select Enable DNS Clustering.
  3. Click Change.
  4. Click Return to Cluster Status.
  5. Select the server to add to the DNS cluster from the Add a new server to the cluster menu.
  6. Click Configure.


 

...

 

Section


Column
width72px

Image RemovedImage Added


Column

Reinstall all SSL certificates.

Note
titleNote:

Proceed to Step 8 if your server meets the following conditions:

  • The accounts on your server do not use SSL certificates from a Certificate Authority.
  • Both of your servers use an SNI-capable operating system. 

To upload an existing SSL certificate to your server, perform the following steps:

  1. Navigate to WHM's Install an SSL Certificate on a Domain How to Move All cPanel Accounts from One Server to Another interface (WHM >> Home >> SSL/TLS >> Install an SSL Certificate on the Domain).
  2. Paste the certificate into the text box, or click Fetch to upload a .crt file.
  3. Click Submit to install the certificate.


 

...

 

Section


Column
width72px

Image RemovedImage Added


Column

Confirm that you possess a valid cPanel license.

After you move all of your accounts to your new server, confirm that you possess a valid cPanel license. To do this, navigate to our License Verification interface.


...

Localtab Group


Localtab
activetrue
titleSuggested documentation

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("migrations","restore","transfers") and label = "whm" and space = currentSpace()


Localtab
titleFor cPanel users

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("migrations","restore","transfers") and label = "cpanel" and space = "ALDDOC"


Localtab
titleFor WHM users

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("migrations","restore","transfers") and label = "whm" and space in (currentSpace(),"ALDDOC")


Localtab
titleFor developers

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("migrations","restore","transfers") and space = "SDKDD"