logo

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, and list disk information.

USAGE

storage alias [ alias { electrical_name | world_wide_name } ]

Sets up aliases for tape libraries and tape drives to map to their electrical names or world wide names.

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.

The world_wide_name of a device consists of the eight byte FC address of the device. Each FC device has a unique world wide name and unlike the electrical_name, it is not location dependent. If a tape drive is addressed by the world_wide_name, then it could be reattached anywhere in the FC switch environment without having its name changed.

Only FC devices have the world_wide_name addresses. SCSI-attached devices do not have this eight byte address, and cannot be addressed using a world_wide_name.

World wide names of devices follow the format WWN[x:xxx:xxxxxx:xxxxxx][Llun], where x is a hexadecimal digit and lun is the logical unit number similar to that of the electrical name. Valid world wide names include the following:

WWN[2:000:3de8f7:28ab80]L12
and WWN[2:000:4d35f2:0ccb79].

Note that WWN[2:000:4d35f2:0ccb79] and WWN[2:000:4d35f2:0ccb79]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 (world_wide_name) 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 world wide name, an alias mapped to the electrical name is added to the 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 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. Fibre channel 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 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 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 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 Bport. 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 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 world_wide_name.

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 ] [ 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). 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 world_wide_name.

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.

CLUSTER 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