0 Simplify SANbox 5200 Series Switch Management User’s Guide Firmware Version 4.
SANbox 5200 Series Switch Management User’s Guide 0 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.4 1.4.1 1.4.2 1.4.3 Intended Audience ............................................................................................. 1-1 Related Materials ............................................................................................... 1-1 JDOM License.................................................................................................... 1-2 Technical Support..................................................................
SANbox 5200 Series Switch Management User’s Guide 0 2.10.6 2.11 2.11.1 2.11.2 2.11.2.1 2.11.2.2 2.11.2.3 2.11.3 2.12 2.12.1 2.12.2 2.12.2.1 2.12.2.2 2.12.3 Working Status Indicator.......................................................................... 2-25 Using the Topology Display .............................................................................. 2-26 Switch and Link Status ............................................................................ 2-26 Working with Switches and Links .
0 3.4.3 3.4.4 3.4.5 3.5 3.5.1 3.5.2 3.5.3 3.5.3.1 3.5.3.2 3.5.3.3 3.5.3.4 3.5.3.5 3.6 3.6.1 3.6.1.1 3.6.1.2 3.6.1.3 3.6.1.4 3.6.2 3.6.3 3.6.3.1 3.6.3.2 3.6.3.3 3.6.3.4 3.6.3.5 3.6.3.6 3.6.4 3.6.4.1 3.6.4.2 3.6.4.3 3.6.4.4 3.6.4.5 3.6.5 3.6.5.1 3.6.5.2 3.6.5.3 3.6.5.4 3.6.5.5 3.6.5.6 59056-02 A SANbox 5200 Series Switch Management User’s Guide Devices Data Window ............................................................................. 3-15 Active Zone Set Data Window..................................
SANbox 5200 Series Switch Management User’s Guide 3.6.5.7 3.6.6 3.6.6.1 3.6.6.2 3.6.6.3 3.6.7 3.6.7.1 3.6.7.2 0 Changing Zone Types .................................................................... 3-37 Managing Aliases .................................................................................... 3-37 Creating an Alias ............................................................................ 3-37 Adding a Member to an Alias .........................................................
0 SANbox 5200 Series Switch Management User’s Guide 4.7.3.3 4.7.4 4.7.4.1 4.7.4.2 4.8 4.9 4.10 4.11 4.12 4.13 4.14 NTP Client ...................................................................................... 4-25 SNMP Properties..................................................................................... 4-26 SNMP Configuration ....................................................................... 4-27 SNMP Trap Configuration...............................................................
SANbox 5200 Series Switch Management User’s Guide 5.6.7.2 5.6.7.3 5.6.8 5.6.9 0 Customizing Graphs ....................................................................... 5-23 Rescaling a Selected Graph ........................................................... 5-25 Printing Graphs........................................................................................ 5-25 Saving Graph Statistics to a File..............................................................
0 SANbox 5200 Series Switch Management User’s Guide Shutdown Command ...............................................................................A-89 Test Command ........................................................................................A-90 Uptime Command....................................................................................A-93 User Command .......................................................................................A-94 Whoami Command.............................
SANbox 5200 Series Switch Management User’s Guide 4-11 4-12 4-13 4-14 4-15 5-1 5-2 5-3 5-4 5-5 5-6 5-7 5-8 5-9 Page x 0 SNMP Properties Dialog .............................................................................................. 4-26 Restore Dialogs – Full and Selective ........................................................................... 4-30 Features License Key Dialog ....................................................................................... 4-34 Add License Key Dialog ...
0 SANbox 5200 Series Switch Management User’s Guide Tables Table 2-1 2-2 2-3 3-1 3-2 3-3 3-4 4-1 4-2 4-3 4-4 4-5 4-6 4-7 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 A-14 A-15 A-16 A-17 Page Topology Display Menu Shortcut Keys ........................................................................ 2-20 Faceplate Display Shortcut Keys ................................................................................. 2-21 Tool Bar Buttons .............
SANbox 5200 Series Switch Management User’s Guide 0 Notes Page xii 59056-02 A
Section 1 Introduction This manual describes the switch management tools which include the SANsurfer Switch Manager application (version 4.02) and the Command Line Interface (CLI) for the SANbox 5200 Series Fibre Channel switches (firmware version 4.2). This includes the model 5200 switch and the model 5202 switch with dual replaceable power supplies. The SANbox 5200 Series switches are 20 port non-blocking Fibre Channel switches.
0 1 – Introduction JDOM License 1.3 JDOM License This product includes software developed by the JDOM Project (http://www.jdom.org/). Copyright (C) 2000-2002 Brett McLaughlin & Jason Hunter. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions, and the following disclaimer. 2.
0 1 – Introduction Technical Support 1.4 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 support Web site listed in Contact Information for the latest firmware and software updates. 1.4.
1 – Introduction Technical Support 0 Notes 1-4 59056-02 A
Section 2 Using SANsurfer Switch Manager This section describes how to use the SANsurfer Switch Manager application and its menus.
0 2 – Using SANsurfer Switch Manager Installing the Management Application 2.1.1 SANsurfer Switch Manager You can install SANsurfer Switch Manager on a Windows, Linux, or Solaris workstation. To install SANsurfer Switch Manager from the SANsurfer Switch Manager disk, close all programs currently running, and insert the SANsurfer Switch Manager Installation Disk into the management workstation CD-ROM drive. For a Windows workstation: 1.
0 2 – Using SANsurfer Switch Manager Installing the Management Application 3. Add the package and follow the SANsurfer Switch Manager installation instructions. Enter the following command: pkgadd -d sol_pkg 2.1.2 SANsurfer Management Suite The following instructions describe how to install SANsurfer Management Suite and upgrade SANsurfer Switch Manager. You can install SANsurfer Management Suite (SMS) on a Windows, Linux, or Solaris workstation.
0 2 – Using SANsurfer Switch Manager Installing the Management Application 7. When the installation is complete, start SANsurfer Management Suite using the SANsurfer file from the SANsurfer Management Suite installation directory. You can also start SANsurfer Management Suite by clicking the SANsurfer icon (if installed) on the desktop or from the Start menu. In SMS, Click the Switch tab in the left pane. From the Help menu, select About ... and make note of the version number.
0 2 – Using SANsurfer Switch Manager Installing the Management Application 2.1.2.2 SMS Installation for Linux Close all programs currently running, and insert the SANsurfer Management Suite Installation Disk into the management workstation CD-ROM drive. 1. If a file browser dialog opens showing icons for the contents of the CD-ROM, double-click the Start_Here.htm file to open the SANsurfer Management Suite start page. If a file browser does not open, double-click the CD-ROM icon to open the browser.
0 2 – Using SANsurfer Switch Manager Installing the Management Application 10. 11. To ensure that you are using the most recent version of SANsurfer Switch Manager, visit the QLogic support web page and go to Drivers, Software and Manuals. a. Select your switch model from the pull-down menu. Locate the description for SANsurfer Switch Manager for Linux under "Management Software". b. If the release version number (4.02.
0 2 – Using SANsurfer Switch Manager Installing the Management Application 3. On the SANbox Switch Software page, scroll to the SANbox 5200 Series Series area. 4. In the Operating System column, click the Solaris SPARC link. 5. Click the SANsurfer Management Software link to open the Save As dialog. 6. Enter a path name to save the sansurfer_solaris_install.bin file and click the Save button. 7. Open a terminal window for the directory in which the sansurfer_solaris_install.
0 2 – Using SANsurfer Switch Manager Starting SANsurfer Switch Manager 15. When prompted for the SMS installation directory, enter d if SMS was installed in it’s default directory (/opt/QLogic_Corporation/SANsurfer). Otherwise, enter the path name for the SMS installation directory. The script will copy the necessary files to the specified installation directory. 16. Restart SANsurfer Switch Manager from SANsurfer Management suite as you did in step 9 and confirm that the new version is running. 2.
0 2 – Using SANsurfer Switch Manager Starting SANsurfer Switch Manager To start SANsurfer Switch Manager from SANsurfer Management Suite, do the following. 1. Start the SANsurfer Management Suite application using one of the following methods: For Windows, double-click the SANsurfer shortcut, or select SANsurfer from Start menu, depending on how you installed the SANsurfer application. From a command line, enter the following command: \SANsurfer.
2 – Using SANsurfer Switch Manager Exiting SANsurfer Switch Manager 0 Click the Open Existing Fabric radio button to open the Add a New Fabric dialog, which prompts you for a fabric name, IP address, account name, and password. Refer to ”Adding a Fabric” on page 3-5. Click the Open Existing Fabric View File radio button to open the Open View dialog which prompts you to specify a fabric view file that you saved earlier. Refer to ”Opening a Fabric View File” on page 3-6.
0 2 – Using SANsurfer Switch Manager Exiting SANsurfer Switch Manager Figure 2-3. Save Default Fabric View File Dialog The encryption key is used to encrypt the sensitive data in the default fabric view file. Refer to ”Changing the Encryption Key for the Default Fabric View File” on page 2-13 for information about changing this encryption key.
2 – Using SANsurfer Switch Manager Uninstalling SANsurfer Switch Manager 0 2.4 Uninstalling SANsurfer Switch Manager The method you use to uninstall SANsurfer Switch Manager depends on how you installed it: If you installed SANsurfer Switch Manager as part of SANsurfer Management Suite, you must uninstall SANsurfer Management Suite. Refer to ”SMS Uninstall” on page 2-12. If you installed SANsurfer Switch Manager as a standalone program, you must uninstall SANsurfer Switch Manager directly.
0 2 – Using SANsurfer Switch Manager Changing the Encryption Key for the Default Fabric View File 2.4.2 Standalone Uninstall A program to uninstall SANsurfer Switch Manager was included as part of the SANsurfer Switch Manager installation process. Use this method only if you installed SANsurfer Switch Manager as a standalone program. The UninstallerData folder in the Install directory contains the uninstall program, Uninstall Switch_Manager.
0 2 – Using SANsurfer Switch Manager Saving and Opening Fabric View Files 2.6 Saving and Opening Fabric View Files A fabric view file is one or more fabrics saved to a file. In addition to the SANsurfer Switch Manager default fabric view file, you can save and open your own fabric view files. To save a set of fabrics to a file, do the following: 1. Open the File menu and select Save View As to open the Save View dialog. 2.
0 2 – Using SANsurfer Switch Manager Setting SANsurfer Switch Manager Preferences Enable (default) or disable the Event Browser. Refer to ”Displaying the Event Browser” on page 3-11. If the Event Browser is enabled using the Preferences dialog as shown in Figure 2-5, the next time SANsurfer Switch Manager is started, all events will be displayed.
2 – Using SANsurfer Switch Manager Using Online Help 0 2.8 Using Online Help Online help is available for the SANsurfer Switch Manager application and its functions. The two ways to open the online help file are: open the Help menu and select Help Topics, or click the Help button in the tool bar. You can also display context-sensitive help for all SANsurfer Switch Manager dialogs by choosing the Help button in the dialog. 2.
0 2 – Using SANsurfer Switch Manager SANsurfer Switch Manager User Interface 2.10 SANsurfer Switch Manager User Interface The SANsurfer Switch 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.
2 – Using SANsurfer Switch Manager SANsurfer Switch Manager User Interface 0 2.10.1 Menu Bars The menus and the options offered in them vary depending on the display. For example, the Port menu and many of the Switch menu selections are available only in the faceplate display. 2.10.1.1 Topology Display Menu The menu options available in the topology display are shown in Figure 2-7. Figure 2-7.
0 2 – Using SANsurfer Switch Manager SANsurfer Switch Manager User Interface 2.10.1.2 Faceplate Display Menu The menu options available in the faceplate display are shown in Figure 2-8. Figure 2-8. Faceplate Display Menu The keyboard shortcut keys vary by display type: topology display and faceplate display. In addition to the menu bar, both the topology and faceplate displays have context sensitive menus that pop up when you right-click in the graphic window.
0 2 – Using SANsurfer Switch Manager SANsurfer Switch Manager User Interface 2.10.1.3 Topology Display Shortcut Keys The shortcut keys for the topology display are shown in Table 2-1. The shortcut key combinations are not case-sensitive. Table 2-1.
0 2 – Using SANsurfer Switch Manager SANsurfer Switch Manager User Interface 2.10.1.4 Faceplate Display Shortcut Keys The shortcut keys for the faceplate display are shown in Table 2-2. The shortcut key combinations are not case-sensitive. Table 2-2.
0 2 – Using SANsurfer Switch Manager SANsurfer Switch Manager User Interface Table 2-2.
0 2 – Using SANsurfer Switch Manager SANsurfer Switch Manager User Interface 2.10.2 Tool Bar The tool bar consists of a row of graphical buttons that you can use to access SANsurfer Switch Manager functions as shown in Table 2-3. The tool bar buttons are an alternative method to using the menu bar. The tool bar can be relocated in the display by clicking and dragging the handle at the left edge of the tool bar. Table 2-3.
0 2 – Using SANsurfer Switch Manager SANsurfer Switch Manager User Interface 2.10.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 or collapsed. Click this handle or double-click the entry to expand or collapse a fabric tree entry.
0 2 – Using SANsurfer Switch Manager SANsurfer Switch Manager User Interface The fabric tree provides access to the topology and faceplate displays for any fabric or switch. To open the topology display from the fabric tree, click a fabric entry. To open the faceplate display from the fabric tree, click a switch entry. 2.10.4 Graphic Window The graphic window, as shown in Figure 2-6, presents graphic information about fabrics and switches such as the fabric topology and the switch faceplate.
2 – Using SANsurfer Switch Manager Using the Topology Display 0 2.11 Using the Topology Display The topology display shown in Figure 2-10 receives information from the selected fabric and displays its topology. Switches and inter-switch links (ISLs) 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.11.
0 2 – Using SANsurfer Switch Manager Using the Topology Display 2.11.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. Context-sensitive popup menus are displayed when you right-click on a switch or link icon, or in the background of the topology display graphic window. 2.11.2.
0 2 – Using SANsurfer Switch Manager Using the Topology Display 2.11.2.3 Opening the Faceplate Display and Topology Popup Menus The faceplate display shows the front of a single switch and its ports. To open the faceplate display when viewing the topology display, click the switch entry/icon in the fabric tree, or double-click the switch graphic. The topology display also offers a fabric, switch, and a link popup menu: To open the fabric popup menu, right-click the graphic window background.
0 2 – Using SANsurfer Switch Manager Using the Faceplate Display 2.12 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.
0 2 – Using SANsurfer Switch Manager Using the Faceplate Display 2.12.1 Port Views and Status Port color and text provide information about the port and its operational state. Green indicates active; gray indicates inactive. The faceplate display provides the following views of port status corresponding to the View menu options in the faceplate display. Refer to ”Monitoring Port Status” on page 5-2 for more information about these displays.
0 2 – Using SANsurfer Switch Manager Using the Faceplate Display 2.12.2.2 Opening the Faceplate Popup Menu To open the popup menu, right-click on the faceplate image to present the following tasks.
2 – Using SANsurfer Switch Manager Using the Faceplate Display 0 Notes 2-32 59056-02 A
Section 3 Managing Fabrics This section describes the following tasks that manage fabrics: Fabric Security Fabric Tracker Managing the Fabric Database Working with Device Information and Nicknames Displaying Fabric Information Zoning a Fabric 3.1 Fabric Security The components of Fibre Channel fabric security are: User account security Fabric services 3.1.
0 3 – Managing Fabrics Fabric Security 3.1.2 Fabric Services Fabric services security includes SNMP and In-band management. Simple Network Management Protocol (SNMP) is the protocol governing network management and monitoring of network devices. SNMP security consists of a read community string and a write community string, that are basically the passwords that control read and write access to the switch.
0 3 – Managing Fabrics Fabric Tracker 3.2 Fabric Tracker The Fabric Tracker option enables you to generate a snapshot or baseline of current system version information, which can be viewed, analyzed and compared to other snapshot files, and exported to a file. Information includes date and time, SANsurfer Switch Manager version, switch active firmware version, device hardware, drivers, and firmware version from FDMI.
3 – Managing Fabrics Managing the Fabric Database 0 3.2.3 Exporting Version Snapshots to a File The Reports tab page enables you to select one of several reports to save to a text file. The are two types of reports. The Summary report type shows the same format displayed on the Summary tab page without the color highlighting. The Detail report type shows a detailed breakdown of the differences. Use the Export button to save the selected report to a text file. Figure 3-1.
0 3 – Managing Fabrics Managing the Fabric Database 3.3.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 dialog as shown in Figure 3-2. Figure 3-2. Add a New Fabric Dialog 2. Enter a fabric name (optional) and the IP address of the switch through which to manage the fabric. 3. Enter an account name and password. The factory account name and password are "admin" and "password".
3 – Managing Fabrics Managing the Fabric Database 0 3.3.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.3.3 Opening a Fabric View File A fabric view file is one or more fabrics saved to a file. To open an existing view file, do the following: 1. Open the File menu and select Open View File, or click the Open button.
0 3 – Managing Fabrics Managing the Fabric Database 3.3.6 Deleting Switches and Links The SANsurfer Switch Manager application does not automatically delete switches or links that have failed or have been physically removed from the fabric. In these cases, you can delete switches and links to bring the display up to date. If you delete a switch or a link that is still active, the SANsurfer Switch Manager application will restore it automatically. You can also refresh the display.
0 3 – Managing Fabrics Managing the Fabric Database 5. Configure the port types for the new switch using the Port Properties dialog. The 1-Gbps/2-Gbps ports can be G_Port, GL_Port, F_Port, FL_Port, or Donor. The 10-Gbps ports can be a G_Port or F_Port. 6. Connect the devices to the switch. 7. Make any necessary zoning changes using the Edit Zoning dialog. To open the Edit Zoning dialog, open the Zoning menu, and select Edit Zoning.
0 3 – Managing Fabrics Displaying Fabric Information 4. Restore the configuration from the failed switch to the replacement switch: a. Open a new fabric through the replacement switch. b. Open the faceplate display for the replacement switch. Open the Switch menu and select Restore. c. In the Restore dialog, enter the archive file from the failed switch or browse for the file. d. Click the Restore button. 5.
0 3 – Managing Fabrics Displaying Fabric Information 3.4.1 Fabric Status 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 display status, or you can refresh the display at any time. To refresh the topology display, do one of the following: Click the Refresh button. Open the View menu and select Refresh. Press the F5 key.
0 3 – Managing Fabrics Displaying Fabric Information 3.4.2 Displaying the Event Browser The Event Browser displays a list of events generated by the switches in the fabric and the SANsurfer Switch Manager application. Events that are generated by the SANsurfer Switch Manager application are not saved on the switch, but can be saved to a file during the SANsurfer Switch Manager session. Entries in the Event Browser shown in Figure 3-3, are formatted by severity, time stamp, source, type, and description.
0 3 – Managing Fabrics Displaying Fabric Information Severity is indicated in the severity column using icons as described in Table 3-2. Table 3-2. Severity Levels Severity Icon Description Alarm – An Alarm is any event that’s a "serviceable event". This means that attention by the user or field service is required. Alarms are events that get posted asynchronously to the screen. Alarms cannot be turned off.
0 3 – Managing Fabrics Displaying Fabric Information 3.4.2.1 Filtering the Event Browser Filtering the Event Browser enables you to display only those events that are of interest based on the event severity, timestamp, source, type, and description. To filter the Event Browser, open the Filter menu and select Filter Entries. This opens the Filter Events dialog shown in Figure 3-4. The Event Browser displays those events that meet all of the criteria in the Filter Events dialog.
3 – Managing Fabrics Displaying Fabric Information 0 3.4.2.2 Sorting the Event Browser Sorting the Event Browser enables you to display the events in alphanumeric order based on the event severity, timestamp, source, type, or description. Initially, the Event Browser is sorted in ascending order by timestamp. To sort the Event Browser, click the Severity, Timestamp, Source, Type, or Description column buttons.
0 3 – Managing Fabrics Displaying Fabric Information 3.4.3 Devices Data Window The Devices data window displays information about devices (hosts and storage targets) connected to the switch. Click the Devices tab below the data window to display device information for all devices that are logged into the selected fabric. To narrow the display to devices that are logged into specific switches, select one or more switches in the fabric tree or the topology display.
0 3 – Managing Fabrics Displaying Fabric Information 3.4.4 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, click the Active Zoneset tab below the data window in the topology display.
0 3 – Managing Fabrics Working with Device Information and Nicknames 3.4.5 Link Data Window The Link data window displays information about all switch links in the fabric or selected links. This information includes the switch name, the port number at the end of each link, and the link status icons. To open the Link data window, click the Link tab below the data window in the topology display. 3.
0 3 – Managing Fabrics Working with Device Information and Nicknames 3.5.2 Exporting Device Information to a File To save device information to a file, open the topology display and do the following: 1. Select one or more switches. If no switches are selected, Devices information is gathered for all switches. 2. Open the Switch menu and select Export Devices Information. 3. In the Save dialog, enter a file name. 4. Click the Save button. 3.5.
0 3 – Managing Fabrics Working with Device Information and Nicknames 3.5.3.2 Editing a Nickname A nickname must start with a letter and can have up to 64 characters. Valid characters include alphanumeric characters [aA-zZ][0-9] and special symbols [$ _ - ^ ]. You can access the Edit Nicknames dialog two ways. Choose one of the following methods to edit a nickname: In the topology or faceplate display, open the File menu and select Nicknames to open the Nicknames dialog.
0 3 – Managing Fabrics Zoning a Fabric 3.5.3.5 Importing a Nicknames File Importing a nicknames file copies its contents into and replaces the contents of the Nicknames.xml file which is used by SANsurfer Switch Manager. To import a nickname file, do the following: 1. Open the File menu and select Nicknames to open the Nicknames dialog. 2. Open the File menu in the Nicknames dialog, and select Import. 3. Select an XML nickname file in the Open dialog and click Open.
0 3 – Managing Fabrics Zoning a Fabric 3.6.1.1 Zones A zone is a named group of ports or devices that can communicate with each other. Devices within a zone can only communicate with other devices in the same zone. A device may participate in more than one zone. Membership in a zone can be defined by switch domain ID and port number, device Fibre Channel address (FCID), or device World Wide Name (WWN). WWN entries define zone membership by the World Wide Name of the attached device.
3 – Managing Fabrics Zoning a Fabric 0 3.6.1.1.2 Access Control List Hard Zones Access Control List (ACL) zoning divides the fabric for purposes of controlling discovery and inbound traffic. ACL zoning is a type of hard zoning that is hardware enforced. This type of zoning is useful for controlling access to certain devices without totally isolating them from the fabric. Devices can communicate with each other and transmit outside the ACL zone, but cannot receive inbound traffic from outside the zone.
0 3 – Managing Fabrics Zoning a Fabric 3.6.1.4 Zoning Database Each switch has its own zoning database. The zoning database is made up of all aliases, zones, and zone sets that have been created on the switch or received from other switches. The switch maintains two copies of the inactive zoning database: one copy is maintained in temporary memory for editing purposes; the second copy is maintained in permanent memory.
0 3 – Managing Fabrics Zoning a Fabric 3.6.2 Using the Zoning Wizard The Zoning Wizard is a series of dialogs that leads you through the process of zoning a fabric. To open the Zoning Wizard, open the Wizards menu in the faceplate display, and select Zoning Wizard. The Zoning Wizard helps you with the two most typical reasons for zoning: Zoning Windows servers storage Assign storage to servers.
0 3 – Managing Fabrics Zoning a Fabric 3.6.3.1 Editing the Zoning Database 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 dialog shown in Figure 3-7. Changes can only be made to inactive zone sets, which are stored in flash (non-volatile) memory and retained after resetting a switch. Port/Device Tree Zone Sets Tree Figure 3-7.
0 3 – Managing Fabrics Zoning a Fabric Note: If the Interop Auto Save parameter is enabled on the Zoning Configuration dialog, then every time the active zone set changes, the switch will copy it into an inactive zone set stored on the switch. You can edit this copy of the active zone set stored on the switch, and activate the updated copy to conveniently apply the changes to the active zone set. The edited copy then becomes the active zone set.
0 3 – Managing Fabrics Zoning a Fabric Table 3-4.
0 3 – Managing Fabrics Zoning a Fabric 3.6.3.2 Configuring the Zoning Database Use the Zoning Config dialog to change the Auto Save and Default Visibility configuration parameters. In the faceplate display, open the Zoning menu and select Edit Zoning Config to open the Zoning Config dialog shown in Figure 3-8. After making changes, click the OK button to put the new values into effect. Figure 3-8. Zoning Config Dialog 3.6.3.2.
0 3 – Managing Fabrics Zoning a Fabric 3.6.3.2.2 Default Visibility Default visibility determines the level of communication that is permitted among ports/devices when there is no active zone set. The default visibility parameter can be set differently on each switch. When default visibility is enabled (ALL) on a switch, all ports/devices on the switch can communicate with all ports/devices on switches that also have default visibility enabled.
0 3 – Managing Fabrics Zoning a Fabric 3.6.3.5 Restoring the Default Zoning Database Restoring the default zoning clears the switch of all zoning definitions. CAUTION! This command will deactivate the active zone set. To restore the default zoning for a switch: 1. In the faceplate display, open the Zoning menu and select Restore Default Zoning. 2. Click the OK button to confirm that you want to restore default zoning and save changes to the zoning database. 3.6.3.
0 3 – Managing Fabrics Zoning a Fabric 3.6.4 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.
0 3 – Managing Fabrics Zoning a Fabric 3.6.4.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.
0 3 – Managing Fabrics Zoning a Fabric 3.6.4.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 can’t be removed and is not saved on the switch. To delete a zone set from the database, do the following: 1.
0 3 – Managing Fabrics Zoning a Fabric 3.6.5.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-37 for more information. Refer to ”Zones” on page 3-21 for information on zone types (soft and hard). To create a zone in a zone set, do the following: 1. Open the Zoning menu, and select Edit Zoning to open the Edit Zoning dialog. 2. Select a zone set. 3.
0 3 – Managing Fabrics Zoning a Fabric 3.6.5.2 Adding Zone Members You can zone a port/device by switch domain ID and port number, device port Fibre Channel address, or the device port WWN. Adding a port/device to a zone affects every zone set in which that zone is a member. To add ports/devices to a zone, do the following: 1. Open the Zoning menu, and select Edit Zoning to open the Edit Zoning dialog. 2.
0 3 – Managing Fabrics Zoning a Fabric 3.6.5.3 Renaming a Zone or a Zone Set To rename a zone, do the following: 1. In the Zone Sets tree of the Edit Zoning dialog, click the zone/zone set to be renamed. 2. Open the Edit menu and select Rename. 3. In the Rename Zone/Rename Zone Set dialog, enter a new name for the zone/zone set. 4. Click the OK button. 3.6.5.4 Removing a Zone Member Removing a zone member will affect every zone and zone set in which that zone is a member.
0 3 – Managing Fabrics Zoning a Fabric 3.6.5.7 Changing Zone Types To change a zone type, do the following: 1. In the faceplate display, select the switch with the zone type to change. 2. Click the Zoning button to open the Edit Zoning dialog. 3. In the Zone Sets tree, select the zone to change. 4. Open the Edit menu and select Set Zone Type to open the Set Zone Type dialog. 5. Open the Zone Type pull-down menu and select Soft or ACL. Soft zoning is the least restrictive type of zoning.
0 3 – Managing Fabrics Zoning a Fabric 3.6.6.2 Adding a Member to an Alias You can add a port/device to an alias by domain ID and port number, device port Fibre Channel address, or the device port WWN. To add ports/devices to an alias, do the following: 1. Open the Zoning menu, and select Edit Zoning to open the Edit Zoning dialog. 2. Choose one of the following methods to add the port/device: Select a port/device in the Port/Device tree, and drag it into the alias.
0 3 – Managing Fabrics Zoning a Fabric 3.6.7 Merging Fabrics and Zoning If you join two fabrics with an inter-switch link, the active zone sets from the two fabrics attempt to merge automatically. 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.
0 3 – Managing Fabrics Zoning a Fabric 3.6.7.2 Zone Merge Failure Recovery When a zone merge failure occurs, the conflict that caused the failure must be resolved. You can correct a failure due to a zone conflict by deactivating one of the active zone sets or by editing the conflicting zones so that their membership is the same. You can deactivate the active zone set on one fabric if the active zone set on the other fabric accurately defines your zoning needs.
Section 4 Managing Switches This section describes the following tasks that manage switches in the fabric.
0 4 – Managing Switches Managing User Accounts 4.1 Managing User Accounts Only the Admin account can manage user accounts with the User Account Administration dialogs. However, any user can modify their own password. To open the User Account Administration dialogs, open the Switch menu in the faceplate display, and select User Accounts....
0 4 – Managing Switches Managing User Accounts 4.1.1 Creating User Accounts To create a user account on a switch, open the Switch menu in the faceplate display and select User Accounts.... This displays the User Account Administration dialog shown in Figure 4-1. A switch can have a maximum of 15 user accounts. Figure 4-1. User Account Administration Dialog – Add Account 59056-02 A 1.
0 4 – Managing Switches Managing User Accounts 4.1.2 Removing a User Account To remove a user account on a switch, open the Switch menu in the faceplate display and select User Accounts.... Click the Remove Account tab in the dialog to present the display shown in Figure 4-2. Select the account (login) name from the list of accounts at the top of the dialog and click the Remove Account button. Figure 4-2.
0 4 – Managing Switches Managing User Accounts 4.1.3 Changing a User Account Password To change the password for an account on a switch, open the Switch menu in the faceplate display and select User Accounts.... Click the Change Password tab in the dialog to present the display shown in Figure 4-3. Select the account (login) name from the list of accounts at the top of the dialog, then enter the old password, the new password, and verify the new password in the corresponding fields.
0 4 – Managing Switches Managing User Accounts 4.1.4 Modifying a User Account To modify a user account on a switch, open the Switch menu in the faceplate display and select User Accounts.... This displays the User Account Administration dialog shown in Figure 4-4. Click the Modify Account tab. Select the account (login) name from the list of accounts at the top of the dialog. Click the Admin authority Enabled check box to grant admin authority to the account name.
0 4 – Managing Switches Displaying Switch Information 4.2 Displaying Switch Information The faceplate display and data windows provide the following switch information: Device and HBA information Switch specifications and addresses Configuration parameters Port performance statistics Port information Configured zone sets Figure 4-5 shows the faceplate display for the SANbox 5200 Series switch. Figure 4-5.
0 4 – Managing Switches Displaying Switch Information 4.2.1 Devices Data Window The Devices data window displays information about devices (hosts and storage targets) connected to the switch. Click the Devices tab below the data window to display name server information for all devices that are logged into the selected fabric. To narrow the display to devices that are logged into specific switches, select one or more switches in the fabric tree or the topology display.
0 4 – Managing Switches Displaying Switch Information Table 4-2. Switch Data Window Entries (Continued) Entry 59056-02 A Description MAC Address Media Access Control address IP Address Internet Protocol address Subnet Mask Mask that determines the IP address subnet Gateway Gateway address SNMP Enabled SNMP enabled or disabled.
0 4 – Managing Switches Displaying Switch Information Table 4-2. Switch Data Window Entries (Continued) Entry 4-10 Description Security Auto Save N/A - does not apply to this switch Security Fabric Binding Enable N/A - does not apply to this switch Fan 1 Status The status of Fan 1 (SANbox 5202 only) Fan 2 Status The status of Fan 2 (SANbox 5202 only) Power Supply 1 Status Power supply 1 status Power Supply 2 Status Power supply 2 status (SANbox 5202 only) Beacon Status Beacon status.
0 4 – Managing Switches Displaying Switch Information Table 4-2. Switch Data Window Entries (Continued) Entry Description Number of Donor Groups Total number of donor port groups. A donor group is a set of (1-Gbps/2-Gbps only) ports on a switch that can donate buffer credits to each other. Embedded GUI SANsurfer Switch Manager web applet status. Enables or disables the web applet on the switch.
4 – Managing Switches Displaying Switch Information 0 4.2.5 Configured Zonesets Data Windows The Configured Zonesets data window displays all zone sets, zones, aliases, and zone membership in the zoning database, as shown in Figure 4-6. To open the Configured Zonesets data window, click the Configured Zonesets tab below the data window in the faceplate display. To view the active zone set in the Active Zonesets data window, open the topology display and click the Active Zonesets data window tab.
0 4 – Managing Switches Configuring Port Threshold Alarms 4.3 Configuring Port Threshold Alarms You can configure the switch to generate alarms for selected events. Configuring an alarm involves choosing an event type, rising and falling triggers, a sample window, and finally enabling or disabling the alarm. To configure port threshold alarms, do the following: 1. In the faceplate display, open the Switch menu and select Port Threshold Alarm Configuration.
0 4 – Managing Switches Paging a Switch 5. Enter a value for the rising trigger. A rising trigger alarm is generated when the event count per interval exceeds the rising trigger. The switch will not generate another rising trigger alarm for that event until the count descends below the falling trigger and rises again above the rising trigger. Consider the example in Figure 4-8. 6. Enter a value for the falling trigger.
0 4 – Managing Switches Setting the Date/Time and Enabling NTP Client 4.5 Setting the Date/Time and Enabling NTP Client The Date/Time and Network Time Protocol (NTP) dialog enables you to manually set the date and time on a switch, or to enable NTP Client to synchronize the date and time on the switch with an NTP server. Enabling the NTP client ensures the consistency of date and time stamps in alarms and log entries. An Ethernet connection to an NTP server is required.
0 4 – Managing Switches Resetting a Switch Management Interfaces: After an NDCLA operation is complete, management connections must be re-initiated: SANsurfer Switch Manager sessions will re-connect automatically Telnet sessions must be restarted manually. Applicable Code Versions: Future switch code releases will be upgraded non-disruptively unless specifically indicated in its associated release notes An NDCLA operation to previous switch code releases is not supported. Table 4-3.
0 4 – Managing Switches Configuring a Switch 4.7 Configuring a Switch Switch configuration is divided into three areas: chassis configuration, network configuration, and SNMP configuration. Chassis configuration specifies switch-wide Fibre Channel settings. Network configuration specifies IP settings, remote logging, and the NTP client. SNMP configuration specifies SNMP settings and traps. You can configure a switch explicitly or you can use the Configuration Wizard.
0 4 – Managing Switches Configuring a Switch The timeout values are displayed only for reference purposes when the switch is online; they become active when the switch is taken offline. After making changes, click the OK button to put the new values into effect. Figure 4-9. Switch Properties Dialog 4.7.2.1 Symbolic Name The symbolic name is a user-defined name of up to 32 characters that identifies the switch.
0 4 – Managing Switches Configuring a Switch Table 4-4. Switch Administrative States Parameter Description Online The switch is available. Offline The switch is unavailable. Diagnostics The switch is in diagnostics mode, is unavailable, and tests can then be run on all ports of the switch. 4.7.2.3 Domain ID and Domain ID Lock The domain ID is a unique Fibre Channel identifier for the switch.
4 – Managing Switches Configuring a Switch 0 4.7.2.4 Fabric Device Management Interface Fabric Device Management Interface (FDMI) provides a means to gather and display device information from the fabric, and allows FDMI capable devices to register certain information with the fabric, if FDMI is enabled. SANsurfer Switch Manager will report any and all FDMI information reported by the entry switch, if FDMI is enabled on the entry switch.
0 4 – Managing Switches Configuring a Switch 4.7.2.5 Broadcast Support Broadcast is supported on the switch and allows for TCP/IP support. Broadcast is implemented using the proposed standard specified in Multi-Switch Broadcast for FC-SW-3, T11 Presentation Number T11/02-031v0. Fabric Shortest Path First (FSPF) is used to set up a fabric spanning tree used in transmission of broadcast frames.
0 4 – Managing Switches Configuring a Switch 4.7.2.8 Legacy Port Address Format Legacy Address Format should be enabled only to permit interoperation with certain older non-FC-SW-2 switches. Enabling this setting under other circumstances will disable zoning that is defined by domain ID and port number. This setting is available only when the Interop Mode setting is disabled. Contact your authorized maintenance provider for assistance in using this feature.
0 4 – Managing Switches Configuring a Switch 4.7.3 Network Properties Use the Network Properties dialog shown in Figure 4-10 to change IP configuration parameters and enable remote logging. After making changes, click the OK button to put the new values into effect. To open the Network Properties dialog, select a switch in the topology display or open the faceplate display, open the Switch menu and select Network Properties. Figure 4-10.
0 4 – Managing Switches Configuring a Switch 4.7.3.1 IP Configuration The IP configuration identifies the switch on the Ethernet network and determines which network discovery method to use. Table 4-6 describes the IP configuration parameters. Table 4-6. IP Configuration Parameters Parameter 4-24 Description Network Discovery Choose one of the following methods by which to assign the IP address: Static - Uses the IP configuration parameters entered in the Switch Properties dialog.
0 4 – Managing Switches Configuring a Switch 4.7.3.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.
0 4 – Managing Switches Configuring a Switch 4.7.4 SNMP Properties Use the SNMP Properties dialog shown in Figure 4-11 to change SNMP configuration parameters. After making changes, click the OK button to put the new values into effect. To open the SNMP Properties dialog, select a switch in the topology display or open the faceplate display, open the Switch menu and select SNMP Properties.
0 4 – Managing Switches Configuring a Switch 4.7.4.1 SNMP Configuration The SNMP configuration defines how authentication traps are managed.Table 4-7 describes the SNMP configuration parameters. The illegal characters for the user-defined fields are the pound sign (#), semi-colon (;), and comma (,). Table 4-7. SNMP Configuration Parameters 59056-02 A Parameter Description SNMP Enabled Enables or disables SNMP communication with other switches in the fabric.
0 4 – Managing Switches Configuring a Switch 4.7.4.2 SNMP Trap Configuration The SNMP trap configuration defines how traps are set. Choose from the tabs Trap1 – Trap 5 to configure each trap. Table 4-8 describes the SNMP configuration parameters. Table 4-8. SNMP Trap Configuration Parameters Parameter Description Trap Version Specifies the SNMP version (1 or 2) with which to format traps. Trap 1 Enabled Enables or disables the trap. If disabled, traps are not configurable.
0 4 – Managing Switches Archiving a Switch 4.8 Archiving a Switch You can create an .XML archive file containing the configuration parameters. Basically any data received by SANsurfer Switch Manager is archived. However, passwords are not archived with the user account information.
0 4 – Managing Switches Restoring a Switch 2. Open the Switch menu in the faceplate display and select Restore to display the Restore dialog shown in Figure 4-12. The Restore dialog offers a Full Restore and a Selective Restore tab. Figure 4-12. Restore Dialogs – Full and Selective 4-30 3. Enter the archive file name or browse for the file. This archive file must be one that was produced by the SANsurfer Switch Manager Archive function.
0 4 – Managing Switches Restoring the Factory Default Configuration Port Properties: Restores all settings presented in the Port properties dialog. Refer to ”Configuring Ports” on page 5-10. Configured Zoning: Restores all zone sets (except the active zone set), zones, and aliases in the switch’s zoning database. 5. If you select the Configured Zoning or Full Restore option and the file contains zone sets, a dialog prompts you to activate one of those zone sets.
0 4 – Managing Switches Restoring the Factory Default Configuration Table 4-9. Factory Default Configuration Settings (Continued) Setting 4-32 Value SNMP Enabled True SNMP Proxy True IP Address 10.0.0.1 FDMI Enabled True FDMI HBA Entry Level 1000 Subnet Mask Address 255.0.0.0 Gateway Address 10.0.0.254 Network Discovery Static Remote Logging False Remote Logging Host Ip Address 10.0.0.254 NTP Client Enabled False NTP Server IP Address 10.0.0.
0 4 – Managing Switches Downloading a Support File 4.11 Downloading a Support File The Download Support File menu option assembles all log files and switch memory data into a core dump file (dump_support.tgz). This file can be sent to technical support personnel for troubleshooting switch problems. The menu option is not accessible (displayed) for switches that don't support the download support file function. To create a support file, do the following: 59056-02 A 1.
0 4 – Managing Switches Upgrading the Switch Using License Keys 4.12 Upgrading the Switch Using License Keys The switch can come from the factory as an 8-, 12-, 16-, or 20-port switch enabling ports 0-7, 0-11, 0-15, or 0-20 respectively. A (port) license key is a password that you can purchase from your switch distributor or authorized reseller to upgrade the switch to a 12-, 16-, or 20-port switch.
0 4 – Managing Switches Installing Firmware 7. Click the Add Key button to upgrade the switch. Allow a minute or two for the upgrade to complete. 4.13 Installing Firmware Installing firmware involves loading, unpacking, and activating the firmware image on the switch. SANsurfer Switch Manager does this in one operation. To provide consistent performance throughout the fabric, ensure that all switches are running the same version of firmware.
0 4 – Managing Switches Displaying Hardware Status To install firmware, do the following: 1. In the faceplate display, open the Switch menu and select Load Firmware. 2. In the Firmware Upload dialog, click the Select button to browse and select the firmware file to be uploaded. 3. Click the Start button to begin the firmware load process. You will be shown a message warning you that the switch will be reset in order to activate the firmware. 4.
Section 5 Managing Ports This section describes the following tasks that manage ports and devices: Displaying Port Information Configuring Ports Testing Ports Graphing Port Performance 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.
0 5 – Managing Ports Displaying Port Information 5.1.1 Monitoring Port Status The faceplate display provides the following port related information: Port type 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.
0 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.
0 5 – Managing Ports Displaying Port Information 5.1.1.4 Displaying Transceiver Media Status To display transceiver media status, open the View menu and select View Port Media. Table 5-4 lists the port media states and their meanings. Table 5-4.
0 5 – Managing Ports Displaying Port Information 5.1.2 Port Statistics Data Window The Port Statistics data window displays statistics about port performance. To open the Port Statistics window, select one or more ports in the faceplate display and click the Port Stats tab below the data window. Table 5-5 describes the Port Statistics data window entries. The Statistics pull-down menu is available on the Port Statistics data window, and provides different ways to view detailed port information.
0 5 – Managing Ports Displaying Port Information Table 5-5. Port Statistics Data Window Entries (Continued) Entry 5-6 Description Class 3 Toss Number of class 3 frames that were discarded by this port. A frame 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, or receiving a frame on an offline port. Class 3 Words In Number of class 3 words received by this port.
0 5 – Managing Ports Displaying Port Information Table 5-5. Port Statistics Data Window Entries (Continued) Entry 59056-02 A Description LIP(f7,f7) A loop initialization primitive frame used to acquire an AL_PA. LIP(f8,AL_PS) This LIP denotes a loop failure detected by the L_port identified by AL_PS. LIP(f8,f7) A loop initialization primitive frame used to indicate that a Loop Failure has been detected at its receiver and does not have a valid AL_PA.
0 5 – Managing Ports Displaying Port Information 5.1.3 Port Information Data Window The Port Information data window displays detail information for the selected port. To open the Port Information data window, click the Port Info tab below the data window in the faceplate display. Table 5-6. Port Information Data Window Entries Entry 5-8 Description Port Address Port Fibre Channel address. Administrative Port Type The administrative port type (G, GL, F, FL, or Donor).
0 5 – Managing Ports Displaying Port Information Table 5-6. Port Information Data Window Entries (Continued) Entry 59056-02 A Description E Port Isolation Reason Why E_Port is isolated. MFS Mode Multiple Frame Sequence bundling status. I/O Stream Guard RSCN message suppression status. Status can be enabled, disabled, or automatically determined by the switch. Administrative Port Speed The speed requested by the user. Operational Port Speed The speed actually being used by the port.
0 5 – Managing Ports Configuring Ports Table 5-6. Port Information Data Window Entries (Continued) Entry Description Media Part Number The part number assigned to the SFP Media Revision Transceiver hardware version 5.2 Configuring Ports The port settings or characteristics for 1-Gbps/2-Gbps and 10-Gbps ports are configured using the Port Properties dialogs shown in Figure 5-2.
0 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 has 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. SANsurfer Switch Manager always makes changes to the configured administrative state.
0 5 – Managing Ports Configuring Ports 5.2.2 Changing Port Speeds The 1-Gbps/2-Gbps ports are capable of transmitting and receiving at 1-Gbps, or 2-Gbps. The ports can be configured for either transmission speed or to sense the transmission speed of the device to which it is connected. Table 5-8 describes the port speeds. To change the port speed, do the following: 1. Select one or more 1Gbps/2Gbps ports in the faceplate display. 2. Open the Port menu and select Port Properties. 3.
0 5 – Managing Ports Configuring Ports Table 5-9. Port Types State Description GL_Port Generic loop port - Self discovers as an F_Port, FL_Port, or an E_Port. GL_Port is the default port type. A single device on a public loop will attempt to configure as an F_Port first, then if that fails, as an FL_Port. 1-Gbps/2-Gbps only. Donor Donor port - Allows buffer credits to be used by another port. 1-Gbps/2-Gbps only. 5.2.
0 5 – Managing Ports Using the Extended Credits Wizard 5.2.6 Changing Port Symbolic Name To change the symbolic name of a port from the faceplate display, do the following: 1. Open the faceplate display and select a port. 2. Open the Port menu and select Port Symbolic Name. 3. In the Port Symbolic Name dialog, choose one of the following: 4. Enter a new name for the port in the Set Port Symbolic Name field. The symbolic name can have up to 32 characters.
0 5 – Managing Ports Resetting a Port Figure 5-3. Designate Donor Ports 4. Verify Requested Changes: Review the extended distance requests and the selected donor ports. Click the Finish button to apply the changes, and redistribute the credits. 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.
0 5 – Managing Ports Testing Ports 5.5 Testing Ports The port loopback tests verify correct port operation by sending a frame out through the loop, and then verifying that the frame received matches the frame that was sent. Only one port can be tested at a time for each type of test. The Port Loopback Test dialog shown in Figure 5-4 presents the following loopback tests: Figure 5-4. Port Loopback Test Dialog 5-16 SerDes level (Internal) - The SerDes level test verifies port circuitry.
0 5 – Managing Ports Testing Ports Node-to-Node (Online) - The Node-to-Node test verifies communications between the port and its device node or device loop. The port being tested must be online and connected to a remote device. The port passes the test if the frame that was sent by the ASIC matches the frame that was received. This test does not disrupt communication on the selected port. This test requires that the port be online, and therefore, does not disrupt communication.
0 5 – Managing Ports Graphing Port Performance 5.6 Graphing Port Performance SANsurfer Performance Viewer application displays port performance using graphs. SANsurfer Performance Viewer plots data communication rates and total errors for selected ports as shown in Figure 5-5. When graphing data communication rates, you can choose either frames/second or KB/second.
0 5 – Managing Ports Graphing Port Performance Set the polling frequency Display graphs Print graphs Save graph statistics to a file 5.6.1 Starting SANsurfer Performance Viewer To start SANsurfer Performance Viewer from within SANsurfer Switch Manager, open the topology display and select Start Performance Viewer from the Fabric menu.
5 – Managing Ports Graphing Port Performance 0 To prevent SANsurfer Performance Viewer from prompting you to save the default performance view file between sessions, set the Auto Load and Save Graphing Environment setting to Enable (default). Refer to ”Setting SANsurfer Performance Viewer Preferences” on page 5-21 for more information. Figure 5-6.
0 5 – Managing Ports Graphing Port Performance To open a performance view file, do the following: 1. Open the File menu and select Open View File to open the Open View dialog. 2. Enter a name for the fabric file or click the Browse button to select an existing file. 5.6.4 Changing the Default Performance View File Encryption Key To change the encryption key for the default performance view file, do the following: 1.
0 5 – Managing Ports Graphing Port Performance 5.6.6 Setting the Polling Frequency SANsurfer Performance Viewer updates the graphs once per second by default. To change this polling frequency, do the following: 1. Open the Graph menu, and select Set Polling Frequency to open the Set Graph Polling Frequency dialog. 2. Enter the new polling interval in seconds [1–60]. Performance Viewer will update the graphs once during the interval.
0 5 – Managing Ports Graphing Port Performance 5.6.7.1 Arranging Graphs in the Display To arrange and size graphs in the display, open the Window menu and select Cascade, Tile, or Close All. Cascade overlaps the graphs so that all graphs are at least partially visible. Tile arranges the graphs in non-overlapping rows and columns. Close All closes all graphs. You can also click a graph on the Window menu to bring that graph to the front. 5.6.7.
0 5 – Managing Ports Graphing Port Performance To modify the graph options, do the following: 1. 2. Choose the units for the graph: Select the Show Bytes Data on Graph check box to plot data in KBytes/second Select the Show Frames Data on Graph check box to plot data in frames/second. Choose what data type to plot. For example, if you selected Show Frames Data on Graph in step 1.
0 5 – Managing Ports Graphing Port Performance 6. In the Default Graph Options dialog, click the OK button to save the color scheme changes and close the dialog. 5.6.7.3 Rescaling a Selected Graph The Rescale Selected Graph option auto-scales downward and re-positions the data within a graphic window to display all new data captured by the graph. To rescale a selected graph, do the following: 1. Select a displayed graph. 2.
5 – Managing Ports Graphing Port Performance 0 Notes 5-26 59056-02 A
Appendix A Command Line Interface The command line interface (CLI) enables you to perform a variety of fabric and switch management tasks through an Ethernet or a serial port connection. This section describes the following: Logging On to a Switch User Accounts Working with Switch Configurations Commands A.
A – Command Line Interface User Accounts 0 A.2 User Accounts Switches come from the factory with the following user account already defined: Account name: admin Password: password Authority: Admin This user account provides full access to the switch and its configuration. After planning your fabric management needs and creating your own user accounts, consider changing the password for this account. Refer to ”Commands” on page A-6 for information about authority levels.
0 A – Command Line Interface Working with Switch Configurations A.3 Working with Switch Configurations Successful management of switches and fabrics with the command line interface depends on the effective use of switch configurations. Modifying configurations, backing up configurations, and restoring configurations are key switch management tasks. A.3.1 Modifying a Configuration A switch supports up to 10 configurations including the default configuration.
0 A – Command Line Interface Working with Switch Configurations The Config Save command saves the changes you made during the Config Edit session. In this case, changes to the configuration named Default are being saved to a new configuration named config_10132003.
0 A – Command Line Interface Working with Switch Configurations You should rename the configdata file on your workstation with the switch name and date, config_switch_169_10112003, for example. The restore operation begins with FTP to upload the configuration file from the workstation to the switch, then finishes with a Telnet session and the Config Restore command. To upload the configuration file, config_switch_169_10112003 in this case, open and FTP session with account name images and password images.
0 A – Command Line Interface Commands A.4 Commands 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: Commands and keywords are case insensitive. Required keyword values appear in standard font: [value]. Optional values are shown in italics: [value]. Underlined portions of the keyword in the command format indicate the abbreviated form that can be used.
0 A – Command Line Interface Commands The command set performs monitoring and configuration tasks. Commands related to monitoring tasks are available to all account names. Commands related to configuration tasks are available only within an admin session. An account must have Admin authority to enter the Admin Start command, which opens an admin session. Refer to the ”Admin Command” on page A-8. The commands and their page numbers are listed in Table A-2. Table A-2.
0 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-56.
0 A – Command Line Interface Alias Command Alias Command Creates a named set of ports/devices. Aliases make it easier to assign a set of ports/devices to many zones. An alias can not have a zone or another alias as a member.
0 A – Command Line Interface Alias Command members [alias] Displays all members of the alias given by [alias]. This keyword does not require an admin session. remove [alias] [member_list] Removes the ports/devices given by [member_list] from the alias given by [alias]. Use a to delimit ports/devices in [member_list]. A port/device in [member_list] can have any of the following formats: Domain ID and port number pair (Domain ID, Port Number). Domain IDs can be 1–-239; port numbers can be 0–-255.
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-39.
A – Command Line Interface Config Command 0 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. After the restore is complete, the switch automatically resets. Refer to ”Backing up and Restoring Switch Configurations” on page A-4.
0 A – Command Line Interface Config Command The following is an example of how to create a backup file (configdata) and download the file to the workstation.
A – Command Line Interface Create Support Command 0 Create Support Command Assembles all log files and switch memory data into a core dump file (dump_support.tgz zip) and prompts you to send it to a remote host. This file is useful to technical support personnel for troubleshooting switch problems. Use this command when directed by your authorized maintenance provider.
0 A – Command Line Interface Create Support Command 221-You have transferred 43430 bytes in 1 files. 221-Total traffic for this session was 43888 bytes in 1 transfers. 221 Thank you for using the FTP service on localhost.localdomain.
A – Command Line Interface Date Command 0 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. The new date and time takes effect immediately. Network Time Protocol (NTP) must be disabled to set the time with the Date command. Refer to the ”Set Setup Command” on page A-56, System keyword, for information about NTP. Authority Admin session except to display the date.
0 A – Command Line Interface Feature Command Feature Command Adds license key features to the switch and displays the license key feature log. To order a license key contact your switch distributor or your authorized reseller. Upgrading a switch is not disruptive, nor does it require a switch reset. Authority Admin session for Add keyword only Syntax feature add [license_key] log Keywords add [license_key] Adds the feature that corresponds to the value given by [license_key].
0 A – Command Line Interface Firmware Install Command Firmware Install Command Downloads firmware from a remote host to the switch, installs the firmware, then resets the switch (without a power-on self test) to activate the firmware. If possible, a non-disruptive activation is performed.
0 A – Command Line Interface Hardreset Command Hardreset Command Resets the switch and performs a power-on self test. This reset disrupts traffic, activates the pending firmware, and clears the alarm log. To save the alarm log before resetting, refer to the ”Set Log Command” on page A-51. Authority Admin session Syntax Notes hardreset To reset the switch without a power-on self test, refer to the ”Reset Command” on page A-31.
0 A – Command Line Interface Help Command Help Command Displays a brief description of the specified command, its keywords, and usage. Authority None Syntax Keywords help [command] [keyword] [command] Displays a summary of the command given by [command] and its keywords. If you omit [command], the system displays all available commands. [keyword] Displays a summary of the keyword given by [keyword] belonging to the command given by [command].
0 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 None Syntax Notes history Examples Use the History command to provide context for the ! command: Enter ![command_string] to re-execute the most recent command that matches [command_string].
0 A – Command Line Interface Hotreset Command Hotreset Command Resets the switch for the purpose of activating the pending firmware without disrupting traffic. This command terminates all management sessions, saves all configuration information, and clears the event log. After the pending firmware is activated, the configuration is recovered. This process takes less than 80 seconds. To save the event log to a file before resetting, refer to the ”Set Log Command” on page A-51.
0 A – Command Line Interface Image Command Image Command Manages and installs switch firmware. Authority Admin session Syntax image cleanup fetch [account_name] [ip_address] [file_source] [file_destination] install 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 Image Command 0 2. Move to the folder or directory on the workstation that contains the new firmware image file. 3. Establish communications with the switch using the File Transfer Protocol (FTP). Enter one of the following on the command line: >ftp xxx.xxx.xxx.xxx or >ftp switchname where xxx.xxx.xxx.xxx is the switch IP address, and switchname is the switch name associated with the IP address. 4.
0 A – Command Line Interface Image Command 12. Wait for the unpack to complete. image unpack command result: Passed 13. A message will prompt you to reset the switch to activate the firmware. Resetting the switch is disruptive. Use the Hotreset command to attempt a non-disruptive activation. SANbox Manager (admin) $>hotreset Examples The following is an example of the Image Install command: SANbox Manager (admin) #> image install Warning: Installing new firmware requires a switch reset.
A – Command Line Interface Lip Command 0 Lip Command Reinitializes the specified loop port. Authority Admin session 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. Ports are numbered beginning with 0.
0 A – Command Line Interface Passwd Command Passwd Command Changes a user account’s password. Authority Admin account name and an admin session to change another account’s password; You can change you own password without an Admin session. Syntax Keywords passwd [account_name] Examples The following is an example of the Passwd command: [account_name] The user account name. To change the password for an account name other than your own, you must open an admin session with the account name Admin.
A – Command Line Interface Ping Command 0 Ping Command Initiates an attempt to communicate with another switch over an Ethernet network and reports the result. Authority None Syntax ping ip_address Keywords ip_address The IP address of the switch to query. Examples The following is an example of a successful Ping command: SANbox Manager #> ping 10.20.11.57 Ping command issued. Waiting for response... SANbox Manager #> Response successfully received from 10.20.11.57.
0 A – Command Line Interface Ps Command Ps Command Displays current system process information. Authority None Syntax Examples ps The following is an example of the Ps command: SANbox Manager #> ps PID 59056-02 A PPID %CPU TIME ELAPSED COMMAND 338 327 0.0 00:00:00 3-01:18:35 cns 339 327 0.0 00:00:01 3-01:18:35 ens 340 327 0.0 00:00:21 3-01:18:35 dlog 341 327 0.1 00:05:35 3-01:18:35 ds 342 327 0.2 00:11:29 3-01:18:35 mgmtApp 343 327 0.0 00:00:04 3-01:18:35 fc2 344 327 0.
A – Command Line Interface Quit Command 0 Quit Command Closes the Telnet session. Authority None Syntax Notes quit, exit, or logout A-30 You can also enter Control-D to close the Telnet session.
0 A – Command Line Interface Reset Command Reset Command Resets the switch configuration parameters. If you omit the keyword, the default is Reset Switch. Authority Admin session 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, port threshold alarm, and zoning configuration.
0 A – Command Line Interface Reset Command Clears the event log. To save the event log before resetting, refer to the ”Set Log Command” on page A-51. To reset the switch with a power-on self test, refer to the ”Hardreset Command” on page A-19. To reset the switch without disrupting traffic, refer to the ”Hotreset Command” on page A-22. system Resets the system configuration settings to the factory default values. Refer to Table A-8 for system configuration default values.
0 A – Command Line Interface Reset Command Table A-4.
0 A – Command Line Interface Reset Command Table A-5.
0 A – Command Line Interface Reset Command Table A-7. SNMP Configuration Defaults Parameter 59056-02 A Default SNMPEnabled True Contact Location Description SANbox 5200 Series FC Switch Trap [1-5] Address Trap 1: 10.0.0.254; Traps 2–5: 0.0.0.0 Trap [1-5] Port 162 Trap [1-5] Severity Warning Trap [1-5] Version 2 Trap [1-5] Enabled False ObjectID 1.3.6.14.1.1663.1.1.1.1.17 (SANbox 5200) 1.3.6.1.4.1.1663.1.1.1.1.
0 A – Command Line Interface Reset Command Table A-8. System Configuration Defaults Parameter A-36 Default Ethernet Network Discovery Static Ethernet Network IP Address 10.0.0.1 Ethernet Network IP Mask 255.0.0.0 Ethernet Gateway Address 10.0.0.254 Admin Timeout 30 minutes InactivityTimeout 0 LocalLogEnabled True RemotelogEnabled False RemoteLogHostAddress 10.0.0.254 NTPClientEnabled False NTPServerAddress 10.0.0.
0 A – Command Line Interface Set Command Set Command Sets a variety of switch parameters. Authority Admin session for all keywords except Alarm, Beacon, and Pagebreak which are available without an Admin session. Syntax set alarm [option] beacon [state] config [option] log [option] pagebreak [state] port [option] setup [option] switch [state] Keywords alarm [option] Controls the display of alarms in the session output stream or clears the alarm log.
A – Command Line Interface Set Command 0 on Limits the display of information to 20 lines at a time. The page break functions affects the following commands: Alias (List, Members), Show (Alarm, Log), Zone (List, Members), Zoneset (List, Zones), Zoning (Active, List). off Allows continuous display of information without a break. port [option] Sets port state and speed for the specified port. The previous Set Config Port settings are restored after a switch reset or a reactivation of a switch configuration.
0 A – Command Line Interface Set Config Command Set Config Command Sets switch, port, port threshold alarm, and zoning configuration parameters. The changes you make with this command are not retained when you reset or power cycle the switch unless you save them using the Config Save command. Refer to the ”Config Command” on page A-11.
0 A – Command Line Interface Set Config Command Table A-9. Set Config Port Parameters (Continued) Parameter A-40 Description PortType Port type: 1-Gbps/2-Gbps Ports: GL, G, F, FL, Donor. The default is GL. 10-Gbps Ports: G SymbolicPortName Descriptive name for the port. The name can be up to 32 characters excluding #, semicolon (;), and comma (,). The default is Port n where n is the port number. ALFairness (1-Gbps/2-Gbps ports only) Arbitration loop fairness.
0 A – Command Line Interface Set Config Command Table A-9. Set Config Port Parameters (Continued) Parameter 59056-02 A Description AutoPerfTuning Automatic performance tuning for FL_Ports only. The default is True. If AutoPerfTuning is enabled (True) and the port is an FL_Port, MFSEnable is automatically enabled. LCFEnable and VIEnable are overridden to False. If AutoPerfTuning is disabled (False), MFSEnable, LCFEnable, and VIEnable retain their original values.
0 A – Command Line Interface Set Config Command Table A-9. Set Config Port Parameters (Continued) Parameter Description IOStreamGuard I/O Stream Guard. Enables or disables the suppression of RSCN messages. IOStreamGuard can have the following values: Enable – Suppresses the reception of RSCN messages from other ports for which IOStreamGuard is enabled. Disable – Allows free transmission and reception of RSCN messages.
0 A – Command Line Interface Set Config Command Table A-10. Set Config Switch Parameters (Continued) Parameter 59056-02 A Description FDMIEnabled Fabric Device Monitoring Interface. Enables (True) or disables (False) the monitoring of target and initiator device information. FDMIEntries The number of device entries to maintain in the FDMI database. Enter a number from 0–1000. The default is 1000. DefaultDomainID Default domain ID. The default is 1.
0 A – Command Line Interface Set Config Command Table A-10. Set Config Switch Parameters (Continued) Parameter A-44 Description InteropMode Propagates just the active zone set throughout the fabric (True, compliant) or the entire zoning database (False, non-compliant). The default is True. LegacyAddressFormat Available only when the InteropMode parameter is False, this parameter enables (True) or disables (False) the use of legacy address formatting for interoperating with non-FC-SW-2 switches.
0 A – Command Line Interface Set Config Command threshold Initiates a configuration session by which to generate and log alarms for selected events. The system displays each event, its triggers, and sampling window 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. These parameters must be saved in a configuration and activated before they will take effect.
0 A – Command Line Interface Set Config Command 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. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets. Table A-12.
0 A – Command Line Interface Set Config Command ARB_FF (True / False) [False ] InteropCredit (decimal value, 0-255) [0 ] ExtCredit (dec value, increments of 15, non-loop only) [0 ] FANEnable (True / False) [True ] AutoPerfTuning (True / False) [False ] LCFEnable (True / False) [False ] MFSEnable (True / False) [False ] VIEnable (True / False) [False ] MSEnable (True / False) [True NoClose (True / False) [False ] ] IOStreamGuard (Enable / Disable / Auto) [Disable] PDISCPin
0 A – Command Line Interface Set Config Command MSEnable (True / False) [True IOStreamGuard (Enable / Disable / Auto) [Disabled] ] 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.
0 A – Command Line Interface Set Config Command ThresholdMonitoringEnabled (True / False) [False ] CRCErrorsMonitoringEnabled (True / False) [True ] RisingTrigger (decimal value, 1-1000) [25 ] FallingTrigger (decimal value, 0-1000) [1 ] SampleWindow (decimal value, 1-1000 sec) [10 ] (True / False) [True ] RisingTrigger (decimal value, 1-1000) [200 ] FallingTrigger (decimal value, 0-1000) [0 ] SampleWindow (decimal value, 1-1000 sec) [10 ] DecodeErrorsMonitoringEnabled ISL
0 A – Command Line Interface Set Config Command The following is an example of the Set Config Zoning command. SANbox Manager #> admin start SANbox Manager (admin) #> config edit SANbox Manager (admin-config) #> set config zoning 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.
0 A – Command Line Interface Set Log Command Set Log Command Specifies the events to record in the event log and display on the screen. You determine what events to record in the switch event log using the Component, Level, and Port keywords. You determine what events are automatically displayed on the screen using the Display keyword. Alarms are always displayed on the screen.
A – Command Line Interface Set Log Command 0 None Monitor none of the component events. Other Monitors other miscellaneous events. Port Monitors all port events. SNMP Monitors all SNMP events. Switch Monitors switch management events. Zoning Monitors zoning conflict events. display [filter] Specifies the log events to automatically display on the screen according to the event severity levels given by [filter]. [filter] can be one of the following values: Critical Critical severity level events.
0 A – Command Line Interface Set Log Command Info Monitors informative, warning, and critical events. The informative level describes routine events associated with a normal fabric. This is the default severity level. None Monitors none of the severity levels. port [port_list] Specifies one or more ports to monitor for events. Choose one of the following values: [port_list] Specifies port or ports to monitor. Use a to delimit values in the list. Ports are numbered beginning with 0.
0 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 session except for the Clear keyword. Syntax set port [port_number] bypass [alpa] clear enable speed [transmission_speed] state [state] Keywords [port_number] Specifies the port. Ports are numbered beginning with 0.
0 A – Command Line Interface Set Port Command Diagnostics Prepares the port for testing. This prepares the port for testing and prevents the port from accepting a device login. Down Disables the port by removing power from the port lasers.
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 session Syntax set setup snmp system Keywords snmp Prompts you in a line-by-line fashion to change SNMP configuration settings. Table A-13 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-13.
0 A – Command Line Interface Set Setup Command Table A-13. SNMP Configuration Settings (Continued) Entry Description ReadCommunity Read community password that authorizes an SNMP agent to read information from the switch. This is a write-only field. The value on the switch and the SNMP management server must be the same. The read community password can be up to 32 characters excluding #, semicolon (;), and comma (,). The default is “public”.
0 A – Command Line Interface Set Setup Command Table A-14. System Configuration Settings (Continued) Entry A-58 Description Eth0NetworkMask Ethernet subnet mask address. Eth0GatewayAddress Ethernet IP address gateway. AdminTimeout Amount of time in minutes the switch waits before terminating an idle Admin session. Zero (0) disables the time out threshold. The default is 30, the maximum is 1440.
0 Examples A – Command Line Interface Set Setup Command The following is an example of the Set Setup SNMP command: SANbox Manager #> admin start SANbox Manager (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.
0 A – Command Line Interface Set Setup Command TrapCommunity (string, max=32 chars) [public ] AuthFailureTrap (True / False) [False ] ProxyEnabled (True / False) [True ] The following is an example of the Set Setup System command: SANbox Manager (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.
0 A – Command Line Interface Show Command Show Command Displays fabric, switch, and port operational information.
0 A – Command Line Interface Show Command chassis Displays chassis component status and temperature. config [option] Displays switch, port, and zoning configuration attributes. Refer to the ”Show Config Command” on page A-76. 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, symbolic name, worldwide name, node IP address, and port IP address.
0 A – Command Line Interface Show Command ns [option] Displays name server information for the specified [option]. If you omit [option], name server information for the local domain ID is displayed. [option] can have the following values: all Displays name server information for all switches and ports. [domain_id] Displays name server information for the switch given by [domain_id]. [domain_id] is a switch domain ID. [port_id] Displays name server information for the port given by [port_id].
0 A – Command Line Interface Show Command Table A-15. Show Port Parameters (Continued) Entry A-64 Description EpConnects Number of times an E_Port connected through ISL negotiation. FBusy Number of times the switch sent a F_BSY because Class 2 frame could not be delivered within ED_TOV time. Number of class 2 and class 3 fabric busy (F_BSY) frames generated by this port in response to incoming frames.
0 A – Command Line Interface Show Command Table A-15. Show Port Parameters (Continued) Entry Description PrimSeqErrors Primitive sequence errors detected. RxLinkResets Number of link reset primitives received from an attached device. RxOfflineSeq Number of offline sequences received. An OLS is issued for link initialization, a Receive & Recognize Not_Operational (NOS) state, or to enter the offline state. TotalErrors Total number of errors detected.
0 A – Command Line Interface Show Command support Executes a series of commands that display a complete description of the switch, its configuration, and operation. The display can be captured from the screen and used for diagnosing problems. This keyword is intended for use at the request of your authorized maintenance provider.
0 A – Command Line Interface Show Command Table A-16. Switch Operational Parameters (Continued) Parameter Description LogLevel Event severity level used to record events in the event log MaxPorts Number of ports available on the switch NumberOfResets Number of times the switch has been reset over its service life ReasonForLastReset Action that caused the last reset ActiveImageVersion - build date Active firmware image version and build date.
0 A – Command Line Interface Show Command Examples The following is an example of the Show Chassis command: SANbox Manager #> show chassis Chassis Information ------------------BoardTemp (1) - Degrees Celsius 36 FanStatus (1) Good FanStatus (2) Good FanDirection (1) BackToFront FanDirection (2) BackToFront PowerSupplyStatus (1) Good PowerSupplyStatus (2) Good HeartBeatCode 1 HeartBeatStatus Normal The following is an example of the Show Domains command: SANbox Manager #> show domains Pr
0 A – Command Line Interface Show Command The following is an example of the Show FDMI command: SANbox Manager #> show fdmi HBA ID PortID Manufacturer Model Ports -------- ------ --------------- ------- ----- 21:01:00:e0:8b:27:aa:bc 610000 QLogic Corporation QLA2342 2 21:00:00:00:ca:25:9b:96 180100 QLogic Corporation QL2330 2 The following is an example of the Show FDMI WWN command: SANbox Manager #> show fdmi 21:00:00:e0:8b:09:3b:17 FDMI Information ---------------Manufacturer QLogic
0 A – Command Line Interface Show Command The following is an example of the Show NS (local domain) command: SANbox Manager #> show ns Seq Domain Port Port No ID Type COS PortWWN NodeWWN ------ ---- --- ------- ------- ID --- -----1 19 (0x13) 1301e1 NL 3 21:00:00:20:37:73:13:69 20:00:00:20:37:73:13:69 2 19 (0x13) 1301e2 NL 3 21:00:00:20:37:73:12:9b 20:00:00:20:37:73:12:9b 3 19 (0x13) 1301e4 NL 3 21:00:00:20:37:73:05:26 20:00:00:20:37:73:05:26 4 19 (0x13) 130d00 N 3 21:01:00:e0:8b:
0 A – Command Line Interface Show Command The following is an example of the Show Interface command: SANbox Manager #> 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.
0 A – Command Line Interface Show Command The following is an example of the Show Port command: SANbox Manager #> show port 1 Port Number: 1 ------------ A-72 AdminState Online OperationalState Online AsicNumber 0 PerfTuningMode Normal AsicPort 1 PortID 0e0800 ConfigType GL PortWWN 20:08:00:c0:dd:03:d5:94 DiagStatus Passed RunningType E EpConnState Connected MediaPartNumber PL-XPL-VC-SG3-22 EpIsoReason NotApplicable MediaRevision 1 IOStreamGuard Disabled MediaType 200-M5-SN
0 A – Command Line Interface Show Command The following is an example of the Show Switch command: SANbox Manager #> show switch Switch Information -----------------SymbolicName sw .108 SwitchWWN 100000c0dd00bc56 SwitchType SANbox 5200 Series BootVersion Vx.x.x.x-0 (day month date time year) CreditPool 0 DomainID 19 (0x13) FirstPortAddress 130000 FlashSize - MBytes 128 LogLevel Critical MaxPorts 20 NumberOfResets 15 ReasonForLastReset PowerUp ActiveImageVersion - build date Vx.x.x.
0 A – Command Line Interface Show Command The following is an example of the Show Topology command for port 1: SANbox Manager #> 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.
0 A – Command Line Interface Show Command The following is an example of the Show Version command: SANbox Manager #> show version ***************************************************** * * * Command Line Interface SHell (CLISH) * * * ***************************************************** 59056-02 A SystemDescription SANbox 5200 Series FC Switch Eth0NetworkAddress 10.20.11.
0 A – Command Line Interface Show Config Command Show Config Command Displays switch, port, alarm threshold, and zoning for the current configuration. Authority None 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 [port_number] is omitted, all ports are specified. switch Displays configuration parameters for the switch.
0 A – Command Line Interface Show Config Command This an example of the Show Config Port command for a 10-Gbps port: SANbox Manager #> show config port 16 Configuration Name: default ------------------Port Number: 16 -----------AdminState Online LinkSpeed 10Gb/s PortType G SymbolicName 10G-16 DeviceScanEnabled True ForceOfflineRSCN False AutoPerfTuning False LCFEnabled False MFSEnabled False MSEnabled True IOStreamGuard Disabled VIEnabled False PDISCPingEnabled True The following
0 A – Command Line Interface Show Config Command The following is an example of the Show Config Threshold command: SANbox Manager #> show config threshold Configuration Name: default ------------ Threshold Configuration Information ----------------------------------ThresholdMonitoringEnabled False CRCErrorsMonitoringEnabled True RisingTrigger 25 FallingTrigger 1 SampleWindow 10 DecodeErrorsMonitoringEnabled True 1 A-78 RisingTrigger 25 FallingTrigger 0 SampleWindow 10 ISLMonitoringEnab
0 A – Command Line Interface Show Config Command The following is an example of the Show Config Zoning command: SANbox Manager #> show config zoning Configuration Name: default ------------------- Zoning Configuration Information -------------------------------- 59056-02 A InteropAutoSave True DefaultVisibility All A-79
A – Command Line Interface Show Log Command 0 Show Log Command Displays the contents of the log or the parameters used to create and display entries in the log. The log contains a maximum of 1200 entries. When the log reaches its entry capacity, subsequent entries overwrite the existing entries, beginning with the oldest.
0 A – Command Line Interface Show Log Command Zoning Monitors zoning conflict events. display [filter] Displays log events on the screen according to the component or severity level filter given by [filter]. [filter] can be one of the following: Info Displays all informative events. Warning Displays all warning events. Critical Displays all critical events. Eport Displays all events related to E_Ports. Mgmtserver Displays all events related to the management server.
0 A – Command Line Interface Show Log Command Examples The following is an example of the Show Log Component command: SANbox Manager #> show log component Current settings for log -----------------------FilterComponent NameServer MgmtServer Zoning Switch Blade Port Eport Snmp The following is an example of the Show Log Level command: SANbox Manager #> show log level Current settings for log -----------------------FilterLevel Info DisplayLevel Critical The following is an example of the Show Log Opt
0 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.
0 A – Command Line Interface Show Perf Command errors [port_number] Displays continuous error counts for the port group (0–15 or 16–19) that includes [port_number]. If you omit [port_number], ports 0–15 are displayed. Type “q” and press the Enter key to stop the display.
0 A – Command Line Interface Show Perf Command The following is an example of the Show Perf Byte command: SANbox Manager #> show perf byte Displaying bytes/sec (total)...
0 A – Command Line Interface Show Setup Command Show Setup Command Displays the current SNMP and system settings. Authority None 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.
0 A – Command Line Interface Show Setup Command The following is an example of the Show Setup Snmp command: SANbox Manager #> show setup snmp SNMP Information ---------------- 59056-02 A SNMPEnabled True Contact Location N_107 System Test Lab Description SANbox 5200 Series FC Switch Trap1Address 10.0.0.254 Trap1Port 162 Trap1Severity warning Trap1Version 2 Trap1Enabled False Trap2Address 0.0.0.
0 A – Command Line Interface Show Setup Command The following is an example of the Show Setup System command: SANbox Manager #> show setup system System Information ------------------ A-88 Eth0NetworkDiscovery Static Eth0NetworkAddress 10.20.11.32 Eth0NetworkMask 255.255.252.0 Eth0GatewayAddress 10.20.8.254 AdminTimeout 30 InactivityTimeout 0 LocalLogEnabled True RemoteLogEnabled False RemoteLogHostAddress 10.0.0.254 NTPClientEnabled True NTPServerAddress 51.68.85.
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 session Syntax Notes shutdown Always use this command to perform an orderly shut down before removing power from the switch. When the shutdown is complete, the Heartbeat LED is extinguished.
0 A – Command Line Interface Test Command Test Command Tests ports using internal (SerDes level), external (transceiver), 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-37 for information about changing the port administrative state. While the test is running, the remaining ports on the switch remain fully operational.
0 Examples A – Command Line Interface Test Command To run an internal or external port test, do the following: 1. To start an admin session, enter the following command and press the Enter key. admin start 2. Place the port in Diagnostics mode, enter the following command (x = port number) and press the Enter key. set port x state diagnostics 3.
0 A – Command Line Interface Test Command 3. 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. The TestLength parameter is the number of frames sent, the FrameSize (256 byte maximum in some cases) parameter is the number of bytes in each frame, and the DataPattern parameter is the pattern in the payload.
0 A – Command Line Interface Uptime Command Uptime Command Displays the elapsed up time since the switch was last reset and reset method. A hot reset or non-disruptive firmware activation does not reset the elapsed up time reported by this command.
A – Command Line Interface User Command 0 User Command Administers and displays user accounts. Authority Admin account name and an Admin session. The Accounts and List keywords are available to all account names without an Admin session. Syntax user accounts add delete [account_name] edit list Keywords accounts Displays all user accounts that exist on the switch. This keyword is available to all account names without an Admin session. add Add a user account to the switch.
0 Examples A – Command Line Interface User Command The following is an example of the User Accounts command: SANbox Manager (admin) #> user accounts Current list of user accounts ----------------------------images (admin authority = False, never expires) admin (admin authority = True , never expires) chuckca (admin authority = False, expires in < 50 days) gregj (admin authority = True , expires in < 100 days) fred (admin authority = True , never expires) The following is an example of the User
0 A – Command Line Interface User Command The following is an example of the User Delete command: SANbox Manager (admin) #> user del user3 The user account will be deleted. Please confirm (y/n): [n] y The following is an example of the User List command: SANbox Manager (admin) #> user list A-96 User Ethernet Addr-Port Logged in Since ---- ------------------ --------------- admin@OB-session1 10.20.68.108-1031 day month date time year admin@OB-session2 10.20.68.
0 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 0 Zone Command Manages zones and zone membership on a switch. Authority Admin session and a Zoning Edit session. Refer to the ”Zoning Command” on page A-104 for information about starting a Zoning Edit session. The List, Members, and Zonesets keywords are available without an Admin session.
0 A – Command Line Interface Zone Command list Displays a list of all zones and the zone sets of which they are components. This keyword does not require an Admin session. members [zone] Displays all members of the zone given by [zone]. This keyword does not require an Admin session. remove [zone] [member_list] Removes the ports/devices given by [member_list] from the zone given by [zone]. Use a to delimit aliases and ports/devices in [member_list].
0 A – Command Line Interface Zone Command Examples The following is an example of the Zone List command: SANbox Manager #> 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: SANbox Manager #> zone members wwn_b0241f Current List of Members for Zone: w
0 A – Command Line Interface Zone Command The following is an example of the Zone Zonesets command: SANbox Manager #> zone zonesets zone1 Current List of ZoneSets for Zone: zone1 ---------------------------------zone_set_1 59056-02 A A-101
A – Command Line Interface Zoneset Command 0 Zoneset Command Manages zone sets and component zones across the fabric. Authority Admin session and a Zoning Edit session. Refer to the ”Zoning Command” on page A-104 for information about starting a Zoning Edit session. The Active, List, and Zones keywords are available without an Admin session. You must close the Zoning Edit session before using the Activate and Deactivate keywords.
0 A – Command Line Interface Zoneset Command list Displays a list of all zone sets. This keyword does not require an Admin session. remove [zone_set] [zone_list] Removes a list of zones given by [zone_list] from the zone set given by [zone_set]. Use a to delimit zone names in [zone_list]. If [zone_set] is the active zone set, the zone will not be removed until the zone set has been deactivated.
0 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-98 and the ”Zoneset Command” on page A-102. Authority Admin session except for the Active, History, Limits, and List keywords. Syntax zoning active cancel clear edit history limits list restore save Keywords active Displays information for the active zone set including component zones and zone members.
0 A – Command Line Interface Zoning Command limits Displays the number of zone sets, zones, aliases, members per zone, members per alias, and total members in the zoning database. This keyword also displays the switch zoning database limits, excluding the active zone set, which are described in Table A-17. This keyword does not require an Admin session. Table A-17.
0 A – Command Line Interface Zoning Command Examples The following is an example of the Zoning Edit command: SANbox Manager #> admin start SANbox Manager (admin) #> zoning edit SANbox Manager (admin-zoning) #> . . SANbox Manager (admin-zoning) #> zoning cancel Zoning edit mode will be canceled.
0 A – Command Line Interface Zoning Command The following is an example of the Zoning List command: SANbox Manager #> zoning list Active ZoneSet 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:bf:d2:18:d2 10:00:00:00:c9:22:14:16 wwn_2215c3 50:06:04:82:bf:d2:18:c2 50
0 A – Command Line Interface Zoning Command wwn_221416 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: A-108 59056-02 A
Glossary Access Control List Zone Access Control List zoning divides the fabric for purposes of controlling discovery and inbound traffic. Arbitrated Loop A Fibre Channel topology where ports use arbitration to establish a point-to-point circuit. Active Zone Set The zone set that defines the current zoning for the fabric. Arbitrated Loop Physical Address (AL_PA) A unique one-byte value assigned during loop initialization to each NL_Port on a loop.
0 SANbox 5200 Series Switch Management User’s Guide Class 3 Service A service which multiplexes frames at frame boundaries to or from one or more N_Ports without acknowledgment. Fabric View File A file containing a set of fabrics that were opened and saved during a previous SANsurfer Switch Manager session. Configured Zone Sets The zone sets stored on a switch excluding the active zone set. Fan Fail LED An LED that indicates that a cooling fan in the switch is operating below standard.
0 SANbox 5200 Series Switch Management User’s Guide In-Order-Delivery A feature that requires that frames be received in the same order in which they were sent. Mesh Topology A fabric in which each chassis has at least one port directly connected to each other chassis in the fabric. Input Power LED A chassis LED that indicates that the switch logic circuitry is receiving proper DC voltages. MIB Management Information Base Inter-Switch Link The connection between two switches using E_Ports.
SANbox 5200 Series Switch Management User’s Guide Small Form-Factor Pluggable A transceiver device, smaller than a GigaBit Interface Converter, that plugs into the Fibre Channel port. 0 Zoning Database The set of zone sets, zones, and aliases stored on a switch. SNMP Simple Network Management Protocol Soft Zone 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.
Index A access control list zone 3-22, 3-37 account name display A-97 factory A-2 active zone set 3-16, 3-22 Active Zoneset data window 3-16 Admin account name A-7 authority A-7 Admin command A-8 administrative state configured 4-18, 5-11 current 4-18, 5-11 port 5-11, A-54 switch 4-18, A-38 alarm configuration 4-13, A-45 configuration display A-76 log A-37, A-61 alias add members 3-38, A-9 copy A-9 create 3-37, A-9 delete A-9 delete members A-10 description 3-22 display list A-9 display members A-10 remove
0 SANbox 5200 Series Switch Management User’s Guide database fabric 3-4 zoning 3-25 Date command A-16 Decode error 4-13 default configuration 4-31 visibility 3-29, 3-32 zoning 3-30 default fabric view file auto save 2-14 SANsurfer Switch Manager 2-14 Detailed 3-17 device scan 5-13 Devices data window 3-15, 4-8 distance 5-14 domain ID description 4-19 display A-62 lock 4-19 donor port 5-2, 5-13, A-62 Dynamic Host Configuration Protocol 4-24 E E_Port isolation 3-39, 4-19 Error Detect Timeout 4-22 event bro
0 SANbox 5200 Series Switch Management User’s Guide non-disruptive activation 4-35, A-22 remove image files A-23 retrieve image file A-23 unpack image A-23 version A-67 Firmware Install command A-18 FL_Port 5-2, 5-12 G gateway address 4-24 generic port 5-2, 5-12 graphic window 2-25 H hard reset 4-16, A-19 Hardreset command A-19 help 2-16 Help command A-20 History command A-21 host bus adapter A-62 hot reset 4-16, A-22 Hotreset command A-22 I I/O Stream Guard 5-13, A-42 Image command A-23 inactivity tim
0 SANbox 5200 Series Switch Management User’s Guide O online help 2-16 test 5-17, A-90 orphan zone set 3-22 P page break A-37 Passwd command A-27 password change A-27 default fabric file 5-21 default fabric view file 2-13 factory A-2 switch A-27 user account 4-5 performance graphs 5-22 tuning A-41 Ping command A-28 popup menu 2-28 port administrative state 5-11, A-54 buffer credits 5-14 configuration 5-10, A-39 configuration display A-76 counters A-54 displaying information 5-1 external test A-90 initial
0 Linux 2-2, 2-5 Solaris 2-2, 2-6 Windows 2-2, 2-3 scan device 5-13 SerDes level test 5-16 Set command A-37 Set Config command A-39 Set Log command A-51 Set Port command A-54 Set Setup command A-56 severity levels 3-12 SFP level test 5-16 Show command A-61 Show Config command A-76 Show Log command A-80 Show Perf command A-83 Show Setup command A-86 Shutdown command A-89 Simple Network Management Protocol configuration 4-27, A-56 configuration display A-86 enabled 4-27 proxy 4-27 reset A-31 trap configuratio
0 SANbox 5200 Series Switch Management User’s Guide factory A-2 logged in A-67 modify 4-6 password 4-5 remove 4-4 security 3-1 User command A-94 V version 2-16 Virtual Interface preference routing A-41 W web applet A-58 Whoami command A-97 working directory 2-14, 5-21 status indicator 2-25 write community 4-27 Z zone access control list 3-22 add member port 3-35, A-98 copy 3-32, A-98 create 3-34, A-98 definition 3-21 delete A-98 delete member port A-99 list A-99 list members A-99 name server 3-21 remov
