[Pkg-xen-devel] [RFR] templates://xen-api/{xcp-networkd.templates}

Christian PERRIER bubulle at debian.org
Mon Mar 19 06:27:31 UTC 2012


Please find, for review, the debconf templates and packages descriptions for the xen-api source package.

This review will last from Monday, March 19, 2012 to Thursday, March 29, 2012.

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:
--- xen-api.old/debian/xcp-networkd.templates	2012-03-11 16:07:16.660536745 +0100
+++ xen-api/debian/xcp-networkd.templates	2012-03-19 07:18:55.786093293 +0100
@@ -3,8 +3,10 @@
 Choices: bridge, openvswitch
 Default: bridge
 _Description: XCP networking manager:
- xcp-networkd supports two network backends: standard Linux bridging
- and Open vSwitch. While both modes support a similar feature set,
+ The xcp-networkd daemon supports two network backends: standard Linux bridging
+ and Open vSwitch.
+ .
+ While both modes support a similar feature set,
  Open vSwitch provides additional features such as QoS, monitoring,
  and control using the OpenFlow protocol. These additional features
  are not controlled directly through the XenAPI, but can instead be

Avoid beginning a sentence with a lowercase letter

Split in two paragraphs for readability (this template is alread too
jargonic so better make it at least readable).


--- xen-api.old/debian/control	2012-03-11 16:07:16.660536745 +0100
+++ xen-api/debian/control	2012-03-19 07:24:15.697438853 +0100
@@ -14,8 +14,8 @@
 Depends: ${shlibs:Depends}, ${misc:Depends}, ${python:Depends}, lsb-base, debconf, python-xenapi (= ${source:Version}), xcp-squeezed, xcp-v6d, xcp-fe, xcp-storage-managers, xen-hypervisor-4.1-amd64 | xen-hypervisor-4.1-i386 | xen-hypervisor-4.1, xen-utils-4.1, stunnel, hwdata, xcp-eliloader, xcp-xe, xcp-networkd
 Recommends: xcp-vncterm, xcp-guest-templates, smbfs
 Provides: xcp
-Description: XCP XenAPI server
- The Xen Cloud Platform (XCP) is an open source enterprise-ready server
+Description: Xen Cloud Platform - XenAPI server
+ The Xen Cloud Platform (XCP) is a server
  virtualization and cloud computing platform, with support for a range of
  guest operating systems, Linux network and storage support.
  .

The above changes are repeated over all binary packages:

- Use a "general - specific" layout for synopsis all over packages for
consistency

- Avoid buzzwords (enterprise-ready) and evidence (open source)....


@@ -177,7 +177,7 @@
  an optimized use of existing hardware, and an improved level of IT
  reliability.
  .
- xcp-xe provides the xe utility, the command line interface for XCP systems.
+ This package provides the xe utility, the command-line interface for XCP systems.
  This tool may be used to control a Debian XCP system from dom0, or it may be
  used from a non-Xen system to control another XCP or Citrix XenServer system.
 
@@ -202,6 +202,6 @@
  an optimized use of existing hardware, and an improved level of IT
  reliability.
  .
- xcp-networkd provides a network configuration daemon for xcp-xapi, which
+ This package provides a network configuration daemon for xcp-xapi, which
  handles the configuration of network interfaces and network bridges (either
  Linux or Open vSwitch) for xcp-xapi.


These two changes propose using the standard "This package provides"
formulation for the package-specific part of the description.

-- 


-------------- next part --------------
Template: xcp-xapi/networking_type
Type: select
Choices: bridge, openvswitch
Default: bridge
_Description: XCP networking manager:
 The xcp-networkd daemon supports two network backends: standard Linux bridging
 and Open vSwitch.
 .
 While both modes support a similar feature set,
 Open vSwitch provides additional features such as QoS, monitoring,
 and control using the OpenFlow protocol. These additional features
 are not controlled directly through the XenAPI, but can instead be
 enabled and controlled through the ovs-* suite of commands.
