User's Manual

160
Be careful when using this CLI command off-host and ensure that you have network connectivity on the
new interface. Use xe pif-reconfigure to set one up first. Otherwise, subsequent CLI commands will reach
the XenServer host.
host-power-on
host-power-on [host=<host_uuid> ]
Turns on power on XenServer hosts with Host Power On functionality enabled. Before using this command,
host-set-power-on must be enabled on the host.
host-set-power-on
host-set-power-on {host=<host uuid> {power-on-mode=<""> <"wake-on-lan"> <"iLO"> <"DRAC">
<"custom"> } | [power-on-config=<"power_on_ip"><"power_on_user"><"power_on_password_secret">] }
Use to enable Host Power On functionality on XenServer hosts that are compatible with remote power
solutions. Workload Balancing requires Host Power On functionality is enabled for it to turn off underused
hosts in Maximum Density mode. When using the host-set-power-on command, you must specify the
type of power management solution on the host (that is, the <power-on-mode>). Then specify configuration
options using the <power-on-config> argument and its associated key-value pairs. To use the secrets feature
to store your password, specify the key "power_on_password_secret".
host-reboot
host-reboot [<host-selector>=<host_selector_value>...]
Reboot the specified XenServer hosts. The specified XenServer hosts must be disabled first using the xe
host-disable command, otherwise a HOST_IN_USE error message is displayed.
The host(s) on which this operation should be performed are selected using the standard selection
mechanism (see host selectors above). Optional arguments can be any number of the host selectors listed
at the beginning of this section.
If the specified XenServer hosts are members of a pool, the loss of connectivity on shutdown will be handled
and the pool will recover when the XenServer hosts returns. If you shut down a pool member, other members
and the master will continue to function. If you shut down the master, the pool will be out of action until the
master is rebooted and back on line (at which point the members will reconnect and synchronize with the
master) or until you make one of the members into the master.
host-restore
host-restore [file-name=<backup_filename>] [<host-selector>=<host_selector_value>...]
Restore a backup named file-name of the XenServer host control software. Note that the use of the
word "restore" here does not mean a full restore in the usual sense, it merely means that the compressed
backup file has been uncompressed and unpacked onto the secondary partition. After you've done a xe
host-restore, you have to boot the Install CD and use its Restore from Backup option.
The host(s) on which this operation should be performed are selected using the standard selection
mechanism (see host selectors above). Optional arguments can be any number of the host selectors listed
at the beginning of this section.
host-set-hostname-live
host-set-hostname host-uuid=<uuid_of_host> hostname=<new_hostname>