virtualm achines

Help
XenServerRelease Notes

XenServer Quick Start Guide

XenServerInstallation Guide

XenServerVirtualM achine User's Guide

XenServerAdm inistrator'sGuide

vSw itch ControllerUser'sGuide

Supplem entalPacks and the DDK

XenServer Softw are Developm ent Kit Guide

XenAPISpecification
 XenServer
Hardw are Com patibility List
 How to SetUp a SerialCable
forTroubleshooting on XenServer

XenServerVirtualM achine User'sGuide

xe host-apply-edition edition= enterprise-per-socket|desktop-plus|desktop|standard-per-socket
license-server-address=<license_server_address> host-uuid=<uuid_of_host> \
license-server-port=<license_server_port>

xe pool-apply-edition edition= enterprise-per-socket|desktop-plus|desktop|standard-per-socket

license-server-address=<license_server_address> pool-uuid=<uuid_of_pool> \
license-server-port=<license_server_port>

XenServer7.0 Licensing FAQ

 Linux Foundation Xen Project

Readm e First
 Netw ork Boot
Installations

BootFrom SAN Environm ents

Upgrading XenServer
Perform clean installation
Upgrade
Upgrading XenServer
Restore
XenServerAdm inistrator'sGuide

strongly
XenServerand IntelliCache
 not the fully qualified
dom ain nam e (FQDN)
Installing XenServeron Sm allDevices
 XenServerAdm inistrator'sGuide

disable-gpt

disable-
gpt

*
includes root, backup, local SR (if any), boot, log, and SWAP
†
includes root, backup, and local SR (if any)
‡
includes root, backup, local SR (if any), and boot
 client_install XenCenterSetup.exe

HKEY_LOCAL_MACHINE\Software
\Citrix\XenCenter
AllowCredentialSave true false
 any

autom atically

XenServerAdm inistrator's
Guide

Help XenServerAdm inistrator'sGuide

 server:/path
xe sr-create content-type=user type=nfs name-label=<sr_name=> \
shared=true device-config:server=<server> \
device-config:serverpath=<path>

device-config-server device-
config-serverpath shared

xe pool-param-set uuid=<pool_uuid> \
default-SR=<storage_repository_uuid>
xe-set-iscsi-iqn <iscsi_iqn>

xe host-param-set uuid=<host_uuid> other-config-iscsi_iqn=<iscsi_iqn>

unique

xe sr-create name-label=<name_for_sr> \
content-type=user device-config-target=<iscsi_server_ip_address> \
device-config-targetIQN=<iscsi_target_iqn> \
device-config-localIQN=<iscsi_local_iqn> \
type=lvmoiscsi shared=true device-config-LUNid=<lun_id>
 device-config-target
device-config-LUNid shared
true

xe pool-param-set uuid=<pool_uuid> default-SR=<iscsi_shared_sr_uuid>

IntelliCache
localsr=`xe sr-list type=lvm host=<hostname> params=uuid --minimal`
echo localsr=$localsr
pbd=`xe pbd-list sr-uuid=$localsr params=uuid --minimal`
echo pbd=$pbd
xe pbd-unplug uuid=$pbd
xe pbd-destroy uuid=$pbd
xe sr-forget uuid=$localsr
sed -i "s/'lvm'/'ext'/" /etc/firstboot.d/data/default-storage.conf
rm -f /etc/firstboot.d/state/10-prepare-storage
rm -f /etc/firstboot.d/state/15-set-default-storage
service firstboot start
xe sr-list type=ext

xe host-disable host=<hostname>
localsr=`xe sr-list type=ext host=<hostname> params=uuid --minimal`
xe host-enable-local-storage-caching host=<hostname> sr-uuid=$localsr
xe host-enable host=<hostname>
 reset true

persist true

on-boot=persist

on-
boot=reset allow-caching=true

<uuid>.vhdcache

/var/run/sr-mount/<sr-uuid>
xe sr-list params=local-cache-sr,uuid,name-label

