14.2. Backup and Restore for a Content Delivery Server

Follow these steps on each CDS to perform a backup. Since client instances connect directly to CDS instances to install and update packages, stopping services on a CDS can possibly cause an outage for clients.
To mitigate the outage, if you have more than one CDS installed in each CDS cluster, only backup a single CDS in each cluster at a time, and client instances will automatically fail over to other running CDS instances.

Note

The /var/lib/pulp-cds directory will likely be quite large depending on how many repositories have been deployed on the CDS. Refer to Section 2.1 of the Installation guide to estimate how large this directory may be, or use the "du" command from the command line to determine its size.

14.2.1. Backup Process

Procedure 14.3. Backup Content Delivery Server

  1. Stop the pulp-cds service:
    # service pulp-cds stop
    
  2. Verify each service has stopped:
    # service httpd status
    httpd is stopped
    
    # service goferd status
    goferd is not running
    
  3. On the CDS, the following files need to be backed up:

    Important

    It is important that the files included in the backup retain their current attributes.
    Use the following command to backup the files:
    cp -a source_files_path destination_files_path
    /etc/pulp/*
    /etc/pki/cds/*
    /var/log/pulp-cds/*
    /var/log/gofer/agent.log
    /var/log/httpd/*
    /var/lib/pulp-cds/*
    /etc/httpd/conf.d/ssl.conf
    

    Note

    In addition to the above files, you may wish to backup any generated client entitlement certificates and client configuration RPMs.
  4. Restart the pulp-server service:
    # service pulp-cds start
    

14.2.2. Restore Process

Prepare a new CDS instance by following all steps from Procedure 2.3 in the Red Hat Update Infrastructure Installation Guide. Once those steps are completed, proceed with the following restoration steps:

Procedure 14.4. Restore Content Delivery Server

  1. Stop the pulp-cds service:
    # service pulp-cds stop
    
  2. Verify each service has stopped:
    # service httpd status
    httpd is stopped
    
    # service goferd status
    goferd is not running
    
  3. Restore all the files that were backed up to their original locations.

    Important

    It is important that the files included in the restore retain their current attributes.
    Use the following command to restore the files:
    cp -a source_files_path destination_files_path
  4. Restart the pulp-server service:
    # service pulp-cds start