This guide will only apply to larger schools in Domain of One’s Own environments that run multiple cPanel servers. Occasionally you might need to move an account from one server to another (this is something Reclaim Hosting does when students leave the school as well). Here’s a quick guide on how to do that in a DoOO environment:
Transfer Tool
Start with the server you are moving the account to (you’ll essentially be pulling the account from the old server to the new so you want to start with the destination server). Login to WHM, search Transfer Tool, and click it.
The Remote Server Address is the hostname of the server you’re transferring an account from. Authentication information should be with the root credentials listed in 1Pass. Note: cPanel has an option for a “Restricted Restore”, we do not recommend using this as it can often exclude necessary files and data in the account in the interest of security.
Click Scan Remote Server and WHM will connect to the origin server and generate a list of accounts hosted there. Searching is the easiest way to move an individual account (you can search by username or domain name). Be sure NOT to select Dedicated IP as this will cause problems. Check the account(s) you want to transfer and then click Copy to begin the migration process.
The connection between the servers will exist until the transfer process is finished. You'll see a progress bar that shows you the progress of both the transfer and the restore. Keep this screen open while the progress happens.
WHMCS
Once the account is moved to the new location, you will need to make a couple of changes to the WHMCS profile. Search the URL in WHMCS and check the Product tab to ensure the Server reflected there is the correct one. If not choose it from the drop-down and click Save Changes.
For New Ubuntu Servers (After January 2024)
With the new Ubuntu SH servers, there are a few additional steps to keep in mind after these cPanel migrations due to the difference in reseller accounts.
- WHM -> Modify Account button -> change reseller to new SH default reseller (rhshwhmcsrs).
- Run fixperms for the user.
- Change Package module in WHMCS to sync Package with new server.