glusterfs-snapshot.git/doc/admin-guide, branch development

Snapshot: Admin guide for snapshot management

2014-02-18T09:09:06+00:00

Admin guide for snapshot management. Provide details of snapshot cli.

Change-Id: I83cf082a8e2c1546d8fcac2e9b234e236024220a
Signed-off-by: Rajesh Joseph 
Reviewed-on: http://review.gluster.org/7027
Reviewed-by: Sachin Pandit

doc: Drop corrupted and unused file

2013-08-04T14:35:32+00:00

Change-Id: Ib220f9264ac941e87a9eb0998775a1b5507c510f
Signed-off-by: Lubomir Rintel 
Reviewed-on: http://review.gluster.org/5478
Reviewed-by: Vijay Bellur 
Tested-by: Vijay Bellur

doc: Get rid of weird quoting

2013-08-04T14:34:41+00:00

pandoc: Error producing PDF from TeX source.
! Package inputenc Error: Unicode char \u8:‟ not set up for use with LaTeX.

See the inputenc package documentation for explanation.
Type  H   for immediate help.
 ...

l.6216 ... the objects access rights to "public‟

Change-Id: I23428930d167064b7c5790eea09daedbef06153a
Signed-off-by: Lubomir Rintel 
Reviewed-on: http://review.gluster.org/5477
Reviewed-by: Vijay Bellur 
Tested-by: Vijay Bellur

doc: Rename architectural diagram

2013-08-04T14:33:58+00:00

It should not be specific to old gluster version anyway and the dot in name
causes trouble to pandoc/LaTeX:

pandoc: Error producing PDF from TeX source.
! LaTeX Error: Unknown graphics extension: .2_Architecture.png.

See the LaTeX manual or LaTeX Companion for explanation.
Type  H   for immediate help.
 ...

l.98 ...ages/640px-GlusterFS_3.2_Architecture.png}

Change-Id: I9d222a1628e1c14b004c059733fabd7b70c86f26
Signed-off-by: Lubomir Rintel 
Reviewed-on: http://review.gluster.org/5476
Reviewed-by: Vijay Bellur 
Tested-by: Vijay Bellur

nfs: AUTH support for exported sub-directories

2013-07-10T05:55:12+00:00

Problem: NFS allows exporting subdirectories but there is not support for
providing AUTH on per directory basis.

Fix: Modified nfs.export-dir to include AUTH parameters
 e.g. nfs.export-dir "/dir1(10.1.1.2),/dir2(10.1.1.0/24|host1)

During mount operation NFS will check if the IP from where the connection is made
is configured in the AUTH parameter, else the mount operation will fail with
EACCES error.

Updated admin-guide and volume set help message.

Change-Id: I5c6d22edb168b4f46376d1cd6878cd065fc081cc
BUG: 968227
Signed-off-by: Rajesh Joseph 
Reviewed-on: http://review.gluster.org/5124
Tested-by: Gluster Build System 
Reviewed-by: Vijay Bellur

doc: Moved non-relevant documentation files to legacy

2013-07-09T06:58:36+00:00

Change-Id: I2d34e5a4e47cd03d301d9fd2525fb61ae997fcb8
BUG: 811311
Signed-off-by: Vijay Bellur 
Reviewed-on: http://review.gluster.org/5277
Tested-by: Gluster Build System

posix: add a simple health-checker

2013-07-04T05:34:54+00:00

Goal of this health-checker is to detect fatal issues of the underlying
storage that is used for exporting a brick. The current implementation
requires the filesystem to detect the storage error, after which it will
notify the parent xlators and exit the glusterfsd (brick) process to
prevent further troubles.

The interval the health-check runs can be configured per volume with the
storage.health-check-interval option. The default interval is 30
seconds.

It is not trivial to write an automated test-case with the current
prove-framework. These are the manual steps that can be done to verify
the functionality:

- setup a Logical Volume (/dev/bz970960/xfs) and format is as XFS for
  brick usage

- create a volume with the one brick

    # gluster volume create failing_xfs glufs1:/bricks/failing_xfs/data
    # gluster volume start failing_xfs

- mount the volume and verify the functionality

- make the storage fail (use device-mapper, or pull disks)

    # dmsetup table
    ..
    bz970960-xfs: 0 196608 linear 7:0 2048

    # echo 0  196608 error > dmsetup-error-target
    # dmsetup load bz970960-xfs dmsetup-error-target
    # dmsetup resume bz970960-xfs

    # dmsetup table
    ...
    bz970960-xfs: 0 196608 error

