Merge pull request #199762 from ekpgh/hpc-asc17

Update HPC Cache docs for new features

Author: 19BMG00

articles/hpc-cache/hpc-cache-manage.md

@@ -1,11 +1,11 @@
 ---
 title: Manage and update Azure HPC Cache
 description: How to manage and update Azure HPC Cache using the Azure portal or Azure CLI
-author: ronhogue
+author: ekpgh
 ms.service: hpc-cache
 ms.topic: how-to
-ms.date: 01/19/2022
-ms.author: rohogue
+ms.date: 06/02/2022
+ms.author: v-erinkelly
 ---
 
 # Manage your cache
@@ -147,27 +147,48 @@ If a new software version is available, the **Upgrade** button becomes active. Y
 
 Client access is not interrupted during a software upgrade, but cache performance slows. Plan to upgrade software during non-peak usage hours or in a planned maintenance period.
 
-The software update can take several hours. Caches configured with higher throughput take longer to upgrade than caches with smaller peak throughput values.
+The software update can take several hours. Caches configured with higher throughput take longer to upgrade than caches with smaller peak throughput values. The cache status changes to **Upgrading** until the operation completes.
 
-When a software upgrade is available, you will have a week or so to apply it manually. The end date is listed in the upgrade message. If you don't upgrade during that time, Azure automatically applies the update to your cache. The timing of the automatic upgrade is not configurable. If you are concerned about the cache performance impact, you should upgrade the software yourself before the time period expires.
+When a software upgrade is available, you will have a week or so to apply it manually. The end date is listed in the upgrade message. If you don't upgrade during that time, Azure automatically applies the new software to your cache.
+
+You can use the Azure portal to schedule a more convenient time for the upgrade. Follow the instructions in the **Portal** tab below.
 
 If your cache is stopped when the end date passes, the cache will automatically upgrade software the next time it is started. (The update might not start immediately, but it will start in the first hour.)
 
 ### [Portal](#tab/azure-portal)
 
-Click the **Upgrade** button to begin the software update. The cache status changes to **Upgrading** until the operation completes.
+Click the **Upgrade** button to configure your software update. You have the option to upgrade the software immediately, or to schedule the upgrade for a specific date and time.
+
+![Screenshot of the Schedule software upgrade blade showing radio buttons with "Schedule later" selected and fields to select a new date and time.](media/upgrade-schedule.png)
+
+To upgrade immediately, select **Upgrade now** and click the **Save** button.
+
+To schedule a different upgrade time, select **Schedule later** and select a new date and time.
+
+* The date and time are shown in the browser's local time zone.
+* You can't choose a later time than the deadline in the original message.
+
+When you save the custom date, the banner message will change to show the date you chose.
+
+If you want to revise your scheduled upgrade date, click the **Upgrade** button again. Click the **Reset date** link. This immediately removes your scheduled date.
+
+![Screenshot of the Schedule software upgrade blade with a custom date selected. A text link appears at the left of the date labeled "Reset date".](media/upgrade-reset-date.png)
+
+After you reset the previously scheduled value, the date selector resets to the latest available date and time. You can choose a new date and save it, or click **Discard** to keep the latest date.
+
+You can't change the schedule if there are fewer than 15 minutes remaining before the upgrade.
 
 ### [Azure CLI](#tab/azure-cli)
 
 [Set up Azure CLI for Azure HPC Cache](./az-cli-prerequisites.md).
 
 On the Azure CLI, new software information is included at the end of the cache status report. (Use [az hpc-cache show](/cli/azure/hpc-cache#az-hpc-cache-show) to check.) Look for the string "upgradeStatus" in the message.
 
-Use [az hpc-cache upgrade-firmware](/cli/azure/hpc-cache#az-hpc-cache-upgrade-firmware) to apply the update, if any exists.
+Use [az hpc-cache upgrade-firmware](/cli/azure/hpc-cache#az-hpc-cache-upgrade-firmware) to apply the software upgrade, if any exists.
 
 If no update is available, this operation has no effect.
 
-This example shows the cache status (no update is available) and the results of the upgrade-firmware command.
+This example shows the cache status (no upgrade is available) and the results of the upgrade-firmware command.
 
 ```azurecli
 $ az hpc-cache show --name doc-cache0629

articles/hpc-cache/manage-storage-targets.md

@@ -1,22 +1,26 @@
 ---
 title: Manage Azure HPC Cache storage targets
 description: How to suspend, remove, force delete, and flush Azure HPC Cache storage targets, and how to understand the storage target state
-author: ronhogue
+author: ekpgh
 ms.service: hpc-cache
 ms.topic: how-to
-ms.date: 01/26/2022
-ms.author: rohogue
+ms.date: 05/29/2022
+ms.author: v-erinkelly
 ---
 
 # View and manage storage targets
 
 The storage targets settings page shows information about each storage target for your HPC Cache, and gives options to manage individual storage targets.
 
+This page also has a utility for customizing the amount of cache space allocated to each individual storage target. Read [Allocate cache storage](#allocate-cache-storage) for details.
+
 > [!TIP]
 > Instructions for listing storage targets using Azure CLI are included in the [Add storage targets](hpc-cache-add-storage.md#view-storage-targets) article. Other actions listed here might not yet be available in Azure CLI.
 
 ![Screenshot of the Settings > Storage targets page in the Azure portal. There are multiple storage targets in the list, and column headings show Name, Type, State, Provisioning state, Address/Container, and Usage model for each one.](media/storage-targets-list-states.png)
 
+<!-- to do: update all storage target list screenshots -->
+
 ## Manage storage targets
 
 You can perform management actions on individual storage targets. These actions supplement the cache-level options discussed in [Manage your cache](hpc-cache-manage.md).
@@ -153,6 +157,24 @@ The **State** value affects which management options you can use. Here's a short
 * **Suspended** - The storage target has been taken offline. You can still flush, delete, or force remove this storage target. Choose **Resume** to put the target back in service.
 * **Flushing** - The storage target is writing data to the back-end storage. The target can't process client requests while flushing, but it will automatically go back to its previous state after it finishes writing data.
 
+## Allocate cache storage
+
+Optionally, you can configure the amount of cache storage that can be used by each storage target. This feature lets you plan ahead so that space is available to store a particular storage system's files.
+
+If you do not customize the storage allocation, each storage target receives an equal share of the available cache space.
+
+Click the **Allocate storage** button to customize the cache allocation.
+
+![Screenshot of the storage targets page in the Azure portal. The mouse pointer is over the 'Allocate storage' button.](media/allocate-storage-button.png)
+
+On the **Allocate storage** blade, enter the percentage of cache space you want to assign to each storage target. The storage allocations must total 100%.
+
+Remember that some cache space is used for overhead, so the total amount of space available for cached files is not exactly the same as the capacity you chose when you created your HPC Cache.
+
+![Screenshot of the 'Allocate storage' panel at the right side of the storage targets list. Text fields next to each storage target name allow you to enter a new percent value for each target. The screenshot has target 'blob01' set to 75% and target 'blob02' set to 50%. The total is calculated underneath as 125% and an error message explains that the total must be 100%. The Save button is inactive; the Discard button is active.](media/allocate-storage-blade.png)
+
+Click **Save** to complete the allocation.
+
 ## Next steps
 
 * Learn about [cache-level management actions](hpc-cache-manage.md)