raidcom modify server

Storage Advisor Embedded User Guide

Version
93-07-2x
88-08-12
Audience
anonymous
Part Number
MK-97HM85022-25
Supported storage systems:
  • VSP G130, G/F350, G/F370, G/F700, G/F900
Modifies a server managed by Storage Advisor Embedded. To execute this command, you need to log in to the storage system with the user account belonging to the user group to which "all resource groups" are set. In addition, you must be able to perform operations with all implemented resource groups. Therefore, this command cannot be executed if any of the following conditions is met:
  • The command device belonging to a resource group other than meta_resource is used in the in-band management.
  • The virtual storage machine that contains only some of the implemented resource groups is specified as HORCM_VCMD in the configuration file.
Note: If a failure occurs in a processor on an MP blade or a controller, this command cannot be run even on an MP blade or a controller on which no failure occurs.

When you run this command, the processing is run asynchronously with the command input. Verify that the processing is complete by using the raidcom get command_status command. There is a limit to the number of asynchronous commands that can be accepted simultaneously. For details, see Maximum number of acceptable asynchronous commands.

Syntax

raidcom modify server {-server_id <id>|-server_name <name>} -request_id auto {-server_operation {add_host_grp|delete_host_grp} -port <port> [<host group name>]}

Options and parameters

{-server_id <id>|-server_name <name>} -request_id auto

Specifies the ID or nickname of the server to be modified.

You need to specify the server ID (0 through 4095) in decimal or hexadecimal in -server_id <id>. To specify in hexadecimal, add "0x" at the beginning of the server ID. For example:

  • -server_id 128
  • -server_id 0x80

To specify the server nickname, specify the server nickname in -server_name <name> with one character through 229 characters.

The following are the characters that can be used:

0 through 9, A through Z, a through z, -. /: @ \ _ single-byte space

The specified server is deleted by executing this command. The registered host groups or iSCSI targets are not deleted.

The request ID is output in the following format when the execution of the raidcom modify server command ends:
  • REQID : <request#>

<request#> is a request ID assigned each time the command is executed. For details, see Request ID function.

-server_operation add_host_grp -port <port> [<host group name>]

Registers the host groups or the iSCSI targets specified with the -port <port> [<host group name>] on the server specified for the -server_id <id> or the -server_name <name>.

If the WWN or iSCSI name of the host is registered in the specified host groups or iSCSI targets, the WWN or iSCSI name of the host is registered on the server. In addition, if an LU path is defined for a specified host groups or iSCSI targets, the LDEV associated with the LU path is registered on the server.

For -port <port> [<host group name>], specify the port number and host groups (iSCSI target ID for iSCSI), or host group name (target alias for iSCSI).

If the host group name or the target alias is more than 64 characters, the host group name or the target alias cannot be specified. Use the host group ID or the target ID. For example:
  • CL1-A -g (g is from 1 to 254)
  • CL1-A Linux_X86
  • CL1-A Target00

To check if host groups or iSCSI targets are registered on the server, execute the raidcom get host_grp command with the -key server option specified.

If any of the following conditions is met, the command execution fails:
  • The specified server and host group/iSCSI target are not installed.
  • The IDs of the specified host groups or iSCSI targets are 0.
  • The host group/iSCSI target, LU path, or LDEV information on the specified server is being updated.
  • The iSCSI target is specified even if the specified server protocol is Fibre. Alternatively, a host group is specified even if the specified server protocol is iSCSI.
  • The host group/iSCSI target which has already been registered on other servers is specified.
  • Another host group/iSCSI target on the same port as the one used for the specified host group/iSCSI target has already been registered on the specified server.
  • If 32 WWNs or iSCSI names of the host have been registered on the specified server, the host group/iSCSI target including WWNs or iSCSI names that are not registered on the server is specified.
  • The specified host group/iSCSI target, the port to which the host group/iSCSI target belongs, or the resource group to which the LDEV associated with the LU path of the host group/iSCSI target belongs is locked by another user.
  • The LU path to an LDEV other than that for Dynamic Provisioning, Dynamic Tiering, or active flash exists in the specified host group/iSCSI target.
  • The LDEV for a Volume Migration pair including LDEV other than that for Dynamic Provisioning, Dynamic Tiering, or active flash is specified.
  • The host group/iSCSI target on the port with the LU security set to OFF is specified.
-server_operation delete_host_grp -port <port> [<host group name>]

Specifies the iSCSI virtual port ID when the specified port is iSCSI and the iSCSI virtual port mode is enabled. If this option is omitted, 0 is assumed.

From the server specified for -server_id <id> or -server_name <name>, delete the host groups or iSCSI targets specified with -port <port> [<host group name>].

The LDEV is deleted from the server if an LU path is defined for the specified host groups or iSCSI targets, and if the LU path is the last one of the LDEV associated with the LU path on the specified server.

For -port <port> [<host group name>], specify the port number and host groups (iSCSI target ID for iSCSI), or the host group name (target alias for iSCSI). If the host group name or the target alias is more than 64 characters, the host group name or the target alias cannot be specified. Use the host group ID or the target ID.

For example:
  • CL1-A -g (g is from 1 to 254)
  • CL1-A Linux_X86
  • CL1-A Target00

To check if host groups or an iSCSI targets are registered on the server, execute the raidcom get host_grp command with the -key server option specified.

If any of the following conditions is met, the command execution fails:

  • The specified server and host group/iSCSI target are not installed.
  • The IDs of the specified host groups or iSCSI targets are 0.
  • The host group/iSCSI target, LU path, or LDEV information on the specified server is being updated.

Examples

Adding CL1-A-1 to server ID: 0.

#raidcom modify server -server_id 0 -request_id auto -server_operation add_host_grp -port CL1-A-1
REQID:0

Deleting CL1-A-1 from server ID: 0.

#raidcom modify server -server_id 0 -request_id auto -server_operation delete_host_grp -port CL1-A-1
REQID:0