Chapter 18. Backup and Disaster Recovery

Procedure 18.1. To Prepare the Backup Location and Back up Configuration and Data Files:

1. Prepare your backup location:

   # umask 0027
   # export BDIR=/backup
   # mkdir $BDIR
   # chgrp postgres $BDIR
   # chmod 770 $BDIR
   # cd $BDIR
   

   Copy to Clipboard Toggle word wrap
2. Back up the configuration and data files:

   # tar --selinux -czvf config_files.tar.gz \
   /etc/katello \
   /etc/elasticsearch \
   /etc/candlepin \
   /etc/pulp \
   /etc/pki/katello \
   /etc/pki/pulp \
   /etc/qpidd.conf \
   /etc/sysconfig/katello \
   /etc/sysconfig/elasticsearch \
   /root/ssl-build \
   /var/www/html/pub/*
   
   # tar --selinux -czvf elastic_data.tar.gz /var/lib/elasticsearch

   Copy to Clipboard Toggle word wrap

Procedure 18.2. To Perform an Online Repository Backup:

• Run the following commands to perform a checksum of all time stamps, back up the repository, and perform the checksum again.

  # find /var/lib/pulp -printf '%T@\n' | md5sum
  # tar --selinux -cvf pulp_data.tar /var/lib/pulp /var/www/pub
  # find /var/lib/pulp -printf '%T@\n' | md5sum

  Copy to Clipboard Toggle word wrap
  If the checksums match, the online backup is correct and usable. If the checksums do not match, perform the repository backup again.

  Note

  You can use the rsync command to speed up file copying. This can help to ensure the checksums match.

Procedure 18.3. To Perform an Offline Repository Backup:

• Run the following commands to stop the required services, perform the backup, and restart the services:

  # katello-service stop
  # tar --selinux -cvf pulp_data.tar /var/lib/pulp /var/www/pub
  # katello-service start

  Copy to Clipboard Toggle word wrap

  Note

  While the katello-service is stopped, Red Hat Satellite and the yum clients will be unable to maintain a connection. Any repository actions performed on Red Hat Satellite will fail during this period.

Procedure 18.4. To Perform a Complete Offline Database Backup:

1. Ensure the Satellite Server is completely stopped:

   # katello-service stop

   Copy to Clipboard Toggle word wrap
2. Run the following commands to back up the PostgreSQL and MongoDB databases:

   # tar --selinux -czvf mongo_data.tar.gz /var/lib/mongodb
   # tar --selinux -czvf pgsql_data.tar.gz /var/lib/pgsql/data/
   

   Copy to Clipboard Toggle word wrap
3. Restart the required services:

   # katello-service start

   Copy to Clipboard Toggle word wrap

Procedure 18.5. To Perform an Online Backup of the PostgreSQL Database:

1. Determine the name of the Red Hat Satellite PostgreSQL database. The default name is foreman and is specified in the /usr/share/katello-installer/modules/foreman/manifests/database/postgresql.pp file. If you chose a different name for your database, it is stored as the value of db_database in the /etc/katello-installer/answers.katello-installer.yaml file.

   Note

   If you used the default database name, this variable has no value in the answers.katello-installer.yaml file.
   The Candlepin database name, candlepin, is not currently user configurable. It is specified in the /usr/share/katello-installer/modules/candlepin/manifests/init.pp file.
2. Run the following commands to create online database backups. It is not necessary to stop PostgreSQL or Red Hat Satellite, and this process does not block logged-in users. However, the process can take several minutes to finish depending on database sizes.

   # runuser - postgres -c "pg_dump -Fc foreman > /backup/foreman.dump"
   # runuser - postgres -c "pg_dump -Fc candlepin > /backup/candlepin.dump"

   Copy to Clipboard Toggle word wrap

Procedure 18.6. To Perform an Online Backup of the MongoDB Database:

• Run the following command in the /backup directory to create the /backup/mongo_dump/pulp_database directory, including JSON files.

  # mongodump --host localhost --out $BDIR/mongo_dump

  Copy to Clipboard Toggle word wrap