DownloadInstall guide
From GlusterDocumentation
This information is out of date
and does not contain information related to the current version of Gluster
Documentation Home
Dependencies
Basic Dependencies
- GlusterFS depends on FUSE on the client side (only). Ensure that libfuse is installed and FUSE kernel module is loaded before mounting. The libfuse must be 2.6.5 or newer.
Optional Dependencies
- OFED stack: Openfabrics RDMA based interconnects require OFED
- Apache: mod_glusterfs is an Apache adapter for high performance web storage.
Note: Gluster does not support or maintain mod_glusterfs. Quick-read translator is introduced from GlusterFS v3.0.1 to improve the performance for Apache. Therefore, mod_glusterfs is deprecated for all releases starting from GlusterFS v3.0.1.
- Berkeley DB: GlusterFS can store very small files efficiently on a distributed BerkeleyDB backend.
Download
- Check the download page for latest version
Installation
Here are some distro specific Installation steps of GlusterFS. If your distribution of OS is different than below mentioned, try compiling from Source.
After installation, make sure the installation is successful by checking the version of GlusterFS.
bash# glusterfs --version
GNU/Linux
'rpm' based distros
One can use the rpm available in GlusterFS ftp site.
bash# rpm -ivh glusterfs-<version>.rpm
It can be used on 'Fedora', 'OpenSuse', RedHat and CentOS distributions.
If 'glusterfs-<version>.rpm' is not available, it can be built on RedHat machines with below command:
bash# rpmbuild -ta glusterfs-<version>.tar.gz
If you have dependencies, use any of --without ibverbs, --without modglfs, --without bdb, --without client or --without libglfsclient accordingly.
'deb' based distros
Currently there are few contributors maintaining the glusterfs debian package. If the latest version is available in the debian repository, you just need to do
bash# apt-cache search glusterfs bash# apt-get install <glusterfs-*> # what ever the above search shows.
If the latest package is not available, then you need to install from source. which is described following sections.
Install from Source
Source tarball is available in the ftp repository of the project. Get the latest version as of today. You will also need flex, bison, and the corresponding dev libs for each feature.
bash# tar -xzf glusterfs-<version>.tar.gz bash# cd glusterfs-<version> bash# ./configure --prefix= > /dev/null GlusterFS configure summary =========================== FUSE client : yes Infiniband verbs : yes epoll IO multiplex : yes Berkeley-DB : yes libglusterfsclient : yes mod_glusterfs : yes argp-standalone : no bash# make && make install bash# ldconfig bash# glusterfs --version
Please refer to getting modglusterfs to work to get details about getting glusterfs module for Apache working.
Mac OS X (Darwin)
On Mac, though the source tarball can be built without any problems, one may be interested to use the click install .dmg images available from our ftp site. Click on the .dmg image after download and you will get a glusterfs package, which need to be installed by clicking on it again. If its a remote machine, you are doing installation on a terminal, you can use the below commands to install glusterfs.
bash# hdiutil attach glusterfs-<version>.dmg bash# installer -pkg /Volumes/glusterfs-<version>/glusterfs-<version>.pkg -target / bash# hdiutil detach /Volumes/glusterfs-<version>/
NOTE: Please go through 'README.MacOS' available with the .dmg image for complete steps for installation, for any version specific information.
Solaris
One can use the Solaris (ZFS) as storage backend with GlusterFS. The client part is not tested yet (mainly due to fuse support on solaris). Go through the below steps to get it working without any issues.
Packages needed
- SUNWarc - system SUNWarc Lint Libraries (usr)
- SUNWhea - system SUNWhea SunOS Header Files
- SUNWgcc gcc - The GNU C compiler
- SUNWbinutils binutils - GNU binutils
- pkg-get - /opt/csw/bin
- automake - /opt/csw/bin
- autoconf - /opt/csw/bin
- m4 - /opt/csw/bin
- bison 2.3 - /opt/csw/bin (GlusterFS works with this bison)
- flex 2.5.4 - /opt/csw/bin (GlusterFS works with this flex)
NOTE:
- flex also comes with SUNWflexlex package, which is installed in /usr/sfw/bin, but its been seen that with that flex there is problem of linking in GlusterFS. So, use the flex installed using 'pkg-get install flex' )
- make sure you are using 'GNU make' and not the Sun Solaris's 'make'
commands to follow
# bash bash-3.00# export PATH=/opt/csw/bin:/usr/sfw/bin:$PATH bash-3.00# gunzip -d glusterfs-VERSION.tar.gz bash-3.00# tar -xf glusterfs-VERSION.tar bash-3.00# cd glusterfs-VERSION bash-3.00# LDFLAGS="-L/opt/csw/lib" ./configure --disable-fuse-client --disable-ibverbs bash-3.00# make CFLAGS="-g -O0" LDFLAGS="-L/opt/csw/lib" bash-3.00# make install bash-3.00# /usr/local/sbin/glusterfs --version
FreeBSD
Only tested on FreeBSD 7 or later.
bash# gunzip glusterfs-<version>.tar.gz bash# tar -xf glusterfs-<version>.tar bash# cd glusterfs-<version> bash# ./configure && make && make install bash# glusterfs --version
If you find any problems, write to the developer mailing list (please provide complete information like machine type, OS version, log messages while failing, for quick help).
OpenFiler (rPath Linux)
The following install was performed on OpenFiler 2.3.
Log in as root on the OpenFiler appliance. Be sure you have updated the appliance to the latest version by following the instructions available at the OpenFiler site (http://www.openfiler.com). Make sure you have enough space on the drive to perform the install and compile of Gluster. Typically the OpenFiler guidelines have you make a root ('/') drive 2GB or less; you will need at least a few hundred MB of space free.
Perform the following commands to install a build environment:
conary update gcc conary update libtool conary update glib conary update glib:devel conary update glibc conary update glibc:devel conary update automake conary update autoconf conary update pkgconfig conary update flex conary update bison
Download the glusterfs compressed tar file. Now follow the typical compile and install procedures:
tar -xvzf glusterfs-<version>.tar.gz cd glusterfs-<version> ./configure && make && make install glusterfs --version
Refer
Following are the guides by GlusterFS users.
- Follow this link for GlusterFS Installation on VServer Guest.
- Install and run GlusterFS v1.3 in 1 minute is for you if you've wasted hours tinkering with other products and are anxious to see a cluster actually working.
- Check what are the Known Issues with current release.
This information is out of date
and does not contain information related to the current version of Gluster
Documentation Home
