volume mirror status
Displays the status of the mirroring operation in progress. Use this command to examine the progress of mirroring.
- License required: Enterprise Edition
- Permissions required:
fc
orrestore
on the volume
status
command displays the statstics of the
mirroring operation including the total number of container IDs to resync,
the current status of the mirroring, the number of indoes in use for the
mirror, the container ID information for the source and destination volumes,
and the error code if any, to name a few.Syntax
- CLI
-
maprcli volume mirror status [ -cluster cluster_name ] -name name [ -start start. default: 1 ] [ -limit limit. default: 2147483647 ] [ -verbose <true/false> if true, will displayed detailed container information. default: true ]
- REST
Request Type POST Request URL http[s]://<host>:<port>/rest/volume/mirror/status?<parameters>
Parameters
Parameter | Description |
---|---|
cluster |
The cluster on which to run the command. |
name
|
The volume for which to determine the mirror status. |
start |
The container to start with. |
limit |
The number of containers for which to display status. |
verbose |
Whether to display a terse output or display full statistics. |
Examples
Check the status of the mirroring on mirror volume "testvol":
maprcli volume mirror status -name testvol -json
**** Displays mirroring statistics. ****
*** Here, it is resyncing destination containers ****
{
"timestamp":1622443868513,
"timeofday":"2021-05-31 06:51:08.513 GMT+0000 AM",
"status":"OK",
"total":1,
"data":[
{
"SourceVolumeName":"test",
"SourceClusterName":"my.cluster.com",
"MirroringStarted":"2021-05-31 06:51:02.532 GMT+0000",
"MirrorState":"ResyncDestinationContainers",
"TotalResyncInProgressCids":6,
"ResyncInProgressCids":[
{
"ErrorCode":0,
"Progress":0,
"ResyncStartedTime":"2021-05-31 06:51:06.985 GMT+0000",
"DestinationCid":{
"ContainerId":2147,
"Epoch":3,
"Master":"10.163.167.214:5660--3-VALID",
"ActiveServers":{
"IP":"10.163.167.214:5660--3-VALID"
},
"InactiveServers":{
},
"UnusedServers":{
},
"OwnedSizeMB":"0 MB",
"SharedSizeMB":"0 MB",
"LogicalSizeMB":"0 MB",
"TotalSizeMB":"0 MB",
"NumInodesInUse":256,
"Mtime":"May 31, 2021",
"NameContainer":"false",
"CreatorContainerId":2138,
"CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
"UseActualCreatorId":false
},
"SourceSnapCid":{
"ContainerId":256000069,
"Epoch":3,
"Master":"10.163.167.214:5660--3-VALID",
"ActiveServers":{
"IP":"10.163.167.214:5660--3-VALID"
},
"InactiveServers":{
},
"UnusedServers":{
},
"OwnedSizeMB":"0 MB",
"SharedSizeMB":"0 MB",
"LogicalSizeMB":"0 MB",
"TotalSizeMB":"0 MB",
"NameContainer":"false",
"RW ContainerId":2138,
"RW VolumeId":217081367,
"CreatorContainerId":2138,
"CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
"UseActualCreatorId":false
}
},
{
"ErrorCode":0,
"Progress":0,
"ResyncStartedTime":"2021-05-31 06:51:06.985 GMT+0000",
"DestinationCid":{
"ContainerId":2144,
"Epoch":3,
"Master":"10.163.167.214:5660--3-VALID",
"ActiveServers":{
"IP":"10.163.167.214:5660--3-VALID"
},
"InactiveServers":{
},
"UnusedServers":{
},
"OwnedSizeMB":"0 MB",
"SharedSizeMB":"32 MB",
"LogicalSizeMB":"32 MB",
"TotalSizeMB":"32 MB",
"NumInodesInUse":33,
"Mtime":"May 31, 2021",
"NameContainer":"false",
"CreatorContainerId":2142,
"CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
"UseActualCreatorId":false
},
"SourceSnapCid":{
"ContainerId":256000073,
"Epoch":3,
"Master":"10.163.167.214:5660--3-VALID",
"ActiveServers":{
"IP":"10.163.167.214:5660--3-VALID"
},
"InactiveServers":{
},
"UnusedServers":{
},
"OwnedSizeMB":"0 MB",
"SharedSizeMB":"0 MB",
"LogicalSizeMB":"0 MB",
"TotalSizeMB":"0 MB",
"NameContainer":"false",
"RW ContainerId":2142,
"RW VolumeId":217081367,
"CreatorContainerId":2142,
"CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
"UseActualCreatorId":false
}
},
{
"ErrorCode":0,
"Progress":0,
"ResyncStartedTime":"2021-05-31 06:51:06.985 GMT+0000",
"DestinationCid":{
"ContainerId":2137,
"Epoch":3,
"Master":"10.163.167.214:5660--3-VALID",
"ActiveServers":{
"IP":"10.163.167.214:5660--3-VALID"
},
"InactiveServers":{
},
"UnusedServers":{
},
"OwnedSizeMB":"0 MB",
"SharedSizeMB":"0 MB",
"LogicalSizeMB":"0 MB",
"TotalSizeMB":"0 MB",
"NumInodesInUse":34,
"Mtime":"May 31, 2021",
"NameContainer":"true",
"CreatorContainerId":2136,
"CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
"UseActualCreatorId":false
},
"SourceSnapCid":{
"ContainerId":256000068,
"Epoch":3,
"Master":"10.163.167.214:5660--3-VALID",
"ActiveServers":{
"IP":"10.163.167.214:5660--3-VALID"
},
"InactiveServers":{
},
"UnusedServers":{
},
"OwnedSizeMB":"0 MB",
"SharedSizeMB":"0 MB",
"LogicalSizeMB":"0 MB",
"TotalSizeMB":"0 MB",
"NameContainer":"true",
"RW ContainerId":2136,
"RW VolumeId":217081367,
"CreatorContainerId":2136,
"CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
"UseActualCreatorId":false
}
},
{
"ErrorCode":0,
"Progress":0,
"ResyncStartedTime":"2021-05-31 06:51:06.985 GMT+0000",
"DestinationCid":{
"ContainerId":2145,
"Epoch":3,
"Master":"10.163.167.214:5660--3-VALID",
"ActiveServers":{
"IP":"10.163.167.214:5660--3-VALID"
},
"InactiveServers":{
},
"UnusedServers":{
},
"OwnedSizeMB":"0 MB",
"SharedSizeMB":"0 MB",
"LogicalSizeMB":"0 MB",
"TotalSizeMB":"0 MB",
"NumInodesInUse":256,
"Mtime":"May 31, 2021",
"NameContainer":"false",
"CreatorContainerId":2140,
"CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
"UseActualCreatorId":false
},
"SourceSnapCid":{
"ContainerId":256000071,
"Epoch":3,
"Master":"10.163.167.214:5660--3-VALID",
"ActiveServers":{
"IP":"10.163.167.214:5660--3-VALID"
},
"InactiveServers":{
},
"UnusedServers":{
},
"OwnedSizeMB":"0 MB",
"SharedSizeMB":"0 MB",
"LogicalSizeMB":"0 MB",
"TotalSizeMB":"0 MB",
"NameContainer":"false",
"RW ContainerId":2140,
"RW VolumeId":217081367,
"CreatorContainerId":2140,
"CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
"UseActualCreatorId":false
}
},
{
"ErrorCode":0,
"Progress":0,
"ResyncStartedTime":"2021-05-31 06:51:06.985 GMT+0000",
"DestinationCid":{
"ContainerId":2143,
"Epoch":3,
"Master":"10.163.167.214:5660--3-VALID",
"ActiveServers":{
"IP":"10.163.167.214:5660--3-VALID"
},
"InactiveServers":{
},
"UnusedServers":{
},
"OwnedSizeMB":"0 MB",
"SharedSizeMB":"0 MB",
"LogicalSizeMB":"0 MB",
"TotalSizeMB":"32 MB",
"NumInodesInUse":32,
"Mtime":"May 31, 2021",
"NameContainer":"false",
"CreatorContainerId":2141,
"CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
"UseActualCreatorId":false
},
"SourceSnapCid":{
"ContainerId":256000072,
"Epoch":3,
"Master":"10.163.167.214:5660--3-VALID",
"ActiveServers":{
"IP":"10.163.167.214:5660--3-VALID"
},
"InactiveServers":{
},
"UnusedServers":{
},
"OwnedSizeMB":"0 MB",
"SharedSizeMB":"0 MB",
"LogicalSizeMB":"0 MB",
"TotalSizeMB":"0 MB",
"NameContainer":"false",
"RW ContainerId":2141,
"RW VolumeId":217081367,
"CreatorContainerId":2141,
"CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
"UseActualCreatorId":false
}
},
{
"ErrorCode":0,
"Progress":0,
"ResyncStartedTime":"2021-05-31 06:51:06.985 GMT+0000",
"DestinationCid":{
"ContainerId":2146,
"Epoch":3,
"Master":"10.163.167.214:5660--3-VALID",
"ActiveServers":{
"IP":"10.163.167.214:5660--3-VALID"
},
"InactiveServers":{
},
"UnusedServers":{
},
"OwnedSizeMB":"0 MB",
"SharedSizeMB":"0 MB",
"LogicalSizeMB":"0 MB",
"TotalSizeMB":"0 MB",
"NumInodesInUse":256,
"Mtime":"May 31, 2021",
"NameContainer":"false",
"CreatorContainerId":2139,
"CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
"UseActualCreatorId":false
},
"SourceSnapCid":{
"ContainerId":256000070,
"Epoch":3,
"Master":"10.163.167.214:5660--3-VALID",
"ActiveServers":{
"IP":"10.163.167.214:5660--3-VALID"
},
"InactiveServers":{
},
"UnusedServers":{
},
"OwnedSizeMB":"0 MB",
"SharedSizeMB":"0 MB",
"LogicalSizeMB":"0 MB",
"TotalSizeMB":"0 MB",
"NameContainer":"false",
"RW ContainerId":2139,
"RW VolumeId":217081367,
"CreatorContainerId":2139,
"CreatorVolumeUuid":"-8872774736600751871:7950895803961029577",
"UseActualCreatorId":false
}
}
]
}
]
}
maprcli volume mirror status -name testvol -json
*** Now the resync is done and the source snapshot is deleted. ***
{
"timestamp":1622443878136,
"timeofday":"2021-05-31 06:51:18.136 GMT+0000 AM",
"status":"OK",
"total":1,
"data":[
{
"SourceVolumeName":"test",
"SourceClusterName":"my.cluster.com",
"MirroringStarted":"2021-05-31 06:51:02.532 GMT+0000",
"MirrorState":"DeleteSourceSnapshot"
}
]
}
maprcli volume mirror status -name testvol -json
*** Mirroring is now complete ***
{
"timestamp":1622443883402,
"timeofday":"2021-05-31 06:51:23.402 GMT+0000 AM",
"status":"ERROR",
"errors":[
{
"id":0,
"desc":"No mirror jobs are in progress for volume testvol"
}
]
}
https://abc.sj.us:8443/rest/volume/mirror/status?name=testvol