Top
ETERNUS SF Storage Cruiser V16.9 Operation Guide
FUJITSU Storage

13.1.1 Commands for Operating Environment Management

The following sub sections explain the commands for managing the operating environment.

13.1.1.1 sanadmsh chtraprcvip (SNMP Trap Transmission Place IP Address Change Command)

NAME

sanadmsh chtraprcvip - changes SNMP Trap transmission place IP address

SYNOPSIS

COMMAND PATH

DESCRIPTION

After the IP address of the Management Server is changed, delete the old IP address of the Management Server that is the SNMP Trap transmission place from the devices registered with this software, and add the new IP address.
In a Windows environment, only a user of the Administrators group can execute this command.
In a Solaris or Linux environment, only OS administrator (root) user can execute this command.

Although the SNMP Trap transmission place setting for a device may be changed with the Management Software on the device, this software provides this command to facilitate changing.

This command is only valid on devices using SNMPv1.

OPERANDS

deviceID

Applies SNMP Trap transmission place setting to the limited devices. Specify the device type according to the following tables. Afterwards, specify how to recognize the device.

Device Type

Device Recognition Method

-host
-storage
-library
-switch

One of which must be specified.

  • ip:IP address of a device

  • sysname:SysName name of a device SNMP setting

OPTIONS

-h

Displays help about the argument format of this command.

-all

Applies SNMP Trap transmission place setting to all devices managed by this software. Executing the command specified with this argument outputs device names and execution results in execution order to the standard output. If the Management Server has more than one IP address, for example, the Management Server is connected to multiple subnets, a device may not be set with the correct SNMP Trap transmission place. After this setting is performed, check whether the correct Management Server address is set as the SNMP Trap transmission place setting on the device side.

-oldip oldIpAddr

Specify the old IP address of the Management Server for oldIpAddr. Delete this IP address from the SNMP transmission place address of managed devices.

-newip newIpAddr

Specify the new IP address of the Management Server for newIpAddr. Add this IP address to the SNMP transmission place address.
If this option is omitted, the new IP address of the new Management Server is automatically specified. It is recommended to specify this option considering the Management Server that has multiple IP addresses.

USAGE

Execute the command after changing the IP address of Manager. The command may be executed for all devices managed by this software by the one command or for a specific device.

Devices that can be targets of the command are devices for which SNMP Trap transmission place settings can be defined automatically from this software.

The status of every target device must be Normal.

EXAMPLES

The following are the examples of executed commands in a Solaris or Linux environment:

13.1.1.2 swtraptest (SNMP Trap Test for Fibre Channel Switch)

NAME

swtraptest - tests of SNMP Trap

SYNOPSIS

swtraptest ipAddr

COMMAND PATH

DESCRIPTION

This command checks whether this software can receive an SNMP Trap correctly, display an event, and cooperate with Systemwalker Centric Manager and Shell/Bat.
A simulated Fibre Channel switch SNMP Trap (FC Port fault) is created and issued to the Management Server.

This command is only valid on devices using SNMPv1.

OPERANDS

ipAddr

Specify the IPv4 address of the Fibre Channel switch which is to check the SNMP Trap setting by this command. IPv6 address cannot be specified.
The Fibre Channel switch must be a device managed by this software.

OPTIONS

None.

EXAMPLES

NOTES

13.1.1.3 grtraptest (SNMP Trap Test for ETERNUS Disk Storage System)

NAME

grtraptest - tests of SNMP Trap

SYNOPSIS

grtraptest ipAddr

COMMAND PATH

DESCRIPTION

This command checks whether this software can receive an SNMP Trap correctly, display an event, and cooperate with Systemwalker Centric Manager and Shell/Bat.
A simulated SNMP Trap (FAN fault) for the ETERNUS Disk storage system is created within the Management Server and is issued to the Management Server itself.

This command is only valid on devices using SNMPv1.

OPERANDS

ipAddr

Specify the IPv4 address of the ETERNUS Disk storage system which is to check the SNMP Trap settings. IPv6 address cannot be specified.
The ETERNUS Disk storage system must be a device managed by this software.

OPTIONS

None.

EXAMPLES

NOTES

13.1.1.4 storageadm zone (Host Affinity and Zoning Operation Command)

NAME

storageadm zone - operates the host affinity and zoning

SYNOPSIS

storageadm zone add -storage cawwpn,affinityGroup -hba hbawwpn [-ipaddr ipAddr[,ipAddr]] [-hostrsp hostResponse] [-update all] [-f [-s]]
storageadm zone delete -storage cawwpn,affinityGroup -hba hbawwpn [-ipaddr ipAddr[,ipAddr]] [-update all] [-s]
storageadm zone info [-ipaddr ipAddr[,ipAddr,...] [-check]] [-fast] [-csv] [-hex] [-hostrsp] [-tfo]

COMMAND PATH

DESCRIPTION

This command is used to set/delete/display the storage device host affinity and Fibre Channel switch zoning.
In a Windows environment, only a user of the Administrators group can execute this command.
In a Solaris or Linux environment, only OS administrator (root) user can execute this command.

Specify the storage device CA WWPN, affinity group, and WWPN of the set HBA in the command parameter to set/delete the storage device host affinity and Fibre Channel switch zoning. The set host affinity and zoning is also displayed.

The target storage device and Fibre Channel switch must be devices managed by this software.

If Storage Cluster is configured for CA of the storage device, no zoning is set or deleted for WWPN whose TFO status is "Standby".

OPERANDS

add

This sets the host affinity and zoning.

delete

This deletes the host affinity and zoning.

info

This displays the host affinity and zoning.

OPTIONS

Options of "add" Operand
-storage cawwpn,affinityGroup

Designate the WWPN and affinity group number for the CA of the storage device for which host affinity is being set.

The CA WWPN is specified with a 16-character long hexadecimal number or a 23-character long hexadecimal number with each two digits separated by a colon (:). For example, if separating the characters with colons, the WWPN is written in a manner such as "11:11:11:11:11:11:11:11".
The affinity group number is specified by a decimal or hexadecimal number. For example, specify affinity group number 16 as either "-storage 1111111111111111,16" in decimal notation or "-storage 1111111111111111,0x10" in hexadecimal notation.
If Storage Cluster is configured, specify CA_WWPN displayed by the storageadm zone info command for cawwpn.

