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 }

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.

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.

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