Set Host

This command assigns a host to a host group or moves a host to a different host group. You can also create a new host group and assign the host to the new host group with this command. The actions performed by this command depend on whether the host has individual logical drive-to-LUN mappings or does not have individual logical drive-to-LUN mappings.

Syntax

set host [hostName] hostGroup=(“hostGroupName” | none | defaultGroup) userLabel=“newHostName” hostType=(hostTypeIndexLabel | hostTypeIndexNumber)

Parameters
Parameter Description
host The name of the host that you want to assign to a host group. Enclose the host name in square brackets ([ ]). If the host name has special characters, you also must enclose the host name in double quotation marks (“ ”).
hostGroup The name of the host group to which you want to assign the host. (This table defines how the command runs if the host does or does not have individual logical drive‑to‑LUN mappings.) Enclose the host group name in double quotation marks (“ ”). The defaultGroup option is the host group that contains the host to which the logical drive is mapped.
userLabel The new host name. Enclose the host name in double quotation marks (“ ”).
hostType The index label or number of the host type for the HBA host port. Use the show storageSubsystem hostTypeTable command to generate a list of available host type identifiers. If the host type has special characters, enclose the host type in double quotation marks (“ ”).
Host Group Parameter Host Has Individual Logical Drive‑to‑LUN Mappings Host Does Not Have Individual Logical Drive‑to‑LUN Mappings

hostGroupName

The host is removed from the present host group and is placed under the new host group defined by hostGroupName.

The host is removed from the present host group and is placed under the new host group defined by hostGroupName.

none The host is removed from the host group as an independent partition and is placed under the root node. The host is removed from the present host group and is placed under the default group.
defaultGroup The command fails. The host is removed from the present host group and is placed under the default group.
Notes

When you use this command, you can specify one or more of the optional parameters.

You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Names can have a maximum of 30 characters.

The CHAP secret must be between 12 characters and 57 characters. Table 57 lists the valid characters.

Valid Characters for a CHAP Secret

Space ! # $ % & ( ) * +
, - . / 0 1 2 3 4 5 6 7
8 9 : ; < = > ? @ A B C
D E F G H I J K L M N O
P Q R S T U V W X Y Z [
\ ] ^ _ a b c d e f g
h i j k l m n o p q r s
t u v w x y z { | } ~  
Minimum Firmware Level

6.10