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 the columns 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:
  • 0 - user
  • 1 - group
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:
  • 0 - disabled
  • 1 - enabled
mirrortype mrt Determines the type of volume:
  • 0 - Read-write Volume
  • 1 - Mirror Volume
  • 2 - Mirror than can be converted to read-write
  • 3 - Read-write volume that can be converted to mirror
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):
  • 0 - Read-write Volume
  • 1 - Mirror Volume
wireSecurity ws Indicates whether (1) or not (0) wire-level security is enabled.