(see rationale at the end of this mail. I took the review over at this time because this package will probably need complex interaction with its maintainer) Please find, for review, the debconf templates of dtc-xen. This review will last from Friday, April 06, 2007 to Monday, April 16, 2007. 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: -this is a complete rewrite. The original templates did not comply with the Developer's Reference recommendations. They were also somewhat cryptic in many places. I tried to make them clearer even if the topic is very jargon-generating. I hope that the jargonic VPS means Virtual Private Server(s). This is my understading but please correct me if I'm wrong. PS: thou shalt never use the interrogative form in debconf templates long description. Never ever. PS/2: thou shalt not use debconf notes. They are Evil. That will be the topic of dedicated bug report for the package. The last note belongs to README.Debian. --
Template: dtc-xen/conf_soap_port Type: string Default: 8089 _Description: Server port: Please enter the port the server will bind to. Template: dtc-xen/conf_soap_login Type: string Default: dtc-xen _Description: SOAP server login: Dtc-xen will bind a SOAP Python server (to which a dtc panel can connect, in order to start, stop, create and destroy a VPS). . Please enter the login name to connect to the server. Template: dtc-xen/conf_soap_pass Type: password Default: dtc-xen _Description: SOAP server pass: Dtc-xen will generate a .htpasswd file for the login you have just configured. . Please enter the password to use in that file. Template: dtc-xen/conf_soap_domain_name Type: string Default: example.com _Description: Server hostname: Please enter the domain name for the dtc-xen server. This will be used as a part of the URL by the SOAP dtc panel client. Template: dtc-xen/conf_node_number Type: string Default: 0101 _Description: VPS Server node number: Please enter the value to use to set up VPS numbering. . Assuming this value is 'XXXX', the node number will be 'xenXXXXYY', YY beingis the VPS number itself (xenYY). This node number must be 4 or 5 characters long. . As a consequence of this choice, the server's hostname will be nodeXXXX.example.com (which you can later add in your DTC control panel). Template: dtc-xen/conf_debian_repository Type: string Default: ftp://ftp.us.debian.org/debian _Description: Debian repository for VPS creation: Please enter the repository to use for creating VPS (Virtual Private Servers). The current /etc/apt/sources.list file will be copied the created VPS so the repository you enter here will be used only during the debootstrap stage of the VPS creation. Template: dtc-xen/conf_netmask Type: string Default: 255.255.255.0 _Description: Network mask for the VPS: Please enter the network mask to use in the created Virtual Private Servers network settings. Template: dtc-xen/conf_network Type: string Default: 192.168.60.0 _Description: Network address for the VPS: Please enter the network address to use in the created Virtual Private Servers network settings. Template: dtc-xen/conf_broadcast Type: string Default: 192.168.60.255 _Description: Broadcast address for the VPS: Please enter the network broadcast address to use in the created Virtual Private Servers network settings. Template: dtc-xen/conf_gateway Type: string Default: 192.168.60.254 _Description: Gateway address for the VPS: Please enter the network gateway address to use in the created Virtual Private Servers network settings. Template: dtc-xen/conf_linux_kernel_name Type: string Default: 2.6.16.27-xenU _Description: Xen kernel release name: Please enter the kernel version number as it appears with the 'uname -a' command. . A kernel domU with that name must be located in /boot (example: vmlinuz-2.6.16.27-xenU) and its corresponding modules must be in /lib/modules. Template: dtc-xen/conf_lvm_name Type: string Default: lvm1 _Description: Volume group to create VPS in: Dtc-xen creates physical partitions in an existing LVM volume group . Please enter that volume group name. The volume group size must fit all the virtual machiness you will set up later on this server. If you don't want to use LVM (because you don't care if loopback is slower), leave this setting to the default value. Template: dtc-xen/conf_info_finish_setup Type: note _Description: Installation completion To finish the installation, you need to launch /usr/sbin/dtc-xen_finish_install. . This script will remove port forwarding from the current sshd_config file and add the grant of xm console to the group xenusers so that users can login to the physical console. It will then try to download the files needed to setup Gentoo and CentOS into the virtual machines. . Please note that the system is currently safe (connections to a physical console as xenXX will be rejected because the /etc/sudoers is not changed), but a basic user won't be able to log into his physical console using ssh.
--- ../dtc-xen.old/debian/templates 2007-04-03 08:41:17.114729549 +0200 +++ debian/templates 2007-04-06 20:56:16.565791041 +0200 @@ -2,106 +2,119 @@ Type: string Default: 8089 _Description: Server port: - What port should it bind to? Default is 8089. + Please enter the port the server will bind to. Template: dtc-xen/conf_soap_login Type: string Default: dtc-xen _Description: SOAP server login: - dtc-xen will bind a SOAP python server on which a dtc panel can connect to - in order to start, stop create and destroy a VPS. What login do you want - to create on that server. + Dtc-xen will bind a SOAP Python server (to which a dtc panel can connect, in + order to start, stop, create and destroy a VPS). + . + Please enter the login name to connect to the server. Template: dtc-xen/conf_soap_pass Type: password Default: dtc-xen _Description: SOAP server pass: - dtc-xen will generate a password (in a .htpasswd file) that will hold the - password for the login you have just configured. What password do you want - to have generated in it? + Dtc-xen will generate a .htpasswd file for the login you have just + configured. + . + Please enter the password to use in that file. Template: dtc-xen/conf_soap_domain_name Type: string Default: example.com _Description: Server hostname: - What will be the domain name for this dtc-xen server? This will be used as a + Please enter the domain name for the dtc-xen server. This will be used as a part of the URL by the SOAP dtc panel client. Template: dtc-xen/conf_node_number Type: string Default: 0101 _Description: VPS Server node number: - dtc-xen will use that number as a VPS Server number and will make your VPS - numbering using xenXXXXYY with X being the server number (what it's are - asking you at the moment) and Y being the VPS number itself (xenYY). Note - that this node number has to be between 4 and 5 chars, and that it will - create something like nodeXXXX.example.com that will be your server - hostname (which you can later add in your DTC control panel). + Please enter the value to use to set up VPS numbering. + . + Assuming this value is 'XXXX', the node number will be 'xenXXXXYY', + YY beingis the VPS number itself (xenYY). This node number must be 4 + or 5 characters long. + . + As a consequence of this choice, the server's hostname will be + nodeXXXX.example.com (which you can later add in your DTC control + panel). Template: dtc-xen/conf_debian_repository Type: string Default: ftp://ftp.us.debian.org/debian -_Description: Debian repository for setting-up VPSes: - dtc-xen will use that repository for creating VPSes, and will copy your - /etc/apt/sources.list inside your VPS (so this will be used ONLY durring - the debootstrap stage of the VPS creation). +_Description: Debian repository for VPS creation: + Please enter the repository to use for creating VPS (Virtual Private + Servers). The current /etc/apt/sources.list file will be copied the + created VPS so the repository you enter here will be used only during + the debootstrap stage of the VPS creation. Template: dtc-xen/conf_netmask Type: string Default: 255.255.255.0 -_Description: Netmask to be setup in the VPSes: - Please enter the Netmask to use when doing the VPS network customization - when dtc-xen creates a VPS. +_Description: Network mask for the VPS: + Please enter the network mask to use in the created Virtual Private + Servers network settings. Template: dtc-xen/conf_network Type: string Default: 192.168.60.0 -_Description: Network to be setup in the VPSes: - Please enter the Network address to use when doing the VPS network - customization when dtc-xen creates a VPS. +_Description: Network address for the VPS: + Please enter the network address to use in the created Virtual Private + Servers network settings. Template: dtc-xen/conf_broadcast Type: string Default: 192.168.60.255 -_Description: Broadcast to be setup in the VPSes: - Please enter the network broadcast address to use when doing the VPS - network customization when dtc-xen creates a VPS. +_Description: Broadcast address for the VPS: + Please enter the network broadcast address to use in the created + Virtual Private Servers network settings. Template: dtc-xen/conf_gateway Type: string Default: 192.168.60.254 -_Description: Gateway to be setup in the VPSes: - Please enter the network gateway address to use when doing the VPS network - customization when dtc-xen creates a VPS. +_Description: Gateway address for the VPS: + Please enter the network gateway address to use in the created + Virtual Private Servers network settings. Template: dtc-xen/conf_linux_kernel_name Type: string Default: 2.6.16.27-xenU -_Description: Xen Kernel release name: - Enter here the kernel version number as it appears in the uname -a. A - kernel domU with that name must be located in /boot (example: - vmlinuz-2.6.16.27-xenU) and it's corresponding modules must be in +_Description: Xen kernel release name: + Please enter the kernel version number as it appears with the + 'uname -a' command. + . + A kernel domU with that name must be located in /boot (example: + vmlinuz-2.6.16.27-xenU) and its corresponding modules must be in /lib/modules. Template: dtc-xen/conf_lvm_name Type: string Default: lvm1 -_Description: Volume group where to create VPS: - dtc-xen creates physical partitions in a lvm volume group that you have to - name here. This volume group has to be big enough to hold all the VMs you will - setup later on this server. If you don't want to use lvm (because you don't - care if loopback is slower), leave this as default and dtc-xen wont use it - anyway. +_Description: Volume group to create VPS in: + Dtc-xen creates physical partitions in an existing LVM volume group + . + Please enter that volume group name. The volume group size must fit + all the virtual machiness you will set up later on this server. If + you don't want to use LVM (because you don't care if loopback is + slower), leave this setting to the default value. Template: dtc-xen/conf_info_finish_setup Type: note -_Description: How to finish the install +_Description: Installation completion To finish the installation, you need to launch - /usr/sbin/dtc-xen_finish_install. This script will remove port - forwarding from your sshd_config and add the grant of xm console - to the group xenusers so your users can loggin to the physical - console. It will then try to download the files needed to setup - Gentoo and CentOS into your VMs. Note that the system is currently - safe (nobody can connect to a physical console as xenXX, they will - be rejected because the /etc/sudoers is not changed), but a basic - user wont be able to log into his physical console using ssh. + /usr/sbin/dtc-xen_finish_install. + . + This script will remove port forwarding from the current sshd_config + file and add the grant of xm console to the group xenusers so that + users can login to the physical console. It will then try to + download the files needed to setup Gentoo and CentOS into the + virtual machines. + . + Please note that the system is currently safe (connections to a + physical console as xenXX will be rejected because the /etc/sudoers + is not changed), but a basic user won't be able to log into his + physical console using ssh. --- ../dtc-xen.old/debian/control 2007-04-03 08:41:17.114729549 +0200 +++ debian/control 2007-04-06 20:59:47.903534751 +0200 @@ -10,11 +10,10 @@ Priority: optional Architecture: all Depends: debconf, python, rrdtool, apache | apache2, python-soappy, python-crypto, m2crypto, debootstrap, openssl, sudo, rpmstrap, adduser -Description: A SOAP daemon and help scripts so a control panel can manage Xen VMs - dtc-xen is a SOAP server running over HTTPS with auth, - so a web GUI tool can manage, create and destroy your - domU under Xen. This package is to be run in the dom0 - of your Xen server. It's written to integrate within DTC - web hosting control panel. +Description: SOAP daemon and scripts to allow control panel management for Xen VMs + Dtc-xen is a SOAP server running over HTTPS with authentication, so + that a web GUI tool can manage, create and destroy domUs under + Xen. This package should be used in the dom0 of a Xen server. It + integrates itself within the DTC web hosting control panel. . Homepage: <http://www.gplhost.com/software-dtc-xen.html>
Source: dtc-xen Section: web Priority: extra Maintainer: Thomas Goirand <thomas@goirand.fr> Build-Depends: debhelper (>= 4), po-debconf Standards-Version: 3.7.2 Package: dtc-xen Section: web Priority: optional Architecture: all Depends: debconf, python, rrdtool, apache | apache2, python-soappy, python-crypto, m2crypto, debootstrap, openssl, sudo, rpmstrap, adduser Description: SOAP daemon and scripts to allow control panel management for Xen VMs Dtc-xen is a SOAP server running over HTTPS with authentication, so that a web GUI tool can manage, create and destroy domUs under Xen. This package should be used in the dom0 of a Xen server. It integrates itself within the DTC web hosting control panel. . Homepage: <http://www.gplhost.com/software-dtc-xen.html>
Attachment:
signature.asc
Description: Digital signature