OSDOCS-13021: Warn that extra files in /var/lib/etcd break restore

[smunaval]

Version(s):
main (in-development OpenShift 5.1). Still present in published 4.18-4.22 docs.

Issue:
https://issues.redhat.com/browse/OSDOCS-13021

Link to docs preview:
Affected module: modules/dr-restoring-cluster-state.adoc
Published 4.22 page:
https://docs.redhat.com/en/documentation/openshift_container_platform/4.22/html/backup_and_restore/control-plane-backup-and-restore

QE review:

• QE has approved this change.

Additional information:
Extra files in /var/lib/etcd on the recovery host can cause cluster-restore.sh to fail. The restore procedure now warns operators to keep only the expected etcd data (typically the member directory) before running the script.

Verified still present in OpenShift 4.22:

• Published 4.22 control-plane backup and restore docs do not warn about extra files in /var/lib/etcd.

[openshift-ci-robot]

@smunaval: This pull request references OSDOCS-13021 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the bug to target the "5.1.0" version, but no target version was set.

Details

In response to this:

Version(s):
main (in-development OpenShift 5.1). Still present in published 4.18-4.22 docs.

Issue:
https://issues.redhat.com/browse/OSDOCS-13021

Link to docs preview:
Preview is generated after an org member comments /ok-to-test.
Affected module: modules/dr-restoring-cluster-state.adoc
Published 4.22 page:
https://docs.redhat.com/en/documentation/openshift_container_platform/4.22/html/backup_and_restore/control-plane-backup-and-restore

QE review:

• QE has approved this change.

Additional information:
Extra files in /var/lib/etcd on the recovery host can cause cluster-restore.sh to fail. The restore procedure now warns operators to keep only the expected etcd data (typically the member directory) before running the script.

Verified still present in OpenShift 4.22:

• Published 4.22 control-plane backup and restore docs do not warn about extra files in /var/lib/etcd.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

[openshift-ci]

Hi @smunaval. Thanks for your PR.

I'm waiting for a openshift member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work.

Regular contributors should join the org to skip this step.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.