-hba hbawwpn

Specify the WWPN for the HBA to be set to the host affinity and zoning.

The WWPN for the HBA is written with a 16-character long hexadecimal number or a 23-character long hexadecimal number with each two digits separated by a colon (:). For example, if separating the characters with colons, the WWPN is written in a manner such as "22:22:22:22:22:22:22:22".

-ipaddr ipAddr[,ipAddr]

Set the IP address of a storage device and/or Fibre Channel switch. To specify the IP addresses of both devices, separate the two IP addresses with a comma (,). The two IP addresses can be specified in either order.

Specified Device

Command Action

Storage device

The command checks that the status allows for setting the host affinity to the affinity group of the CA for the storage device designated with the -storage option. The command sets the host affinity to the storage device only if the status allows the setting. If the status does not allow for the setting to be made, the command terminates with an error.

Fibre Channel switch

The command checks that the status allows for setting the WWPN and zoning for the HBA specified with the -hba option within the fabric which includes the Fibre Channel switches connected to the CA of the storage device specified with the -storage option (i.e. all Fibre Channel switches connected in a cascade connection). The command sets the zoning to the Fibre Channel switch only if the status allows the setting. If the status does not allow the setting, the command terminates with an error.

Both storage device and Fibre Channel switch

The command checks that the status allows you to set the host affinity or zoning to the respective devices. The command sets the host affinity and zoning only if the status allows for the settings to be made for both devices. If the status is such that the setting cannot be made to either of the devices, the command terminates with an error.

-hostrsp hostResponse

Specify the host response being used by the HBA.
If this option is omitted, the storage device's default host response is set.

-update all

Specify this option to update the information this software is managing to the latest information after the completion of the setup.
If this option is omitted, information managed by this software is not updated. To update the information, be sure to execute the "info" operand without specifying the -fast option.

This option is effective for when there are few settings needing to be updated. The "info" operand is effective for updating information after performing multiple settings at one time.

-f

Specify this option if forcibly setting WWPN zoning to a Fibre Channel switch in a status of not having zoning set up.

Check the security settings for the Fibre Channel switch when specifying this option. Specify this option only if setting WWPN zoning.

Moreover, if you specify this option under the conditions described below, the command is executed the same as if this option is omitted.

  • If only a storage device is specified for the -ipaddr option

  • If zoning is already set for the Fibre Channel switch to which you intend to set the zoning

-s

Continues the processing without a confirmation message being output.
This option can be specified only when the -f option is specified.

Options of "delete" Operand
-storage cawwpn,affinityGroup

Designate the WWPN and affinity group number for the CA of the storage device for which host affinity is being deleted.

The CA WWPN is specified with a 16-character long hexadecimal number or a 23-character long hexadecimal number with each two digits separated by a colon (:). For example, if separating the characters with colons, the WWPN is written in a manner such as "11:11:11:11:11:11:11:11".
The affinity group number is specified by a decimal or hexadecimal number. For example, specify affinity group number 16 as either "-storage 1111111111111111,16" in decimal notation or "-storage 1111111111111111,0x10" in hexadecimal notation.
If Storage Cluster is configured, specify CA_WWPN displayed by the storageadm zone info command for cawwpn.

-hba hbawwpn

Specify the WWPN for the HBA from which the host affinity and zoning to be deleted.

The WWPN for the HBA is written with a 16-character long hexadecimal number or a 23-character long hexadecimal number with each two digits separated by a colon (:). For example, if separating the characters with colons, the WWPN is written in a manner such as "22:22:22:22:22:22:22:22".

-ipaddr ipAddr[,ipAddr]

Set the IP address of a storage device and/or Fibre Channel switch. To specify the IP addresses of both devices, separate the two IP addresses with a comma (,). The two IP addresses can be specified in either order.

Specified Device

Command Action

Storage device

The command checks that the status allows for deleting the host affinity from the affinity group of the CA for the storage device designated with the -storage option. The command deletes the host affinity from the storage device only if the status allows the deletion. If the status does not allow the deletion, the command terminates with an error.

Fibre Channel switch

The command checks that the status allows for deleting the WWPN and zoning for the HBA specified with the -hba option within the fabric which includes the Fibre Channel switches connected to the CA of the storage device specified with the -storage option (i.e. all Fibre Channel switches connected in a cascade connection). The command deletes the zoning to the Fibre Channel switch only if the status allows the deletion. If the status does not allow the deletion, the command terminates with an error.

Both storage device and Fibre Channel switch

The command checks that the status allows for deleting the host affinity or zoning from the respective devices. The command deletes the host affinity and zoning only if the status allows for the deletion for both devices. If the status is such that the deletion cannot be made to either of the devices, the command terminates with an error.

-update all

Specify this option to update the information this software is managing to the latest information after the completion of the setup.
If this option is omitted, information managed by this software is not updated. To update the information, be sure to execute the "info" operand without specifying the -fast option specified.

This option is effective for when there are few deletion. The "info" operand is effective for updating information after performing multiple deletions at one time.

-s

Processing continues without output of a confirmation message.

Options of "info" Operand
-ipaddr ipAddr[,ipAddr, ...]

Displays the zoning information for the Fibre Channel switches corresponding to the specified IP addresses or host affinity information for the host affinities set to the CA of the storage devices. To display information for multiple storage devices and Fibre Channel switches, specify the IP addresses separated by comma (,).

If this option is omitted, the command displays the information for all storage devices and Fibre Channel switches registered with this software.

-check

Checks that the devices specified with the -ipaddr option are storage devices or Fibre Channel switches which are registered to this software.

Checks that the status allows for display of the information. The information for the designated devices is displayed only if the status allows for it. If the status does not allow for information to be displayed or if the devices are not devices applicable to this display, the command terminates with an error.

This option can be specified when the -ipaddr option is specified.

-fast

Specify this to display storage device and Fibre Channel switch information from the existing information managed by this software.
If this option is omitted, the storage device and Fibre Channel switch information are displayed after the information managed by this software has been updated to the latest information.

