H-Sphere Sysadmin Guide

Restoring H-Sphere From Backup

 

Related Docs:  

Backing Up H-Sphere Restoring the H-Sphere System Database Recovering Services

 

Restoring H-Sphere Content

H-Sphere content could be backed up either automatically by the hs_bck backup script, or manually by saving the corresponding files, directories and databases.

The H-Sphere backup destination directory for the /hsphere/shared/backup/hs_bck script is set in the /hsphere/shared/backup/hs_bck.cfg config file. The default location is:
BCK_DIR /var/backup

hs_bck stores the system data backup (with user content if configured in hs_bck.cfg) in the following files in the BCK_DIR directory:

  • <ARCHIVE>.tgz - the latest backup; <ARCHIVE> is the name of the backup file set in hs_bck.cfg. This is the default name:
    BACKUP hs_bck
    Older backup files are named <ARCHIVE>.1.tgz, <ARCHIVE>.2.tgz, ...
  • hsphere.sql - the H-Sphere system database backup;
  • counter.sql, poll.sql, guestbook.sql - SiteStudio system databases are also backed up if SiteStudio is integrated with H-Sphere.

 

Restoring The H-Sphere System Database

The H-Sphere system database restore is described here.

 

Restoring System Data

Untar <ARCHIVE>.tgz in the H-Sphere backup directory. System data is restored to the corresponding locations:

  • ~cpanel/shiva/psoft_config/ (H-Sphere configuration files)
  • ~cpanel/shiva/shiva-templates/IMAGES/ (H-Sphere and custom images)
  • ~cpanel/shiva/custom/ (customization directory)
  • /hsphere/shared/SiteStudio/psoft_config/ (SS config)
  • /hsphere/shared/SiteStudio/var/websites/ (SS sites)

 

Restoring User Content

Untar <ARCHIVE>.tgz in the H-Sphere backup directory on a box you wish to restore user content. User content is restored to the corresponding locations:

DNS server:

  • /etc/named.conf
  • /hsphere/local/var/named/

Web server:

  • /hsphere/local/home/ (users' dirs)
  • /hsphere/local/config/ (httpd and ftp configs)
  • /usr/local/frontpage/ (frontpage configs)

Mail server:

  • ~vpopmail/domains/
  • ~vpopmail/etc/
  • ~qmaild/users/
  • ~qmaild/control/

MySQL server:

  • ~mysql/

Note: If you back up MySQL databases using the mysqldump utility, restore them according to the instructions in MySQL documentation.

PostgreSQL server:

  • For Linux servers:
    ~postgres/
    For FreeBSD servers:
    ~pgsql/

Note: If you back up PostgreSQL databases using the pg_dump or pg_dumpall utility, restore them according to the instructions in PostgreSQL documentation.

 

Recovering H-Sphere Services

If you wish to recover services such as Web, mail, DNS, MySQL/PostgreSQL servers, use the PhysicalCreator utility as outlined in the corresponding documentation.

 

Recovering H-Sphere To Clean Servers

  1. Install H-Sphere on a clean server.
  2. Delete the user wwwuser in Control Panel.
  3. Restore system data on the CP server:
    a) restore the H-Sphere system database;
    b) restore the /hsphere/local/home/cpanel/shiva/psoft_config directory content from the backup; all this content should have cpanel:cpanel ownership.
  4. Recover H-Sphere services: Web, mail, DNS, etc., - the corresponding resources and configuration on the CP server, by means of the H-Sphere Physical Creator.
  5. Restore user content to the corresponding directories across H-Sphere servers.

 


Related Docs:  

Backing Up H-Sphere Restoring the H-Sphere System Database Recovering Services



© Copyright 1998-2004. Positive Software Corporation.
All rights reserved.