Modifying a Volume

Describes how to edit a volume using either the Control System or the CLI.

Modifying a Volume Using the Control System

About this task

To modify a volume:

Procedure

Log in to the Control System and go to the volume information page.
Click Edit Volume to display the Edit Volume page.

Modify one or more of the following general, auditing, and replication settings:

SETTINGS AND AUDITING	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	Whether volume is a read-only or read/write volume.
	Enable Auditing	Select one of the following: Disable auditing Enable auditing for volume so that auditing can be enabled by directories, files, tables, and streams in the volume Enable auditing of operations on all files, tables, streams in the volume whether or not auditing is enabled by files, tables, and streams in the volume.
	Coalesce Interval	Interval of time used when logging multiple instance of an operation on a node from a client IP, if auditing is enabled.
	Data on Wire Encryption	Whether (Yes) or not (No) to encrypt data in the volume during transmission. This is not supported on insecure clusters.
HOT (REPLICATION)	Topology	The location of the volume in the cluster rack topology.
	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.

SETTINGS AND AUDITING	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 the volume’s usage.
	Collect Metrics	Whether (Yes) or not (No) to enable metrics collection for the volume.
	Enable Auditing	Select one of the following: Disable auditing Enable auditing for volume so that auditing can be enabled by directories, files, tables, and streams in the volume Enable auditing of operations on all files, tables, streams in the volume whether or not auditing is enabled by files, tables, and streams in the volume.
	Coalesce Interval	The interval of time to use when logging multiple instance of an operation on a node from a client IP, if auditing is enabled.
	Data on Wire Encryption	Whether (Yes) or not (No) to encrypt data in the volume during transmission. This is not supported on insecure clusters.
REPLICATION (HOT)	Topology	The location of this volume in the cluster rack topology.
	Replication	Desired and minimum number of copies of the volume.
	Name Container Replication	Desired and minimum number of copies of the name container associated with the volume.

Set new (if Data Tier 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 Using the Control System for more information.
Erasure Coding	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.

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 Cold Tier Using the Control System for more information.
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 Using the Control System for more information.
Retention Duration after Recall	The number of days to retain data recalled from the tier to the MapR cluster. Once the number of days is reached, recalled data on the MapR 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.

Make changes as needed to volume access.

ADMINISTRATIVE CONTROLS

Users and groups that have permissions to perform administrative operations on this volume. To:

Modify access to existing users, select or deselect permissions.
Grant access to another user, click Add Another, enter the user name, and select permissions to grant to the user.

USER ACCESS CONTROLS

Specifies public or the users, groups, and/or roles that have and/or do not have access to read from and/or write to this volume.

To grant or block access to users, groups, and/or roles, from the:

Basic settings, select the type — public, (OR) user, group, or role — from the drop-down menu, specify the name of the user, group, or role, and select one or more checkbox to grant permissions.
TIP Click to create a copy of the associated access control setting. Click to remove the associated access control expression.
To add Access Control Expression (ACE)s for another user, group, or role, click Add Another and repeat this step.
Advanced settings, specify public (p) or user (u), group (g), and/or role (r) who have or do not have the type of access using the following boolean expressions and subexpressions:
- ! — Negation operator.
- & — AND operation.
- | — OR operation.
Use (), parentheses, for subexpressions.
NOTE You cannot specify user, group, or role individually if access is granted to all users (public).
Alternatively, click associated with the type of access to use the Access Control Expression window to define access for public or users, group, and/or role. See Defining ACEs for more information.

NOTE If you switch from Basic to Advanced, the basic settings, if any, are carried over to the advanced settings. If you switch from Advanced to Basic, all the settings are lost because the subexpressions and AND (&) and negation (!) operations that are supported by advanced settings are not supported in the basic settings.

(Optional) Modify volume quota as needed.

Volume Advisory Quota	Allocated disk space, which when exceeded raises an alarm but does not prevent writes.
Volume Hard Quota	Allocated disk space, which when exceeded prevents further writes.

(Optional) Add or modify schedule(s) as needed.

Snapshot Schedule	Schedule for creating snapshots of the volume.
Tier Offload Schedule	Schedule for offloading data to the storage tier. This is available only if volume is enabled for storage tiering.

Snapshot Schedule	Schedule for creating snapshots of this volume.
Mirror Schedule	Schedule for automatically synchronizing (mirroring) this volume with the source volume.
Tier Offload Schedule	Schedule for offloading data to the storage tier. This is available only if volume is enabled for storage tiering.

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:

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.