4.8. host

The host resource type groups all host resources in a Red Hat Enterprise Virtualization environment.

Expand

Table 4.17. Host parameters
Name	Type	Description	Required	User Creatable	User Updatable
`--name`	string	The name of the host.	Yes	Yes	Yes
`--address`	string	The IP address or hostname for the host.	Yes	Yes	Yes
`--root_password`	string	The password for the host's `root` user.	Yes	Yes	Yes
`--cluster-id\|name`	string	Defines the cluster that includes the host.	Yes	Yes	Yes
`--port`	int	The port for communication with the VDSM daemon running on the host.	No	Yes	Yes
`--storage_manager-priority`	int	Sets the priority of host order for storage pool manager (SPM).	No	Yes	Yes
`--power_management-type`	string	The type of power management device in the host.	No	Yes	Yes
`--power_management-enabled`	boolean	Indicates whether power management configuration is enabled or disabled.	No	Yes	Yes
`--power_management-address`	string	The host name or IP address of the power management device.	No	Yes	Yes
`--power_management-user_name`	string	A valid user name for power management.	No	Yes	Yes
`--power_management-password`	string	A valid, robust password for power management.	No	Yes	Yes
`--power_management-options-option`	collection	Fencing options for the selected `power_management-type`.	No	Yes	Yes
`--reboot_after_installation`	boolean	Defines if the host reboots after VDSM installation.	No	Yes	No

The --power_management-options-option parameter is a collection that uses the sub-parameters in the following table.

Expand

Table 4.18. --power_management-options-option parameters
Name	Type	Description
`option.name`	string	Power management option name.
`option.value`	string	Power management option value.

Example 4.17. Creating a new host

[RHEVM shell (connected)]# add host --name Host1 --address host1.example.com --root_password p@55w0rd! --cluster-name Default

[RHEVM shell (connected)]# add host --name Host1 --address host1.example.com --root_password p@55w0rd! --cluster-name Default

Copy to Clipboard

Toggle word wrap

Example 4.18. Updating a host

[RHEVM shell (connected)]# update host Host1 --name Host2

[RHEVM shell (connected)]# update host Host1 --name Host2

Copy to Clipboard

Toggle word wrap

Example 4.19. Deleting a host

[RHEVM shell (connected)]# remove host Host1

[RHEVM shell (connected)]# remove host Host1

Copy to Clipboard

Toggle word wrap

The following table lists actions for a host resource.

Expand

Table 4.19. Host actions
Action	Description
`activate`	Activate a host.
`approve`	Approve a host.
`commitnetconfig`	Save the network configuration.
`deactivate`	Deactivate a host.
`fence`	Fence a host.
`forceselectspm`	Select the host to be the Storage Pool Manager.
`install`	Install VDSM on a host.
`iscsidiscover`	Perform an iSCSI discover command.
`iscsilogin`	Perform an iSCSI login command.

The following table lists additional options for the fence action.

Expand

Table 4.20. Fencing options
Option	Description
`manual`	Manually fence the host. Use this action to confirm to the Manager that the host became non-responsive and was manually rebooted.
`restart`	Restart the host, implemented as stop, wait, status, start, wait, status.
`start`	Power on the host.
`stop`	Power off the host.
`status`	Check the operational status of the host.

Example 4.20. Confirming a host is rebooted

[RHEVM shell (connected)]# action host Host1 fence --fence_type manual

[RHEVM shell (connected)]# action host Host1 fence --fence_type manual

Copy to Clipboard

Toggle word wrap