Manual Pages


Table of Contents

NAME

na_storage - Commands for managing the disks and SCSI and Fibre Channel adapters in the storage subsystem.

SYNOPSIS

storage command argument ...

DESCRIPTION

The storage family of commands manages disks, SCSI and Fibre Channel (FC) adapters, and various components of the storage subsystem. These commands can enable and disable adapters, display the I/O routes to dual-attached disk drives, list disk and array LUN information, manage array profiles and display storage array connectivity.

USAGE

storage alias [ alias { electrical_name | serial_number } ]

Sets up aliases for tape libraries and tape drives to map to their electrical names or serial number.

Alias names for tape drives follow the format stn, where n is a decimal integer such as 0, 99, or 123. Valid tape drive aliases include st0, st99, and st123. Extra zeroes in the number are considered valid, but the aliases st000 and st0 are different aliases.

Medium changers (tape libraries) use the alias format mcn where n is a decimal integer such as 0, 99, or 123. Valid medium changer aliases include mc0, mc99, and mc123. Extra zeroes in the number are considered valid, but the aliases mc000 and mc0 are different aliases.

The electrical_name of a device is the name of the device based on how it is connected to the system. These names follow the format switch:port.id[Llun] for switch attached devices and host_adapter.id[Llun] for locally attached devices. The lun field is optional. If it is not set, then the LUN is assumed to be 0.

An example of a switch-attached device is MY_SWITCH:5.4L3, where a tape drive with ID 4 and LUN 3 is connected to port 5 on the switch MY_SWITCH. An example of a locally attached device is 0b.5, where a tape drive with scsi id 5 is connected to SCSI adapter 0b. Note that 0b.5 and 0b.5L0 are equivalent. Both reference LUN 0 on the device.

The electrical_name of a host_adapter is the name of the device based on how it is connected to the system. These names follow the format slotport, such as 4a; which represents the first port on adapter in slot 4.

serial_number is a unique identifier of a tape device and is not location dependent. If a tape drive is mapped by the serial_number, then the tape drive could be reattached anywhere in the switch fabric without changing the alias name. The serial number-based alias of tape devices has the

following
format SN[xxxxxxxxxxxxxxxxxxxxxxxx][Llun], where x is an alphanumeric character and lun is the logical unit number of the tape device. If the LUN is 0, the L[lun] part of the string is not displayed. Example of a valid serial number as a mapped alias include the following: SN[00013B0122]L12 and SN[HU104514FJ].

Note that SN[HU104514FJ] and SN[HU104514FJ]L0 are equivalent because both address LUN 0.

If no options are given to the storage alias command, a list of the current alias mappings is shown.

Aliases allow multiple storage systems that are sharing tape drives to use the same names for each device. The alias names can be assigned either a location dependent name (electrical_name) so that a storage system always use a tape drive attached to port 5 on switch MY_SWITCH, or the names can be assigned to a physical device (serial number) so that a storage system always use the same tape drive regardless of where it is moved on the network.

If the storage system detects the addition of a tape device and no alias mapping has been set up for either the electrical name or the serial number, an alias mapped to the device serial number is added to the storage system.

Tip: Sharing this configuration information between storage systems, especially with long device names and many alias settings, can be done by entering the commands into a source file and running the source command on the storage system.

storage array modify array-name [ -m model ] [ -n new array name ] [ -v vendor ] [ -p prefix ] [ -o array options ]

This command modifies attributes of array profile records. The controller maintains a record for each storage array that presents array LUNs to it. The record gives the storage array a name, and is used to associate each of its target ports with a single entity. You can change some of the systemassigned values.

-m model

The -m option enables you to change the model name assigned to the array profile. A default model name is returned by an inquiry command sent to the storage array.

-n new_name

The -n option allows the administrator to change the default name given to the array profile. The array profile name is used to identify the storage array on most displays. The default name is a concatenation of the vendor and model inquiry data and an increasing numerical value.

-v vendor

The -v option allows the administrator to change the vendor name given to the array profile. The default vendor name is returned by an inquiry command to the storage array.

-p prefix

The -p option allows the administrator to change the prefix assigned to an array profile. A prefix is a unique 5 character string assigned to the array profile. The prefix is not currently used.

-o options

The -o option allows the administrator to set storage array specific options on a per storage array basis.

storage array purge-database

This command removes all records from the controller's array profile database. For storage arrays that are still attached to the controller, Data ONTAP automatically repopulates the database with records using default values.

