Skip to content

Latest commit

 

History

History
177 lines (104 loc) · 8.9 KB

hpc-cache-edit-storage.md

File metadata and controls

177 lines (104 loc) · 8.9 KB
title description author ms.service ms.topic ms.date ms.author
Update Azure HPC Cache storage targets
How to edit Azure HPC Cache storage targets
ronhogue
hpc-cache
how-to
01/19/2022
rohogue

Edit storage targets

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 View and manage storage targets to learn how to delete or suspend storage targets, make them write cached data to back-end storage, or refresh their DNS-supplied IP addresses.

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

  • For Blob storage targets, you can change the namespace path and access policy.

  • For NFS storage targets, you can change these values:

    • Namespace paths
    • Access policy
    • The storage export or export subdirectory associated with a namespace path
    • Usage model

  • For ADLS-NFS storage targets, you can change the namespace path, access policy, and the usage model.

You can't edit a storage target's name, type, or back-end storage system. If you need to change these properties, delete the storage target and create a replacement with the new value.

Change a blob storage target's namespace path or access policy

Namespace paths are the paths that clients use to mount this storage target. (To learn more, read Plan the aggregated namespace and Set up the aggregated namespace).

Use the Azure portal or the Azure CLI to change the namespace path or access policy.

Portal

Use the Namespace page for your Azure HPC Cache to update the namespace path or client access policy. The namespace page is described in more detail in the article Set up the aggregated namespace.

  1. Click the path that you want to change. Screenshot of the Namespace page with the cursor over an item in the Namespace path column (first column to the left). The name is formatted as a hyperlink and the cursor indicates that it can be clicked.

  2. Use the edit window to type in new virtual path or update the access policy.

    Screenshot of the namespace page after clicking on a Blob namespace path - the edit fields appear on a pane to the right.

After making changes, click OK to update the storage target, or click Cancel to discard changes.

Azure CLI

Set up Azure CLI for Azure HPC Cache.

To change a blob storage target's namespace with the Azure CLI, use the command az hpc-cache blob-storage-target update. Only the --virtual-namespace-path value can be changed.

az hpc-cache blob-storage-target update --cache-name cache-name --name target-name \
  --resource-group rg --virtual-namespace-path "/new-path"

Update an NFS storage target

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.

Details are below:

Change aggregated namespace values

You can use the Azure portal or the Azure CLI to change the client-facing namespace path, the storage export, and the export subdirectory (if used). If you need to change the access policy, use the Azure portal.

Read the guidelines in Add NFS namespace paths if you need a reminder about how to create multiple valid paths on one storage target.

Portal

Use the Namespace page for your Azure HPC Cache to update namespace values, including the client access policy. This page is described in more detail in the article Set up the aggregated namespace.

screenshot of the portal namespace page with the NFS update page open at the right

  1. Click the name of the path that you want to change.
  2. Use the edit window to type in new virtual path, export, or subdirectory values, or to select a different access policy.
  3. After making changes, click OK to update the storage target or Cancel to discard changes.

Azure CLI

Set up Azure CLI for Azure HPC Cache.

Use the --junction option in the az hpc-cache nfs-storage-target update command to change the namespace path, NFS export, or export subdirectory.

The --junction parameter uses these values:

  • namespace-path - The client-facing virtual file path
  • nfs-export - The storage system export to associate with the client-facing path
  • target-path (optional) - A subdirectory of the export, if needed

Example: --junction namespace-path="/nas-1" nfs-export="/datadisk1" target-path="/test"

You must supply all three values for each path in the --junction statement. Use the existing values for any values that you don't want to change.

The cache name, storage target name, and resource group also are required in all update commands.

Example command:

az hpc-cache nfs-storage-target update --cache-name mycache \
  --name st-name --resource-group doc-rg0619 \
  --junction namespace-path="/new-path" nfs-export="/my-export" target-path="my-subdirectory"

Change the usage model

The usage model influences how the cache retains data. Read Understand cache usage models to learn more.

Note

You can't change between Read heavy, infrequent writes and other usage models. Read Understand cache usage models for details.

To change the usage model for an NFS storage target, use one of these methods.

Portal

Open the Storage targets page in the Azure portal. Click the name of a storage target in the list to open its edit page.

screenshot of the edit page for an NFS storage target

Use the drop-down selector to choose a new usage model. Click OK to update the storage target, or click Cancel to discard changes.

Azure CLI

Set up Azure CLI for Azure HPC Cache.

Use the az hpc-cache nfs-storage-target update command.

The update command is nearly identical to the command that you use to add an NFS storage target. Refer to Create an NFS storage target for details and examples.

To change the usage model, update the --nfs3-usage-model option. Example: --nfs3-usage-model WRITE_WORKLOAD_15

The cache name, storage target name, and resource group values also are required.

If you want to verify the names of the usage models, use the command az hpc-cache usage-model list.

If the cache is stopped or not in a healthy state, the update will apply after the cache is healthy.

Update an ADLS-NFS storage target

Similar to NFS targets, you can change the namespace path and the usage model for ADLS-NFS storage targets.

Change an ADLS-NFS namespace path

Use the Namespace page for your Azure HPC Cache to update namespace values. This page is described in more detail in the article Set up the aggregated namespace.

screenshot of the portal namespace page with an ADS-NFS update page open at the right

  1. Click the name of the path that you want to change.
  2. Use the edit window to type in new virtual path, or update the access policy.
  3. After making changes, click OK to update the storage target or Cancel to discard changes.

Change ADLS-NFS usage models

The configuration for ADLS-NFS usage models is identical to the NFS usage model selection. Read the portal instructions in Change the usage model in the NFS section above. Additional tools for updating ADLS-NFS storage targets are in development.

Next steps