SDOC 2003-3 Revision A

MAN Pages for Network Appliance Data OnTap Version 6.1 Commands
Contents
The STORAGE Command ........................................................................... 2 The SYSCONFIG Command ....................................................................... 6 The NPMPD Command............................................................................... 7 The SYSSTAT Command ............................................................................. 9

MAN Pages for Network Appliance Data OnTap Version 6.1 Commands

The STORAGE Command

Name: na_storage
The na_storage commands manage the disks and manage 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. This prevents the system from using the adapter for I/O. Only adapters that are redundant can 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 then enable or disable status on an adapter. SCSI adapters are not redundant and cannot be disabled. Adapters connected to single port tape drives cannot be disabled. After an adapter connected to dual-attached disk drives has been disabled, the other adapter connected to the same disks is not considered redundant and cannot be disabled. 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.

MAN Pages for Network Appliance Data OnTap Version 6.1 Commands

storage show Displays information about storage components of the system. The storage show command displays information about all disks 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 disk <-a|-p> If no options are given, the current disks in the system are displayed. 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 filer can access both ports, one port is used as the primary path and the other is used as a secondary (backup) path. 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. 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 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.

MAN Pages for Network Appliance Data OnTap Version 6.1 Commands

storage alias <alias[electrical_name|world_wide_name]> The storage alias command 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, 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. Media changers (tape libraries) use the alias format mcn where n is a decimal integer such as 0, 99, 123. Valid media 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 Logical Unit Number (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 LUN 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 World Wide Name (WWN) 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 WWN, then it could be reattached anywhere in the Fibre Channel switch environment without having its name changed. Only Fibre Channel devices have the WWN addresses. SCSI attached devices do not have this eight-byte address, and cannot be addressed using a WWN. WWNs of devices follow the format WWN[x:xxx:xxxxxx:xxxxxx][Llun] where x is a hexadecimal digit and LUN is 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 WWN so that a filer will always use the same tape drive regardless of where it is moved on the network.

MAN Pages for Network Appliance Data OnTap Version 6.1 Commands

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 WWN, an alias mapped to the electrical name will be added to the system.

Note: 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> The storage unalias command removes alias settings from the filer. alias 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 media changer aliases stored in the system. Media 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.

MAN Pages for Network Appliance Data OnTap Version 6.1 Commands

The SYSCONFIG Command

Name: na_sysconfig
The na_sysconfig command displays filer configuration information.

Synopsis
sysconfig <-A|-c|-d|-m|-r|-t|-V> sysconfig <-av> <slot>

Description
The sysconfig command displays the configuration information about the filer. Without any arguments, the output includes the software version number and a separate line for each I/O device on the filer. If the slot argument is specified, sysconfig displays detailed information for the specified physical slot; slot 0 is the system board, and slot n is the Nth expansion slot on the filer.

Options
-A Display all of the sysconfig reports, one after the other. These include the reports of configuration errors, disk drives, media changers, RAID details, tape devices, and volume details. -a Displays very detailed information about each I/O device. This is more verbose than the output produced by the -v option. -c Checks that expansion cards are in the appropriate slots. -d Displays vital product information for each disk.

MAN Pages for Network Appliance Data OnTap Version 6.1 Commands

-m Displays tape library information. To use this option, the autoload setting of the tape library must be off when the filer boots. -r Displays RAID configuration information. -t Displays device and configuration information for each tape drive. If you have a tape device that Network Appliance has not qualified, the sysconfig -t command output for that device is different from that for qualified devices. If the filer has never accessed this device, the output indicates that this device is a non-qualified tape drive, even though there is an entry for this device in the /etc/clone tape file. Otherwise, the output provides information about the qualified tape drive that is being emulated by this device. You can enter the mt -f device status command to access a tape device. -v Displays detailed information about each I/O device. For SCSI or Fibre Channel host adapters, the additional information includes a separate line describing each attached disk. -V Displays volume configuration information.

The NPMPD Command

Name: na_ndmpd
The na_ndmpd command manages NDMP service.

Synopsis
ndmpd <on|off|status|probe[session]|kill[session]>

MAN Pages for Network Appliance Data OnTap Version 6.1 Commands

Description
The ndmpd command controls and displays information about the daemon responsible for providing Network Data Management Protocol (NDMP) service.

Options
on Enables NDMP request-handling by the daemon. If you want NDMP to be enabled after each filer reboot, put the ndmpd on command in the /etc/rc file. off Disables NDMP request-handling by the daemon. Processing continues for requests that are already in progress. New requests are rejected. By default, NDMP service is disabled at system startup. status Displays the current state of NDMP service. probe <session> Displays diagnostic information about the specified session. If the session is not specified, information about all sessions is displayed. kill <session> Signals the specified session to stop processing its current requests and to move to an inactive state. If the session is not specified, all active sessions are signaled. This allows hung sessions to be cleared without the need for a reboot, since the off command waits until all sessions are inactive before turning off the NDMP service.

MAN Pages for Network Appliance Data OnTap Version 6.1 Commands

The SYSSTAT Command

Name: na_sysstat
The na_sysstat command reports filer performance statistics.

Synopsis
sysstat <interval> sysstat <-c count> <-s> <-u|-x> <interval>

Description
The sysstat command reports aggregated filer performance statistics, such as the current CPU utilization, the amount of network I/O, the amount of disk I/O, and the amount of tape I/O. When invoked with no arguments, the sysstat command prints a new line of statistics every 15 seconds. Use Ctrl-C or set the interval count (-c count) to stop the sysstat command.

Options
-c count Terminate the output after count number of iterations. The count is a positive, non-zero integer; values larger than LONG_MAX will be truncated to LONG_MAX. -s Displays a summary of the output columns upon termination, descriptive columns such as CP ty will not have summaries printed. Note that, with the exception of Cache hit, the Avg summary for percentage values is an average of percentages, not a true mean of the underlying data. The Avg is only intended as a gross indicator of performance. For more detailed information, use tools such as na_nfsstat, na_netstat, or statit. -u Displays the extended utilization statistics instead of the default display.

MAN Pages for Network Appliance Data OnTap Version 6.1 Commands

-x Displays the extended output format instead of the default display. This includes all available output fields. Be aware that this produces output that is longer than 80 columns and is generally intended for off-line types of analysis and not for real-time viewing. interval A positive, non-zero integer that represents the reporting interval in seconds. If not provided, the default is 15 seconds.

10