templates://redhat-cluster/{cman.templates}
 

Please find, for review, the debconf templates and packages descriptions for the redhat-cluster source package.

This review will last from Monday, January 07, 2008 to Thursday, January 17, 2008.

Please send reviews as unified diffs (diff -u) against the original
files. Comments about your proposed changes will be appreciated.

Your review should be sent as an answer to this mail.

When appropriate, I will send intermediate requests for review, with
"[RFRn]" (n>=2) as a subject tag.

When we will reach a consensus, I send a "Last Chance For
Comments" mail with "[LCFC]" as a subject tag.

Finally, the reviewed templates will be sent to the package maintainer
as a bug report, and a mail will be sent to this list with "[BTS]" as
a subject tag.

Rationale:
--- ../redhat-cluster.old/debian/cman.templates 2007-12-29 08:26:58.922223775 +0100
+++ debian/cman.templates 2008-01-03 07:56:10.855302148 +0100
@@ -1,14 +1,11 @@
Template: cman/upgrade-warning
Type: boolean
Default: false
-_Description: Do you want to abort now?
+_Description: Abort the potentially disruptive upgrade of Red Hat Cluster Suite?


"Abort what" would be the question. So, better explain.

The new version 2.0 of the Red Hat Cluster Suite is not compatible with
the currently installed one. Upgrading these packages without stopping
- the complete cluster can cause filesystem corruption on shared storage
+ the complete cluster can cause file system corruption on shared storage
devices.

Most packages (including D-I) standardized on "file system".

.
For instructions on how to safely upgrade the Red Hat Cluster Suite to
- version 2.0, please refer to the following document:
- .
- http://wiki.debian.org/UpgradeRHCSV1toV2
- .
+ version 2.0, please refer to http://wiki.debian.org/UpgradeRHCSV1toV2.

No need to split this in two paragraphs.


--- ../redhat-cluster.old/debian/control 2007-12-29 08:26:58.922223775 +0100
+++ debian/control 2008-01-03 08:21:03.343791119 +0100
@@ -12,7 +12,7 @@
Priority: optional
Architecture: all
Depends: cman, gfs-tools, gfs2-tools, rgmanager, clvm
-Description: Red Hat cluster suite (meta package)
+Description: Red Hat cluster suite - meta package

Standard "common description - specific description" format


The only scope for this package is to install the full Red Hat Cluster Suite
in one shot. It is safe to remove it.

I think that ALL packages are missing a common paragraph describing
*what* Redhat cluster suite is..... Anyone feeling like proposing one?


@@ -23,54 +23,62 @@
Depends: ${shlibs:Depends}, python, openais (>= 0.82-2)
Conflicts: magma, libmagma1, libmagma-dev, ccs, fence, libiddev-dev, fence-gnbd, gulm, libgulm1, libgulm-dev, magma-plugins
Replaces: ccs, fence, fence-gnbd
-Description: cluster manager
+Description: Red Hat cluster suite - cluster manager
CMAN is a symmetric general-purpose cluster manager. It consists of
a connection manager that handles cluster membership management,
messaging among the cluster nodes, event notification, quorum and
state transitions. Another part of CMAN is a service manager that
handles service groups.
.
- This package contains only userspace tools for controlling the actual
+ This package provides only userspace tools for controlling the
cluster manager.

"actual"? Is there any need for that word?

Package: libcman2
Section: libs
Architecture: any
Depends: ${shlibs:Depends}
-Description: cluster manager - libraries
- cman provides a general purpose, openais based, cluster manager.
+Description: Red Hat cluster suite - cluster manager libraries
+ CMAN is a symmetric general-purpose cluster manager. It consists of
+ a connection manager that handles cluster membership management,
+ messaging among the cluster nodes, event notification, quorum and
+ state transitions. Another part of CMAN is a service manager that
+ handles service groups.

Common with the former package.

.
- This package contains the client libraries.
+ This package provides the client libraries.

Standardize on "this package provides"

Package: libcman-dev
Section: libdevel
Architecture: any
Depends: libcman2 (= ${binary:Version})
-Description: cluster manager - development files
- cman provides a general purpose, openais based, cluster manager.
+Description: Red Hat cluster suite - cluster manager development files
+ CMAN is a symmetric general-purpose cluster manager. It consists of
+ a connection manager that handles cluster membership management,
+ messaging among the cluster nodes, event notification, quorum and
+ state transitions. Another part of CMAN is a service manager that
+ handles service groups.
.
- This package contains the files needed for developing applications.
+ This package provides the files needed for developing applications.

Ditto. Similar changes follow all along

@@ -142,6 +150,6 @@
Architecture: all
Depends: bzip2
Description: Red Hat cluster suite - kernel modules source
- This package contains the source necessary for compiling the Red Hat
+ This package provides the source necessary for compiling the Red Hat
cluster suite out-of-tree kernel modules gfs and gnbd against the
- linux tree.
+ Linux kernel source tree.

"linux tree" is incorrect, imho. That's the Linux kernel source tree,
I think

--


Template: cman/upgrade-warning
Type: boolean
Default: false
_Description: Abort the potentially disruptive upgrade of Red Hat Cluster Suite?
The new version 2.0 of the Red Hat Cluster Suite is not compatible with
the currently installed one. Upgrading these packages without stopping
the complete cluster can cause file system corruption on shared storage
devices.
.
For instructions on how to safely upgrade the Red Hat Cluster Suite to
version 2.0, please refer to http://wiki.debian.org/UpgradeRHCSV1toV2.
--- redhat-cluster.old/debian/cman.templates 2007-12-29 08:26:58.922223775 +0100
+++ redhat-cluster/debian/cman.templates 2008-01-03 07:56:10.855302148 +0100
@@ -1,14 +1,11 @@
Template: cman/upgrade-warning
Type: boolean
Default: false
-_Description: Do you want to abort now?
+_Description: Abort the potentially disruptive upgrade of Red Hat Cluster Suite?
The new version 2.0 of the Red Hat Cluster Suite is not compatible with
the currently installed one. Upgrading these packages without stopping
- the complete cluster can cause filesystem corruption on shared storage
+ the complete cluster can cause file system corruption on shared storage
devices.
.
For instructions on how to safely upgrade the Red Hat Cluster Suite to
- version 2.0, please refer to the following document:
- .
- http://wiki.debian.org/UpgradeRHCSV1toV2
- .
+ version 2.0, please refer to http://wiki.debian.org/UpgradeRHCSV1toV2.
--- redhat-cluster.old/debian/control 2007-12-29 08:26:58.922223775 +0100
+++ redhat-cluster/debian/control 2008-01-07 07:28:01.759879277 +0100
@@ -12,7 +12,7 @@
Priority: optional
Architecture: all
Depends: cman, gfs-tools, gfs2-tools, rgmanager, clvm
-Description: Red Hat cluster suite (meta package)
+Description: Red Hat cluster suite - meta package
The only scope for this package is to install the full Red Hat Cluster Suite
in one shot. It is safe to remove it.

@@ -23,54 +23,62 @@
Depends: ${shlibs:Depends}, python, openais (>= 0.82-2)
Conflicts: magma, libmagma1, libmagma-dev, ccs, fence, libiddev-dev, fence-gnbd, gulm, libgulm1, libgulm-dev, magma-plugins
Replaces: ccs, fence, fence-gnbd
-Description: cluster manager
+Description: Red Hat cluster suite - cluster manager
CMAN is a symmetric general-purpose cluster manager. It consists of
a connection manager that handles cluster membership management,
messaging among the cluster nodes, event notification, quorum and
state transitions. Another part of CMAN is a service manager that
handles service groups.
.
- This package contains only userspace tools for controlling the actual
+ This package provides only userspace tools for controlling the
cluster manager.

Package: libcman2
Section: libs
Architecture: any
Depends: ${shlibs:Depends}
-Description: cluster manager - libraries
- cman provides a general purpose, openais based, cluster manager.
+Description: Red Hat cluster suite - cluster manager libraries
+ CMAN is a symmetric general-purpose cluster manager. It consists of
+ a connection manager that handles cluster membership management,
+ messaging among the cluster nodes, event notification, quorum and
+ state transitions. Another part of CMAN is a service manager that
+ handles service groups.
.
- This package contains the client libraries.
+ This package provides the client libraries.

Package: libcman-dev
Section: libdevel
Architecture: any
Depends: libcman2 (= ${binary:Version})
-Description: cluster manager - development files
- cman provides a general purpose, openais based, cluster manager.
+Description: Red Hat cluster suite - cluster manager development files
+ CMAN is a symmetric general-purpose cluster manager. It consists of
+ a connection manager that handles cluster membership management,
+ messaging among the cluster nodes, event notification, quorum and
+ state transitions. Another part of CMAN is a service manager that
+ handles service groups.
.
- This package contains the files needed for developing applications.
+ This package provides the files needed for developing applications.

Package: libdlm2
Section: libs
Architecture: any
Depends: ${shlibs:Depends}
-Description: distributed lock manager - library
+Description: Red Hat cluster suite - distributed lock manager library
DLM is a symmetric general-purpose distributed lock manager. It is
used for example by GFS and the distributed volume manager.
.
- This is the client library for applications using the lock manager.
- The lock manager itself is a kernel module.
+ This package provides a client library for applications using the
+ lock manager. The lock manager itself is a kernel module.

Package: libdlm-dev
Section: libdevel
Architecture: any
Depends: libdlm2 (= ${binary:Version})
-Description: distributed lock manager - development files
+Description: Red Hat cluster suite - distributed lock manager development files
DLM is a symmetric general-purpose distributed lock manager. It is
used for example by GFS and the distributed volume manager.
.
- This package contains the files needed for developing applications
+ This package provides the files needed for developing applications
that use the lock manager.

Package: gfs-tools
@@ -78,13 +86,13 @@
Depends: ${shlibs:Depends}, psmisc, gfs2-tools
Recommends: redhat-cluster-modules
Section: admin
-Description: global file system tools
+Description: Red Hat cluster suite - global file system tools
The Global File System allows a cluster of machines to concurrently access
shared storage hardware like SANs or iSCSI and network block devices. GFS
can be deployed to build high available services without the single point
of failure a file server would be.
.
- This package contains userspace tools for creating and managing global
+ This package provides userspace tools for creating and managing global
file systems. GFS itself is a set of kernel modules.
.
Note: the package requires gfs2-tools installed and it's known to work fine
@@ -95,13 +103,13 @@
Architecture: any
Depends: ${shlibs:Depends}, psmisc
Section: admin
-Description: global file system 2 tools (EXPERIMENTAL)
+Description: Red Hat cluster suite - global file system 2 tools
The Global File System 2 allows a cluster of machines to concurrently access
shared storage hardware like SANs or iSCSI and network block devices. GFS
can be deployed to build high available services without the single point
of failure a file server would be.
.
- This package contains userspace tools for creating and managing global
+ This package provides userspace tools for creating and managing global
file systems. GFS2 itself is a set of kernel modules.
.
GFS2 *MUST NOT* be used in production enviroment yet.
@@ -111,30 +119,30 @@
Architecture: any
Depends: ${shlibs:Depends}
Recommends: fence-gnbd (= ${binary:Version}), redhat-cluster-modules
-Description: global network block device - client tools
+Description: Red Hat cluster suite - global network block device client tools
GNBD allows to use block devices over the network. It is a modified
version of the linux network block device for the use within a cluster
environment.
.
- This package contains userspace tools for running GNBD clients.
+ This package provides userspace tools for running GNBD clients.

Package: gnbd-server
Section: admin
Architecture: any
Depends: ${shlibs:Depends}
Recommends: fence-gnbd (= ${binary:Version})
-Description: global network block device - server tools
+Description: Red Hat cluster suite - global network block device server tools
GNBD allows to use block devices over the network. It is a modified
version of the linux network block device for the use within a cluster
environment.
.
- This package contains userspace tools for running GNBD servers.
+ This package provides userspace tools for running GNBD servers.

Package: rgmanager
Architecture: any
Depends: ${shlibs:Depends}, cman (= ${binary:Version}), iproute, iputils-arping, iputils-ping, nfs-kernel-server, nfs-common
Conflicts: nfs-user-server
-Description: clustered resource group manager
+Description: Red Hat cluster suite - clustered resource group manager
Resource Group Manager provides high availability of critical server
applications in the event of planned or unplanned system downtime.

@@ -142,6 +150,6 @@
Architecture: all
Depends: bzip2
Description: Red Hat cluster suite - kernel modules source
- This package contains the source necessary for compiling the Red Hat
+ This package provides the source necessary for compiling the Red Hat
cluster suite out-of-tree kernel modules gfs and gnbd against the
- linux tree.
+ Linux kernel source tree.
Source: redhat-cluster
Section: admin
Priority: optional
Maintainer: Debian Kernel Team <debian-kernel@lists.debian.org>
Uploaders: Bastian Blank <waldi@debian.org>, Frederik Schüler <fs@debian.org>
Standards-Version: 3.7.3.0
Build-Depends: dpatch, debhelper (>= 4.2.28), libxml2-dev, libncurses5-dev, libopenais-dev (>= 0.82-2), libvolume-id-dev (>= 0.105-4), linux-libc-dev (>= 2.6.22-6), libvirt-dev (>= 0.3.0) [amd64 i386], libnss3-dev [amd64 i386], libnspr4-dev [amd64 i386], bzip2, libslang2-dev
Build-Conflicts: libccs-dev, libcman-dev (<= 2.0), libdlm-dev (<= 2.0), libcman2, libdlm2

Package: redhat-cluster-suite
Section: admin
Priority: optional
Architecture: all
Depends: cman, gfs-tools, gfs2-tools, rgmanager, clvm
Description: Red Hat cluster suite - meta package
The only scope for this package is to install the full Red Hat Cluster Suite
in one shot. It is safe to remove it.

Package: cman
Architecture: any
Section: admin
Pre-Depends: debconf | debconf-2.0
Depends: ${shlibs:Depends}, python, openais (>= 0.82-2)
Conflicts: magma, libmagma1, libmagma-dev, ccs, fence, libiddev-dev, fence-gnbd, gulm, libgulm1, libgulm-dev, magma-plugins
Replaces: ccs, fence, fence-gnbd
Description: Red Hat cluster suite - cluster manager
CMAN is a symmetric general-purpose cluster manager. It consists of
a connection manager that handles cluster membership management,
messaging among the cluster nodes, event notification, quorum and
state transitions. Another part of CMAN is a service manager that
handles service groups.
.
This package provides only userspace tools for controlling the
cluster manager.

Package: libcman2
Section: libs
Architecture: any
Depends: ${shlibs:Depends}
Description: Red Hat cluster suite - cluster manager libraries
CMAN is a symmetric general-purpose cluster manager. It consists of
a connection manager that handles cluster membership management,
messaging among the cluster nodes, event notification, quorum and
state transitions. Another part of CMAN is a service manager that
handles service groups.
.
This package provides the client libraries.

Package: libcman-dev
Section: libdevel
Architecture: any
Depends: libcman2 (= ${binary:Version})
Description: Red Hat cluster suite - cluster manager development files
CMAN is a symmetric general-purpose cluster manager. It consists of
a connection manager that handles cluster membership management,
messaging among the cluster nodes, event notification, quorum and
state transitions. Another part of CMAN is a service manager that
handles service groups.
.
This package provides the files needed for developing applications.

Package: libdlm2
Section: libs
Architecture: any
Depends: ${shlibs:Depends}
Description: Red Hat cluster suite - distributed lock manager library
DLM is a symmetric general-purpose distributed lock manager. It is
used for example by GFS and the distributed volume manager.
.
This package provides a client library for applications using the
lock manager. The lock manager itself is a kernel module.

Package: libdlm-dev
Section: libdevel
Architecture: any
Depends: libdlm2 (= ${binary:Version})
Description: Red Hat cluster suite - distributed lock manager development files
DLM is a symmetric general-purpose distributed lock manager. It is
used for example by GFS and the distributed volume manager.
.
This package provides the files needed for developing applications
that use the lock manager.

Package: gfs-tools
Architecture: any
Depends: ${shlibs:Depends}, psmisc, gfs2-tools
Recommends: redhat-cluster-modules
Section: admin
Description: Red Hat cluster suite - global file system tools
The Global File System allows a cluster of machines to concurrently access
shared storage hardware like SANs or iSCSI and network block devices. GFS
can be deployed to build high available services without the single point
of failure a file server would be.
.
This package provides userspace tools for creating and managing global
file systems. GFS itself is a set of kernel modules.
.
Note: the package requires gfs2-tools installed and it's known to work fine
even if GFS2 is highly experimental and *MUST NOT* be used in production
enviroment yet.

Package: gfs2-tools
Architecture: any
Depends: ${shlibs:Depends}, psmisc
Section: admin
Description: Red Hat cluster suite - global file system 2 tools
The Global File System 2 allows a cluster of machines to concurrently access
shared storage hardware like SANs or iSCSI and network block devices. GFS
can be deployed to build high available services without the single point
of failure a file server would be.
.
This package provides userspace tools for creating and managing global
file systems. GFS2 itself is a set of kernel modules.
.
GFS2 *MUST NOT* be used in production enviroment yet.

Package: gnbd-client
Section: admin
Architecture: any
Depends: ${shlibs:Depends}
Recommends: fence-gnbd (= ${binary:Version}), redhat-cluster-modules
Description: Red Hat cluster suite - global network block device client tools
GNBD allows to use block devices over the network. It is a modified
version of the linux network block device for the use within a cluster
environment.
.
This package provides userspace tools for running GNBD clients.

Package: gnbd-server
Section: admin
Architecture: any
Depends: ${shlibs:Depends}
Recommends: fence-gnbd (= ${binary:Version})
Description: Red Hat cluster suite - global network block device server tools
GNBD allows to use block devices over the network. It is a modified
version of the linux network block device for the use within a cluster
environment.
.
This package provides userspace tools for running GNBD servers.

Package: rgmanager
Architecture: any
Depends: ${shlibs:Depends}, cman (= ${binary:Version}), iproute, iputils-arping, iputils-ping, nfs-kernel-server, nfs-common
Conflicts: nfs-user-server
Description: Red Hat cluster suite - clustered resource group manager
Resource Group Manager provides high availability of critical server
applications in the event of planned or unplanned system downtime.

Package: redhat-cluster-source
Architecture: all
Depends: bzip2
Description: Red Hat cluster suite - kernel modules source
This package provides the source necessary for compiling the Red Hat
cluster suite out-of-tree kernel modules gfs and gnbd against the
Linux kernel source tree.

templates://redhat-cluster/{cman.templates}
 

Christian Perrier wrote:
> Your review should be sent as an answer to this mail.

> Template: cman/upgrade-warning
[...]
> + version 2.0, please refer to http://wiki.debian.org/UpgradeRHCSV1toV2.

Just in case people cut and paste it including the punctuation:

version 2.0, please refer to "http://wiki.debian.org/UpgradeRHCSV1toV2".

> Package: redhat-cluster-suite
[...]
> I think that ALL packages are missing a common paragraph describing
> *what* Redhat cluster suite is..... Anyone feeling like proposing one?

It would have to be something like:

This package is part of the Red Hat Cluster Suite, a complete
high-availability solution.

(stitched together from a redhat.com blurb), but this is a bit
inadequate, so I haven't included it in my patch.

> Package: cman
[...]
> +Description: Red Hat cluster suite - cluster manager
> CMAN is a symmetric general-purpose cluster manager. It consists of
> a connection manager that handles cluster membership management,
> messaging among the cluster nodes, event notification, quorum and
> state transitions. Another part of CMAN is a service manager that
> handles service groups.

This boils down to "It consists of (a), which does foo, bar and baz.
P.S.: there's also a (b)." It's simpler to explain (b) first:

CMAN is a symmetric general-purpose cluster manager. It provides a
service manager that handles service groups, plus a connection manager
that handles cluster membership management, messaging among the
cluster nodes, event notification, quorum and state transitions.

I don't quite follow the foo-bar-baz bit, though. It seems to be:

a connection manager that handles
- cluster membership management,
- messaging among the cluster nodes,
- event notification,
- quorum
and
- state transitions.

But what does it mean to say that it "handles [...] quorum"?

> - This package contains only userspace tools for controlling the actual
> + This package provides only userspace tools for controlling the
> cluster manager.
>
> "actual"? Is there any need for that word?

It's mildly informal; try "the cluster manager itself"?

> Package: redhat-cluster-source
[...]
> + This package provides the source necessary for compiling the Red Hat
> cluster suite out-of-tree kernel modules gfs and gnbd against the
> - linux tree.
> + Linux kernel source tree.
>
> "linux tree" is incorrect, imho. That's the Linux kernel source tree,
> I think

RHCS isn't Section: devel, so it would be good if it could avoid
this jargon - only dogs and programmers do things against trees.
Unfortunately I'm not confident I can translate "compiling an
out-of-tree module against a source tree" into English...

Then some other package descriptions have odd glitches:

Package: gfs-tools
[...]
The Global File System allows a cluster of machines to concurrently access
shared storage hardware like SANs or iSCSI and network block devices. GFS
- can be deployed to build high available services without the single point
- of failure a file server would be.
+ can be deployed to build high-availability services without the single point
+ of failure of a file server.

(Ditto in gfs2-tools)

- Note: the package requires gfs2-tools installed and it's known to work fine
- even if GFS2 is highly experimental and *MUST NOT* be used in production
- enviroment yet.
+ Note: the package requires gfs2-tools installed; this is known to be
+ reliable even though the GFS2 kernel modules themselves are highly
+ experimental and *MUST NOT* be used in a production enviroment yet.

Package: gfs2-tools
[...]
This package contains userspace tools for creating and managing global
- file systems. GFS2 itself is a set of kernel modules.
+ file systems.
.
- GFS2 *MUST NOT* be used in production enviroment yet.
+ The GFS2 kernel modules themselves are highly experimental and *MUST NOT*
+ be used in a production enviroment yet.

(Phrased to match gfs-tools above)

Package: gnbd-client
[...]
- GNBD allows to use block devices over the network. It is a modified
- version of the linux network block device for the use within a cluster
- environment.
+ GNBD allows block devices to be used over the network. It is a modified
+ version of the Linux network block device for use within a cluster environment.

(And likewise for gnbd-server.) Sometimes I think we should just
outlaw the use of the word "allow" outside of license texts.
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
--- ../redhat-cluster.old/debian/cman.templates 2007-12-29 22:14:58.000000000 +0000
+++ debian/cman.templates 2008-01-07 23:24:23.000000000 +0000
@@ -1,14 +1,11 @@
Template: cman/upgrade-warning
Type: boolean
Default: false
-_Description: Do you want to abort now?
+_Description: Abort the potentially disruptive upgrade of Red Hat Cluster Suite?
The new version 2.0 of the Red Hat Cluster Suite is not compatible with
the currently installed one. Upgrading these packages without stopping
- the complete cluster can cause filesystem corruption on shared storage
+ the complete cluster can cause file system corruption on shared storage
devices.
.
For instructions on how to safely upgrade the Red Hat Cluster Suite to
- version 2.0, please refer to the following document:
- .
- http://wiki.debian.org/UpgradeRHCSV1toV2
- .
+ version 2.0, please refer to "http://wiki.debian.org/UpgradeRHCSV1toV2".
--- ../redhat-cluster.old/debian/control 2007-12-29 22:15:00.000000000 +0000
+++ debian/control 2008-01-07 23:42:46.000000000 +0000
@@ -12,7 +12,7 @@
Priority: optional
Architecture: all
Depends: cman, gfs-tools, gfs2-tools, rgmanager, clvm
-Description: Red Hat cluster suite (meta package)
+Description: Red Hat cluster suite - meta package
The only scope for this package is to install the full Red Hat Cluster Suite
in one shot. It is safe to remove it.

@@ -23,54 +23,59 @@
Depends: ${shlibs:Depends}, python, openais (>= 0.82-2)
Conflicts: magma, libmagma1, libmagma-dev, ccs, fence, libiddev-dev, fence-gnbd, gulm, libgulm1, libgulm-dev, magma-plugins
Replaces: ccs, fence, fence-gnbd
-Description: cluster manager
- CMAN is a symmetric general-purpose cluster manager. It consists of
- a connection manager that handles cluster membership management,
- messaging among the cluster nodes, event notification, quorum and
- state transitions. Another part of CMAN is a service manager that
- handles service groups.
+Description: Red Hat cluster suite - cluster manager
+ CMAN is a symmetric general-purpose cluster manager. It provides a
+ service manager that handles service groups, plus a connection manager
+ that handles cluster membership management, messaging among the
+ cluster nodes, event notification, quorum and state transitions.
.
- This package contains only userspace tools for controlling the actual
- cluster manager.
+ This package provides only userspace tools for controlling the
+ cluster manager itself.

Package: libcman2
Section: libs
Architecture: any
Depends: ${shlibs:Depends}
-Description: cluster manager - libraries
- cman provides a general purpose, openais based, cluster manager.
+Description: Red Hat cluster suite - cluster manager libraries
+ CMAN is a symmetric general-purpose cluster manager. It provides a
+ service manager that handles service groups, plus a connection manager
+ that handles cluster membership management, messaging among the
+ cluster nodes, event notification, quorum and state transitions.
.
- This package contains the client libraries.
+ This package provides the client libraries.

Package: libcman-dev
Section: libdevel
Architecture: any
Depends: libcman2 (= ${binary:Version})
-Description: cluster manager - development files
- cman provides a general purpose, openais based, cluster manager.
+Description: Red Hat cluster suite - cluster manager development files
+ CMAN is a symmetric general-purpose cluster manager. It provides a
+ service manager that handles service groups, plus a connection manager
+ that handles cluster membership management, messaging among the
+ cluster nodes, event notification, quorum and state transitions.
.
- This package contains the files needed for developing applications.
+ This package provides the files needed for developing applications.

Package: libdlm2
Section: libs
Architecture: any
Depends: ${shlibs:Depends}
-Description: distributed lock manager - library
+Description: Red Hat cluster suite - distributed lock manager library
DLM is a symmetric general-purpose distributed lock manager. It is
used for example by GFS and the distributed volume manager.
.
- This is the client library for applications using the lock manager.
- The lock manager itself is a kernel module.
+ This package provides a client library for applications using the
+ lock manager. The lock manager itself is a kernel module.

Package: libdlm-dev
Section: libdevel
Architecture: any
Depends: libdlm2 (= ${binary:Version})
-Description: distributed lock manager - development files
+Description: Red Hat cluster suite - distributed lock manager development files
DLM is a symmetric general-purpose distributed lock manager. It is
used for example by GFS and the distributed volume manager.
.
- This package contains the files needed for developing applications
+ This package provides the files needed for developing applications
that use the lock manager.

Package: gfs-tools
@@ -78,63 +83,62 @@
Depends: ${shlibs:Depends}, psmisc, gfs2-tools
Recommends: redhat-cluster-modules
Section: admin
-Description: global file system tools
+Description: Red Hat cluster suite - global file system tools
The Global File System allows a cluster of machines to concurrently access
shared storage hardware like SANs or iSCSI and network block devices. GFS
- can be deployed to build high available services without the single point
- of failure a file server would be.
+ can be deployed to build high-availability services without the single point
+ of failure of a file server.
.
- This package contains userspace tools for creating and managing global
+ This package provides userspace tools for creating and managing global
file systems. GFS itself is a set of kernel modules.
.
- Note: the package requires gfs2-tools installed and it's known to work fine
- even if GFS2 is highly experimental and *MUST NOT* be used in production
- enviroment yet.
+ Note: the package requires gfs2-tools installed; this is known to be
+ reliable even though the GFS2 kernel modules themselves are highly
+ experimental and *MUST NOT* be used in a production enviroment yet.

Package: gfs2-tools
Architecture: any
Depends: ${shlibs:Depends}, psmisc
Section: admin
-Description: global file system 2 tools (EXPERIMENTAL)
+Description: Red Hat cluster suite - global file system 2 tools
The Global File System 2 allows a cluster of machines to concurrently access
shared storage hardware like SANs or iSCSI and network block devices. GFS
- can be deployed to build high available services without the single point
- of failure a file server would be.
+ can be deployed to build high-availability services without the single point
+ of failure of a file server.
.
- This package contains userspace tools for creating and managing global
- file systems. GFS2 itself is a set of kernel modules.
+ This package provides userspace tools for creating and managing global
+ file systems.
.
- GFS2 *MUST NOT* be used in production enviroment yet.
+ The GFS2 kernel modules themselves are highly experimental and *MUST NOT*
+ be used in a production enviroment yet.

Package: gnbd-client
Section: admin
Architecture: any
Depends: ${shlibs:Depends}
Recommends: fence-gnbd (= ${binary:Version}), redhat-cluster-modules
-Description: global network block device - client tools
- GNBD allows to use block devices over the network. It is a modified
- version of the linux network block device for the use within a cluster
- environment.
+Description: Red Hat cluster suite - global network block device client tools
+ GNBD allows block devices to be used over the network. It is a modified
+ version of the Linux network block device for use within a cluster environment.
.
- This package contains userspace tools for running GNBD clients.
+ This package provides userspace tools for running GNBD clients.

Package: gnbd-server
Section: admin
Architecture: any
Depends: ${shlibs:Depends}
Recommends: fence-gnbd (= ${binary:Version})
-Description: global network block device - server tools
- GNBD allows to use block devices over the network. It is a modified
- version of the linux network block device for the use within a cluster
- environment.
+Description: Red Hat cluster suite - global network block device server tools
+ GNBD allows block devices to be used over the network. It is a modified
+ version of the Linux network block device for use within a cluster environment.
.
- This package contains userspace tools for running GNBD servers.
+ This package provides userspace tools for running GNBD servers.

Package: rgmanager
Architecture: any
Depends: ${shlibs:Depends}, cman (= ${binary:Version}), iproute, iputils-arping, iputils-ping, nfs-kernel-server, nfs-common
Conflicts: nfs-user-server
-Description: clustered resource group manager
+Description: Red Hat cluster suite - clustered resource group manager
Resource Group Manager provides high availability of critical server
applications in the event of planned or unplanned system downtime.

@@ -142,6 +146,6 @@
Architecture: all
Depends: bzip2
Description: Red Hat cluster suite - kernel modules source
- This package contains the source necessary for compiling the Red Hat
+ This package provides the source necessary for compiling the Red Hat
cluster suite out-of-tree kernel modules gfs and gnbd against the
- linux tree.
+ Linux kernel source tree.
Template: cman/upgrade-warning
Type: boolean
Default: false
_Description: Abort the potentially disruptive upgrade of Red Hat Cluster Suite?
The new version 2.0 of the Red Hat Cluster Suite is not compatible with
the currently installed one. Upgrading these packages without stopping
the complete cluster can cause file system corruption on shared storage
devices.
.
For instructions on how to safely upgrade the Red Hat Cluster Suite to
version 2.0, please refer to "http://wiki.debian.org/UpgradeRHCSV1toV2".
Source: redhat-cluster
Section: admin
Priority: optional
Maintainer: Debian Kernel Team <debian-kernel@lists.debian.org>
Uploaders: Bastian Blank <waldi@debian.org>, Frederik Sch�fs@debian.org>
Standards-Version: 3.7.3.0
Build-Depends: dpatch, debhelper (>= 4.2.28), libxml2-dev, libncurses5-dev, libopenais-dev (>= 0.82-2), libvolume-id-dev (>= 0.105-4), linux-libc-dev (>= 2.6.22-6), libvirt-dev (>= 0.3.0) [amd64 i386], libnss3-dev [amd64 i386], libnspr4-dev [amd64 i386], bzip2, libslang2-dev
Build-Conflicts: libccs-dev, libcman-dev (<= 2.0), libdlm-dev (<= 2.0), libcman2, libdlm2

Package: redhat-cluster-suite
Section: admin
Priority: optional
Architecture: all
Depends: cman, gfs-tools, gfs2-tools, rgmanager, clvm
Description: Red Hat cluster suite - meta package
The only scope for this package is to install the full Red Hat Cluster Suite
in one shot. It is safe to remove it.

Package: cman
Architecture: any
Section: admin
Pre-Depends: debconf | debconf-2.0
Depends: ${shlibs:Depends}, python, openais (>= 0.82-2)
Conflicts: magma, libmagma1, libmagma-dev, ccs, fence, libiddev-dev, fence-gnbd, gulm, libgulm1, libgulm-dev, magma-plugins
Replaces: ccs, fence, fence-gnbd
Description: Red Hat cluster suite - cluster manager
CMAN is a symmetric general-purpose cluster manager. It provides a
service manager that handles service groups, plus a connection manager
that handles cluster membership management, messaging among the
cluster nodes, event notification, quorum and state transitions.
.
This package provides only userspace tools for controlling the
cluster manager itself.

Package: libcman2
Section: libs
Architecture: any
Depends: ${shlibs:Depends}
Description: Red Hat cluster suite - cluster manager libraries
CMAN is a symmetric general-purpose cluster manager. It provides a
service manager that handles service groups, plus a connection manager
that handles cluster membership management, messaging among the
cluster nodes, event notification, quorum and state transitions.
.
This package provides the client libraries.

Package: libcman-dev
Section: libdevel
Architecture: any
Depends: libcman2 (= ${binary:Version})
Description: Red Hat cluster suite - cluster manager development files
CMAN is a symmetric general-purpose cluster manager. It provides a
service manager that handles service groups, plus a connection manager
that handles cluster membership management, messaging among the
cluster nodes, event notification, quorum and state transitions.
.
This package provides the files needed for developing applications.

Package: libdlm2
Section: libs
Architecture: any
Depends: ${shlibs:Depends}
Description: Red Hat cluster suite - distributed lock manager library
DLM is a symmetric general-purpose distributed lock manager. It is
used for example by GFS and the distributed volume manager.
.
This package provides a client library for applications using the
lock manager. The lock manager itself is a kernel module.

Package: libdlm-dev
Section: libdevel
Architecture: any
Depends: libdlm2 (= ${binary:Version})
Description: Red Hat cluster suite - distributed lock manager development files
DLM is a symmetric general-purpose distributed lock manager. It is
used for example by GFS and the distributed volume manager.
.
This package provides the files needed for developing applications
that use the lock manager.

Package: gfs-tools
Architecture: any
Depends: ${shlibs:Depends}, psmisc, gfs2-tools
Recommends: redhat-cluster-modules
Section: admin
Description: Red Hat cluster suite - global file system tools
The Global File System allows a cluster of machines to concurrently access
shared storage hardware like SANs or iSCSI and network block devices. GFS
can be deployed to build high-availability services without the single point
of failure of a file server.
.
This package provides userspace tools for creating and managing global
file systems. GFS itself is a set of kernel modules.
.
Note: the package requires gfs2-tools installed; this is known to be
reliable even though the GFS2 kernel modules themselves are highly
experimental and *MUST NOT* be used in a production enviroment yet.

Package: gfs2-tools
Architecture: any
Depends: ${shlibs:Depends}, psmisc
Section: admin
Description: Red Hat cluster suite - global file system 2 tools
The Global File System 2 allows a cluster of machines to concurrently access
shared storage hardware like SANs or iSCSI and network block devices. GFS
can be deployed to build high-availability services without the single point
of failure of a file server.
.
This package provides userspace tools for creating and managing global
file systems.
.
The GFS2 kernel modules themselves are highly experimental and *MUST NOT*
be used in a production enviroment yet.

Package: gnbd-client
Section: admin
Architecture: any
Depends: ${shlibs:Depends}
Recommends: fence-gnbd (= ${binary:Version}), redhat-cluster-modules
Description: Red Hat cluster suite - global network block device client tools
GNBD allows block devices to be used over the network. It is a modified
version of the Linux network block device for use within a cluster environment.
.
This package provides userspace tools for running GNBD clients.

Package: gnbd-server
Section: admin
Architecture: any
Depends: ${shlibs:Depends}
Recommends: fence-gnbd (= ${binary:Version})
Description: Red Hat cluster suite - global network block device server tools
GNBD allows block devices to be used over the network. It is a modified
version of the Linux network block device for use within a cluster environment.
.
This package provides userspace tools for running GNBD servers.

Package: rgmanager
Architecture: any
Depends: ${shlibs:Depends}, cman (= ${binary:Version}), iproute, iputils-arping, iputils-ping, nfs-kernel-server, nfs-common
Conflicts: nfs-user-server
Description: Red Hat cluster suite - clustered resource group manager
Resource Group Manager provides high availability of critical server
applications in the event of planned or unplanned system downtime.

Package: redhat-cluster-source
Architecture: all
Depends: bzip2
Description: Red Hat cluster suite - kernel modules source
This package provides the source necessary for compiling the Red Hat
cluster suite out-of-tree kernel modules gfs and gnbd against the
Linux kernel source tree.

templates://redhat-cluster/{cman.templates}
 

Quoting Justin B Rye (jbr@edlug.org.uk):

> > "linux tree" is incorrect, imho. That's the Linux kernel source tree,
> > I think
>
> RHCS isn't Section: devel, so it would be good if it could avoid
> this jargon - only dogs and programmers do things against trees.

In case you don't read blogs, that one made my day. Please just
imagine myself alone hacking at 07:00am in my daily train to work and
suddenly laughing out loud and looking silly to other train
apssengers, *because of you*..:-)


> Unfortunately I'm not confident I can translate "compiling an
> out-of-tree module against a source tree" into English...

We should some day invent an en_US@geek locale...

Otherwise, as usual, all suggestions adopted (unless I forgot some: I
usually apply changes manually).

templates://redhat-cluster/{cman.templates}
 

Hi!

First of all thanks for bringing this up, the package indeed needs i
this kind of review.

On Mon, Jan 07, 2008 at 07:32:20AM +0100, Christian Perrier wrote:
> I think that ALL packages are missing a common paragraph describing
> *what* Redhat cluster suite is..... Anyone feeling like proposing one?

RHCS is a cluster management infrastructure, which allows to build
highly available N-node clusters with services and IP takeover on top
of shared FC/iSCSI storage devices.

something like that?

> + state transitions. Another part of CMAN is a service manager that
> + handles service groups.

rgmanager handles service groups, not cman.

Best regards
Frederik Schüler



--
ENOSIG

templates://redhat-cluster/{cman.templates}
 

Frederik Schueler wrote:
> On Mon, Jan 07, 2008 at 07:32:20AM +0100, Christian Perrier wrote:
>> I think that ALL packages are missing a common paragraph describing
>> *what* Redhat cluster suite is..... Anyone feeling like proposing one?
>
> RHCS is a cluster management infrastructure, which allows to build
> highly available N-node clusters with services and IP takeover on top
> of shared FC/iSCSI storage devices.
>
> something like that?

Or:
RHCS is a cluster management infrastructure, for building
high-availability N-node clusters with service and IP takeover on
top of shared FC/iSCSI storage devices.

I'd also suggest s/N-node/multi-node/ (I assume it's always N>1!)
and s/takeover/failover/, but that may be me missing technical
subtleties. Given that this is Red Hat we could throw in an
"enterprise grade" at the start.

"FC" should perhaps be "Fibre Channel", given the existence of
Fedora Core. The redhat.com hardware requirements say that RHCS can
also use Multi-Initiator Serial Attached SCSI (MI SAS, a new one on
me). Could we get away with replacing "FC/iSCSI storage devices"
with something more generic like "Storage Area Network hardware"?

>> + state transitions. Another part of CMAN is a service manager that
>> + handles service groups.
>
> rgmanager handles service groups, not cman.

So the (lib)cman boilerplate should be just:

CMAN is a symmetric general-purpose cluster manager. It provides a
connection manager that handles cluster membership management,
messaging among the cluster nodes, event notification, quorum and
state transitions.

Can you confirm that it "handles [...] quorum", whatever that is?

At present rgmanager has:

Resource Group Manager provides high availability of critical server
applications in the event of planned or unplanned system downtime.

Would that be improved by a transplanted reference to service groups?

(Holding off on amended patches for now)
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package


--
To UNSUBSCRIBE, email to debian-kernel-REQUEST@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org

templates://redhat-cluster/{cman.templates}
 

This is the last call for comments for the review of debconf
templates for redhat-cluster.

The reviewed templates will be sent on Sunday, January 20, 2008 to the package
maintainer as a bug report and a mail will be sent to this list with
"[BTS]" as a subject tag.


--


Template: cman/upgrade-warning
Type: boolean
Default: false
_Description: Abort the potentially disruptive upgrade of Red Hat Cluster Suite?
The new version 2.0 of the Red Hat Cluster Suite is not compatible with
the currently installed one. Upgrading these packages without stopping
the complete cluster can cause file system corruption on shared storage
devices.
.
For instructions on how to safely upgrade the Red Hat Cluster Suite to
version 2.0, please refer to 'http://wiki.debian.org/UpgradeRHCSV1toV2'.
sSource: redhat-cluster
Section: admin
Priority: optional
Maintainer: Debian Kernel Team <debian-kernel@lists.debian.org>
Uploaders: Bastian Blank <waldi@debian.org>, Frederik Schüler <fs@debian.org>
Standards-Version: 3.7.3.0
Build-Depends: dpatch, debhelper (>= 4.2.28), libxml2-dev, libncurses5-dev, libopenais-dev (>= 0.82-2), libvolume-id-dev (>= 0.105-4), linux-libc-dev (>= 2.6.22-6), libvirt-dev (>= 0.3.0) [amd64 i386], libnss3-dev [amd64 i386], libnspr4-dev [amd64 i386], bzip2, libslang2-dev
Build-Conflicts: libccs-dev, libcman-dev (<= 2.0), libdlm-dev (<= 2.0), libcman2, libdlm2

Package: redhat-cluster-suite
Section: admin
Priority: optional
Architecture: all
Depends: cman, gfs-tools, gfs2-tools, rgmanager, clvm
Description: Red Hat cluster suite - meta package
RHCS is a cluster management infrastructure, for building
high-availability multi-node clusters with service and IP failover on
top of shared Fibre Channel/iSCSI storage devices.
.
The only scope for this package is to install the full Red Hat Cluster Suite
in one shot. It is safe to remove it.

Package: cman
Architecture: any
Section: admin
Pre-Depends: debconf | debconf-2.0
Depends: ${shlibs:Depends}, python, openais (>= 0.82-2)
Conflicts: magma, libmagma1, libmagma-dev, ccs, fence, libiddev-dev, fence-gnbd, gulm, libgulm1, libgulm-dev, magma-plugins
Replaces: ccs, fence, fence-gnbd
Description: Red Hat cluster suite - cluster manager
This package is part of the Red Hat Cluster Suite, a complete
high-availability solution.
.
CMAN is a symmetric general-purpose cluster manager. It provides a
service manager that handles service groups, plus a connection
manager that handles cluster membership management, messaging among
the cluster nodes, event notification, quorum and state transitions.
.
This package provides only userspace tools for controlling the
cluster manager itself.

Package: libcman2
Section: libs
Architecture: any
Depends: ${shlibs:Depends}
Description: Red Hat cluster suite - cluster manager libraries
This package is part of the Red Hat Cluster Suite, a complete
high-availability solution.
.
CMAN is a symmetric general-purpose cluster manager. It provides a
service manager that handles service groups, plus a connection
manager that handles cluster membership management, messaging among
the cluster nodes, event notification, quorum and state transitions.
.
This package provides the client libraries.

Package: libcman-dev
Section: libdevel
Architecture: any
Depends: libcman2 (= ${binary:Version})
Description: Red Hat cluster suite - cluster manager development files
This package is part of the Red Hat Cluster Suite, a complete
high-availability solution.
.
CMAN is a symmetric general-purpose cluster manager. It provides a
service manager that handles service groups, plus a connection
manager that handles cluster membership management, messaging among
the cluster nodes, event notification, quorum and state transitions.
.
This package provides the files needed for developing applications.

Package: libdlm2
Section: libs
Architecture: any
Depends: ${shlibs:Depends}
Description: Red Hat cluster suite - distributed lock manager library
This package is part of the Red Hat Cluster Suite, a complete
high-availability solution.
.
DLM is a symmetric general-purpose distributed lock manager. It is
used for example by GFS and the distributed volume manager.
.
This package provides a client library for applications using the
lock manager. The lock manager itself is a kernel module.

Package: libdlm-dev
Section: libdevel
Architecture: any
Depends: libdlm2 (= ${binary:Version})
Description: Red Hat cluster suite - distributed lock manager development files
This package is part of the Red Hat Cluster Suite, a complete
high-availability solution.
.
DLM is a symmetric general-purpose distributed lock manager. It is
used for example by GFS and the distributed volume manager.
.
This package provides the files needed for developing applications
that use the lock manager.

Package: gfs-tools
Architecture: any
Depends: ${shlibs:Depends}, psmisc, gfs2-tools
Recommends: redhat-cluster-modules
Section: admin
Description: Red Hat cluster suite - global file system tools
This package is part of the Red Hat Cluster Suite, a complete
high-availability solution.
.
The Global File System allows a cluster of machines to concurrently access
shared storage hardware like SANs or iSCSI and network block devices. GFS
can be deployed to build high-availability services without the single point
of failure of a file server.
.
This package provides userspace tools for creating and managing global
file systems. GFS itself is a set of kernel modules.
.
Note: the package requires gfs2-tools installed; this is known to be
reliable even though the GFS2 kernel modules themselves are highly
experimental and *MUST NOT* be used in a production environment yet.

Package: gfs2-tools
Architecture: any
Depends: ${shlibs:Depends}, psmisc
Section: admin
Description: Red Hat cluster suite - global file system 2 tools
This package is part of the Red Hat Cluster Suite, a complete
high-availability solution.
.
The Global File System allows a cluster of machines to concurrently access
shared storage hardware like SANs or iSCSI and network block devices. GFS
can be deployed to build high-availability services without the single point
of failure of a file server.
.
This package provides userspace tools for creating and managing global
file systems.
.
The GFS2 kernel modules themselves are highly experimental and *MUST NOT*
be used in a production environment yet.

Package: gnbd-client
Section: admin
Architecture: any
Depends: ${shlibs:Depends}
Recommends: fence-gnbd (= ${binary:Version}), redhat-cluster-modules
Description: Red Hat cluster suite - global network block device client tools
This package is part of the Red Hat Cluster Suite, a complete
high-availability solution.
.
GNBD allows block devices to be used over the network. It is a modified
version of the Linux network block device for use within a cluster
environment.
.
This package provides userspace tools for running GNBD clients.

Package: gnbd-server
Section: admin
Architecture: any
Depends: ${shlibs:Depends}
Recommends: fence-gnbd (= ${binary:Version})
Description: Red Hat cluster suite - global network block device server tools
This package is part of the Red Hat Cluster Suite, a complete
high-availability solution.
.
GNBD allows block devices to be used over the network. It is a modified
version of the Linux network block device for use within a cluster
environment.
.
This package provides userspace tools for running GNBD servers.

Package: rgmanager
Architecture: any
Depends: ${shlibs:Depends}, cman (= ${binary:Version}), iproute, iputils-arping, iputils-ping, nfs-kernel-server, nfs-common
Conflicts: nfs-user-server
Description: Red Hat cluster suite - clustered resource group manager
This package is part of the Red Hat Cluster Suite, a complete
high-availability solution.
.
Resource Group Manager provides high availability of critical server
applications in the event of planned or unplanned system downtime.

Package: redhat-cluster-source
Architecture: all
Depends: bzip2
Description: Red Hat cluster suite - kernel modules source
This package is part of the Red Hat Cluster Suite, a complete
high-availability solution.
.
This package provides the source necessary for compiling the Red Hat
cluster suite out-of-tree kernel modules gfs and gnbd against the
Linux kernel source tree.