Configuring host objects using the CLI

You can use command-line interface (CLI) to create host objects.

If you are configuring a host object on a fibre-channel attached host, ensure that you have completed all zone and switch configuration. Also test the configuration to ensure that zoning was created correctly.

If you are configuring a host object on the cluster that uses iSCSI connections, ensure that you have completed the necessary host-system configurations and have configured the cluster for iSCSI connections.

At least one WWPN or iSCSI name must be specified.

Perform the following steps to create host objects:

Issue the svctask mkhost CLI command to create a logical host object for a fibre-channel attached host. Assign your worldwide port name (WWPN) for the host bus adapters (HBAs) in the hosts.
The following is an example of the CLI command that you can issue to create a fibre-channel attached host:
```
svctask mkhost -name new_name -hbawwpn wwpn_list
```
where new_name is the name of the host and wwpn_list is the WWPN of the HBA.
To create an iSCSI-attached host, issue the following CLI command:
```
svctask mkhost -iscsiname iscsi_name_list
```
where iscsi_name_list specifies one or more iSCSI qualified names (IQNs) of this host. Up to 16 names can be specified, provided that the command-line limit is not reached. Each name should comply with the iSCSI standard, RFD 3720.
To add ports to a fibre-channel attached host, issue the svctask addhostport CLI command.
For example, issue the following CLI command:
```
svctask addhostport -hbawwpn wwpn_list new_name 
```
This command adds another HBA WWPN wwpn_list to the host that was created in step 1.
To add ports to an iSCSI-attached host, issue the svctask addhostport CLI command.
For example, issue the following CLI command:
```
svctask addhostport -iscsiname iscsi_name_list new_name 
```
where iscsi_name_list Specifies the comma-separated list of IQNs to add to the host. This command adds an IQN to the host that was created in step 2.
To set the Challenge Handshake Authentication Protocol (CHAP) secret that is used to authenticate the host for iSCSI I/O, issue the svctask chhost CLI command. This secret is shared between the host and the cluster. For example, issue the following CLI command:
```
svctask chhost -chapsecret chap_secret
```
where chap_secret is the CHAP secret that is used to authenticate the host for iSCSI I/O. To list the CHAP secret for each host, use the svcinfo lsiscsiauth command. To clear any previously set CHAP secret for a host, use the svctask chhost -nochapsecret command.