xe host-enable-local-storage-caching host=<host> sr-uuid=<sr>

 VirtualM achine User'sGuide.

upgrade

not

multipathd
BootFrom SAN Environm ents
 Boot From SAN
Environm ents

XenServerAdm inistrator'sGuide
 XenServer Adm inistrator's Guide

em ergency
m ode

Installing XenServer and

XenCenter
 XenServer
Adm inistrator'sGuide

XenServerVirtualM achine User'sGuide

em pty

xe vbd-list type=CD empty=false

uuid ( RO) : abae3997-39af-2764-04a1-ffc501d132d9
vm-uuid ( RO): 340a8b49-866e-b27c-99d1-fb41457344d9
vm-name-label ( RO): VM02_DemoLinux
vdi-uuid ( RO): a14b0345-b20a-4027-a233-7cbd1e005ede
empty ( RO): false
device ( RO): xvdd

uuid ( RO) : ec174a21-452f-7fd8-c02b-86370fa0f654

vm-uuid ( RO): db80f319-016d-0e5f-d8db-3a6565256c71
vm-name-label ( RO): VM01_DemoLinux
vdi-uuid ( RO): a14b0345-b20a-4027-a233-7cbd1e005ede
empty ( RO): false
device ( RO): xvdd

uuid

xe vbd-eject uuid=<uuid>

xe host-disable <host-selector>=<host_selector_value>

Installing XenServerand XenCenter

 XenServer Adm inistrator's
Guide
 .xsupdate

xe -s <server> -u <username> -pw <password> patch-upload file-name=<filename>

xe patch-pool-apply uuid=<UUID_of_file>

xe patch-apply host-uuid=<UUID_of_host> uuid=<UUID_of_file>

hosts
 .xsupdate

xe -s <server> -u <username> -pw <password> patch-upload file-name=<filename>

xe patch-apply host-uuid=<UUID_of_host> uuid=<UUID_of_file>

hosts
/opt/xensource/installer/report.py

support.tar.bz2
 not

multipath

multipath

device_mapper_multipath=yes
default xenserver
label xenserver
kernel mboot.c32
append /tftpboot/xenserver/xen.gz dom0_max_vcpus=1-2 dom0_mem=1024M,max:1024M com1=115200,8n1 \
console=com1,vga --- /tftpboot/xenserver/vmlinuz \
xencons=hvc console=hvc0 console=tty0 \
device_mapper_multipath=yes \
install --- /tftpboot/xenserver/install.img

XenServer
Adm inistrator'sGuide

*
Software-boot-from-iSCSI has been tested in Legacy BIOS and UEFI boot mode using Cisco UCS vNICs and Power Vault, NetApp and
EqualLogic arrays. Other configurations may work, however, they have not been validated.
 boot: menu.c32

--- /install.img

use_ibft --- /install.img

label XenServer
kernel mboot.c32
append XS/xen.gz dom0_max_vcpus=2 dom0_mem=1024M,max:1024M
com1=115200,8n1 console=com1,vga --- XS/vmlinuz xencons=hvc console=tty0
console=hvc0 use_ibft --- XS/install.img

label XenServer
kernel mboot.c32
append XS/xen.gz dom0_max_vcpus=2 dom0_mem=1024M,max:1024M
com1=115200,8n1 console=com1,vga --- XS/vmlinuz xencons=hvc console=tty0
console=hvc0 use_ibft device_mapper_multipath=enabled --- XS/install.img
 before

/tftpboot xenserver
mboot.c32 pxelinux.0 /usr/lib/syslinux /
tftboot

mboot.c32 pxelinux.0

install.img vmlinuz
xen.gz /boot /tftpboot/xenserver

/tftboot pxelinux.cfg
pxelinux.cfg default
 tty0
default xenserver
label xenserver
kernel mboot.c32
append /tftpboot/xenserver/xen.gz dom0_max_vcpus=1-2 dom0_mem=1024M,max:1024M com1=115200,8n1
console=com1,vga --- /tftpboot/xenserver/vmlinuz \
xencons=hvc console=hvc0 console=tty0 \
--- /tftpboot/xenserver/install.img

