Modifying a Volume

Describes how to edit volume properties using the Control System, CLI and the REST API.

Modifying a Volume Using the Control System

  1. Log in to the Control System and go to the volume information page.
  2. Click Edit Volume to display the Edit Volume page.
Modifying General Properties
  1. Make changes, as needed, to the following general properties:
    Accountable Entity The entity accountable for the volume’s usage.
    Collect Metrics Whether (Yes) or not (No) to enable metrics collection for the volume.
    Volume Access Indicates whether volume is a read-only or read/write volume.
    Last Access Interval Denotes the frequency at which the access time of a file is updated. See Tuning Last Access Time for more information.
    Source Cluster Name The name of the cluster on which the source volume exists.
    Source Volume Name The name of the source volume to mirror.
    Accountable Entity The entity accountable for this volume’s usage.
    Collect Metrics Whether (Yes) or not (No) to enable metrics collection for the volume.
    Volume Access Indicates whether volume is a read-only (default) or read/write volume. To promote the mirror volume to a standard volume, you can switch to read/write volume; see Changing Mirror Volumes to Standard Volumes for more information.
    Last Access Interval Denotes the frequency at which the access time of a file is updated. See Tuning Last Access Time for more information.
Modifying Replication and Storage Settings
  1. Make changes, as needed, to the following replication settings:
    Topology The location of this volume in the cluster rack topology.
    Guarantee Min Replication (Available from v6.0.1) Specifies whether (true) or not (false) to enforce minimum number of copies for the (read-write) volume. If this is enabled (Yes), writes succeed only when the minimum number of copies exist.
    Note: If this parameter was not already set on a volume or if you modify the setting for this property from No to Yes, restart all the nodes where the containers associated with the volume exist for the changes to take effect.
    Replication Desired and minimum number of copies of the volumes.
    Name Container Replication Desired and minimum number of copies of the name container associated with the volumes.
  2. Set new (if Data Tiering was enabled (On) during volume creation) or modify existing DATA TIERING settings.
    For offloading data to a warm tier, set new or modify existing values for the following properties.
    Topology The topology of the erasure coded volume from the drop-down list only if it is already not set.
    Storage Policy The rule (or criteria) for automatically offloading data in this volume. You can click:
    Scheme The erasure coding scheme, which is the number of data chunks and number of parity chunks, only if it is already not set; you cannot modify existing scheme. See Erasure Coding Scheme for Data Protection and Recovery for more information.
    For offloading data to a low cost storage alternative on the cloud, set new or modify existing values for the following properties.
    Storage Policy The rule (or criteria) for offloading data in this volume. You can click:
    Remote Target The location to offload data to only if it is already not set; you cannot modify if it is already set. You can click:
    • Browse to select an existing tier.
    • Create to create a new tier. See Creating a Storage Tier for more information.
    Retention Duration after Recall The number of days to retain data recalled from the tier to the HPE Ezmeral Data Fabric cluster. Once the number of days is reached, recalled data on the HPE Ezmeral Data Fabric cluster is purged (if there are no changes) or offloaded (if there are changes).
    Tier Encryption The setting to enable (Yes) or disable (No) encryption of data on the tier only if it is already not set.
Modifying Security Settings
  1. Enter the name of the security policy in the SECURITY POLICIES field to search for the security policy to associate with the volume and click Add to tag the volume with the security policy.
  2. Make changes to the auditing settings by moving the slider to Yes (to enable) or No (to disable).
    If enabled (Yes), you can make the following changes also:
    1. Choose the Default radio button to enable auditing of a default list of operations or choose the Custom radio button to select a custom list of directory, file, table, and streams operations to audit.
    2. Specify a Coalesce Interval, which is the interval of time (in minutes) to use when logging multiple READ, WRITE, or GETATTR operations on one file from the same client IP address. The default value is 60 minutes.
  3. Make changes to the following encryption settings by moving the slider to Yes (to enable) or No (to disable):
    Data on Wire Encryption Encryption of data in the volume during transmission. By default, this is enabled (Yes) for all new volumes in secure cluster. This is not supported on insecure clusters.
    Data at Rest Encryption Encryption of data at rest. This should be enabled only if the feature is enabled at the cluster-level. By default, this is disabled (No). This is not supported on insecure clusters.
  4. Make changes, as needed, to the users, groups, and/or roles that have and/or do not have permissions to read and/or write by clicking one of the following in the Data Access Control section:
    • — to modify the users, groups, and/or roles.
    • — to create a copy of the permissions, which you can then modify.
    • — to remove a data access control setting.
    • Select or deselect Read and/or Write checkbox in the Permissions column — to grant or deny that type of access.
    • Add Data Access Control or Add Another — to display the Add Access Permissions window. To specify the users, groups, and/or roles that have and/or do not have permissions to read and/or write, do the following:
    1. Move the slider associated with Public to Yes to grant access to all or to No to specify a list of users, groups, and or roles and do one of the following:
    2. Click Add to select permissions for the specified users, groups, and/or roles.
    3. Select the Read and/or Write checkbox in the Permissions column to grant that type of access to all (Public) or the specified users, groups, and/or roles.
Modifying Volume Administration Control Settings
  1. Make changes to the users and/or groups that can perform the following administrative operations on this volume:
    Dump & Backup
    Transport large amount of data or copies of the volume on physical media to a remote cluster using backup files.
    Restore & Mirror
    Restore a volume from a dump file and create mirror volumes, which is a read-only copy of the source volume.
    Edit
    Edit volume properties, create and delete snapshots.
    Delete
    Delete the volume.
    Admin
    View and edit access control settings (but cannot perform volume operations).
    Full Control
    Perform all volume-related administrative operations except changing access control settings.
    To:
    • Modify access for existing users and/or groups, select or deselect permissions.
    • Grant access to other users and/or groups, click Add Another, enter the user/group name, and select permissions to grant to the user/group.
  2. Click Save Changes for the changes to take effect.

Modifying a Volume Using the CLI or REST API

The basic command to modify a volume is:

/opt/mapr/bin/maprcli volume modify -name <volume name>

Send a request of type POST. For example:

curl -k -X POST 'https://<hostname>:8443/rest/volume/modify?name=<volume name>' --user mapr:mapr
For the complete list of editable parameters, see volume modify.