dtc_write_xenhvm_conf(8)				      System Manager's Manual					  dtc_write_xenhvm_conf(8)

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 con-
       nect  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)