-------------- next part --------------
--- xen-api.old/debian/xcp-networkd.templates	2012-03-11 16:07:16.660536745 +0100
+++ xen-api/debian/xcp-networkd.templates	2012-03-19 07:18:55.786093293 +0100
@@ -3,8 +3,10 @@
 Choices: bridge, openvswitch
 Default: bridge
 _Description: XCP networking manager:
- xcp-networkd supports two network backends: standard Linux bridging
- and Open vSwitch. While both modes support a similar feature set,
+ The xcp-networkd daemon supports two network backends: standard Linux bridging
+ and Open vSwitch.
+ .
+ While both modes support a similar feature set,
  Open vSwitch provides additional features such as QoS, monitoring,
  and control using the OpenFlow protocol. These additional features
  are not controlled directly through the XenAPI, but can instead be
--- xen-api.old/debian/control	2012-03-11 16:07:16.660536745 +0100
+++ xen-api/debian/control	2012-03-19 07:24:15.697438853 +0100
@@ -14,8 +14,8 @@
 Depends: ${shlibs:Depends}, ${misc:Depends}, ${python:Depends}, lsb-base, debconf, python-xenapi (= ${source:Version}), xcp-squeezed, xcp-v6d, xcp-fe, xcp-storage-managers, xen-hypervisor-4.1-amd64 | xen-hypervisor-4.1-i386 | xen-hypervisor-4.1, xen-utils-4.1, stunnel, hwdata, xcp-eliloader, xcp-xe, xcp-networkd
 Recommends: xcp-vncterm, xcp-guest-templates, smbfs
 Provides: xcp
-Description: XCP XenAPI server
- The Xen Cloud Platform (XCP) is an open source enterprise-ready server
+Description: Xen Cloud Platform - XenAPI server
+ The Xen Cloud Platform (XCP) is a server
  virtualization and cloud computing platform, with support for a range of
  guest operating systems, Linux network and storage support.
  .
@@ -40,8 +40,8 @@
 Section: python
 Depends: ${shlibs:Depends}, ${misc:Depends}, ${python:Depends}
 Replaces: xcp-xapi (<< 1.3-14)
-Description: XCP XenAPI Python libraries
- The Xen Cloud Platform (XCP) is an open source enterprise-ready server
+Description: Xen Cloud Platform - XenAPI Python libraries
+ The Xen Cloud Platform (XCP) is a server
  virtualization and cloud computing platform, with support for a range of
  guest operating systems, Linux network and storage support.
  .
@@ -63,8 +63,8 @@
 Package: xcp-squeezed
 Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends}, lsb-base, xen-hypervisor-4.1-amd64 | xen-hypervisor-4.1-i386 | xen-hypervisor-4.1, xen-utils-common
-Description: daemon in charge of memory ballooning for xen domains
- The Xen Cloud Platform (XCP) is an open source enterprise-ready server
+Description: Xen Cloud Platform - memory ballooning daemon
+ The Xen Cloud Platform (XCP) is a server
  virtualization and cloud computing platform, with support for a range of
  guest operating systems, Linux network and storage support.
  .
@@ -87,8 +87,8 @@
 Package: xcp-v6d
 Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends}, lsb-base
-Description: feature daemon for xcp-xapi
- The Xen Cloud Platform (XCP) is an open source enterprise-ready server
+Description: Xen Cloud Platform - feature daemon
+ The Xen Cloud Platform (XCP) is a server
  virtualization and cloud computing platform, with support for a range of
  guest operating systems, Linux network and storage support.
  .
@@ -111,8 +111,8 @@
 Architecture: any
 Section: ocaml
 Depends: ${ocaml:Depends}, ${misc:Depends}
-Description: OCaml bindings for the Xen API
- The Xen Cloud Platform (XCP) is an open source enterprise-ready server
+Description: Xen Cloud Platform - OCaml bindings
+ The Xen Cloud Platform (XCP) is a server
  virtualization and cloud computing platform, with support for a range of
  guest operating systems, Linux network and storage support.
  .
