Merge branch 'esa-pp' into esa-pp

Author: sethmanheim

articles/azure-arc/edge-storage-accelerator/attach-app.md

@@ -1,14 +1,14 @@
 ---
-title: Attach your application using the Azure IoT Operations data processor or Kubernetes native application
-description: Learn how to attach your app using the Azure IoT Operations data processor or Kubernetes native application.
+title: Attach your application using the Azure IoT Operations data processor or Kubernetes native application (preview)
+description: Learn how to attach your app using the Azure IoT Operations data processor or Kubernetes native application in Edge Storage Accelerator.
 author: sethmanheim
 ms.author: sethm
 ms.topic: how-to
-ms.date: 03/12/2024
+ms.date: 04/08/2024
 zone_pivot_groups: attach-app
 ---
 
-# Attach your application
+# Attach your application (preview)
 
 This article assumes you created a Persistent Volume (PV) and a Persistent Volume Claim (PVC). For information about creating a PV, see [Create a persistent volume](create-pv.md). For information about creating a PVC, see [Create a Persistent Volume Claim](create-pvc.md).
 
@@ -107,7 +107,7 @@ These pods are part of a **statefulSet**. You can't edit the statefulSet in plac
      name: example-static
      labels:
        app: example-static
-     ### Uncomment the next line and add your namespace only if you are not using the default namespace (if you are using azure-iot-operations) as specified from Line 6 of your pvc.yaml
+     ### Uncomment the next line and add your namespace only if you are not using the default namespace (if you are using azure-iot-operations) as specified from Line 6 of your pvc.yaml. If you are not using the default namespace, all future kubectl commands require "-n YOUR_NAMESPACE" to be added to the end of your command.
      # namespace: YOUR_NAMESPACE
    spec:
      replicas: 1
@@ -138,6 +138,9 @@ These pods are part of a **statefulSet**. You can't edit the statefulSet in plac
                claimName: YOUR_CLAIM_NAME_FROM_YOUR_PVC
    ```
 
+   > [!NOTE]
+   > If you are using your own namespace, all future `kubectl` commands require `-n YOUR_NAMESPACE` to be appended to the command. For example, you must use `kubectl get pods -n YOUR_NAMESPACE` instead of the standard `kubectl get pods`.
+
 1. To apply this .yaml file, run the following command:
 
     ```bash

articles/azure-arc/edge-storage-accelerator/azure-monitor-kubernetes.md

@@ -1,14 +1,14 @@
 ---
-title: Azure Monitor and Kubernetes monitoring
-description: Learn how to monitor your deployment using Azure Monitor and Kubernetes monitoring.
+title: Azure Monitor and Kubernetes monitoring (preview)
+description: Learn how to monitor your deployment using Azure Monitor and Kubernetes monitoring in Edge Storage Accelerator.
 author: sethmanheim
 ms.author: sethm
 ms.topic: how-to
-ms.date: 03/12/2024
+ms.date: 04/08/2024
 
 ---
 
-# Azure Monitor and Kubernetes monitoring
+# Azure Monitor and Kubernetes monitoring (preview)
 
 This article describes how to monitor your deployment using Azure Monitor and Kubernetes monitoring.
 
