Installing LizardFS¶

Getting and installing LizardFS¶

There are several methods for getting LizardFS software. The easiest and most common method is to get packages by adding repositories for use with package management tools such as the Advanced Package Tool (APT) or Yellowdog Updater, Modified (YUM). You may also retrieve pre-compiled packages from the LizardFS repository. Finally, you can retrieve tar balls or clone the LizardFS source code repository and build LizardFS yourself.

Installing from Debian or Ubuntu packages¶

First, add a our key which is needed to verify the signatures of LizardFS packages:

# wget -O - http://packages.lizardfs.com/lizardfs.key | apt-key add -

Now add a proper entry in /etc/apt/sources.list.d/

For Debian do:

# apt-get install lsb-release
# echo "deb http://packages.lizardfs.com/debian/$(lsb_release -sc) $(lsb_release -sc) main" > /etc/apt/sources.list.d/lizardfs.list
# echo "deb-src http://packages.lizardfs.com/debian/$(lsb_release -sc) $(lsb_release -sc) main" >> /etc/apt/sources.list.d/lizardfs.list

For Ubuntu do:

# echo "deb http://packages.lizardfs.com/ubuntu/$(lsb_release -sc) $(lsb_release -sc) main" > /etc/apt/sources.list.d/lizardfs.list
# echo "deb-src http://packages.lizardfs.com/ubuntu$(lsb_release -sc) $(lsb_release -sc) main" >> /etc/apt/sources.list.d/lizardfs.list

This will have created the lizardfs.list file. To use the newly added repository, update the packages index:

# apt-get update

Now you are able to install LizardFS packages (listed below) using:

# apt-get install <package>

It is also possible to download the source package using:

# apt-get source lizardfs

Important

Before upgrading any existing LizardFS installation, please read the instructions here: Upgrading Lizardfs

LizardFS consists of the following packages:

lizardfs-master – LizardFS master server
lizardfs-chunkserver – LizardFS data server
lizardfs-client – LizardFS client
lizardfs-adm – LizardFS administration tools (e.g, lizardfs-probe)
lizardfs-cgi – LizardFS CGI Monitor
lizardfs-cgiserv – Simple CGI-capable HTTP server to run LizardFS CGI Monitor
lizardfs-metalogger – LizardFS metalogger server
lizardfs-common – LizardFS common files required by lizardfs-master, lizardfs-chunkserver and lizardfs-metalogger
lizardfs-dbg – Debugging symbols for all the LizardFS binaries
lizardfs-uraft - High Availability solution based on RAFT algorithm (from version 3.13)

Installing from RedHAT EL / CentOS Packages¶

First, add a file with information about the repository:

for RHEL 6 and CentOS 6:

# curl http://packages.lizardfs.com/yum/el6/lizardfs.repo > /etc/yum.repos.d/lizardfs.repo
# yum update

for RHEL 7 and CentOS 7:

# curl http://packages.lizardfs.com/yum/el7/lizardfs.repo > /etc/yum.repos.d/lizardfs.repo
# yum update

To get libjudy which is used by parts of LizardFS, install the epel repository for RHEL 7:

yum install epel-release

Now you are able to install LizardFS packages (listed below) using:

# yum install <package>

It is also possible to download the source package (SRPM) using:

# yum install yum-utils
# yumdownloader --source lizardfs

Important

Before upgrading any existing LizardFS installation, please read the instructions here: Upgrading Lizardfs

LizardFS consists of following packages:

lizardfs-master – LizardFS master server
lizardfs-chunkserver – LizardFS data server
lizardfs-client – LizardFS client
lizardfs-adm – LizardFS administration tools (e.g, lizardfs-probe)
lizardfs-cgi – LizardFS CGI Monitor
lizardfs-cgiserv – Simple CGI-capable HTTP server to run LizardFS CGI Monitor
lizardfs-metalogger – LizardFS metalogger server
lizardfs-debuginfo – (CentOS 7 / RHEL 7 only) Debugging symbols and sources for all the LizardFS binaries

Installing LizardFS from downloaded .deb packages¶

Make sure to install the lizardfs-common package first before installing other packages.

Also, remember to install lizardfs-cgi before installing lizardfs-cgiserv

In order to install a .deb package, run:

# dpkg -i <package>

If installing fails due to dependency problems, run:

# apt-get -f install

Installing LizardFS from source¶

Installing LizardFS from source.

The current LizardFS source code can be obtained from our github (https://github.com/lizardfs/lizardfs) project page. You can either download a tar ball from there by choosing the respective version in the Branch tab on the left or use git to clone the source tree.

LizardFS uses CMake as its build system. To compile the sources, follow the directions outlined below.

Create a build directory inside the source directory:
```
cd lizardfs-source
mkdir build
```
Run cmake .. inside the build directory. Useful options include -DCMAKE_INSTALL_PREFIX, -DCMAKE_BUILD_TYPE as well as various LizardFS-specific -DENABLE_… options. Options are listed when cmake is ran and can be changed by re-running cmake:
```
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/opt/lizardfs
```
Run make in the build directory:
```
make
```
Run make install to install files (you may need to be root):
```
make install
```
Now continue to the configuration pages.

If you want to participate in developing LizardFS, please refer to the LizardFS Developers Guide and the Participation Rules.