4.1.1 acarray add (ETERNUS Disk Storage System Registration Command)

NAME

acarray add - Register ETERNUS Disk storage systems

SYNOPSIS

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

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

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

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

To register a remote ETERNUS Disk storage system

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

DESCRIPTION

This command registers the specified ETERNUS Disk storage system to this software.

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.
Point
When you specify an ETERNUS name by using another AdvancedCopy Manager CCM command, it is necessary to enter the ETERNUS name specified with this option correctly.

-ip diskArrayIP

This option specifies the IP address of an ETERNUS Disk storage system to be registered. 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.0.2.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 may 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. Specify the user name using a string that is between 1 and 32 characters long.

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

-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 to be registered.

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 to be registered.
An error may 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

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

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

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

> acarray add -a ET001 -ip 192.0.2.10 -user **** -password **** -lan
Successful completion.

To register a storage device which is at remote site

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