HP 3PAR OS 3.1.3 Command Line Interface Reference

Specifies any additional information for the host.
SPECIFIERS
<host_name>
Specifies the name of the host, using up to 31 characters.
<WWN>
Specifies the World Wide Name (WWN) to be assigned or added to an existing host. This specifier
can be repeated to specify multiple WWNs. This specifier is optional.
<iSCSI_name>
Host iSCSI name to be assigned or added to a host. This specifier is optional.
RESTRICTIONS
Access to all domains is required to run this command.
EXAMPLES
The following example creates system host test01:
cli% createhost test01 2000000087041F72
The following example creates an iSCSI host test02:
cli% createhost -iscsi test02 iqn.1991-06.com.microsoft:dt-391-xp.hq.3par.com
The following example creates host ibm520-13 with an 8/AIX-legacy host persona:
cli% createhost -persona 3 ibm520-13 10000000C97B142E
NOTES
• If the host is running the HP 3PAR Host Agent then createhost may be called with no paths
and the hostname reported by the agent to create the host with all reported paths. If no agent
is running then createhost with no paths creates a host without assigning a host path. The
-add option modifies an existing host by associating a host path with that host. If the -add
option is not used, the createhost command defines a new host.
• If assigning paths to a host you are creating, specify the -f option to remove any existing
VLUNs associated with those paths to avoid any conflicting VLUNs.
• Verify the creation of a host by issuing the showhost command.
• The options that allow for adding descriptive information are for annotation purposes only;
the storage server does not actively use the information provided here.
• Although it is optional to specify a host persona, a host must have one. If one is not specified,
it will default to 1 (Generic). This will not operate correctly with all types of hosts. The host
persona can be changed with sethost -persona.
• Host personas cannot be specified with the -add argument.
• A port's FC parameters should be set with controlport config.
createhost 113