>>- svctask -- -- mkhost -- --+-------------------------+-- ----> '- -name -- new_name_arg -' >-- -hbawwpn -- wwpn_list -- --+----------+-------------------->< '- -force -'
This command associates one or more HBA WWPNs with a logical host object. You can subsequently use this object when mapping virtual disks to hosts. This command creates a new host. The ID is returned when the command completes.
You only need to issue this command once. The cluster scans the fabric for WWPNs in the host zone. The cluster itself cannot filter into the hosts to determine which WWPNs are in which hosts. Therefore, you must use the svctask mkhost command to identify the hosts.
After you identify the hosts, mappings are created between hosts and virtual disks. These mappings effectively present the virtual disks to the hosts to which they are mapped. All WWPNs in the host object will be mapped to the virtual disks.
Some HBA device drivers do not log in to the fabric until they can see target logical unit numbers (LUNs). Because they do not log in, their WWPNs will not be recognized as candidate ports. You can specify the force flag with this command to stop the validation of the WWPN list.
See also the svctask mkvdiskhostmap and svcinfo lshbaportcandidate commands.
An invocation example
svctask mkhost -name hostone -hbawwpn 210100E08B251DD4 -force
The resulting output
Host id [1] successfully created.