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
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.
- 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.
- Stop H-Sphere CP on the target server.
Step 2. Recover system data
- Log into the target server as root.
- Copy files and directories in the table below from the source server or backup to the target server.
- Start H-Sphere CP on the target server.
Files And Directories To Recover
||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, etc.
||SiteStudio user data
||H-Sphere and SiteStudio system databases and database settings
|H-Sphere knowledge bases