Identifying Converted Snapshots

Converted snapshots and any snapshots that you created manually are not governed by any retention policy and must be deleted manually.

What Is a Converted Snapshot

If you change any settings in a backup policy other than the display name of the policy, snapshots that were created under that policy are detached and marked as converted. For example, if you update a backup policy to add a new schedule, change a schedule, or delete a schedule, all existing snapshots are detached and marked as converted on the ZFS Storage Appliance.

A converted snapshot has been converted from being managed by a backup policy to requiring manual management. Specifically, snapshots that are marked as converted will not be automatically deleted because they are no longer governed by any retention policy. When these snapshots are no longer needed, you must delete them manually.

How to Identify Converted Snapshots

The following procedure describes how to identify converted snapshots. In addition to converted snapshots, any snapshots that you created manually must be deleted manually.

  1. Log on to one of the management nodes.

    # ssh root@pcamn01

  2. Show storagectl content. 

    # helm history storagectl
REVISION UPDATED STATUS CHART APP VERSION DESCRIPTION
3 Mon Sep 23 14:01:17 2024 superseded storagectl-3.0.202-3.10.0.0.1.75.g94b57a2 3.0.202-3.10.0.0.1.75.g94b57a2 Upgrade complete
4 Tue Sep 24 09:39:19 2024 superseded storagectl-3.0.202-3.10.0.0.0.79.g1f63430 3.0.202-3.10.0.0.0.79.g1f63430 Upgrade complete
5 Wed Sep 25 03:20:06 2024 superseded storagectl-3.0.202-3.10.0.0.0.80.gbb09c40 3.0.202-3.10.0.0.0.80.gbb09c40 Upgrade complete
6 Thu Sep 26 09:33:19 2024 superseded storagectl-3.0.202-3.10.0.0.1.66.g435af30 3.0.202-3.10.0.0.1.66.g435af30 Upgrade complete
7 Tue Oct 1 19:37:24 2024 superseded storagectl-3.0.202-3.10.0.0.1.75.gf712a7e 3.0.202-3.10.0.0.1.75.gf712a7e Upgrade complete
8 Tue Oct 1 19:46:22 2024 superseded storagectl-3.0.202-3.10.0.0.1.75.gf712a7e 3.0.202-3.10.0.0.1.75.gf712a7e Upgrade complete
9 Tue Oct 1 19:51:08 2024 superseded storagectl-3.0.202-3.10.0.0.1.79.ged909dd 3.0.202-3.10.0.0.1.79.ged909dd Upgrade complete
10 Tue Oct 1 19:53:25 2024 superseded storagectl-3.0.202-3.10.0.0.1.75.gf712a7e 3.0.202-3.10.0.0.1.75.gf712a7e Upgrade complete
11 Tue Oct 1 20:00:18 2024 superseded storagectl-3.0.202-3.10.0.0.1.79.ged909dd 3.0.202-3.10.0.0.1.79.ged909dd Upgrade complete
12 Tue Oct 1 21:45:03 2024 deployed storagectl-3.0.202-3.11.0.0.1.1.g1e7dc83 3.0.202-3.11.0.0.1.1.g1e7dc83 Upgrade complete

  3. Extract the storagectl chart from /nfs/shared_storage/.

    In this example, use the chart from the latest revision (the last line) shown in Step 2.

    # tar -xvf /nfs/shared_storage/charts/storagectl-3.0.202-3.11.0.0.1.1.g1e7dc83.tgz -C /target_directory
# cd /target_directory

  4. Delete the file job.batch/storagectl-list-converted-snapshots if it exists. 

    # kubectl delete job.batch/storagectl-list-converted-snapshots

  5. Rename the job definition file to remove the underscore prefix.

    # cp storagectl/templates/_storagectl-list-converted-snapshots.yaml storagectl/templates/storagectl-list-converted-snapshots.yaml

  6. (Optional) Set input parameters such as volumeId or compartmentId (the volume or compartment for which you want to list converted snapshots) or output file name.

    If you do not set either a volume OCID or a compartment OCID, then the list will include all converted snapshots, which could be a large list.

    # kubectl edit configmap storagectl-list-converted-snapshots-config

  7. Deploy the Kubernetes job. 

    # helm template -s templates/storagectl-list-converted-snapshots.yaml storagectl/ | kubectl apply -f -

  8. Check the status of the job.

    # kubectl get all -A | grep storagectl

    When the Kubernetes job is finished, the corresponding pod/storagectl-list-converted-snapshots-* is complete and the output file contains the list of converted snapshots.

  9. View the list of converted snapshots in the output file.

    # cat /nfs/shared_storage/pca-platform/kubernetes/storagectl-data/converted_snapshots_data.json

    The snapshots in this list will not be deleted automatically.