table of contents
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 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.