[Cluster-devel] GFS2: Update main gfs2 doc

[Cluster-devel] GFS2: Update main gfs2 doc

[Steven Whitehouse]

From 49f30789fc33c4516fbe123f05ea4313866381d3 Mon Sep 17 00:00:00 2001
From: Steven Whitehouse <swhiteho@redhat.com>
Date: Thu, 10 May 2012 11:45:31 +0100
Subject: [PATCH 1/2] GFS2: Update main gfs2 doc

Various items were a bit out of date, so this is a refresh to the
latest info.

Signed-off-by: Steven Whitehouse <swhiteho@redhat.com>

diff --git a/Documentation/filesystems/gfs2.txt b/Documentation/filesystems/gfs2.txt
index 4cda926..cc4f230 100644
--- a/Documentation/filesystems/gfs2.txt
+++ b/Documentation/filesystems/gfs2.txt
@@ -1,7 +1,7 @@
 Global File System
 ------------------
 
-http://sources.redhat.com/cluster/wiki/
+https://fedorahosted.org/cluster/wiki/HomePage
 
 GFS is a cluster file system. It allows a cluster of computers to
 simultaneously use a block device that is shared between them (with FC,
@@ -30,7 +30,8 @@ needed, simply:
 
 If you are using Fedora, you need to install the gfs2-utils package
 and, for lock_dlm, you will also need to install the cman package
-and write a cluster.conf as per the documentation.
+and write a cluster.conf as per the documentation. For F17 and above
+cman has been replaced by the dlm package.
 
 GFS2 is not on-disk compatible with previous versions of GFS, but it
 is pretty close.
@@ -39,8 +40,6 @@ The following man pages can be found at the URL above:
   fsck.gfs2		to repair a filesystem
   gfs2_grow		to expand a filesystem online
   gfs2_jadd		to add journals to a filesystem online
-  gfs2_tool		to manipulate, examine and tune a filesystem
-  gfs2_quota	to examine and change quota values in a filesystem
+  tunegfs2		to manipulate, examine and tune a filesystem
   gfs2_convert	to convert a gfs filesystem to gfs2 in-place
-  mount.gfs2	to help mount(8) mount a filesystem
   mkfs.gfs2		to make a filesystem
-- 
1.7.4

[Cluster-devel] GFS2: Update main gfs2 doc

[Fabio M. Di Nitto]

On 5/10/2012 2:11 PM, Steven Whitehouse wrote:
>>From 49f30789fc33c4516fbe123f05ea4313866381d3 Mon Sep 17 00:00:00 2001
> From: Steven Whitehouse <swhiteho@redhat.com>
> Date: Thu, 10 May 2012 11:45:31 +0100
> Subject: [PATCH 1/2] GFS2: Update main gfs2 doc
> 
> Various items were a bit out of date, so this is a refresh to the
> latest info.
> 
> Signed-off-by: Steven Whitehouse <swhiteho@redhat.com>
> 
> diff --git a/Documentation/filesystems/gfs2.txt b/Documentation/filesystems/gfs2.txt
> index 4cda926..cc4f230 100644
> --- a/Documentation/filesystems/gfs2.txt
> +++ b/Documentation/filesystems/gfs2.txt
> @@ -1,7 +1,7 @@
>  Global File System
>  ------------------
>  
> -http://sources.redhat.com/cluster/wiki/
> +https://fedorahosted.org/cluster/wiki/HomePage
>  
>  GFS is a cluster file system. It allows a cluster of computers to
>  simultaneously use a block device that is shared between them (with FC,
> @@ -30,7 +30,8 @@ needed, simply:
>  
>  If you are using Fedora, you need to install the gfs2-utils package
>  and, for lock_dlm, you will also need to install the cman package
> -and write a cluster.conf as per the documentation.
> +and write a cluster.conf as per the documentation. For F17 and above
> +cman has been replaced by the dlm package.

^^^ cman has been replaced by corosync 2.0 (or higher) in combination
with votequorum provide (see votequorum.5).

gfs2 still requires dlm for it?s dependencies but it?s not a replacement.

Fabio

[Cluster-devel] GFS2: Update main gfs2 doc

[Steven Whitehouse]

Hi,

On Thu, 2012-05-10 at 15:09 +0200, Fabio M. Di Nitto wrote:
> On 5/10/2012 2:11 PM, Steven Whitehouse wrote:
> >>From 49f30789fc33c4516fbe123f05ea4313866381d3 Mon Sep 17 00:00:00 2001
> > From: Steven Whitehouse <swhiteho@redhat.com>
> > Date: Thu, 10 May 2012 11:45:31 +0100
> > Subject: [PATCH 1/2] GFS2: Update main gfs2 doc
> > 
> > Various items were a bit out of date, so this is a refresh to the
> > latest info.
> > 
> > Signed-off-by: Steven Whitehouse <swhiteho@redhat.com>
> > 
> > diff --git a/Documentation/filesystems/gfs2.txt b/Documentation/filesystems/gfs2.txt
> > index 4cda926..cc4f230 100644
> > --- a/Documentation/filesystems/gfs2.txt
> > +++ b/Documentation/filesystems/gfs2.txt
> > @@ -1,7 +1,7 @@
> >  Global File System
> >  ------------------
> >  
> > -http://sources.redhat.com/cluster/wiki/
> > +https://fedorahosted.org/cluster/wiki/HomePage
> >  
> >  GFS is a cluster file system. It allows a cluster of computers to
> >  simultaneously use a block device that is shared between them (with FC,
> > @@ -30,7 +30,8 @@ needed, simply:
> >  
> >  If you are using Fedora, you need to install the gfs2-utils package
> >  and, for lock_dlm, you will also need to install the cman package
> > -and write a cluster.conf as per the documentation.
> > +and write a cluster.conf as per the documentation. For F17 and above
> > +cman has been replaced by the dlm package.
> 
> ^^^ cman has been replaced by corosync 2.0 (or higher) in combination
> with votequorum provide (see votequorum.5).
> 
corosync was always a requirement though, it gets pulled in through the
deps

> gfs2 still requires dlm for it?s dependencies but it?s not a replacement.
> 
Well it is kind of, since thats where dlm_controld resides and that now
deals with all the recovery stuff now that gfs_controld is gone, so
maybe it could have been worded better, but it at least is correct in
terms of what needs to be installed package-wise,

Steve.

> Fabio
> 

[Cluster-devel] GFS2: Update main gfs2 doc

[Fabio M. Di Nitto]

On 5/10/2012 3:13 PM, Steven Whitehouse wrote:
> Hi,
> 
> On Thu, 2012-05-10 at 15:09 +0200, Fabio M. Di Nitto wrote:
>> On 5/10/2012 2:11 PM, Steven Whitehouse wrote:
>>> >From 49f30789fc33c4516fbe123f05ea4313866381d3 Mon Sep 17 00:00:00 2001
>>> From: Steven Whitehouse <swhiteho@redhat.com>
>>> Date: Thu, 10 May 2012 11:45:31 +0100
>>> Subject: [PATCH 1/2] GFS2: Update main gfs2 doc
>>>
>>> Various items were a bit out of date, so this is a refresh to the
>>> latest info.
>>>
>>> Signed-off-by: Steven Whitehouse <swhiteho@redhat.com>
>>>
>>> diff --git a/Documentation/filesystems/gfs2.txt b/Documentation/filesystems/gfs2.txt
>>> index 4cda926..cc4f230 100644
>>> --- a/Documentation/filesystems/gfs2.txt
>>> +++ b/Documentation/filesystems/gfs2.txt
>>> @@ -1,7 +1,7 @@
>>>  Global File System
>>>  ------------------
>>>  
>>> -http://sources.redhat.com/cluster/wiki/
>>> +https://fedorahosted.org/cluster/wiki/HomePage
>>>  
>>>  GFS is a cluster file system. It allows a cluster of computers to
>>>  simultaneously use a block device that is shared between them (with FC,
>>> @@ -30,7 +30,8 @@ needed, simply:
>>>  
>>>  If you are using Fedora, you need to install the gfs2-utils package
>>>  and, for lock_dlm, you will also need to install the cman package
>>> -and write a cluster.conf as per the documentation.
>>> +and write a cluster.conf as per the documentation. For F17 and above
>>> +cman has been replaced by the dlm package.
>>
>> ^^^ cman has been replaced by corosync 2.0 (or higher) in combination
>> with votequorum provide (see votequorum.5).
>>
> corosync was always a requirement though, it gets pulled in through the
> deps

No disagreement on the dependency here, but cman is not replaced by dlm
in terms of functionality, that would be incorrect.

> 
>> gfs2 still requires dlm for it?s dependencies but it?s not a replacement.
>>
> Well it is kind of, since thats where dlm_controld resides and that now
> deals with all the recovery stuff now that gfs_controld is gone, so
> maybe it could have been worded better, but it at least is correct in
> terms of what needs to be installed package-wise,

Right, package wise you are right, you install dlm and you get corosync
indirectly. I was only pointing out the functionality chain here vs
package chain.

It might be better to express both in a doc since the landscape has
changed substantially.

Fabio