@@ -136,8 +136,8 @@
 Section: debug
 Architecture: any
 Depends: xcp-xapi, ${misc:Depends}, ${shlibs:Depends}, ${python:Depends}
-Description: Binary utils to help debug XCP
- The Xen Cloud Platform (XCP) is an open source enterprise-ready server
+Description: Xen Cloud Platform - debug binary utilities
+ The Xen Cloud Platform (XCP) is a server
  virtualization and cloud computing platform, with support for a range of
  guest operating systems, Linux network and storage support.
  .
@@ -159,8 +159,8 @@
 Package: xcp-xe
 Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends}
-Description: command line utility for managing XCP hosts
- The Xen Cloud Platform (XCP) is an open source enterprise-ready server
+Description: Xen Cloud Platform - command-line utilities
+ The Xen Cloud Platform (XCP) is a server
  virtualization and cloud computing platform, with support for a range of
  guest operating systems, Linux network and storage support.
  .
@@ -177,7 +177,7 @@
  an optimized use of existing hardware, and an improved level of IT
  reliability.
  .
- xcp-xe provides the xe utility, the command line interface for XCP systems.
+ This package provides the xe utility, the command-line interface for XCP systems.
  This tool may be used to control a Debian XCP system from dom0, or it may be
  used from a non-Xen system to control another XCP or Citrix XenServer system.
 
@@ -202,6 +202,6 @@
  an optimized use of existing hardware, and an improved level of IT
  reliability.
  .
- xcp-networkd provides a network configuration daemon for xcp-xapi, which
+ This package provides a network configuration daemon for xcp-xapi, which
  handles the configuration of network interfaces and network bridges (either
  Linux or Open vSwitch) for xcp-xapi.
-------------- next part --------------
Source: xen-api
Section: admin
Priority: extra
Maintainer: Pkg Xen <pkg-xen-devel at lists.alioth.debian.org>
Uploaders: Jon Ludlam <jonathan.ludlam at eu.citrix.com>, Thomas Goirand <zigo at debian.org>, Mike McClurg <mike.mcclurg at citrix.com>
Build-Depends: debhelper (>= 8.0.0), dh-autoreconf, dh-ocaml, ocaml-native-compilers, ocaml-findlib, camlp4, camlp4-extra, autotools-dev, libtype-conv-camlp4-dev, libxmlm-ocaml-dev, uuid-dev, libxcp-ocaml, libxcp-ocaml-dev, omake, libxen-ocaml-dev, libxen-ocaml, libpam-dev, zlib1g-dev, xen-utils, libxen-dev, libounit-ocaml-dev, python-all (>= 2.6.6-3~), po-debconf
Standards-Version: 3.9.2
Homepage: http://www.xen.org/XCP/
Vcs-Browser: http://anonscm.debian.org/gitweb/?p=pkg-xen/xen-api.git
Vcs-Git: http://anonscm.debian.org/git/pkg-xen/xen-api.git

Package: xcp-xapi
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, ${python:Depends}, lsb-base, debconf, python-xenapi (= ${source:Version}), xcp-squeezed, xcp-v6d, xcp-fe, xcp-storage-managers, xen-hypervisor-4.1-amd64 | xen-hypervisor-4.1-i386 | xen-hypervisor-4.1, xen-utils-4.1, stunnel, hwdata, xcp-eliloader, xcp-xe, xcp-networkd
Recommends: xcp-vncterm, xcp-guest-templates, smbfs
Provides: xcp
Description: Xen Cloud Platform - XenAPI server
 The Xen Cloud Platform (XCP) is a server
 virtualization and cloud computing platform, with support for a range of
 guest operating systems, Linux network and storage support.
 .
 XCP addresses the needs of cloud providers, hosting services and data centers
 by combining the isolation and multitenancy capabilities of the Xen hypervisor
 with enhanced security, storage and network virtualization technologies to
 offer a rich set of virtual infrastructure cloud services. The platform
 also address user requirements for security, availability, performance and
 isolation across both private and public clouds.
 .
 XCP consolidates server workloads, enables savings in power, cooling, and
 management costs and thus contributing to environmentally sustainable
 computing, an increased ability to adapt to ever-changing IT environments,
 an optimized use of existing hardware, and an improved level of IT
 reliability.
 .
 This package contains the XenAPI server, which provides the control plane for
 XCP hosts and resource pools.

