Modifies an existing volume. Permissions required:
fc on the volume.
An error occurs if the name or path refers to a non-existent volume, or cannot be resolved.
maprcli volume modify [ -cluster <cluster name> ] -name <volume name> [ -advisoryquota <advisory quota> ] [ -ae <accounting entity> ] [ -aetype <aetype> ] [ -allowgrant true|false ] [ -auditenabled true|false ] [ -coalesce interval in mins ] [ -group <list of group:allowMask> ] [ -maxinodesalarmthreshold <threshold> ] [ -minreplication <minimum replication> ] [ -mirrorschedule mirror schedule ID ] [ -mirrorthrottle true|false ] [ -nsminreplication <minimum replication factor> ] [ -nsreplication <replication factor> ] [ -quota <quota> ] [ -readonly <readonly> ] [ -replication <replication> ] [ -rereplicationtimeoutsec <timeout in seconds> ] [ -schedule <schedule ID> ] [ -source <source volume> ] [ -type rw|mirror ] [ -user <list of user:allowMask> ]
The advisory quota for the volume as
The accounting entity that owns the volume.
The type of accounting entity:
|allowgrant||Specifies whether the volume as a parent grants permission for a child volume to inherit its properties. True or false. Default: false.|
Specifies whether to turn auditing on for the volume. If auditing is also enabled at the cluster level with the
You must have the
The cluster on which to run the command.
The interval of time during which READ, WRITE, or GETATTR operations on one file from one client IP address are logged only once, if auditing is enabled.
For example, suppose that a client application reads a single file three times in 6 minutes, so that there is one read at 0 minutes, another at 3 minutes, and a final read at 6 minutes. If the coalesce interval is at least 6 minutes, then only the first read operation is logged. However, if the interval is between 4 minutes, then only the first and third read operations are logged. If the interval is 2 minutes, all three read operations are logged.
The default value is 60 minutes. Setting this field to a larger number helps prevent audit logs from growing quickly.
Space-separated list of
The minimum replication level. Default: 0
|mirrorschedule||The schedule ID corresponding to the schedule to be used for mirroring. Pre-assigned IDs include 1 for critical data, 2 for important data, and 3 for normal data. Custom schedules are assigned ID numbers in sequence. To determine the ID number, use the |
|mirrorthrottle||Specifies whether mirror throttling is enabled (|
|nsminreplication||The minimum replication level for the namespace container. Default: 2 When the replication factor falls below this minimum, re-replication occurs as aggressively as possible to restore the replication level. If any containers in the CLDB volume fall below the minimum replication factor, writes are disabled until aggressive re-replication restores the minimum level of replication. When enabled, the CLDB manages the namespace container replication separate from the data container replication. This capability is used when you have low volume replication but want to have higher namespace replication. Note: This parameter must be the same or larger than the equivalent data replication parameter, |
The desired namespace container replication level. Default: 3. When the number of copies falls below the desired replication factor, but remains equal to or above the minimum replication factor, re-replication occurs after the timeout specified in the
|The name of the volume to modify.|
The quota for the volume as
Note that quotas for source and mirror volumes must match.
Specifies whether the volume is read-only.
The desired replication level. Default: 0
Timeout (in seconds) before attempting re-replication of replica containers. This volume property defines the timeout period until CLDB starts re-replicating the containers on the node of the volume when CLDB stops receiving a heartbeat from the node.
When a node is down, CLDB gives the node an hour to come back online before it takes any action for the containers on this node. This parameter can be set on volumes to reduce the default 1 hour to a shorter time period. This option is provided mainly for local volumes, repl=1 so that when an mfs is down, CLDB can give up quickly and decide that the container has no master. This forces the TT to give up on local containers and take appropriate recovery action of deleting the mapred volume and creating another one.
A schedule ID. If a schedule ID is provided, then the volume will automatically create snapshots (normal volume) or sync with its source volume (mirror volume) on the specified schedule.
(Mirror volumes only) The source volume from which a mirror volume receives updates, specified in the format
Space-separated list of
Threshold for the INODES_EXCEEDED alarm.
If type = mirror, the volume is converted from a rw volume to a mirror volume.
If type = rw, the volume is converted from a mirror volume to a rw volume.
Change the source volume of the mirror "test-mirror":
maprcli volume modify -name test-mirror -source volume-2@my-cluster
Create a volume with namespace container replicas
Modify a volume to allow inheritance by a child volume
Sub-volumes (children) can inherit properties from their parent volume. The
maprcli volume create and
volume modify commands provide parameters for setting the inheritance feature. In order for child volume to inherit from a parent volume, the parent volume must grant permission and the child volume must be created specifying the volume name of the parent. In the following example, the parent volume, parentVol, grants of inheritance to child volumes.