Page 1
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.
Page 3
IBM TotalStorage Storage Switch 2006 Model L10 CLI Reference Guide GC26-7652-00...
Page 6
Port configuration menu (root/config/port) ....20 Beaconing ports (root/config/port/beacon) ....20 Displaying port configuration information (root/config/port/show) .
Page 7
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) .
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.
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.
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.
4. If using the tip command on a UNIX workstation, do the following: a. View the /etc/remote file and create an alias similar to Hardware but with the serial port parameters above. (Suggested name: Switch) b. Use the tip command to establish a connection through the created alias, for example tip switch.
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.
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 default password can make changes.
Page 17
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 NTER 2. Type the new date and time (MM/DD/YYYY HR:MN:SC) and press E NTER To reset the switch: 1.
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.
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.
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 Additional Command Description Information 1. speed Configures the switch speed. See page 11. 2. mode Configures the switch mode. See page 12.
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.
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.
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.
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.
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).
Table 9. Switch settings for a system log server (continued) Setting Description 6. Severity The lowest severity level at which to send messages to the system log Threshold server. Any messages that are equal to or higher in severity than the specified severity level are sent to the system log server.
Displaying events (root/config/sys/events) This command displays the event log entries (up to 3000 messages) generated by the switch. For a list of the severity levels and event messages, see Appendix A. Event messages on page 67. To view the event log: From the System Configuration menu (root/config/sys), type events and press E NTER To continue to list event messages:...
Configuring the event log severity fault threshold (root/config/sys/fault) This command sets the threshold for when the Fault LED is triggered by an event. When set, an event that is equal to or higher than the specified fault threshold will trigger the switch’s Fault LED.
Port configuration menu (root/config/port) The Port configuration menu provides commands to configure the port settings. Menu commands Table 13. Port configuration menu commands Additional Command Description Information 1. beacon Beacons a port. See page 20. 2. show Displays a port’s configuration. See page 21.
Displaying port configuration information (root/config/port/show) This command displays the port configuration and policy settings. To view the port configuration and policy settings: 1. From the Port Configuration menu (root/config/port), type show and press E NTER A list of port configuration information appears for each port. Table 14.
Table 14. Port configuration information (continued) Field Description LIP Ctrl Methods of change notification management. • rxtxlip – no change notification management • rxlip – devices attached to the port can receive change notifications but will not propagate change notifications generated by that port to other ports.
Page 35
Table 15. Port information (continued) Field Description LIPF8 Recovery When a port is already inserted into a zone, the port transforms F8 Failure notifications into F7 Initialization notifications. When this occurs, the port is bypassed and F7 Initialization notifications are allowed in the zone.
Table 16. Smart Settings Number Port Type Initiator or Target Initiator with Stealth Target with Stealth Fabric Connection Tree Cascade String Cascade--Trunk 1 String Cascade--Trunk 2 String Cascade--Trunk 3 String Cascade--Trunk 4 IBM Smart Setting 2006 Model L10 Storage Switch...
Table 16. Smart Settings (continued) Number Port Type IBM Linux Initiator IBM Linux Stealth Initiator Default Smart Settings The default Smart Settings cannot be modified or deleted, but these settings can be used as templates for creating custom port types.
IBM Smart Setting This Smart Setting is a custom setting defined by IBM. IBM Linux Initiator This Smart Setting is a custom setting defined by IBM that has the Port Test Before Insert (PTBI) policy disabled. IBM Linux Stealth Initiator...
Table 17. Smart Setting attributes Attribute Description Port Type Name The name of the port type setting. If using one of the pre-defined port types, the name will automatically appear. Cascade Type The topology among switches for a port. • Initiator or Target Port – the default setting. For when there are no links among switches.
Page 40
Table 17. Smart Setting attributes (continued) Attribute Description LIP on Insert Policy The switch normally operates under the condition that when a device is inserted onto the network, a change notification is generated. However, this condition is not always true when connecting hubs or switches together. In some instances, it is possible to connect two zones together without the zones realizing that multiple AL_PAs exist with the same values.
Page 41
Table 17. Smart Setting attributes (continued) Attribute Description LIP (F8) Recovery Policy When a port is already inserted into a zone, the port transforms F8 Failure notifications into F7 Initialization notifications. When this occurs, the port is bypassed and F7 Initialization notifications are allowed in the zone.
Page 42
Table 17. Smart Setting attributes (continued) Attribute Description LIP Control Methods of change notification management. • rxtxlip – no change notification management • rxlip – devices attached to the port can receive change notifications but will not propagate change notifications generated by that port to other ports. Note: Change notifications will be reflected back out of the port if originated by devices attached to this port.
Creating a custom Smart Setting (root/config/port/add) This command creates a new custom Smart Setting. The Smart Setting name can contain any printable character except a comma ',' and may be up to 28 characters in length. Spaces may be included in the name by wrapping the name with quotes. For example, ‘custom HBA’.
3. Type the number of the custom Smart Setting to delete and press E NTER 4. A message box appears confirming the request. 5. Type y and press E to delete the custom Smart Setting. NTER Selecting Smart Settings (root/config/port/type) This command selects a Smart Setting for a specified port.
Load Balancing configuration menu (root/config/load) Load balancing builds on the Automatic Trunking functionality by specifying the path that the data uses to flow between multiple switches. Users can manage the switch’s aggregate bandwidth by manually distributing traffic across multiple cascade ports as shown below.
To clear the trunk group members for a specific port: From the Load Balancing configuration menu (root/config/load), type lbclr <port number> and press E NTER Clearing trunk group configurations (root/config/load/lbclr) This command clears all members from being associated with a specific trunk group port.
Deleting AL_PA members from trunk groups (root/config/load/delalpa) This command removes a specified AL_PA member from a trunk group. Once removed from the trunk group, the AL_PA returns to using the primary trunk. To delete an AL_PA member from a specific trunk group: From the Load Balancing configuration menu (root/config/load), type delalpa <cascade port number>...
Table 19. Port utilization information (continued) Value Description The low percentage of data communication through a port over a period of time (measured in seconds). To view port utilization for all ports: From the Load Balancing configuration menu (root/config/load), type util and press NTER A list of the port utilization percentages for the High, Average, and Low levels appears.
Automatic Trunking configuration menu (root/config/trunk) Multiple links between switches are called ‘trunks’. Trunks provide higher bandwidth across cascaded switches for systems incorporating multiple initiators. Each trunk can improve system throughput and provide ‘failover’ capability. A maximum of 4 trunks between each switch is supported. Trunking is performed automatically when ports are configured properly.
Deleting ports members from trunk groups (root/config/trunk/delprt) This command removes port members from a trunk group. In order to delete a member, the member must be explicitly removed from the trunk group. To delete a port from a trunk group: From the Trunking configuration menu (root/config/trunk), type delprt <trunk group number>...
Network configuration menu (root/config/network) The Network configuration menu displays the current network settings and provides commands for configuring the switch’s network settings. Menu commands Table 21. Network configuration menu commands Additional Command Description Information 1. reset Resets the switch. See page 39. 2.
Configuring the IP address setting (root/config/network/ip) This command configures the IP address for the switch. The IP address format should be separated by periods. For example, 196.168.1.129. To change the IP address setting: 1. From the Network configuration menu (root/config/network), type ip and press NTER The switch’s current IP address setting appears in brackets before the command prompt.
One-Step Zoning configuration menu (root/config/zone) One-Step Zoning allows ports to be divided into multiple virtual zones (or work groups), similar to Virtual Local Area Networking (VLAN). By separating activity on the network, zoning also eliminates change notification propagation (change notifications that occur within one zone cannot propagate to other zones.) Use zoning to: •...
Setting the Bad Zone Recovery Reset Hold Time (root/config/zone/bzht) The Bad Zone Recovery Hold Time is the amount of time that the switch keeps the ports in bypass mode before attempting to re-insert the ports into the zone. This setting is measured in milliseconds (.001 seconds).
Removing a port member from a zone (root/config/zone/delprt) This command deletes a port from a zone. Each port may belong to zones 1-11. Ports cannot be deleted from Zone 0 since zone 0 is a special zone managed by the unit. Zone 0 contains all of the ports not associated with other zones.
Displaying the zone state (root/config/zone/zstate) This command displays the current zone state for a specified zone or all zones. The zone state may be "up" (operational) or "down" (non-operational). To view the zone state for all zones: From the Zoning Configuration menu (root/config/zone), type zstate and press E NTER To view the zone state for a specific zone: From the Zoning configuration menu (root/config/zone), type zstate <zone number>...
Page 57
Using the example in Figure 2, suppose you want to restrict Host 1 from accessing sensitive data on Drive 2. AL_PAs 01 and E8 should be added to a route block zone. Figure 2. Route block zone To add an AL_PA member to a blocking group: From the Zoning configuration menu (root/config/zone), type addblk <group number>...
Removing an AL_PA blocking member from a group (root/config/zone/delblk) This command deletes an AL_PA member from an AL_PA blocking group. To remove an AL_PA member from a blocking group: From the Zoning configuration menu (root/config/zone), type delblk <group number> <AL_PA member> and press E NTER Note: Changes to blocking configurations require that zoning be active.
The limitations of hard zoning include: • 2 Gb of shared bandwidth over the entire hard zone. • Ports in a hard zone cannot use the Stealth Intelligent Change Manager. • Automatic Trunking and route blocking are not allowed in a hard zone. •...
Displaying zone AL_PAs (config/zone/alpas) This command displays the AL_PAs for a specific zone or for all zones. To view the AL_PAs for all zones: From the Zoning configuration menu (root/config/zone), type alpas and press E NTER To view the AL_PAs for a specific zone: From the Zoning configuration menu (root/config/zone), type alpas <zone number>...
To view the LIM port for a specific zone: From the Diagnostics menu (root/diag), type glim <zone number> and press E NTER Displaying detected ordered sets (root/diag/os) This command displays the detected ordered sets for a single port or for all ports. To view the detected ordered sets for all ports: From the Diagnostics menu (root/diag), type os and press E NTER...
Table 26. Detected ordered sets (continued) Detection Indication LIPF8 (F8 Failure) A non-switching port has detected a failure on its receive input, is notifying other ports, and is determining whether the network is still operational. Some events that could cause the port to detect network failure follow: •...
Displaying primary ports (root/diag/showpri) This command displays the primary ports and associated duplicates for a single port or for all ports. To view the primary port and associated duplicates for all ports: From the Diagnostics menu (root/diag), type showpri and press E NTER To view the primary port and associated duplicates for a specific port: From the Diagnostics menu (root/diag), type showpri <port number>...
Displaying connected device information (root/diag/con) This command displays the connected device information including the device ID, connected port number, and Stealth settings for one or more ports. To view device information for all ports: From the Diagnostics menu (root/diag), type con and press E NTER To view device information for a specific port: From the Diagnostics menu (root/diag), type con <port number>...
To view all remaining event log messages: Type a and press E NTER To quit viewing the event log messages: Press C Displaying Smart Settings (root/show/ptype) This command displays the available Smart Settings (port types). For a list of available Smart Settings, see the User’s Guide To view the Smart Settings:...
Displaying system information (root/show/sysinfo) This command displays the current switch information. To display current switch information: From the Show menu (root/show), type sysinfo and press E NTER The system information includes the following: Table 28. System information Setting Description System Name The name assigned to the switch.
Table 28. System information (continued) Setting Description Fault Status The current status of the switch. InSpeed SOC Status The current status of the InSpeed SOC chipset. Current Time The switch’s current date and time. System Up Time The duration of time that the switch has been operational. If the switch is rebooted or power is cycled, this value is reset.
Displaying detected ordered sets (root/show/os) This command displays the detected ordered sets for a single port or for all ports. To view the detected ordered sets for all ports: From the Show menu (root/show), type os and press E NTER To view the detected ordered sets for a specific port: From the Show menu (root/show), type os <port number>...
Table 30. Sensor information Setting Indicator Enclosure Temperature Nominal (green)–the switch temperature is within the normal operating range. OverTemp (red)–the enclosure temperature has exceeded the recommended operating range (above 45 Nominal (green)–the fan unit is working properly. Not Present (yellow)–the fan unit has been removed or cannot be detected.
Note: HyperTerminal® users can capture the entire switch setting display by enabling the text capture feature. To enable this feature, click Transfer > Capture Text and designate the location and filename for the file. Once this feature is enabled, proceed with the instructions above. When the system is finished downloading the switch information, open the text file to view the settings.
4. Type show and press E NTER The active and alternate firmware versions appear. 5. Type reset to reboot the switch to activate the new image. Unix Instructions Unix users should replace step #2 above with the following instructions: 1. At a Unix prompt, type tftp <IPaddress> (where IPaddress is the switch’s IP Address) and press E NTER 2.
6. Type y and press E NTER The following message appears: Transfer Complete. Verifying file integrity..Verification Complete. Copying to Flash..... Flash Copy Complete. Download Complete. New image will become active upon reset. Figure 6. XMODEM download complete message 7. Type show and press E NTER The active and alternate firmware versions appear.
Page 78
2. To save changes and reset the switch, type y and press E NTER To reset the switch without saving changes, type n and press E NTER To cancel the request to reset the switch, type c and press E NTER 2006 Model L10 Storage Switch...
Page 80
Table 33. Event messages (continued) Event Event Message Severity Segment stall on Port # NOTIFY Bad Open on Port # Error during Port Disc. NOTIFY Port # PTBI failed due to timeout NOTIFY Port # changed to <state> NOTIFY Transceiver in Port # has been cycled NOTIFY Port # has cycled between insert/bypassed (not NOTIFY...
Page 88
config/sys/time 14 show/sync 60 config/trunk 37 show/sysinfo 57 config/zone 41 show/zalpas 61 config/zone/act 43 show/zninfo 58 config/zone/addblk 44 comments x config/zone/addprt 42 configuration config/zone/alpas 48 port information 21 config/zone/bzdt 42 Configuration menu config/zone/bzht 42 Automatic Trunking Configuration menu 37 config/zone/bzr 47 default command 9 config/zone/deact 43 help command 10...
Page 89
Smart Settings 24 switch settings 60 IBM Smart Settings 26 system information 57 IBM Linux Initiator 26 trunk group members 33 IBM Linux Stealth Initiator 26 zone AL_PAs 48 Initiator AL_PAs 53 zone information 58 installation, switch 9 zone state 44...
Page 90
displaying 59 configuring gateway setting 40 LIP (F8) Recovery Policy 29 configuring IP address 40 LIP on Insert Policy 28 configuring network mask setting 40 LIP on Removal Policy 28 displaying settings 39 listing Network Configuration menu 39 commands 6 gateway command 40 load balancing ip command 40...
Page 91
7 Smart Settings reset command 7 Show menu 55 IBM Linux Initiator route blocking 44 IBM Linux Stealth Initiator Port Configuration menu 20 add command 31 selecting beacon command 20 Smart Settings 32 del command 31 sensor information 59...
Page 92
Fabric Connection 25 adding port members 37 IBM 26 clearing 34 IBM Linux Initiator 26 deleting AL_PA members 35 IBM Linux Stealth Initiator 26 deleting members 34 Initiator or Target 25 deleting port members 38 Initiator with Stealth 25 displaying members 33...
Page 93
Thank you for your responses. May we contact you? h Yes h No When you send comments to IBM, you grant IBM a nonexclusive right to use or distribute your comments in any way it believes appropriate without incurring any obligation to you. Name...
Page 94
Readers’ Comments — We’d Like to Hear from You Cut or Fold Along Line GC26-7652-00 Fold and Tape Please do not staple Fold and Tape _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ NO POSTAGE NECESSARY IF MAILED IN THE...