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)