mc ready
Syntax
The mc ready
command checks the status of a cluster and whether the cluster has read
and write
quorum.
The following sends a GET
request to the cluster at alias myminio
and returns its status.
mc ready myminio
The command sends a GET
request to the deployment at the alias
myminio
.’
The command repeats the request until it is successful.
The output before the cluster at alias myminio
is ready resembles the following:
The cluster `myminio` is unreachable: Get "http://myminio.example.com:9000/minio/health/cluster": dial tcp 198.51.100.0:9000: connect: connection refused
Once the request succeeds in connecting to the myminio
deployment, the output resembles the following:
The cluster `myminio` is ready
The command has the following syntax:
mc [GLOBALFLAGS] ready \
TARGET \
[--cluster-read] \
[--maintenance]
Brackets
[]
indicate optional parameters.Parameters sharing a line are mutually dependent.
Parameters separated using the pipe
|
operator are mutually exclusive.
Copy the example to a text editor and modify as-needed before running the command in the terminal/shell.
Parameters
- TARGET
- Required
The full path to the alias or prefix where the command should run.
- --cluster-read
- Optional
Checks if the cluster has enough quorum to serve
READ
requests.
Global Flags
This command supports any of the global flags.
Examples
Check if the cluster has read quorum
The following command checks that a deployment has sufficient drives available for read operations.
mc read myminio --cluster-read
Check if a cluster is down for maintenance
The following command checks whether the cluster can maintain read and write quorum during maintenance when the node at alias myminio
is taken down.
mc ready myminio --maintenance