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 6f89859

Browse files
author
ekelly
committedOct 7, 2019
better ingest image, update rp search info
1 parent a305533 commit 6f89859

File tree

3 files changed

+11
-5
lines changed

3 files changed

+11
-5
lines changed
 

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

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -32,13 +32,16 @@ To define an Azure Blob container, enter this information.
3232

3333
![screenshot of the add storage target page, populated with information for a new Azure Blob storage target](media/hpc-cache-add-blob.png)
3434

35-
<!-- need to replace screenshot after note text is updated with both required RBAC roles -->
35+
<!-- need to replace screenshot after note text is updated with both required RBAC roles and also with correct search term -->
3636

3737
* **Storage target name** - Set a name that identifies this storage target in the Azure HPC Cache.
3838
* **Target type** - Choose **Blob**.
3939
* **Storage account** - Select the account with the container to reference.
4040

4141
You will need to authorize the cache instance to access the storage account as described in [Add the access roles](#add-the-access-control-roles-to-your-account).
42+
43+
For information about the kind of storage account you can use, read [Blob storage requirements](hpc-cache-prereqs.md#blob-storage-requirements).
44+
4245
* **Storage container** - Select the Blob container for this target.
4346

4447
* **Virtual namespace path** - Set the client-facing file path for this storage target. Read [Configure aggregated namespace](hpc-cache-namespace.md) to learn more about the virtual namespace feature.
@@ -49,7 +52,7 @@ When finished, click **OK** to add the storage target.
4952

5053
Azure HPC Cache uses [role-based access control (RBAC)](https://docs.microsoft.com/azure/role-based-access-control/index) to authorize the cache application to access your storage account for Azure Blob storage targets.
5154

52-
The storage account owner must explicitly add the roles [Storage Account Contributor](https://docs.microsoft.com/azure/role-based-access-control/built-in-roles#storage-account-contributor) and [Storage Blob Data Contributor](https://docs.microsoft.com/azure/role-based-access-control/built-in-roles#storage-blob-data-contributor) for the user "StorageCache Resource Provider".
55+
The storage account owner must explicitly add the roles [Storage Account Contributor](https://docs.microsoft.com/azure/role-based-access-control/built-in-roles#storage-account-contributor) and [Storage Blob Data Contributor](https://docs.microsoft.com/azure/role-based-access-control/built-in-roles#storage-blob-data-contributor) for the user "HPC Cache Resource Provider".
5356

5457
You can do this ahead of time, or by clicking a link on the page where you add a Blob storage target.
5558

@@ -63,7 +66,10 @@ Steps to add the RBAC roles:
6366

6467
1. In the **Assign access to** field, leave the default value selected ("Azure AD user, group, or service principal").
6568

66-
1. In the **Select** field, search for "storagecache". This string should match one security principal, named "HPC Cache Resource Provider". Click that principal to select it.
69+
1. In the **Select** field, search for "hpc". This string should match one service principal, named "HPC Cache Resource Provider". Click that principal to select it.
70+
71+
> [!NOTE]
72+
> If a search for "hpc" doesn't work, try using the string "storagecache" instead. Users who joined the preview early might need to use the older name for the service principal.
6773
6874
1. Click the **Save** button to add the role assignment to the storage account.
6975

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Keep these facts in mind:
2222

2323
A Python-based utility is available to load content into a Blob storage container. Read [Pre-load data in Blob storage](#pre-load-data-in-blob-storage-with-clfsload) to learn more.
2424

25-
If you don't want to use the loading utility, or if you want to add content to an existing storage target, follow the parallel data ingest tips in [Copy data through the Azure HPC Cache](#copy-data-through-the-azure-hpc-cache).
25+
If you don't want to use the loading utility, or if you want to add content to an existing storage target, follow the parallel data ingest tips in [Copy data through the Azure HPC Cache](#copy-data-through-the-azure-hpc-cache).
2626

2727
## Pre-load data in Blob storage with CLFSLoad
2828

@@ -53,7 +53,7 @@ The Avere CLFSLoad utility needs the following information:
5353

5454
If you don't want to use the Avere CLFSLoad utility, or if you want to add a large amount of data to an existing Blob storage target, you can copy it through the cache. Azure HPC Cache is designed to serve multiple clients simultaneously, so to copy data through the cache, you should use parallel writes from multiple clients.
5555

56-
![Diagram showing multi-client, multi-threaded data movement: At the top left, an icon for on-premises hardware storage has multiple arrows coming from it. The arrows point to four client machines. From each client machine three arrows point toward the Azure HPC Cache. From the Azure HPC Cache, multiple arrows point to Blob storage.](media/hpc-cache-parallel-ingest.png)
56+
![Diagram showing multi-client, multi-threaded data movement: At the top left, an icon for on-premises hardware storage has multiple arrows coming from it. The arrows point to four client machines. From each client machine three arrows point toward the Azure HPC Cache. From the Azure HPC Cache, multiple arrows point to Blob storage.](media/hpc-cache-parallel-ingest.png)
5757

5858
The ``cp`` or ``copy`` commands that you typically use to transfer data from one storage system to another are single-threaded processes that copy only one file at a time. This means that the file server is ingesting only one file at a time - which is a waste of the cache's resources.
5959

-1005 Bytes
Loading

0 commit comments

Comments
 (0)
Please sign in to comment.