mc admin replicate status

Displays the status of the sites, buckets, users, groups, or policies for a site replication configuration.

Syntax 

mc [GLOBALFLAGS] admin replicate status          \
                   TARGET                        \
                   [--all]                       \
                   [--buckets]                   \
                   [--bucket nameOfBucket]       \
                   [--groups]                    \
                   [--group nameOfGroup]         \
                   [--ilm-expiry-rules]          \
                   [--ilm-expiry-rule <rule ID>] \
                   [--policies]                  \
                   [--policy nameOfPolicy]       \
                   [--users]                     \
                   [--user accessKey]

Parameters

TARGET

Required

The alias of an active MinIO AIStor deployment in the site replication configuration.

--all

Optional

Display all available site replication status information.

--buckets

Optional

Display the replication status of all buckets.

--bucket

Optional

Display the replication status of a specific bucket by including the bucket name after the flag.

--groups

Optional

Display the replication status of all groups.

--group

Optional

Display the replication status of a specific group by including the group name after the flag.

--ilm-expiry-rules

Optional

Display sync information about ILM expiration rules.

Mutually exclusive with --ilm-expiry-rule

--ilm-expiry-rule

Optional

Display replication status information about the specified ILM expiration rule.

Mutually exclusive with --ilm-expiry-rules

--policies

Optional

Display the replication status of all policies.

--policy

Optional

Display the replication status of a specific policy by including the policy name after the flag.

--users

Optional

Display the replication status of all users.

--user

Optional

Display the replication status of a specific identity.

Specify the identity using the value MinIO AIStor stores it under, which depends on the identity provider:

  • For a built-in user, the access key. A built-in user’s access key and username are the same string.
  • For an LDAP user, the full distinguished name (DN), such as uid=janedoe,ou=people,dc=example,dc=com. MinIO AIStor treats any value containing an equals sign as a DN.
  • For a service account or a Security Token Service (STS) credential, that credential’s own access key.

Global flags

This command supports any of the global flags.

Examples

Display the overall replication status for a site replication configuration that includes the site myaistor1.

mc admin replicate status myaistor1

Display the replication status of buckets across sites for a site replication configuration that includes the site myaistor1.

mc admin replicate status     \
                   myaistor1     \
                   --buckets

Display the site replication status of a bucket called images across sites for a site replication configuration that contains the site myaistor1.

mc admin replicate status           \
                    myaistor1          \
                    --bucket images

Display the site replication status for the setting for a user, janedoe, across sites for a site replication configuration that contains the site myaistor1.

mc admin replicate status         \
                   myaistor1         \
                   --user janedoe

The output of the above examples resembles the following:

Bucket replication status:
●  30/30 Buckets in sync

Policy replication status:
●  5/5 Policies in sync

User replication status:
●  3/3 Users in sync

Group replication status:
No Groups present

ILM Expiry Rules replication status:
●  5/5 ILM Expiry Rules in sync

Object replication status:
Replication status since 1 day
Summary:
In Progress:    - 0 objects, (0 B) (avg: 0 objects, 0 B; max: 0 objects, 0 B)
Queued:        - 0 objects, (0 B) (avg: 0 objects, 0 B; max: 0 objects, 0 B)
Errors:        0 in last 1 minute; 0 in last 1 hr; 1 since uptime
Retries:       0 in last 1 minute; 0 in last 1 hr; 1 since uptime
Replicated:    0 objects (0 B)
Received:      0 objects (0 B)

Display the site replication status across sites for the ILM expiration rule with rule ID of ckok9v5b4dtgofkbi6tg for a site replication configuration that contains the site myaistor1.

mc admin replicate status myaistor1 --ilm-expiry-rule ckok9v5b4dtgofkbi6tg

The output resembles the following:

●  ILM Expiry Rule replication summary for: ckok9v5b4dtgofkbi6tg

ILMExpiryRule   | myaistor1          | myaistor2
ILM Expiry Rule | ✔               | ✔