4.2.1 acarray add (ETERNUS Disk storage system registration command)

NAME

acarray add - Registration of ETERNUS Disk storage system

SYNOPSIS

To register a storage device which is operated by Copy command via SAN

acarray add -a DISKARRAY-NAME -ip DISKARRAY-IP -user USER -password PASSWORD [-san] [-path ACCESSVOLUME] [-xml]

To register a storage device which is operated by Copy command via LAN

acarray add -a DISKARRAY-NAME -ip DISKARRAY-IP -user USER -password PASSWORD -lan [-xml]

To register a remote ETERNUS Disk storage system

acarray add -a DISKARRAY-NAME -boxid BOX-ID -remote [-xml]

DESCRIPTION

This command registers ETERNUS Disk storage system.

OPTIONS

-a DISKARRAY-NAME

This option specifies the ETERNUS names that are used by AdvancedCopy Manager CCM or Express.
Specify it in the alphanumeric character within 255 characters.

When using Web Console, specify a device name of ETERNUS Disk storage system as ETERNUS name.
ETERNUS names are case-sensitive. When you specify an ETERNUS name by using another command, enter the ETERNUS name specified with this option correctly.

-ip DISKARRAY-IP: This option specifies the IP address of an ETERNUS Disk storage system.
An error will occur when an attempt is made to register an ETERNUS Disk storage system with the same IP address as an ETERNUS Disk storage system that has already been registered.

-user USER

This option specifies the user who has the following privileges.

Storage device	Privileges
ETERNUS Disk storage system which can operate by using Copy command via LAN	Software role of ETERNUS Disk storage system
ETERNUS Disk storage system which cannot operate by using Copy command via LAN	Administrator authorization of ETERNUS Disk storage system

Specify the user name using a string that is between 1 and 32 characters long.

Refer to the ETERNUS Web GUI manuals for more information about ETERNUS Web GUI.
Refer to "Table 1.1 ETERNUS Disk storage system that can be operated by Copy command via SAN or via LAN" for storage devices which can operate by using Copy command via LAN.

-password PASSWORD: This option specifies the password for the user name specified with -user option.

-path ACCESSVOLUME

This option specifies the access volume in the logical volume within an ETERNUS Disk storage system that was specified with -a option.

OS type	Explanation
Windows	Specify the drive letter (e.g. X:).
Solaris	Specify a device name from the following: OS standard device name (/dev/rdsk/) Solaris standard multipath (MPxIO) device name (/dev/rdsk/) ETERNUS multipath device name (/dev/FJSVmplb/rdsk/) VxVM device name (/dev/vx/rdmp/)
Linux	Specify a device name from the following: OS standard device name (/dev/sd) Multipath device name generated by device mapper infrastructure of OS (/dev/mapper/) udev device name generated by udev infrastructure of OS (/dev/disk/by-id/, /dev/disk/by-path/)

OS type

Explanation

Windows

Specify the drive letter (e.g. X:).

Solaris

Specify a device name from the following:

OS standard device name (/dev/rdsk/*)
Solaris standard multipath (MPxIO) device name (/dev/rdsk/*)
ETERNUS multipath device name (/dev/FJSVmplb/rdsk/*)
VxVM device name (/dev/vx/rdmp/*)

Linux

Specify a device name from the following:

OS standard device name (/dev/sd*)
Multipath device name generated by device mapper infrastructure of OS (/dev/mapper/*)
udev device name generated by udev infrastructure of OS (/dev/disk/by-id/*, /dev/disk/by-path/*)

The access volume is automatically set if this option is omitted.
When registering the ETERNUS Disk storage system which is operated by Copy command via LAN, it is unnecessary to specify this option.

-san: This option specifies the Copy command via SAN as the method of sending the copy command.
This option can be omitted.

-lan: This option specifies the Copy command via LAN as the method of sending the copy command.
The method of sending the copy command is set to Copy command via SAN, if this option is omitted.

-box-id BOX-ID: This option specifies the Box ID of ETERNUS Disk storage system.
An error will occur when an attempt is made to register an ETERNUS Disk storage system with the same Box ID as an ETERNUS Disk storage system that has already been registered.

-remote: This option specifies when registering the ETERNUS Disk storage system which is in a remote site.

-xml: This option specifies when displaying the result of the command execution by the XML format.

EXIT STATUS

=0 : Completed successfully
>0 : Terminated abnormally

EXAMPLES

The execution example on Windows operating system is as follows.

Registering a storage device which is operated by Copy command via SAN:

> acarray add -a ET001 -ip 10.124.6.251 -user root -password root -san -path X:
Successful completion.

Registering a storage device which is operated by Copy command via LAN:

> acarray add -a ET001 -ip 10.124.6.251 -user root -password root -lan
Successful completion.

Registering a storage device which is at remote site:

> acarray add -a ET001 -boxid 00ETERNUSDXM##ET44S20A####HK000104###### -remote
Successful completion.