Citrix Systems 5.6 manual Xe command reference, Bonding commands, Bond parameters, Bond-create

For scripting, a useful technique is passing --minimalon the command line, causing xe to print only the first field in a comma-separated list. For example, the command xe vm-list--minimalon a XenServer host with three VMs installed gives the three UUIDs of the VMs, for example:

a85d6717-7264-d00e-069b-3b1d19d56ad9,aaa3eec5-9499-bcf3-4c03-af10baea96b7, \ 42c044de-df69-4b30-89d9-2c199564581d

xe command reference

This section provides a reference to the xe commands. They are grouped by objects that the commands address, and listed alphabetically.

Bonding commands

Commands for working with network bonds, for resilience with physical interface failover. See the section called “Creating NIC bonds on a standalone host” for details.

The bond object is a reference object which glues together master and member PIFs. The master PIF is the bonding interface which must be used as the overall PIF to refer to the bond. The member PIFs are a set of 2 or more physical interfaces which have been combined into the high-level bonded interface.

Bond parameters

Bonds have the following parameters:

Parameter Name	Description	Type
uuid	unique identifier/object reference for the	read only
	bond
master	UUID for the master bond PIF	read only
members	set of UUIDs for the underlying bonded	read only set parameter
	PIFs

bond-create

bond-createnetwork-uuid=<network_uuid>pif-uuids=<pif_uuid_1,pif_uuid_2,...>

Create a bonded network interface on the network specified from a list of existing PIF objects. The command will fail if PIFs are in another bond already, if any member has a VLAN tag set, if the referenced PIFs are not on the same XenServer host, or if fewer than 2 PIFs are supplied.

bond-destroy

host-bond-destroy uuid=<bond_uuid>

Delete a bonded interface specified by its UUID from the XenServer host.

147