How to Manually Migrate Accounts to cPanel from Unsupported Control Panels

How to Manually Migrate Accounts to cPanel from Unsupported Control Panels

Overview

This document describes how to migrate your web accounts from unsupported third-party control panels to cPanel & WHM.

Warning:

  • We strongly recommend that only advanced system administrators who understand migrations perform this process.
  • Your websites will likely experience downtime during this process.

cPanel, Inc. offers free migration services from the following third-party control panels:

  • Odin Plesk (formerly Parallels)
  • DirectAdmin
  • Ensim

cPanel & WHM supports the following services:

  • Apache
  • Bind
  • Exim
  • Mailman

Any other services on the third-party control panel require that you customize them to function in a cPanel & WHM environment.

If you do not host your account on one of these control panels, you must manually migrate your web accounts to a cPanel & WHM server.

 

Migrate your accounts


Lower your DNS Time to Live.

Decrease your DNS records’ Time To Live (TTL) on all of your account’s domains. This forces clients to update their copy of the DNS zones that your nameservers host. We recommend that you perform this action several days before you begin the migration process.

 


 

Install cPanel & WHM on your new server

Before you transfer the accounts, install cPanel & WHM on your new server.

During the installation process, select a hostname and main IP address for the new server. You can perform this action in WHM’s Basic WebHost Manager Setup interface (Home >> Server Configuration >> Basic WebHost Manager Setup). The system configures the DNS zone files of restored accounts with those settings.

Important:

  • Select a main IP address that is not your old server’s main IP address.
  • Select the same hostname, shared IP address, and nameservers as your old server.

Note:

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 is noteligible for a trial license, contact Customer Service.

 


 

Migrate the files.

After you create a new cPanel & WHM account, migrate your old account’s files and directories to your new account’s appropriate files and directories.

The following table describes files and directories that you commonly use when you transfer an account to a cPanel & WHM server:

Directory
Description
Notes
Examples
/home/user/public_html

This directory contains all of your files, directories, subdirectories, and content.

  • This directory may appear as the home/user/www directory or the /home/user/vhost directory on some systems.
  • The account user must own the files and subdirectories in this directory.
  • The subdirectories in this directory must possess 755 permissions.
  • The files in these directories must possess 644 permissions.
/home/user/mail

This directory contains all of the email files for every email account on the cPanel account.This includes any addon domains, parked domains (aliases), and subdomains.

A directory for each domain, subdomain, addon domain, and parked domain exists in the /home/user/mail directory. These directories include subdirectories for each email address associated with the domain.

Users who migrate data to cPanel & WHM servers must convert any mbox data to the Maildir format.

 

 
/home/user/tmp

This directory contains the temporary files for the account, as well as bandwidth and web statistics data.

For example, you can migrate your original server’s AWStats data to the /home/user/tmp/awstats directory.

When you migrate the bandwidth and web statistics data to a cPanel & WHM server, the system uses the data to create web statistics files.

 

 

 

/home/user/etc

This directory contains the email account password, shadow, and quota files for current email accounts.

For example, you can migrate your original server’s email account quota data to the /home/user/etc/quota directory.

N/A
 
/home/usr/ssl

This directory contains the SSL certificates associated with the domains on the cPanel account.

After you migrate the SSL certificates, you must activate them in the Manage SSL Hosts section of WHM’s Manage SSL Hosts interface (Home >> SSL/TLS >> Manage SSL Hosts).

 

 

/var/lib/mysql

This directory stores the MySQL® databases for every account on the server.

  • You must create the empty database on the cPanel account first, and then restore it on to that database.To do this, use cPanel’s MySQL Database Wizard interface (Home >> Databases >> MySQL Database Wizard).
  • You must create a dump of your database and import it via cPanel’s phpMyAdmin interface (Home >> Databases >> phpMyAdmin).
 
/var/lib/pgsql

This directory stores the PostgreSQL databases for every account on the server.

  • You must create the empty database on the cPanel account first, and then restore it on to that database.To do this, use cPanel’s PostgreSQL Database Wizard interface (Home >> Databases >> PostgreSQL Database Wizard).
  • You must create a dump of your database and import it via cPanel’s phpPgAdmin interface (Home >> Databases >> phpPgAdmin).
 

 


 

Migration completion and DNS updates.

After you migrate your content to your new cPanel & WHM server, perform the following steps:

  1. Confirm that all of your content and credentials migrated properly and that they function in the new environment.
  2. Update your domain’s nameservers to match the new nameservers on your cPanel & WHM server.

    Note:

    We recommend that you also edit the DNS records on your old server to point to your cPanel & WHM server so that all content forwards to the new server.

Was this article helpful?

Related Articles

Leave A Comment?