This document provides a general outline on how to migrate H-Sphere Control Panel to a different server.
This is a basic one-to-one server migration, which doesn't involve any other servers. If you need a
more complex migration, please request it from our support team.
This instruction doesn't give file/directory locations for FreeBSD,
because Linux is the recommended operating system for the CP server.
Please be prepared that copying data between servers may take a long period of time.
Step 1. Prepare for migration
- On the target server, install the latest stable version.
- On the source server, update to the latest stable version.
- Make sure the source and target servers have the same versions of all software packages.
For example, make sure that the target server has the same version of PostgreSQL as the source server.
Step 2. Move system data
- Log into the target server as the cpanel user.
- Copy files and directories in the table below from the source server to the target server
with the rsync utility:
rsync -arlpogvzt -e ssh <SOURCE_SERVER_IP>:<DIRECTORY_PATH> <TARGET_DIRECTORY_PATH>
||H-Sphere system database and SiteStudio databases
||Apache configs, including SSL certs for master admin and resellers
|H-Sphere knowledge bases
||Custom H-Sphere templates etc.
||H-Sphere configuration files
||SiteStudio configuration files
- Stop H-Sphere CP on the target server.
- Stop H-Sphere CP on the source server.
- Repeat the rsync command for each of the above directories
to synchronize any changes made while you were copying the data.
Step 3. Change IPs on the target server
- Switch the IPs of the source and target servers. To do this, you'll need to run the setup
utility on each of the two servers.
- Reboot both source and target servers simultaneously to avoid having the same IP
on both servers.
- Restart the router.
- Start H-Sphere CP on the target server.