This option is effective for displaying information after you have executed the "add" operand or the "delete" operand with the -update all option specified.

-csv

Displays the storage device and Fibre Channel switch information in CSV format.
If this option is omitted, the information is displayed in a table format.

-hex

Specify this to display the storage device and Fibre Channel switch information in hexadecimal format. If this option is specified, the affinity group numbers for storage devices are displayed in hexadecimal format.

-hostrsp

If this option is specified, the host response number used by the HBA and the host response's alias name are displayed.
If this option is omitted, the host response number and host response alias name, including the table border and column names are not displayed.

-tfo

The following items concerning Storage Cluster are output by the addition.

  • Response WWPN

  • TFO status

If this option is specified together with -hostrsp option at the same time, this item is displayed after host response information.
If not specified together with -hostrsp option at the same time, this item is displayed after HBA_WWPN.

EXAMPLES

NOTES

13.1.1.5 storageadm iscsizone (Host Affinity Operation Command)

NAME

storageadm iscsizone - operates iSCSI host affinity

SYNOPSIS

storageadm iscsizone add -ipaddr ipAddr -storage {portIpAddr,portIscsiName,affinityGroup | portID,affinityGroup} -server {serverPortIpAddr,serverPortIscsiName | serverPortIscsiName} [-svalias serverAlias] [-svname serverName] [-svhostrsp serverHostResponse] [-check]
storageadm iscsizone delete -ipaddr ipAddr -storage {portIpAddr,portIscsiName,affinityGroup | portID,affinityGroup} -server {serverPortIpAddr,serverPortIscsiName | serverPortIscsiName} [-check] [-s]
storageadm iscsizone info [-ipaddr ipAddr[,ipAddr,...] [-check]] [-csv] [-hex] [-expand]

COMMAND PATH

DESCRIPTION

This command is used to set, delete, and display the host affinity of the storage device iSCSI.
In a Windows environment, only a user of the Administrators group can execute this command.
In a Solaris or Linux environment, only OS administrator (root) user can execute this command.

In the command operands, specify the IP address and iSCSI name of the storage device iSCSI port, the affinity group, and the IP address and iSCSI name of the server being set. Use these operands to set and delete the host affinity of the storage device and to display the host affinity that is set.

The targeted storage device must be a device managed by this software.

OPERANDS

add

This sets the host affinity.

delete

This deletes the host affinity.

info

This displays the host affinity.

OPTIONS

Options of "add" Operand
-ipaddr ipAddr

Specify the IP address of the storage device.

-storage {portIpAddr,portIscsiName,affinityGroup | portID,affinityGroup}

Specify the iSCSI port IP address and iSCSI name of the storage device for which the host affinity is set and the affinity group number, or specify the port ID and the affinity group number.

Specify the affinity group number as a decimal or hexadecimal number. Specification example is as follows:

[Decimal specification]
-storage 192.0.2.38,iqn.2000-09.com.fujitsu:storage-system.e2000:0000000029,3
[Hexadecimal specification]
-storage 192.0.2.38,iqn.2000-09.com.fujitsu:storage-system.e2000:0000000029,0x3

For the ETERNUS DX60 S2, the port ID is the CM number and the port number entered.
For the ETERNUS DX S5 series (excluding the ETERNUS DX900 S5), DX S4 series (excluding the ETERNUS DX8900 S4), DX S3 series (excluding the ETERNUS DX8000 S3 series), DX S2 series (excluding the ETERNUS DX60 S2), the ETERNUS AF All-Flash Arrays, or the ETERNUS DX200F, the port ID is the CM number, the CA number, and the port number entered.
For the ETERNUS DX900 S5, DX8900 S4, DX8000 S3 series, the port ID is the CE number (hexadecimal), the CM number, the CA number, and the port number entered. Specification example is as follows:

[To specify CM number 1, CA number 2, port number 1, and affinity group number 6]
-storage 121,6
[To specify CE number 3, CM number 1, CA number 2, Port number 1, and affinity group number 6]
-storage 3121,6
-server {serverPortIpAddr,serverPortIscsiName | serverPortIscsiName}

Specify the iSCSI port IP address and the iSCSI name of the server for which the host affinity is set.
If the device supports non-setting of the iSCSI host IP address, the server can be specified with the iSCSI host IP address omitted.

-svalias serverAlias

This specifies the iSCSI alias of the server being set for the host affinity.
If this option is omitted, an alias is not set.

-svname serverName

This specifies the host alias of the server being set for the host affinity.
If this option is omitted, an alias is set automatically.

-svhostrsp serverHostResponse

This specifies the host response number of the server being set for the host affinity.
If this option is omitted, then host response number #0 is set.

-check

This checks whether the server specified in the -server option is already set as the host affinity setting for the device at the IP address specified in the -ipaddr option. If it is not already set as the host affinity, processing continues and the host affinity is set. If it is already set as the host affinity, an error occurs.
If this option is omitted, processing continues without checking.

Options of "delete" Operand
-ipaddr ipAddr

Specify the IP address of the storage device.

-storage {portIpAddr,portIscsiName,affinityGroup | portID,affinityGroup}

Specify the iSCSI port IP address and iSCSI name of the storage device for which the host affinity is being deleted and the affinity group number, or specify the port ID and the affinity group number.

Specify the affinity group number as a decimal or hexadecimal number. Specification example is as follows:

[Decimal specification]
-storage 192.0.2.38,iqn.2000-09.com.fujitsu:storage-system.e2000:0000000029,3
[Hexadecimal specification]
-storage 192.0.2.38,iqn.2000-09.com.fujitsu:storage-system.e2000:0000000029,0x3

For the ETERNUS DX60 S2, the port ID is the CM number and the port number entered.
For the ETERNUS DX S5 series (excluding the ETERNUS DX900 S5), DX S4 series (excluding the ETERNUS DX8900 S4), DX S3 series (excluding the ETERNUS DX8000 S3 series), DX S2 series (excluding the ETERNUS DX60 S2), the ETERNUS AF All-Flash Arrays, or the ETERNUS DX200F, the port ID is the CM number, the CA number, and the port number entered.
For the ETERNUS DX900 S5, DX8900 S4, DX8000 S3 series, the port ID is the CE number (hexadecimal), the CM number, the CA number, and the port number entered. Specification example is as follows:

