switched tab flow; prereq edits

Author: kgremban

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

@@ -24,19 +24,6 @@ Microsoft supports Azure Kubernetes Service (AKS) Edge Essentials for deployment
 
 If you want to deploy Azure IoT Operations to a multi-node solution, use K3s on Ubuntu.
 
-### [AKS Edge Essentials](#tab/aks-edge-essentials)
-
-To prepare an Azure Arc-enabled Kubernetes cluster, you need:
-
-* An Azure subscription. If you don't have an Azure subscription, [create one for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
-
-* Hardware that meets the system requirements:
-
-  * Ensure that your machine has a minimum of 16-GB available RAM, 8 available vCPUs, and 52-GB free disk space reserved for Azure IoT Operations.
-  * [Azure Arc-enabled Kubernetes system requirements](/azure/azure-arc/kubernetes/system-requirements).
-  * [AKS Edge Essentials requirements and support matrix](/azure/aks/hybrid/aks-edge-system-requirements).
-  * [AKS Edge Essentials networking guidance](/azure/aks/hybrid/aks-edge-concept-networking).
-
 ### [Ubuntu](#tab/ubuntu)
 
 To prepare an Azure Arc-enabled Kubernetes cluster, you need:
@@ -60,19 +47,24 @@ To prepare an Azure Arc-enabled Kubernetes cluster, you need:
 
 * If you're going to deploy Azure IoT Operations to a multi-node cluster with fault tolerance enabled, review the hardware and storage requirements in [Prepare Linux for Edge Volumes](/azure/azure-arc/container-storage/prepare-linux-edge-volumes).
 
----
+### [AKS Edge Essentials](#tab/aks-edge-essentials)
 
-## Create and Arc-enable a cluster
+To prepare an Azure Arc-enabled Kubernetes cluster, you need:
 
-This section provides steps to create clusters in validated environments on Linux and Windows.
+* An Azure subscription. If you don't have an Azure subscription, [create one for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
 
-### [AKS Edge Essentials](#tab/aks-edge-essentials)
+* Hardware that meets the system requirements:
 
-[Azure Kubernetes Service Edge Essentials](/azure/aks/hybrid/aks-edge-overview) is an on-premises Kubernetes implementation of Azure Kubernetes Service (AKS) that automates running containerized applications at scale. AKS Edge Essentials includes a Microsoft-supported Kubernetes platform that includes a lightweight Kubernetes distribution with a small footprint and simple installation experience that supports PC-class or "light" edge hardware.
+  * Ensure that your machine has a minimum of 16-GB available RAM, 8 available vCPUs, and 52-GB free disk space reserved for Azure IoT Operations.
+  * [Azure Arc-enabled Kubernetes system requirements](/azure/azure-arc/kubernetes/system-requirements).
+  * [AKS Edge Essentials requirements and support matrix](/azure/aks/hybrid/aks-edge-system-requirements).
+  * [AKS Edge Essentials networking guidance](/azure/aks/hybrid/aks-edge-concept-networking).
 
-The [AksEdgeQuickStartForAio.ps1](https://github.com/Azure/AKS-Edge/blob/main/tools/scripts/AksEdgeQuickStart/AksEdgeQuickStartForAio.ps1) script automates the process of creating and connecting a cluster, and is the recommended path for deploying Azure IoT Operations on AKS Edge Essentials.
+---
 
-For instructions on running the script, see [Configure an AKS Edge Essentials cluster for Azure IoT Operations](/azure/aks/hybrid/aks-edge-howto-deploy-azure-iot).
+## Create and Arc-enable a cluster
+
+This section provides steps to create clusters in validated environments on Linux and Windows.
 
 ### [Ubuntu](#tab/ubuntu)
 
@@ -208,6 +200,14 @@ Connect your cluster to Azure Arc so that it can be managed remotely.
    systemctl restart k3s
    ```
 
+### [AKS Edge Essentials](#tab/aks-edge-essentials)
+
+[Azure Kubernetes Service Edge Essentials](/azure/aks/hybrid/aks-edge-overview) is an on-premises Kubernetes implementation of Azure Kubernetes Service (AKS) that automates running containerized applications at scale. AKS Edge Essentials includes a Microsoft-supported Kubernetes platform that includes a lightweight Kubernetes distribution with a small footprint and simple installation experience that supports PC-class or "light" edge hardware.
+
+The [AksEdgeQuickStartForAio.ps1](https://github.com/Azure/AKS-Edge/blob/main/tools/scripts/AksEdgeQuickStart/AksEdgeQuickStartForAio.ps1) script automates the process of creating and connecting a cluster, and is the recommended path for deploying Azure IoT Operations on AKS Edge Essentials.
+
+For instructions on running the script, see [Configure an AKS Edge Essentials cluster for Azure IoT Operations](/azure/aks/hybrid/aks-edge-howto-deploy-azure-iot).
+
 ---
 
 ## Verify your cluster

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

@@ -16,7 +16,17 @@ ms.date: 10/23/2024
 
 ## Supported environments
 
-Microsoft supports Azure Kubernetes Service (AKS) Edge Essentials for deployments on Windows and K3s for deployments on Ubuntu. For a list of specific hardware and software combinations that are tested and validated, see [Validated environments](../overview-iot-operations.md#validated-environments).
+Microsoft supports Azure Kubernetes Service (AKS) Edge Essentials for deployments on Windows and K3s for deployments on Ubuntu. 
+
+* Minimum hardware requirements:
+  * 16-GB RAM
+  * 4 vCPUs
+
+* Recommended hardware, especially for multi-node K3s clusters that enable fault tolerance:
+  * 32-GB RAM
+  * 8 vCPUs
+
+[!INCLUDE [validated-environments](includes/validated-environments.md)]
 
 ## Choose your features
 

articles/iot-operations/includes/validated-environments.md

@@ -10,11 +10,11 @@ ms.custom:
   - ignite-2023
 ---
 
-Currently, Microsoft has validated Azure IoT Operations against the following fixed-set of infrastructures and environments:
+Currently, Microsoft validates Azure IoT Operations against the following fixed-set of infrastructures and environments:
 
 | Environment | Version |
 | ----------- | ------- |
 | AKS-EE on Windows 11 IoT Enterprise <br> on a Lenovo ThinkStation P3 Tiny machine (16 core, 32 GB RAM) with single-node cluster | AksEdge-K3s-1.29.6-1.8.202.0 |
 | K3S on Ubuntu 24.04 <br> on a Lenovo ThinkStation P3 Tiny machine (16 core, 32 GB RAM) with a 3-node cluster | K3s version 1.31.1 |
 
-Currently Azure IoT Operations doesn't support ARM64 architectures.
+Azure IoT Operations doesn't support ARM64 architectures.