Set host

09/10/2024 Contributors

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 any individual storage array, including the E4000, E2700, E5600, E2800, E5700, EF600 and EF300 arrays, as long as all SMcli packages are installed.

Roles

To execute this command on an E4000, E2800, E5700, EF600, or EF300 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 [hostName]
hostGroup=("hostGroupName" | none | defaultGroup)
userLabel="newHostName"
hostType=(hostTypeIndexLabel | hostTypeIndexNumber)

Parameters

Parameter Description

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

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

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.

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.

Minimum firmware level

6.10