[To specify CM number 1, CA number 2, port number 1, and affinity group number 6]
-storage 121,6
[To specify CE number 3,CM number 1, CA number 2, Port number 1, and affinity group number 6]
-storage 3121,6
-server {serverPortIpAddr,serverPortIscsiName | serverPortIscsiName}

Specify the iSCSI port IP address and the iSCSI name of the server for which the host affinity is being deleted.
If the device supports non-setting of the iSCSI host IP address, the server can be specified with the iSCSI host IP address omitted.

-check

This checks whether the server specified in the -server option is already set as the host affinity setting for the device at the IP address specified in the -ipaddr option. If it is not already set as the host affinity, an error occurs. If it is already set as the host affinity, processing continues and the setting is deleted.
If this option is omitted, processing continues without checking.

-s

Processing continues without output of a confirmation message.

Options of "info" Operand
-ipaddr ipAddr

This displays the host affinity information of the storage device at the specified IP address. To display information of multiple storage devices, specify the IP addresses successively, separated by commas (,).

If this option is omitted, information is displayed for all the storage devices registered with this software.

-check

This checks whether the devices at the IP address specified in the -ipaddr option are storage devices registered with this software. If all devices at the specified IP address are registered with this software, processing continues and the setting information is displayed. If at least one device at the specified IP address is not registered with this software, and error occurs.

If this option is omitted, processing continues without checking.

This option can be specified only when the -ipaddr option is specified.

-csv

Output is in CSV format.

-hex

The affinity group number is displayed as a hexadecimal number.

-expand

This adds the following to the host affinity information to display:

  • IPv6 link local address

  • IPv6 connection IP address

  • TFO status

Added information depends on the version of this software. If this software is upgraded, displayed information may be increased.
When this option is omitted, a list of host affinities is displayed.

EXAMPLES

NOTES

13.1.1.6 storageadm perfdata (Performance Information Operation Command)

NAME

storageadm perfdata - operates the performance information

SYNOPSIS

storageadm perfdata export outDirName -ipaddr ipAddr [-date startTime[-endTime]]

COMMAND PATH

DESCRIPTION

This command outputs the performance information of the storage devices and Fibre Channel switches.
In a Windows environment, only a user of the Administrators group can execute this command.
In a Solaris or Linux environment, only OS administrator (root) user can execute this command.

By specifying the IP address of the device that outputs the performance information and the date in the command operand, the storage device and Fibre Channel switch performance information is output in CSV format.

The target storage device and Fibre Channel switch must be devices managed by this software when performance monitoring is either still running or already completed.

The supported devices are as follows:

The details of CSV files are as follows:

Port Information of Fibre Channel Switch

Items

Explanation

File name

PORT.csv

Header line

Date,PortX - Tx Throughput, PortX - Rx Throughput, PortX - CRC Error, ...

Data line

date,port0s,port0r,port0e, ... ,portNs,portNr,portNe

The following information is output for each field. After date, the information is repeated for the actual number of ports.
date : Performance Information Acquisition Time (YYYY/MM/DD hh:mm:ss format)
port0s : Port0 Transfer rates of send data at date (Decimal notation. The unit is MB/S.)
port0r : Port0 Transfer rates of receive data at date (Decimal notation. The unit is MB/S.)
port0e : Port0 Number of CRC errors at date (Decimal notation. The unit is Count.)
portNs : PortN Transfer rates of send data at date (Decimal notation. The unit is MB/S.)
portNr : PortN Transfer rates of receive data at date (Decimal notation. The unit is MB/S.)
portNe : PortN Number of CRC errors at date (Decimal notation. The unit is Count.)

CM Performance Information of Storage Device

For the ETERNUS DX S5 series (excluding the ETERNUS DX900 S5), DX S4 series (excluding the ETERNUS DX8900 S4), DX S3 series (excluding the ETERNUS DX8000 S3 series), DX60 S2/DX80 S2/DX90 S2, the ETERNUS AF All-Flash Arrays, or the ETERNUS DX200F

Items

Explanation

File name

CM.csv

Header line

Date, CM0xX - CPU Use Rate, CM0xX - Copy Remain, ...

Data line

date,CM0u,CM0r, ... ,CMNu,CMNr

The following information is output for each field. After date, the information is repeated for the actual number of CMs.
date : Performance Information Acquisition Time (YYYY/MM/DD hh:mm:ss format)
CM0u : CM0x0 CPU Load at date (Decimal notation. The unit is %.)
CM0r : CM0x0 CM Copy remaining amount at date (Decimal notation. The unit is GB.)
CMNu : CM0xN CPU Load at date (Decimal notation. The unit is %.)
CMNr : CM0xN CM Copy remaining amount at date (Decimal notation. The unit is GB.)

For the ETERNUS DX900 S5, DX8900 S4, DX8000 S3 series

Items

Explanation

File name

CM.csv

Header line

Data, CE0xXCM0xX - CPU Use Rate, CE0xXCM0xX - Copy Remain, ...

Data line

date,CE0CM0u,CE0CM0r, ... ,CENCMNu,CENCMNr

The following information is output for each field. After date, the information is repeated for the actual number of CMs.
date : Performance Information Acquisition Time (YYYY/MM/DD hh:mm:ss format)
CE0CM0u : CE0x0CM0x0 CPU Load at date (Decimal notation. The unit is %.)
CE0CM0r : CE0x0CM0x0 CM Copy remaining amount at date (Decimal notation. The unit is GB.)
CENCMNu : CE0xNCM0xN CPU Load at date (Decimal notation. The unit is %.)
CENCMNr : CE0xNCM0xN CM Copy remaining amount at date (Decimal notation. The unit is GB.)

For the ETERNUS DX400 S2 series, DX8000 S2 series

Items

Explanation

File name

