IBM TotalStorage L10 Cli Reference Manual

IBM TotalStorage Storage Switch
2006 Model L10 CLI Reference Guide
Read Before Using
This product contains software that is licensed under written license agreements. Your use of such software is subject to the license agreements under which they are provided.
GC26-7652-00
IBM TotalStorage Storage Switch
2006 Model L10 CLI Reference Guide
GC26-7652-00
Note:
Before using this information and the product it supports, read the information in the
Safety Information
First Edition (August 2004)
Form Number GC26-7652-00
The following paragraph does not apply to any country (or region) where such provisions are inconsistent with local law.
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATIONS “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states (or regions) do not allow disclaimer of express or implied warranties in certain transactions; therefore, this statement may not apply to you.
Order publications through your IBM representative or the IBM branch office serving your locality.
© Copyright International Business Machines Corporation 2004. All rights reserved.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
© 2004 Emulex Corporation. All rights reserved.
Part Number 00041459-001 Rev. A
Emulex and Vixel are registered trademarks, and InSpeed and FibreSpy are trademarks, of Emulex Corporation. All other brand or product names referenced herein are trademarks or registered trademarks of their respective companies or organizations.

Contents

Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
About this document . . . . . . . . . . . . . . . . . . . . . .ix
Model L10 library . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Web sites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Getting software updates. . . . . . . . . . . . . . . . . . . . . . . . x
Getting help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
Online . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
Telephone . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
How to send your comments . . . . . . . . . . . . . . . . . . . . . . x
Chapter 1. Introduction . . . . . . . . . . . . . . . . . . . . . 1
Getting started . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Connecting through a serial interface . . . . . . . . . . . . . . . . . 1
Logging in and out. . . . . . . . . . . . . . . . . . . . . . . . . 2
Menu navigation . . . . . . . . . . . . . . . . . . . . . . . . . 2
Saving configuration changes . . . . . . . . . . . . . . . . . . . . 3
Initial switch setup . . . . . . . . . . . . . . . . . . . . . . . . . 4
CLI command reference . . . . . . . . . . . . . . . . . . . . . . . . 6
Root menu (root) . . . . . . . . . . . . . . . . . . . . . . . . . 7
Hardware reset (reset) . . . . . . . . . . . . . . . . . . . . . . . 7
Help (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Chapter 2. Configuration menu (root/config) . . . . . . . . . . . . 9
Saving the current system configuration (root/config/save) . . . . . . . . . 9
Setting the switch to factory defaults (root/config/default) . . . . . . . . . . 9
Changing the password (root/config/password). . . . . . . . . . . . . . 10
Return to previous menu (..) . . . . . . . . . . . . . . . . . . . . . 10
Help (?) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
System configuration menu (root/config/sys) . . . . . . . . . . . . . . . . 11
Setting the system speed (root/config/sys/speed) . . . . . . . . . . . . . 11
Setting the system switching mode (root/config/sys/mode) . . . . . . . . . 12
Configuring the OS Error Threshold (root/config/sys/oserr) . . . . . . . . . 12
Configuring the CRC Error Threshold (root/config/sys/crcerr) . . . . . . . . 13
Setting the Blocking Arbitration AL_PA (root/config/sys/blkarb) . . . . . . . . 13
Configuring the Clock Delta Threshold (root/config/sys/clkd) . . . . . . . . 14
Setting the system time (root/config/sys/time) . . . . . . . . . . . . . . 14
Configuring the Stealth Intelligent Change Manager
(root/config/sys/lipen) . . . . . . . . . . . . . . . . . . . . . . . 14
Setting the switch name (root/config/sys/name) . . . . . . . . . . . . . 15
Setting the switch location (root/config/sys/location) . . . . . . . . . . . . 15
Setting the contact information (root/config/sys/contact) . . . . . . . . . . 15
Configuring the switch for a system log server (root/config/sys/syslog) . . . . . 16
Displaying events (root/config/sys/events) . . . . . . . . . . . . . . . . 18
Configuring the event log severity filter (root/config/sys/sev). . . . . . . . . 18
Configuring the event log severity fault threshold
(root/config/sys/fault) . . . . . . . . . . . . . . . . . . . . . . . . 19
Clearing the event log (root/config/sys/evclr). . . . . . . . . . . . . . . 19
Clearing the fault LED (root/config/sys/clrled) . . . . . . . . . . . . . . 19
© Copyright IBM Corp. 2004
iii
Port configuration menu (root/config/port) . . . . . . . . . . . . . . . . . 20
Beaconing ports (root/config/port/beacon) . . . . . . . . . . . . . . . 20
Displaying port configuration information (root/config/port/show) . . . . . . 21
Displaying Smart Settings (root/config/port/types) . . . . . . . . . . . . 24
Default Smart Settings. . . . . . . . . . . . . . . . . . . . . . . 25
Displaying Smart Setting attributes (root/config/port/view) . . . . . . . . . 26
Creating a custom Smart Setting (root/config/port/add) . . . . . . . . . . 31
Editing custom Smart Setting attributes (root/config/port/edit). . . . . . . . 31
Deleting custom Smart Settings (root/config/port/del) . . . . . . . . . . . 31
Selecting Smart Settings (root/config/port/type) . . . . . . . . . . . . . 32
Load Balancing configuration menu (root/config/load) . . . . . . . . . . . . 33
Displaying trunk group members (root/config/load/show) . . . . . . . . . 33
Clearing trunk group configurations (root/config/load/lbclr) . . . . . . . . . 34
Deleting port members from trunk groups (root/config/load/delprt) . . . . . . 34
Adding port members to trunk groups (root/config/load/addprt) . . . . . . . 34
Deleting AL_PA members from trunk groups
(root/config/load/delalpa) . . . . . . . . . . . . . . . . . . . . . . 35
Adding AL_PA members to trunk groups (root/config/load/addalpa) . . . . . 35
Displaying initiator AL_PAs (root/config/load/ialpa) . . . . . . . . . . . . 35
Displaying port utilization (root/config/load/util) . . . . . . . . . . . . . 35
Displaying the average port utilization interval (root/config/load/pu1) . . . . . 36
Displaying the high/low port utilization interval
(root/config/load/pu2) . . . . . . . . . . . . . . . . . . . . . . . 36
Automatic Trunking configuration menu (root/config/trunk) . . . . . . . . . . 37
Adding port members to trunk groups (root/config/trunk/addprt) . . . . . . . 37
Deleting ports members from trunk groups (root/config/trunk/delprt) . . . . . 38
Displaying port members on a trunk group
(root/config/trunk/showmem) . . . . . . . . . . . . . . . . . . . . 38
Clearing trunk groups (root/config/trunk/clr). . . . . . . . . . . . . . . 38
Network configuration menu (root/config/network) . . . . . . . . . . . . . . 39
Hardware reset (root/config/network/reset) . . . . . . . . . . . . . . . 39
Displaying network settings (root/config/network/show) . . . . . . . . . . 39
Configuring the IP address setting (root/config/network/ip) . . . . . . . . . 40
Configuring the network mask setting (root/config/network/mask) . . . . . . 40
Configuring the gateway setting (root/config/network/gateway) . . . . . . . 40
One-Step Zoning configuration menu (root/config/zone) . . . . . . . . . . . 41
Setting the Bad Zone Recovery Reset Hold Time
(root/config/zone/bzht) . . . . . . . . . . . . . . . . . . . . . . . 42
Setting the Bad Zone Recovery Delay Time (root/config/zone/bzdt) . . . . . 42
Adding a port member to a zone (root/config/zone/addprt) . . . . . . . . . 42
Removing a port member from a zone (root/config/zone/delprt) . . . . . . . 43
Displaying port members within a zone (root/config/zone/showmem) . . . . . 43
Activating zoning (root/config/zone/act) . . . . . . . . . . . . . . . . 43
Deactivating zoning (root/config/zone/deact) . . . . . . . . . . . . . . 43
Displaying the zone state (root/config/zone/zstate) . . . . . . . . . . . . 44
Clearing zones (root/config/zone/zclr) . . . . . . . . . . . . . . . . . 44
Adding an AL_PA blocking member to a group
(root/config/zone/addblk) . . . . . . . . . . . . . . . . . . . . . . 44
Removing an AL_PA blocking member from a group
(root/config/zone/delblk) . . . . . . . . . . . . . . . . . . . . . . 46
Displaying AL_PA blocking groups (root/config/zone/showblks) . . . . . . . 46
Configuring the Hard Zone policy (root/config/zone/hz) . . . . . . . . . . 46
Configuring the Bad Zone Recovery policy (root/config/zone/bzr) . . . . . . 47
2006 Model L10 Storage Switch
iv
Displaying zone AL_PAs (config/zone/alpas). . . . . . . . . . . . . . . 48
Chapter 3. Diagnostics menu (root/diag) . . . . . . . . . . . . . 49
Displaying port AL_PAs (root/diag/galpa) . . . . . . . . . . . . . . . . 49
Displaying LIM port (root/diag/glim) . . . . . . . . . . . . . . . . . . 49
Displaying detected ordered sets (root/diag/os) . . . . . . . . . . . . . 50
Displaying port state (root/diag/ps) . . . . . . . . . . . . . . . . . . 51
Displaying port clock delta (root/diag/delta) . . . . . . . . . . . . . . . 51
Displaying primary ports (root/diag/showpri) . . . . . . . . . . . . . . . 52
Displaying port error counters (root/diag/prtctrs) . . . . . . . . . . . . . 52
Clearing counters (root/diag/clrctr) . . . . . . . . . . . . . . . . . . 52
Beaconing ports (root/diag/beacon) . . . . . . . . . . . . . . . . . . 52
Displaying connected device information (root/diag/con) . . . . . . . . . . 53
Displaying change notification information (root/diag/who) . . . . . . . . . 53
Displaying initiator AL_PAs (root/diag/ialpa) . . . . . . . . . . . . . . . 53
Chapter 4. Show menu (root/show) . . . . . . . . . . . . . . . 55
Displaying events (root/show/events) . . . . . . . . . . . . . . . . . 55
Displaying Smart Settings (root/show/ptype) . . . . . . . . . . . . . . . 56
Displaying port configuration information (root/show/portinfo) . . . . . . . . 56
Displaying port error counters (root/show/prtctrs) . . . . . . . . . . . . . 56
Clearing counters (root/show/clrctr) . . . . . . . . . . . . . . . . . . 56
Displaying system information (root/show/sysinfo) . . . . . . . . . . . . 57
Displaying zone information (root/show/zninfo) . . . . . . . . . . . . . . 58
Displaying Load Balancing information (root/show/lbinfo) . . . . . . . . . . 58
Displaying detected ordered sets (root/show/os) . . . . . . . . . . . . . 59
Displaying port AL_PAs (root/show/galpa). . . . . . . . . . . . . . . . 59
Displaying LIM port (root/show/glim) . . . . . . . . . . . . . . . . . . 59
Displaying sensor information (root/show/sensors) . . . . . . . . . . . . 59
Displaying connected device IDs (root/show/getcon). . . . . . . . . . . . 60
Displaying PLL lock status (root/show/sync) . . . . . . . . . . . . . . . 60
Displaying switch settings (root/show/dump) . . . . . . . . . . . . . . . 60
Displaying SFP serial ID information (root/show/sid) . . . . . . . . . . . . 61
Displaying zone AL_PAs (root/show/zalpas) . . . . . . . . . . . . . . . 61
Chapter 5. Firmware menu (root/fw) . . . . . . . . . . . . . . . 63
Loading a new image using TFTP (root/fw/tftp) . . . . . . . . . . . . . . 63
Loading a new image using Xmodem (root/fw/xmodem) . . . . . . . . . . 64
Changing firmware images (root/fw/revert) . . . . . . . . . . . . . . . 65
Displaying current firmware information (root/fw/show) . . . . . . . . . . . 65
Hardware reset (root/fw/reset) . . . . . . . . . . . . . . . . . . . . 65
Appendix A: Event messages . . . . . . . . . . . . . . . . . 67
Appendix B: Default Smart Setting attributes . . . . . . . . . . . 69
Appendix C: AL_PA cross references . . . . . . . . . . . . . . 71
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Contents
v
2006 Model L10 Storage Switch
vi

Tables

1. CLI command reference diagram . . . . . . . . . . . . . . . . . . 6
2. Root menu commands . . . . . . . . . . . . . . . . . . . . . . . 7
3. Configuration menu commands . . . . . . . . . . . . . . . . . . . 9
4. System configuration menu commands . . . . . . . . . . . . . . . . 11
5. System speed settings . . . . . . . . . . . . . . . . . . . . . . . 11
6. System switching modes . . . . . . . . . . . . . . . . . . . . . . 12
7. Blocking Arbitration AL_PA . . . . . . . . . . . . . . . . . . . . . 13
8. Stealth Intelligent Change Manager settings . . . . . . . . . . . . . . 14
9. Switch settings for a system log server . . . . . . . . . . . . . . . . 16
10. System log server messages and severities . . . . . . . . . . . . . . 17
11. Event log severity filter settings . . . . . . . . . . . . . . . . . . . 18
12. Event log severity fault threshold settings . . . . . . . . . . . . . . . 19
13. Port configuration menu commands . . . . . . . . . . . . . . . . . 20
14. Port configuration information . . . . . . . . . . . . . . . . . . . . 21
15. Port information . . . . . . . . . . . . . . . . . . . . . . . . . 22
16. Smart Settings . . . . . . . . . . . . . . . . . . . . . . . . . . 24
17. Smart Setting attributes . . . . . . . . . . . . . . . . . . . . . . 27
18. Load Balancing configuration menu . . . . . . . . . . . . . . . . . . 33
19. Port utilization information . . . . . . . . . . . . . . . . . . . . . 35
20. Automatic Trunking configuration menu commands . . . . . . . . . . . 37
21. Network configuration menu commands . . . . . . . . . . . . . . . . 39
22. One-Step Zoning configuration menu commands . . . . . . . . . . . . 41
23. Hard Zone policy settings . . . . . . . . . . . . . . . . . . . . . 47
24. Bad Zone Recovery policy settings . . . . . . . . . . . . . . . . . . 47
25. Diagnostic menu commands . . . . . . . . . . . . . . . . . . . . 49
26. Detected ordered sets . . . . . . . . . . . . . . . . . . . . . . . 50
27. Show menu commands . . . . . . . . . . . . . . . . . . . . . . 55
28. System information . . . . . . . . . . . . . . . . . . . . . . . . 57
29. Load Balancing information . . . . . . . . . . . . . . . . . . . . . 58
30. Sensor information . . . . . . . . . . . . . . . . . . . . . . . . 60
31. Firmware menu commands . . . . . . . . . . . . . . . . . . . . . 63
32. Event message severity levels . . . . . . . . . . . . . . . . . . . . 67
33. Event messages . . . . . . . . . . . . . . . . . . . . . . . . . 67
34. Default Smart Setting attributes . . . . . . . . . . . . . . . . . . . 69
35. Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
© Copyright IBM Corp. 2004
vii
2006 Model L10 Storage Switch
viii

About this document

This guide describes how to configure and manage an IBM TotalStorage® Storage Switch 2006 Model L10 using the Command Line Interface (CLI).
Throughout the rest of this document, the IBM TotalStorage Storage Switch 2006 Model L10 is referred to as the Model L10, the L10, or simply the switch.
The sections that follow provide information about:
• “Model L10 library”
• “Web sites”
• “Getting software updates”
• “Getting help”
• “How to send your comments”

Model L10 library

The following documents contain information related to this product:
IBM TotalStorage Storage Switch 2006 Model L10 User’s Guide
IBM TotalStorage Storage Switch 2006 Model L10 CLI Reference Guide
GC26-7652-00 (this document)
, GC26-7651-00
,

Web sites

IBM TotalStorage Storage Switch 2006 Model L10 Quick Reference Card
GC26-7653-00
IBM TotalStorage Storage Switch 2006 Model L10 Statement of Limited Warranty
GC26-7657-00
IBM Safety Notices
You can find additional information related to the software for this and other switches at the following Web site:
http://www.ibm.com/servers/storage/support/san
To get specific details about models and firmware that the switch supports, see the following Web site:
http://www.storage.ibm.com/ibmsan/
For detailed information about the Fibre Channel standards, see the Fibre Channel Industry Association (FCIA) Web site at:
www.fibrechannel.org/
For a directory of worldwide contact information, including technical support, see the following Web site:
, SD21-0030-05
,
,
www.ibm.com/contact/
© Copyright IBM Corp. 2004
ix

Getting software updates

Contact IBM for software updates and maintenance releases.
Select the SAN support link at the following Web site:
http://www.storage.ibm.com/ibmsan/index.html

Getting help

Before contacting technical support, check for solutions in this guide or check with the network administrator.

Online

Contact technical support at the following Web site:
http://www.ibm.com/servers/storage/support/san/index.html

Telephone

Within the United States, call 1-800-IBM-SERV (1-800-426-7378).
Outside the United States, go to the following Web site to find the appropriate service number:
http://www.ibm.com/planetwide/

How to send your comments

Your feedback is important in helping us provide the most accurate and high-quality information. If you have comments or suggestions for improving this document, you can send us comments electronically by using the following addresses:
• Internet: starpubs@us.ibm.com
• IBMLink™ from U.S.A.: STARPUBS at SJEVM5
• IBMLink from Canada: STARPUBS at TORIBM
• IBM Mail Exchange: USIB3VVD at IBMMAIL
You can also mail your comments by using the Reader Comment Form in the back of this manual or direct your mail to:
International Business Machines Corporation Information Development Department GZW 9000 South Rita Road Tucson, Arizona 85744-0001 U.S.A.
When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you.
2006 Model L10 Storage Switch
x

Chapter 1. Introduction

This guide describes how to configure and manage an IBM TotalStorage Storage Switch 2006 Model L10 using the Command Line Interface (CLI). The CLI provides a command-based interface that enables you to configure and display switch settings.
In addition to the CLI, the Web Manager interface provides an intuitive graphical user interface that enables you to quickly check switch status or configure switch settings in a visual environment. For information on how to use Web Manager interface, see the
User’s Guide

Getting started

The CLI enables you to monitor and change system and port configurations, configure zoning, load balancing, trunking, and event reporting parameters, and download and install firmware.

Connecting through a serial interface

Before using the CLI, ensure the switch’s Ethernet network parameter settings are correct for the network configuration. The switch ships with the following default IP settings:
• IP Address: 192.168.1.129
.
• Netmask: 255.255.255.0
• Gateway: 192.168.1.1
If these settings need to be adjusted to open the CLI, connect to the switch through the serial interface using the instructions below.
Once the proper network configuration settings are entered, the switch can be managed over a network interface using a terminal emulation program, such as HyperTerminal®. The switch may also be accessed through the serial interface to manage the switch from a local computer.
To connect through a serial interface:
1. Attach one end of the included RS-232 null modem cable to the computer’s DB-9 serial port, and attach the other end to the switch’s DB-9 serial port.
2. Open a terminal session through a serial terminal emulation program (such as HyperTerminal®) with the appropriate serial port (for example, COM1) and the following serial port parameters:
– Bits per second: 19200
– Data bits: 8
– Parity: None
– Stop bits: 1
– Flow control: None
3. If using HyperTerminal, press E
© Copyright IBM Corp. 2004
NTER to receive a prompt.
1
4. If using the tip command on a UNIX workstation, do the following:
a. View the
port parameters above. (Suggested name: Switch)
b. Use the tip command to establish a connection through the created alias, for
example tip switch.

Logging in and out

The CLI does not require login if only viewing basic switch information. Anyone can monitor basic switch information by pressing E appears indicating that an invalid password was entered and a minimal CLI menu is displayed. From this menu, you can view basic switch settings, including switch and port information, zoning information, and load balancing information. However, for monitoring most switch information or configuring any switch or port settings, you must log in to the switch.
To log in to the CLI:
1. Type li and press E
2. Type the password at the prompt and press E ‘password’.)
To log out of the CLI:
Type lo and press E
/etc/remote
file and create an alias similar to Hardware but with the serial
NTER. The password prompt appears.
NTER, or exit the terminal session.
NTER at the password prompt. A message
NTER. (The default password is
Note: The CLI will automatically log users out after 30 minutes of inactivity.
If logged out of the switch due to inactivity or a command prompt does not appear, press E
NTER to get a command prompt and log in to the switch using the instructions below.
To log in to the CLI when already connected to the switch:
1. Type li and press E
2. Type the password at the prompt and press E

Menu navigation

The flexibility in the CLI menus and commands facilitates quick monitoring and configuring. Users can jump several menus ahead or back, select options, and issue commands from the command prompt.
root Menu:
1. config - Go to configuration sub-menu.
2. diag - Go to diagnostic sub-menu.
3. show - Go to show sub-menu.
4. fw - Go to firmware download sub-menu.
5. reset - Hardware Reset
6. ? - Help
OK
NTER.The password prompt appears.
NTER.
root>
Figure 1. CLI main menu (root)
2006 Model L10 Storage Switch
2
Note: Up to 10 concurrent telnet sessions may access the switch.
Once logged in to the CLI, the Root menu (main menu) is displayed. The CLI incorporates a menu-based interface featuring a list of menus and commands. Each menu offers a selection of commands in a numbered list. Commands are entered at the command prompt. The command prompt also indicates the current menu level (for example, root/config>).
To enter a CLI command:
• Type the actual command text. For example, to select the Configuration menu from the
Root menu, type config and press E
NTER.
–or–
• Type the number of the command. Using the previous example, to select the
Configuration menu from the Root menu, type 1 and press E
NTER.
–or–
• Type the first few letters of the command. Either two or more letters are required to make the command unique. Using the original example, to select the Configuration menu from the Root menu, type co and press E
NTER.
From the Root menu, you can also navigate to a specific command in a sub-menu by entering the first few letters of the sub menu, a space, and then the first few letters of the command. For example, to view system information under the Show sub-menu:
Type sh sys and press E
To return to the previous menu, type .. and press E
To return directly to the Root menu, type root and press E
To navigate from one menu to another menu, type in the complete menu command and press E
NTER.
For example, type root show sysinfo at the command prompt while in the Firmware menu, press E
NTER, and the system information menu is displayed.
To cancel a prompt or input request, press E
If an incorrect command is entered, the ‘ERROR: Invalid Command’ message appears. If this message appears, ensure the correct command syntax is being entered and try again.
To display help for specific command, type ? <command name or number> and press E
NTER.

Saving configuration changes

When making changes to the switch configuration, always save the changes to ensure the switch is configured properly. Some switch configuration changes may require a reboot of the switch.
NTER.
NTER.
NTER.
NTER.
To save changes to the switch configuration at any time:
1. Type save at any command prompt and press E
NTER. A message appears
confirming the request.
2. Type y and press E
NTER.
Chapter 1. Introduction
3

Initial switch setup

After logging in to the CLI for the first time, perform the following switch configuration tasks:
• Verify the switch’s network settings.
• Change the switch’s password.
Note: Until the default switch password is changed, any user with knowledge of the
• Verify the switch’s date and time settings.
• Reset the switch to enable the changes to the switch’s configuration.
To verify the switch’s current network settings:
From the Network Configuration menu (root/config/network), type show and press E
NTER.
The switch ships with the following default IP settings:
• IP Address: 192.168.1.129
• Netmask: 255.255.255.0
• Gateway: 192.168.1.1
default password can make changes.
To change the IP address setting:
1. From the Network Configuration menu (root/config/network), type ip and press
E
NTER.
2. Type the new IP address and press E
NTER.
To change the network mask setting:
1. From the Network Configuration menu (root/config/network), type mask and press
E
NTER.
2. Type the new network mask setting and press E
NTER.
To change the default gateway setting:
1. From the Network Configuration menu (root/config/network), type gateway and
press E
2. Type the new default gateway setting and press E
Once the network settings are configured, type save and press E appears confirming the request. Type y and press E
NTER.
NTER.
NTER. A message
NTER to save the current settings.
To change the password:
1. From the Configuration menu (root/config), type password and press E
2. Type the current password and press E
NTER.
NTER.
3. Type the new password and press E
4. Type the new password again and press E
2006 Model L10 Storage Switch
4
NTER.
Note: The password must be between 6 and 25 characters in length and is case
sensitive.
NTER.
To view the current date and time:
From the Root menu, type show sysinfo and press E
NTER.
To change the date and time:
1. From the System Configuration menu (root/config/sys), type time and press E
2. Type the new date and time (MM/DD/YYYY HR:MN:SC) and press E
NTER.
To reset the switch:
1. From the Root menu, type reset and press E
NTER. A message appears confirming
the request to save the current configuration.
2. To save changes and reset the switch, type y and press E
NTER.
NTER.
Chapter 1. Introduction
5

CLI command reference

The diagram below displays the available CLI commands and their hierarchical structure.
Table 1. CLI command reference diagram
root --> 1. config --> 1. save
help
li
lo
save
2. diag --> 1. galpa
3. show --> 1. events
4. fw --> 1. tftp
5. reset
6. ?
2. sys --> 1. speed
2. mode
3. oserr
4. crcerr
5. blkarb
6. clkd
7. time
3. default
4. port --> 1. beacon
2. show
3. types
4. add
5. password
6. load --> 1. show
2. lbclr
3. delprt
4. addprt
7. trunk --> 1. addprt
2. delprt
8. network --> 1. reset
2. show
3. ip
9. zone --> 1. bzht
2. bzdt
3. addprt
4. delprt
5. showmem
6. act
10. ..
11. ?
5. delta
2. glim
3. os
4. ps
2. ptype
3. portinfo
4. prtctrs
5. clrctr
2. xmodem
6. showpri
7. prtctrs
8. clrctr
6. sysinfo
7. zninfo
8. lbinfo
9. os
10. galpa
3. revert
4. show
8. lipen
9. name
10. location
11. contact
12. syslog
13. events
14. sev
5. view
6. edit
7. del
8. type
5. delalpa
6. addalpa
7. ialpa
8. util
3. showmem
4. clr
4. mask
5. gateway
6. ..
7. deact
8. zstate
9. zclr
10. addblk
11. delblk
12. showblks
9. beacon
10. con
11. who
12. ialpa
11. glim
12. sensors
13. getcon
14. sync
15. dump
5. reset
6. ..
15. fault
16. evclr
17. clrled
18. ..
19. ?
9. ..
10. ?
9. pu1
10. pu2
11. ..
12. ?
5. ..
6. ?
7. ?
13. hz
14. bzr
15. alpas
16. ..
17. ?
13. ..
14. ?
16. sid
17. zalpas
18. ..
19. ?
7. ?
2006 Model L10 Storage Switch
6

Root menu (root)

The Root menu is the CLI’s main menu. This menu is the first menu displayed after entering the password and logging in to the CLI.
Menu commands
Table 2. Root menu commands
Command Description Additional Information
1. config Displays the Configuration sub-menu. See page 9.
2. diag Displays the Diagnostics sub-menu. See page 49.
3. show Displays the Show sub-menu. See page 55.
4. fw Displays the Firmware sub-menu. See page 63.
5. reset Resets the switch. See page 7.
6. ? Displays additional information on a

Hardware reset (reset)

This command resets the switch.
To reset the switch:
From the Root menu, type reset and press E
If changes have been made to the switch configuration, a message appears asking if the current configuration should be saved.
To save changes and reset the switch, type y and press E
To reset the switch without saving changes, type n and press E
To cancel the request to reset the switch, type c and press E

Help (?)

This command displays the help description for a specific command.
To display help for specific command:
See page 7.
command.
NTER.
NTER.
NTER.
NTER.
Type ? <command> and press E
NTER.
Enter the command using one of the following methods:
• Type the actual command text. For example, under the Show menu, to view help for the sysinfo command: type ? sysinfo and press E
NTER.
• Type the number of the command. For example, under the Show menu, to view help for the sysinfo command: type ? 6 and press E
NTER.
• Type the first few letters of the command. For example, under the Show menu, to view help for the sysinfo command: type ? sys and press E
NTER.
Chapter 1. Introduction
7
2006 Model L10 Storage Switch
8

Chapter 2. Configuration menu (root/config)

The Configuration menu provides menus and commands for configuring the switch, ports, One-Step Zoning, Automatic Trunking, Load Balancing, and network settings.
Menu Commands
Table 3. Configuration menu commands
Command Description
1. save Saves the current system configuration. See page 9.
2. sys Displays the System Configuration sub-menu. See page 11.
3. default Resets the switch to the factory default settings. See page 9.
4. port Displays the Port Configuration sub-menu. See page 20.
5. password Changes the switch password. See page 10.
6. load Displays the Load Balancing Configuration sub-menu. See page 33.
7. trunk Displays the Trunking Configuration sub-menu. See page 37.
8. network Displays the Network Configuration sub-menu. See page 39.
9. zone Displays the Zone Configuration sub-menu. See page 41.
10. .. Returns to the previous menu. See page 10.
11. ? Displays additional information on a command. See page 10.

Saving the current system configuration (root/config/save)

Switch configuration settings (for example, zoning or port settings) can be saved to the switch’s Flash memory to protect against loss of power. This command automatically resets the switch.
Additional Information
To save the current configuration:
1. From the Configuration menu (root/config), type save and press E
the current switch configuration settings.
A message prompt appears confirming the request.
2. Type y and press E
The current switch configuration is saved and the switch automatically resets.
NTER to proceed.

Setting the switch to factory defaults (root/config/default)

This command returns the switch to the factory default settings; however, the network configuration and port type settings are retained.
To restore the factory default configuration:
1. From the Configuration menu (root/config), type default and press E
A message prompt appears confirming the request.
2. Type y and press E
© Copyright IBM Corp. 2004
NTER.
NTER to save all of
NTER.
9

Changing the password (root/config/password)

This command enables you to change the password for modifying the switch’s configuration. The same password is used to access both the CLI and the Web
Note: Until the default switch password is changed, any user with knowledge of the
default password can make changes to the switch’s configuration.
To change the password:
1. From the Configuration menu (root/config), type password and press E
A message prompt appears asking for the current password.
2. Type the current password and press E
If the correct password is entered, a message prompt appears asking for the new password.
3. Type the new password and press E
Note: The password must be between 6 and 25 characters in length and is case
sensitive.
A message prompt appears asking for the new password to be entered again.
4. Type the new password and press E
The new password is saved and activated.

Return to previous menu (..)

This command enables you to return to the previous menu.
To return to the previous menu:
Type .. and press E
NTER.
NTER.
NTER.
NTER.
NTER.

Help (?)

This command displays the help description for a specific command.
To display help for specific command:
Type ? <command> and press E
Enter the command using one of the following methods:
• Type the actual command text. For example, under the Show menu, to view help for
• Type the number of the command. For example, under the Show menu, to view help
• Type the first few letters of the command. For example, under the Show menu, to view
2006 Model L10 Storage Switch
10
NTER.
the sysinfo command: type ? sysinfo and press E
for the sysinfo command: type ? 6 and press E
NTER.
NTER.
help for the sysinfo command: type ? sys and press E
NTER.

System configuration menu (root/config/sys)

The System configuration menu provides commands to configure the switch settings.
Menu commands
Table 4. System configuration menu commands
Command Description
1. speed Configures the switch speed. See page 11.
2. mode Configures the switch mode. See page 12.
3. oserr Configures the OS Error Threshold. See page 12.
4. crcerr Configures the CRC Error Threshold. See page 13.
5. blkarb Configures the Blocking Arbitration AL_PA. See page 13.
6. clkd Configures the Clock Delta Threshold. See page 14.
7. time Configures the switch time. See page 14.
8. lipen Configures the Stealth Intelligent Change Manager See page 14.
9. name Configures the switch’s name. See page 15.
10. location Configures the switch’s location. See page 15.
11. contact Configures the contact information for the individual or party managing the switch.
12. syslog Configure the switch for a system log server See page 16.
13. events Displays the event log. See page 18.
14. sev Configures the event log’s severity filter level. See page 18.
Additional Information
See page 15.
15. fault Configures the event log’s severity fault threshold. See page 19.
16. evclr Clears the event log. See page 19.
17. clrled Clears the Fault LED. See page 19.
18. .. Returns to the previous menu. See page 10.
19. ? Displays additional information on a command. See page 10.

Setting the system speed (root/config/sys/speed)

This command sets the current speed per port at which the switch is running. All ports operate at the same speed. The default setting is 2.125 Gb/s.
To change the switch speed:
Type speed <setting> and press E
Table 5. System speed settings
Setting Description
1 Set switch speed to 1.0625 Gb/s.
2 Set switch speed to 2.125 Gb/s.
NTER.
Chapter 2. Configuration menu (root/config)
11
To view the current switch speed:
From the Root menu, type show sysinfo and press E
NTER.

Setting the system switching mode (root/config/sys/mode)

This command sets the switching or segmenting capability of the device, which allows increased aggregate bandwidth and decreased latency by only routing data between opened ports. The default setting is on (enabled).
Disabling the switching capability places the switch into a single shared loop (FC-AL loop mode) similar to a Fibre Channel hub. In this mode, all port policies are disabled and the ports share bandwidth.
To change the switch mode:
From the System Configuration menu (root/config/sys), type mode <setting> and press E
Table 6. System switching modes
Setting Description
1 Set switch mode to on (enabled).
2 Set switch mode to off (disabled).
To view the current switch mode:
NTER.
From the Root menu, type show sysinfo and press E
NTER.

Configuring the OS Error Threshold (root/config/sys/oserr)

The Ordered Set Error Threshold is the maximum number of OS errors allowed in a 10­second interval before a port is bypassed. Setting this value to ‘0’ returns the threshold to the factory default setting. The default setting is 16777215.
To change the threshold:
1. From the System Configuration menu (root/config/sys), type oserr and press
E
NTER.
The current value appears in brackets before the command prompt.
2. Type the new value and press E
To view the current OS Error Threshold:
From the Root menu, type show sysinfo and press E
NTER. The valid range is from 0 to 16777215.
NTER.
2006 Model L10 Storage Switch
12

Configuring the CRC Error Threshold (root/config/sys/crcerr)

The cyclic redundancy check (CRC) Error Threshold is the maximum number of CRC errors allowed in a 10-second interval before a port is bypassed. Setting this value to ‘0’ returns the threshold to the factory default setting. The default setting is 3.
To change the threshold:
1. From the System Configuration menu (root/config/sys), type crcerr and press
E
NTER.
The current value appears in brackets before the command prompt.
2. Type the new value and press E
NTER. The valid range is from 0 to 255.
To view the current CRC Error Threshold:
From the Root menu, type show sysinfo and press E
NTER.

Setting the Blocking Arbitration AL_PA (root/config/sys/blkarb)

When two ports start a communication session, the Blocking ARB is sent to all other ports trying to communicate with those ports until the connection is terminated. The default setting is ‘FF’. If other connected devices use the ‘FF’ setting for a different purpose, select another Blocking ARB value (for example, ‘FB’). Under normal circumstances, this setting does not need to be modified.
To change the blocking ARB value:
1. From the System Configuration menu (root/config/sys), type blkarb and press
E
NTER.
The current value appears in brackets before the command prompt.
2. Type the desired selection (1-6) and press E
Table 7. Blocking Arbitration AL_PA
Setting Description
1 xF7
NTER.
2 xF8
3xFB
4xFD
5xFE
6xFF
To view the current Blocking Arbitration AL_PA:
From the Root menu, type show sysinfo and press E
Chapter 2. Configuration menu (root/config)
NTER.
13

Configuring the Clock Delta Threshold (root/config/sys/clkd)

The Clock Delta is the amount of variance in frequency between the reference clock and an input port. The Clock Delta Threshold sets the threshold that can be used by the Clock Delta Policy to automatically bypass a port based on the frequency difference. The default setting is 200.
To change the threshold:
1. From the System Configuration menu (root/config/sys), type clkd and press E
The current value appears in brackets before the command prompt.
2. Type the new value and press E
The valid range is from 10 to 1000 (units measured in PPM).
NTER.

Setting the system time (root/config/sys/time)

This command sets the switch’s current date and time for the box. The default setting is 01/01/1970 00:00:00.
Note: The date and time settings must be configured any time the switch loses power or
is reset, as the time settings are not retained
To change the date and time:
1. From the System Configuration menu (root/config/sys), type time and press E
The current time and date appear in brackets before the command prompt.
2. Type the new date and time (MM/DD/YYYY HR:MN:SC) and press E
To view the current system time:
From the Root menu, type show sysinfo and press E
NTER.
NTER.
NTER.
NTER.

Configuring the Stealth Intelligent Change Manager (root/config/sys/lipen)

This command displays the current Stealth Intelligent Change Manager setting and allows you to enable or disable the Stealth Intelligent Change Manager. The Stealth Intelligent Change Manager provides stability and control over change notification disruptions on a port basis. The default setting is enabled.
To change the Stealth Intelligent Change Manager setting:
1. From the System Configuration menu (root/config/sys), type lipen and press E
The current setting appears in brackets before the command prompt.
2. Type the appropriate selection (1 or 2) and press E
Table 8. Stealth Intelligent Change Manager settings
Setting Description
1 enable
2 disable
2006 Model L10 Storage Switch
14
NTER.
NTER.

Setting the switch name (root/config/sys/name)

This command sets the switch name. The name is limited to 79 characters and quotation marks must wrap the entire name. For example, ‘Storage Switch #3’. The default setting is ‘Storage Switch’.
To change the switch name:
1. From the System Configuration menu (root/config/sys), type name and press E
The current name appears in brackets before the command prompt.
2. Type the new name and press E
NTER.
To view the current switch name:
From the Root menu, type show sysinfo and press E
NTER.

Setting the switch location (root/config/sys/location)

This command sets the switch location. The location is limited to 79 characters and quotation marks must wrap the entire location. For example, ‘Lab #1’. The default setting is ‘None’.
To change the switch location:
1. From the System Configuration menu (root/config/sys), type location and press
E
NTER.
The current location appears in brackets before the command prompt.
2. Type the new location and press E
To view the current switch location:
From the Root menu, type show sysinfo and press E
NTER.
NTER.
NTER.

Setting the contact information (root/config/sys/contact)

This command sets the switch contact information. Contact information may be a name, telephone number, or web site address. The contact information is limited to 79 characters and quotation marks must wrap the entire contact information. For example, ‘John Smith 425-555-1212’. The default setting is ‘IBM Technical Support’.
To change the switch contact information:
1. From the System Configuration menu (root/config/sys), type contact and press
E
NTER.
The contact information appears in brackets before the command prompt.
2. Type the new contact information and press E
To view the current switch contact information:
From the Root menu, type show sysinfo and press E
Chapter 2. Configuration menu (root/config)
NTER.
NTER.
15

Configuring the switch for a system log server (root/config/sys/syslog)

This command configures the switch for a system log server that monitors switch events.
To configure the switch to communicate with a system log server:
1. From the System Configuration menu (root/config/sys), type syslog and press
E
NTER.
2. Type the appropriate selection (1-7) and press ENTER.
3. Enter the applicable setting and press E
Table 9. Switch settings for a system log server
Setting Description
1. IP Address The system log server’s IP address. The default value is 127.0.0.1.
2. Port The port number of the system log server. The port is usually set to
514. The default value is 514.
3. Name The name under which to log reports on the system log server. The default value is "IBM".
4. Enable Enables the switch to send reports to the system log server (enable=1 or disable=2). The default value is 2 (disabled).
5. Facility The reporting group to send to the system log server. The default setting is 1 [userLevelMessages].
The standard reporting groups are:
0 – kernelMessages 1 – userLevelMessages 2 – mailSystem 3 – systemDaemons 4 – securityAuthorizationMessages 5 – messagesGeneratedInternallyBySyslogd 6 – linePrinterSubsystem 7 – networkNewsSubsystem 8 – uucpSubsystem 9 – clockDaemon 10 – securityAuthorizationMessages 11 – ftpDaemon 12 – ntpSubsystem 13 – logAudit 14 – logAlert 15 – clockDaemon 16 – localUse0 17 – localUse1 18 – localUse2 19 – localUse3 20 – localUse4 21 – localUse5 22 – localUse6 23 – localUse7
NTER.
2006 Model L10 Storage Switch
16
Table 9. Switch settings for a system log server (continued)
Setting Description
6. Severity Threshold
The lowest severity level at which to send messages to the system log server. Any messages that are equal to or higher in severity than the specified severity level are sent to the system log server. For example, if the severity level for system log reporting is designated as ‘alert’, the switch logs messages of the ‘alert’ or the ‘emergency’ severity level only—’emergency’ is the only severity level higher than ‘alert’. The default setting is 6 (‘info’).
The severity levels include:
0 – emergency 1 – alert 2 – critical 3 – error 4 – warning 5 – notify 6 – info 7 – debug
7. Exit Setup Exits the setup menu.
To exit the setup menu: Type 7 and press E
NTER.
The following table provides a list of the system log messages and their severities.
Table 10. System log server messages and severities
Message Severity
SFP Overvoltage. CRITICAL
Port # inserted. INFO
Port # bypassed. INFO
Temperature Over Max. ALERT
Temperature OK. INFO
Port # state change to Unknown. INFO
Port # state change to Inserted. INFO
Port # state change to Loopback. INFO
Port # state change to Byp-Tx Fault. INFO
Port # state change to Diag Transmit. INFO
Port # state change to Byp-LIP(f8,x). INFO
Port # state change to Byp-Timeout. INFO
Port # state change to Byp-Redundant. INFO
Port # state change to Byp-Rx LOS. INFO
Port # state change to Byp-Sync LOS. INFO
Port # state change to bypassed. INFO
Chapter 2. Configuration menu (root/config)
17
Loading...
+ 67 hidden pages