Set host
The set host command assigns a host to a host group or moves a host to a different host group.
Supported Arrays
This command applies to an individual DE2000H, DE4000H, DE4000F, DE6000H, or DE6000F storage array.
Roles
To execute this command on an storage array, you must have the Storage Admin role.
Context
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 mappings or does not have individual mappings.
Syntax
set host [<var id="GUID-C22D5C27-E798-41E7-BE1F-A2FD98A4EA4E__V1110121" className="keyword varname">hostName</var>]
hostGroup=(<var id="GUID-C22D5C27-E798-41E7-BE1F-A2FD98A4EA4E__V1110122" className="keyword varname">"hostGroupName"</var> | none | defaultGroup)
userLabel=<var id="GUID-C22D5C27-E798-41E7-BE1F-A2FD98A4EA4E__V1110123" className="keyword varname">"newHostName"</var>
hostType=(<var id="GUID-C22D5C27-E798-41E7-BE1F-A2FD98A4EA4E__V1110124" className="keyword varname">hostTypeIndexLabel </var>| <var id="GUID-C22D5C27-E798-41E7-BE1F-A2FD98A4EA4E__V1110125" className="keyword varname">hostTypeIndexNumber</var>)
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 or numbers, you must enclose the host name in double quotation marks (" ") inside square brackets. |
| hostGroup | The name of 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 mappings.) Enclose the host group name in double quotation marks (" "). The defaultGroup option is the host group that contains the host to which the volume 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 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 Mappings | Host Does Not Have Individual 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.
For the names, you can use any combination of alphanumeric characters, hyphens, and underscores. Names can have a maximum of 30 characters.