Restoring a Kubernetes etcd Snapshot to a File System

Applies to: Only on-premises environments and self-managed cloud environments

You can restore the etcd snapshot and the etcd SSL certificates from the active etcd worker node to a Commvault access node. Access nodes run backups and other operations.

After the etcd snapshot and (optionally) the SSL certificates are restored, the Kubernetes infrastructure administrator can schedule the recovery or repair of etcd state on the cluster.

To avoid potentially affecting running applications and services on the Kubernetes cluster, Commvault supports restoring etcd to a Commvault access node rather than to the running cluster. etcd is a distributed key-value store, so recovery of etcd snapshots affects all control plane nodes in the cluster.

To restore etcd snapshot, follow these steps:

1. From the navigation pane, go to Protect > Kubernetes.

2. On the Application groups tab, for the etcd (system generated) application group, click the action button , and then select Restore.

3. Click Application files.

4. To select a specific backup copy to restore from, follow these steps:

   The Commvault software restores content from the first available, valid backup copy by default.

   1. Click Change source.

   2. From the Restore from copy list, select the backup copy.

   3. From the MediaAgent list, select the MediaAgent that contains the backup copy, and then click Save.

5. Click the etcd application.

   • For OpenShift clusters, the etcd snapshot is stored in the ocpclusterhost folder.

   • For Kubernetes clusters, the etcd-certs and etcd-data folders appear.

     Note

     • The etcd snapshot is stored in the etcd-data folder.

     • To restore only some of the etcd content, select a folder, or continue drilling down to the content that you want to restore.

6. Click Restore.

7. Select the destination client.

8. For Path, click Browse button, and then select an existing folder, or click the add button to create a new folder.

9. To delete and overwrite existing data, enable the Unconditionally overwrite if it already exists toggle, and then click Yes.

   Caution

   If matching data exists in the destination, the Commvault software deletes the existing data before starting the restore operation starts.

10. Click Submit.

    After the restore completes, use the etcd snapshot to recover the cluster state. For more information on recovering a cluster, see Recover a Kubernetes environment after a disaster.