Deleting old data

About deleting old Calico data

You may need or wish to manually delete Calico data from your etcd datastore under the following conditions.

• etcd: You succeeded in migrating your data and upgrading to Calico . After running Calico for some time and experiencing no errors, you want to delete the old Calico data from the etcdv2 datastore.

• etcd: A data migration attempt failed partway through, leaving the etcdv3 datastore with some, but not all of your etcvd2 data.

Deleting Calico data from etcdv2 after a successful migration and upgrade

Prerequisite

This procedure requires etcdctl v3. The etcdctl tool is installed along with etcd. To install just etcdctl, download the etcd release binary, untar it, and extract the etcdctl binary.

Deleting Calico data from etcdv2

Note: You must pass the same options you configured calico-upgrade with to etcdctl to achieve a connection. We include just the --endpoint flag in the following commands. Depending on your etcd configuration, you may need to include additional parameters in these commands. Refer to the etcdctl documentation for etcdv2 datastores for more information about the flags and environment variables.

1. Issue the following command to retrieve a list of all of the Calico keys.

   etcdctl --endpoint=<etcdv2-hostname:port> ls /calico --recursive
   

2. Issue the following command to delete the Calico keys.

   etcdctl --endpoint=<etcdv2-hostname:port> rm /calico/ --recursive 
   

3. Issue the following command to confirm that the Calico keys were deleted.

   etcdctl --endpoint=<etcdv2-hostname:port> ls /calico --recursive
   

   It should return Error: 100: Key not found (/calico) [1186].

4. Congratulations! You’ve cleaned Calico’s etcdv2 datastore of Calico data.

Deleting Calico data from etcdv3 after a partial migration

Prerequisites

This procedure requires etcdctl v3. The etcdctl tool is installed along with etcd. To install just etcdctl, download the etcd release binary, untar it, and extract the etcdctl binary.

Deleting Calico data from etcdv3

Note: You must pass the same options you configured calico-upgrade with to etcdctl to achieve a connection. We include just the --endpoints flag in the following commands. Depending on your etcd configuration, you may need to include additional parameters in these commands or set environment variables. Refer to the etcdctl documentation for etcdv3 datastores for more information about the flags and environment variables.

1. Issue the following command to retrieve a list of all of the Calico keys.

   ETCDCTL_API=3 etcdctl --endpoints=<etcdv3-hostname:port> get /calico/ --prefix --keys-only
   

2. Issue the following command to delete the Calico keys.

   ETCDCTL_API=3 etcdctl --endpoints=<etcdv3-hostname:port> del /calico/ --prefix 
   

   It returns the number of keys it deleted.

3. Issue the following command to confirm that the Calico keys were deleted.

   ETCDCTL_API=3 etcdctl --endpoints=<etcdv3-hostname:port> get /calico/ --prefix --keys-only
   

   It should return nothing.

4. Congratulations! You’ve cleaned Calico’s etcdv3 datastore of Calico data.

Next steps

Return to Migrate your data to try again.