Document how to back up and restore Pulp 3

[pulpbot]

Author: @goosemania (ttereshc)

Redmine Issue: 6711, https://pulp.plan.io/issues/6711

---

Currently there are no docs about how to back up and restore a Pulp 3 installation.

• Create a page for backup and restore
• It should list all the components which needs to be backed up
• It should mention all the requirements and caveats (e.g. pulp version should be the same for backup+restore procedure, tasks in incomplete state needs to be cancelled, etc)

Details

This should be a conceptual guide. We do not want to document how to backup postgresql in great detail for example. There are so many ways to backup postgresql. Similarly for the filesystem, we can give a simple examples, but there are so many backup tools for files, e.g. cp -a rsync, or rdiff-backup, etc.

To backup

1. Stop all pulp services
2. Stop postgresql
3. Backup MEDIA_ROOT, e.g. /var/lib/pulp/
4. Backup Postgresql
5. If using S3 or Azure you'll need to archive that somehow.

Also mention that temporary files are not needed to be included in the backup

To restore

1. Stop all pulp services
2. Stop postgresql Restore MEDIA_ROOT (with correct file permissions)
3. Restore postgresql
4. restore S3 or Azure

[pulpbot]

From: @bmbouter (bmbouter) Date: 2020-06-02T18:53:13Z

---

Grooming on irc w/ @daviddavis and @dkliban

[pulpbot]

From: daviddavis (daviddavis) Date: 2020-08-18T13:54:10Z

---

Removing from sprint per our pulpcore meeting.

[pulpbot]

From: @melcorr (mcorr) Date: 2021-08-06T13:23:33Z

---

There's a request for this in our 2021 survey, so I am happy to find a ticket :)

[pulpbot]

From: @goosemania (ttereshc) Date: 2021-08-17T13:29:48Z

---

Take into account cache invalidation

[pulpbot]

From: @goosemania (ttereshc) Date: 2021-08-17T13:30:55Z

---

Backup and restore only with the new tasking system (3.14+)

[stale[bot]]

This issue has been marked 'stale' due to lack of recent activity. If there is no further activity, the issue will be closed in another 30 days. Thank you for your contribution!

[linqing2004]

Is this documented? where is it?

[ipanova]

@dkliban was your presentation at config maangemtn camp covering some of these points? do you think we could get this documented?