1c699d8d3f
This patch re-writes FS backend to support shared backend sharing locks for safe concurrent access across multiple servers. |
||
|---|---|---|
| .. | ||
| DESIGN.md | ||
| README.md | ||
README.md
Shared Backend Minio Quickstart Guide 
Minio now supports shared backend across multiple instances. This solves certain specific use cases.
Use Cases
- Minio on NAS
- Minio on Distributed Filesystems
- Multi-user Shared Backend.
Why Minio On Shared Backend?
This feature allows Minio to serve a shared NAS drive across multiple Minio instances. There are no special configuration changes required to enable this feature. Access to files stored on NAS volume are locked and synchronized by default.
Get started
If you're aware of stand-alone Minio set up, the installation and running remains the same.
1. Prerequisites
Install Minio - Minio Quickstart Guide.
2. Run Minio On Shared Backend
Below examples will clarify further for each operating system of your choice:
Ubuntu 16.04 LTS
Run the following commands on all the object storage gateway servers where your NAS volume is accessible. By explicitly passing access and secret keys through the environment variable you make sure that all the gateway servers share the same key across.
Example 1: Start Minio instance on a shared backend mounted and available at /mnt/nfs.
On linux server1
minio server /mnt/nfs
On linux server2
minio server /mnt/nfs
Windows 2012 Server
Run the following commands on all the object storage gateway servers where your NAS volume is accessible. By explicitly passing access and secret keys through the environment variable you make sure that all the gateway servers share the same key across.
Example 1: Start Minio instance on a shared backend mounted and available at \\remote-server\smb.
On windows server1
set MINIO_ACCESS_KEY=my-username
set MINIO_SECRET_KEY=my-password
minio.exe server \\remote-server\smb\export
On windows server2
set MINIO_ACCESS_KEY=my-username
set MINIO_SECRET_KEY=my-password
minio.exe server \\remote-server\smb\export
Alternatively if \\remote-server\smb is mounted as M:\ drive.
On windows server1
set MINIO_ACCESS_KEY=my-username
set MINIO_SECRET_KEY=my-password
net use m: \\remote-server\smb\export /P:Yes
minio.exe server M:\export
On windows server2
set MINIO_ACCESS_KEY=my-username
set MINIO_SECRET_KEY=my-password
net use m: \\remote-server\smb\export /P:Yes
minio.exe server M:\export
3. Test your setup
To test this setup, access the Minio server via browser or mc. You’ll see the uploaded files are accessible from the node2 endpoint as well.