storcfg host -mod

Modifies the attributes of a host already contained in the StorMan repository.

If a parameter is not specified, the corresponding attribute is not changed.

Syntax

storcfg host –mod {–name hostname | –ip ip | –wwpn wwpn | –iqn iqn}
                 [ –newname hostname ]
                 { –newip ip[,...] | –addip ip | –remip ip }
                 { –newwwpn wwpn[,...] | –addwwpn wwpn | –remwwpn wwpn }
                 { –newiqn iqn[,...] | –addiqn iqn | –remiqn iqn }
                 –connectparam ...

Parameters

–name hostname

Identifies the host by its name which is used as a uniqe identifier.

–ip ip

Identifies the host by an IP address belonging to the host which is used as a uniqe identifier.

–wwpn wwpn

Identifies the host by a WWPN belonging to the host which is used as a uniqe identifier.

–iqn iqn

Identifies the host by a IQN belonging to the host which is used as a uniqe identifier.

Exactly one of the parameters –name, –ip, -wwpn or -iqn must be specified to identify the host.

–newname hostname

Specifies the new name of the host. If the –newname is specified without a value, the name is removed.

Refer to the common description of ”hostname” in chapter "Common supported value ranges".

–newip ip[,...]

Specifies a list of IP addresses delimited by comma. The previous IP addresses of the host are replaced by the specified list. i.e. if the specified list is empty, it results in a host with no IP addresses. 

–addip ip[,...]

Assigns a single IP address to the host.

–remip ip

Deassigns a single IP address from the host.

–newwwpn wwpn[,...]

Assigns a list of WWPNs delimited by comma to assign to the host. Specifies a list of wwpns delimited by comma. The previous wwpns of the host are replaced by the specified list. i.e. if the specified list is empty, it results in a host with no wwpns. 

–addwwpn wwpn

Assigns a single WWPN to the host.

–remwwpn wwpn

Deassign a single WWPN from the host.

–newiqn iqn[,...]

Assigns a list of IQNs delimited by comma to assign to the host. The previous IQNs of the host are replaced by the specified list. i.e. if the specified list is empty, it results in a host with no IQN. 

–addiqn iqn

Assigns a single IQN to the host.

–remiqn iqn

Deassigns a single IQN from the host.

–connectparam

Refer to the description of the "Connection parameters".

Only one of the parameters -newip, -addip or -remip can be specified to modify the IP address assignment to the host. Combined input of these parameters is rejected with STORMAN_INV_PARAMETERS. If a specified IP address is already assigned to a different host, the (re)assignment of this IP address is rejected with return code STORMAN_ALREADY_EXISTS.

Only one of the parameters –newwwpn, -addwwpn or -remwwpn can be specified to modify the WWPN assignment to the host. Combined input of these parameters is rejected with STORMAN_INV_PARAMETERS. If a specified WWPN is already assigned to a different host, the (re)assignment of this WWPN is rejected with return code STORMAN_ALREADY_EXISTS.

Only one of the parameters –newiqn, -addiqn or -remiqn can be specified to modify the IQN assignment to the host. Combined input of these parameters is rejected with STORMAN_INV_PARAMETERS. If a specified IQN is already assigned to a different host, the (re)assignment of this IQN is rejected with return code STORMAN_ALREADY_EXISTS. 

Return codes

Error Code	Name	Error Type
0	STORMAN_OK	Function successful
3	STORMAN_VER_NOT_SUPP	Version not supported
7	STORMAN_INV_PARAMETERS	Specified parameters invalid
13	STORMAN_COMMUNIC_ERROR	Error in StorMan communication between client and server
16	STORMAN_FAULT	Unexpected error in function
18	STORMAN_NOT_FOUND	Specified host could not be found
20	STORMAN_ALREADY_EXISTS	Object already exists in repository
36	STORMAN_AUTH_FAILED	User / password for StorMan not valid