storage

Table of Contents

NAME

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 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 disable adapter adapter

Disables an adapter with name adapter and takes it off-line. For fibre channel 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 the redundancy and the enable or disable status on an adapter.

After a fibre channel adapter connected to dualattached disk drives has been disabled, the other adapter connected to the same disks is not considered redundant and cannot be disabled.

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

Disabling a parallel SCSI bus adapter connected to tape drives and/or medium changers allows them to be added and removed from the bus without turning off the filer. The parallel SCSI bus is not designed for hot-plugging devices so the instructions given here must be explicitly followed otherwise the filer may panic or hardware may be damaged. When the adapter is enabled it reinitializes the hardware on the SCSI bus so if any faulty cables or devices are put on the SCSI bus, the filer may panic. This is no different from what happens when the filer 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. Execute the command storage disable adapter adapter where adapter is replaced with the parallel SCSI bus adapter name that needs tape drives or medium changers added or removed from it.

This command will first make sure any tape drives or medium changers connected to the adapter are not being used and then offline the adapter. If the adapter has dual-channels then both channels will be put offline. Once the adapter is offline it will be in a safe state to allow changes to the SCSI bus.

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

3. Add or remove any tape drives or medium changers from the SCSI bus and 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 LVD and 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 adapter.

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

This command will reinitialize the adapter and scan the bus for any devices. Once 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 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 adapter [ -a ] [ adapter ]

If no adapter name is given, information about all adapters 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 adapter name is given, only information about that specified adapter is shown.

storage show hub [ -a ] [ hub ]

Displays shelf hub statistics for shelves with ESH/ESH2/ESH4 modules. If no hub name is given, information about all hubs are 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 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 shelf [ -a ] [ shelf ]

Displays shelf module statistics for shelves with SAS or ESH/ESH2/ESH4 modules. If no shelf module name is given, information about all shelves are 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 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 filer can access both ports, one port is used as the primary path and the other 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 tape [ tape ]

If no tape name is given, information about all tape devices are 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 show mc [ mc ]

If no mc name is given, information about all media changer devices are 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 initiators

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

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 4KB increments up to 508KB.

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

storage show disk_led [ -a ]

If no options are given, the current disk LEDs that are lit are displayed. The -a option shows the LED state of all of the drives. The time that the LED was set to this state is also displayed.

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 4KB increments up to 508KB.

storage stats tape zero [ tape ]

Resets 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 alias [ alias { electrical_name | world_wide_name } ]

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

Alias names for tape drives follow the format stn where n is a decimal integer such as 0, 99, 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, 123. Valid medium changer aliases include mc0 , mc99 , 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 name would be MY_SWITCH:5.4L3 where a tape drive with id 4 and logical unit number 3 is connected to port 5 on the switch MY_SWITCH. An example of a locally attached device name would be 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 fibre channel address of the device. Each fibre channel 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 fibre channel switch environment without having its name changed.

Only fibre channel 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

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 since both address lun 0.

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

Aliases allow multiple filers that are sharing tape drives to use the same names for each device. The alias names can be assigned either via a location dependent name ( electrical_name ) so that a filer will 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 filer will always use the same tape drive regardless of where it is moved on the network.

If the filer 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 will be added to the system.

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

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

Removes alias settings from the filer. If the alias argument is entered, then that particular alias mapping will be 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 filer. The storage command shows all of the disks it sees, regardless of who owns the disks.

The storage enable and storage disable commands are disabled if a filer 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

disk , sysconfig


Table of Contents

Copyright © 1994-2008 NetApp, Inc. Legal Information

7-mode Manual Pages , , , ,

  1. No comments yet.
  1. No trackbacks yet.



This site is not affiliated or sponsored in anyway by NetApp or any other company mentioned within.
%d bloggers like this: