[Debian-ha-maintainers] [RFR] templates://redhat-cluster/{cman.templates}
Christian Perrier
bubulle at debian.org
Sat Oct 17 05:01:43 UTC 2009
Please find, for review, the debconf templates and packages descriptions for the redhat-cluster source package.
This review will last from Saturday, October 17, 2009 to Tuesday, October 27, 2009.
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 2009-10-10 07:38:21.704208932 +0200
+++ redhat-cluster/debian/cman.templates 2009-10-13 07:21:59.546773609 +0200
@@ -1,14 +1,11 @@
Template: cman/upgrade-warning
Type: boolean
Default: false
-_Description: Do you want to abort now?
+_Description: Do you want to abort Red Hat Cluster Suite upgrade?
"Abort what"?
The short description should make it clear what we're talking about as
the template may appear in the middle of many others during an upgrade.
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.
Currently accepted spelling (see D-I for instance)
.
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.
Shorten the template by dropping a paragraph (these are space eaters).
--- redhat-cluster.old/debian/control 2009-10-10 07:38:21.688208213 +0200
+++ redhat-cluster/debian/control 2009-10-13 07:27:41.550772025 +0200
@@ -12,7 +12,7 @@
Priority: optional
Architecture: all
Depends: ${misc:Depends}, cman, gfs-tools, gfs2-tools, rgmanager, clvm
-Description: Red Hat cluster suite (metapackage)
+Description: Red Hat cluster suite - metapackage
Standardize on the currently most common format for short descriptions
in such situations. This is repeated for all binary packages.
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 indeed missing a boilerplate paragraph
that would described what is RHCS, in general. Could we find one?
@@ -25,22 +25,22 @@
libnet-snmp-perl, libnet-telnet-perl, snmp, telnet, openssh-client,
python-openssl
Conflicts: libdlm-dev (<= 2.20090112-0ubuntu3)
-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 contains only user space tools for controlling the actual
cluster manager.
Commonly accepted spelling.
Package: liblogthread3
Section: libs
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}
-Description: cluster logging - libraries
- this library provides a simple logging API designed for cluster
+Description: Red Hat cluster suite - cluster logging libraries
+ This library provides a simple logging API designed for cluster
applications.
.
This package contains the client libraries.
Properly capitalize. This is repeated over several binary packages...
@@ -59,12 +59,13 @@
Section: libs
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}
-Description: cluster configuration - libraries
- this library provides a simplified xpath implementation to access
+Description: Red Hat cluster suite - cluster configuration libraries
+ This library provides a simplified xpath implementation to access
cman/corosync configuration objdb retaining the same API as the old
and deprecated libccs provided by ccsd.
.
- brand new applications should use libconfdb from corosync.
+ This library shouldn't be used for new development. Use libconfdb
+ from corosync instead.
Make this more written language than spoken language. This change is
repeated for a few other packages
.
This package contains the client libraries.
Package: libcman3
Section: libs
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}
-Description: cluster manager - libraries
- cman provides a general purpose, corosync/openais based, cluster manager.
+Description: Red Hat cluster suite - cluster manager libraries
+ CMAN provides a general purpose, corosync/openais based, cluster manager.
Consistently capitalize the acronym
-------------- next part --------------
Template: cman/upgrade-warning
Type: boolean
Default: false
_Description: Do you want to abort Red Hat Cluster Suite upgrade?
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.
-------------- next part --------------
--- redhat-cluster.old/debian/cman.templates 2009-10-10 07:38:21.704208932 +0200
+++ redhat-cluster/debian/cman.templates 2009-10-13 07:21:59.546773609 +0200
@@ -1,14 +1,11 @@
Template: cman/upgrade-warning
Type: boolean
Default: false
-_Description: Do you want to abort now?
+_Description: Do you want to abort Red Hat Cluster Suite upgrade?
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 2009-10-10 07:38:21.688208213 +0200
+++ redhat-cluster/debian/control 2009-10-13 07:27:41.550772025 +0200
@@ -12,7 +12,7 @@
Priority: optional
Architecture: all
Depends: ${misc:Depends}, cman, gfs-tools, gfs2-tools, rgmanager, clvm
-Description: Red Hat cluster suite (metapackage)
+Description: Red Hat cluster suite - metapackage
The only scope for this package is to install the full Red Hat Cluster Suite
in one shot. It is safe to remove it.
@@ -25,22 +25,22 @@
libnet-snmp-perl, libnet-telnet-perl, snmp, telnet, openssh-client,
python-openssl
Conflicts: libdlm-dev (<= 2.20090112-0ubuntu3)
-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 contains only user space tools for controlling the actual
cluster manager.
Package: liblogthread3
Section: libs
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}
-Description: cluster logging - libraries
- this library provides a simple logging API designed for cluster
+Description: Red Hat cluster suite - cluster logging libraries
+ This library provides a simple logging API designed for cluster
applications.
.
This package contains the client libraries.
@@ -49,8 +49,8 @@
Section: libdevel
Architecture: any
Depends: ${misc:Depends}, liblogthread3 (= ${binary:Version})
-Description: cluster logging - development files
- this library provides a simple logging API designed for cluster
+Description: Red Hat cluster suite - cluster logging development files
+ This library provides a simple logging API designed for cluster
applications.
.
This package contains the files needed for developing applications.
@@ -59,12 +59,13 @@
Section: libs
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}
-Description: cluster configuration - libraries
- this library provides a simplified xpath implementation to access
+Description: Red Hat cluster suite - cluster configuration libraries
+ This library provides a simplified xpath implementation to access
cman/corosync configuration objdb retaining the same API as the old
and deprecated libccs provided by ccsd.
.
- brand new applications should use libconfdb from corosync.
+ This library shouldn't be used for new development. Use libconfdb
+ from corosync instead.
.
This package contains the client libraries.
@@ -72,12 +73,13 @@
Section: libdevel
Architecture: any
Depends: ${misc:Depends}, libccs3 (= ${binary:Version})
-Description: cluster manager - development files
- this library provides a simplified xpath implementation to access
+Description: Red Hat cluster suite - cluster manager development files
+ This library provides a simplified xpath implementation to access
cman/corosync configuration objdb retaining the same API as the old
and deprecated libccs provided by ccsd.
.
- brand new applications should use libconfdb from corosync.
+ This library shouldn't be used for new development. Use libconfdb
+ from corosync instead.
.
This package contains the files needed for developing applications.
@@ -85,15 +87,15 @@
Section: perl
Architecture: any
Depends: ${misc:Depends}, ${perl:Depends}, ${shlibs:Depends}
-Description: Perl module for using the libccs2 library
+Description: Red Hat cluster suite - Perl module for libccs2 library
This modules implements a Perl interface to the Cluster libccs library.
Package: libcman3
Section: libs
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}
-Description: cluster manager - libraries
- cman provides a general purpose, corosync/openais based, cluster manager.
+Description: Red Hat cluster suite - cluster manager libraries
+ CMAN provides a general purpose, corosync/openais based, cluster manager.
.
This package contains the client libraries.
@@ -101,8 +103,8 @@
Section: libdevel
Architecture: any
Depends: ${misc:Depends}, libcman3 (= ${binary:Version})
-Description: cluster manager - development files
- cman provides a general purpose, corosync/openais based, cluster manager.
+Description: Red Hat cluster suite - cluster manager development files
+ CMAN provides a general purpose, corosync/openais based, cluster manager.
.
This package contains the files needed for developing applications.
@@ -111,7 +113,7 @@
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}
Breaks: udev (<< 0.136-1)
-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.
.
@@ -122,7 +124,7 @@
Section: libdevel
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}, libdlm3 (= ${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.
.
@@ -133,7 +135,7 @@
Section: libs
Architecture: any
Depends: ${misc: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.
.
@@ -144,7 +146,7 @@
Section: libdevel
Architecture: any
Depends: ${misc:Depends}, libdlmcontrol3 (= ${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.
.
@@ -155,8 +157,8 @@
Section: libs
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}
-Description: fence client - library
- fenced is the daemon in charge of controlling cluster node fencing.
+Description: Red Hat cluster suite - fence client library
+ The fenced daemoin is in charge of controlling cluster node fencing.
.
This is the client library for requesting node fencing.
@@ -164,8 +166,8 @@
Section: libdevel
Architecture: any
Depends: ${misc:Depends}, libfence4 (= ${binary:Version})
-Description: fenced - development files
- fenced is the daemon in charge of controlling cluster node fencing.
+Description: Red Hat cluster suite - fenced development files
+ The fenced daemon is in charge of controlling cluster node fencing.
.
This package contains the files needed for developing applications
that need to request node fencing.
@@ -175,7 +177,7 @@
Depends: ${misc:Depends}, ${shlibs:Depends}, 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
@@ -192,7 +194,7 @@
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}, psmisc
Section: admin
-Description: global file system 2 tools (EXPERIMENTAL)
+Description: Red Hat cluster suite - global file system 2 tools (EXPERIMENTAL)
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
@@ -209,7 +211,7 @@
iproute, iputils-arping, iputils-ping, nfs-kernel-server, nfs-common,
perl, gawk, net-tools
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.
-------------- next part --------------
Source: redhat-cluster
Section: admin
Priority: optional
Maintainer: Debian HA Maintainers <debian-ha-maintainers at lists.alioth.debian.org>
Uploaders: Bastian Blank <waldi at debian.org>, Frederik Sch?ler <fs at debian.org>,
Guido G?nther <agx at sigxcpu.org>
Standards-Version: 3.8.3
Build-Depends: quilt, debhelper (>= 5), libxml2-dev, libncurses5-dev, libcorosync-dev (>= 1.0.0), libopenais-dev (>= 1.0.0), linux-libc-dev, libvirt-dev (>= 0.3.0), libnss3-dev, libnspr4-dev, bzip2, libslang2-dev, libldap2-dev, perl-modules
Package: redhat-cluster-suite
Section: admin
Priority: optional
Architecture: all
Depends: ${misc:Depends}, cman, gfs-tools, gfs2-tools, rgmanager, clvm
Description: Red Hat cluster suite - metapackage
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: ${misc:Depends}, ${shlibs:Depends}, corosync (>= 1.0.0),
openais (>= 1.0.0), python, openipmi, sg3-utils, python-pexpect,
libnet-snmp-perl, libnet-telnet-perl, snmp, telnet, openssh-client,
python-openssl
Conflicts: libdlm-dev (<= 2.20090112-0ubuntu3)
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 user space tools for controlling the actual
cluster manager.
Package: liblogthread3
Section: libs
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}
Description: Red Hat cluster suite - cluster logging libraries
This library provides a simple logging API designed for cluster
applications.
.
This package contains the client libraries.
Package: liblogthread-dev
Section: libdevel
Architecture: any
Depends: ${misc:Depends}, liblogthread3 (= ${binary:Version})
Description: Red Hat cluster suite - cluster logging development files
This library provides a simple logging API designed for cluster
applications.
.
This package contains the files needed for developing applications.
Package: libccs3
Section: libs
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}
Description: Red Hat cluster suite - cluster configuration libraries
This library provides a simplified xpath implementation to access
cman/corosync configuration objdb retaining the same API as the old
and deprecated libccs provided by ccsd.
.
This library shouldn't be used for new development. Use libconfdb
from corosync instead.
.
This package contains the client libraries.
Package: libccs-dev
Section: libdevel
Architecture: any
Depends: ${misc:Depends}, libccs3 (= ${binary:Version})
Description: Red Hat cluster suite - cluster manager development files
This library provides a simplified xpath implementation to access
cman/corosync configuration objdb retaining the same API as the old
and deprecated libccs provided by ccsd.
.
This library shouldn't be used for new development. Use libconfdb
from corosync instead.
.
This package contains the files needed for developing applications.
Package: libccs-perl
Section: perl
Architecture: any
Depends: ${misc:Depends}, ${perl:Depends}, ${shlibs:Depends}
Description: Red Hat cluster suite - Perl module for libccs2 library
This modules implements a Perl interface to the Cluster libccs library.
Package: libcman3
Section: libs
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}
Description: Red Hat cluster suite - cluster manager libraries
CMAN provides a general purpose, corosync/openais based, cluster manager.
.
This package contains the client libraries.
Package: libcman-dev
Section: libdevel
Architecture: any
Depends: ${misc:Depends}, libcman3 (= ${binary:Version})
Description: Red Hat cluster suite - cluster manager development files
CMAN provides a general purpose, corosync/openais based, cluster manager.
.
This package contains the files needed for developing applications.
Package: libdlm3
Section: libs
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}
Breaks: udev (<< 0.136-1)
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.
Package: libdlm-dev
Section: libdevel
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}, libdlm3 (= ${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 contains the files needed for developing applications
that use the lock manager.
Package: libdlmcontrol3
Section: libs
Architecture: any
Depends: ${misc: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 is the client library for applications using the lock manager.
The lock manager itself is a kernel module.
Package: libdlmcontrol-dev
Section: libdevel
Architecture: any
Depends: ${misc:Depends}, libdlmcontrol3 (= ${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 contains the files needed for developing applications
that use the lock manager.
Package: libfence4
Section: libs
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}
Description: Red Hat cluster suite - fence client library
The fenced daemoin is in charge of controlling cluster node fencing.
.
This is the client library for requesting node fencing.
Package: libfence-dev
Section: libdevel
Architecture: any
Depends: ${misc:Depends}, libfence4 (= ${binary:Version})
Description: Red Hat cluster suite - fenced development files
The fenced daemon is in charge of controlling cluster node fencing.
.
This package contains the files needed for developing applications
that need to request node fencing.
Package: gfs-tools
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}, 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 contains 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
environment yet.
Package: gfs2-tools
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}, psmisc
Section: admin
Description: Red Hat cluster suite - global file system 2 tools (EXPERIMENTAL)
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
file systems. GFS2 itself is a set of kernel modules.
.
GFS2 *MUST NOT* be used in production environment yet.
Package: rgmanager
Architecture: any
Depends: ${misc:Depends}, ${shlibs:Depends}, cman (= ${binary:Version}),
iproute, iputils-arping, iputils-ping, nfs-kernel-server, nfs-common,
perl, gawk, net-tools
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: ${misc:Depends}, bzip2
Description: Red Hat cluster suite - kernel module source
This package contains the source necessary for compiling the Red Hat
cluster suite out-of-tree kernel module gfs against the
Linux tree.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: Digital signature
URL: <http://lists.alioth.debian.org/pipermail/debian-ha-maintainers/attachments/20091017/3b1b38e1/attachment.pgp>
More information about the Debian-ha-maintainers
mailing list