CM/nnnn.csv
(nnnn indicates the CM number by hexadecimal notation. CM numbers are assigned in ascending order, starting with 0000 for the lowest CM CPU number in the device.
CM0x0 CPU0 is 0000,
CM0x0 CPU1 is 0001,
CM0x1 CPU0 is 0002,
CM0x1 CPU1 is 0003,
:
CM0x7 CPU0 is 000E,
CM0x7 CPU1 is 000F.)

Header line

Date, CM0xX:CPUX - CPU Use Rate, CM0xX:CPUX(ROE) - CPU Use Rate, CM0xX:CPUX - Copy Remain

Data line

date,cpu,roe,remain

The following information is output for each field.
date : Performance Information Acquisition Time (YYYY/MM/DD hh:mm:ss format)
cpu : CM0xX:CPUX CPU Load at date (Decimal notation. The unit is %.)
roe : CM0xX:CPUX ROE Load at date (Decimal notation. The unit is %.)
remain : CM0xX:CPUX CM Copy remaining amount at date (Decimal notation. The unit is GB.)

Logical Volume Performance Information of Storage Device

Items

Explanation

File name

LogicalVolume/nnnn.csv
(nnnn indicates the LogicalVolume number by hexadecimal notation.)

Header line

Date, LogicalVolume0xXXXX - Read IOPS,
LogicalVolume0xXXXX - Write IOPS,
LogicalVolume0xXXXX - Read Throughput,
LogicalVolume0xXXXX - Write Throughput,
LogicalVolume0xXXXX - Read Response Time,
LogicalVolume0xXXXX - Write Response Time,
LogicalVolume0xXXXX - Read Cache Hit Rate,
LogicalVolume0xXXXX - Write Cache Hit Rate,
LogicalVolume0xXXXX - Prefetch Cache Hit Rate,
LogicalVolume0xXXXX - Read Cache Hit Rate(Extreme Cache),
LogicalVolume0xXXXX - Read Cache Hit Rate(DRAM + Extreme Cache),
LogicalVolume0xXXXX - Read QoS Delay Time,
LogicalVolume0xXXXX - Write QoS Delay Time

Data line

date,read,write,through-r,through-w,resp-r,resp-w,hit-r,hit-w,fetch,
hit-r-extreme-cache,hit-r-dram-extreme-cache,delay-r-qos,delay-w-qos

The following information is output for each field.
date : Performance Information Acquisition Time. (YYYY/MM/DD hh:mm:ss format)
read : Read Count at date. (Decimal notation. The unit is IOPS.)
write : Write Count at date. (Decimal notation. The unit is IOPS.)
through-r : Read data transfer rate at date. (Decimal notation. The unit is MB/S.)
through-w : Write data transfer rate at date (Decimal notation. The unit is MB/S.)
resp-r : Read Response Time at date. (Decimal notation. The unit is msec.)
resp-w : Write Response Time at date. (Decimal notation. The unit is msec.)
hit-r : Read Cache Hit Rate at date. (Decimal notation. The unit is %.)
hit-w : Write Cache Hit Rate at date. (Decimal notation. The unit is %.)
fetch : Read Pre-fetch Cache Hit Rate at date. (Decimal notation. The unit is %.)
hit-r-extreme-cache : Read Cache Hit Rate at date. (Extreme Cache) (Decimal notation. The unit is %.) (*1, *2)
hit-r-dram-extreme-cache : Read Cache Hit Rate at date. (DRAM + Extreme Cache) (Decimal notation. The unit is %.) (*1, *2)
delay-r-qos : Read QoS Delay Time at date. (Decimal notation. The unit is msec.) (*3, *4)
delay-w-qos : Write QoS Delay Time at date. (Decimal notation. The unit is msec.) (*3, *4)

*1: When this function is disabled for a device that supports Extreme Cache performance information, "0" is output.

Example: For a device that supports Extreme Cache performance information (function disabled)
...,hit-r-extreme-cache,hit-r-dram-extreme-cache
...,0,0

*2: For a device that does not support Extreme Cache performance information, a value is not output and instead a series of commas are output.

Example: For a device that does not support Extreme Cache performance information
...,hit-r-extreme-cache,hit-r-dram-extreme-cache
...,,

*3: When this function is disabled for a device that supports Host-LU QoS performance information (QoS Delay Time), "0" is output.

Example: For a device that supports Host-LU QoS performance information (function disabled)
...,delay-r-qos,delay-w-qos
...,0,0

*4: For a device that does not support Host-LU QoS performance information (QoS Delay Time), a value is not output and instead a series of commas are output.

Example: For a device that does not support Host-LU QoS performance information
...,delay-r-qos,delay-w-qos
...,,
RAID Group Performance Information of Storage Device

Items

Explanation

File name

RAIDGroup/nnnn.csv
(nnnn indicates the RAID group number by hexadecimal notation.)

Header line

Date, RAIDGroup0xXXXX - Read IOPS,
RAIDGroup0xXXXX - Write IOPS,
RAIDGroup0xXXXX - Read Throughput,
RAIDGroup0xXXXX - Write Throughput,
RAIDGroup0xXXXX - Read Response Time,
RAIDGroup0xXXXX - Write Response Time,
RAIDGroup0xXXXX - Read Cache Hit Rate,
RAIDGroup0xXXXX - Write Cache Hit Rate,
RAIDGroup0xXXXX - Prefetch Cache Hit Rate,
RAIDGroup0xXXXX - Read Cache Hit Rate(Extreme Cache),
RAIDGroup0xXXXX - Read Cache Hit Rate(DRAM + Extreme Cache),
RAIDGroup0xXXXX - Read QoS Delay Time,
RAIDGroup0xXXXX - Write QoS Delay Time

Data line

date,read,write,through-r,through-w,resp-r,resp-w,hit-r,hit-w,fetch,
hit-r-extreme-cache,hit-r-dram-extreme-cache,delay-r-qos,delay-w-qos

