Provided by: dtc-xen_0.5.17-1_all bug

NAME

       dtc_write_xenhvm_conf - rewrites the xen startup script with selected params

SYNOPSIS

       dtc_write_xenhvm_conf   VPS_NUMBER   MEMORY_SIZE   ALL_IP_ADDRESSES   VNC_CONSOLE_PASSWORD
       HOW_TO_BOOT

DESCRIPTION

       dtc_write_xenhvm_conf This shell script is a part of the dtc-xen package  that  is  to  be
       used by the dtc panel to manage a Xen VPS server.

       This script generate a Xen startup file with the parameters given to the script.

PARAMETERS

       Note that ALL parameters are mendatory.

       VPS_NUMBER has to be a number between 01 and 29

       MEMORY_SIZE  is  the amount of memory in mega bytes that you want to have setup in the Xen
       startup file for this VPS

       ALL_IP_ADDRESSES is a list of IPs that you want to be set in the VM's startup file and  in
       the  VM's  configuration.  Note  that the IPs have to be separated by spaces, and thus you
       might want to use single quotes like this: '1.2.3.4 1.2.3.5'. Note that only the first  IP
       will be set in the VM's configuration, but the list will be set in the Xen startup file so
       you can use the anti-spoofing facilities of Xen if you need it  (with  untrusted  users  /
       unknown customers for example).

       VNC_CONSOLE_PASSWORD  This is the VNC console password that you want to have set-up in the
       Xen domU configuration file, so that you can connect using VNC to the the setup. Note that
       special  value  no_vnc  can  be used to declare that you do not want the VNC console to be
       used at all.

       HOW_TO_BOOT This controls what the VPS will use to boot. A special value  of  hdd  can  be
       used  to  tell  dtc_write_xenhvm_conf that you want to boot on the hard drive of the domU.
       Any   other   parameters    will    be    used    as    a    .iso    file    located    in
       /var/lib/dtc-xen/ttyssh_home/xenXX  where  xenXX  equals  to  the  VPS  number  set in the
       VPS_NUMBER parameter (see above).

       Note that whatever is set in this parameter, dtc_write_xenhvm_conf will add as many  cdrom
       devices as it finds .iso files in the /var/lib/dtc-xen/ttyssh_home/xenXX folder.

EXAMPLE

       The following command:

       dtc_write_xenhvm_conf 14 512 '1.2.3.4 1.2.3.5' mYvNcPaSs boot.iso

       will produce this config file in /etc/xen/xen14:

       kernel = "/usr/lib/xen/boot/hvmloader"
       builder = 'hvm'
       memory = 512
       name = "xen14${VPSNAME}"
       vcpus=1
       pae=0
       acpi=0
       apic=0
       vif = [ 'type=ioemu, mac=00:00:00:00:00:00, ip=1.2.3.4 1.2.3.5' ]
       disk=[            'phy:/dev/mapper/lvm1-xen14,ioemu:hda,w',            'file:/var/lib/dtc-
       xen/ttyssh_home/xen14/boot.iso,hdb:cdrom,r',                           'file:/var/lib/dtc-
       xen/ttyssh_home/xen14/cd2.iso,hdc:cdrom,r' ]
       cdrom="/var/lib/dtc-xen/ttyssh_home/xen14/boot.iso"
       boot="d"
       vfb = [ "type=vnc,vncdisplay=21,vncpasswd=mYvNcPaSs" ]
       nographic=0
       vnc=1
       stdvga=1
       serial='pty'

       Note  that  the above mac address will be calculated and depend on your node name: it will
       NOT be like the above example.

UPDATES

       See http://www.gplhost.com/software-dtc-xen.html for updates.

                                                                         dtc_write_xenhvm_conf(8)