Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit c0f7ba1

Browse files
committedJun 23, 2021
create done, edit and add in progress
1 parent d9c60ad commit c0f7ba1

File tree

4 files changed

+25
-21
lines changed

4 files changed

+25
-21
lines changed
 

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

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: How to define storage targets so that your Azure HPC Cache can use
44
author: ekpgh
55
ms.service: hpc-cache
66
ms.topic: how-to
7-
ms.date: 05/05/2021
7+
ms.date: 06/23/2021
88
ms.custom: subject-rbac-steps
99
ms.author: v-erkel
1010
---
@@ -33,11 +33,13 @@ Click the image below to watch a [video demonstration](https://azure.microsoft.c
3333

3434
## Size your cache correctly to support your storage targets
3535

36-
<!-- asc12 to do: add L series standard (they all get 20 even though you can't change the size) -->
37-
The number of supported storage targets depends on the cache size, which is set when you create the cache. The size is a combination of throughput capacity (in GB/s) and storage capacity (in TB).
36+
The number of supported storage targets depends on the cache size, which is set when you create the cache. The cache capacity is a combination of throughput capacity (in GB/s) and storage capacity (in TB).
3837

39-
* Up to 10 storage targets - If you choose the smallest or medium cache storage size for your selected throughput value, your cache can have up to 10 storage targets.
40-
* Up to 20 storage targets - Choose the highest available cache size for your selected throughput value if you want to use more than 10 storage targets. (If using Azure CLI, choose the highest valid cache size for your cache SKU.)
38+
* Up to 10 storage targets - If you choose a standard cache, and select the smallest or medium cache storage value for your selected throughput, your cache can have a maximum of 10 storage targets.
39+
* Up to 20 storage targets -
40+
41+
* All high-throughput caches (which have preconfigured cache storage sizes) can support up to 20 storage targets.
42+
* Standard caches can support up to 20 storage targets if you choose the highest available cache size for your selected throughput value. (If using Azure CLI, choose the highest valid cache size for your cache SKU.)
4143

4244
Read [Set cache capacity](hpc-cache-create.md#set-cache-capacity) to learn more about throughput and cache size settings.
4345

@@ -48,7 +50,9 @@ A new Blob storage target needs an empty Blob container or a container that is p
4850
The Azure portal **Add storage target** page includes the option to create a new Blob container just before you add it.
4951

5052
> [!NOTE]
51-
> For NFS-mounted blob storage, use the [ADLS-NFS storage target](#) type.
53+
>
54+
> * For NFS-mounted blob storage, use the [ADLS-NFS storage target](#add-a-new-adls-nfs-storage-target-preview) type.
55+
> * [High-throughput cache configurations](hpc-cache-create.md#choose-the-cache-type-for-your-needs) do not support standard Azure Blob storage targets. Use NFS-enabled blob storage (ADLS-NFS) instead.
5256
5357
### [Portal](#tab/azure-portal)
5458

‎articles/hpc-cache/hpc-cache-create.md

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: How to create an Azure HPC Cache instance
44
author: ekpgh
55
ms.service: hpc-cache
66
ms.topic: how-to
7-
ms.date: 06/21/2021
7+
ms.date: 06/23/2021
88
ms.author: v-erkel
99
ms.custom: devx-track-azurepowershell
1010
---
@@ -65,7 +65,7 @@ If you need help sizing your cache correctly, contact Microsoft Service and Supp
6565

6666
### Choose the cache type for your needs
6767

68-
When you choose your cache capacity, you might notice that some throughput values have fixed cache size values, and others let you select from multiple cache size options. This is because there are two different styles of cache infrastructure:
68+
When you choose your cache capacity, you might notice that some throughput values have fixed cache sizes, and others let you select from multiple cache size options. This is because there are two different styles of cache infrastructure:
6969

7070
* Standard caches - listed under **Read-write caching** in the throughput menu
7171

@@ -94,13 +94,8 @@ Learn more about these options:
9494
* [Maximum number of storage targets](hpc-cache-add-storage.md#size-your-cache-correctly-to-support-your-storage-targets)
9595
* [Read and write caching modes](cache-usage-models.md#basic-file-caching-concepts)
9696

97-
98-
Choose one of the available throughput values. Also choose the cache storage size if your throughput size allows that option.
99-
10097
## Enable Azure Key Vault encryption (optional)
10198

102-
The **Disk encryption keys** page appears between the **Cache** and **Tags** tabs.<!-- Read [Regional availability](hpc-cache-overview.md#region-availability) to learn more about region support. -->
103-
10499
If you want to manage the encryption keys used for your cache storage, supply your Azure Key Vault information on the **Disk encryption keys** page. The key vault must be in the same region and in the same subscription as the cache.
105100

106101
You can skip this section if you do not need customer-managed keys. Azure encrypts data with Microsoft-managed keys by default. Read [Azure storage encryption](../storage/common/storage-service-encryption.md) to learn more.
@@ -113,13 +108,16 @@ You can skip this section if you do not need customer-managed keys. Azure encryp
113108
114109
For a complete explanation of the customer-managed key encryption process, read [Use customer-managed encryption keys for Azure HPC Cache](customer-keys.md).
115110

116-
![screenshot of encryption keys page with "customer managed" selected and key vault fields showing](media/create-encryption.png)
111+
![Screenshot of encryption keys page with "Customer managed" selected and the "Customer key settings" and "Managed identities" configuration forms showing.](media/create-encryption.png)
117112

118113
Select **Customer managed** to choose customer-managed key encryption. The key vault specification fields appear. Select the Azure Key Vault to use, then select the key and version to use for this cache. The key must be a 2048-bit RSA key. You can create a new key vault, key, or key version from this page.
119114

120-
Select xxx
115+
Check the **Always use current key version** box if you want to use [automatic key rotation](../virtual-machines/disk-encryption.md#automatic-key-rotation-of-customer-managed-keys-preview).
121116

122-
[ xxx just explain this image: media/cmk-identities-asc12.png xxx ]
117+
If you need to use a specific managed identity for this cache, configure it in the **Managed identities** section. Read the [managed identities documentation](../active-directory/managed-identities-azure-resources/overview.md#managed-identity-types) for help.
118+
119+
> [!NOTE]
120+
> You cannot change the assigned identity after you create the cache.
123121
124122
After you create the cache, you must authorize it to use the key vault service. Read [Authorize Azure Key Vault encryption from the cache](customer-keys.md#3-authorize-azure-key-vault-encryption-from-the-cache) for details.
125123

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

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,9 @@ ms.author: v-erkel
1010

1111
# Edit storage targets
1212

13-
You can remove or modify storage targets with the Azure portal or by using the Azure CLI. You also can trigger actions on individual storage targets - like suspending service or writing cached data back to long-term storage - as described in Manage storage targets().
13+
You can modify, manage, or remove storage targets with the Azure portal or by using the Azure CLI.
14+
15+
The xxx
1416

1517
Depending on the type of storage, you can modify these storage target values:
1618

@@ -212,9 +214,9 @@ The configuration for ADLS-NFS usage models is identical to the NFS usage model
212214

213215
## Manage storage targets
214216

215-
You can xxx
217+
You can also perform management actions on individual storage targets. These actions supplement the cache-level management options discussed in [Manage your cache](hpc-cache-manage.md).
216218

217-
To learn more about cache-level management actions, read [Manage your cache](hpc-cache-manage.md).
219+
Sometimes an individual storage target can get into a bad state and need to be temporarily removed, or permanently deleted. You also can flush cached data for a specific target.
218220

219221
![Screenshot of the storage targets page in the Azure portal, with the cursor over the menu exposed by clicking on the three dots (...) symbol to the far right of the storage target's row in the list.](media/storage-target-manage-options.png)
220222

@@ -224,7 +226,7 @@ To learn more about cache-level management actions, read [Manage your cache](hpc
224226
* Resume
225227
* Delete
226228

227-
### Flush cached files to the storage target
229+
### Flush cached files to the storage target
228230

229231
### Suspend a storage target
230232

@@ -233,7 +235,7 @@ The suspend feature disables client access to a storage target, but doesn't perm
233235
### Force remove a storage target
234236
<!-- https://msazure.visualstudio.com/One/_workitems/edit/8267141 -->
235237

236-
238+
Delete
237239

238240

239241
## Next steps
59.6 KB
Loading

0 commit comments

Comments
 (0)
Please sign in to comment.