storage array remove array-name

This command removes array profile records from the controller's internal database. The administrator may wish to remove array profiles that are no longer connected to the controller. If a storage array is still connected to the controller, it reappears with the default values after its' removal.

storage array remove-port array-name -p WWPN

This command removes ports associated with an array profile. The administrator may wish to remove ports from the array profile record if the ports are no longer connected to the controller. This can happen due to hardware replacement, rezoning or other activities. The -p WWPN arguments must be supplied to specify the World Wide Port Name (WWPN) of the port to be removed.

storage array show [ array-name ]

This command lists all array profile records known to the controller. A record is known to the controller if the controller has ever seen the storage array export array LUNs to the controller, regardless of whether or not the array LUNs were assigned.

The record can exist even if the storage array is not currently visible to the controller.

A record is eliminated only if you remove the record by using the storage array purge-database command, or the storage array remove command. When you specify an array profile name, only the information for the array profile you specifiy is shown.

storage array show-ports [ array-name ]

This command lists all target ports known to the controller for a given storage array (if an array name is specified) or for all storage arrays if no storage array name is specified. Target ports will remain as part of an array profile forever, unless they are removed as a result of removing the port, the profile or purging the database.

storage array show-luns [ -a ] array-name

[ -a ] The -a option will only display array LUNs that are assigned.

[ -p WWPN ]

This command lists all array LUNs exported from a named storage array that you identify. Alternatively, you can specify a World Wide Port Name (WWPN), in which case only the array LUNS that are exported by that target port on the named storage array you identified are listed.

storage array show-config [ -a ]

[ -a ] The -a option displays only the array LUNs that are assigned.

This command provides information about the connectivity to SAN-attached storage arrays that are connected to the V-Series system's FC initiator ports. The summary shows the LUN groups that the VSeries system can see. For each LUN group, the following information is shown: target ports, the array LUNs exported over each target port, and the V-Series system's FC initiator ports that can see the LUN group. A properly configured array LUN group shows two target ports per LUN group.

storage disable adapter <adapter>

Disables an adapter with name <adapter> and takes it offline. For FC adapters this prevents the system from using the adapter for I/O. FC adapters must be redundant to be be disabled. An adapter is considered redundant if all devices connected to it can be reached through another adapter. The subcommand show can display whether the adapter is redundant and whether it is enabled or disabled.

After an FC adapter connected to dual-attached disk drive has been disabled, the other adapter connected to the same disks is no longer considered redundant and cannot be disabled.

This command also allows the disabling of parallel SCSI host bus adapters connected to tape drives and/or medium changers. The command cannot disable parallel SCSI HBAs connected to disk drives.

Disabling a parallel SCSI HBA connected to tape drives and/or medium changers allows them to be added and removed from the bus without turning off the storage system. The parallel SCSI bus is not designed for hot-plugging devices so the instructions given here must be followed explicitly or the storage system might panic or the hardware might be damaged. When the HBA is enabled, it reinitializes the hardware on the SCSI bus; if there any faulty cables or devices are put on the SCSI bus, the storage system might panic. This is no different from what happens when the storage system boots after being turned on.

Below are the steps that must be followed to change the tape drives and/or medium changers that are connected to a parallel SCSI bus.

1. Run the command storage disable adapter adapter, replacing adapter with the name of the parallel SCSI HBA that needs tape drives or medium changers added to or removed from it.

This command first ensures that no tape drives or medium changers connected to the HBA are being used, and then takes the HBA offline. If the HBA has dual-channels, then both channels are taken offline. After the HBA is offline, it is in a safe state and changes can be made to the SCSI bus.

2. Turn off all devices connected by the SCSI bus to the HBA.

3. Add to or remove from the SCSI bus any tape drives or medium changers, and then change the cabling appropriately.

4. Verify the new bus connections by checking that all devices have different SCSI ID's and have compatible bus types, so that low voltage differential (LVD) and high voltage differential (HVD) devices are not connected to the same bus. Also verify the bus is properly terminated.

5. Turn on all devices now connected by the SCSI bus to the HBA.

6. Run the command storage enable adapter adapter using the same adapter name used in step 1.

This command reinitializes the HBA and scans the bus for any devices. After this command is complete, the tape drives and medium changers now connected to the system can be seen with the storage show tape or storage show mc commands.

