glusterfs.git/doc/features, branch v3.7.16

common-ha: reliable grace using pacemaker notify actions

2016-02-26T11:00:38+00:00

Using *-dead_ip-1 resources to track on which nodes the ganesha.nfsd
had died was found to be unreliable.

Running `pcs status` in the ganesha_grace monitor action was seen to
time out during failover; the HA devs opined that it was, generally,
not a good idea to run `pcs status` in a monitor action in any event.
They suggested using the notify feature, where the resources on all
the nodes are notified when a clone resource agent dies.

This change adds a notify action to the ganesha_grace RA. The ganesha_mon
RA monitors its ganesha.nfsd daemon. While the daemon is running, it
creates two attributes: ganesha-active and grace-active. When the daemon
stops for any reason, the attributes are deleted. Deleting the
ganesha-active attribute triggers the failover of the virtual IP (the
IPaddr RA) to another node where ganesha.nfsd is still running. The
ganesha_grace RA monitors the grace-active attribute. When the
grace-active attibute is deleted, the ganesha_grace RA stops, and will
not restart. This triggers pacemaker to trigger the notify action in
the ganesha_grace RAs on the other nodes in the cluster; which send a
DBUS message to their ganesha.nfsd.

(N.B. grace-active is a bit of a misnomer. while the grace-active
attribute exists, everything is normal and healthy. Deleting the
attribute triggers putting the surviving ganesha.nfsds into GRACE.)

To ensure that the remaining/surviving ganesha.nfsds are put into
NFS-GRACE before the IPaddr (virtual IP) fails over there is a short
delay (sleep) between deleting the grace-active attribute and the
ganesha-active attribute. To summarize:
  1. on node 2 ganesha_mon:monitor notices that ganesha.nfsd has died
  2. on node 2 ganesha_mon:monitor deletes its grace-active attribute
  3. on node 2 ganesha_grace:monitor notices that grace-active is gone
     and returns OCF_ERR_GENERIC, a.k.a. new error. When pacemaker
     tries to (re)start ganesha_grace, its start action will return
     OCF_NOT_RUNNING, a.k.a. known error, don't attempt further
     restarts.
  4. on nodes 1, 3, etc., ganesha_grace:notify receives a post-stop
     notification indicating that node 2 is gone, and sends a DBUS
     message to its ganesha.nfsd putting it into NFS-GRACE.
  5. on node 2 ganesha_mon:monitor waits a short period, then deletes
     its ganesha-active attribute. This triggers the IPaddr (virt IP)
     failover according to constraint location rules.

ganesha_nfsd modified to run for the duration, start action is invoked
to setup the /var/lib/nfs symlink, stop action is invoked to restore it.
ganesha-ha.sh modified accordingly to create it as a clone resource.

Change-Id: Iad60b0c5222bbd55ef95c8b8f955e791caa3ffd0
BUG: 1290865
Signed-off-by: Kaleb S KEITHLEY 
Reviewed-on: http://review.gluster.org/12964
Smoke: Gluster Build System 
NetBSD-regression: NetBSD Build System 
CentOS-regression: Gluster Build System

cluster/afr : Prevent inode-evict during split-brain resolution

2015-05-09T08:54:56+00:00

        Backport of: http://review.gluster.org/#/c/10134/

1) Provided setfattr command to set timeout for split-brain
choice.

2) If split-brain inspection/resolution is being done
from the mount for a file, ref the inode when
split-brain-choice is set.
This inode will be unconditionally unref-ed after timeout
seconds set by the user/default otherwise.

3) Updated the doc and testcase to reflect the changes.

Change-Id: I15c9037dee28855f21e680e7e3632e1f48dba4e1
BUG: 1219388
Reviewed-on: http://review.gluster.org/10134
Reviewed-by: Krutika Dhananjay 
Reviewed-by: Ravishankar N 
Tested-by: Gluster Build System 
Reviewed-by: Pranith Kumar Karampuri 
Signed-off-by: Anuradha 
Reviewed-on: http://review.gluster.org/10679

