mc replicate resync
mc replicate resync command resynchronizes all objects in the
specified MinIO bucket to a remote replication target.
This command requires first configuring the remote bucket target using the
mc replicate add command. You must specify the resulting
remote ARN as part of running
mc replicate resync.
This command supports rebuilding a MinIO deployment using an active-active replication remote as the “backup” source. See the following tutorials for more information on active-active replication:
The following command resynchronizes the content of the
mydata bucket on the
myminio MinIO deployment to the remote
MinIO deployment associated to the specified
mc replicate resync start \ --remote-bucket "arn:minio:replication::d3c086c7-1d64-40c2-954b-fe8222907033:mydata" \ myminio/mydata
The command has the following syntax:
mc [GLOBALFLAGS] replicate resync start|status \ --remote-bucket "string" \ [--older-than "string"] \ ALIAS
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.
The alias of the MinIO deployment and full path to the bucket or bucket prefix which MinIO uses as the replication source. For example, the following command starts replication using the
databucket on the MinIO deployment associated to the
mc replicate resync start primary/data --remote-bucket "ARN"
Starts the resynchronization procedure using the specified
bucketas the source and the
--remote-bucketas the remote target.
Mutually exclusive with
mc replicate resync status.
Returns the status of resynchronization on the specified
bucketto all remote targets.
--remote-bucketargument to filter the status output to only the specified remote target.
Specify the ARN for the destination deployment and bucket.
You can retrieve the ARN using
mc replicate lswith the
rule.Destination.Bucketfield contains the ARN for any given replication rule.
Specify a duration in days where MinIO only resynchronizes objects older than the specified duration.
Only valid with
mc replicate resync start.
This command supports any of the global flags.
Resynchronize Remote Replication Target from Source Bucket
mc replicate resync command resynchronizes all objects
on the specified source bucket to the remote target regardless of their
mc replicate resync start --remote-bucket "arn:minio:replication::UUID:data" primary/data
ALIASand full bucket path for which to create the replication configuration.
--remote-bucketvalue with the ARN of the remote target. Use
mc replicate lsto list all configured remote replication targets.
The mc commandline tool is built for compatibility with the AWS S3 API and is tested with MinIO and AWS S3 for expected functionality and behavior.
MinIO provides no guarantees for other S3-compatible services, as their S3 API implementation is unknown and therefore unsupported. While mc commands may work as documented, any such usage is at your own risk.