Package: python-xenapi
Architecture: all
Section: python
Depends: ${shlibs:Depends}, ${misc:Depends}, ${python:Depends}
Replaces: xcp-xapi (<< 1.3-14)
Description: Xen Cloud Platform - XenAPI Python libraries
 The Xen Cloud Platform (XCP) is a server
 virtualization and cloud computing platform, with support for a range of
 guest operating systems, Linux network and storage support.
 .
 XCP addresses the needs of cloud providers, hosting services and data centers
 by combining the isolation and multitenancy capabilities of the Xen hypervisor
 with enhanced security, storage and network virtualization technologies to
 offer a rich set of virtual infrastructure cloud services. The platform
 also address user requirements for security, availability, performance and
 isolation across both private and public clouds.
 .
 XCP consolidates server workloads, enables savings in power, cooling, and
 management costs and thus contributing to environmentally sustainable
 computing, an increased ability to adapt to ever-changing IT environments,
 an optimized use of existing hardware, and an improved level of IT
 reliability.
 .
 This package contains Python libraries to use XCP API.

Package: xcp-squeezed
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, lsb-base, xen-hypervisor-4.1-amd64 | xen-hypervisor-4.1-i386 | xen-hypervisor-4.1, xen-utils-common
Description: Xen Cloud Platform - memory ballooning daemon
 The Xen Cloud Platform (XCP) is a server
 virtualization and cloud computing platform, with support for a range of
 guest operating systems, Linux network and storage support.
 .
 XCP addresses the needs of cloud providers, hosting services and data centers
 by combining the isolation and multitenancy capabilities of the Xen hypervisor
 with enhanced security, storage and network virtualization technologies to
 offer a rich set of virtual infrastructure cloud services. The platform
 also address user requirements for security, availability, performance and
 isolation across both private and public clouds.
 .
 XCP consolidates server workloads, enables savings in power, cooling, and
 management costs and thus contributing to environmentally sustainable
 computing, an increased ability to adapt to ever-changing IT environments,
 an optimized use of existing hardware, and an improved level of IT
 reliability.
 .
 This daemon takes requests from xapi, the XenAPI server, in the form of
 xenstore trees and balloons domains up and down.

Package: xcp-v6d
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, lsb-base
Description: Xen Cloud Platform - feature daemon
 The Xen Cloud Platform (XCP) is a server
 virtualization and cloud computing platform, with support for a range of
 guest operating systems, Linux network and storage support.
 .
 XCP addresses the needs of cloud providers, hosting services and data centers
 by combining the isolation and multitenancy capabilities of the Xen hypervisor
 with enhanced security, storage and network virtualization technologies to
 offer a rich set of virtual infrastructure cloud services. The platform
 also address user requirements for security, availability, performance and
 isolation across both private and public clouds.
 .
 XCP consolidates server workloads, enables savings in power, cooling, and
 management costs and thus contributing to environmentally sustainable
 computing, an increased ability to adapt to ever-changing IT environments,
 an optimized use of existing hardware, and an improved level of IT
 reliability.
 .
 This daemon manages the features that are enabled or disabled on an XCP host.

Package: libxenapi-ocaml-dev
Architecture: any
Section: ocaml
Depends: ${ocaml:Depends}, ${misc:Depends}
Description: Xen Cloud Platform - OCaml bindings
 The Xen Cloud Platform (XCP) is a server
 virtualization and cloud computing platform, with support for a range of
 guest operating systems, Linux network and storage support.
 .
 XCP addresses the needs of cloud providers, hosting services and data centers
 by combining the isolation and multitenancy capabilities of the Xen hypervisor
 with enhanced security, storage and network virtualization technologies to
 offer a rich set of virtual infrastructure cloud services. The platform
 also address user requirements for security, availability, performance and
 isolation across both private and public clouds.
 .
 XCP consolidates server workloads, enables savings in power, cooling, and
 management costs and thus contributing to environmentally sustainable
 computing, an increased ability to adapt to ever-changing IT environments,
 an optimized use of existing hardware, and an improved level of IT
 reliability.
 .
 This package contains OCaml libraries for the XenAPI. These will
 allow a program to communicate with an XCP host running xapi.