The following information is output for each field.
date : Performance Information Acquisition Time. (YYYY/MM/DD hh:mm:ss format)
read : Read Count at date. (Decimal notation. The unit is IOPS.)
write : Write Count at date. (Decimal notation. The unit is IOPS.)
through-r : Read data transfer rate at date. (Decimal notation. The unit is MB/S.)
through-w : Write data transfer rate at date. (Decimal notation. The unit is MB/S.)
resp-r : Read Response Time at date. (Decimal notation. The unit is msec.)
resp-w : Write Response Time at date. (Decimal notation. The unit is msec.)
hit-r : Read Cache Hit Rate at date. (Decimal notation. The unit is %.)
hit-w : Write Cache Hit Rate at date. (Decimal notation. The unit is %.)
fetch : Read Pre-fetch Cache Hit Rate at date. (Decimal notation. The unit is %.)
hit-r-extreme-cache : Read Cache Hit Rate at date. (Extreme Cache) (Decimal notation. The unit is %.) (*1, *2)
hit-r-dram-extreme-cache : Read Cache Hit Rate at date. (DRAM + Extreme Cache) (Decimal notation. The unit is %.) (*1, *2)
delay-r-qos : Read QoS Delay Time at date. (Decimal notation. The unit is msec.) (*3, *4)
delay-w-qos : Write QoS Delay Time at date. (Decimal notation. The unit is msec.) (*3, *4)

*1: When this function is disabled for a device that supports Extreme Cache performance information, "0" is output.

Example: For a device that supports Extreme Cache performance information (function disabled)
...,hit-r-extreme-cache,hit-r-dram-extreme-cache
...,0,0

*2: For a device that does not support Extreme Cache performance information, a value is not output and instead a series of commas are output.

Example: For a device that does not support Extreme Cache performance information
...,hit-r-extreme-cache,hit-r-dram-extreme-cache
...,,

*3: When this function is disabled for a device that supports Host-LU QoS performance information (QoS Delay Time), "0" is output.

Example: For a device that supports Host-LU QoS performance information (function disabled)
...,delay-r-qos,delay-w-qos
...,0,0

*4: For a device that does not support Host-LU QoS performance information (QoS Delay Time), a value is not output and instead a series of commas are output.

Example: For a device that does not support Host-LU QoS performance information
...,delay-r-qos,delay-w-qos
...,,
Disk Performance Information of Storage Device

Items

Explanation

File name

Disk/nnnn.csv
(nnnn indicates the DE number by hexadecimal notation.)

Header line

  • For disk mounted on CE:
    Date, CE(DE0x00):DiskX - busy time, ...

  • For disk mounted on DE:
    Date, DE0xXX:DiskX - busy time, ...

Data line

date,Disk0, ... ,DiskN

The following information is output for each field. After date, the information is repeated for the actual number of Disks.
date : Performance Information Acquisition Time (YYYY/MM/DD hh:mm:ss format)
Disk0 : Disk0 Disk busy rate at date (Decimal notation. The unit is %.)
DiskN : DiskN Disk busy rate at date (Decimal notation. The unit is %.)

CA/CM Port Performance Information of Storage Device

For the ETERNUS DX series (excluding the ETERNUS DX900 S5, DX8900 S4, DX8000 S3 series), the ETERNUS AF All-Flash Arrays, or the ETERNUS DX200F

Items

Explanation

File name

Port/nnnn.csv
(nnnn indicates the CA/CM Port number by hexadecimal notation. CA/CM port numbers are assigned in ascending order, starting with 0000 for the lowest CA/CM port number in the device.
CM0x0 CA0x0 Port0 is 0000,
CM0x0 CA0x0 Port1 is 0001,
:
CM0x7 CA0x3 Port2 is 007E,
CM0x7 CA0x3 Port3 is 007F.)

Header line

  • Case of CA Port
    Date, CM0xX:CA0xX:PortX - Read IOPS, CM0xX:CA0xX:PortX - Write IOPS, CM0xX:CA0xX:PortX - Read Throughput, CM0xX:CA0xX:PortX - Write Throughput

  • Case of CM Port
    Date, CM0xX:PortX - Read IOPS, CM0xX:PortX - Write IOPS, CM0xX:PortX - Read Throughput, CM0xX:PortX - Write Throughput

Data line

date,read,write,through-r,through-w

The following information is output for each field.
date : Performance Information Acquisition Time (YYYY/MM/DD hh:mm:ss format)
read : Read Count at date (Decimal notation. The unit is IOPS.)
write : Write Count at date (Decimal notation. The unit is IOPS.)
through-r : Read data transfer rate at date (Decimal notation. The unit is MB/S.)
through-w : Write data transfer rate at date (Decimal notation. The unit is MB/S.)

For the ETERNUS DX900 S5, DX8900 S4, or DX8000 S3 series

Items

Explanation

File name

Port/nnnn.csv
(nnnn indicates the CA Port number by hexadecimal notation. CA Port numbers are assigned in ascending order, starting with 0000 for the lowest CA Port number in the device.
CE0x0 CM0x0 CA0x0 Port0 is 0000,
CE0x0 CM0x0 CA0x0 Port1 is 0001,
:
CE0x3 CM0x1 CA0x3 Port2 is 007E,
CE0x3 CM0x1 CA0x3 Port3 is 007F)

Header line

Date, CE0xX:CM0xX:CA0xX:PortX - Read IOPS, CE0xX:CM0xX:CA0xX:PortX - Write IOPS,
CE0xX:CM0xX:CA0xX:PortX - Read Throughput, CE0xX:CM0xX:CA0xX:PortX - Write Throughput

Data line

date,read,write,through-r,through-w

The following information is output for each field.
date : Performance Information Acquisition Time (YYYY/MM/DD hh:mm:ss format)
read : Read Count at date (Decimal notation. The unit is IOPS.)
write : Write Count at date (Decimal notation. The unit is IOPS.)
through-r : Read data transfer rate at date (Decimal notation. The unit is MB/S.)
through-w : Write data transfer rate at date (Decimal notation. The unit is MB/S.)

Note: According to the port mode of the target CA/CM Port, the following is added at the end of each port name in the header line.

Port Mode

FC

iSCSI

CA

-

(iSCSI-CA)

RA

(FC-RA)

(iSCSI-RA)

CA/RA

(FC-CA/RA)

(iSCSI-CA/RA)

