Merge branch 'main' of https://github.com/amymzhou/windows-docs-pr

windows/deployment/do/TOC.yml

@@ -64,5 +64,4 @@
 - name: Content endpoints for Delivery Optimization and Microsoft Connected Cache
   href: delivery-optimization-endpoints.md 
 
-
   

windows/deployment/do/delivery-optimization-test.md

@@ -0,0 +1,209 @@
+---
+title: Testing Delivery Optimization 
+description: Explanation of Delivery Optimization distributed cache and high-level design. Demonstrate how Delivery Optimization peer-to-peer works in different test scenarios.
+ms.date: 11/08/2022
+ms.prod: windows-client
+ms.technology: itpro-updates
+ms.topic: reference
+ms.localizationpriority: medium
+author: cmknox
+ms.author: carmenf
+ms.reviewer: mstewart
+manager: naengler
+---
+
+# Testing Delivery Optimization
+
+## Overview
+
+Delivery Optimization is a powerful and useful tool to help enterprises manage bandwidth usage for downloading Microsoft content. It's a solution designed to be used in large-scale environments with large numbers of devices, various content sizes, etc. Delivery Optimization is native to Win10+ and provides default configuration to get the most out of the typical customer environment. It's used to deliver many different types of content, so Microsoft customers enjoy the best possible download experience for their environment. There are three components to Delivery Optimization, 1) HTTP downloader, 2) Peer-to-peer (P2P) cloud technology, and 3) Microsoft Connected Cache. One of the most powerful advantages of using Delivery Optimization is the ability to fine-tune settings that empower users to dial in Microsoft content delivery to meet the needs of specific environments.
+
+## Monitoring The Results
+
+Since Delivery Optimization is on by default, you'll be able to monitor the value either through the Windows Settings for ‘Delivery Optimization’, using Delivery Optimization PowerShell [cmdlets.](waas-delivery-optimization-setup.md), and/or via the [Windows Update for Business Report.](../update/wufb-reports-workbook.md) experience in Azure.
+
+In the case where Delivery Optimization isn't working in your environment, it's important to investigate to get to the root of the problem. We recommend a test environment be created to easily evaluate typical devices to ensure Delivery Optimization is working properly. For starters, ‘Scenario 1: Basic Setup’ should be created to test the use of Delivery Optimization between two machines. This scenario is designed to eliminate any noise in the environment to ensure there's nothing preventing Delivery Optimization from working on the devices. Once you have a baseline, you can expand the test environment for more sophisticated tests.
+
+## Expectations and Goals
+
+The focus of the testing scenarios in this article is primarily centered on demonstrating the Delivery Optimization policies centered around the successful downloading of bytes using P2P. More specifically, the goal will be to show peer to peer is working as expected, using the following criteria:
+
+* Peers can find each other (for example on the same LAN / subnet / Group – matching your 'Download Mode' policy).
+* Files are downloading in the expected 'Download Mode' policy setting (validates connectivity to DO cloud, HTTP, and local configs).
+* At least some downloads happening via P2P (validates connectivity between peers).
+
+Several elements that influence overall peering, using Delivery Optimization. The most common, impactful environment factors should be considered.
+
+* **The number of files in the cache and** **the** **number of devices have a big effect on overall peering.** There's a set number of files available for peering at a time, from each client, so the peering device may not be serving a particular file.
+* **File size** **and** **internet connection** **reliability matter.** There's a Delivery Optimization setting to determine the minimum file size to use P2P. In addition, an internet connection must be open and reliable enough to let the Delivery Optimization client make cloud service API calls and download metadata files before starting a file download.
+* **Delivery Optimization Policies can play a role.** In general, it's important to familiarize yourself with the Delivery Optimization settings and defaults [Delivery Optimization reference - Windows Deployment | Microsoft Docs.](waas-delivery-optimization-reference.md).
+
+### Delivery Optimization is a Hybrid P2P Platform
+
+* Delivery Optimization’s hybrid approach to downloading from multiple sources (HTTP and peer) in parallel is especially critical for large-scale environments, constantly assessing the optimal source from which to deliver the content. In conjunction, the distribution of content cache, across participating devices, contributes to Delivery Optimization’s ability to find bandwidth savings as more peers become available.
+
+* At the point a download is initiated, the DO client starts downloading from the HTTP source and discovering peers simultaneously. With a smaller file, most of the bytes could be downloaded from an HTTP source before connecting to a peer, even though peers are available. With a larger file and quality LAN peers, it might reduce the HTTP request rate to near zero, but only after making those initial requests from HTTP.
+
+* In the next section, you'll see how the two testing scenarios produce differing results in the number of bytes coming from HTTP vs. peers, which shows Delivery Optimization continuously evaluating the optimal location from which to download the content.
+
+## Test Scenarios
+
+### Scenario 1: Basic Setup
+
+**Goal:**
+Demonstrate how Delivery Optimization peer-to-peer technology works using two machines in a controlled test environment
+
+**Expected Results:**
+Machine 1 will download zero bytes from peers and Machine 2 will download 50-99% from peers.
+
+#### Test Machine Setup
+
+|Setup Checklist| Value/Explanation
+|--------|-------------------------------|
+|Number of machines used| 2 |
+|Virtual Machines/physical devices| 2 |
+|Windows OS version | Windows 10 (21H2) and Windows 11 (21H2) |
+|RAM | 8 GB |
+|Disk size | 127 GB |
+|Network | Connected to same network, one that is representative of the corporate network. |
+|Pause Windows Updates | This controls the test environment so no other content is made available during the test, and potentially altering the outcome of the test. If there are problems and no peering happens, use 'Get-DeliveryOptimizationStatus' on the first machine to return a real-time list of the connected peers. |
+|Ensure all Store apps are up to date | This will help prevent any new, unexpected updates to download during testing. |
+|Delivery Optimization 'Download Mode' Policy | 2 (Group)(set on each machine) |
+|Delivery Optimization 'GroupID' Policy | Set the *same* 'GUID' on each test machine. A GUID is a required value, which can be generated using PowerShell, ‘[[guid]::NewGuid().](https://blogs.technet.microsoft.com/heyscriptingguy/2013/07/25/powertip-create-a-new-guid-by-using-powershell/)’. |
+|**Required on Windows 11 devices only** set Delivery Optimization 'Restrict Peer Selection' policy | 0-NAT (set on each machine). The default behavior in Windows 11 is set to '2-Local Peer Discovery'. For testing purposes, this needs to be scoped to the NAT. |
+
+#### Test Instructions
+
+The following set of instructions will be used for each machine:
+
+1. Open PowerShell console as 'Administrator'.
+   * Clear the DO cache: 'Delete-DeliveryOptimizationCache'.
+   * Run 'Get-DeliveryOptimizationStatus'.
+2. Open MS Store and search for 'Asphalt Legends 9'. Select *Get* to initiate the download of the content (content size: ~3.4 GB).
+
+**On machine #1**
+
+* Run 'Test Instructions'
+
+|Windows 10 | Windows 11
+|--------|-------------------------------|
+| :::image type="content" source="images/test-scenarios/win10/m1-basic-complete.png" alt-text="Windows 10 21H2 - Machine 1 - Basic Test." lightbox="images/test-scenarios/win10/m1-basic-complete.png"::: | :::image type="content" source="images/test-scenarios/win11/m1-basic-complete.png" alt-text="Windows 11 21H2 - Machine 1 - Basic Test." lightbox="images/test-scenarios/win11/m1-basic-complete.png"::: |
+| **Observations** | |
+| * No peers were found on the first machine downloading the content.<br>* 'TotalBytesDownloaded' is equal to the file size.<br>* Status is set to 'Caching' the content so future peers can use it.<br>* Download was happening in the foreground.<br>* DownloadMode is set to 'Group' and no peers were found.<br>* No distinct observations seen between Window 10 and Windows 11 devices. |
+
+*Wait 5 minutes*.
+
+**On machine #2**
+
+* Run 'Test Instructions'
+
+|Windows 10 | Windows 11 |
+|--------|--------------------------------|
+| :::image type="content" source="images/test-scenarios/win10/m2-basic-complete.png" alt-text="Windows 10 21H2 - Machine 2 - Basic Test." lightbox="images/test-scenarios/win10/m2-basic-complete.png"::: | :::image type="content" source="images/test-scenarios/win11/m2-basic-complete.png" alt-text="Windows 11 21H2 - Machine 2 - Basic Test." lightbox="images/test-scenarios/win11/m2-basic-complete.png":::|
+| **Observations** | **Observations**|
+| * A peer was found for the content and 87% of total bytes came from the peer. <br> * One peer was found for the piece of content, which is expected as there are only two devices in the peering group. <br> * Download mode was set to 'Group', but since group mode includes both LAN and Group devices, Delivery Optimization prioritizes LAN peers, if found. Therefore, 'BytesFromLanPeers' shows bytes where 'BytesFromGroupPeers' doesn't. <br> * 'DownloadDuration' is roughly the same between machines.|* A peer was found for the content and 90% of total bytes came from the peer. <br> * All other points are the same as Windows 10 results. |
+
+### Scenario 2: Advance Setup
+
+**Goal:**
+Demonstrate how Delivery Optimization peer-to-peer technology works in a non-controlled environment and expanding to three machines
+**Expected Results:**
+Machine 1 will download zero bytes from peers and Machine 2 will find peers and download 50-99% from peers. Machine 3 will find two peers and download 50-99% from peers.
+
+#### Test Machine Setup
+
+|Setup Checklist| Value/Explanation |
+|--------|-------------------------------|
+|Number of machines used| 3 |
+|Virtual Machines| 3 |
+|Windows OS version | Windows 10 (21H2) |
+|RAM | 8 GB |
+|Disk size | 127 GB |
+|Network | Connected to same network, one that is representative of the corporate network. |
+|Delivery Optimization 'Download Mode' Policy| 2 (Group)(set on each machine) |
+|Delivery Optimization 'Group ID' Policy| Set the *same* 'GUID' on each test machine. A GUID is required value, which can be generated using PowerShell, '[guid]::NewGuid().](https://blogs.technet.microsoft.com/heyscriptingguy/2013/07/25/powertip-create-a-new-guid-by-using-powershell/)'. |
+|Delivery Optimization 'Delay background download from http' Policy | 60 (set on each machine) |
+|Delivery Optimization 'Delay foreground download from http Policy |60 (set on each machine) |
+
+#### Testing Instructions
+
+The following set of instructions will be used for each machine:
+
+1. Clear the DO cache: ‘Delete-DeliveryOptimizationCache’.
+2. Open MS Store and search for 'Asphalt Legends 9'. Select *Get* to initiate the download of the content (content size: ~3.4 GB).
+3. Open PowerShell console as Administrator. Run 'Get-DeliveryOptimizationStatus'.
+
+**On machine #1:**
+
+* Run ‘Test Instructions’
+
+**Output: Windows 10 (21H2)**
+
+![Windows 10 21H2 - Machine 1 - Advanced Test.](images/test-scenarios/win10/m1-adv-complete.png)
+
+**Observations**
+
+* The first download in the group of devices shows all bytes coming from HTTP, 'BytesFromHttp'.
+* Download is in the ‘Foreground’ because the Store app is doing the download and in the foreground on the device because it is initiated by the user in the Store app.
+* No peers are found.
+
+*Wait 5 minutes*.
+
+**On machine #2:**
+
+* Run ‘Test Instructions’
+
+**Output** Windows 10 (21H2)
+
+![Windows 10 21H2 - Machine 2 - Advanced Test.](images/test-scenarios/win10/m2-adv-complete.png)
+
+**Observations**
+
+* 'PercentPeerCaching' is 99.8%
+* There are still 'BytesFromHttp' source being used
+* One peer was found
+* All peering was done from device on the LAN, as shown with 'BytesFromLanPeers'
+
+**On machine #3:**
+
+* Run ‘Test Instructions’
+
+**Output:** Windows 10 (21H2)
+
+![Windows 10 21H2 - Machine 3 - Advanced Test.](images/test-scenarios/win10/m3-adv-complete.png)
+
+**Observations**
+
+* 'PercentPeerCaching' is roughly the same as machine #2, at 99.7%.
+* Now, two peers are found.
+* Still downloading from HTTP source as seen with 'BytesFromHttp' value.
+
+## Peer sourcing observations for all machines in the test group
+
+The distributed nature of the Delivery Optimization technology is obvious when you rerun the ‘Get-DeliveryOptimizationStatus’ cmdlet on each of the test machines. For each, there's a new value populated for the ‘BytesToLanPeers’ field. This demonstrates that as more peers become available, the requests to download bytes are distributed across the peering group and act as the source for the peering content. Each peer plays a role in servicing the other.
+  
+**Output:** Machine 1
+
+'BytesToPeers' sourced from Machine 1 are '5704426044'. This represents the total number of bytes downloaded by the two peers in the group.
+
+![Windows 10 21H2 - Machine 1 - Advanced BytesToPeers Test.](images/test-scenarios/win10/m1-adv-bytes-to-peers.png)
+
+**Output:** Machine 2
+
+'BytesToPeers' sourced from Machine 2 are '1899143740'. When there are two peers in the group with bytes available, notice that the distribution of bytes comes from either Machine 1 or Machine 2.
+
+![Windows 10 21H2 - Machine 2 - Advanced BytesToPeers Test.](images/test-scenarios/win10/m2-adv-bytes-to-peers.png)
+
+**Output:** Machine 3
+
+'BytesToPeers' sourced from Machine 3 are '0'. This means that no other peers are downloading bytes from this peer, which is expected since it was the last machine in the group.
+
+![Windows 10 21H2 - Machine 3 - Advanced BytesToPeers Test.](images/test-scenarios/win10/m3-adv-bytes-to-peers.png)
+
+## Conclusion
+
+Using Delivery Optimization can help make a big impact in customer environments to optimize bandwidth. The peer-to-peer technology offers many configurations designed to be flexible for any organization. Delivery Optimization uses a distributed cache across different sources to ensure the most optimal download experience, while limiting the resources used on each device.
+
+The testing scenarios found in this document help to show a controlled test environment, helping to prevent updates from interrupting the peering results. The other, a more real-world case, demonstrates how content available across peers will be used as the source of the content.
+
+If there are issues found while testing, the Delivery Optimization PowerShell [cmdlets.](waas-delivery-optimization-setup.md) can be a helpful tool to help explain what is happening in the environment.

windows/deployment/do/index.yml

@@ -102,4 +102,6 @@ landingContent:
             url: delivery-optimization-proxy.md
           - text: Content endpoints for Delivery Optimization and Microsoft Connected Cache
             url: delivery-optimization-endpoints.md
+          - text: Testing Delivery Optimization
+            url: delivery-optimization-test.md
 

windows/deployment/do/mcc-isp-create-provision-deploy.md

@@ -96,7 +96,7 @@ There are five IDs that the device provisioning script takes as input in order t
 
 | ID | Description |
 |---|---|
-| Customer ID | The Azure subscription ID that the cache node is created in. |
+| Customer ID | A unique alphanumeric ID that the cache nodes are associated with. |
 | Cache node ID | The unique alphanumeric ID of the cache node being provisioned. |
 | Customer key | The unique alphanumeric ID that provides secure authentication of the cache node to Delivery Optimization services. |
 | Registration key | Single use device registration key used by Microsoft Delivery Optimization services. |
@@ -108,10 +108,15 @@ There are five IDs that the device provisioning script takes as input in order t
 1. Open a terminal window in the directory where you would like to deploy your cache node and run the following command to change the access permission to the Bash script: 
 
     ```bash
-    sudo chmod +x installmcc.sh
+    sudo chmod +x provisionmcc.sh
     ```
 
-1. Run the deployment script that is shown for your cache node in Azure portal by copying and pasting the script in your terminal. The script may take a few minutes to run. If there were no errors, you have set up your cache node successfully. To verify the server is set up correctly, follow the [verification steps](mcc-isp-verify-cache-node.md).
+1. Copy and paste the script command line shown in the Azure portal.
+
+1. Run the script in your server terminal for your cache node by . The script may take a few minutes to run. If there were no errors, you have set up your cache node successfully. To verify the server is set up correctly, follow the [verification steps](mcc-isp-verify-cache-node.md).
+
+    > [!NOTE]
+    > The same script can be used to provision multiple cache nodes, but the command line is unique per cache node. Additionally, if you need to reprovision your server or provision a new server or VM for the cache node, you must copy the command line from the Azure portal again as the "registrationkey" value is unique for each successful execution of the provisioning script.
 
 ### General configuration fields
 
@@ -124,9 +129,13 @@ There are five IDs that the device provisioning script takes as input in order t
 
 ### Storage fields
 
+> [!IMPORTANT]
+> All cache drives must have read/write permissions set or the cache node will not function.
+> For example, in a terminal you can run: `sudo chmod 777 /path/to/cachedrive`
+
 | Field Name | Expected Value| Description |
 |---|---|---|
-| **Cache drive** | File path string | Up to 9 drives can be configured for each cache node to configure cache storage. Enter the file path to each drive. For example: /dev/folder/ |
+| **Cache drive** | File path string | Up to 9 drives can be configured for each cache node to configure cache storage. Enter the file path to each drive. For example: `/dev/folder/` Each cache drive should have read/write permissions configured. |
 | **Cache drive size in gigabytes** | Integer in GB | Set the size of each drive configured for the cache node. |
 
 ### Client routing fields

windows/deployment/do/mcc-isp-verify-cache-node.md

@@ -73,7 +73,7 @@ For more information about how to build your custom charts and graphs, see [Azur
 
 To view the metrics associated with your cache nodes, navigate to the **Overview** > **Monitoring** tab within the Azure portal.
 
-:::image type="content" source="./images/mcc-isp-metrics.png" alt-text="Screenshot of the Azure portal displaying the metrics view in the Overview tab".:::
+:::image type="content" source="./images/mcc-isp-metrics.png" alt-text="Screenshot of the Azure portal displaying the metrics view in the Overview tab.":::
 
 You can choose to monitor the health and performance of all cache nodes or one at a time by using the dropdown menu. The **Egress bits per second** graph shows your inbound and outbound traffic of your cache nodes over time. You can change the time range (1 hour, 12 hours, 1 day, 7 days, 14 days, and 30 days) by selecting the time range of choice on the top bar.
 

windows/deployment/do/mcc-isp.md

@@ -110,7 +110,7 @@ To deploy MCC:
 
 1. [Provide Microsoft with your Azure subscription ID](#provide-microsoft-with-your-azure-subscription-id)
 2. [Create the MCC Resource in Azure](#create-the-mcc-resource-in-azure)
-3. [Create a Cache Node](#create-a-mcc-node-in-azure)
+3. [Create a Cache Node](#create-an-mcc-node-in-azure)
 4. [Configure Cache Node Routing](#edit-cache-node-information)
 5. [Install MCC on a physical server or VM](#install-mcc)
 6. [Verify properly functioning MCC server](#verify-properly-functioning-mcc-server)