Set Host

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 virtual disk-to-LUN mappings or does not have individual virtual disk-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 must also enclose the host name in double quotes (" ").

hostGroup
The host group to which you want to assign the host. (The following table defines how the command runs if the host does or does not have individual virtual disk-to-LUN mappings.) Enclose the host group name in double quotes (" "). defaultGroup is the host group that contains the host to which the virtual disk is mapped.

userLabel
New host name. Enclose the host name in double quotes (" ").

hostType
The index label or number of the host type for the HBA host port. Use the show storageArray 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 Virtual Disk to LUN Mappings Host Does Not Have Individual Virtual Disk to LUN Mappings

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

none
Host is removed from the host group as an independent partition and is placed under the root node. Host is removed from the present host group and is placed under the default group.

defaultGroup
Command fails. 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 do not, however, need to use all of the parameters.

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

Minimum Firmware Level

6.10
7.10 adds the hostType parameter.

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 must also enclose the host name in double quotes (" ").
`hostGroup`	The host group to which you want to assign the host. (The following table defines how the command runs if the host does or does not have individual virtual disk-to-LUN mappings.) Enclose the host group name in double quotes (" "). `defaultGroup` is the host group that contains the host to which the virtual disk is mapped.
`userLabel`	New host name. Enclose the host name in double quotes (" ").
`hostType`	The index label or number of the host type for the HBA host port. Use the `show storageArray 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 Virtual Disk to LUN Mappings	Host Does Not Have Individual Virtual Disk to LUN Mappings
`hostGroupName`	Host is removed from the present host group and is placed under the new host group defined by `hostGroupName`.	Host is removed from the present host group and is placed under the new host group defined by `hostGroupName`.
`none`	Host is removed from the host group as an independent partition and is placed under the root node.	Host is removed from the present host group and is placed under the default group.
`defaultGroup`	Command fails.	Host is removed from the present host group and is placed under the default group.