LeoFS is a highly available, distributed, eventually consistent object/blob store. If you are searching a storage system that is able to store huge amount and various kind of files such as photo, movie, log data and so on, LeoFS is suitable for that.
LeoFS is supporting the following features:
- Multi Protocol
- S3-API Support
- LeoFS is an Amazon S3 compatible storage system.
- Switch to LeoFS to decrease your cost from more expensive public-cloud solutions.
- NFS Support
- NFS support was provided from LeoFS v1.1, the current status of which is beta.
- S3-API Support
- Large Object Support
- LeoFS can handle files with more than GB
- Multi Data Center Replication
- LeoFS is a highly scalable, fault-tolerant distributed file system without SPOF.
- LeoFS's cluster can be viewed as ONE-HUGE storage. It consists of a set of loosely connected nodes.
- We can build a global scale storage system with easy operations
LeoFS consists of 3 applications - LeoFS Storage, LeoFS Gateway and LeoFS Manager which depend on Erlang.
LeoFS Gateway handles http-request and http-response from any clients when using REST-API OR S3-API. Also, it is already built in the object-cache mechanism (memory and disk cache).
LeoFS Storage handles GET, PUT and DELETE objects as well as metadata. Also, it has replicator, recoverer and queueing mechanism in order to keep running a storage node and realise eventual consistency.
LeoFS Manager always monitors LeoFS Gateway and LeoFS Storage nodes. The main monitoring status are Node status and RING’s checksum in order to realise to keep high availability and keep data consistency.
We can access LeoFS server using S3 clients and S3 client libries of each programming language.
The presentation - Scaling and High Performance Storage System: LeoFS was given at Erlang User Conference 2014 in Stockholm on June 2014
- LeoFS aims to provide all of 3-HIGHs as follow:
- HIGH Reliability
- Nine nines - Operating ratios is 99.9999999%
- High Scalability
- Build huge-cluster at low cost
- HIGH Cost Performance
- Fast - Over 10Gbps
- A lower cost than other storage
- Provide easy management and easy operation
- HIGH Reliability
LeoFS packages have been already provided on the Web. You're able to easily install LeoFS on your environments.
- LeoProject
- Community
Here is the installation manual.
Here, we explain how to build LeoFS from source code.
First, you have to install the following packages to build Erlang and LeoFS.
## [CentOS]
$ sudo yum install libuuid-devel cmake check check-devel
## [Ubuntu]
$ sudo apt-get install build-essential libtool libncurses5-dev libssl-dev cmake check
Then, install Erlang.
##
## 1. Install libatomic
##
$ wget http://www.hpl.hp.com/research/linux/atomic_ops/download/libatomic_ops-7.2d.tar.gz
$ tar xzvf libatomic_ops-7.2d.tar.gz
$ cd libatomic_ops-7.2d
$ ./configure --prefix=/usr/local
$ make
$ sudo make install
##
## 2. Install Erlang (17.5)
##
$ wget http://www.erlang.org/download/otp_src_17.5.tar.gz
$ tar xzf otp_src_17.5.tar.gz
$ cd otp_src_17.5
$ ./configure --prefix=/usr/local/erlang/17.5 \
--enable-smp-support \
--enable-m64-build \
--enable-halfword-emulator \
--enable-kernel-poll \
--without-javac \
--disable-native-libs \
--disable-hipe \
--disable-sctp \
--enable-threads \
--with-libatomic_ops=/usr/local
$ make
$ sudo make install
##
## 3. Set PATH
##
$ vi ~/.profile
## append the follows:
export ERL_HOME=/usr/local/erlang/17.5
export PATH=$PATH:$ERL_HOME/bin
$ source ~/.profile
Then, clone source of LeoFS and libraries from GitHub.
$ git clone https://github.com/leo-project/leofs.git
$ cd leofs
$ git checkout -b develop remotes/origin/develop
$ ./rebar get-deps
$ ./git_checkout.sh develop
Then, build LeoFS with the following commands.
$ make clean
$ make
$ make release
Now, you can find the LeoFS package as follow.
$ ls package/
leo_gateway/ leo_manager_0/ leo_manager_1/ leo_storage/ README.md
Then, we can start and access LeoFS with the following commands. Also, you're able to easily operate LeoFS with leofs-adm script.
$ package/leo_manager_0/bin/leo_manager start
$ package/leo_manager_1/bin/leo_manager start
$ package/leo_storage/bin/leo_storage start
$ package/leo_gateway/bin/leo_gateway start
$ ./leofs-adm status
[System Confiuration]
-----------------------------------+----------
Item | Value
-----------------------------------+----------
Basic/Consistency level
-----------------------------------+----------
system version | 1.2.16
cluster Id | leofs_1
DC Id | dc_1
Total replicas | 2
number of successes of R | 1
number of successes of W | 1
number of successes of D | 1
number of rack-awareness replicas | 0
ring size | 2^128
-----------------------------------+----------
Multi DC replication settings
-----------------------------------+----------
max number of joinable DCs | 2
number of replicas a DC | 1
-----------------------------------+----------
Manager RING hash
-----------------------------------+----------
current ring-hash | 3923d007
previous ring-hash | 3923d007
-----------------------------------+----------
[State of Node(s)]
-------+--------------------------+--------------+----------------+----------------+----------------------------
type | node | state | current ring | prev ring | updated at
-------+--------------------------+--------------+----------------+----------------+----------------------------
S | storage_0@127.0.0.1 | running | 3923d007 | 3923d007 | 2015-10-30 09:44:11 +0900
-------+--------------------------+--------------+----------------+----------------+----------------------------
$ ./leofs-adm start
OK
$ ./leofs-adm status
-----------------------------------+----------
Item | Value
-----------------------------------+----------
Basic/Consistency level
-----------------------------------+----------
system version | 1.2.16
cluster Id | leofs_1
DC Id | dc_1
Total replicas | 2
number of successes of R | 1
number of successes of W | 1
number of successes of D | 1
number of rack-awareness replicas | 0
ring size | 2^128
-----------------------------------+----------
Multi DC replication settings
-----------------------------------+----------
max number of joinable DCs | 2
number of replicas a DC | 1
-----------------------------------+----------
Manager RING hash
-----------------------------------+----------
current ring-hash | 3923d007
previous ring-hash | 3923d007
-----------------------------------+----------
[State of Node(s)]
-------+--------------------------+--------------+----------------+----------------+----------------------------
type | node | state | current ring | prev ring | updated at
-------+--------------------------+--------------+----------------+----------------+----------------------------
S | storage_0@127.0.0.1 | running | 3923d007 | 3923d007 | 2015-10-30 09:44:11 +0900
G | gateway_0@127.0.0.1 | running | 3923d007 | 3923d007 | 2015-10-30 09:45:27 +0900
-------+--------------------------+--------------+----------------+----------------+----------------------------
You can easily build a LeoFS cluster.
Please refer here.
About the configuration of LeoFS, please refer here.
You can benchmark LeoFS with Basho Bench.
Here is a documentation to benchmark LeoFS.
We're able to easily check LeoFS with leofs_test whether LeoFS has issues or not before getting installed LeoFS in your dev/staging/production environment(s).
- DONE - v1.0 (Nov 2013 - May 2014)
- Multi Data Center Replication
- Increase compatibility S3-APIs#5
- Other bucket operations
- DONE - v1.1
- NFS v3 Support (alpha)
- Improve Web GUI Console (Option)
- DONE - v1.2
- NFS v3 Support (beta)
- Watchdog
- Auto-compaction
- On Going - v1.4
- NFS v3 Support (stable)
- Improve performance of the list objects
- NFS lock-option support
- Erasure Code
- Improve Web GUI console (option)
- Improve compatibility S3-APIs#6
- AWS Signature v4 support
- Objects Expiration into a bucket
- Versioning
- NFS v3 Support (stable)
- v2.0
- NFS v4 Support
- Data Deduplication
- QoS Support (Option)
- Improve compatibility S3-APIs#7
LeoProject/LeoFS is sponsored by Rakuten, Inc. and supported by Rakuten Institute of Technology.