4.1.1 acarray add (ETERNUS Disk Storage System Registration Command)

NAME

acarray add - Registration of ETERNUS Disk storage system

SYNOPSIS

For Registering Storage Device Which Is Operated by Copy Command via SAN

acarray add -a diskArrayName -ip diskArrayIP -user userName -password password [-san] [-path volumeName] [-xml]

For Registering Storage Device Which Is Operated by Copy Command via LAN

acarray add -a diskArrayName -ip diskArrayIP -user userName -password password -lan [-xml]

For Registering Remote ETERNUS Disk Storage System

acarray add -a diskArrayName -boxid boxID -remote [-xml]

DESCRIPTION

This command registers ETERNUS Disk storage system.

OPTIONS

-a diskArrayName

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 diskArrayIP

This option specifies the IP address of an ETERNUS Disk storage system. The following IP addresses can be specified.

IPv4 address
Format that separates decimal digits with periods ".". (Values according to the IPv4 rules)
It is a specification example as follows:
192.168.0.1
IPv6 address
Format that separates hexadecimal digits with colons ":".
It is a specification example as follows:
2001:0db8:0000:0000:1234:0000:0000:0001
2001:db8::1234:0:0:1(abbreviated notation)

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. Moreover, even if IP address is different, it becomes an error when the same ETERNUS Disk storage system has already been registered.

-user userName

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 Systems Supporting Copy Command via SAN and/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 the -user option.

-path volumeName

This option specifies the access volume in the logical volume within an ETERNUS Disk storage system that was specified with the -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 facility of OS (/dev/mapper/) udev device name generated by udev facility 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 facility of OS (/dev/mapper/*)
udev device name generated by udev facility 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.

A TFOV cannot be specified.

-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 boxID: 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.

NOTES

If using REC, execute this command when the REC path is set.
If the REC path is set after execution of the command, execute the acarray list command to check that the ETERNUS Disk storage system is registered as storage device which is operated by Copy command via SAN or Copy command via LAN. Refer to "Changing Information Other than ETERNUS Names and Access Volumes" to re-register the ETERNUS Disk storage system.