@@ -40,6 +40,6 @@ If you want to access log data via Azure Monitor, you must enable [Azure Monitor
 
 Additionally, you can use [Azure Monitor Log Analytics](/azure/azure-monitor/logs/log-analytics-tutorial) to query collected log data.
 
-## Next Steps
+## Next steps
 
 [Edge Storage Accelerator overview](overview.md)

articles/azure-arc/edge-storage-accelerator/create-pv.md

@@ -1,14 +1,14 @@
 ---
-title: Create a persistent volume
-description: Learn about creating persistent volumes.
+title: Create a persistent volume (preview)
+description: Learn about creating persistent volumes in Edge Storage Accelerator.
 author: sethmanheim
 ms.author: sethm
 ms.topic: how-to
-ms.date: 03/12/2024
+ms.date: 04/08/2024
 
 ---
 
-# Create a persistent volume
+# Create a persistent volume (preview)
 
 This article describes how to create a persistent volume using storage key authentication.
 
@@ -24,7 +24,7 @@ This section describes the prerequisites for creating a persistent volume (PV).
 
 ## Storage key authentication configuration
 
-1. Create a file named **add-key.sh**. This file creates a secret named `{YOUR_STORAGE_ACCOUNT}-secret`. This secret name is used for the `secretName` value when you configure your Persistent Volume (PV). No edits or changes to the following contents are necessary:
+1. Create a file named **add-key.sh** with the following contents. No edits or changes are necessary:
 
    ```bash
    #!/usr/bin/env bash
@@ -43,7 +43,7 @@ This section describes the prerequisites for creating a persistent volume (PV).
    kubectl create secret generic -n "${NAMESPACE}" "${STORAGE_ACCOUNT}"-secret --from-literal=azurestorageaccountkey="${SECRET}" --from-literal=azurestorageaccountname="${STORAGE_ACCOUNT}"
    ```
 
-1. After you create the file, change the write permissions on the file and execute the shell script using:
+1. After you create the file, change the write permissions on the file and execute the shell script using the following commands. Running these commands creates a secret named `{YOUR_STORAGE_ACCOUNT}-secret`. This secret name is used for the `secretName` value when configuring your PV:
 
    ```bash
    chmod +x add-key.sh
@@ -54,7 +54,7 @@ This section describes the prerequisites for creating a persistent volume (PV).
 
 You must create a Persistent Volume (PV) for the Edge Storage Accelerator to create a local instance and bind to a remote BLOB storage account.  
 
-Note the name (`esa4` in this example), as you need to specify it in the `spec::volumeName` of the PVC that binds to it. Use your storage account and container that you created as part of the [prerequisites](#prerequisites).
+Note the `metadata: name:` (`esa4` in this example), as you must specify it in the `spec: volumeName` of the PVC that binds to it. Use your storage account and container that you created as part of the [prerequisites](#prerequisites).
 
 1. Create a file named **pv.yaml**:
 
@@ -77,7 +77,7 @@ Note the name (`esa4` in this example), as you need to specify it in the `spec::
        csi:
            driver: edgecache.csi.azure.com
            readOnly: false
-           ### Make sure this volumeid is unique in the cluster. You must specify it in the spec::volumeName of the PVC. ###
+           ### Make sure this volumeid is unique in the cluster. You must specify it in the spec:volumeName of the PVC. ###
            volumeHandle: YOUR_NAME_FROM_METADATA_NAME_IN_LINE_4_HERE
            volumeAttributes:
                protocol: edgecache

articles/azure-arc/edge-storage-accelerator/create-pvc.md

@@ -1,16 +1,16 @@
 ---
-title: Create a Persistent Volume Claim (PVC)
-description: Learn how to create a Persistent Volume Claim (PVC).
+title: Create a Persistent Volume Claim (PVC) (preview)
+description: Learn how to create a Persistent Volume Claim (PVC) in Edge Storage Accelerator.
 author: sethmanheim
 ms.author: sethm
 ms.topic: how-to
-ms.date: 03/12/2024
+ms.date: 04/08/2024
 
 ---
 
-# Create a Persistent Volume Claim (PVC)
+# Create a Persistent Volume Claim (PVC) (preview)
 
-The PVC is a persistent volume claim against the persistent volume that you can use to mount a Kubernetes pod. In this case, the `storageClassName` is `blob-edgecache` and the storage amount requested for local storage.  
+The PVC is a persistent volume claim against the persistent volume that you can use to mount a Kubernetes pod.
 
 This size does not affect the ceiling of blob storage used in the cloud to support this local cache. Note the name of this PVC, as you need it when you create your application pod.  
 

articles/azure-arc/edge-storage-accelerator/how-to-single-node-k3s.md

@@ -0,0 +1,52 @@
+---
+title: Install Edge Storage Accelerator (ESA) on a single-node K3s cluster using Ubuntu or AKS Edge Essentials (preview)
+description: Learn how to create a single-node K3s cluster for Edge Storage Accelerator and install Edge Storage Accelerator on your Ubuntu or Edge Essentials environment.
+author: sethmanheim
+ms.author: sethm
+ms.topic: how-to
+ms.date: 04/08/2024
+
+---
+
+# Install Edge Storage Accelerator on a single-node K3s cluster (preview)
+
+This article shows how to set up a single-node [K3s cluster](https://docs.k3s.io/) for Edge Storage Accelerator (ESA) using Ubuntu or [AKS Edge Essentials](/azure/aks/hybrid/aks-edge-overview), based on the instructions provided in the Edge Storage Accelerator documentation.
+
+## Prerequisites
+
+Before you begin, ensure you have the following prerequisites in place:
+
+- A machine capable of running K3s, meeting the minimum system requirements.
+- Basic understanding of Kubernetes concepts.
+
+Follow these steps to create a single-node K3s cluster using Ubuntu or Edge Essentials.
+
+## Step 1: Create and configure a K3s cluster on Ubuntu
+
+Follow the [Azure IoT Operations K3s installation instructions](/azure/iot-operations/get-started/quickstart-deploy?tabs=linux#connect-a-kubernetes-cluster-to-azure-arc) to install K3s on your machine.
+
+## Step 2: Prepare Linux using a single-node cluster
+
+See [Prepare Linux using a single-node cluster](single-node-cluster.md) to set up a single-node K3s cluster.
+
+## Step 3: Install Edge Storage Accelerator
+
+Follow the instructions in [Install Edge Storage Accelerator](install-edge-storage-accelerator.md) to install Edge Storage Accelerator on your single-node Ubuntu K3s cluster.
+
+## Step 4: Create Persistent Volume (PV)
+
+Create a Persistent Volume (PV) by following the steps in [Create a PV](create-pv.md).
+
+## Step 5: Create Persistent Volume Claim (PVC)
+
+To bind with the PV created in the previous step, create a Persistent Volume Claim (PVC). See [Create a PVC](create-pvc.md) for guidance.
+
+## Step 6: Attach application to Edge Storage Accelerator
+
+Follow the instructions in [Edge Storage Accelerator: Attach your app](attach-app.md) to attach your application.
+
+## Next steps
+
+- [K3s Documentation](https://k3s.io/)
+- [Azure IoT Operations K3s installation instructions](/azure/iot-operations/get-started/quickstart-deploy?tabs=linux#connect-a-kubernetes-cluster-to-azure-arc)
+- [Azure Arc documentation](/azure/azure-arc/)

articles/azure-arc/edge-storage-accelerator/index.yml

@@ -1,11 +1,11 @@
 ### YamlMime:Landing
 
-title: Edge Storage Accelerator documentation
-summary: Edge Storage Accelerator (ESA) is a 1P storage system designed for Arc-connected Kubernetes clusters.
+title: Edge Storage Accelerator documentation (preview)
+summary: Edge Storage Accelerator (ESA) is a first-party storage system designed for Arc-connected Kubernetes clusters.
 
 metadata:
-  title: Edge Storage Accelerator documentation
-  description: Edge Storage Accelerator (ESA) is a 1P storage system designed for Arc-connected Kubernetes clusters.
+  title: Edge Storage Accelerator documentation (preview)
+  description: Edge Storage Accelerator (ESA) is a first-party storage system designed for Arc-connected Kubernetes clusters.
   ms.topic: landing-page
   author: sethmanheim
   ms.author: sethm 
@@ -18,23 +18,21 @@ landingContent:
         links:
           - text: What is Edge Storage Accelerator?
             url: overview.md
-      - linkListType: concept
+      - linkListType: how-to-guide
         links:
-          - text: Install Edge Storage Accelerator
-            url: install-edge-storage-accelerator.md
+          - text: Install Edge Storage Accelerator (ESA) on a single-node K3s cluster using Ubuntu or AKS Edge Essentials
+            url: how-to-single-node-k3s.md
   - title: Get started
     linkLists:
       - linkListType: how-to-guide
         links:
           - text: Prepare Linux
             url: prepare-linux.md
+          - text: Install Edge Storage Accelerator
+            url: install-edge-storage-accelerator.md
+          - text: Create a persistent volume
+            url: create-pv.md
           - text: Create a persistent volume claim
             url: create-pvc.md
-  - title: Troubleshoot
-    linkLists:
-      - linkListType: how-to-guide
-        links:
-          - text: Installation troubleshooting
-            url: installation-troubleshooting.md
-          - text: Operational troubleshooting
-            url: operational-troubleshooting.md
+          - text: Attach your application
+            url: attach-app.md

articles/azure-arc/edge-storage-accelerator/install-edge-storage-accelerator.md

@@ -1,5 +1,5 @@
 ---
-title: Install Edge Storage Accelerator
+title: Install Edge Storage Accelerator (preview)
 description: Learn how to install Edge Storage Accelerator.
 author: sethmanheim
 ms.author: sethm
@@ -8,35 +8,35 @@ ms.date: 03/12/2024
 
 ---
 
-# Install Edge Storage Accelerator
+# Install Edge Storage Accelerator (preview)
 
 This article describes the steps to install Edge Storage Accelerator.
 
 ## Optional: increase cache disk size
 
 Currently, the cache disk size defaults to 8 GiB. If you're satisfied with the cache disk size, move to the next section, [Install the Edge Storage Accelerator Arc Extension](#install-edge-storage-accelerator-arc-extension).  
 
-If you use Edge Essentials, require a larger cache disk size, and already created a **config.json** file, append the key and value pair (`"hydra.cachedStorageSize": "20Gi"`) to your existing **config.json**. Don't erase the previous contents of **config.json**.
+If you use Edge Essentials, require a larger cache disk size, and already created a **config.json** file, append the key and value pair (`"cachedStorageSize": "20Gi"`) to your existing **config.json**. Don't erase the previous contents of **config.json**.
 
 If you require a larger cache disk size, create **config.json** with the following contents:
 
 ```json
 {
-  "hydra.cachedStorageSize": "20Gi"
+  "cachedStorageSize": "20Gi"
 }
 ```
 
 ## Install Edge Storage Accelerator Arc extension
 
 Install the Edge Storage Accelerator Arc extension using the following command:
 
+> [!NOTE]
+> If you created a **config.json** file from the previous steps in [Prepare Linux](prepare-linux.md), append `--config-file "config.json"` to the following `az k8s-extension create` command. Any values set at installation time persist throughout the installation lifetime (inclusive of manual and auto-upgrades).
+
 ```bash
 az k8s-extension create --resource-group "${YOUR-RESOURCE-GROUP}" --cluster-name "${YOUR-CLUSTER-NAME}" --cluster-type connectedClusters --name hydraext --extension-type microsoft.edgestorageaccelerator
 ```
 
-> [!NOTE]
-> If you created a `config.json` from previous steps in [Prepare Linux](prepare-linux.md), append `--config-file "config.json"` to the previous `az k8s-extension create` command.
-
 ## Next steps
 
-Once you complete these prerequisites, you can begin to [create a Persistent Volume (PV) with Storage Key Authentication or Workload Identity](create-pv.md).
+Once you complete these prerequisites, you can begin to [create a Persistent Volume (PV) with Storage Key Authentication](create-pv.md).

articles/azure-arc/edge-storage-accelerator/installation-troubleshooting.md

@@ -1,15 +1,15 @@
 ---
-title: Prepare Linux using a multi-node cluster
-description: Learn how to prepare Linux with a multi-node cluster using AKS enabled by Azure Arc, Edge Essentials, or Ubuntu.
+title: Prepare Linux using a multi-node cluster (preview)
+description: Learn how to prepare Linux with a multi-node cluster in Edge Storage Accelerator using AKS enabled by Azure Arc, Edge Essentials, or Ubuntu.
 author: sethmanheim
 ms.author: sethm
 ms.topic: how-to
-ms.date: 03/12/2024
+ms.date: 04/08/2024
 zone_pivot_groups: platform-select
 
 ---
 
-# Prepare Linux using a multi-node cluster
+# Prepare Linux using a multi-node cluster (preview)
 
 This article describes how to prepare Linux using a multi-node cluster, and assumes you [fulfilled the prerequisites](prepare-linux.md#prerequisites).
 
@@ -56,7 +56,7 @@ This section describes how to prepare Linux with AKS Edge Essentials if you run
 
    ```bash
    az k8s-extension create --resource-group "YOUR_RESOURCE_GROUP_NAME" --cluster-name "YOUR_CLUSTER_NAME" --cluster-type connectedClusters --extension-type Microsoft.openservicemesh --scope cluster --name osm
-   kubectl patch meshconfig osm-mesh-config -n "arc-osm-system" -p '{"spec":{"featureFlags":{"enableWASMStats": false }, "traffic":{"outboundPortEx
+   kubectl patch meshconfig osm-mesh-config -n "arc-osm-system" -p '{"spec":{"featureFlags":{"enableWASMStats": false }, "traffic":{"outboundPortExclusionList":[443,2379,2380], "inboundPortExclusionList":[443,2379,2380]}}}' --type=merge
    ```
 
 1. Create a file named **config.json** with the following contents: