Restore to new infrastructure

When necessary, you can use a backup file to restore your Continuous Delivery (CD) installation to new infrastructure.

Before you begin:
Ensure you are running a version of the module that matches the version of the backup being used for the migration and that the target has been updated in Hiera to reference the new target system.

To restore your Continuous Delivery (CD) installation to a new server:

  1. Install Continuous Delivery (CD) on the new system. From the root of your Continuous Delivery (CD) Bolt project run:
    Copy
    bolt plan run cd4peadm::install
  2. Copy the backup tarball you wish to restore to /var/lib/puppetlabs/cd4pe/backups on the new system.
  3. Restore the backup on the new system. From the root of your Continuous Delivery (CD) Bolt project run:
    Copy
    bolt plan run cd4peadm::restore backup=<backup tarball name>

    Wait for the restore to finish before moving to the next step.

  4. Update the installation with the database passwords. From the root of your Continuous Delivery (CD) Bolt project run:
    Copy
    bolt plan run cd4peadm::apply_configuration