Chapter 11. Backing Up and Restoring the Red Hat Storage Console

Procedure 11.1. Backing up the Red Hat Storage Console

1. Log on to the machine running the Red Hat Storage Console.
2. Run the following command to create a full backup:

   Example 11.1. Creating a Full Backup

   # engine-backup --scope=all --mode=backup --log=[file name] --file=[file name]

   Alternatively, run the following command to back up only the engine database:

   Example 11.2. Creating an engine database Backup

   # engine-backup --scope=db --mode=backup --log=[file name] --file=[file name]

Procedure 11.2. Restoring a Backup to a Fresh Installation

1. Log on to the machine on which the Red Hat Storage Console is installed.
2. Manually create an empty database to which the database in the backup can be restored and configure the postgresql service:
   1. Run the following commands to initialize the postgresql database, start the postgresql service and ensure this service starts on boot:

      # service postgresql initdb
      # service postgresql start
      # chkconfig postgresql on

   2. Run the following commands to enter the postgresql command line:

      # su postgres
      $ psql

   3. Run the following command to create a new user:

      postgres=# CREATE USER [user name] PASSWORD '[password]';

      The password used while creating the database should be same as the one used while taking backup. If the password is different, follow step 3 in Section 11.1.7, “Restoring a Backup with Different Credentials”
   4. Run the following command to create the new database:

      postgres=# create database [database name] owner [user name] template template0 encoding 'UTF8' lc_collate 'en_US.UTF-8' lc_ctype 'en_US.UTF-8';

   5. Edit the /var/lib/pgsql/data/pg_hba.conf file and add the following lines under the 'local' section near the end of the file:
      • For local databses:

        host    [database name]    [user name]    0.0.0.0/0    md5
        host    [database name]    [user name]    ::0/0        md5

      • For remote databases:

        host    [database name]    [user name]    X.X.X.X/32   md5

        Replace X.X.X.X with the IP address of the Manager.
   6. Run the following command to restart the postgresql service:

      # service postgresql restart

3. Restore the backup using the engine-backup command:

   # engine-backup --mode=restore --file=[file name] --log=[file name]

   If successful, the following output displays:

   Restoring...
   Note: you might need to manually fix:
   - iptables/firewalld configuration
   - autostart of ovirt-engine service
   You can now start the engine service and then restart httpd
   Done.

4. Run the following command and follow the prompts to set up the Manager as per a fresh installation, selecting to manually configure the database when prompted:

   # engine-setup

Procedure 11.3. Restoring a Backup to an Existing Installation

1. Log on to the machine on which the Red Hat Storage Console is installed.
2. Run the following command and follow the prompts to remove the configuration files for and clean the database associated with the Manager:

   # engine-cleanup

   Manually drop the database and create an empty database to which the database in the backup can be restored and configure the postgresql service
   1. Run the following commands to enter the postgresql command line:

      # su postgres
      $ psql

   2. Run the following command to drop the database:

      # postgres=# DROP DATABASE [database name]

   3. Run the following command to create the new database:

      # postgres=# create database [database name] owner [user name] template template0 encoding 'UTF8' lc_collate 'en_US.UTF-8' lc_ctype 'en_US.UTF-8';

3. Restore the backup using the engine-backup command:

   # engine-backup --mode=restore --file=[file name] --log=[file name]

   If successful, the following output displays:

   Restoring...
   Note: you might need to manually fix:
   - iptables/firewalld configuration
   - autostart of ovirt-engine service
   You can now start the engine service and then restart httpd
   Done.

4. Run the following command and follow the prompts to re-configure the firewall and ensure the ovirt-engine service is correctly configured:

   # engine-setup

Procedure 11.4. Restoring a Backup with Different Credentials

1. Log on to the machine on which the Red Hat Storage Console is installed.
2. Run the following command and follow the prompts to remove the configuration files for and clean the database associated with the Manager:

   # engine-cleanup

   Manually drop the database and create an empty database to which the database in the backup can be restored and configure the postgresql service:
   1. Run the following commands to enter the postgresql command line:

      # su postgres
      $ psql

   2. Run the following command to drop the database:

      # postgres=# DROP DATABASE [database name]

   3. Run the following command to create the new database:

      # postgres=# create database [database name] owner [user name] template template0 encoding 'UTF8' lc_collate 'en_US.UTF-8' lc_ctype 'en_US.UTF-8';

3. Restore the backup using the engine-backup command with the --change-db-credentials parameter:

   # engine-backup --mode=restore --file=[file name] --log=[file name] --change-db-credentials --db-host=[database location] --db-name=[database name] --db-user=[user name] --db-password=[password]

   If successful, the following output displays:

   Restoring...
   Note: you might need to manually fix:
   - iptables/firewalld configuration
   - autostart of ovirt-engine service
   You can now start the engine service and then restart httpd
   Done.

4. Run the following command and follow the prompts to re-configure the firewall and ensure the ovirt-engine service is correctly configured:

   # engine-setup