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
Procedure
- Log in to the Control System and go to the volume information page.
- Click Edit Volume to display the Edit Volume page.
Modifying General Properties
-
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
-
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. NOTEIf 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. -
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: - Browse to select an existing rule.
- Create to create a new rule for offloading data. See Creating a Storage Tier Policy for more information.
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: - Browse to select an existing rule.
- Create to create a new rule for offloading data. See Creating a Storage Tier Policy for more information.
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
- 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.
-
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:
-
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.
Note that enabling
setattr
automatically enableschown
,chgrp
, andchperm
. If you excludesetattr
, these operations are automatically disabled. If you do nothing withsetattr
(neither enable nor disable), you can enable or disablechown, chgrp,
andchperm
in any combination. - 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.
-
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.
Note that enabling
-
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. 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). -
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:
Modifying Volume Administration Control Settings
-
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.
- 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.
- Click Save Changes for the changes to take effect.
Modifying a Volume Using the CLI or REST API
About this task
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 -X POST 'https://<hostname>:8443/rest/volume/modify?name=<volume name>' --user <username>:<password>
volume modify
.