Migrating a cPanel Account

Posted on December 5, 2018 by Andrej Walilko | Updated: December 7, 2018
Category: Tutorials | Tags: account management, copy, cpanel, migrate, migration, migrations, transfer, whm

Moving domains or accounts between servers is just another necessity of server ownership. It may be necessary to upgrade your operating system, consolidate or decentralize your domains, get onto a different platform type (dedicated or cloud), or refresh your hardware to newer specifications. WHM makes it easy to move all or a portion of your cPanel accounts from an existing cPanel server using a variety of easy-to-use tools.

It’s important to remember that we are not moving domains when we migrate them, we are just copying them. While you are migrating, sites stay live at the origin server until DNS is changed.

There are three different methods we will look at for migrating, all of which are executed from the target server (the server to which we will be copying data and will eventually host the domain).

What Will Be Migrated?

Essentially, everything that can be associated with one specific cPanel account is included in the cPanel backup structure. This includes, but is not limited to:

metadata for setting up the account, like the username, password, list of domains, DNS zone file, and custom apache includes files
full home directory of the account, including the document root (site files), email files and forwarders for all of the owned domains
MySQL databases, users, and grants that are mapped to the account
SSL keys and certificates
statistics files like bandwidth usage or AWStats

Items that are not migrated are excluded from the backup structure of the single cPanel account. This might include:

databases used by the account that belongs to a completely different cPanel account that is not part of your migration
grants or databases set up from the command line and not mapped to your cPanel account
other file dependencies outside of the cPanel user’s home directory (such as the /images directory on another partition)
extra programs and configurations that are set up server-wide, even if they are only installed for one user’s benefit (such as Sphinx or ImageMagick)
server-wide configurations such as email sending limits or global PHP settings

If there is anything that the site depends on outside of the cPanel structure, you’ll need to set up manually and ahead of time. Everything you set up directly inside of the cPanel account will be included.

Getting Ready To Migrate

When starting a migration, the end goal should be in mind: updating DNS to make the domain live on the target server. So, the first thing we should do is determine where DNS is hosted for the domains we are migrating, and lower the TTL value for the A records, without actually changing the IP address values. This allows for quicker propagation when we do eventually change the IPs.

If your DNS is in several locations, you might consider consolidating it to a single location in advance. If that happens to be Liquid Web’s shared nameservers, you can use the Live Import feature when setting up your zone files to import much of the public DNS zone file without effort. This will let you change your DNS to Liquid Web without changing any of the traffic to your sites.

We should also have a look at the versions of software on the source machine and make sure that something compatible is available on the target machine. This can be as thorough as you like, but I recommend at least looking at the PHP version on the old server and what is available in EasyApache 4 on the new server, and if possible, adding that version.

Finally, we will need to have some level of access on the source server, either credential for root or for the cPanel user we are migrating. The access level will define the method we use.

Copying Data: cPanel Account or Reseller Access

If you only happen to have a cPanel account username and password, there are two options. The first is to create a backup using the cPanel GUI on the source server, download it to the target server, and restore it from the command line. For ease of use, all of these functions are encompassed in the WHM tool handily titled “Copy an Account From Another Server With an Account Password”.

The WHM tool, "Copy an Account from Another Server With An Account Password" lets you migrate a cPanel account.

This cPanel tool, like all the others we will go over, is used on the target server. It allows you to enter a domain name, hostname, or IP address for a source server, as well as the username and password combination for logging into cPanel. The tool will function very well for a single cPanel account if the servers can reach each other and the source server supports a generation of backups from the cPanel account.

The copy tool will perform the following actions:

Connect to the source cPanel server and log in using provided credentials.
Start a generation of a cPanel backup to the local directory.
Recheck the backup generation once per minute to see if it is complete.
Once the backup is finished, download the backup to a temporary directory on the local server.
Restore the backup and delete the backup file.

For a basic migration of a single account, you can’t ask for much more in terms of simplicity; it is a GUI after all! It also doesn’t require elevated access like the other two methods; if you can log into the cPanel account, you can usually migrate that account using this tool.

This method also works if you have a reseller with WHM access; you can use that reseller’s password in this tool in place of the cPanel user password to migrate a single account.

This tool will not do anything in terms of global configurations or version matching, nor will it affect the DNS of the migrated account. It also cannot work on every single source server; some hosts turn off the ability for cPanel accounts to make their own backups. There is also the concern of sufficient free disk space on the source machine. Make sure there is enough room to make a full cPanel backup before starting this procedure.

Copying Data: WHM Access

With root-level WHM access, it becomes effortless to migrate multiple cPanel accounts at once. This is the same concept as the cPanel tool, but is rolled into a more broadly termed “Transfer Tool”. The "Transfer Tool" in WHM allows you to copy data from one server to another.

