Katello 3.1 Documentation


In the following sections, these assumptions are being made with respect to making the backup:

  • /tmp/backup will be used as the target for backups
  • All commands are executed as root

Option One: Offline repositories backup

By default, the whole Katello instance will be turned off completely for the entire backup.

# katello-backup /tmp/backup

Option Two: Online repositories backup

Backing up the repositories can take an extensive amount of time. You can perform a backup while online. In order for this procedure to succeed, you must not change or update the repositories database until the backup procedure is complete. Thus, you must avoid publishing, adding, or deleting content views, promoting content view versions, adding, changing, or deleting sync-plans, and adding, deleting, or syncing repositories during this time. To perform an online-backup of the repositories, run:

# katello-backup --online-backup /tmp/backup

Option Three: Skip repositories backup

There may be situations in which you want to see a system without its repository information. You can skip backing up the Pulp database with the following option:

# katello-backup --skip-pulp /tmp/backup

Please note you would not be able to restore a Katello instance from a directory where the Pulp database was skipped.

Final check-up

After a successful backup, the backup directory should have the following files:

# ls /tmp/backup

Additionally, if you ran the backup without skipping the Pulp database, you will see the additional file:


Katello instance should be up and running. Next chapter is dedicated to restoring a backup.


All the following commands are executed under root system account.

Please note only backups that include the Pulp database can be restored. To verify that your backup directory is usable, make sure it has the following files:

# ls /tmp/backup

Once verified, simply run:

# katello-restore /tmp/backup

This command will require verification in order to proceed, as the method will destruct all databases before restoring them. Once the procedure is finished, all processes will be online, and all databases and system configuration will be reverted to the state and the time of the backup.

Check log files for errors, such as /var/log/foreman/production.log and /var/log/messages.

Foreman 2.3.3 has been released! Follow the quick start to install it.

Foreman 2.2.2 has been released! Follow the quick start to install it.