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 list
command and used to specify the columns displayed using thecolumns
parameter - Short name - used to specify the columns displayed using
the
columns
parameter
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 | Indicates whether 1 or not (0 )
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.
|
containerAllocationFactor | caf | Indicates the number of containers created for the volume. |
ContainersNonLocalAlarm | cnla | Timestamp when the Local Volume containers non-local alarm was raised. |
creationTime | ct | The volume creation time (epoch time in seconds). This is only available
on volumes created using MapR v6.0.0 or later. For volumes created using
older MapR versions, the volume info
and volume list commands will return
empty value for this field. |
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. |
criticalReReplTimeOutSec | crto | The timeout (in seconds) before re-replicating critically under-replicated containers only. |
DataUnavailableAlarm | dua | Timestamp when Data Unavailable alarm was raised. |
DataUnderReplicatedAlarm | rfa | Timestamp when Data Under-Replicatedalarm was raised. |
dbindexlagsecalarmthresh | dilsat | Defines the lag time in seconds for updating secondary indexes after which the Secondary Index Encoding Error alarm is 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. For more information, see Auditing Data Access Operations and Selective Auditing of MapR-FS, MapR-DB Table, and MapR-ES Operations Using the CLI. |
enableddataauditoperations | edao | The list of operations selected for auditing. For more information, see Auditing Data Access Operations and Selective Auditing of MapR-FS, MapR-DB Table, and MapR-ES Operations Using the CLI. |
enforceMinReplicationForIO | esmr | Indicates whether (true ) or not
(false ) to enforce minimum number of replicas for the
volume. |
fixCreatorId | fcid | An internal flag for MapR volumes to fix the creator container ID. |
forceAudit | fa | Indicates whether (1 ) or not (0 ) to
force audit of operations on all files, tables, and streams in the
volume. |
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. |
metricsEnabled | me | Indicates whether (1 ) or not (0 )
metrics collection is enabled for the volume. |
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 |
nameContainerDataThresholdMB | ncdt | Maximum amount of data allowed in the name container. |
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 Errors 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):
|
wireSecurity | ws | Indicates whether (1 ) or not (0 )
wire-level security is enabled. |