Control Panel Server Migration

By server migration we mean moving applications and data from one server to another while keeping old IPs for the new server.

It is not recommended to erase data on the old server in case you forget to move something or if you need any data from the old server. It is safer to shut down the old server after you check the functionality upon migration.

To perform Control Panel server migration:

1. Install H-Sphere Control Panel software on the target server (make sure to use the same H-Sphere version that is running on the source server).
   Note: If your source server is also running Site Studio, make sure to install Site Studio on the target server as well.
2. Stop Control Panel on the source server.
3. Move the following directories to the new server:



Directory			Files
/hsphere/local/home/cpanel/shiva/psoft_config/ /hsphere/shared/SiteStudio/psoft_config/ /hsphere/local/home/cpanel/apache/etc/ /hsphere/local/home/cpanel/shiva/shiva-templates/IMAGES /hsphere/local/home/cpanel/shiva/custom /hsphere/shared/SiteStudio/var/websites /var/lib/pgsql (Linux)  |  /var/db/pgsql (FreeBSD) /hsphere/local/home/cpanel/.kb/ /hsphere/local/home/cpanel/.attachments/			H-Sphere configuration and properties files SiteStudio configuration and properties files Apache configuration and properties files Control Panel icons and images Custom Control Panel templates SiteStudio user data H-Sphere and SiteStudio system databases and database settings * H-Sphere knowledge bases Trouble Ticket system attachments

* Before moving postgresql directory, make sure to:

1. Stop postgresql service on the source and target servers.
2. Dump H-Sphere and Site Studio databases on the source server and then restore them on the target server. Use our documentation for more info.

Note: if you have the same postgresql version on the source and target server, move this directory without dumping.

Alternatively, use rsync to move necessary data to the new server:

rsync -arlpogvzt -e ssh $login@$ip:$folder $folder      if you are using rsync on the target server
rsync -arlpogvzt -e ssh $folder $login@$ip:$folder      if you are using rsync on the source server
Note: $login usually is root.
4. Switch IPs between the old and new servers.

To find main server IP in Linux, go to:


/etc/sysconfig/network-scripts/ifcfg-eth0

To find main server IP in FreeBSD, go to:


/etc/rc.conf

Also, please make sure that main server IPs are excluded from the /hsphere/local/network/IPs file (corresponding IP on the corresponding server).

5. Prevent the startup of Control Panel service on the source server on reboot:

For Linux, run:


chkconfig --level2345 httpdcp off

For FreeBSD, run:


chmod 000 /usr/local/etc/rc.d/apachecp.sh
6. Reboot both servers and the router. Router reboot is needed to clear ARP cache. You can also do it using other methods.
7. Check the Control Panel functionality.

If you want to perform Server/IP migration, skip steps 4-6 and follow the instruction on Changing IPs instead.