3.8 KiB
How to use mc mirror to setup replication between two sites running Minio. 
In this document we will illustrate how to set up replication between two Minio servers, minio1 and minio2 running on 192.168.1.11 and 192.168.1.12 respectively. We will mirror the data directory on minio1 to the bucket on minio2.
1. Prerequisites
2. Install and Configure Minio Server
Setup minio1
$ ./minio server minio1-data/
Endpoint: http://127.0.0.1:9000 http://192.168.1.11:9000
AccessKey: MURIVYBYNPTYE7O8I779
SecretKey: lVbZmz4CvGkBl7JKw5icuL7RCcSvpBJTkAJTFQwz
Region: us-east-1
...
mc alias
Alias is a short name to your cloud storage service for Minio client. End-point, access and secret keys are supplied by your cloud storage provider. API signature is an optional argument. By default, it is set to S3v4.
$ ./mc config host add minio1 http://192.168.1.11:9000 MURIVYBYNPTYE7O8I779 lVbZmz4CvGkBl7JKw5icuL7RCcSvpBJTkAJTFQwz
Create buckets and add objects
We have created few buckets using mc mb and added objects to it using mc cp Minio client commands.
$ ./mc mb minio1/mybucket
$ ./mc cp myfile.txt minio1/bucket1
$ ./mc ls minio1
[2016-07-31 10:26:55 PDT] 0B bucket1/
[2016-07-31 09:36:17 PDT] 0B bucket2/
[2016-07-31 09:38:08 PDT] 0B bucket3/
Setup minio2
$ ./minio server minio2-data/
Endpoint: http://127.0.0.1:9000 http://192.168.1.12:9000
AccessKey: YRDRWWQLEWS9OBJ31GZ2
SecretKey: y2sSWzx5ytwvkELcxOuSaQ8n3doNqoIilRpb5Kjj
Region: us-east-1
...
$ ./mc config host add minio2 http://192.168.1.12:9000 YRDRWWQLEWS9OBJ31GZ2 y2sSWzx5ytwvkELcxOuSaQ8n3doNqoIilRpb5Kjj
Create bucket
We are creating destination bucket mbucket on minio2 and adding minio2 alias. The bucket mbucket will be used to mirror data directory of minio1.
$ ./mc mb minio1/mbucket
$ ./mc config host add minio2 http://192.168.1.12:9000 YRDRWWQLEWS9OBJ31GZ2 y2sSWzx5ytwvkELcxOuSaQ8n3doNqoIilRpb5Kjj
4. Setup crontab
Cron is a Unix/Linux system utility by which you can schedule a task process for particular duration, we have tested this setup on Ubuntu Linux.
Script
Add crontab configuration on minio1 providing path of data directory, minio1-data.
--force option with mc mirror overwrites the destination contents, this would keep your contents in sync.
#!/bin/bash
datadir="/home/minio/minio1-data/"
minio2="minio2/mbucket"
MC_PATH="/home/minio/mc"
$MC_PATH --quiet mirror --force $minio1 $minio2
Set executable permissions on the script before adding a cron entry.
$ chmod 755 /home/minio/minio.sh
Set a new cron entry to run minio.sh script once every 30mins.
$ crontab -e
*/30 * * * * /home/minio/minio.sh
Note: We are going to introduce continuous replication feature in mc mirror which will enable the sites to be in sync without having the need to setup cron job.