Initiator

(FC-Initiator)

-

The performance information of the FC-Initiator ports is displayed only for the ETERNUS DX S5 series, DX8900 S4, or the ETERNUS AF S3 series, or for the ETERNUS DX S4/S3 series (excluding the ETERNUS DX8900 S4), the ETERNUS AF S2 series, AF series, or the ETERNUS DX200F that has a firmware version of V10L80 or later.

Number of Active Disks Performance Information of Storage Device

Items

Explanation

File name

ACTIVE_DISK.csv

Header line

Date, Total Disks, Active Disks

Data line

date,total,active

The following information is output for each field.
date : Performance Information Acquisition Time (YYYY/MM/DD hh:mm:ss format)
total : Overall number of loaded disk devices at date (Decimal notation. The unit is Disk.)
active : Overall number of active disk devices at date (Decimal notation. The unit is Disk.)

Power Consumption Performance Information of Storage Device

Items

Explanation

File name

SYSTEM_POWER_CONSUMPTION.csv

Header line

Date, System Power Consumption

Data line

date, power

The following information is output for each field.
date : Performance Information Acquisition Time (YYYY/MM/DD hh:mm:ss format)
power : Power used by the device as a whole at date (Decimal notation. The unit is Watt.)

Temperature Performance Information of Storage Device

Items

Explanation

File name

SYSTEM_TEMPERATURE.csv

Header line

Date, System Temperature

Data line

date, temperature

The following information is output for each field.
date : Performance Information Acquisition Time (YYYY/MM/DD hh:mm:ss format)
temperature : Air intake temperature at device at date (Decimal notation. The unit is degrees Centigrade.)

Storage Device NAS System Performance Information

Items

Explanation

File name

NAS/System/nnnn.csv
(nnnn indicates the CM number by hexadecimal notation.)

Header line

Date, CM0xX - CPU Use Rate, CM0xX - CIFS Operations, CM0xX - NFS Operations

Data line

date,CMuse,CMcifs,CMnfs

The following information is output for each field.
date : Performance Information Acquisition Time (YYYY/MM/DD hh:mm:ss format)
CMuse : CPU usage rate within the CM at date (Decimal notation. The unit is %.)
CMcifs : Number of CIFS processes within CM at date (Decimal notation. The unit is ops/s.)
CMnfs : Number of NFS processes within CM at date (Decimal notation. The unit is ops/s.)

Storage Device NAS Volume Performance Information

Items

Explanation

File name

NAS/LogicalVolume/nnnn.csv
(nnnn indicates the LogicalVolume number by hexadecimal notation.)

Header line

Date, LogicalVolume0xXXXX - Read Throughput, LogicalVolume0xXXXX - Write Throughput

Data line

date,through-r,through-w

The following information is output for each field.
date : Performance Information Acquisition Time (YYYY/MM/DD hh:mm:ss format)
through-r : Read data transfer rate at date (Decimal notation. The unit is MB/s.)
through-w : Write data transfer rate at date (Decimal notation. The unit is MB/s.)

Storage Device Compression Performance Information (for the ETERNUS DX900 S5, DX8900 S4 only) and Storage Device Deduplication/Compression Performance Information (for the ETERNUS DX S5 series (excluding the ETERNUS DX900 S5) and the ETERNUS AF S3 series only)

Items

Explanation

File name

DataReduction/LogicalVolume/nnnn.csv
(nnnn indicates the LogicalVolume number by hexadecimal notation.) (*1, *2)

Header line

Date, LogicalVolume0xXXXX - Data Compression Rate, LogicalVolume0xXXXX - Unaligned I/O Rate

Data line

date,data-compression-rate,unaligned-io-rate

The following information is output for each field.
date : Performance Information Acquisition Time (YYYY/MM/DD hh:mm:ss format)
data-compression-rate : Data compression rate at date (Decimal notation. The unit is %) (*3)
unaligned-io-rate : Unaligned I/O rate at date (Decimal notation. The unit is %)

*1: The directory is created only when Deduplication/Compression is enabled in the storage device.
*2: A CSV file is output only when Deduplication/Compression is enabled for the volume.
*3: This information is not displayed when Deduplication only is enabled for the volume.

OPERANDS

export

Outputs performance information for the specified date in the CSV format.

outDirName

Specify the directory that outputs performance information. The full path of an existing directory must be specified in outDirName.
Performance information is output to the outDirName directory based on the following configuration.

OPTIONS

-ipaddr ipAddr

Specify the IP address of the device that outputs performance information.

The output target device must satisfy the following conditions:

  • The device is registered with this software, and it is one of the following performance monitoring targets:

    • ETERNUS DX series, ETERNUS AF All-Flash Arrays, ETERNUS DX200F

    • Fibre Channel switches and Fibre Channel switch blades which support the performance monitoring

Refer to "7.2.2 Instruction for Performance Management" for the settings of performance monitoring.

-date startTime[-endTime]

Specify the start and end times for the output of performance information in YYYYMMDDhhmm format. The start and end times must be concatenated using a hyphen (-), as follows.

YYYYMMDDhhmm-YYYYMMDDhhmm

If a hyphen (-) and end time are omitted, the command execution time is the end time.

The time that is specified for the -date option start time must be earlier than the end time. Additionally, the time that is specified for the start and end times must be later than 00:00 on 01/08/2001, and earlier than the command execution time.

If this option is omitted, a time 30 minutes before the command execution time is the start time, and the command execution time is the end time.

EXAMPLES

13.1.1.7 storageadm spindle (Disk Control command)

NAME

storageadm spindle - controls disk drives

SYNOPSIS

storageadm spindle start -ipaddr ipAddr {-raid raidGroupNumber[,raidGroupNumber,...] | -server} [-sync [-time timeout]]
storageadm spindle stop -ipaddr ipAddr {-raid raidGroupNumber[,raidGroupNumber,...] | -server} [-sync [-time timeout]] [-s] [-f]
storageadm spindle info -ipaddr ipAddr [{-raid raidGroupNumber[,raidGroupNumber,...] | -server}]

COMMAND PATH

DESCRIPTION