This tool works with root-level SSH access to the source server using a password, key, or SSH user with privileges to escalate to root. After entering the source server hostname or IP and the SSH information and credentials, the tool will collect a list of accounts on the source machine and present a checklist of accounts it can migrate for you. After making your selections, it works in parallel to bring accounts into the new server in the same fashion as the cPanel-only access tool above.

If you are bringing over a selection of users or even a full server into a new machine, or are combining accounts from multiple servers into one, this graphical tool is ideal. It also has the ability to bring over basic configurations from the source server into the target server, to help match the WHM environments.

There are some pitfalls to this method, however, including the need for SSH access as root to the source server. Reseller or cPanel user passwords won’t work here either. You need to be able to get into the server as the root user. Again, there is the need for sufficient disk space on the source server.

Note

Filling up your hard disk completely with temporary backup files could cause all your sites on the source server to go offline!

Copying Data: SSH Access

A command line method for migrating a single cPanel account is available as well. A backup can be created on the source server using the pkgacct function:

/scripts/pkgacct username

By default, pkgacct will make a full backup of the user specified, and place the backup at /home/cpmove-username.tar.gz. It might be preferable to place the backup inside the user’s home directory instead and give it a unique name; this can be done by adding the –userbackup flag:

/scripts/pkgacct --userbackup username

The command will make the same backup, but instead, it will be placed at /home/username/backup-mm.dd.yyyy_hh:mm:ss_username.tar.gz, with the unique identifier of the start time of the backup task.

After the backup is created, it can be copied over to the new server using your favorite method. You may prefer to use scp from the target server, just in case the source server has a rootkit we don’t know about:

scp root@123.45.67.89:/home/cpmove-username.tar.gz /home/

This will place the backup in the /home/ directory when executing from the target machine. You can then easily restore using the restorepkg command:

/scripts/restorepkg /home/cpmove-username.tar.gz

That’s all! The account will be recreated, reconfigured, and repopulated with the contents of the backup.

A more accurate and flexible method for migrating cPanel accounts is to use command line tools on both servers to create targeted backups of only the data you need to restore the account. Then you can bring over additional files and databases to complete the backup separately. That method is quite a bit more complex than the tools we are covering, and outside the scope of this article. If you have disk space issues on your source server that can’t be reconciled, or require more precise control to specific portions of the cPanel accounts that are being migrated, you can read a bit more at this blog post. You can check the help text for the /scripts/pkgacct command by running it without arguments.

Verify Data Migration

After completing the account migration using any of the graphical methods, you should be presented with the transfer session log. This log lists any errors that may have occurred during the transfer, such as a missing file, or a conflict with another account. If there are no issues, you’ll be able to check the “List Accounts” function on your target WHM panel to see the migrated accounts.

To test the functionality of these migrated accounts, we recommend modifying your computer’s hosts file and browse the new server directly. Changing your /etc/hosts file is the most accurate method of testing since the server and your browser both believe that this is real live traffic.

Migration Troubleshooting

Some common issues encountered during a cPanel migration include:

Naming conflicts. If a conflict is found, the account will fail to restore. In the case of the WHM Transfer Tool, it will detect these conflicts before you start the task, and allow you to rename the restored account. But, the cPanel-level tool may not verify this before starting and fail part way through the restore. In this case, you can download the backup from the source server, upload it to the target server, and use the command line restorepkg tool to load the package with a new name:

/scripts/restorepkg --newuser anothername /path/to/uploaded/backup-file.tar.gz

Database name conflicts. In these cases, the conflict is not fatal; the restore command will instead change the name of the database (usually by putting a ‘2’ at the end) and then restore the database there instead. You will have to go into your website files and change any pointers to the database name to the new one.
Disk space issues. There must be enough room on the new server to completely extract the cPanel backup; WHM generally calculates this by multiplying the size of the backup by about 3. The best cure for this is to clean up the disk space on the target server, but if this is not plausible (and you know the account will fit), you can fall back to the manual method of skipping the home directory in the package and bringing it over separately.

Update DNS and Finalize Migration

After confirming that the new server is working as you expect, the only remaining step in bringing it live. Updating the DNS for the domain at its current nameservers is necessary. Because we lowered the TTL values at the start of the migration the new change should propagate around the Internet quickly. DNS propagation can still take a few hours to change completely. If DNS is hosted on the source server, you can change this directly in cPanel. Otherwise, check the documentation or help pages for your current nameservers for changing the A record (Liquid Web’s can be found here).

