mkhost

You can use the mkhost command to create a logical host object.

Syntax

Read syntax diagramSkip visual syntax diagram>>- svctask -- -- mkhost -- --+-------------------------+-- ---->
                              '- -name -- new_name_arg -'

>-- -hbawwpn -- wwpn_list -- --+----------+--------------------><
                               '- -force -'

Parameters

-name new_name_arg
Optionally specifies a name or label for the new object.
-hbawwpn wwpn_list
Specifies a list of host bus adapter (HBA) worldwide port names (WWPNs) to add to this host object.
-force
Optionally forces the creation. This argument stops any validation of the WWPNs.

Description

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.

Possible failures

Examples

An invocation example

svctask mkhost -name hostone -hbawwpn 210100E08B251DD4 -force

The resulting output

Host id [1] successfully created.

(C) Copyright International Business Machines Corporation 2003, 2004