Parallels H-Sphere Documentation System Administrator Guide

 

Recovering H-Sphere Control Panel

 
 

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

Last modified: 02 Aug 2007

 

WARNING: This documentation covers Parallels H-Sphere versions up to 3.1. For the latest up-to-date Parallels H-Sphere documentation, please proceed to the official Parallels site.

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.
  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

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 (on Linux)
/var/db/pgsql or /usr/local/pgsql (on FreeBSD)
H-Sphere and SiteStudio system databases and database settings
/hsphere/local/home/cpanel/.kb/
/hsphere/local/home/cpanel/.attachments/
H-Sphere knowledge bases

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



© Copyright 2017. Parallels Holdings. All rights reserved.