storage download shelf [ -R ] [ adapter | shelf ]

Downloads new firmware to disk shelves attached to adapter name adapter If the name is of the form adapter.shelfN where N is an integer, then it is considered to be the name of the shelf with ID N attached to the adapter. In this case only the specified shelf is updated.

If neither the adapter nor the shelf name is specified, then all shelves attached to all adapters will be updated. For example, the following command updates all shelves attached to adapter 5:

  storage download shelf 5

The following command updates shelf 3 attached to adapter 8:
  storage download shelf 8.shelf3

The -R option allows the firmware to be reverted to the version shipped with the current Data ONTAP release.

storage download acp [ -R ] [ <adapter_name>.<shelf_id>.<module_number> ]

Downloads new firmware to ACP processors with inband specified by triplet <adapter_name>.<shelf_id>.<module_number>

If no inband id is specified, then all ACP processors connected to ACP administrator will be updated. For example, the following command updates all ACP processors connected to the system:

  storage download acp

The following command updates ACP processor on slot B in shelf 4 connected to adapter 7a:
  storage download acp 7a.4.B

The -R option allows the firmware to be reverted to the version shipped with the current Data ONTAP release.

storage enable adapter <adapter>

Enables an adapter with name <adapter> after the adapter has been disabled by the disable subcommand. I/O can be issued on the adapter.

storage help sub_command

Displays the Help information for the given sub_command.

storage load balance

Requests that I/O load over the storage system FC initiator ports be balanced based on recent averages.

storage load summary

Displays a summary of I/O load (in blocks) for each storage system FC initiator port. The I/O volume is shown between each storage system FC initiator port and each storage array target port. This command is valid only for storage systems that attach to FC storage arrays. This command is only available on V-Series systems.

storage load show

Displays the total I/O volume, to all array LUNs, over each storage system FC initiator port. If you specify an FC initiator port in the command, the output is shown only for the port you specify. This command is only available on V-Series systems.

storage shelf identify <shelf-name> [ on | off ]

Turns the identify mode of a shelf to on or off. The identify mode will flash all LEDs on the front and back of the shelf when set to on and when set to off restore shelf LEDs to previous state. The OPS LED panel on the front of the shelf will also alternate between the shelf ID and "H0" letters. This aids in identifying the shelf among other hardware.

storage show

Displays information about storage components of the system.

The storage show command displays information about all disks, hubs, and adapters. Additional arguments to storage show can control the output; see the following commands:

storage show acp [ -a ]

Displays status and statistics for the Alternate Control Path (ACP) administrator. The header displays whether the ACP is enabled or not. If ACP is enabled, the output displays all ACP administrator information including Ethernet interface, IP address, current status, domain, netmask and ACP connectivity status.

It also displays shelf module id, reset count statistics, IP address, firmware version, module type and current status of all the connected ACP processors.

ACP connectivity status can be,

No Connectivity: no ACP processors connected.

Partial Connectivity: more ACP processors reported through inband than alternate path.

Full Connectivity: same number of ACP processors seen through inband and alternate path.

Additional Connectivity: more ACP processors reported through alternate path than inband.

-a