tiering: Correction to tiering documentation

2015-05-09T07:10:41+00:00

1) convert to md format
2) Add info about ctr and libgfdb 

Change-Id: I531d8a0bff8195f759302c5e613c7af2113729eb
BUG: 1218638
Signed-off-by: Joseph Fernandes 
Reviewed-on: http://review.gluster.org/10665
Reviewed-by: Humble Devassy Chirammal 
Tested-by: Humble Devassy Chirammal 
(cherry picked from commit 9c21c5a632ba22a6f46d037bd4fa4d825b24d07f)
Reviewed-on: http://review.gluster.org/10669
Tested-by: Gluster Build System 
Tested-by: NetBSD Build System

doc: Feature doc for shard translator

2015-05-07T02:34:25+00:00

        Backport of: http://review.gluster.org/10537

Source: https://gist.github.com/avati/af04f1030dcf52e16535#sharding-xlator-stripe-20

Change-Id: Ibd29b99ab702dc60c50d7fe0eda36e27b4941f89
BUG: 1218475 
Signed-off-by: Krutika Dhananjay 
Reviewed-on: http://review.gluster.org/10538
Reviewed-by: Humble Devassy Chirammal 
Tested-by: Humble Devassy Chirammal

doc: AFR arbiter volume usage

2015-05-06T13:11:36+00:00

Backport of http://review.gluster.org/#/c/10541/

Contains information on creation and behaviour of replica 3 arbiter volumes.
Signed-off-by: Ravishankar N  

Change-Id: I6af4aa3488649686fdb9b839c733046160e0785b
BUG: 1217689
Reviewed-on: http://review.gluster.org/10542
Reviewed-by: Humble Devassy Chirammal 
Tested-by: Humble Devassy Chirammal

Upcall: Feature doc for Upcall infrastrucutre

2015-05-04T18:18:28+00:00

Change-Id: I802ba2f13fde6c05da1ed355e340f071e9d20d30
BUG: 1217711
Signed-off-by: Soumya Koduri 
Reviewed-on: http://review.gluster.org/10525
Reviewed-by: Kaleb KEITHLEY 
Reviewed-on: http://review.gluster.org/10527
Tested-by: NetBSD Build System
Tested-by: Gluster Build System

admin/doc : Object count for quota

2015-04-14T04:16:58+00:00

Change-Id: I271cca911f6dd1f481634063919a587843d93e50
BUG: 1190108
Signed-off-by: Sachin Pandit 
Reviewed-on: http://review.gluster.org/10171
Reviewed-by: Vijaikumar Mallikarjuna 
Tested-by: Gluster Build System 
Reviewed-by: Kaleb KEITHLEY

doc : pNFS support for gluster volumes

2015-04-13T10:48:52+00:00

Change-Id: I910f8f786849b4ece3d3c258c2c52537edc173dd
BUG: 1209380
Signed-off-by: Jiffin Tony Thottan 
Reviewed-on: http://review.gluster.org/10145
Reviewed-by: Kaleb KEITHLEY 
Reviewed-by: soumya k 
Reviewed-by: Humble Devassy Chirammal 
Tested-by: Humble Devassy Chirammal

doc : GlusterFS NFS-ganesha integration

2015-04-08T05:07:00+00:00

Change-Id: Ie18df44d32125afcc750e1f0f2c4728aa2d93699
BUG: 1209380
Signed-off-by: Jiffin Tony Thottan 
Reviewed-on: http://review.gluster.org/10151
Reviewed-by: Humble Devassy Chirammal 
Tested-by: Gluster Build System 
Reviewed-by: Kaleb KEITHLEY

doc: Fix Jeff Darcy's links in docs

2015-03-30T12:30:18+00:00

Change-Id: I4bc859662088a55fe70714feb3c47ed02ad08e94
BUG: 1206539
Signed-off-by: Saravanakumar Arumugam 
Reviewed-on: http://review.gluster.org/10041
Tested-by: Gluster Build System 
Reviewed-by: Kaleb KEITHLEY