If you do happen to be using the source server as your nameserver, you will also need to make sure that DNS authority is shifted elsewhere: the target server, Liquid Web’s DNS server, or a 3rd party DNS service. Should the source server be terminated or the cPanel account deleted from the source machine, the domain’s zone files will stop working, and the site will go offline. So don’t skip this critical step in finishing your server move!

Need Help?

Liquid Web offers our customer migration services for all of its fully managed products. If a cPanel migration sounds overwhelming, we have a dedicated team available to guide you through the entire process! After ordering a new fully managed server, you can request a migration right from your Manage account. We aren’t limited just to cPanel sources, either. Our experts can analyze any migration and access method for feasibility and have an excellent success rate.

Ready to try your own migration? Order a new Managed Cloud VPS server today!

Windows User Account Management

Posted on November 7, 2018 by Matthew Hurst
Category: Getting Started | Tags: account management, add, computer management tool, create, deleting, disabling, groups, password, windows, workstation

Managing who has access to your server, and what type of access that person is an important part of server administration. This article will address multiple areas relating to user accounts on the Windows operating system. It assumes your Windows Server is on a “Workstation” and not a part of an Active Directory domain. The process for resetting an Active Directory user account is different and out of scope for this article.

To determine if your server is on a workstation, or an Active Directory domain, launch PowerShell and run the following command.

Get-WmiObject Win32_ComputerSystem | Select-Object domain

The output looks similar to this:

Running the command above lets the user know they are running a "Workstation" or "Active Directory" with Windows servers.

Jump to a Specific Topic

Computer Management Tool (compmgmt.msc)
Creating Accounts
Resetting Passwords for User Accounts
Adding Users to Groups
Creating Groups
Deleting and Disabling Accounts

Computer Management Tool

You will use the “Computer Management” tool to create and manage Windows accounts. We will perform all of our user management from this tool.

To open the Computer Management tool, in a command prompt, or in a PowerShell console, type the following.

compmgmt.msc
Press Enter

Alternatively, you can right-click the start button and select “Computer Management”. You’ll see a tool comparable to the following.

The "Computer Management" tool lets you create Windows accounts.

Creating Accounts

While using the Computer Management tool, expand “Local Users and Groups” and click the “Users” folder. You can now view all of the existing user accounts on the server on the right-hand pane.

To create a new user, perform the following steps.

Select “More Actions” under the “Actions” pane on the right, and then select “New User”.

The “New User” window will pop up where you can fill out the following information.

User Name: (Required)
Full Name: (Optional descriptor)
Description: (Optional descriptor)
Password: (Optional)

The following options are available upon creating a new user account.

The user must change the password upon login. (Select this if creating an account for someone other than yourself)
The user cannot change the password. (Optional. For specific use cases)
Password never expires. (Typically used for service accounts)
The account is disabled. (Optional. For specific use cases)

When you are ready to go, hit create and your new user account should show up.

Resetting Password for User Accounts

You may need to reset a password for a user account for multiple reasons. This is an easy task within the “Windows Management” tool.

To reset an account password perform the following steps:

In Windows Management expand “Local Users and Groups” and click the “Users” container.
Locate the user account you want to edit in the middle pane, and right-click the account.
Select “Set Password”
Read the notice pop up, and select Proceed.
Set the password and hit OK.

The password requirements are customizable on your server, but the default values are below for reference.

