XenServer Commands

XenServer Commands

If you found the information on my blog valuable, please consider making a bitcoin donation to 1FyWnKFAVwSEELfieENDoKDhdCEgR9Lq2j

  • Fix XenServer Storage that is not connected

xe sr-scan uuid=
xe pbd-list
xe pbd-plug uuid=

  • Export XVA

xe vm-export vm=uuid filename=SR_Volume\filename.xva –compress

  • XenServer Patch Management
xe patch-destroy
  • List overall SR usage:

pvs |egrep ‘ea9194fc|Free’

  • List all VDIs on a given SR:

lvs | grep SR-UUID

lvs |grep ea9194fc

  • Get all VDIs and their trees:

vhd-util scan -f -a -p -c -m VHD-* -l VG_XenStorage-<UUID of the SR you want to scan>
vhd-util scan -f -a -p -c -m VHD-* -l VG_XenStorage-ea9194fc-a6c1-9f9a-529c-f9f3233e1f81

  • Open XenServer Debug Status report in XenCenter

Add file location to XenCenter eg: c:\server reports\2011-06-28-14-51-22-1-bugtool-XEN01\bug-report-20110628145134\xapi-db.xml

  • Configure SR-IOV/opt/xensource/libexec/xen-cmdline –set-xen iommu=1

xe vm-param-set other-config:pci=0/0000:07:10.0 uuid=uuid_of_the_VM

  • Enable and Disable Open VSwitchxe-switch-network-backend bridge

xe-switch-network-backend openvswitch

  • Setup Diagnostic Websitecd /opt/xensource/www

ln –s /opt/xensource/debug/www debug

  • Configure Auto Start VMsPool Config : xe pool-param-set uuid=… other-config:auto_poweron=true

VM Config: xe vm-param-set uuid=… other-config:auto_poweron=true

  • iSCSI Commandsdiscover: iscsiadm –mode discovery –type sendtargets –portal <IP-Address of the iSCSI target>

login: iscsiadm –mode node –targetname <target IQN you have discovered before> –portal <IP-Address of your Target>:3260 –login
logout: iscsiadm –mode node –targetname <target IQN you have discovered before> –portal <IP-Address of your Target>:3260 –logout

  • View TapDiskstap-ctl list

ls -l /var/run/sr-mount/…..

  • Compare Template Differencesxe template-list name-label=Citrix\ XenApp\ on\ Windows\ Server\ 2003\ \(32-bit)\) params=all >> /root/2k3-32

xe template-list name-label=Citrix\ XenApp\ on\ Windows\ Server\ 2008\ \(32-bit)\) params=all >> /root/2k8-32
diff –side-by-side –suppress-common-lines /root/2k3-32 /root/2k8-32 (to see which parameters differ)
diff –suppress-common-lines /root/2k3-32 /root/2k8-32 (to see the full difference)

xe host-call-plugin host-uuid=<host-UUID> plugin=coalesce-leaf fn=leaf-coalesce args:vm_uuid=<VM-UUID>

  • Emergency Master Server Failure Recoveryxe host-emergency-ha-disable force=true

xe pool-emergency-transition-to-master
pool-designate-new-master host-uuid=<UUID of member XenServer host to become new master>
cat /etc/xensource/pool.conf to reflect to the new master.
Restarted XAPI service and it back to the pool.

  • Remove a Lost server from a Resource Pool

xe host-list

xe -s [ip address] -u root -pw PASSWORD pool-sync-database

xe -s [ip address] -u root -pw PASSWORD host-forget uuid=[the above command will provide the UUID]

xe pool-eject host-uuid

  • Copy a VM to another XenServer

xe vm-list (note the name of the VM you wish to copy)

xe sr-list (note the name of the storage you will to copy the VM to)

xe vm-copy (needs the following parameters to complete)

xe vm-copy vm=<name of VM to copy> sr-uuid=<UUID of SR to copy VM to> new-name-label=<NewNameofVM> new-name-description=”Description of VM”

  • Force Pool master Selection

xe pool-emergency-transition-to-master

xe pool-recover-slaves

xe host-list

xe pool-sync-database

xe host-forget

  • Check if XenServer is a Pool Master

cat /etc/xensource/pool.conf

Output says “master” , slaves output “slave:<master host IP>”

  • Enable Open vSwitch

xe-switch-network-backend openvswitch

xe host-list params=software-version

  • Enter XenServer Config Menu via SSH


  • Configure HA Timeout
      • xe pool-ha-enable heartbeat-sr-uuids=021e7e21-1e64-a0b3-2e22-5bbfcfe559e9 ha-config:timeout=10
      • Minimum timeout is 10 seconds
      • Default is 30 Seconds
      • xe pool-ha-compute-max-host-failures-to-tolerate
  • Destroying or forgetting a SR (Storage Repository)

xe -s [host ip] -u root -pw [password] sr-list

xe -s [host ip] -u root -pw [password] pbd-list sr-uuid=

xe -s [host ip] -u root -pw [password] pbd-unplug uuid=

xe -s [host ip] -u root -pw [password] pbd-destroy uuid=

xe -s [host ip] -u root -pw [password] sr-forget uuid=

  • xentop

