117 lines
3.8 KiB
Markdown
117 lines
3.8 KiB
Markdown
# How to use ``mc mirror`` to setup replication between two sites running Minio. [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/minio/minio?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
|
|
|
![minio_MIRROR](https://github.com/minio/minio/blob/master/docs/screenshots/miniomirror.jpeg?raw=true)
|
|
|
|
|
|
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
|
|
|
|
* Download Minio server from [here](https://docs.minio.io/docs/minio)
|
|
* Download & Install mc from [here](https://docs.minio.io/docs/minio-client-quickstart-guide)
|
|
* Familiarity with [``mc mirror``](https://docs.minio.io/docs/minio-client-complete-guide#mirror)
|
|
|
|
## 2. Install and Configure Minio Server
|
|
|
|
### Setup minio1
|
|
|
|
```sh
|
|
$ ./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``.
|
|
|
|
```sh
|
|
$ ./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``](https://docs.minio.io/docs/minio-client-complete-guide#mb) and added objects to it using [``mc cp``](https://docs.minio.io/docs/minio-client-complete-guide#cp) Minio client commands.
|
|
|
|
```sh
|
|
$ ./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
|
|
|
|
```sh
|
|
$ ./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
|
|
...
|
|
```
|
|
|
|
```sh
|
|
$ ./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``.
|
|
|
|
```sh
|
|
$ ./mc mb minio1/mbucket
|
|
```
|
|
|
|
```sh
|
|
$ ./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.
|
|
|
|
```sh
|
|
|
|
#!/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.
|
|
|
|
```sh
|
|
|
|
$ chmod 755 /home/minio/minio.sh
|
|
```
|
|
|
|
Set a new cron entry to run ``minio.sh`` script once every 30mins.
|
|
|
|
```sh
|
|
|
|
$ 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.
|
|
|
|
# Explore Further
|
|
* [Minio Quickstart Guide](https://docs.minio.io/docs/minio-quickstart-guide)
|
|
* [Minio Client Complete Guide](https://docs.minio.io/docs/minio-client-complete-guide)
|