answerfile_device=ethX answerfile_device=MAC

default xenserver-auto
label xenserver-auto
kernel mboot.c32
append /tftpboot/xenserver/xen.gz dom0_max_vcpus=1-2 dom0_mem=1024M,max:1024M com1=115200,8
console=com1,vga --- /tftpboot/xenserver/vmlinuz \
xencons=hvc console=hvc0 console=tty0 \
answerfile=http://pxehost.example.com/answerfile \
install --- /tftpboot/xenserver/install.img

/tftpboot EFI/xenserver
/EFI/xenserver/grubx64.efi
grub.cfg

menuentry "XenServer Install (serial)" {

multiboot2 /EFI/xenserver/xen.gz dom0_mem=1024M,max:1024M watchdog dom0_max_vcpus=4 com1=1
module2 /EFI/xenserver/vmlinuz console=hvc0
module2 /EFI/xenserver/install.img
}
grub.cfg /tftpboot/EFI/xenserver
grubx64.efi install.img
vmlinuz xen.gz /boot /tftpboot/EFI/
xenserver
default xenserver
label xenserver
kernel mboot.c32
append /tftpboot/EFI/xenserver/xen.gz dom0_mem=1024M,max:1024M watchdog dom0_max_vcpus=4 com1
console=com1,vga --- /tftpboot/EFI/xenserver/vmlinuz \
console=hvc0 console=tty0 \
--- /tftpboot/EFI/xenserver/install.img

answerfile_device=ethX answerfile_device=MAC

default xenserver-auto
label xenserver-auto
kernel mboot.c32
append /tftpboot/EFI/xenserver/xen.gz dom0_mem=1024M,max:1024M watchdog dom0_max_vcpus=4 co
console=com1,vga --- /tftpboot/EFI/xenserver/vmlinuz \
console=hvc0 console=tty0 \
answerfile=http://pxehost.example.com/answerfile \
install --- /tftpboot/EFI/xenserver/install.img

.treeinfo

XS-REPOSITORY-LIST
<?xml version="1.0"?>
<installation srtype="ext">
<primary-disk>sda</primary-disk>
<guest-disk>sdb</guest-disk>
<guest-disk>sdc</guest-disk>
<keymap>us</keymap>
<root-password>mypassword</root-password>
<source type="url">http://pxehost.example.com/XenServer/</source>
<post-install-script type="url">
http://pxehost.example.com/myscripts/post-install-script
</post-install-script>
<admin-interface name="eth0" proto="dhcp" />
<timezone>Europe/London</timezone>
</installation>

installation

srtype ext

XenServerand IntelliCache

SelectPrim aryDisk

yes no

yes
no

us
 hash plaintext

<root-password type="hash">hashedpassword</root-password>

url nfs local

<source type="url">
http://server/packages
</source>
<source type="local" />
<source type="nfs">
server:/packages
</source>

url nfs local

<driver-source type="url">
http://server/drivers
</driver-source>
<driver-source type="local" />
<driver-source type="nfs">
server:/drivers
</driver-source>
 filesystem -populated installation-start installation-
com plete

filesystem -populated

installation-com plete

url nfs local

url nfs local

<script stage="filesystem-populated"
type="url">
http://prehost.example.com/post-install-script
</script>
<script stage="installation-start"
type="local">
file:///scripts/run.sh
</script>
<script stage="installation-complete"
type="nfs">
server:/scripts/installation-pass-fail-script
</script>

file://
 dhcp static

eth0

required

upgrade existing-
installation prim ary-disk guest-disk

<?xml version="1.0"?>
<installation mode="upgrade">
<existing-installation>sda</existing-installation>
<source type="url">http://pxehost.example.com/XenServer/</source>
<post-install-script type="url">
http://pxehost.example.com/myscripts/post-install-script
</post-install-script>
</installation>