minio/docs/shared-backend
Harshavardhana 1c699d8d3f fs: Re-implement object layer to remember the fd (#3509)
This patch re-writes FS backend to support shared backend sharing locks for safe concurrent access across multiple servers.
2017-01-16 17:05:00 -08:00
..
DESIGN.md fs: Re-implement object layer to remember the fd (#3509) 2017-01-16 17:05:00 -08:00
README.md fs: Re-implement object layer to remember the fd (#3509) 2017-01-16 17:05:00 -08:00

Shared Backend Minio Quickstart Guide Slack Go Report Card Docker Pulls codecov

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. Youll see the uploaded files are accessible from the node2 endpoint as well.

Explore Further