dump replicationmanagerqueueinfo

Returns information that enables you to check the status of containers in various replication manager queues like under-replicated containers, and over-replicated containers, etc.

Syntax

CLI
maprcli dump replicationmanagerqueueinfo
    [-cluster <cluster name>]
    -queue <queue>
NOTE
For best results, use the -json option from the command line.
REST
N/A

Parameters

Parameter

Description

cluster

The cluster on which to run the command. If this parameter is omitted, the command is run on the same cluster where it is issued. In multi-cluster contexts, you can use this parameter to specify a different cluster on which to run the command.

queue

The name of the queue. Valid values are 0, 1, 2, or 5. Queue 0 includes containers that have copies below the minimum replication factor for the volume. Queue 1 includes containers that have copies below the replication for the volume, but above the minimum replication factor. Queue 2 includes containers that are over-replicated. Queue 5 includes containers which are not rack aware.

Output

The maprcli dump replicationmanagerqueueinfo command returns information about one of these queues: 0, 1, 2, or 5. Depending on the queue value entered, the command displays information about containers that are under-replicated or over-replicated. You can use this information to decide if you need to change the replication factor for that volume.

# maprcli dump replicationmanagerqueueinfo -queue 0
Mtime                         LogicalSizeMB  UnusedServers  ActiveServers  TotalSizeMB  NameContainer  InactiveServers  ContainerId  Master                      Epoch  SharedSizeMB  OwnedSizeMB
Thu May 17 10:32:59 PDT 2012  0 MB                          ...            0 MB         false                           2065         10.250.1.103:5660--3-VALID  3      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  0 MB                          ...            0 MB         false                           2064         10.250.1.103:5660--3-VALID  3      0 MB          0 MB
                              0 MB                          ...            0 MB         true                            1            10.250.1.103:5660--8-VALID  8      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  0 MB                          ...            0 MB         false                           2066         10.250.1.103:5660--3-VALID  3      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  1 MB                          ...            0 MB         false                           2069         10.250.1.103:5660--5-VALID  5      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  1 MB                          ...            0 MB         false                           2068         10.250.1.103:5660--5-VALID  5      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  0 MB                          ...            0 MB         false                           2071         10.250.1.103:5660--3-VALID  3      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  0 MB                          ...            0 MB         false                           2070         10.250.1.103:5660--3-VALID  3      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  0 MB                          ...            0 MB         false                           2073         10.250.1.103:5660--3-VALID  3      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  0 MB                          ...            0 MB         false                           2072         10.250.1.103:5660--3-VALID  3      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  0 MB                          ...            0 MB         false                           2075         10.250.1.103:5660--3-VALID  3      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  0 MB                          ...            0 MB         false                           2074         10.250.1.103:5660--3-VALID  3      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  0 MB                          ...            0 MB         false                           2077         10.250.1.103:5660--3-VALID  3      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  0 MB                          ...            0 MB         false                           2076         10.250.1.103:5660--3-VALID  3      0 MB          0 MB
Thu May 17 10:36:30 PDT 2012  0 MB                          ...            0 MB         true                            2049         10.250.1.103:5660--7-VALID  7      0 MB          0 MB
Thu May 17 10:36:36 PDT 2012  0 MB                          ...            0 MB         true                            2050         10.250.1.103:5660--7-VALID  7      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  0 MB                          ...            0 MB         true                            2051         10.250.1.103:5660--6-VALID  6      0 MB          0 MB
Thu May 17 10:37:06 PDT 2012  0 MB                          ...            0 MB         true                            2053         10.250.1.103:5660--6-VALID  6      0 MB          0 MB
Fri May 18 14:33:44 PDT 2012  0 MB                          ...            0 MB         true                            2054         10.250.1.103:5660--5-VALID  5      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  0 MB                          ...            0 MB         true                            2055         10.250.1.103:5660--3-VALID  3      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  0 MB                          ...            0 MB         true                            2056         10.250.1.103:5660--3-VALID  3      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  0 MB                          ...            0 MB         false                           2057         10.250.1.103:5660--5-VALID  5      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  0 MB                          ...            0 MB         false                           2058         10.250.1.103:5660--3-VALID  3      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  0 MB                          ...            0 MB         false                           2059         10.250.1.103:5660--3-VALID  3      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  0 MB                          ...            0 MB         false                           2060         10.250.1.103:5660--3-VALID  3      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  0 MB                          ...            0 MB         false                           2061         10.250.1.103:5660--3-VALID  3      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  0 MB                          ...            0 MB         false                           2062         10.250.1.103:5660--3-VALID  3      0 MB          0 MB
Thu May 17 10:32:59 PDT 2012  0 MB                          ...            0 MB         false                           2063         10.250.1.103:5660--3-VALID  3      0 MB          0 MB

Output fields

Field

Description

ContainerID

The unique ID number of the container.

Epoch

A sequence number that indicates the most recent copy of the container. The CLDB uses the epoch to ensure that an out-of-date copy cannot become the master for the container.

Master

The physical IP address and port number of the master copy. The master copy is part of the original copy of the volume.

ActiveServers

The physical IP address and port number of each active node on which the container resides.

InactiveServers

The physical IP address and port number of each inactive node on which the container resides.

UnusedServers

The physical IP address and port number of servers from which no "heartbeat" has been received for quite some time.

OwnedSizeMB

The size on disk (in MB) dedicated to the container.

SharedSizeMB

The size on disk (in MB) shared by the container.

LogicalSizeMB

The logical size on disk (in MB) of the container.

TotalSizeMB

The total size on disk (in MB) allocated to the container. Combines the Owned Size and Shared Size.

Mtime

The time of the last modification to the contents of the container.

NameContainer

Indicates if the container is the name container for the volume. If true, the container holds the volume's namespace information and file chunk locations.

Example

CLI
maprcli dump replicationmanagerqueueinfo -queue 0 -json