Skip to content

Commit 3040a5d

Browse files
committed
Updating uninstall instructions
1 parent 57f4617 commit 3040a5d

File tree

2 files changed

+25
-1
lines changed

2 files changed

+25
-1
lines changed

articles/azure-arc/container-storage/prepare-linux-edge-volumes.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ The article describes how to prepare Linux for Edge Volumes using AKS enabled by
2323
2424
### Uninstall previous instance of Azure Container Storage enabled by Azure Arc extension
2525

26-
If you previously installed a version of Azure Container Storage enabled by Azure Arc before version 2.1.0-preview, you must uninstall that previous instance in order to install the newer version. Versions after 2.1.0-preview will be upgradable and will not require this uninstall.
26+
If you previously installed a version of Azure Container Storage enabled by Azure Arc before version 2.1.0-preview, you must uninstall that previous instance in order to install the newer version. If you installed the 1.2.0-preview release or any release prior to that, please use instructions provided [here](release-notes.md#if-i-installed-a-the-120-preview-or-any-preview-prior-to-that-how-do-i-uninstall-the-extension). Versions after 2.1.0-preview will be upgradable and will not require this uninstall.
2727

2828
1. In order to delete the old version of the extension, the Kubernetes resources holding references to old version of the extension must be cleaned up. Any pending resources will hold the clean-up of the extension. There are at least two ways to clean up these resources, either using `kubectl delete <resource_type> <resource_name>` or by 'un-applying' the YAML files used to create the resources. The resources that need to be deleted are typically the 'pod(s)', the PVC referenced, and the subvolume CRD (if *Cloud Ingest Edge Volume* was configured). Alternatively, the 4 following YAML files can be be fed to 'kubectl delete -f' using the following commands in the specified order. These variables must be updated with your information:
2929

articles/azure-arc/container-storage/release-notes.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,30 @@ This article provides information about new features and known issues in Azure C
3232

3333
## FAQ
3434

35+
### Uninstall previous instance of Azure Container Storage enabled by Azure Arc extension
36+
37+
#### If I installed a the 1.2.0-preview or any preview prior to that, how do I uninstall the extension?
38+
39+
If you previously installed a version of Azure Container Storage enabled by Azure Arc before version 2.1.0-preview, you must uninstall that previous instance in order to install the newer version.
40+
41+
> [!NOTE] The extension name for Arc Container Stoarge enabled by Azure Arc was previously "Edge Storage Accelerator". If you still have this instance installed, the extension will be referred to as "microsoft.edgestorageaccelerator" in the Azure Portal.
42+
43+
1. Before you are able to delete the extension, you will need to delete your configPod(s), Persistent Volume Claim(s), and Persistent Volume(s) using the following commands in the following order. Replace `YOUR_POD_FILE_NAME_HERE`, `YOUR_PVC_FILE_NAME_HERE`, and `YOUR_PV_FILE_NAME_HERE` with your respective file names. If you have more than one of each type, add one line per instance:
44+
45+
```bash
46+
kubectl delete -f "YOUR_POD_FILE_NAME_HERE.yaml"
47+
kubectl delete -f "YOUR_PVC_FILE_NAME_HERE.yaml"
48+
kubectl delete -f "YOUR_PV_FILE_NAME_HERE.yaml"
49+
```
50+
51+
1. After you delete your configPod(s), PVC(s), and PV(s) from the previous step, you can uninstall the extension using the following command. Replace `YOUR_RESOURCE_GROUP_NAME_HERE`, `YOUR_CLUSTER_NAME_HERE`, and `YOUR_EXTENSION_NAME_HERE` with your respective information:
52+
53+
```azurecli
54+
az k8s-extension delete --resource-group YOUR_RESOURCE_GROUP_NAME_HERE --cluster-name YOUR_CLUSTER_NAME_HERE --cluster-type connectedClusters --name YOUR_EXTENSION_NAME_HERE
55+
```
56+
57+
1. If you installed the extension prior to the 1.1.0-preview release (released on 4/19/24) and have a preexisting `config.json` file, be aware that the `config.json` schema changed. Remove the old `config.json` file using `rm config.json`.
58+
3559
### Encryption
3660

3761
#### What types of encryption are used by Azure Container Storage enabled by Azure Arc?

0 commit comments

Comments
 (0)