Installing a Storage Server

From GlusterDocumentation

This information is out of date
and does not contain information related to the current version of Gluster

Documentation Home

FIXME: Starting on updates to Install

[edit]

Preparing to Install GlusterFS on the Server

This section describes how to locate and install the latest version of GlusterFS for your operating system.

[edit]

Downloading GlusterFS

To download GlusterFS, go to:

Download page for latest version

Official FTP site

Select the package or tarball for your operating system.

[edit]

Installing on GNU/Linux

Depending on your Linux distribution, use one of the following methods.

[edit]

Red Hat Package Manager (RPM) based Distributions

To install the GlusterFS package on Fedora, OpenSUSE, Red Hat, or CentOS Linux distributions, run the following commands:

bash# rpm -ivh glusterfs-*-version.rpm
bash# glusterfs --version

The build version information displays, for example:

glusterfs 2.0.3 built on Jul  7 2009 12:22:40
Repository revision: 9ec22fd9fc28684b7e2093b4c67d449c7f021623
Copyright (c) 2006-2009 Gluster Inc. <http://www.gluster.com>

If the glusterfs-server-version.rpm file is not available, you can build it on Red Hat Linux by entering the following command:

bash# rpmbuild -ta glusterfs-version.tar.gz

[edit]

Debian-based Distributions

You can get GlusterFS from www.debian.org in the testing and unstable repositories. Currently, there are few contributors maintaining the GlusterFS Debian package. (You can get the latest package by installing from source.)

bash# apt-get install glusterfs-*
bash# glusterfs --version

The build information is displayed, for example:

glusterfs 2.0.3 built on Jul  7 2009 12:22:40
Repository revision: 9ec22fd9fc28684b7e2093b4c67d449c7f021623
Copyright (c) 2006-2009 Gluster Inc. <http://www.gluster.com>

[edit]

Installing from Source

You can get the source tarball from the ftp repository of the project. To install the tar file from source, enter the following commands:

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
argp-standalone    : no

bash# make && make install
bash# ldconfig
bash# glusterfs --version

The build information is displayed, for example:

glusterfs 2.0.3 built on Jul  7 2009 12:22:40
Repository revision: 9ec22fd9fc28684b7e2093b4c67d449c7f021623
Copyright (c) 2006-2009 Gluster Inc. <http://www.gluster.com>

[edit]

Installing on Mac OS X

Mac OS X users can build from the source tarball without problems, or install the .dmg images available from the GlusterFS ftp site. After downloading, click on the .dmg image to get a GlusterFS package.

If you are installing the package locally, click to install.
If you are installing on a remote machine from a terminal, enter the following commands:

bash# hdiutil attach glusterfs-version.dmg
bash# installer -pkg /Volumes/glusterfs-version/glusterfs-version.pkg -target /
bash# hdiutil detach /Volumes/glusterfs-version/
bash# glusterfs --version

The build information is displayed, for example:

glusterfs 2.0.3 built on Jul  7 2009 12:22:40
Repository revision: 9ec22fd9fc28684b7e2093b4c67d449c7f021623
Copyright (c) 2006-2009 Gluster Inc. <http://www.gluster.com>

Note: For complete installation steps for your version of Mac OS X, read the README.MacOS file available with the .dmg image.

[edit]

Installing on Solaris

You can use the Solaris ZFS file system as a storage backend with GlusterFS. (The client has not been tested due to FUSE support on Solaris.)

To install GlusterFS for Solaris, perform the following steps:

Make sure that your Solaris installation includes the following:

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)

Notes:

Use the Flex installed by entering "pkg-get install flex". (Flex also comes with the SUNWflexlex package, which is installed in /usr/sfw/bin, but there is a linking problem in GlusterFS with that Flex.)
Use the GNU make utility and not the Solaris make utility.

Enter the following commands:

FIXME: can you give me a sample for what the user should see somewhere in the middle here so that they don't 8 commands without seeing that they are on the right track?

# 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

The build information is displayed, for example:

glusterfs 2.0.3 built on Jul  7 2009 12:22:40
Repository revision: 9ec22fd9fc28684b7e2093b4c67d449c7f021623
Copyright (c) 2006-2009 Gluster Inc. <http://www.gluster.com>

[edit]

About FreeBSD

Due to the 32-bit inode limitations of FreeBSD, the FreeBSD version of GlusterFS is not functioning. This problem will be addressed in future releases of GlusterFS.

[edit]