The -a option displays information about all the ACP processors connected through the alternate path. ACP processors which are reported only through inband will have `NA' for the reset count, IP address, firmware version, module type and status.

storage show adapter [ -a ] [ adapter ]

If no adapter name is given, information about all adapters is shown. The -a option shows the same information (the -a option is provided for consistency, matching the storage show disk -a command). If an adapter name is given, only information about that specified adapter is shown.

storage show disk [ -a | -p | -T | -x ] [ name ]

If no options are given, the current disks in the system are displayed. If a name is given then information about that disk or host adapter is displayed. The name can be either an electrical_name or a world_wide_name. The following options are supported:

-a

The -a option displays all information about disks in a report form that makes it easy to include new information, and that is easily interpreted by scripts. This is the information and format that appears in the STORAGE section of an AutoSupport report.

-p

The -p option displays the primary and secondary paths to a disk device. Disk devices can be connected through the A-port or the B-port. If the storage system can access both ports, one port is used as the primary path and the other port is used as a secondary (backup) path.

Optionally displays the disks that have primary path on a given host adapter by specifying a host adapter name. Specifying all for host adapter name will display the disk primary path list for all host adapters, sorted by the host adapter name.

Only the endpoints of a route are used to determine primary and secondary paths. If two adapters are connected to a switch but the switch is only connected to one port on the drive, there is only one path to the device.

-T

The -T option displays the disk type (e.g., FCAL, LUN, ATA) and can be used in conjunction with the -x option.

-x

The -x option displays the disk specific information including serial number, vendor name and model.

storage show expander [ -a ] [ expander ]

Displays shelf expander statistics for SAS shelf modules. If no expander name is given, information about all expanders are shown. The -a option shows the same information (the -a option is provided for consistency, matching the storage show disk -a command). If an expander name is given, only information about that specified expander is shown.

storage show fabric

This command shows all fabrics, including any fabric health monitor status.

storage show fault [ -a ] [ -v ] [ shelf ]

Displays shelf fault information for shelves that currently have a fault. If no shelf is specified, information for all shelves that have any fault is shown. The -a option shows information formatted for AutoSupport and limits the information to a maximum of 10 shelves. The -v option shows fault information for a shelf even if no fault exists currently in that shelf.

storage show hub [ -a ] [ hub ]

Displays shelf hub statistics for shelves with ESH, ESH2, or ESH4 modules. If no hub name is given, information about all hubs is shown. The -a option shows the same information (the -a option is provided for consistency, matching the storage show disk -a command). If a hub name is given, only information about that specified hub is shown.

storage show initiators [ -a ]

Displays the host name and system id of other controllers in a Shared Storage configuration. The local host is denoted by the word self after its system ID.

storage show mc [ mc ]

If no mc name is given, information about all media changer devices is shown. If the mc argument is given, then only information about that device is shown unless the device does not exist in the system. The mc name can either be an alias name of the form mcn, an electrical_name, or a serial_number.

storage show port [ port ]

If the port name argument is absent, the command displays information about all ports on all switches. If the port name argument is given, only information about the named port is displayed. The information includes the WWPN, the switch name and loop and link status.

storage show shelf [ -a ] [ -e ] [ shelf ]

Displays shelf module statistics for shelves with SAS or ESH, ESH2, or ESH4 modules. If no shelf module name is given, information about all shelves is shown. The -a option shows the same information (the -a option is provided for consistency, matching the storage show disk -a command). The -e option shows the status of expanders and modules. If a shelf module name is given, only information about that specified shelf module is shown.

storage show switch [ switch ]

If no switch name is given, information about all switches is displayed. If the switch argument is given, then only information about that switch is shown. The information includes the symbolic name, the WWN, the current status and switch statistics.

storage show tape [ tape ]

If no tape name is given, information about all tape devices is shown. If the tape argument is given, then only information about that device is shown unless the device does not exist in the system. The tape name can either be an alias name of the form stn, an electrical_name or a serial_number.

storage show tape supported [ -v ]

If no options are given, the list of supported tape drives is displayed. The following option is supported:

-v

The -v option displays all the information about the supported tape drives including their supported density and compression settings.

storage stats tape [ tape ]

Displays statistics of the tape drive named tape. The output shows the total number of bytes read/written to/from the tape drive and a breakdown of the time spent in the different tape commands. The tape commands include writes, reads, erases, writing the end of file marker, and tape movement operations. The output displays how many times each command was executed, the average time to execute the command, the maximum time to execute the command, and the minimum time to execute the command. For writes and reads, the output also shows a breakdown of the times spent and the throughput for different block sizes in 4-KB increments up to 508 KB.

If no tape drive is named in the command, statistics for all tape drives are be shown.

storage stats tape zero [ tape ]

Resets to zero all the statistics for the tape drive named tape to zero.

If no tape drive is named in the command, statistics for all tape drives would be zeroed.

storage unalias { alias | -a | -m | -t }

Removes alias settings from the storage system. If the alias argument is entered, then that particular alias mapping is removed.

-a

The -a option removes all aliases stored in the system.

-m

The -m option removes all medium changer aliases stored in the system. Medium changer aliases follow the format mcn.

-t

The -t option removes all tape drive aliases stored in the system. Tape drive aliases follow the format stn.

HA CONSIDERATIONS

The information displayed can present disks that belong to the partner controller. The storage command shows all the disks it sees, regardless of who owns the disks.

The storage enable and storage disable commands are disabled if a controller is in takeover mode and the command is issued on behalf of the virtual partner. The storage show command shows devices connected to the live partner.

SEE ALSO

na_disk(1), na_sysconfig(1)


Table of Contents