Recovering H-Sphere Control Panel

This document provides a general outline on how to recover H-Sphere Control Panel to a new server if the old one has crashed due to hardware or other problems. We will be looking into two situations:

• You have been having hardware problems that didn't affect the HDD, and you can access the HDD. This also applies to hacked servers. In this case, you'll have to mount the HDD of the crashed server to the new server to copy below system data from it.
• You've had a HDD failure and/or the HDD is inaccessible. In this case, you'll have to restore below system data from a backup.

In either case it is presumed that your old server is down and no H-Sphere servers are running.

This instruction doesn't give file/directory locations for FreeBSD, because Linux is the recommended operating system for the CP server.

Step 1. Prepare for the recovery

1. In versions before 2.4.2 beta 2, the installer returns an error at the end of the installation if you choose to install only CP and system database. Please disregard the error and proceed with the recovery.
2. 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.
3. Stop H-Sphere CP on the target server.

Step 2. Recover system data

1. Log into the target server as root.
2. Copy files and directories in the table below from the source server or backup to the target server.
   • If you are recovering from a backup made by the psoft script, untar the backup archive copy the below directories.
   • If you are recovering data from the HDD of the crashed server, just copy the below directories:
     rsync -arlpogvzt -e ssh <SOURCE_SERVER_IP>:<DIRECTORY_PATH> <TARGET_DIRECTORY_PATH>
3. Start H-Sphere CP on the target server.

Files And Directories To Recover