Manual Pages
Table of Contents
na_storage - Commands for managing the disks and SCSI and
Fibre Channel adapters in the storage subsystem.
storage command argument ...
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.
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.
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.
na_disk(1), na_sysconfig(1)
Table of Contents