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
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.
--- 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.
Source: redhat-cluster Section: admin Priority: optional Maintainer: Debian HA Maintainers <debian-ha-maintainers@lists.alioth.debian.org> Uploaders: Bastian Blank <waldi@debian.org>, Frederik Schüler <fs@debian.org>, Guido Günther <agx@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.
Attachment:
signature.asc
Description: Digital signature