Merge pull request #289200 from kgremban/m3-upgrade

Upgrade steps for M3

Author: JamesJBarnett

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

@@ -51,7 +51,7 @@ A cluster host:
 
 * Have an Azure Arc-enabled Kubernetes cluster with the custom location and workload identity features enabled. If you don't have one, follow the steps in [Prepare your Azure Arc-enabled Kubernetes cluster](./howto-prepare-cluster.md).
 
-  If you deployed Azure IoT Operations to your cluster previously, uninstall those resources before continuing. For more information, see [Update Azure IoT Operations](./howto-manage-update-uninstall.md#update).
+  If you deployed Azure IoT Operations to your cluster previously, uninstall those resources before continuing. For more information, see [Update Azure IoT Operations](./howto-manage-update-uninstall.md#upgrade).
 
 * Verify that your cluster host is configured correctly for deployment by using the [verify-host](/cli/azure/iot/ops#az-iot-ops-verify-host) command on the cluster host:
 

articles/iot-operations/deploy-iot-ops/howto-manage-update-uninstall.md

@@ -5,7 +5,7 @@ author: kgremban
 ms.author: kgremban
 ms.topic: how-to
 ms.custom: devx-track-azurecli
-ms.date: 09/23/2024
+ms.date: 10/24/2024
 
 #CustomerIntent: As an OT professional, I want to manage Azure IoT Operations instances.
 ---
@@ -34,6 +34,11 @@ After deployment, you can use the Azure CLI and Azure portal to view and manage
 
 ### List instances
 
+#### [Azure portal](#tab/portal)
+
+1. In the [Azure portal](https://portal.azure.com), search for and select **Azure IoT Operations**.
+1. Use the filters to view Azure IoT Operations instances based on subscription, resource group, and more.
+
 #### [Azure CLI](#tab/cli)
 
 Use the `az iot ops list` command to see all of the Azure IoT Operations instances in your subscription or resource group.
@@ -50,14 +55,21 @@ To filter the results by resource group, add the `--resource-group` parameter.
 az iot ops list --resource-group <RESOURCE_GROUP>
 ```
 
+---
+
+### View instance
+
 #### [Azure portal](#tab/portal)
 
-1. In the [Azure portal](https://portal.azure.com), search for and select **Azure IoT Operations**.
-1. Use the filters to view Azure IoT Operations instances based on subscription, resource group, and more.
+You can view your Azure IoT Operations instance in the Azure portal.
 
----
+1. In the [Azure portal](https://portal.azure.com), go to the resource group that contains your Azure IoT Operations instance, or search for and select **Azure IoT Operations**.
 
-### View instance
+1. Select the name of your Azure IoT Operations instance.
+
+1. On the **Overview** page of your instance, the **Arc extensions** table displays the resources that were deployed to your cluster.
+
+   :::image type="content" source="../get-started-end-to-end-sample/media/quickstart-deploy/view-instance.png" alt-text="Screenshot that shows the Azure IoT Operations instance on your Arc-enabled cluster." lightbox="../get-started-end-to-end-sample/media/quickstart-deploy/view-instance.png":::
 
 #### [Azure CLI](#tab/cli)
 
@@ -91,21 +103,17 @@ MyCluster
 
 You can run `az iot ops check` on your cluster to assess health and configurations of individual Azure IoT Operations components. By default, the command checks MQ but you can [specify the service](/cli/azure/iot/ops#az-iot-ops-check-examples) with `--ops-service` parameter.
 
-#### [Azure portal](#tab/portal)
+---
 
-You can view your Azure IoT Operations instance in the Azure portal.
+### Update instance tags and description
+
+#### [Azure portal](#tab/portal)
 
 1. In the [Azure portal](https://portal.azure.com), go to the resource group that contains your Azure IoT Operations instance, or search for and select **Azure IoT Operations**.
 
 1. Select the name of your Azure IoT Operations instance.
 
-1. On the **Overview** page of your instance, the **Arc extensions** table displays the resources that were deployed to your cluster.
-
-   :::image type="content" source="../get-started-end-to-end-sample/media/quickstart-deploy/view-instance.png" alt-text="Screenshot that shows the Azure IoT Operations instance on your Arc-enabled cluster." lightbox="../get-started-end-to-end-sample/media/quickstart-deploy/view-instance.png":::
-
----
-
-### Update instance tags and description
+1. On the **Overview** page of your instance, select **Add tags** or **edit** to modify tags on your instance.
 
 #### [Azure CLI](#tab/cli)
 
@@ -121,14 +129,6 @@ To delete all tags on an instance, set the tags parameter to a null value. For e
 az iot ops update --name <INSTANCE_NAME> --resource-group --tags ""
 ```
 
-#### [Azure portal](#tab/portal)
-
-1. In the [Azure portal](https://portal.azure.com), go to the resource group that contains your Azure IoT Operations instance, or search for and select **Azure IoT Operations**.
-
-1. Select the name of your Azure IoT Operations instance.
-
-1. On the **Overview** page of your instance, select **Add tags** or **edit** to modify tags on your instance.
-
 ---
 
 ## Uninstall
@@ -137,6 +137,18 @@ The Azure CLI and Azure portal offer different options for uninstalling Azure Io
 
 The Azure portal steps can delete an Azure IoT Operations instance, but can't affect the related resources in the deployment. If you want to delete the entire deployment, use the Azure CLI.
 
+### [Azure portal](#tab/portal)
+
+1. In the [Azure portal](https://portal.azure.com), go to the resource group that contains your Azure IoT Operations instance, or search for and select **Azure IoT Operations**.
+
+1. Select the name of your Azure IoT Operations instance.
+
+1. On the **Overview** page of your instance, select **Delete**.
+
+1. Review the list of resources that are and aren't deleted as part of this operation, then type the name of your instance and select **Delete** to confirm.
+
+   :::image type="content" source="./media/howto-deploy-iot-operations/delete-instance.png" alt-text="A screenshot that shows deleting an Azure IoT Operations instance in the Azure portal.":::
+
 ### [Azure CLI](#tab/cli)
 
 Use the [az iot ops delete](/cli/azure/iot/ops#az-iot-ops-delete) command to delete the entire Azure IoT Operations deployment from a cluster. The `delete` command evaluates the Azure IoT Operations related resources on the cluster and presents a tree view of the resources to be deleted. The cluster should be online when you run this command.
@@ -161,37 +173,37 @@ To delete the instance and also remove the Azure IoT Operations dependencies (th
 az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --include-deps
 ```
 
-### [Azure portal](#tab/portal)
+---
 
-1. In the [Azure portal](https://portal.azure.com), go to the resource group that contains your Azure IoT Operations instance, or search for and select **Azure IoT Operations**.
+## Upgrade
 
-1. Select the name of your Azure IoT Operations instance.
+In public preview, Azure IoT Operations supports upgrading instances from version 0.7.x to 0.8.x. 
 
-1. On the **Overview** page of your instance, select **Delete** your instance.
+When a generally available release is made available, you'll need to deploy a new Azure IoT Operations installation. You won't be able to upgrade from a preview installation.
 
-1. Review the list of resources that are and aren't deleted as part of this operation, then type the name of your instance and select **Delete** to confirm.
+### [Azure portal](#tab/portal)
 
-   :::image type="content" source="./media/howto-deploy-iot-operations/delete-instance.png" alt-text="A screenshot that shows deleting an Azure IoT Operations instance in the Azure portal.":::
+1. In the [Azure portal](https://portal.azure.com), go to the resource group that contains your Azure IoT Operations instance, or search for and select **Azure IoT Operations**.
 
----
+1. Select the name of your Azure IoT Operations instance.
 
-## Update
+1. On the **Overview** page of your instance, select **Upgrade**.
 
-Currently, there's no support for updating an existing Azure IoT Operations deployment. Instead, uninstall and redeploy a new version of Azure IoT Operations.
+1. The **Upgrade Azure IoT Operations** wizard prompts you to make sure you have the latest version for the Azure IoT Operations CLI extension. Copy and run the provided `az extension add` command.
 
-1. Use the [az iot ops delete](/cli/azure/iot/ops#az-iot-ops-delete) command to delete the Azure IoT Operations deployment on your cluster.
+1. Update to the latest version of Azure IoT Operations instance. Copy and run the provided `az iot ops upgrade` command.
 
-   ```azurecli
-   az iot ops delete --cluster <CLUSTER_NAME> --resource-group <RESOURCE_GROUP>
-   ```
+1. Once the upgrade command completes successfully, you can exit the wizard and refresh your instance page.
 
-1. Update the CLI extension to get the latest Azure IoT Operations version.
+### [Azure CLI](#tab/cli)
+
+Use the `az iot ops upgrade` command to upgrade an Azure IoT Operations deployment. This command:
 
-   ```azurecli
-   az extension update --name azure-iot-ops
-   ```
+* Upgrades Azure Arc extensions on your cluster.
+* Upgrades the Azure IoT Operations instance.
 
-1. Follow the steps in this article to deploy the newest version of Azure IoT Operations to your cluster.
+```azurecli
+az iot ops upgrade --resource-group <RESOURCE_GROUP> --name <INSTANCE_NAME>
+```
 
-   >[!TIP]
-   >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.
+---

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

@@ -42,8 +42,7 @@ There are two core elements in the Azure IoT Operations Preview architecture:
 
 Azure IoT Operations runs on Arc-enabled Kubernetes clusters on the edge. You can deploy Azure IoT Operations by using the Azure portal or the Azure CLI.
 
-> [!NOTE]
-> 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-manage-update-uninstall.md#update).
+During public preview, Azure IoT Operations supports upgrading instances from version 0.7.x to 0.8.x. For more information, see [Manage Azure IoT Operations](./deploy-iot-ops/howto-manage-update-uninstall.md#upgrade).
 
 ## Manage devices and assets