The spindle rotation of disk drives making up RAID of the storage device and the power of disk drives are controlled.
In a Windows environment, only a user of the Administrators group can execute this command.
In a Solaris or Linux environment, only OS administrator (root) user can execute this command.

If the storage device is specified when status is displayed, the spindle rotation status of disk drives making up RAID and the power status of disk drives are displayed.
If a server was specified, the storage device RAID group number and volume number used by the server are displayed.

The rotation of configured disk drives and the power of disk drives are controlled.

Specifying the server IP address controls the rotation of disk drives of the storage device used by the server and the power of those disk drives.

The target storage device and server must be devices managed by this software.

OPERANDS

start

Starts the disk drive that is used to configure the storage device RAID group.

stop

Stops the disk drive that is used to configure the storage device RAID group.

info

Displays the storage device RAID group Eco-mode information, or the storage device information used by the server.

OPTIONS

Options of "start" Operand
-ipaddr ipAddr

Specify the storage device or server IP address.

-raid raidGroupNumber[,raidGroupNumber,...]

Specify the start target RAID group number using hexadecimal notation.
If more than one RAID group number is specified, separate each number using a comma (,).
Specify this option when the storage device IP address has been specified in the -ipaddr option.

-server

The disk drive of the storage device used by the specified server is started.
Specify this option when the server IP address has been specified in the -ipaddr option.

-sync

There is no return until processing is complete, or the time specified in the -time option has elapsed.

-time timeout

Specify the timeout value (unit: seconds) if the -sync option has been specified. Specify a number from 1 to 86400.
If this option is omitted, the timeout value is 600 seconds.

Options of "stop" Operand
-ipaddr ipAddr

Specify the storage device or server IP address.

-raid raidGroupNumber[,raidGroupNumber,...]

Specify the stop target RAID group number using hexadecimal notation.
If more than one RAID group number is specified, separate each number using a comma (,).
Specify this option when the storage device IP address has been specified in the -ipaddr option.

-server

The disk drive of the storage device used by the specified server is stopped.
Specify this option when the server IP address has been specified in the -ipaddr option.

-sync

There is no return until processing is complete, or the time specified in the -time option has elapsed.

-time timeout

Specify the timeout value (unit: seconds) if the -sync option has been specified. Specify a number from 1 to 86400.
If this option is omitted, the timeout value is 600 seconds.

-s

Processing continues without the output of a confirmation message.

-f

Related RAID group disk drives are forcibly stopped.

Options of "info" Operand
-ipaddr ipAddr

Specify the storage device or server IP address.

-raid raidGroupNumber[,raidGroupNumber,...]

Specify the status display target RAID group number using hexadecimal notation.
If more than one RAID group number is specified, separate each number using a comma (,).
Specify this option when the storage device IP address has been specified in the -ipaddr option.

If this option is omitted, the information for all RAID groups in the specified storage device is displayed.

-server

The storage device RAID group Eco-mode information and volume number used by the specified server are displayed.
Specify this option when the server IP address has been specified in the -ipaddr option.

EXAMPLES

NOTES

13.1.1.8 storageadm remcs (REMCS Notification Command)

NAME

storageadm remcs - REMCS notification (for Windows environments only)

SYNOPSIS

storageadm remcs send -ipaddr ipAddr -type type

COMMAND PATH

DESCRIPTION

This command is used to send REMCS notification of Fibre Channel switch which is registered with this software.

OPERANDS

send

As for REMCS notification of the Fibre Channel switch whose IP address is specified, sends a test mail.

OPTIONS

Options of "send" Operand
-ipaddr ipAddr

Specify the IP address of Fibre Channel switch.

-type type

Specify the type of the sending mail.
Make sure to specify "test".

EXAMPLES

NOTES

13.1.1.9 esfsnap (Troubleshooting Information Collection of Manager)

NAME

esfsnap - Collects the troubleshooting information of Manager

SYNOPSIS

esfsnap -dir dirName [-all]

COMMAND PATH

DESCRIPTION

Collect information of the Manager on the Management Server.
Only OS administrator user can execute this command.

The esfsnap is the command used to collect information on the Management Server when a problem occurs. Submit its information to Fujitsu Technical Support.

OPTIONS

-dir dirName

Specify the directory that stores the troubleshooting information for dirName.
In a Windows environment, specify the full path name that starts from the drive letter for dirName. The maximum length that can be specified for dirName is 70 bytes.
In a Solaris or Linux environment, specify the full path name for dirName.

The collected information is output with the name that starts by "esfsnap_". Before executing this command, confirm that dirName directory has the following free space.

Collected Information

Required Free Space

Initial investigation information

more than 40 MB

All troubleshooting information

more than "80 + (2 * numberOfRegisteredDevices)" MB

-all

Collects all troubleshooting information on servers. Data includes lots of information, which increases the size of the data. This option is not necessary for initial investigation.

EXAMPLES

13.1.1.10 esfadm esfdata (Configuration Information Operation Command)

NAME

esfadm esfdata - Operates the configuration information

SYNOPSIS

esfadm esfdata backup -ipaddr ipAddr [-s]
esfadm esfdata restore -all [-s]
esfadm esfdata delete -all

COMMAND PATH

DESCRIPTION

This command backs up the various configuration information stored by this product to the ETERNUS Disk storage system and restores from the ETERNUS Disk storage system to the repository of this product. Further, this command delete the configuration information related to the ETERNUS Disk storage system that has been deleted from the repository.

OPERANDS

backup

Backs up the configuration information to the ETERNUS Disk storage system.

restore

Restores the configuration information from the ETERNUS Disk storage system to the repository of this product.

delete

Deletes the configuration information related to the ETERNUS Disk storage system that has been deleted.

OPTIONS

Options of "backup" Operand
-ipaddr ipAddr

Specify the IP address of the storage device.

-s

Processing continues without output of a confirmation message.

Options of "restore" Operand
-all

Restores from all registered ETERNUS Disk storage systems.

-s

Processing continues without output of a confirmation message.

Options of "delete" Operand
-all

Deletes all configuration information related to the ETERNUS Disk storage system that has been deleted.

EXAMPLES

NOTES