5.17 rcxadm storagemgr

Name

[Windows Manager]
Installation_folder\SVROR\Manager\bin\rcxadm storagemgr - storage management software operations

[Linux Manager]
/opt/FJSVrcvmr/bin/rcxadm storagemgr - storage management software operations

Format

rcxadm storagemgr register -name name -soft_name soft_name [-label label] [-comment comment] [-soft_url url] [-ip ipaddress] [-port number] [-user_name user_name] [-passwd password|-passwd_file password_file]
rcxadm storagemgr list [-verbose]
rcxadm storagemgr show -name name
rcxadm storagemgr unregister -name name
rcxadm storagemgr modify -name name [-label label] [-comment comment] [-soft_url url] [-ip ipaddress] [-port number] [-user_name user_name] [-passwd password|-passwd_file password_file]

Description

rcxadm storagemgr is the command used to perform operations of storage management software.

Subcommands

register: Registers storage management software.

list

Displays a list of storage management software information.

The following detailed information is displayed:

Table 5.8 Storage Management Software Information
Item Name	Description
NAME	Storage management software name
LABEL	Storage management software label
COMMENT (*)	Storage management software comment
SOFT NAME	Name of storage management software
STATUS	Storage management software status
IP ADDRESS (*)	IP address to use to access the storage management software
PORT (*)	Port number to use to access the storage management software

* Note: When specifying -verbose for the option, it is displayed.

show

Displays the detailed information for storage management software.

The following detailed information is displayed:

Table 5.9 Detailed Information for Storage Management Software
Item Name	Description
NAME	Storage management software name
LABEL	Storage management software label
COMMENT	Storage management software comment
SOFT NAME	Name of storage management software
VERSION	Version of storage management software
URL	URL to use to access the storage management software
IP ADDRESS	IP address to use to access the storage management software
PORT NUMBER	Port number to use to access the storage management software
STATUS	Storage management software status
USER NAME	Storage management software user ID
PASSWORD	Password for storage management software user ID

unregister: Unregisters storage management software.

modify

Modifies the following items of storage management software:

Label
Comment
IP address
Port number
User name
Password

When the storage management software is ESC, an error occurs if the following options are specified.

-ip
-port
-user_name
-passwd
-passwd_file

When the storage management software is Navisphere, an error occurs if the following options are specified.

-ip
-port
-user_name
-passwd
-passwd_file

When the storage management software is Solutions Enabler, an error occurs if the following options are specified.

-ip
-port
-user_name
-passwd
-passwd_file

When the storage management software is FalconStor NSS, an error occurs if the following options are specified.

port

If the storage management software is the one of the following, an error occurs because this command cannot be used to make changes.

VMware vCenter Server
SCVMM
Oracle VM Manager
iSCSI controller for Resource Orchestrator

Options

-name name: In name, specify the resource name of the target storage management software to perform an operation with.

-soft_name soft_name

In soft_name, specify the storage management software. The name that can be specified is one of the following:

When using ETERNUS SF Storage Cruiser
Specify "esc".
If the following options are specified, an error will occur.
- -ip
- -port
- -user_name
- -passwd
- -passwd_file
When using Data ONTAP
Specify "ontap".
If the following options are not specified, an error will occur.
- -ip
- -user_name
- -passwd
- -passwd_file
When using PRIMECLUSTER GDS
Specify "gds".
If the following options are not specified, an error will occur.
- -ip
- -user_name
- -passwd
- -passwd_file
When using Navisphere
Specify "emcns".
If -ip is not specified, an error will occur.
If the following options are specified, an error will occur.
- -port
- -user_name
- -passwd
- -passwd_file
When using Solutions Enabler
Specify "emcse".
If the following options are specified, an error will occur.
- -ip
- -port
- -user_name
- -passwd
- -passwd_file
When using Citrix XenServer
Specify "xen".
If the following options are not specified, an error will occur.
- -ip
- -user_name
- -passwd
- -passwd_file
When using FalconStor NSS
Specify "nss".
If the following options are not specified, an error will occur.
- -ip
- -user_name
- -passwd
- -passwd_file
In addition, if the following options are specified, it becomes an error.
- -port

-soft_url url

In url, specify the URL to use to access the storage management software.

When using ETERNUS SF Storage Cruiser 14.2 for storage management software
When specifying -soft_name esc and managing only an ETERNUS, specify the URL of ETERNUSmgr for the ETERNUS.
When managing multiple ETERNUSs, do not specify -soft_url.
When using ETERNUS SF Storage Cruiser 15 for storage management software
Specify the URL for ETERNUS SF operation management servers.
For details on the URL to specify, refer to the "ETERNUS SF Express 15.0/Storage Cruiser 15.0/AdvancedCopy Manager 15.0 Web Console Guide".
When managing only one ETERNUS server, the URL can be specified in the same way as when using ETERNUS SF Storage Cruiser 14.2.

-ip ipaddress

In ipaddress, specify an IP address to use to access the storage management software.

When Storage Server that installs FalconStor NSS is doubled, and "nss" is specified for "-soft_name", specified IP address should specify not Heartbeat IP Address but Virtual IP Address.

-port number: In number, specify a port number to use to access the storage management software.

-user_name user_name

In user_name, specify the user ID for the storage management software.

When specifying -soft_name ontap, specify root.

-passwd password: In password, specify the password for the storage management software.

-passwd_file password_file: In password_file, specify the password file for the storage management software. When users other than administrators use an admin server, it is dangerous to specify the password using an argument such as -passwd because the arguments of commands issued by other users can be viewed. Use the -passwd_file option.
In the file that defines the passwords, enter a user name and password on each line, separated by a comma (","). The password entered in the line including the user name specified with the -user_name option will be registered.

-verbose: Specify when displaying detailed information.

-label label: In label, specify the new label.

-comment comment: In comment, specify the new comments.

Requirements

Permissions: Not required.

Location: Admin server

Examples

To display the list of the storage management software information:

>rcxadm storagemgr list <RETURN>
NAME      LABEL    SOFT NAME                      STATUS
----      -----    ---------                      ------
esc00     -        ETERNUS SF Storage Cruiser     normal

To display the details of the storage management software information:

>rcxadm storagemgr list -verbose <RETURN>
NAME    LABEL   COMMENT  SOFT NAME                  STATUS  IP ADDRESS PORT
----    -----   -------  ---------                  ------  ---------- ----
esc00   -       -        ETERNUS SF Storage Cruiser normal  -          -

To display the detailed information for storage management software:

>rcxadm storagemgr show -name esc00 <RETURN>
Name: esc00
Label:
Comment:
Soft name: ETERNUS SF Storage Cruiser
Version: 14.2
URL:
IP address:
Port number:
Status: normal
User name:
Password:

Exit Status

This command returns the following values:

0: The command executed successfully.

non-zero: An error has occurred.