Not contain the user’s account name or parts of the user’s full name that exceed two consecutive characters
Be at least six characters in length
Contain characters from three of the following four categories:
English uppercase characters (A through Z)
English lowercase characters (a through z)
Base 10 digits (0 through 9)
Non-alphabetic characters (for example, !, $, #, %)
Complexity requirements are enforced when passwords are changed or created.

Please note, when resetting the password for the administrator account, be sure to also update your Liquid Web control panel to continue receiving Heroic Support.

Adding Users to Groups

Groups allow you to manage permissions and right assignments for multiple users at a time. There are many system groups created by default when you install windows. Assigning users to these system groups gives specific rights to users such as “Backup Operator”. If you would like a user to have remote desktop privileges, but not be an administrator, you assign them to the “Remote Desktop Users” group. Assigning a user to the “Administrators” group, by default gives the account “Remote Desktop Users” privileges.

To assign a user account to a local group perform the following steps.

In Windows Management expand “Local Users and Groups” and click the “Groups” container.
Locate the group you want to add the user to, right click it and select “Add to Group”
In the new window, you will see the current members of the group. Select “Add” at the bottom.

A new window will pop up “Select Users”.
Enter the account name to add, and hit check names.
Hit OK to add the account to the group.

Creating Groups

Occasionally you might need to create custom groups. Typical use cases are for assigning folder or file level permissions.

To create a new group in Windows Management execute the following.

In Windows Management expand “Local Users and Groups” and click the “Groups” container.
Select “More Actions” under the “Actions” pane on the right, and then select “New Group”.
The “New Group” window will pop up.
Assign a group name.
The description is optional.
If you like, you can add accounts to the group upon creation by clicking “add”.
Select Create.

Your new group should now be available to assign members.

Caution:

It is possible to lock yourself out of the server or cause other unforeseen issues with the following actions. If you are unsure, please feel free to reach out to your Heroic Support™ team for assistance.

Deleting and Disabling Accounts

When users no longer require access to your server, you might want to revoke their access by deleting or disabling their account. Typically, you will want to disable accounts for a short period before deleting them. This allows you to recover from issues that might arise from removing an account.

To disable an account in “Windows Management” tool perform the following steps.

In Windows Management expand “Local Users and Groups” and click the “Users” container.
Locate the user account you want to edit in the middle pane, and right-click the account.
Select properties to expose the account properties window.
Under the “General” tab, select the “Account is disabled” box and hit OK.

Disable or delete an account within your windows server by using the Windows Management tool.

To delete an account in “Windows Management” tool perform the following steps.

In Windows Management expand “Local Users and Groups” and click the “Users” container.
Locate the user account you want to edit in the middle pane, and right-click the account.
Select “Delete”
Read the notice and select “Yes” when ready.

Our Support Teams are filled with talented admins with an intimate knowledge of multiple web hosting technologies, especially those discussed in this article. If you are Fully Managed VPS customer and you are uncomfortable with performing the outlined steps, we are a phone call, chat or ticket away from assisting you with this process.

Creating an API User in Manage

Posted on December 11, 2017 by Dan Pock
Category: Billing + Manage | Tags: account management, api, manage, security

Liquid Web’s Account Management System has a robust API that allows for accessing your account from outside of the Manage interface. For example, the API can be used to integrate WHMCS directly to your Liquid Web account. To access the API, an API user must first be created for that account.

Continue reading “Creating an API User in Manage” →

Using the Self-Service Email Migration Tool for Premium Business Email and Hosted Exchange

Posted on November 24, 2017 by Libby White | Updated: December 13, 2017
Category: Getting Started, Products | Tags: account management, email, Hosted Exchange, Premium Business Email

Migrating your email from your server to Liquid Web’s Premium Business Email is made easy with our free self-service migration tool. From your browser, navigate to https://liquidweb.selfmigration.com and follow the instructions below. If your migration seems to be taking longer than expected, please see the troubleshooting section of this article. Continue reading “Using the Self-Service Email Migration Tool for Premium Business Email and Hosted Exchange” →

Updating Your Server Password

Posted on November 14, 2017 by Libby White
Category: Billing + Manage, Getting Started | Tags: account management, password, server

As a security measure, your server’s root user and SSH information will not automatically update in your Liquid Web account when it is changed using WHM or the command line. Without having updated login credentials, our Heroic Support team is unable to proactively fix any server problems or allow us to begin working on your support ticket.

To update and register your login information, you will first need to log into your Liquid Web account.
Once you are logged in, expand the details of the server you’d like to update using the plus sign [+] next to the server name on the Overview page of your account.
Click the link Report current password on the upper right hand corner of the server dashboard.
A pop-up will appear asking you to confirm your root password. Enter the default root user password twice in this section to allow us to login using this user login.

What is a Glue Record?

Posted on November 14, 2017 by Libby White | Updated: November 24, 2017
Category: Getting Started | Tags: account management, dns, glue record, server

As we learned in our article What Are Domains?, a domain is associated with an IP address that directs visitors to the right location in the Internet that houses your site and its contents. In the same way, a Glue Record binds the IP address to a static cache so visitors can always locate your site without issue. This avoids impossible dependencies for that DNS zone. Your registrar holds the Glue Record and allows traffic to be directed without using the lookup process of DNS. You often see a Glue Record used for nameservers, but it is occasionally in other records depending on circumstances. Continue reading “What is a Glue Record?” →

Checking Resource Usage in Cloud Sites

Posted on February 27, 2017 by Dan Pock | Updated: November 14, 2017
Category: Getting Started | Tags: account management, bandwidth, cloud sites, disk usage, linux, mssql, mysql, windows

The Usage tab in your Cloud Sites control panel provides information on the amount of bandwidth, disk space and database usage for your sites. Your Cloud Sites control panel includes 50GB of disk space and 500GB of bandwidth. You can log into your Liquid Web Cloud Sites account to view the current charges for additional space and bandwidth use.

View Resource Usage Data

To help you keep track of these metrics, the Usage tab gives you a breakdown of your usage so that you can adjust accordingly and avoid any issues.
Continue reading “Checking Resource Usage in Cloud Sites” →

Liquid Web | Knowledge Base

Tag: account management