displays real-time information about Xen system.

  • xen-bugtool –yestoall
  • Set HA Timeouot

xe pool-ha-enable heartbeat-sr-uuids=##### ha-config:timeout=however many seconds you want.

  • VM Operations

xe task-list

xe task-cancle uuid=xe

vm-shutdown –force vm=

  • Overload CPU for testing Workload Balancing

while true ; do true ; donewhile true ; do true ; done &while true ; do `ls –lR /` ; done

  • How to Create a Local Storage Repository (CTX121313)

# cat /proc/partitions

# ll /dev/disk/by-id

Find the disk ID of the “sdb” or “cciss/c0d1”disk. The “scsi-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx” or “cciss-xxxxxxxxxxxxxxxxxxxxxxxxxx”format is what you need.

Create a Storage Repository (SR):

# xe sr-create content-type=user device-config:device=/dev/disk/by-id/<scsi-xxxxxxxxxxxxxxxxxxxxxxxxx> host-uuid=<host-uuid> name-label=”Local Storage 2” shared=false type=lvm-

Or –

# xe sr-create content-type=user device-config:device=/dev/disk/by-id/<cciss-xxxxxxxxxxxxxxxxxxxxxxxxx> host-uuid=<host-uuid> name-label=”Local Storage 2” shared=false type=lvm


xe sr-create name-label=”Local ISO” type=iso device-config:location=/var/run/sr-mount/21972e3c-41fe-c071-bc6c-248692be51fb/iso device-config:legacy_mode=true content-type==iso 76f6f72c-7239-9142-f23c-97d7cea34c3c

  • Cancel XenServer Tasks

xe task-list

xe task-cancel uuid=<task uuid>

  • Install XenTools on Linux

mount /dev/xvdd /mnt

cd /mnt/Linux


QLogic, run scli

Emulex, run hbanywhere

Emulex: /bin/sbin/ocmanager

QLogic FC: /opt/QLogic_Corporation/SANsurferCLI

QLogic iSCSI: /opt/QLogic_Corporation/SANsurferiCLI

Enable HA

  • xe vm-param-set uuid=<vm_uuid> ha-restart-priority=<1> ha-always-run=true
  • xe pool-ha-enable heartbeat-sr-uuids=<sr_uuid>

Reboot Host in HA

  • host-disable host=<hostname>
  • host-evacuate uuid=<host uuid>
  • host-shutdown host=<hostname>

Designate new master

  • Xe pool-designate-new-master host-uuid=<UUID of member XenServer host to become new master>

Pool Emergency Actions

  • host-emergency-ha-disable –force
  • pool-recovery-slaves
  • pool-eject host-uuid=<host UUID>
  • pool-emergency-reset-master master-address=<ip address of pool master>
  • pool-emergency-transition-to-master uuid=<host uuid>
  • xe pool-join master-address=<host1> master-username=<administrators_username> master-password=<password>

Snapshot Copy (Fast Clone)

  • xe snapshot-list snapshot-of=<vm uuid>
  • xe snapshot-copy new-name-label=<vm-template-name> snapshot-uuid=<uuid of the snapshot>
  • xe template-list
  • xe snapshot-export-to-template snapshot-uuid=<uuid of snapshot> filename=<template filename> (.XVA)
  • other-config snapmanager=true
  • xe vm-snapshot-with-quiesce vm=<vm uuid> ne-name-lablel=<name of new vm> (install-XenProvider.cmd)

Memory Consistent Snapshots

  • xe vm-checkpoint vm=<vm uuid> new-name-lable=<name of the snapshot>

Role Based Administration 

  • xe subject-add subject-name=[active directory account name]
  • xe subject-role-add uuid=<subject uuid> role-name=<role_name>

Configure Management Interface

  • xe pif-scan, xe pif-list, xe pif-reconfigure-ip, xe host-management-reconfigure

Create NFS ISO Repository

  • xe sr-create host-uuid=<mast uuid> content-type=iso name-lable=<”name”> location=\\

Create a shared NFS SR on

  • xe sr-create host-uuid=<host_uuid> content-type=user name-label=<“Example shared NFS SR”> shared=true device-config:server=<> device-config:serverpath=</export1> type=nfs

Physic NIC configuration

  • xe pif-scan
  • xe pif-plug
  • xe  pif-introduce

VM in libo

  • xe vm-list
  • xe vm-reset-powerstate uuid=<uuid of VM> force=true

XAPI stack

  • service xapi status
  • service xapi restart
  • xe-toolstack-restart

XenServer Log Files

  • /var/log – XenServer Log Files
  • /etc/logrotate.conf – XenServer Log Rotation Configuration File

  Search SR to locate metadata

  • xe sr-probe type=lvmoiscsi device-config:target=IP device-config:targetIQN=IQN device-config:SCSIid=SCSIID sm-config:metadata=true   

Check VDI database

  • xe vm-list database:vdi-uuid=$my_vdi

Check inventory

  • . /etc/xensource-inventory
  • xe host-list uuid=$INSTALLATION_UUID

Exporting and Importing VMs via API – http://docs.vmd.citrix.com/XenServer/5.6.0fp1/1.0/en_gb/sdk.html#vm_import_and_export