Package: xcp-xapi-debug
Section: debug
Architecture: any
Depends: xcp-xapi, ${misc:Depends}, ${shlibs:Depends}, ${python:Depends}
Description: Xen Cloud Platform - debug binary utilities
 The Xen Cloud Platform (XCP) is a server
 virtualization and cloud computing platform, with support for a range of
 guest operating systems, Linux network and storage support.
 .
 XCP addresses the needs of cloud providers, hosting services and data centers
 by combining the isolation and multitenancy capabilities of the Xen hypervisor
 with enhanced security, storage and network virtualization technologies to
 offer a rich set of virtual infrastructure cloud services. The platform
 also address user requirements for security, availability, performance and
 isolation across both private and public clouds.
 .
 XCP consolidates server workloads, enables savings in power, cooling, and
 management costs and thus contributing to environmentally sustainable
 computing, an increased ability to adapt to ever-changing IT environments,
 an optimized use of existing hardware, and an improved level of IT
 reliability.
 .
 This package contains extra utilities for debugging XCP hosts.

Package: xcp-xe
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Description: Xen Cloud Platform - command-line utilities
 The Xen Cloud Platform (XCP) is a server
 virtualization and cloud computing platform, with support for a range of
 guest operating systems, Linux network and storage support.
 .
 XCP addresses the needs of cloud providers, hosting services and data centers
 by combining the isolation and multitenancy capabilities of the Xen hypervisor
 with enhanced security, storage and network virtualization technologies to
 offer a rich set of virtual infrastructure cloud services. The platform
 also address user requirements for security, availability, performance and
 isolation across both private and public clouds.
 .
 XCP consolidates server workloads, enables savings in power, cooling, and
 management costs and thus contributing to environmentally sustainable
 computing, an increased ability to adapt to ever-changing IT environments,
 an optimized use of existing hardware, and an improved level of IT
 reliability.
 .
 This package provides the xe utility, the command-line interface for XCP systems.
 This tool may be used to control a Debian XCP system from dom0, or it may be
 used from a non-Xen system to control another XCP or Citrix XenServer system.

Package: xcp-networkd
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, lsb-base, ethtool, bridge-utils, iproute, isc-dhcp-client, procps, openvswitch-switch, module-init-tools, openvswitch-datapath-dkms
Description: daemon to manage network configuration for xcp-xapi
 The Xen Cloud Platform (XCP) is an open source enterprise-ready server
 virtualization and cloud computing platform, with support for a range of
 guest operating systems, Linux network and storage support.
 .
 XCP addresses the needs of cloud providers, hosting services and data centers
 by combining the isolation and multitenancy capabilities of the Xen hypervisor
 with enhanced security, storage and network virtualization technologies to
 offer a rich set of virtual infrastructure cloud services. The platform
 also address user requirements for security, availability, performance and
 isolation across both private and public clouds.
 .
 XCP consolidates server workloads, enables savings in power, cooling, and
 management costs and thus contributing to environmentally sustainable
 computing, an increased ability to adapt to ever-changing IT environments,
 an optimized use of existing hardware, and an improved level of IT
 reliability.
 .
 This package provides a network configuration daemon for xcp-xapi, which
 handles the configuration of network interfaces and network bridges (either
 Linux or Open vSwitch) for xcp-xapi.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 836 bytes
Desc: Digital signature
URL: <http://lists.alioth.debian.org/pipermail/pkg-xen-devel/attachments/20120319/e5970fa8/attachment.pgp>


More information about the Pkg-xen-devel mailing list