H-Sphere Documentation Sysadmin Guide


Recovering H-Sphere Control Panel


Related Docs:   Restoring H-Sphere from Backup Recreating Unix Hosted Servers Recovering Winbox

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. On the target server, install exactly the same version of H-Sphere Control Panel as on the source server.
    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:
  3. Start H-Sphere CP on the target server.


Files And Directories To Recover

Item Comment
/hsphere/local/home/cpanel/shiva/psoft_config/ H-Sphere configuration and properties files
/hsphere/shared/SiteStudio/psoft_config/ SiteStudio configuration and properties files
/hsphere/local/home/cpanel/apache/etc/ Apache configuration and properties files
/hsphere/local/home/cpanel/shiva/shiva-templates/IMAGES Control Panel icons and images
/hsphere/local/home/cpanel/shiva/custom Custom Control Panel templates, etc.
/hsphere/shared/SiteStudio/var/websites SiteStudio user data
/var/lib/pgsql H-Sphere and SiteStudio system databases and database settings
H-Sphere knowledge bases

Related Docs:   Restoring H-Sphere from Backup Recreating Unix Hosted Servers Recovering Winbox

Home   Products   Services   Partners   Support   News   Contact   Forum
© 2020 psoft.net.
All rights reserved.