Install and run GlusterFS v1.3 in 10mins

From GlusterDocumentation

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

Documentation Home

NOTE: Any new users trying out GlusterFS newly, its advised to get these barebone configurations working properly before configuring GlusterFS for higher performance.

[edit]

Requirements

NOTE: If you are starting this instruction manual with the timer clock on, I would recommend the following packages to be already installed in your system.

flex
bison
byacc
fuse-devel

[edit]

Download

[edit]

Get GlusterFS

Download GlusterFS from the following links

[edit]

Install

NOTE: You need to be logged in as 'root' to run the following commands.

[edit]

GlusterFS

$ rpm -Uvh glusterfs-*rpm

Congratulations :) You are done with 'glusterfs' installation.

[edit]

Execution

After installation is complete, the problem that the majority of people are faced with is how to get glusterfs working. To run GlusterFS, you need a volume specification file, or spec file, which defines the behavior and features for glusterfs.

We will start with a barebones spec file (this spec file is very basic and it is just to get the feel of GlusterFS).

NOTE: On many systems, modifying (or turning off) iptables may be required to get GlusterFS working.

$ glusterfs --help

[edit]

Example

In this basic example, let us assume you have two machines, '192.168.0.1' and '192.168.0.2'. Let 192.168.0.1 be the server and 192.168.0.2 be the client.

NOTE: you must change the IP address in the spec file according to your network configuration or else to test, you can use the system's localhost IP address (i.e. 127.0.0.1)

[edit]

Server machine: [192.168.0.1]

NOTE: After editing the file it should have the content as shown by the cat command, and this holds true for all the given examples below.

$ emacs /etc/glusterfs/glusterfs-server.vol
$ cat /etc/glusterfs/glusterfs-server.vol
volume brick
  type storage/posix
  option directory /tmp/export
end-volume

volume server
  type protocol/server
  subvolumes brick
  option transport-type tcp/server # For TCP/IP transport
  option auth.ip.brick.allow *
end-volume

$ glusterfsd -f /etc/glusterfs/glusterfs-server.vol

[edit]

Client machine: [192.168.0.2]

$ mkdir /mnt/glusterfs
$ emacs /etc/glusterfs/glusterfs-client.vol
$ cat /etc/glusterfs/glusterfs-client.vol
volume client
  type protocol/client
  option transport-type tcp/client
  option remote-host 192.168.0.1
  option remote-subvolume brick
end-volume

$ modprobe fuse
$ glusterfs -f /etc/glusterfs/glusterfs-client.vol /mnt/glusterfs

You should now be able to see the exported directory '192.168.0.1:/tmp/export' as /mnt/glusterfs on the client machine :O

[edit]

Where to go from here

You can now refer to many other detailed volume spec file examples on the different ways that you can configure your GlusterFS cluster.

Refer to Install GlusterFS from Source page for checking details of installing from source.

Refer to GlusterFS Command-line Arguments for a complete list of options.

Refer to Mounting a GlusterFS Volume to see various ways of mounting a volume.

[edit]

When I run the glusterfs command, it exited normally, but I don't see the process running

There is more than one possible reason for what went wrong. Please refer to the glusterfs log file at /var/log/glusterfs/glusterfs*.log.

If you specified a prefix during installation, the log file may not be in /var/log/glusterfs/. Instead try looking in the prefix path you specified during installation for the log files. Otherwise, you can choose to run the glusterfs command with -l /dev/stdout to get the logs to display on screen when you run the command. Hope that was helpful.

[edit]

Refer

For more extensive documentation/details refer GlusterFS wiki.

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

Documentation Home

Retrieved from "http://gluster.org/community/documentation/index.php/Install_and_run_GlusterFS_v1.3_in_10mins"