Simplify SANbox2-8c/16 Switch Management User’s Guide 59022-04 B Page i
SANbox2-8c/16 Switch Management User’s Guide Information furnished in this manual is believed to be accurate and reliable. However, QLogic Corporation assumes no responsibility for its use, nor for any infringements of patents or other rights of third parties which may result from its use. QLogic Corporation reserves the right to change product specifications at any time without notice. Applications described in this document for any of these products are for illustrative purposes only.
Table of Contents Section 1 Introduction 1.1 1.2 1.3 1.3.1 1.3.2 1.3.3 Intended Audience ............................................................................................. 1-1 Related Materials ............................................................................................... 1-1 Technical Support............................................................................................... 1-2 Availability...........................................................................
SANbox2-8c/16 Switch Management User’s Guide 2.11.2 2.11.2.1 2.11.2.2 2.11.3 Working with Ports................................................................................... 2-19 Selecting Ports................................................................................ 2-19 Opening Popup Menus ................................................................... 2-19 Faceplate Data Windows.........................................................................
3.5.6.4 3.5.6.5 3.5.6.6 3.5.7 3.5.7.1 3.5.7.2 3.5.7.3 3.5.7.4 3.5.7.5 3.5.7.6 3.5.7.7 3.5.8 3.5.8.1 3.5.8.2 3.5.8.3 SANbox2-8c/16 Switch Management User’s Guide Removing a Zone from a Zone Set or from All Zone Sets.............. 3-18 Removing a Zone Set ..................................................................... 3-19 Removing All Zoning Definitions..................................................... 3-19 Managing Zones...........................................................................
SANbox2-8c/16 Switch Management User’s Guide 4.7.1.6 4.7.2 4.7.2.1 4.7.2.2 4.7.2.3 4.7.2.4 4.7.3 4.7.4 4.8 4.9 4.10 4.10.1 4.10.2 4.11 Timeout Values ............................................................................... 4-14 Network Properties .................................................................................. 4-15 IP Configuration .............................................................................. 4-16 Remote Logging .................................................
SANbox2-8c/16 Switch Management User’s Guide Admin Command.......................................................................................A-4 Alias Command .........................................................................................A-5 Config Command.......................................................................................A-7 Date Command .........................................................................................A-9 Fallback Command.........................
SANbox2-8c/16 Switch Management User’s Guide Figures Figure Page 2-1 SANbox Manager Window ............................................................................................. 2-5 2-2 Load Default Fabric View File Window .......................................................................... 2-5 2-3 Add a New Fabric Window............................................................................................. 2-6 2-4 Save Current Fabric View Window ......................................
4-8 4-9 5-1 5-2 5-3 5-4 5-5 5-6 5-7 5-8 5-9 A-1 A-2 A-3 A-4 A-5 A-6 A-7 A-8 A-9 A-10 A-11 A-12 A-13 SANbox2-8c/16 Switch Management User’s Guide SNMP Trap Configuration Parameters ........................................................................ 4-16 Factory Default Configuration Settings ........................................................................ 4-20 Port Modes.....................................................................................................................
SANbox2-8c/16 Switch Management User’s Guide Notes Page x 59022-04 B
Section 1 Introduction This manual describes the switch management tools which include the SANbox® Manager® application (version 1.04) and the Command Line Interface (CLI) for the SANbox2-8c and SANbox2-16 Fibre Channel switches (firmware version 1.4). The SANbox Manager switch management application is the primary focus of this manual which is organized as follows: ■ Section 1 describes the intended audience for this manual, related materials, and technical support.
1 – Introduction Technical Support 1.3 Technical Support Customers should contact their authorized maintenance provider for technical support of their QLogic switch products. QLogic-direct customers may contact QLogic Technical Support; others will be redirected to their authorized maintenance provider. Visit the QLogic switch support Web site listed in Contact Information for the latest firmware and software updates. 1.3.
Section 2 Using SANbox Manager This section describes how to use the SANbox Manager application and its menus. The following topics are covered: ■ Installing SANbox Manager ■ Starting SANbox Manager ■ Exiting SANbox Manager ■ Changing the password for the default fabric view file ■ Setting SANbox Manager user preferences ■ Using online help ■ SANbox Manager user interface ■ Using the topology display ■ Using the faceplate display 2.
2 – Using SANbox Manager Installing SANbox Manager 2.1.1 For Windows: To install the SANbox Manager application on Windows from the SANsurfer Tool Kit CD-ROM, do the following: 1. Close all programs currently running, and Insert the SANsurfer Tool Kit CD into the management workstation CD-ROM drive. If the SANsurfer Tool Kit start page does not open in your default browser, do the following: a. Using Windows Explorer, double-click the drive letter which contains the SANsurfer Took Kit CD. b.
2 – Using SANbox Manager Installing SANbox Manager b. Mount the CD-ROM. From a shell prompt, enter the following command: mount /mnt/cdrom c. Execute your web browser to view the Start_Here.htm document using one of the following commands: $mozilla file:/mnt/cdrom/Start_Here.htm or $netscape file:/mnt/cdrom/Start_Here.htm d. The SANsurfer Tool Kit start page opens in your default browser. 2. On the SANsurfer Tool Kit start page, choose the SANbox Switch Software button. 3.
2 – Using SANbox Manager Starting SANbox Manager c. In File Manager, double-click the CD-ROM icon, and then double-click the Sansurfer folder. d. In the Sansurfer folder, double-click the Start_Here.htm file to open the SANsurfer Tool Kit start page in your default browser. 2. On the SANsurfer Tool Kit start page, choose the SANbox Switch Software button. 3. On the SANbox Switch Software page, scroll to the SANbox2-8c/16 (2Gb) Series area. 4.
2 – Using SANbox Manager Starting SANbox Manager Figure 2-1 SANbox Manager Window If the default fabric view file exists, the system prompts you to enter the file password as shown in Figure 2-2. Enter the password and choose the Load View File button to open the SANbox Manager application and load a previously saved set of fabrics. Otherwise, choose the Continue Without Loading button to open an empty fabric view. Choose the Add button to open the Add a New Fabric window shown in Figure 2-3.
2 – Using SANbox Manager Exiting SANbox Manager Figure 2-3 Add a New Fabric Window 2. Enter a fabric name and the IP address of the switch through which to manage the fabric. 3. Enter an account name and a password. The factory account name is "admin" and the factory password is "password". If security is turned off (default), you are not required to enter an account name or password. This account name is for the switch and is stored in the switch firmware.
2 – Using SANbox Manager Uninstalling SANbox Manager (Enable is the default). Refer to ”Setting Preferences” on page 2-8 for more information. To exit a SANbox Manager application session, open the File menu and select Exit. The system prompts you to enter a password with which to protect the default fabric view file as shown in Figure 2-4. Choose one of the following: ■ Enter a password and choose the Save View File button to save the current set of fabrics in the default fabric view file (fc_view.
2 – Using SANbox Manager Changing Default File Password 2. Double-click the uninstall program file or shortcut/link, and follow the instructions to uninstall the SANbox Manager application. Note: For UNIX uninstalls, execute the link to Uninstall_SANbox_Manager. If no links were created during the installation, run: $INSTALL_DIR/UninstallerData/Uninstall_SANbox_Manager. Where INSTALL_DIR is the directory selected for installation. 2.
2 – Using SANbox Manager Using Online Help Figure 2-6 Preferences Window To set user preferences for your SANbox Manager sessions, do the following: 1. Open the File menu, and select Preferences to open the Preferences window. 2. Enter or browse for paths to the working directory and browser. 3. In the Application-wide Options area, choose the polling frequency, enable or disable the View File Auto Save and Load feature, and choose the initial port view when entering the faceplate display. 4.
2 – Using SANbox Manager SANbox Manager User Interface 2.9 SANbox Manager User Interface The SANbox Manager application uses two basic displays to manage the fabric and individual switches: the topology display and the faceplate display. The topology display shows all switches that are able to communicate and all connections between switches. The faceplate display shows the front of a single switch and its ports. Both displays share some common elements as shown in Figure 2-7.
2 – Using SANbox Manager SANbox Manager User Interface 2.9.1 Menu Bar The Menu Bar presents the SANbox Manager menus as shown in Figure 2-8. The menus and the tasks offered in them vary depending on the display. For example, the Port menu and many of the Switch menu selections, shown in gray, appear only in the faceplate display. File Fabric Switch Open View File... Save View As... Change Default File Password... Preferences... Exit Add Fabric...
2 – Using SANbox Manager SANbox Manager User Interface In addition to the menu bar, both the topology and faceplate displays have context sensitive menus that pop up when you click in the graphic window with the right mouse button. Refer to ”Opening the Faceplate Display and Popup Menus” on page 2-16 for more information about these popup menus. 2.9.2 Tool Bar The Tool Bar consists of a row of graphical buttons that you can use to access SANbox Manager functions as shown in Table 2-3.
2 – Using SANbox Manager SANbox Manager User Interface 2.9.3 Fabric Tree The fabric tree lists the managed fabrics and their switches as shown in Figure 2-9. The window width can be adjusted by clicking and dragging the moveable window border. An entry handle located to the left of an entry in the tree indicates that the entry can be expanded. Click this handle or double-click the entry to expand or contract a fabric tree entry. A fabric entry expands to show its member switches.
2 – Using SANbox Manager SANbox Manager User Interface 2.9.4 Graphic Window The graphic window presents graphic information about fabrics and switches such as the fabric topology and the switch faceplate. The window length can be adjusted by clicking and dragging the window border that it shares with the data window. 2.9.5 Data Window and Tabs The data window presents a table of data and statistics associated with the selected tab. Use the scroll bar to browse through the data.
2 – Using SANbox Manager Using the Topology Display 2.10 Using the Topology Display The topology display shown in Figure 2-10 polls the selected fabric and displays its topology. Switches and inter-switch links (ISL) appear in the graphic window and use color to indicate status. Consider the following topology display features: ■ Switch and link status ■ Working with switches and links ■ Topology data windows Figure 2-10 Topology Display 2.10.
2 – Using SANbox Manager Using the Topology Display 2.10.2 Working with Switches and Links Switch and link icons are selectable and moveable, and serve as access points for other displays and menus. You select switches and links to display information about them, modify their configuration, or delete them from the display. The context-sensitive popup menus are accessible through the switch and link icons. 2.10.2.1 Selecting Switches and Links Selected switch icons are highlighted in violet.
2 – Using SANbox Manager Using the Topology Display ■ To open the switch popup menu when viewing the topology display, right-click the switch icon in the graphic window. The switch popup menu presents selections to refresh the switch, delete the switch from the display, open the Switch Properties window, or open the Network Properties window. ■ To open the link popup menu, right-click the link. The Link popup menu presents a selection to delete the link from the display.
2 – Using SANbox Manager Using the Faceplate Display 2.11 Using the Faceplate Display The faceplate display shown in Figure 2-11 displays the switch name and operational state, and port status. Consider the following functional elements of the faceplate display: ■ Port views and status ■ Working with ports ■ Faceplate data windows Figure 2-11 Faceplate Display 2.11.1 Port Views and Status Port color and text provides information about the port and its operational state.
2 – Using SANbox Manager Using the Faceplate Display 2.11.2 Working with Ports Ports are selectable and serve as access points for other displays and menus. You select ports to display information about them in the data window or to modify them. Context sensitive popup menus and properties windows are accessible through the faceplate and port icons. 2.11.2.1 Selecting Ports You can select ports in the following ways. Selected ports are highlighted with a white border.
2 – Using SANbox Manager Using the Faceplate Display 2.11.3 Faceplate Data Windows The faceplate display provides the following data windows corresponding to the data window tabs: 2-20 ■ Name Server – displays all devices connected to the switch that are logged with the name server. ■ Switch – displays current switch configuration data. ■ Port Statistics – displays port performance data for the selected port(s). ■ Port Information – displays port detail information for the selected port.
Section 3 Managing Fabrics This section describes the following tasks that manage fabrics: ■ Security ■ Managing the fabric database ■ Displaying fabric information ■ Zoning a fabric 3.1 Security The two components of SANbox2 security are user authentication and fabric security. The user must be authenticated before gaining access to a switch. If an invalid account name/password combination is entered, that user can not access the switch, and thus can not gain access to the fabric.
3 – Managing Fabrics Managing the Fabric Database 3.2 Managing the Fabric Database A fabric database contains the set of fabrics that you have added during a SANbox Manager session. Initially, the SANbox Manager application opens with an empty fabric database. 3.2.1 Adding a Fabric To add a fabric to the database, do the following: 1. Open the Fabric menu and select Add Fabric to open the Add a New Fabric window as shown in Figure 3-1. Figure 3-1 Add a New Fabric Window 2.
3 – Managing Fabrics Managing the Fabric Database 3.2.2 Removing a Fabric To delete a fabric file from the database, do the following: 1. Select a fabric in the fabric tree. 2. Open the Fabric menu and select Remove Fabric. 3.2.3 Opening a Fabric View File To open an existing view file, do the following: 1. Open the File menu, and select Open View File, or choose the Open button.
3 – Managing Fabrics Replacing a Failed Switch 3.2.6 Adding a New Switch to a Fabric If there are no special conditions to be configured for the new switch, simply plug in the switch and the switch becomes functional with the default fabric configuration. The default fabric configuration settings are: ■ Fabric zoning is sent to the switch from the fabric. ■ All ports will be GL_Ports. ■ The default IP address 10.0.0.
3 – Managing Fabrics Replacing a Failed Switch 2. At the replacement switch: a. Mount the switch in the location where the failed switch was removed. b. Install the SFPs using the same ports as were used on the failed switch. CAUTION! c. Do not reconnect inter-switch links, target devices, and initiator devices at this time. Doing so could invalidate the fabric zoning configuration. Attach the AC cords and power up the switch. 3. Select the failed switch in the topology display.
3 – Managing Fabrics Displaying Fabric Information 3.4 Displaying Fabric Information The topology display is your primary tool for monitoring a fabric. The graphics window of the topology display provides status information for switches, inter-switch links, and the Ethernet connection to the management workstation. The data window tabs show name server, switch, and active zone set information. The Active Zoneset tab shows the zone definitions for the active zone set.
3 – Managing Fabrics Displaying Fabric Information Table 3-1 Topology Display Switch and Status Icons Switch Icon Description SANbox2-8c/16 Switch Normal operation (Green) SANbox2-8c Switch Normal operation (Green) Non-QLogic Switch, or a QLogic Switch with different security than the fabric management switch.
3 – Managing Fabrics Displaying Fabric Information 3.4.2 Active Zone Set Data Window The Active Zoneset data window displays the zone membership for the active zone set that resides on the fabric management switch. The active zone set is the same on all switches in the fabric – you can confirm this by adding a fabric through another switch and comparing Active Zone Set displays. To open the Active Zoneset data window, choose the Active Zoneset tab below the data window in the topology display.
3 – Managing Fabrics Zoning a Fabric 3.5 Zoning a Fabric Zoning enables you to divide the ports and devices of the fabric into zones for more efficient and secure communication among functionally grouped nodes. This subsection addresses the following topics: ■ Zoning concepts ■ Using the Zoning Config window ■ Restoring default zoning ■ Using the Edit Zoning window ■ Merging fabrics and zoning ■ Managing zone sets ■ Managing zones ■ Managing aliases 3.5.
3 – Managing Fabrics Zoning a Fabric 3.5.1.1.1 Soft Zones Soft zoning divides the fabric for purposes of controlling discovery. Members of the same soft zone automatically discover and communicate freely with all other members of the same zone. The soft zone boundary is not secure; traffic across soft zones can occur if addressed correctly. Soft zones that include members from multiple switches need not include the ports of the inter-switch links.
3 – Managing Fabrics Zoning a Fabric Note: Domain ID conflicts can result in automatic reassignment of switch domain IDs. These reassignments are not reflected in zones that use domain ID and port number pairs or Fibre Channel addresses to define their membership. Be sure to reconfigure zones that are affected by a domain ID change. To prevent zoning definitions from becoming invalid when the membership is defined by domain ID/port number or Fibre Channel address, you must lock domain IDs.
3 – Managing Fabrics Zoning a Fabric ■ Maximum number of zonesets is 256 ■ Maximum number of zones is 256 ■ Maximum total number of zone set members is 1000 ■ Maximum number of members per zone is 2000 ■ Maximum number of aliases is 256 ■ Maximum number of members per alias is 2000 ■ Maximum total number of zone and alias members is 2000 3.5.1.
3 – Managing Fabrics Zoning a Fabric 3.5.2.1 Auto Save The Auto Save parameter determines whether changes to the active zone set that a switch receives from other switches in the fabric will be saved to permanent memory on that switch. Changes are saved when an updated zone set is activated. Zoning changes are always saved to temporary memory. However, if Auto Save is enabled, the switch firmware saves changes to the active zone set in both temporary and permanent memory.
3 – Managing Fabrics Zoning a Fabric 3.5.4 Merging Fabrics and Zoning If you join two fabrics, the active zone sets from the two fabrics attempt to merge. The fabrics may consist of a single switch or many switches already connected together. The switches in the two fabrics attempt to create a new active zone set containing the union of each fabric’s active zone set. The propagation of zoning information only affects the active zone set, not the configured zone sets. 3.5.4.
3 – Managing Fabrics Zoning a Fabric 3.5.5 Using the Edit Zoning Window To edit the zoning database for a particular switch, open the Zoning menu from the faceplate display and select Edit Zoning to open the Edit Zoning window shown in Figure 3-4. Changes can only be made to inactive zone sets, which are stored in flash (non-volatile) memory and retained after resetting a switch. The Edit Zoning window has a Zone Sets tree on the left and a Port/Device (or members) tree on the right.
3 – Managing Fabrics Zoning a Fabric Using tool bar buttons, popup menus, or a drag-and-drop method, you can create and manage zone sets and zones in the zoning database. The Apply button saves changes to the zoning database without closing the window. The OK button saves the zoning changes to the database and closes the window.
3 – Managing Fabrics Zoning a Fabric 3.5.6 Managing Zone Sets Zoning a fabric involves creating a zone set, creating zones as zone set members, then adding devices as zone members. The zoning database supports multiple zone sets to serve the different security and access needs of your storage area network, but only one zone set can be active at one time.
3 – Managing Fabrics Zoning a Fabric 3.5.6.2 Activating and Deactivating a Zone Set You must activate a zone set to apply its zoning definitions to the fabric. Only one zone set can be active at one time. When you activate a zone set, the switch distributes that zone set to the temporary zoning database on every switch in the fabric replacing any zone set of the same name. If Auto Save is enabled, the zone set is saved in the permanent zoning database also. Refer to ”Auto Save” on page 3-13.
3 – Managing Fabrics Zoning a Fabric 3.5.6.5 Removing a Zone Set Removing a zone set from the database affects the member zones in the following ways. ■ Member zones that are members of other zone sets are not affected. ■ Member zones that are not members of other zone sets become members of the orphan zone set. The orphan zone set is saved on the switch. To delete a zone set from the database, do the following: 1.
3 – Managing Fabrics Zoning a Fabric Note: Changes that you make to the zoning database are limited to the managed switch and do not propagate to the rest of the fabric. To distribute changes to configured zone sets fabric wide, you must edit the zoning databases on the individual switches. 3.5.7.1 Creating a Zone in a Zone Set When a zone is created, its zone type is soft. To change the zone type to a hard zone, refer to ”Changing Zone Types” on page 3-22 for more information.
3 – Managing Fabrics Zoning a Fabric 3.5.7.2 Adding Zone Members Adding a zone member to a zone will affect every zone set in which that zone is a member. To add member ports/devices to a zone, do one of the following: ■ Select a port by port number, Fibre Channel address, or worldwide name in the Port/Device tree, and drag it into the zone. To select and drag multiple ports/devices, press and hold the Control key while dragging.
3 – Managing Fabrics Zoning a Fabric 3.5.7.5 Removing a Zone from a Zone Set Removing a zone from a zone set will affect every zone set in which that zone is a member. Zones that are no longer members of any zone set are moved to the orphan zone set. The orphan zone set is saved on the switch. To delete a zone from a zone set: 1. In the Edit Zoning window, select the zone to be removed. 2. Open the Edit menu and select Remove. 3.
3 – Managing Fabrics Zoning a Fabric 3.5.8 Managing Aliases An alias is a collection of objects that can be zoned together. An alias is not a zone, and can not have a zone or another alias as a member. Note: Changes that you make to the zoning database are limited to the managed switch and do not propagate to the rest of the fabric. To distribute changes to configured zone sets fabric wide, you must edit the zoning databases on the individual switches. 3.5.8.
3 – Managing Fabrics Zoning a Fabric 3.5.8.2 Adding a Member to an Alias The three ways to add a member to an alias are: ■ Drag-and-drop method. ■ Select the alias in the left pane and the member in the right pane to add to that alias, and choose the Insert button. ■ Select the alias in the left pane and the member in the right pane to add to that alias, and open the Edit menu and select Add Members. To add a member to an alias using the drag-and-drop method, do the following: 1.
Section 4 Managing Switches This section describes the following tasks that manage switches in the fabric. ■ Displaying switch information ■ Managing alarms ■ Exporting name server information to a file ■ Paging a switch ■ Resetting a switch ■ Setting the date and time ■ Configuring a switch ■ Archiving a switch ■ Restoring a switch ■ Managing firmware ■ Restoring the factory default configuration 4.
4 – Managing Switches Displaying Switch Information Figure 4-1 Faceplate Display The fabric updates the topology and faceplate displays by forwarding changes in status to the management workstation as they occur. You can allow the fabric to update the switch status, or you can refresh the display at any time. To refresh switch status in the display, do one of the following: 4-2 ■ Choose the Refresh button. ■ Open the View menu and select Refresh. ■ Press the F5 key.
4 – Managing Switches Displaying Switch Information 4.1.1 Displaying Hardware Status A switch is equipped with the following chassis LEDs that provide hardware status information: ■ Chassis Over Temperature LED - indicates air temperature inside the switch. ■ Fan Fail LED - indicates operational status of both fans. ■ Heartbeat LED - indicates the status of the internal switch processor and the results of Power On Self Tests (POSTs).
4 – Managing Switches Displaying Switch Information Table 4-1 Name Server Data Window Entries Entry Description Dev Device number in the fabric Switch Switch name Port Port number (0–8 or 0–15) Address Fibre Channel address Type Node type WWNN Worldwide node name WWPN Worldwide port name Vendor Host Bus Adapter/Device Vendor FC-4 Types Device Fibre Channel protocol types Active Zones The active zone to which the device belongs 4.1.
4 – Managing Switches Displaying Switch Information Table 4-2 Switch Data Window Entries (Continued) Entry 59022-04 B Description PROM/Flasher Version Firmware version MAC Address Media Access Control address IP Address Internet Protocol Address Subnet Mask Mask that determines the IP address subnet Gateway Gateway address Negotiated Domain ID The domain ID currently being used by the fabric Configured Domain ID The domain ID defined by network administrator Domain ID Lock Domain ID lo
4 – Managing Switches Displaying Switch Information Table 4-2 Switch Data Window Entries (Continued) Entry Description Power Supply 1 Status Power supply 1 status Power Supply 2 Status Power supply 2 status Beacon Status Beacon status. Switch LEDs are blinking (On) or not (off). Broadcast Support Broadcast support status. Broadcast support is enabled or disabled (default). Inband Enabled Inband management status. Permits (True) or prevents (False) a switch from being managed over an ISL. 4.
4 – Managing Switches Displaying Switch Information 4.1.7 Configured Zonesets Data Window The Configured Zonesets data window displays all zone sets, zones, and zone membership in the zoning database, as shown in Figure 4-3. To open the Configured Zonesets data window, choose the Configured Zonesets tab below the data window in the faceplate display. The Configured Zonesets data window uses display conventions for expanding and contracting entries that are similar to the fabric tree.
4 – Managing Switches Managing Alarms 4.1.8 Alarm Log Data Window The Alarm Log data window displays switch event information. To open the Alarm Log data window, choose the Alarm Log tab in the faceplate display. Table 4-3 Alarm Log Data Window Entries Entry Description Time Stamp The time the event occurred. Alarm Type The configured alarm type. Description Additional information about the alarm. 4.2 Managing Alarms You can configure the switch to generate and log alarms.
4 – Managing Switches Managing Alarms Figure 4-4. Alarm Threshold Configuration Window 3. 59022-04 B Select an event type from the Alarm Threshold pull-down menu. Choose from the following options: ■ CRC error monitoring ■ Decode error monitoring ■ ISL monitoring ■ Login monitoring ■ Logout monitoring ■ Loss of signal monitoring 4. Enter a value for the falling threshold. The falling threshold is the event count above which an event becomes eligible for logging in the alarm log. 5.
4 – Managing Switches Exporting Name Server Information to a File 4.2.2 Exporting Alarm Log Information to a File To save the switch alarm log to a file, open the faceplate display and do the following: 1. Open the Switch menu and select Export Alarm Log. 2. In the Save window, enter a file name. 3. Choose the Save button. 4.3 Exporting Name Server Information to a File To save switch name server information to file, open the topology display and do the following: 1.
4 – Managing Switches Configuring a Switch 4.7 Configuring a Switch Switch configuration is divided into two areas: chassis configuration and network configuration. Chassis configuration specifies switch-wide Fibre Channel settings. Network configuration specifies Ethernet and SNMP settings. To open the Switch Properties window, open the Switch menu and select Switch Properties.
4 – Managing Switches Configuring a Switch 4.7.1.2 Switch Administrative States The switch administrative state determines the operational state of the switch and its ports. The switch administrative state exists in two forms: the configured administrative state and the current administrative state. ■ The configured administrative state is the state that is saved in the switch configuration and is preserved across switch resets.
4 – Managing Switches Configuring a Switch If you connect a new switch to an existing fabric with its domain ID unlocked, and a domain conflict occurs, the new switch will isolate as a separate fabric. However, you can remedy this by resetting the new switch or taking it offline then back online. The principal switch will reassign the domain ID and the switch will join the fabric. Note: Domain ID reassignment is not reflected in zoning that is defined by domain ID and port number pair.
4 – Managing Switches Configuring a Switch 4.7.1.6 Timeout Values The switch timeout values determine the timeout values for all ports on the switch. Table 4-5 describes the switch timeout parameters. The R_A_TOV, R_T_TOV, or E_D_TOV values must be the same for all switches in the fabric. Note: Timeout values can only be changed if the switch operational state is offline.
4 – Managing Switches Configuring a Switch 4.7.2 Network Properties Use the Network Properties window shown in Figure 4-6 to change IP and SNMP configuration parameters. After making changes, choose the OK button to put the new values into effect. To open the Network Properties window, open the Switch menu and select Network Properties. Note: Since Read Community, Trap Community, and Write Community settings are like passwords, they are write-only fields; the current settings are not displayed.
4 – Managing Switches Configuring a Switch 4.7.2.1 IP Configuration The IP configuration identifies the switch on the Ethernet network and determines which boot method to use. Table 4-6 describes the IP configuration parameters. Table 4-6 IP Configuration Parameters Parameter 4-16 Description IP Address Internet Protocol (IP) address for the Ethernet port. The default and PROM mode value is 10.0.0.1. Subnet mask Subnet mask address for the Ethernet port. The default and PROM mode value is 255.0.
4 – Managing Switches Configuring a Switch 4.7.2.2 Remote Logging The Remote Logging (syslog) feature enables saving of the log information to a remote host that supports the syslog protocol. When enabled, the log entries are sent to the syslog host at the IP address that you specify in the Logging Host IP Address field. Log entries are saved in the internal switch log whether this feature is enabled or not. To save log information to a remote host, you must edit the syslog.
4 – Managing Switches Configuring a Switch 4.7.2.4 SNMP Trap Configuration The SNMP trap configuration defines how traps are set. Table 4-8 describes the SNMP configuration parameters. Table 4-8 SNMP Trap Configuration Parameters Parameter Description Trap Enabled Check box to enable or disable the trap. Trap Address Specifies the IP address to which SNMP traps are sent. A maximum of 5 trap addresses are supported. The default address for trap 1 is 10.0.0.254.
4 – Managing Switches Archiving a Switch 4.8 Archiving a Switch You can create an .XML archive file containing the configuration parameters. Archived parameters include the following: ■ Switch properties and statistics ■ IP configuration ■ SNMP configuration ■ Port properties and statistics ■ Zoning configuration This archive file can be used to restore the configuration on the same switch or on a replacement switch.
4 – Managing Switches Managing Firmware 4.10 Managing Firmware The switch memory is partitioned for two firmware images. This can be useful when upgrading so that both the old an new firmware can be maintained on the switch. When you install new firmware, the currently active firmware is preserved and the new firmware becomes the second image or the fallback version. You have the ability to activate either firmware image.
4 – Managing Switches Restoring the Factory Default Configuration 4.11 Restoring the Factory Default Configuration You can restore the switch and port configuration settings to the factory default values. To restore the factory configuration on a switch, open the Switch menu and select Restore Factory Defaults. Table 4-9 lists the factory default switch configuration settings. Restoring the switch to the factory default configuration does not restore the account name and password settings.
4 – Managing Switches Restoring the Factory Default Configuration Table 4-9 Factory Default Configuration Settings (Continued) Setting 4-22 Value Trap address Trap 1: 10.0.0.254; Traps 2-5: 0.0.0.
Section 5 Managing Ports This section describes the following tasks that manage ports and devices: ■ Displaying port information ■ Configuring ports ■ Testing ports 5.1 Displaying Port Information Port information is available primarily in the faceplate display shown in Figure 5-1. The faceplate display data windows provide information and statistics for switches and ports. Use the topology display to show the status information for links between switches.
5 – Managing Ports Displaying Port Information 5.1.1 Monitoring Port Status The faceplate display provides the following port related information: ■ Port mode ■ Port operational state ■ Port speed ■ Port media To display port number and status information for a port, position the cursor over a port on the faceplate display. The status information changes depending on the View menu option selected. 5.1.1.
5 – Managing Ports Displaying Port Information 5.1.1.2 Displaying Port Operational States To display the operational state on each port in the faceplate display, open the View menu and select View Port States. Table 5-2 lists the possible operational states and their meanings. The port operational state refers to actual port state and not the administrative state you may have assigned. Table 5-2 Port Operational States State Description On Online – port is active and ready to send data.
5 – Managing Ports Displaying Port Information 5.1.1.4 Displaying Tranceiver Media Status To display transceiver media status, open the View menu and select View Port Media. Table 5-2 lists the possible media states and their meanings. Table 5-4 Transceiver Media View Media Icon Description Optical SFP, Online (Green) Optical SFP, Offline (Gray) None Empty port, no transceiver installed 5.1.2 Port Statistics Data Window The Port Statistics data window displays statistics about port performance.
5 – Managing Ports Displaying Port Information Table 5-5 Port Statistics Data Window Entries (Continued) Entry 59022-04 B Description Logout Count Number of logouts that have occurred on the switch. Al Init Count Number of times the port entered the initialization state. Invalid Destination Address Number of address identifiers (S_ID, D_ID) found to be in error. Total LIP Received Number of loop initialization primative frames received.
5 – Managing Ports Displaying Port Information Table 5-5 Port Statistics Data Window Entries (Continued) Entry 5-6 Description Class 3 Toss Count Number of class 2 and class 3 sequences that were discarded by this port. A sequence can be discarded because of detection of a missing frame (based on SEQ_CNT), detection of an E_D_TOV timeout, receiving a reject frame, receiving frames for a stopped sequence, or other causes. FReject Count Number of frames, from devices, that have been rejected.
5 – Managing Ports Displaying Port Information 5.1.3 Port Information Data Window The Port Information data window displays port detail information for the selected port. To open the Port Information data window, choose the Port Info tab below the data window in the faceplate display. Table 5-6 Port Information Data Window Entries Entry 59022-04 B Description Port Address Port Fibre Channel address. Admin Port Mode The port mode before auto-configuration occurs.
5 – Managing Ports Configuring Ports 5.1.4 Name Server Data Window The Name Server data window displays information about the port and the connected device. To open the Name Server data window, select one or more switches in the topology display and choose the Name Server tab below the data window. You can also open the Name Server data window in the faceplate display. Refer to Table 4-1 for a description of the Name Server data window entries. 5.
5 – Managing Ports Configuring Ports 5.2.1 Changing Port Administrative States The port administrative state determines the operational state of a port. The port administrative state exists in two forms: the configured administrative state and the current administrative state. ■ The configured administrative state is the state that is saved in the switch configuration and is preserved across switch resets. SANbox Manager always makes changes to the configured administrative state.
5 – Managing Ports Configuring Ports 4. Choose the Apply button to write the new port speed to the switch. Table 5-8 Port Speeds State Description Auto-Detect Matches the transmission speed of the connected device. This is the default. 1Gb Sets the transmission speed to 1 Gbps. 2Gb Sets the transmission speed to 2 Gbps. 5.2.3 Changing Port Modes The SANbox2 switch ports support both public and private devices as single devices or in loops.
5 – Managing Ports Configuring Ports 5.2.4 Changing TL Modes You can configure a TL_Port to support a loop of private target devices or a loop of private initiator devices. ■ For a loop of up to 124 private target devices, choose the TL Target radio button. This enables up to 63 initiator devices anywhere in the fabric to automatically connect with the private devices on the TL_Port.
5 – Managing Ports Configuring Ports This is called credit extension. Each donor port contributes 11 credits to the pool from which the recipient ports can draw. For example, one donor port contributes 11 credits to the pool from which a recipient draws for a total of 23 credits (11+12). This provides approximately 38 Km at 1 Gbps (23÷0.6) or 19 Km at 2 Gbps (23÷1.2). To extend port buffer credits, do the following: 1. In the faceplate display, select the ports that are to serve as donor ports.
5 – Managing Ports Testing Ports 4. To confirm that the requested credits were received, reopen the Extended Credits window and match the number of credits in the "Ext Credits Requested" column with the number in the "Donated to Port" column. Note: As credits are used, the Logged-In LEDs on the corresponding donor ports illuminate continuously. In addition, donor port Activity LEDs will reflect the same traffic as the recipient port.
5 – Managing Ports Testing Ports Figure 5-4 Port Loopback Test Window Note: The SerDes (Internal) and SFP (External) level tests disrupt communication on the selected port. The Node-to-Node (Online) level test does not disrupt communication, because the requires that the port be online. To run the internal, external, or online port loopback test on a port, do the following: 5-14 1. In the faceplate display, select the port to be tested. 2.
59022-04 B 5 – Managing Ports Testing Ports 5. Choose the Start Test button to begin the test. The Test Results area displays the test status, number of frames sent, and number of errors found. 6. To test another port, open the Select Port pull-down menu and select another port (number) and test type (Internal, External, or Online) in the Test Selection area. 7. Choose the Start Test button to begin the next test. Observe the results in the Test Results area.
5 – Managing Ports Testing Ports Notes 5-16 59022-04 B
Appendix A Command Line Interface Each switch contains a Telnet server. This server allows a Telnet client to establish a Telnet session with the switch to retrieve information or to configure parameters using the Command Line Interface (CLI). The CLI enables you to perform a variety of fabric and switch management tasks through an Ethernet or a serial port connection. A.
A – Command Line Interface Command Syntax A.2 Command Syntax The command syntax is as follows: command keyword keyword [value] keyword [value1] [value2] The Command is followed by one or more keywords. Consider the following rules and conventions: A-2 ■ Commands and keywords are lowercase and case sensitive. ■ Commands with keywords require one of those keywords. ■ Required keyword values appear in standard font: [value]. Optional values are shown in italics: [value].
A – Command Line Interface Commands A.3 Commands The command set provides for User and Admin authority levels. ■ User authority grants viewing access to the fabric and switches using the Show command and other read-only commands. ■ Admin authority includes the User authority and grants permission to use the Admin command. The Admin Start command opens an admin session which provides access to the commands that change switch and fabric configurations. Refer to the ”Admin Command” on page A-4.
A – Command Line Interface Admin Command Admin Command Opens and closes an Admin session. The Admin session provides commands that change the fabric and switch configurations. Only one Admin session can be open on the switch at any time. An inactive Admin session will time out after a period of time which can be changed using the Set Setup System command. Refer to the Set Setup Command on page A-37. Authority Admin Syntax admin start end cancel Keywords start Opens the admin session.
A – Command Line Interface Alias Command Alias Command Creates a named set of ports. Aliases make it easier to assign a set of ports to many zones. An alias can not have a zone or another alias as a member.
A – Command Line Interface Alias Command members [alias] Displays all members of the alias given by [alias]. This keyword is available with User authority and does not require a zoning edit session or an admin session. remove [alias] [members] Removes the ports given by [members] from the alias given by [alias]. [members] can have one of the following formats: ■ Domain ID and port number pair (Domain ID, Port Number). Domain IDs and port numbers are in decimal. Ports are numbered beginning with 0.
A – Command Line Interface Config Command Config Command Manages the Fibre Channel configurations on a switch. For information about setting the port and switch configurations, refer to the Set Config Command on page A-25. Authority Admin for all keywords except List Syntax config activate [config] backup cancel copy [config_source] [config_destination] delete [config] edit [config] list restore save [config] Keywords activate [config] Activates the configuration given by [config].
A – Command Line Interface Config Command restore Restores configuration settings to an out-of-band switch from a backup file named configdata, which must be first uploaded on the switch using FTP. You create the backup file using the Config Backup command. Use FTP to load the backup file on a switch, then enter the Config Restore command. save [config] Saves changes made during a configuration edit session in the configuration given by [config].
A – Command Line Interface Date Command Date Command This command displays or sets the system date and time. To set the date and time the information string must be provided in this format: MMDDhhmmCCYY. You must reset the switch for the new date to take effect. Authority Admin to change the date; User to display the date. Syntax date [MMDDhhmmCCYY] Keywords [MMDDhhmmCCYY] Specifies the date – this requires an admin session.
A – Command Line Interface Fallback Command Fallback Command Loads the fallback version of the firmware from switch memory. The switch stores two versions of the firmware. This command alternately activates the two versions. Authority Admin Syntax Notes fallback Examples ■ The Show Switch command displays the available firmware versions and the currently active version. ■ After executing the Fallback command, reset the switch for the firmware to be placed in effect.
A – Command Line Interface Help Command Help Command Displays a brief description of the specified command and its keywords. Authority User Syntax Keywords help [command] [keyword] [command] A command name. If you omit this value, the system displays all available commands from which to choose. [keyword] A keyword associated with the command named by [command]. If you omit this value, the system displays the available keywords for the specified command.
A – Command Line Interface History Command History Command Displays a numbered list of the previously entered commands from which you can re-execute selected commands. Authority User Syntax Notes history Examples Use the History command to provide context for the ! command: ■ Enter ![command] to re-enter the most recent execution of that command.
A – Command Line Interface Image Command Image Command Manages and installs switch firmware. Authority Admin Syntax image cleanup fetch [account_name] [ip_address] [file_source] [file_destination] list unpack [file] Keywords cleanup Removes all firmware image files from the switch. All firmware image files are removed automatically each time the switch is reset.
A – Command Line Interface Lip Command Lip Command Reinitializes the specified loop port. Authority Admin Syntax Keywords lip [port_number] Examples The following is an example of the Lip command: [port_number] The number of the port to be reinitialized.
A – Command Line Interface Passwd Command Passwd Command Changes a user account’s password. Authority Admin to change another account’s password; User to change your own. Syntax Keywords passwd [account_name] Examples The following is an example of the Passwd command: [account_name] The user account name. You must open an admin session to change the password for an account name other than your own.
A – Command Line Interface Ps Command Ps Command Displays current system process information. Authority User Syntax Examples ps The following is an example of the Ps command: SANbox2 #> ps PID A-16 PPID %CPU TIME ELAPSED COMMAND 298 292 0.0 00:00:00 59:42 cns 299 292 0.0 00:00:00 59:42 ens 300 292 0.0 00:00:00 59:42 dlog 301 292 0.3 00:00:53 59:42 ds 302 292 0.2 00:00:29 59:42 mgmtApp 303 292 0.0 00:00:02 59:42 nserver 304 292 0.0 00:00:00 59:42 mserver 305 292 0.
A – Command Line Interface Quit Command Quit Command Closes the Telnet session.
A – Command Line Interface Reset Command Reset Command Resets the switch and port configuration parameters. Authority Admin Syntax reset config [config_name] factory port [port_number] snmp switch (default) system zoning Keywords config [config_name] Resets the configuration given by [config_name] to the factory default values for switch, port, alarm threshold, and zoning configuration. This keyword clears all zoning definitions.
A – Command Line Interface Reset Command Table A-2. Switch Configuration Defaults Parameter Default Admin State Online Broadcast Enable True InbandEnable True Domain ID 1 Domain ID Lock False Symbolic Name SANbox2 R_T_TOV 100 R_A_TOV 10000 E_D_TOV 2000 FS_TOV 5000 DS_TOV 5000 Principal Priority 254 System Description Undefined Configuration Last Saved By Initial Configuration Last Saved On Initial Table A-3.
A – Command Line Interface Reset Command Table A-3. Port Configuration Defaults (Continued) Parameter Default ExtCredit 0 FanEnable True LCFEnable False MFSEnable True MFS_TOV 10 MSEnable True NoClose False IOStreamGuard False VIEnable False CheckAlps False Table A-4.
A – Command Line Interface Reset Command Table A-4. Alarm Threshold Configuration Defaults (Continued) Parameter Default LogoutMonitoringEnabled RisingTrigger FallingTrigger SampleWindow True 5 1 10 LOSMonitoringEnabled RisingTrigger FallingTrigger SampleWindow True 100 5 10 Table A-5. SNMP Configuration Defaults Parameter 59022-04 B Default Contact Undefined Location Undefined Description Undefined Trap [1-5] Address Trap 1: 10.0.0.254; Traps 2–5: 0.0.0.
A – Command Line Interface Reset Command Table A-6. System Configuration Defaults Parameter A-22 Default Ethernet Network IP Address 10.0.0.1 Ethernet Network IP Mask 255.0.0.0 Ethernet Gateway Address 10.0.0.
A – Command Line Interface Set Command Set Command Sets a variety of switch and port parameters. Authority Admin for all keywords except Alarm Clear, Beacon, and Pagebreak which are available with User authority. Syntax set alarm clear beacon [state] config [option] log [option] pagebreak [state] port [option] setup [option] switch [state] Keywords alarm clear Clears the alarm log. This keyword is available with User authority.
A – Command Line Interface Set Command port [option] Sets port state and speed for the specified port temporarily until the next switch reset or new configuration activation. Refer to the ”Set Port Command” on page A-36. setup [option] Changes SNMP and system configuration settings. Refer to the ”Set Setup Command” on page A-37. switch [state] Temporarily changes the administrative state for all ports on the switch to the state given by [state].
A – Command Line Interface Set Config Command Set Config Command Sets switch, port, alarm threshold, and zoning configuration parameters. Authority Admin authority and a Config Edit session Syntax set config port [port_number] ports [port_number] switch threshold zoning Keywords port [port_number] Initiates an edit session in which to change configuration parameters for the port number given by [port_number].
A – Command Line Interface Set Config Command Table A-7. Set Config Port Parameters (Continued) Parameter A-26 Description ISLSecurity E_Port security. Determines which switches a port will establish a link with. ■ Any - we will link with any switch. ■ Ours - we will only link to another QLogic switch. ■ None - the port will not establish an ISL link.
A – Command Line Interface Set Config Command switch Initiates an editing session in which to change switch configuration settings. The system displays each parameter one line at a time and prompts you for a value. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets. Table A-8.
A – Command Line Interface Set Config Command Table A-8. Set Config Switch Parameters Parameter Description PrincipalPriority The priority used in the FC-SW-2 principal switch selection algorithm. 1 is high, 255 is low. ConfigDescription The name for the configuration. The default is undefined. threshold Initiates a configuration session by which to generate and log alarms for selected events.
A – Command Line Interface Set Config Command Table A-9. Set Config Threshold Parameters Parameter Description Falling Trigger The event count above which an event becomes eligible for logging in the alarm log. Sample Window The period of time in seconds in which to count events. zoning Initiates an editing session in which to change switch zoning attributes. The system displays each parameter one line at a time and prompts you for a value.
A – Command Line Interface Set Config Command AdminState (1=Online, 2=Offline, 3=Diagnostics, 4=Down) [Online] LinkSpeed (1=1Gb/s, 2=2Gb/s, 3=Auto) [Auto ] PortType (TL / GL / G / F / FL / Donor) [GL ] TLPortMode (1=TLTargetMode, 2=TLInitiatorMode) [TLInitiatorMode] ISLSecurity (Any / [Any SymPortName (string, max=32 chars) [Port2 ] ALFairness (True / False) [False ] ARB_FF (True / False) [False ] Ours / None) ] InteropCredit (decimal value, 0-255) [0 ] ExtCredit (decimal
A – Command Line Interface Set Config Command R_A_TOV (decimal value, 100-100000 msec) [10000 ] E_D_TOV (decimal value, 10-20000 msec) [2000 ] FS_TOV (decimal value, 100-100000 msec) [5000 ] DS_TOV (decimal value, 100-100000 msec) [5000 ] PrincipalPriority (decimal value, 1-255) [254 ] ConfigDescription (string, max=32 chars) [ ] The following is an example of the Set Config Threshold command: SANbox2 #> admin start SANbox2 (admin) #> config edit SANbox2 (admin-config) #> set c
A – Command Line Interface Set Config Command LOSMonitoringEnabled (True / False) [True] RisingTrigger (decimal value, 1-1000) [100 ] FallingTrigger (decimal value, 0-1000) [5 ] SampleWindow (decimal value, 1-1000 sec) [10 ] Finished configuring attributes. This configuration must be saved (see config save command) and activated (see config activate command) before it can take effect. To discard this configuration use the config cancel command.config.
A – Command Line Interface Set Log Command Set Log Command Specifies the type of entries to be entered in the event log. The log is a storage file contained on the switch. The log can hold a maximum of 200 entries. When the log becomes full, the entries are replaced, starting with the oldest entry, to produce a list of the last 200 events which occurred. Log entries are created for ports, components, and event severity levels.
A – Command Line Interface Set Log Command Other Monitors other miscellaneous events. Port Monitors all port events Switch Monitors switch management events. Zoning Monitors zoning conflict events. level [level] Specifies the severity level given by [level] to use in monitoring events for the specified components or ports. [level] can be one of the following values: Critical Monitors critical events. Warn Monitors warning events. Info Monitors informational events.
A – Command Line Interface Set Log Command start Starts the logging of events based on the Port, Component, and Level keywords assigned to the current configuration. The logging continues until you enter the Set Log Stop command. stop Stops logging of events. Notes 59022-04 B To maintain optimal switch performance, do not set the Component keyword to All and the Level keyword to Info at the same time.
A – Command Line Interface Set Port Command Set Port Command Sets port state and speed for the specified port temporarily until the next switch reset or new configuration activation. This command also clears port counters. Authority Admin Syntax set port [port_number] bypass [alpa] clear enable [alpa] speed [transmission_speed] state [state] Keywords [port_number] Specifies the port. Ports are numbered beginning with 0.
A – Command Line Interface Set Setup Command Set Setup Command Changes SNMP and system configuration settings. The switch maintains one SNMP configuration and one system configuration. Authority Admin Syntax set setup snmp system Keywords snmp Prompts you in a line-by-line fashion to change SNMP configuration settings. Table A-11 describes the SNMP fields. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets. Table A-11.
A – Command Line Interface Set Setup Command system Prompts you in a line-by-line fashion to change system configuration settings. Table A-12 describes the system configuration fields. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets. Table A-12. System Configuration Settings Entry Notes A-38 Description Eth0NetworkAddress Internet Protocol (IP) address for the Ethernet port. Eth0NetworkMask Subnet mask address for the Ethernet port.
Examples A – Command Line Interface Set Setup Command The following is an example of the Set Setup SNMP command: SANbox2 #> admin start SANbox2 (admin) #> set setup snmp A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press ’q’ or ’Q’ and the ENTER key to do so.
A – Command Line Interface Set Setup Command The following is an example of the Set Setup System command: SANbox2 (admin) #> set setup system A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press ’q’ or ’Q’ and the ENTER key to do so. Eth0NetworkAddress (dot-notated IP Address) [10.0.0.
A – Command Line Interface Show Command Show Command Displays fabric, switch, and port operational information. Authority User Syntax show about alarm broadcast chassis config [option] domains donor fabric interface log [option] lsdb mem [count] ns [option] pagebreak perf [option] port [port_number] post log setup [option] steering [domain_id] support switch topology users version Keywords about Displays an introductory set of information about operational attributes of the switch.
A – Command Line Interface Show Command domains Displays list of each domain and its worldwide name in the fabric. donor Displays list of current donor configuration for all ports. fabric Displays list of each domain, fabric ID, worldwide name, node IP address, port IP address, and symbolic name in the fabric. interface Displays the status of the active network interfaces. log [option] Displays log entries. Refer to the Show Log Command on page A-57. lsdb Displays Link State database information.
A – Command Line Interface Show Command perf [option] Displays performance information for all ports. Refer to the Show Perf Command on page A-59. port [port_number] Displays operational information for the port given by [port_number]. Ports are numbered beginning with 0. If the port number is omitted, information is displayed for all ports. Table A-13 describes the port parameters. Table A-13.
A – Command Line Interface Show Command Table A-13. Show Port Parameters (Continued) Entry A-44 Description LIPF7F7 A loop initialization primitive frame used to acquire a valid AL_PA. LIPF8F7 A loop initialization primitive frame used to indicate that a loop failure has been detected at the receiver. Link Failures Number of optical link failures detected by this port.
A – Command Line Interface Show Command Table A-13. Show Port Parameters (Continued) Entry Description TotalTxWords Total number of words issued by this port. TxLinkResets Number of Link Resets issued by this port. TxOfflineSeq Total number of Offline Sequences issued by this port. TxWait Time waiting to transmit when blocked with no credit. Measured in FC Word times. post log Displays the Power On Self Test (POST) log which contains results from the POST.
A – Command Line Interface Show Command ■ Zoneset (Active, List) ■ Zoning (History, Limits, List) switch Displays switch operational information. topology Displays all connected devices. users Displays a list of logged-in users. This is equivalent to the User List command. version Displays an introductory set of information about operational attributes of the switch. This keyword is equivalent to the About keyword.
A – Command Line Interface Show Command The following is an example of the Show Fabric command: SANbox2 #> show fabric Switch ID WWN Eth0IPAddress SymbolicName ------ -- --- ------------- ------------ 1 (0x1) fffc01 10:00:00:c0:dd:00:bd:ec 10.20.68.107 4 (0x4) fffc04 10:00:00:c0:dd:00:80:21 10.20.68.
A – Command Line Interface Show Command The following is an example of the Show Interface command: SANbox2 #> show interface eth0 Link encap:Ethernet HWaddr 00:C0:DD:00:BD:ED inet addr:10.20.68.107 Bcast:10.20.68.255 UP BROADCAST RUNNING MULTICAST MTU:1500 Mask:255.255.255.0 Metric:1 RX packets:4712 errors:0 dropped:0 overruns:0 frame:0 TX packets:3000 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:100 RX bytes:415313 (405.5 Kb) TX bytes:716751 (699.
A – Command Line Interface Show Command Class3FramesOut 0 LIP_F8_AL_PS 0 TotalRxFrames 0 Class3Toss 0 LIP_F8_F7 0 TotalRxWords 0 Class3WordsIn 0 LinkFailures 0 TotalTxFrames 0 Class3WordsOut 0 Login 0 TotalTxWords 0 DecodeErrors 0 Logout 0 TxLinkResets 0 EpConnects 0 LoopTimeouts 0 TxOfflineSeq 0 FBusy 0 LossOfSync 0 TxWaits 0 The following is an example of the Show Setup SNMP command: SANbox2 #> show setup snmp SNMP Information ---------------- 59022-04 B Cont
A – Command Line Interface Show Command The following is an example of the Show Setup System command: SANbox2 (admin) #> show setup system System Information ------------------ A-50 Eth0NetworkAddress 10.20.11.112 Eth0NetworkMask 255.255.252.0 Eth0GatewayAddress 10.20.8.254 Eth0NetworkDiscovery Static AdminTimeout 30 SecurityEnabled True LocalLogEnabled True RemoteLogEnabled True RemoteLogHostAddress 10.20.11.
A – Command Line Interface Show Command The following is an example of the Show Switch command: SANbox2 #> show switch Switch Information -----------------SymbolicName SANbox2-203 SwitchWWN 10:00:00:c0:dd:00:b8:b5 SwitchType SANbox2-16 PromVersion V0.1-5-18 CreditPool 0 DomainID 3 LogLevel Info MaxPorts 16 NumberOfAsics 1 NumberOfPortsPerAsic 16 NumberOfResets 127 ReasonForLastReset NormalReset SWImageVersion (1) - build date V0.
A – Command Line Interface Show Command The following is an example of the Show Topology command for port 1: SANbox2 #> show topology 1 Local Link Information ---------------------PortNumber 1 PortID 650100 PortWWN 20:01:00:c0:dd:00:91:11 PortType F Remote Link Information ----------------------Device 0 NodeWWN 50:80:02:00:00:06:d5:38 PortType NL Description (NULL) IPAddress 0.0.0.0 Device 1 NodeWWN 20:00:00:20:37:2b:08:c9 PortType NL Description (NULL) IPAddress 0.0.0.
A – Command Line Interface Show Command The following is an example of the Show Version command: SANbox2 #> show version SystemDescription QLogic SANbox2 FC Switch Eth0NetworkAddress 10.0.0.1 (use ’set setup system’ to update) 59022-04 B FCNetworkAddress 0.0.0.0 (use ’set setup system’ to update) MACAddress 12:34:56:78:ab:cd WorldWideName 10:00:00:c0:dd:00:90:a4 SymbolicName SANbox2 SWImageVersion V255.
A – Command Line Interface Show Config Command Show Config Command Displays switch, port, alarm threshold, and zoning attributes for the current configuration. Authority User Syntax show config port [port_number] switch threshold zoning Keywords port [port_number] Displays configuration parameters for the port number given by [port_number]. Ports are numbered beginning with 0. If the port value is omitted, all ports are specified. switch Displays configuration parameters for the switch.
A – Command Line Interface Show Config Command NoClose False IOStreamGuard False VIEnable False CheckAlps False The following is an example of the Show Config Switch command: SANbox2 #> show config switch Configuration Name: default ------------------- Switch Configuration Information -------------------------------AdminState Online BroadcastEnabled True InbandEnabled True DomainID 100 (0x64) DomainIDLock False SymbolicName SANbox2-16 N_11.
A – Command Line Interface Show Config Command FallingTrigger 0 SampleWindow 10 ISLMonitoringEnabled True RisingTrigger 2 FallingTrigger 0 SampleWindow 10 LoginMonitoringEnabled True RisingTrigger 5 FallingTrigger 1 SampleWindow 10 LogoutMonitoringEnabled True RisingTrigger 5 FallingTrigger 1 SampleWindow 10 LOSMonitoringEnabled True RisingTrigger 100 FallingTrigger 5 SampleWindow 10 The following is an example of the Show Config Zoning command: SANbox2 #> show config
A – Command Line Interface Show Log Command Show Log Command Displays the contents of the log or the parameters used to create entries in the log. The log contains a maximum of 200 entries. When the log reaches its entry capacity, subsequent entries overwrite the existing entries, beginning with the oldest. Authority User Syntax show log component level options port settings Keywords component Displays the components currently being monitored for events.
A – Command Line Interface Show Log Command The following is an example of the Show Log Options command: SANbox2 #> show log options Allowed options for ’ level’: Critical,Warn,Info,None Allowed options for ’component’: All,None,NameServer,MgmtServer,Zoning,Switch, Chassis,Blade,Port,Eport,Snmp,Other The following is an example of the Show Log Port command: SANbox2 #> show log port Current setting(s) for log port: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 The following is an example of the Show Log co
A – Command Line Interface Show Perf Command Show Perf Command Displays port performance in frames/second and bytes/second. If you omit the keyword, the command displays data transmitted (out), data received (in), and total data transmitted and received in frames/second and bytes per second. Authority User Syntax show perf byte inbyte outbyte frame inframe outframe errors Keywords byte Displays continuous performance data in total bytes/second transmitted and received for all ports.
A – Command Line Interface Show Perf Command Examples The following is an example of the Show Perf command: SANbox2 #> show perf Port Bytes/s Number Bytes/s (in) Bytes/s Frames/s Frames/s Frames/s (out) (total) (in) (out) (total) ------ ------- ------- ------- -------- -------- -------- 0 0 0 0 0 0 0 1 0 0 0 0 0 0 2 0 0 0 0 0 0 3 0 0 0 0 0 0 4 0 0 0 0 0 0 5 0 0 0 0 0 0 6 0 0 0 0 0 0 7 0 0 0 0 0 0 8 7K 136M 136M 245 68K 68
A – Command Line Interface Show Setup Command Show Setup Command Displays the current SNMP and system settings. Authority User Syntax show setup mfg snmp system Keywords mfg Displays manufacturing information about the switch. snmp Displays the current SNMP settings. system Displays the current system settings.
A – Command Line Interface Show Setup Command The following is an example of the Show Setup Snmp command: SANbox2 #> show setup snmp SNMP Information ---------------- A-62 Contact Location N_107 System Test Lab Description QLogic SANbox2 FC Switch Trap1Address 10.0.0.254 Trap1Port 162 Trap1Severity warning Trap1Enabled False Trap2Address 0.0.0.0 Trap2Port 162 Trap2Severity warning Trap2Enabled False Trap3Address 0.0.0.
A – Command Line Interface Show Setup Command The following is an example of the Show Setup System command: SANbox2 #> show setup system System Information ------------------ 59022-04 B Eth0NetworkAddress 10.0.0.1 Eth0NetworkMask 255.255.255.0 Eth0GatewayAddress 10.0.0.254 Eth0NetworkDiscovery Static AdminTimeout 30 SecurityEnabled False LocalLogEnabled True RemoteLogEnabled False RemoteLogHostAddress 10.0.0.
A – Command Line Interface Shutdown Command Shutdown Command Terminates all data transfers on the switch at convenient points and closes the Telnet session. Always power cycle the switch after entering this command. Authority Admin Syntax Notes shutdown A-64 Always use this command to effect an orderly shut down before removing power from the switch. Failure to do so could corrupt the flash memory and the switch configuration.
A – Command Line Interface Test Command Test Command Tests ports using internal (SerDes level), external (SFP), and online loopback tests. Internal and external tests require that the port be placed in diagnostic mode. Refer to the ”Set Command” on page A-23 for information about changing the port administrative state. While the test is running, the remaining ports on the switch remain fully operational.
A – Command Line Interface Test Command ■ To run an external loopback test, enter the following: test x external 5. A series of test parameters are displayed on the screen. Press the Enter key to accept each default parameter value, or type a new value for each parameter and press the Enter key.
A – Command Line Interface Test Command process before reaching the end of the list press ’q’ or ’Q’ and the ENTER key to do so. TestLength (decimal value, 1-4294967295) [100 ] FrameSize (decimal value, 36-2148) [256 ] DataPattern (32-bit hex value or ’Default’) [Default] StopOnError (True/False) [False ] Do you want to start the test? (y/n) [n] 4. 59022-04 B After all parameter values are defined, press the Y key to start the test.
A – Command Line Interface Uptime Command Uptime Command Displays the elapsed time since the switch was last reset and reset method.
A – Command Line Interface User Command User Command Administers or displays user accounts. Authority Admin. The List keyword is available with User authority. Syntax user accounts add delete [account_name] list Keywords accounts Displays all user accounts that exist on the switch. add Add a user account to the switch. After this command is executed, the administrator will be prompted for the information needed to establish the user account. A switch can have a maximum of 15 user accounts.
A – Command Line Interface User Command The following is an example of the User Add command: SANbox2 (admin) #> user add Press ’q’ and the ENTER key to abort this command.
A – Command Line Interface Whoami Command Whoami Command Displays the account name, session number, and switch domain ID for the Telnet session.
A – Command Line Interface Zone Command Zone Command Manages zones and zone membership on a switch. The Zone command defines members (ports and devices) for a single switch. Zones are members of zone sets. Authority Admin authority and a Zoning Edit session. Refer to the Zoning Command on page A-79 for information about starting a Zoning Edit session. The List, Members, and Zonesets keywords are available with User authority and do not require a Zoning Edit session.
A – Command Line Interface Zone Command delete [zone] Deletes the specified zone given by [zone] from the zoning database. If the zone is a member of the active zone set, the zone will not be removed from the active zone set until the active zone set is deactivated. list Displays a list of all zones and the zone sets of which they are members. This keyword is valid for User authority and does not require a zoning edit session. members [zone] Displays all members of the zone given by [zone].
A – Command Line Interface Zone Command Examples The following is an example of the Zone List command: SANbox2 #> zone list Zone ZoneSet ------------------wwn_b0241f zone_set_1 wwn_23bd31 zone_set_1 wwn_221416 zone_set_1 wwn_2215c3 zone_set_1 wwn_0160ed zone_set_1 wwn_c001b0 zone_set_1 wwn_401248 zone_set_1 wwn_02402f zone_set_1 wwn_22412f zone_set_1 The following is an example of the Zone Members command: SANbox2 #> zone members wwn_b0241f Current List of Members for Zone: wwn_b0241f ----
A – Command Line Interface Zone Command The following is an example of the Zone Zonesets command: SANbox2 #> zone zonesets zone1 Current List of ZoneSets for Zone: wwn_b0241f ---------------------------------zone_set_1 59022-04 B A-75
A – Command Line Interface Zoneset Command Zoneset Command Manages zone sets and zone set membership across the fabric. Authority Admin authority and a Zoning Edit session. Refer to the Zoning Command on page A-79 for information about starting a Zoning Edit session. The Active, List, and Zones keywords are available with User authority. You must close the Zoning Edit session before using the Activate and Deactivate keywords.
A – Command Line Interface Zoneset Command delete [zone_set] Deletes the zone set given by [zone_set]. If the specified zone set is active, the command is suspended until the zone set is deactivated. This keyword requires a Zoning Edit session. list Displays a list of all zone sets. This keyword is available with User authority and does not require a Zoning Edit session. remove [zone_set] [zone_list] Removes a list of zones and aliases given by [zone_list] from the zone set given by [zone_set].
A – Command Line Interface Zoneset Command The following is an example of the Zoneset Zones command: SANbox2 #> zoneset zones ssss Current List of Zones for ZoneSet: ssss ---------------------------------zone1 zone2 zone3 A-78 59022-04 B
A – Command Line Interface Zoning Command Zoning Command Opens a Zoning Edit session in which to create and manage zone sets and zones. Refer to the Zone Command on page A-72 and the Zoneset Command on page A-76. Authority Admin. The List keyword is available with User authority. Syntax zoning active cancel clear edit history limits list restore save Keywords active Displays membership information for the active zone set including member zones and zone members.
A – Command Line Interface Zoning Command list Lists all fabric zoning definitions. This keyword is available with User authority. restore Reverts the changes to the zoning database that have been made during the current Zoning Edit session since the last Zoning Save command was entered. save Saves changes made during the current Zoning Edit session. The system will inform you that the zone set must be activated to implement any changes.
A – Command Line Interface Zoning Command 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 10:00:00:00:c9:22:14:16 wwn_2215c3 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 10:00:00:00:c9:22:15:c3 Configured Zoning Information ZoneSet Zone ZoneMember -------------------------------wwn wwn_b0241f 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 21:00:00:e0:8b:02:41:2f wwn_23bd31 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 10:00:00:00:c9:23:bd:31 wwn_221416 50:06:04:82:bf:d2:18:c2 50:06:04:82:b
A – Command Line Interface Zoning Command Notes A-82 59022-04 B
Appendix B Graphing Port Performance SANsurfer Fabric View is an optional application that displays port performance using graphs. SANsurfer Fabric View plots data communication rates and total errors for selected ports as shown in Figure B-1. When graphing data communication rates, you can choose either frames/second or KB/second. Figure B-1.
B – Graphing Port Performance Displaying Graphs B.2 Displaying Graphs To display graphs, do the following: 1. Open the Fabric menu and select Add Fabric or click the Add button. Enter a fabric name and an IP address in the Add a New Fabric window. Include a login name and a password if required. 2. Set the graphing options and polling frequency. By default, SANsurfer Fabric View plots total bytes transmitted and received at a polling frequency of once per second.
B – Graphing Port Performance Displaying Graphs B.2.2 Customizing Graphs You can customize the graph polling frequency, what is plotted in the graphs, and the graph color scheme. To set the polling frequency for all graphs, open the Graph menu and select Set Polling Frequency.... Enter an interval in seconds (0–60) in the dialog box and choose the OK button. To choose what is to be plotted, open the Graph menu and select Options.... This opens the Modify Graph Display shown in Figure B-2. Figure B-2.
B – Graphing Port Performance Displaying Graphs 2. Choose what data type to plot. For example, if you selected Show Frames Data on Graph in step 1, you can plot one or all of the following: ■ Total frames transmitted and received (Total Frames) ■ Total frames transmitted (Total Tx Frames) ■ Total frames received (Total Rx Frames) In addition to these, you can also plot total errors by selecting the Total Errors check box. 3. Display or hide the unit grid.
Glossary Activity LED A port LED that indicates when frames are entering or leaving the port. Alias A collection of objects that can be zoned together. An alias is not a zone, and can not have a zone or another alias as a member. ALFairness On an arbitrated loop, the switch is always highest priority when arbitrating for the right to transfer.
Expansion Port See E_Port. ExtCredit Allows full speed operation over distances greater than 10 kilometers. Additional credit buffers are borrowed from other ports (which must be set to donor state). Decimal value 0-65535 Fabric Management Switch The switch through which the fabric is managed. Fabric Name User defined name associated with the file that contains user list data for the fabric. Fan Fail LED An LED that indicates that a cooling fan in the switch is operating below standard.
SANbox2-8c/16 Switch Management User’s Guide Logged-In LED A port LED that indicates device login or loop initialization status. Over Temperature LED A chassis LED or a power supply LED that indicates that the switch or power supply is overheating. Management Information Base A set of guidelines and definitions for the Fibre Channel functions. POST Power On Self Test Management Workstation PC workstation that manages the fabric through the fabric management switch.
SANbox2-8c/16 Switch Management User’s Guide SNMP Simple Network Management Protocol Target A storage device that responds to an initiator device. VCCI Voluntary Control Council for Interference VIEnable FC-VI. When enabled, VI preference frames will be transmitted ahead of other frames. (True / False) Worldwide Name (WWN) A unique 64-bit address assigned to a device by the device manufacturer. WWN Worldwide Name Zone A set of ports or devices grouped together to control the exchange of information.
Index A access control list zone 3-10, 3-22, A-73 account name 3-2, 4-21, A-71 active zone set 3-8 Active Zoneset data window 3-8 Admin authority A-3 Admin command A-4 administrative state configured 4-12, 5-9 current 4-12, 5-9 port A-36 switch 4-12, A-24 alarm configuration 4-8, A-28, A-54 alarm log clear A-23 display A-41 export 4-10 Alarm Log data window 4-8 alias add members 3-24, A-5 copy A-5 create 3-23, A-5 definition 3-11 delete A-5 delete member A-6 display list A-5 display members A-6 remove 3-24
SANbox2-8c/16 Switch Management User’s Guide zoning 3-15 date 4-10 Date command A-9 decode error monitoring 4-9 default configuration 4-21 visibility 3-12, 3-13 domain ID conflict 3-11 lock 4-12 domains A-42 donor port 5-2, 5-10, 5-12, A-42 Dynamic Host Configuration Protocol 4-16 E E_Port isolation 3-14, 4-13 self-discovery 5-10 Error Detect Timeout 4-14 event logging by component A-33, A-57 by port A-34, A-57 by severity level A-34, A-57 restore A-34 settings A-34, A-57 start A-35 stop A-35 expansion
SANbox2-8c/16 Switch Management User’s Guide Image command A-13 inband management 4-13 Input Power LED 4-3 internal port test 5-13, A-65 IP address 4-16 configuration 4-16 ISL monitoring 4-9 L link delete 3-5 selecting 2-16 status 2-15 Link data window 4-6 link state database A-42 Lip command A-14 log archive A-33 clear A-33 file A-33 power-on self test A-45 logged in users A-46 Logged-In LED 4-12 login limit 2-6, 3-2, A-1 monitoring 4-9 logout monitoring 4-9 loop port A-14 fabric 5-10 generic 5-2, 5-1
SANbox2-8c/16 Switch Management User’s Guide operational information A-43 operational state 5-3 performance A-59, B-1 recipient 5-12 reset 5-13 selecting 2-19 speed 5-3, 5-9, A-36 status 2-18, 5-2 testing 5-13 view 2-8, 2-18 Port Information data window 4-6, 5-7 Port Statistics data window 4-6, 5-4 port/device tree 3-15 power-on self test log A-45 preferences 2-8 private device 5-11 Ps command A-16 Q Quit command A-17 R read community 4-17 receive buffer 5-11 Receiver Transmitter Timeout 4-14 recipien
SANbox2-8c/16 Switch Management User’s Guide status 2-15 Switch data window 4-4 syslog 4-17 system configuration A-38, A-61 process A-16 reset A-18 settings A-61 T Telnet session A-71 Test command A-65 time 4-10 timeout values 4-14 TL mode 5-11 TL_Port 5-10 tool bar standard 2-12 zoning 3-16 topology display 2-10, 2-15 transceiver status 5-4 translated loop port 5-2, 5-10 trap authentication 4-17 community 4-17 configuration 4-18 U Uptime command A-68 user account 3-1, A-1 logged in A-46 User authorit
SANbox2-8c/16 Switch Management User’s Guide zoning configuration 3-12, A-29, A-54 database 3-11, 3-15 edit A-79 history A-79 limits A-79 list definitions A-80 reset A-18 restore default 3-13 revert changes A-80 save edits A-80 Zoning command A-79 Index-6 59022-04 B