HPC add storage target stateinformation

Author: ekpgh

articles/hpc-cache/configuration.md

@@ -76,7 +76,7 @@ Consider using a test cache to check and refine your DNS setup before you use it
 
 ### Refresh storage target DNS
 
-If your DNS server updates IP addresses, the associated NFS storage targets will become temporarily unavailable. Read how to update your custom DNS system IP addresses in [Manage storage targets](manage-storage-targets.md#update-ip-address-custom-dns-configurations-only).
+If your DNS server updates IP addresses, the associated NFS storage targets will become temporarily unavailable. Read how to update your custom DNS system IP addresses in [View and manage storage targets](manage-storage-targets.md#update-ip-address-custom-dns-configurations-only).
 
 ## View snapshots for blob storage targets
 

articles/hpc-cache/hpc-cache-add-storage.md

@@ -4,7 +4,7 @@ description: How to define storage targets so that your Azure HPC Cache can use
 author: ekpgh
 ms.service: hpc-cache
 ms.topic: how-to
-ms.date: 07/12/2021
+ms.date: 09/22/2021
 ms.custom: subject-rbac-steps
 ms.author: v-erkel
 ---
@@ -397,7 +397,7 @@ From the Azure portal, open your cache instance and click **Storage targets**, w
 
 Click on a storage target's name to open its details page.
 
-Read [Edit storage targets](hpc-cache-edit-storage.md) to learn more.
+Read [View and manage storage targets](manage-storage-targets.md) and [Edit storage targets](hpc-cache-edit-storage.md) to learn more.
 
 ### [Azure CLI](#tab/azure-cli)
 

articles/hpc-cache/hpc-cache-edit-storage.md

@@ -13,7 +13,7 @@ ms.author: v-erkel
 You can modify storage targets with the Azure portal or by using the Azure CLI. For example, you can change access policies, usage models, and namespace paths for an existing storage target.
 
 > [!TIP]
-> Read [Manage storage targets](manage-storage-targets.md) to learn how to delete or suspend storage targets, or make them write cached data to back-end storage.
+> Read [View and manage storage targets](manage-storage-targets.md) to learn how to delete or suspend storage targets, or make them write cached data to back-end storage.
 
 Depending on the type of storage, you can modify these storage target values:
 
@@ -68,7 +68,7 @@ To change a blob storage target's namespace with the Azure CLI, use the command
 
 For NFS storage targets, you can change or add virtual namespace paths, change the NFS export or subdirectory values that a namespace path points to, and change the usage model.
 
-Storage targets in caches with some types of custom DNS settings also have a control for refreshing their IP addresses. (This kind of configuration is rare.) Learn how to refresh the DNS settings in [Manage storage targets](manage-storage-targets.md#update-ip-address-custom-dns-configurations-only).
+Storage targets in caches with some types of custom DNS settings also have a control for refreshing their IP addresses. (This kind of configuration is rare.) Learn how to refresh the DNS settings in [View and manage storage targets](manage-storage-targets.md#update-ip-address-custom-dns-configurations-only).
 
 Details are below:
 
@@ -174,6 +174,6 @@ The configuration for ADLS-NFS usage models is identical to the NFS usage model
 
 ## Next steps
 
-* Read [Manage storage targets](manage-storage-targets.md) for information about stopping, deleting, and flushing individual storage targets.
+* Read [View and manage storage targets](manage-storage-targets.md) for information about stopping, deleting, and flushing individual storage targets.
 * Read [Add storage targets](hpc-cache-add-storage.md) to learn more about storage target options.
 * Read [Plan the aggregated namespace](hpc-cache-namespace.md) for more tips about using virtual paths.

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

@@ -30,7 +30,7 @@ The buttons at the top of the page can help you manage the cache:
 Read more about these options below.
 
 > [!TIP]
-> You can also manage individual storage targets - read [Manage storage targets](manage-storage-targets.md) for details.
+> You can also manage individual storage targets - read [View and manage storage targets](manage-storage-targets.md) for details.
 
 Click the image below to watch a [video](https://azure.microsoft.com/resources/videos/managing-hpc-cache/) that demonstrates cache management tasks.
 

articles/hpc-cache/index.yml

@@ -61,7 +61,7 @@ landingContent:
             url: hpc-cache-support-ticket.md
           - text: Edit a storage target
             url: hpc-cache-edit-storage.md
-          - text: Manage storage targets
+          - text: View and manage storage targets
             url: manage-storage-targets.md
           - text: Work around firewall settings to create Blob storage targets
             url: hpc-cache-blob-firewall-fix.md

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

@@ -1,14 +1,23 @@
 ---
 title: Manage Azure HPC Cache storage targets
-description: How to suspend, remove, force delete, and flush 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: ekpgh
 ms.service: hpc-cache
 ms.topic: how-to
-ms.date: 07/12/2021
+ms.date: 09/22/2021
 ms.author: v-erkel
 ---
 
-# Manage storage targets
+# 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.
+
+> [!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)
+
+## 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).
 
@@ -30,7 +39,7 @@ Some storage targets also have a **Refresh DNS** option on this menu, which upda
 
 Read the rest of this article for more detail about these options.
 
-## Write cached files to the storage target
+### Write cached files to the storage target
 
 The **Flush** option tells the cache to immediately copy any changed files stored in the cache to the back-end storage system. For example, if your client machines are updating a particular file repeatedly, it is held in the cache for quicker access and not written to the long-term storage system for a period ranging from several minutes to more than an hour.
 
@@ -42,15 +51,15 @@ You could use this option to make sure that the back-end storage is populated be
 
 This option mainly applies to usage models that include write caching. Read [Understand cache usage models](cache-usage-models.md) to learn more about read and write caching.
 
-## Suspend a storage target
+### Suspend a storage target
 
 The suspend feature disables client access to a storage target, but doesn't permanently remove the storage target from your cache. You can use this option if you need to disable a back-end storage system for maintenance, repair, or replacement.
 
-## Put a suspended storage target back in service
+### Put a suspended storage target back in service
 
 Use **Resume** to un-suspend a storage target.
 
-## Force remove a storage target
+### Force remove a storage target
 
 > [!NOTE]
 > This option can cause data loss for the affected storage target.
@@ -64,7 +73,7 @@ There also is no guarantee that the back-end storage system will be accessible a
 Usually, force remove is used only when a storage target has become unresponsive or otherwise is in a bad state. This option lets you remove the bad storage target instead of having to take more drastic action.
 <!-- https://msazure.visualstudio.com/One/_workitems/edit/8267141 -->
 
-## Delete a storage target
+### Delete a storage target
 
 You can use the Azure portal or the AZ CLI to delete a storage target.
 
@@ -74,11 +83,11 @@ Deleting a storage target removes the storage system's association with this Azu
 
 If there is a large amount of changed data stored in the cache, deleting a storage target can take several minutes to complete. Wait for the action to finish to be sure that the data is safely stored in your long-term storage system.
 
-### [Portal](#tab/azure-portal)
+#### [Portal](#tab/azure-portal)
 
 To remove a storage target, open the **Storage targets** page. Click the '...' next to the storage target and choose **Delete** from the menu.
 
-### [Azure CLI](#tab/azure-cli)
+#### [Azure CLI](#tab/azure-cli)
 
 [Set up Azure CLI for Azure HPC Cache](./az-cli-prerequisites.md).
 
@@ -97,18 +106,32 @@ $ az hpc-cache storage-target remove --resource-group cache-rg --cache-name doc-
 
 ---
 
-## Update IP address (custom DNS configurations only)
+### Update IP address (custom DNS configurations only)
 
 If your cache uses a non-default DNS configuration, it's possible for your NFS storage target's IP address to change because of back-end DNS changes. If your DNS server changes the back-end storage system's IP address, Azure HPC Cache can lose access to the storage system.
 
 Ideally, you should work with the manager of your cache's custom DNS system to plan for any updates, because these changes make storage unavailable.
 
 If you need to update a storage target's DNS-provided IP address, use the **Storage targets** page. Click the **...** symbol in the right column to open the context menu. Choose **Refresh DNS** to query the custom DNS server for a new IP address.
 
-![Screenshot of storage target list. For one storage target, the "..." menu in the far right column is open and two options appear: Delete, and Refresh DNS.](media/refresh-dns.png) <!-- update screenshot if possible -->
+![Screenshot of storage target list. For one storage target, the "..." menu in the far right column is open and these options appear: Flush, Suspend, Refresh DNS, Force remove, Resume (this option is disabled), and Delete.](media/refresh-dns.png)
 
 If successful, the update should take less than two minutes. You can only refresh one storage target at a time; wait for the previous operation to complete before trying another.
 
+### Understand storage target state
+
+The storage target list shows two types of status: **State** and **Provisioning state**.
+
+* **State** indicates the operational state of the storage target. This value updates regularly and helps you understand whether or not the storage target is available for client requests and which of the management options are available.
+* **Provisioning state** tells you whether the last action to add or edit the storage target was successful. This value is only updated if you edit the storage target.
+
+The **State** value affects which management options you can use. Here is a short explanation of the values and their effects.
+
+* **Ready** - The storage target is operating normally and available to clients. You can use any of the management options on this storage target (except for **Resume**, which only is valid for suspended storage targets).
+* **Busy** - The storage target is processing another operation. You can delete or force remove the storage target.
+* **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.
+
 ## Next steps
 
 * Learn about [cache-level management actions](hpc-cache-manage.md)

articles/hpc-cache/media/add-storage-target-button.png

@@ -43,7 +43,7 @@ items:
           href: hpc-cache-ingest-manual.md
     - name: Edit storage targets
       href: hpc-cache-edit-storage.md
-    - name: Manage storage targets
+    - name: View and manage storage targets
       href: manage-storage-targets.md
   - name: Connect to the cache
     href: hpc-cache-mount.md