4.8. host
The
host
resource type groups all host resources in a Red Hat Virtualization environment.
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.
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
Example 4.18. Updating a host
[RHEVM shell (connected)]# update host Host1 --name Host2
Example 4.19. Deleting a host
[RHEVM shell (connected)]# remove host Host1
The following table lists actions for a host resource.
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.
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