Installing GlusterFS on the Client

From GlusterDocumentation

Contents

Introduction

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

For server installation, see Installing GlusterFS on the Server.

Before Installing

Before mounting GlusterFS on the client, make sure that libfuse (2.6.5 or higher) is installed and the FUSE kernel module is loaded. GlusterFS requires FUSE on the client side.

If your client does not support FUSE, see Adding unfs3.


Downloading GlusterFS

FIXME: Would any of these OS not apply for the client?? (I already removed Solaris)

To download GlusterFS, go to:

Select the package or tarball for your operating system.

Installing on GNU/Linux

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

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 Z RESEARCH Inc. <http://www.zresearch.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

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 Z RESEARCH Inc. <http://www.zresearch.com>

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 Z RESEARCH Inc. <http://www.zresearch.com>

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

If successful, the builds version information is displayed, for example:

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

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


About Solaris and FreeBSD

The client has not been tested on Solaris due to lack of FUSE support.

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

Next Steps

After completing the native installation of GlusterFS on the client, you are ready to mount the volume. See Mounting_a_GlusterFS_Volume.

Further Reading

FIXME: Does the VServer guest information apply to the client?

GlusterFS users have contributed:

 

Copyright © Gluster, Inc. All Rights Reserved.