- notice the errors caught by syslog:

    Jun 24 11:31:49 vm130-32 kernel: XFS (dm-2): metadata I/O error: block 0x0 ("xfs_buf_iodone_callbacks") error 5 buf count 512
    Jun 24 11:31:49 vm130-32 kernel: XFS (dm-2): I/O Error Detected. Shutting down filesystem
    Jun 24 11:31:49 vm130-32 kernel: XFS (dm-2): Please umount the filesystem and rectify the problem(s)
    Jun 24 11:31:49 vm130-32 kernel: VFS:Filesystem freeze failed
    Jun 24 11:31:50 vm130-32 GlusterFS[1969]: [2013-06-24 10:31:50.500674] M [posix-helpers.c:1114:posix_health_check_thread_proc] 0-failing_xfs-posix: health-check failed, going down
    Jun 24 11:32:09 vm130-32 kernel: XFS (dm-2): xfs_log_force: error 5 returned.
    Jun 24 11:32:20 vm130-32 GlusterFS[1969]: [2013-06-24 10:32:20.508690] M [posix-helpers.c:1119:posix_health_check_thread_proc] 0-failing_xfs-posix: still alive! -> SIGTERM

- these errors are in the log of the brick as well:

    [2013-06-24 10:31:50.500607] W [posix-helpers.c:1102:posix_health_check_thread_proc] 0-failing_xfs-posix: stat() on /bricks/failing_xfs/data returned: Input/output error
    [2013-06-24 10:31:50.500674] M [posix-helpers.c:1114:posix_health_check_thread_proc] 0-failing_xfs-posix: health-check failed, going down
    [2013-06-24 10:32:20.508690] M [posix-helpers.c:1119:posix_health_check_thread_proc] 0-failing_xfs-posix: still alive! -> SIGTERM

- the glusterfsd process has exited correctly:

    # gluster volume status
    Status of volume: failing_xfs
    Gluster process						Port	Online	Pid
    ------------------------------------------------------------------------------
    Brick glufs1:/bricks/failing_xfs/data			N/A	N	N/A
    NFS Server on localhost					2049	Y	1897

Change-Id: Ic247fbefb97f7e861307a5998a9a7a3ecc80aa07
BUG: 971774
Signed-off-by: Niels de Vos 
Reviewed-on: http://review.gluster.org/5176
Tested-by: Gluster Build System 
Reviewed-by: Vijay Bellur

cluster/afr: Provide an option to disable afr durability

2013-07-03T14:33:13+00:00

Change-Id: I40eec20ca6b3f857245a2438883822e251077ee9
BUG: 979365
Signed-off-by: Pranith Kumar K 
Reviewed-on: http://review.gluster.org/5269
Tested-by: Gluster Build System 
Reviewed-by: Vijay Bellur

doc: Move admin-guide to markdown format.

2013-06-25T17:36:45+00:00

Editing markdown is probably more easier than xml.

pandoc can then be used for conversion to html, pdf and any other necessary
formats. Note that pandoc has the following input and output formats:

Input: markdown and (subsets of) Textile, reStructuredText, HTML, LaTeX, and
DocBook XML.

Output:plain text, markdown, reStructuredText, XHTML,  HTML  5,  LaTeX
(including beamer slide shows), ConTeXt, RTF, DocBook XML, OpenDocument XML,
ODT, Word docx, GNU Texinfo, MediaWiki markup, EPUB, Textile, groff man pages,
Emacs Org-Mode, AsciiDoc, and Slidy, Slideous, DZSlides, or S5 HTML slide shows.
It can also  pro‐ duce PDF output on systems where LaTeX is installed.

All documentation changes can be submitted as changes to markdown and we can
attempt a periodic documentation refresh on gluster.org.

Change-Id: I5dcf7f79184cd6b6d62ce7065d2faa352622f6ac
Reviewed-on: http://review.gluster.org/5232
Reviewed-by: Kaleb KEITHLEY 
Reviewed-by: Krishnan Parthasarathi 
Reviewed-by: Anand Avati 
Tested-by: Anand Avati

Fix docs to reflect change in GLUSTERD_DEFAULT_WORKDIR

2012-10-05T16:52:51+00:00

Change-Id: I8ee98cece7a3c4ccdc4c444ff755fba37c75f169
BUG: 859849
Signed-off-by: Kacper Kowalik (Xarthisius) 
Reviewed-on: http://review.gluster.org/3970
Tested-by: Gluster Build System 
Reviewed-by: Vijay Bellur