Skip to content

Commit 0ef8f3a

Browse files
committed
Clarify AIO update steps
1 parent 6149c04 commit 0ef8f3a

File tree

2 files changed

+18
-4
lines changed

2 files changed

+18
-4
lines changed

articles/iot-operations/deploy-iot-ops/howto-deploy-iot-operations.md

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -131,11 +131,25 @@ To view your cluster on the Azure portal, use the following steps:
131131
> [!TIP]
132132
> You can run `az iot ops check` to assess health and configurations of deployed AIO workloads. By default, MQ including cloud connectors are assessed and you can [specifiy the service](/cli/azure/iot/ops#az-iot-ops-check-examples) with `--ops-service --svc`.
133133
134-
## Update a deployment
134+
## Update Azure IoT Operations
135135

136-
Currently, there's no support for updating an existing Azure IoT Operations deployment. Instead, start with a clean cluster for a new deployment.
136+
Currently, there's no support for updating an existing Azure IoT Operations deployment. Instead, use the following steps to uninstall and redeploy a new version of Azure IoT Operations.
137137

138-
If you want to delete the Azure IoT Operations deployment on your cluster so that you can redeploy to it, navigate to your cluster on the Azure portal. Select the extensions of the type **microsoft.iotoperations.x** and **microsoft.deviceregistry.assets**, then select **Uninstall**. Keep the secrets provider on your cluster, as that is a prerequisite for deployment and not included in a fresh deployment.
138+
1. Delete the Azure IoT Operations deployment on your cluster so that you can redeploy to it.
139+
140+
1. In the Azure portal, navigate to your cluster.
141+
1. Select all of the extensions of the type **microsoft.iotoperations.x** and **microsoft.deviceregistry.assets**, then select **Uninstall**. Keep the secrets provider on your cluster, as that's a prerequisite for deployment and not included in a fresh deployment.
142+
143+
1. Update the CLI extension to get the latest Azure IoT Operations version.
144+
145+
```azurecli
146+
az extension add --upgrade --name azure-iot-ops
147+
```
148+
149+
1. Follow the steps in this article to deploy Azure IoT Operations to your cluster again.
150+
151+
>[!TIP]
152+
>Add the `--ensure-latest` flag to the `az iot ops init` command to check that the latest Azure IoT Operations CLI version is installed and raise an error if an upgrade is available.
139153
140154
## Next steps
141155

articles/iot-operations/get-started/overview-iot-operations.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ Azure IoT Operations runs on Arc-enabled Kubernetes clusters on the edge. You ca
4444
[Azure IoT Orchestrator Preview](../deploy-custom/overview-orchestrator.md) manages the deployment and configuration of the Azure IoT Operations components that run on your Arc-enabled Kubernetes cluster.
4545

4646
> [!NOTE]
47-
> During public preview, there's no support for upgrading an existing Azure IoT Operations deployment to a newer version. Instead, remove Azure IoT Operations from your cluster and then deploy the latest version.
47+
> During public preview, there's no support for upgrading an existing Azure IoT Operations deployment to a newer version. Instead, remove Azure IoT Operations from your cluster and then deploy the latest version. For more information, see [Update Azure IoT Operations](../deploy-iot-ops/howto-deploy-iot-operations.md#update-azure-iot-operations).
4848
4949
## Manage devices and assets
5050

0 commit comments

Comments
 (0)