volume
Manages volumes, snapshots and mirrors.
Fields
The following table lists the data fields that provide information about each volume. Each field has two names:
- Field name - displayed in the output of the
volume listcommand and used to specify the columns displayed using thecolumnsparameter - Short name - used to specify the columns displayed using
the
columnsparameter
The short name is also used when specifying rows with a filter, for example when specifying a set of volumes about which to get information.
| accesstime | va | A value that can be used to determine when this volume was accessed. |
| actualreplication | arf | The actual current replication factor by percentage of the volume, as a zero-based array of integers from 0 to 100. For each position in the array, the value is the percentage of the volume that is replicated index number of times. Example: arf=5,10,85 means that 5% is not replicated, 10% is replicated once, 85% is replicated twice. |
| advisoryquota | aqt | The advisory quota for the volume, in MB. A value of 0 indicates there
are no soft or advisory quotas for this volume. |
| AdvisoryQuotaExceededAlarm | aqa | Alarm raised if the volume size is more than the value configured for the advisory quota. |
| aename | aen | The accountable entity name. |
| aetype | aet | The type of accounting entity. Value can be:
|
| allowGrant | ag | Specifies whether a parent volume grants permission for a child volume
to inherit its properties. Value can be true or false. |
| AlmostFullTopologyAlarm | afta | Timestamp when Topology Almost Full alarm was raised. |
| audited | ea | A value of 1 indicates that auditing is enabled for the volume. See Enabling Auditing for the steps to enable auditing on a volume and on directories, files, and tables in that volume. |
| auditVolume | av | Indicates whether (1) or not volume accommodates audit logs. |
| CannotMirrorAlarm | cma | Timestamp when "Cannot Mirror" alarm was raised. |
| coalesceInterval | ci | The interval of time in minutes during which only the first instance of
an operation on a node is recorded in audit logs, if auditing is enabled.
Subsequent identical operations performed on the same node are ignored
during the interval. Setting this field to a larger number helps prevent
audit logs from growing quickly.
NOTE: The default value is 60 minutes.
|
| ContainersNonLocalAlarm | cnla | Timestamp when the Local Volume containers non-local alarm was raised. |
| creator | on | Name of the user that created the volume. |
| creatorcontainerid | ccid | ID for the container. |
| creatorvolumeuuid | cvid | ID that supports the container chain identification for mirroring. The creatorcontainerid and creatorvolumeuuid fields combined form a unique identifier for the container chain. |
| DataUnavailableAlarm | dua | Timestamp when Data Unavailable alarm was raised. |
| DataUnderReplicatedAlarm | rfa | Timestamp when Data Under-Replicatedalarm was raised. |
| dbrepllagsecalarmthresh | dlsat | Defines the lag time in seconds for replication after which the Table Replication Lag High alarm is raised. |
| disableddataauditoperations | ddao | The list of operations excluded from auditing. |
| enableddataauditoperations | edao | The list of operations selected for auditing. |
| fixCreatorId | fcid | An internal flag for MapR volumes to fix the creator container ID. |
| FullTopologyAlarm | fta | Timestamp when Topology Full Alarm was raised. |
| InodesExceededAlarm | ia | Timestamp when Inodes Exceeded alarm was raised. |
| LargeRowWarning | lrwarning | Timestamp when Large Row alarm was raised. |
| lastSuccessfulMirrorTime | lmt | Last time when the mirror completed successfully. |
| limitspread | ls | An internal flag for MapR volumes to control the growth of volumes in terms of the number of containers. When this flag is set, CLDB tried to limit the number of new containers created depending on the present size of the volume. If the volume size (the data in the volume) is small, the CLDB tries to reuse space in existing containers thus avoiding the creation of new containers. |
| localpath | lp | Topology of the volume. |
| logicalUsed | dlu | Logical size of disk used by this volume in MB. |
| maxinodesalarmthreshold | miath | The threshold of inodes in use that will set off the VOLUME_ALARM_INODES_EXCEEDED alarm. |
| minreplicas | mrf | Minimum number of replicas before re-replication starts. |
| mirrorDataSrcCluster | mdc | Name of the cluster of the originator volume. |
| mirrorDataSrcVolume | mds | Name of the originator volume. This is used to identify the mirror family in cascaded mirroring. |
| mirrorDataSrcVolumeId | mdi | ID of the originator volume. |
| MirrorFailureAlarm | mfa | Timestamp when Mirror Failure alarm was raised. |
| mirrorId | mid | Current mirror ID of the volume. |
| mirror-percent-complete | mpc | Percentage complete for the most recent or current mirror operation. |
| mirrorscheduleid | msid | ID of the schedule that determines when the volume needs to be mirrored. |
| mirrorSrcCluster | msc | Name of the source cluster from which the current mirroring will happen. |
| mirrorSrcVolume | src | Name of the source volume from which the current mirrroring will happen. |
| mirrorSrcVolumeId | msi | ID of the source volume from which the current mirroring will happen. |
| mirrorstatus | mst | Status of the last mirror attempt. |
| mirrorthrottle | dt | Flag to determine if the
throttling need to be done on mirroring. Value can be:
|
| mirrortype | mrt | Determines the type of volume:
|
| mountdir | p | The path the volume is mounted on. |
| mounted | mt | A value of 1 indicates the volume is mounted |
| nameContainerSizeMB | ncsmb |
Size of the name container for this volume in MB. |
| nsMinReplicas | nsmr | Minimum replication level for the namespace container. |
| nsNumReplicas | nsnr | Replication level for the namespace container. |
| needsGfsck | nfsck | Indicates whether (true) or not
(false) this volume requires a filesystem check. |
| nextMirrorId | nmid | Mirror ID that will be assigned if the mirroring successfully completes the next time. |
| NoNodesInTopologyAlarm | nna | Timestamp when No Nodes in Topology alarm was raised. |
| numcontainers | nc | Number of containers that the volume has. |
| numreplicas | drf | Desired number of replicas. Containers with this amount of replicas are not re-replicated. |
| partlyOutOfTopology | poot | A value of 1 indicates this volume is partly out of its topology |
| quota | qta | Quota for limiting disk size in MB. A value of 0 indicates there are no hard quotas for this volume |
| QuotaExceededAlarm | qa | Timestamp when Volume Quota Alarm was raised. |
| rackpath | rp | The rack path for this volume. |
| readonly | ro | A value of 1 indicates the volume is read-only. |
| replicationtype | dcr | Replication type. Value can be low_latency (star replication) or high_throughput (chain replication). |
| ReplTypeConversionInProgress | rtip | Indicates whether (1) replication type conversion is currently happening. |
| reReplTimeOutSec | rto | 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. |
| scheduleid | sid | The ID of the schedule, if any, used by this volume. |
| schedulename | sn | The name of the schedule, if any, used by this volume. |
| snapshotcount | sc | The number of snapshots for this volume. |
| SnapshotFailureAlarm | sfa | Timestamp when Snapshot Failure alarm was raised. |
| snapshotused | ssu | Disk space used for all snapshots, in MB. |
| TableReplicationAsyncAlarm | vatrepa | Timestamp when Table Replication Asynchronous alarm was raised. |
| TableReplicationErrorAlarm | vatrepe | Timestamp when Table Replication Error alarm was raised. |
| TableReplicationLagHighAlarm | vatreplh | Timestamp when Table Replication Lag High alarm was raised. |
| totalused | tsu | Total space used for volume and snapshots, in MB. |
| used | dsu | Disk space used, in MB, not including snapshots. |
| volumeid | id | The volume ID. |
| volumename | n | The name of the volume. |
| volumetype | t | The volume type (for backward-compatibility):
|