0 Simplify SANbox2-8c/16 Switch Management User’s Guide Firmware Version 5.
0 SANbox2-8c/16 Switch Management User’s Guide Information furnished in this manual is believed to be accurate and reliable. However, QLogic Corporation assumes no responsibility for its use, nor for any infringements of patents or other rights of third parties which may result from its use. QLogic Corporation reserves the right to change product specifications at any time without notice. Applications described in this document for any of these products are for illustrative purposes only.
Table of Contents Section 1 Introduction 1.1 1.2 1.3 1.4 1.4.1 1.4.2 1.4.3 Intended Audience ............................................................................................. 1-1 Related Materials ............................................................................................... 1-1 JDOM License.................................................................................................... 1-2 Technical Support..................................................................
SANbox2-8c/16 Switch Management User’s Guide 0 2.11 2.11.1 2.11.1.1 2.11.1.2 2.11.1.3 2.11.2 2.11.3 2.11.4 2.11.5 2.11.6 2.12 2.12.1 2.12.2 2.12.2.1 2.12.2.2 2.12.3 2.12.4 2.13 2.13.1 2.13.2 2.13.2.1 2.13.2.2 2.13.3 SANsurfer Switch Manager User Interface ...................................................... 2-19 Menu Bar ................................................................................................. 2-20 Topology Display Menu ...........................................................
0 3.2 3.2.1 3.2.2 3.2.3 3.2.4 3.2.4.1 3.2.4.2 3.2.4.3 3.2.4.4 3.2.4.5 3.2.4.6 3.2.4.7 3.2.4.8 3.2.4.9 3.2.4.10 3.2.4.11 3.2.4.12 3.2.4.13 3.2.4.14 3.2.5 3.2.5.1 3.2.5.2 3.3 3.3.1 3.3.2 3.3.3 3.4 3.4.1 3.4.2 3.4.3 3.4.4 3.4.5 3.4.6 3.4.7 3.4.8 59022-11 A SANbox2-8c/16 Switch Management User’s Guide Securing a Fabric ............................................................................................... 3-7 Connection Security ........................................................................
SANbox2-8c/16 Switch Management User’s Guide 0 3.5 3.5.1 3.5.2 3.5.2.1 3.5.2.2 3.5.2.3 3.5.3 3.5.4 3.5.5 3.6 3.6.1 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 Displaying Fabric Information........................................................................... 3-26 Fabric Status............................................................................................ 3-27 Displaying the Event Browser..................................................................
0 3.7 3.7.1 3.7.1.1 3.7.1.2 3.7.1.3 3.7.1.4 3.7.2 3.7.3 3.7.3.1 3.7.3.2 3.7.3.3 3.7.3.4 3.7.3.5 3.7.3.6 3.7.4 3.7.4.1 3.7.4.2 3.7.4.3 3.7.4.4 3.7.4.5 3.7.5 3.7.5.1 3.7.5.2 3.7.5.3 3.7.5.4 3.7.5.5 3.7.5.6 3.7.5.7 3.7.6 3.7.6.1 3.7.6.2 3.7.6.3 3.7.7 3.7.7.1 3.7.7.2 59022-11 A SANbox2-8c/16 Switch Management User’s Guide Zoning a Fabric ................................................................................................ 3-37 Zoning Concepts .......................................................
SANbox2-8c/16 Switch Management User’s Guide 0 Section 4 Managing Switches 4.1 4.1.1 4.1.2 4.1.3 4.1.4 4.2 4.2.1 4.2.2 4.2.3 4.2.4 4.2.5 4.3 4.4 4.5 4.6 4.7 4.7.1 4.7.2 4.7.2.1 4.7.2.2 4.7.2.3 4.7.2.4 4.7.2.5 4.7.2.6 4.7.3 4.7.3.1 4.7.3.2 4.7.3.3 4.7.4 4.7.5 4.7.6 4.7.6.1 4.7.6.2 4.7.6.3 4.7.7 4.7.7.1 4.7.7.2 4.8 Managing User Accounts ................................................................................... 4-2 Creating User Accounts...........................................................
0 SANbox2-8c/16 Switch Management User’s Guide 4.9 4.10 4.11 4.12 4.13 Restoring a Switch ........................................................................................... 4-36 Restoring the Factory Default Configuration .................................................... 4-38 Downloading a Support File ............................................................................. 4-39 Installing Firmware ..........................................................................................
SANbox2-8c/16 Switch Management User’s Guide 0 Appendix A Command Line Interface A.1 A.2 A.3 A.3.1 A.3.2 A.4 Page x Logging On to a Switch ......................................................................................A-1 User Accounts ....................................................................................................A-2 Working with Switch Configurations ...................................................................A-2 Modifying a Configuration..............................
0 SANbox2-8c/16 Switch Management User’s Guide Show Setup Command.......................................................................... A-111 Shutdown Command ............................................................................. A-115 Test Command ...................................................................................... A-116 Uptime Command.................................................................................. A-119 User Command .........................................
0 SANbox2-8c/16 Switch Management User’s Guide Figures Figure Page 2-1 Initial Startup Dialog ..................................................................................................... 2-10 2-2 SANsurfer Switch Manager Window ............................................................................ 2-11 2-3 Save Default Fabric View File Dialog........................................................................... 2-12 2-4 Load Default Fabric File Dialog...................................
0 5-1 5-2 5-3 5-4 5-5 5-6 5-7 5-8 5-9 SANbox2-8c/16 Switch Management User’s Guide Faceplate Display - Port Information.............................................................................. 5-1 Port Properties Dialog .................................................................................................. 5-10 Designate Donor Ports................................................................................................. 5-15 Port Loopback Test Dialog................................
SANbox2-8c/16 Switch Management User’s Guide A-10 A-11 A-12 A-13 A-14 A-15 A-16 A-17 A-18 A-19 A-20 A-21 A-22 A-23 A-24 A-25 A-26 A-27 A-28 A-29 0 Port Configuration Defaults ..........................................................................................A-47 Port Threshold Alarm Configuration Defaults...............................................................A-48 Zoning Configuration Defaults......................................................................................
Section 1 Introduction This manual describes the switch management tools which include the SANsurfer Switch Manager™ application (version 5.00) and the Command Line Interface (CLI) for the SANbox2 Fibre Channel switch (firmware version 5.0). The SANsurfer Switch Manager switch management application is the primary focus of this manual which is organized as follows: Section 1 describes the intended audience for this manual, related materials, and technical support.
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 59022-11 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 Workstation Requirements 2.1 Workstation Requirements The requirements for fabric management workstations running SANsurfer Switch Manager are described in Table 2-1: Table 2-1. Workstation Requirements Operating System Memory 256 MB or more Disk Space 150 MB per installation Processor 500 MHz or faster Hardware CD-ROM drive, RJ-45 Ethernet port, RS-232 serial port (optional) Internet Browser Microsoft® Internet Explorer® 5.
0 2 – Using SANsurfer Switch Manager Installing the Management Application 2.2.1 SANsurfer Switch Manager You can install SANsurfer Switch Manager on a Windows, Linux, Solaris, or Mac OS X workstation. To install the SANsurfer Switch Manager application from the SANsurfer Switch Manager Installation Disk, do the following: For a Windows platform: 1. Close all programs currently running, and insert the SANsurfer Switch Manager Installation Disk into the management workstation CD-ROM drive. 2.
2 – Using SANsurfer Switch Manager Installing the Management Application 0 For a Mac OS X platform: 1. Open the CD and move to the following folder: data/files/Management_Software/MacOSX 2. Double click the applicaton zip file (MacOSX_5.00.xx_xxxx.zip). This will place the install program on your desktop. 3. Locate the Install program icon on your desktop, execute it, and follow the installation instructions. 2.2.
0 2 – Using SANsurfer Switch Manager Installing the Management Application 6. You can run the installation file from the CD-ROM or download the installation file to your hard drive. Choose one of the following: Open the installation file from the CD-ROM and follow the SANsurfer Switch Manager installation instructions. Specify a location in which to save the sansurfer_windows_install.exe file, and click the Save button. Double-click the saved sansurfer_windows_install.
0 2 – Using SANsurfer Switch Manager Installing the Management Application 2.2.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 (5.00.
0 2 – Using SANsurfer Switch Manager Installing the Management Application 3. On the SANbox Switch Software page, scroll to the SANbox2-8c/16 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.
0 2 – Using SANsurfer Switch Manager Starting SANsurfer Switch Manager 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-23. Click the Start Application Without Specifying a Fabric radio button to open the SANsurfer Switch Manager window shown in Figure 2-2.
2 – Using SANsurfer Switch Manager Exiting SANsurfer Management Suite 0 2.4 Exiting SANsurfer Management Suite To exit a SANsurfer Switch Manager application session, open the File menu and select Exit. If you have not yet defined an encryption key, the Save Default Fabric View File dialog, shown in Figure 2-3, prompts you to save the current fabric view as the default fabric view file. Enter an encryption key in the Default Fabric File Encryption Key field.
0 2 – Using SANsurfer Switch Manager Uninstalling SANsurfer Switch Manager In your next SANsurfer Switch Manager session, the Load Default Fabric File dialog shown in Figure 2-4 prompts you to load the default fabric view file and to specify its encryption key, if there is one. In the Default Fabric File Encryption Key field, enter the encryption key and click the Load View File button.
2 – Using SANsurfer Switch Manager Uninstalling SANsurfer Switch Manager 0 2.5.1 SMS Uninstall A program to uninstall SANsurfer Management Suite was included as part of the SANsurfer Management Suite installation process. Use this method only if you installed SANsurfer Switch Manager as part of SANsurfer Management Suite. The UninstallData folder in the installation directory contains the uninstall program, SANsurferUninstaller.
0 2 – Using SANsurfer Switch Manager Changing the Encryption Key for the Default Fabric View File 2.5.2 Standalone Uninstall A program to uninstall SANsurfer Switch Manager was included as part of the 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_SANsurfer_Switch_Manager.
0 2 – Using SANsurfer Switch Manager Saving and Opening Fabric View Files 2.7 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-28. If the Event Browser is enabled using the Preferences dialog 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.9 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 clicking the Help button in the dialog. 2.
0 2 – Using SANsurfer Switch Manager SANsurfer Switch Manager User Interface 2.11 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.11.1 Menu Bar The SANsurfer Switch Manager menus and the tasks offered in them vary depending on the display. For example, the Port menu and many of the Switch menu selections are only available in the faceplate display. 2.11.1.1 Topology Display Menu The menu options 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.11.1.2 Faceplate Display Menu The menu options 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.
0 2 – Using SANsurfer Switch Manager SANsurfer Switch Manager User Interface 2.11.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-2. 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-2.
0 2 – Using SANsurfer Switch Manager SANsurfer Switch Manager User Interface 2.11.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.
2 – Using SANsurfer Switch Manager SANsurfer Switch Manager User Interface 0 2.11.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. The window height can be adjusted by clicking and dragging the window border that it shares with the data window. 2.11.5 Data Window and Tabs The data window presents a table of data and statistics associated with the selected tab.
0 2 – Using SANsurfer Switch Manager Using the Topology Display 2.12 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: Using the Topology Display Working with Switches and Links Topology Data Windows Figure 2-10. Topology Display 2.12.
2 – Using SANsurfer Switch Manager Using the Topology Display 0 2.12.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 and graphic window. 2.12.2.
0 2 – Using SANsurfer Switch Manager Using the Topology Display 2.12.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.
2 – Using SANsurfer Switch Manager Using the Faceplate Display 0 2.13 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 Faceplate Data Windows Figure 2-11. Faceplate Display 2.13.1 Port Views and Status Port color and text provide information about the port and its operational state.
0 2 – Using SANsurfer Switch Manager Using the Faceplate Display 2.13.2 Working with Ports Ports are selectable and serve as access points for other displays and menus. You select ports to display information about them in the data window or to modify them. Context-sensitive popup menus and properties dialogs are displayed when you right-click the faceplate image or port icons in the faceplate display. 2.13.2.1 Selecting Ports You can select ports in the following ways.
2 – Using SANsurfer Switch Manager Using the Faceplate Display 0 2.13.2.2 Opening the Faceplate Popup Menu To open the popup menu, right-click the faceplate image to present the following tasks.
0 2 – Using SANsurfer Switch Manager Using the Faceplate Display 2.13.3 Faceplate Data Windows The faceplate display provides the following data windows corresponding to the data window tabs: 59022-11 A Devices – displays information about devices (hosts and storage targets) connected to the switch. Switch – displays current switch configuration data. Port Statistics – displays performance data for the selected ports. Port Information – displays information for the selected ports.
2 – Using SANsurfer Switch Manager Using the Faceplate Display 0 Notes 2-32 59022-11 A
Section 3 Managing Fabrics This section describes the following tasks that manage fabrics: RADIUS Servers Securing a Fabric Tracking Fabric Firmware and Software Versions Managing the Fabric Database Displaying Fabric Information Working with Device Information and Nicknames Zoning a Fabric 3.1 RADIUS Servers Remote Authentication Dial In User Service (RADIUS) provides a method to centralize the management of authentication passwords in larger networks.
0 3 – Managing Fabrics RADIUS Servers 3.1.1 Adding a RADIUS Server When you add a RADIUS server, you provide a method to centralize the management of authentication passwords over a network. Figure 3-1. Add Server To add a RADIUS server, do the following: 3-2 1. Open the faceplate display, open the Switch menu, and select Radius Servers.... 2. In the Radius Server Information dialog, shown in Figure 3-1, click the Add Server tab. 3. Select the server type (Device, User, Account). 4.
0 59022-11 A 3 – Managing Fabrics RADIUS Servers 7. In the Retries field, enter the the number of retries. This is the maximum number of times the RADIUS client will retry a request sent to the primary RADIUS server. 8. Select the Sign Packet check box to enable the switch to include a digital signature (Message-Authenticator) in all RADIUS access request packets sent to the RADIUS server. A valid Message-Authenticator attribute will be required in all RADIUS server responses. 9.
0 3 – Managing Fabrics RADIUS Servers 3.1.2 Removing a RADIUS Server When you remove a RADIUS server, you disable the management of authentication usernames and passwords over the network for that server. Figure 3-2. Remove Server To remove a RADIUS server, do the following: 3-4 1. Open the faceplate display, open the Switch menu, and select Radius Servers.... 2. In the Radius Server Information dialog, shown in Figure 3-2, click the Remove Server tab. 3.
0 3 – Managing Fabrics RADIUS Servers 3.1.3 Editing RADIUS Server Information Editing information of a RADIUS server involves changing the configuration of a RADIUS server. Figure 3-3. Edit Radius Server Information To edit information of a RADIUS server, do the following: 59022-11 A 1. Open the faceplate display, open the Switch menu, and select Radius Servers.... 2. In the Radius Server Information dialog, shown in Figure 3-3, click the Edit Server tab. 3.
0 3 – Managing Fabrics RADIUS Servers 3.1.4 Modifying Authentication Order RADIUS Server Information Editing information of a RADIUS server involves changing the configuration of a RADIUS server. Figure 3-4. Modify Authentication Order - Radius Server Information To modify the authentication order information of a RADIUS server, do the following: 3-6 1. Open the faceplate display, open the Switch menu, and select Radius Servers.... 2.
0 3 – Managing Fabrics Securing a Fabric 3.2 Securing a Fabric Fabric security consists of the following: Connection Security User Account Security Security Consistency Checklist Device Security Fabric Services 3.2.1 Connection Security Connection security provides an encrypted data path for switch management methods.
0 3 – Managing Fabrics Securing a Fabric 3.2.2 User Account Security User account security is the process by which your user account and password are authenticated with the list of valid user accounts and passwords. The switch validates your account and password when you attempt to add a fabric using SANsurfer Switch Manager or log in to a switch through Telnet. Your system administrator defines accounts, passwords, and authority levels that are stored on the switch.
0 3 – Managing Fabrics Securing a Fabric 3.2.4 Device Security Device security provides for the authorization and authentication of devices that you attach to a switch. You can configure a switch with a group of devices against which the switch authorizes new attachments by devices, other switches, or devices issuing management server commands. Device security is configured through the use of security sets and groups. A group is a list of device worldwide names that are authorized to attach to a switch.
0 3 – Managing Fabrics Securing a Fabric 3.2.4.1 Edit Security Dialog The Edit Security dialog, shown in Figure 3-5 opens after clicking the Security button on the toolbar or selecting Edit Security from the Security menu. The Security dialogs are available only on a secure (SSL) fabric and on the entry switch (out of band switch). The primary use of the Edit Security dialog is to edit the security configuration on the switch. You can also open and edit a security configuration saved to a file.
0 3 – Managing Fabrics Securing a Fabric Use the File menu to: Edit the security configuration on the switch. Open or edit security files.
0 3 – Managing Fabrics Securing a Fabric 3.2.4.3 Create Security Group Dialog Use the Create Security Group dialog, shown in Figure 3-6, to add a security group to a security set. The Create Security Group dialog is displayed after clicking the Security Group button on the toolbar, or after you right-click on a security set in the graphic window and select Create a Security Group from the popup menu. Figure 3-6.
0 3 – Managing Fabrics Securing a Fabric 3.2.4.4 Creating a Security Group An empty (no members) security group in the active security set will prevent all connections for that security group type. For example, an empty ISL security group will cause the switch to refuse all logins from other switches. To add a security group to a security set, do the following: 1.
0 3 – Managing Fabrics Securing a Fabric 3.2.4.5 Create Security Group Member Dialog Use the Create Security Group Member dialog, shown in Figure 3-7, to add a member to a security group. Choose options from the Group Member (or manually type in a hex value) and Authentication pull-down menus, and enter values in the Secret and Binding (ISL groups only) fields. Figure 3-7.
0 3 – Managing Fabrics Securing a Fabric The conventions for MS security group members are listed below: You can enter member world-wide name (WWN), which must be 16 hex characters, or 23 characters with valid WWN format xx:xx:xx:xx:xx:xx:xx:xx. The CT (common transport) authentication choices are None, MD5, and SHA-1. The Secret field is disabled if authentication is set to None, otherwise the Secret field enabled. The Generate button is only enabled when authentication is Chap.
0 3 – Managing Fabrics Securing a Fabric 3.2.4.7 Editing the Security Configuration on a Switch To edit a security configuration on the switch, do the following: 3-16 1. On the faceplate display, click the Security button on the toolbar, or open the Security menu and select Edit Security to open the Edit Security dialog. By default, the security configuration on the switch is displayed in the Edit Security dialog.
0 3 – Managing Fabrics Securing a Fabric 3.2.4.8 Viewing Properties of a Security Set, Group, or Member To view the properties of a security set, group, or member, do the following: 1. On the faceplate display and click the Security button on the toolbar, or open the Security menu and select Edit Security to open the Edit Security dialog. 2. Choose one of the following: 3. Select a security set, group, or member, open the Edit menu and select Properties.
0 3 – Managing Fabrics Securing a Fabric Note: The fabric binding feature must be enabled on all switches in the fabric. When enabling this feature, it is best to set the switch state to offline, enable the fabric binding feature on all switches, and then set the switch state to online. 4. Click the Apply button to save the settings. 5. Click the OK button to close the Security Config dialog. 3.2.4.
0 3 – Managing Fabrics Securing a Fabric 3.2.4.13 Configured Security Data Window The Configured Security data window displays a graphical representation of all security sets, groups, and members in the database. To open the Configured Security data window, click the Configured Security tab below the data window in the faceplate display. 3.2.4.
0 3 – Managing Fabrics Tracking Fabric Firmware and Software Versions 3.2.5.2 Enabling In-band Management To enable In-band Management, do the following: 1. On the faceplate display, open the Switch menu and select Switch Properties to open the Switch Properties dialog. 2. Click the In-band Management Enable button. 3. Click the OK button to save the change to the database. 3.
0 3 – Managing Fabrics Tracking Fabric Firmware and Software Versions 3.3.2 Viewing and Comparing Version Snapshots The Differences tab page shows a side-by-side comparison of two snapshots. The timestamp of each snapshot is displayed above the scroll area showing that snapshot. The background color of the older snapshot is darker than the background of the newer snapshot. The arrow icon between the snapshot selectors always points from the older snapshot to the newer one.
3 – Managing Fabrics Managing the Fabric Database 0 3.4 Managing the Fabric Database A fabric database contains the set of fabrics that you have added during a SANsurfer Switch Manager session. Initially, if you do not open an existing fabric or fabric view file, the SANsurfer Switch Manager application opens with an empty fabric database. 3.4.1 Adding a Fabric To add a fabric to the database, do the following: 1.
0 3 – Managing Fabrics Managing the Fabric Database Note: A switch supports a combined maximum of 19 logins or sessions reserved as follows: 4 logins or sessions for internal applications such as management server and SNMP 9 high priority Telnet sessions 6 logins or sessions for SANsurfer Switch Manager inband and out-of-band logins, Application Programming Interface (API) inband and out-of-band logins, and Telnet logins. Additional logins will be refused. 4. Click the Add Fabric button.
0 3 – Managing Fabrics Managing the Fabric Database 3.4.4 Saving a Fabric View File To save a fabric view file, do the following: 1. Open the File menu, and select Save View As. 2. In the Save View dialog, enter a new file name. 3. Enter a file password, if necessary. 4. Click the OK button. 3.4.5 Rediscovering a Fabric After making changes to or deleting switches from a fabric view, it may be helpful to again view the actual fabric configuration.
0 3 – Managing Fabrics Managing the Fabric Database 5. Configure the port types for the new switch using the Port Properties dialog. The ports can be G_Port, GL_Port, F_Port, FL_Port, or Donor. 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. If you changed the Default Visibility setting in the Zoning Config dialog from All to None, change that setting back to All.
3 – Managing Fabrics Displaying Fabric Information 4. 0 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.5.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.5.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-11, 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 a "serviceable event". This means that attention by the user or field service is required. Alarms are posted asynchronously to the screen and cannot be turned off.
0 3 – Managing Fabrics Displaying Fabric Information 3.5.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-12. The Event Browser displays those events that meet all of the criteria in the Filter Events dialog.
0 3 – Managing Fabrics Displaying Fabric Information 3.5.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.5.3 Devices Data Window The Devices data window displays information about the devices that are logged into the fabric. 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.5.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.
3 – Managing Fabrics Working with Device Information and Nicknames 0 3.5.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 icon. 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.6.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. Select the extension for the type of output file (CSV or text format) to be saved.
0 3 – Managing Fabrics Working with Device Information and Nicknames 3.6.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. Click the OK button to save the changes.
0 3 – Managing Fabrics Zoning a Fabric 3.6.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.7.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.
0 3 – Managing Fabrics Zoning a Fabric 3.7.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.7.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.7.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 zone the two most typical reasons for zoning: Zoning Windows servers storage Assign storage to servers.
0 3 – Managing Fabrics Zoning a Fabric 3.7.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-15. 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-15.
0 3 – Managing Fabrics Zoning a Fabric The Edit Zoning dialog has a Zone Sets tree on the left and a Port/Device (or members) tree on the right. Both trees use display conventions similar to the fabric tree for expanding and contracting zone sets, zones, and ports. An expanded port shows the port Fibre Channel address; an expanded address shows the port World Wide Name. You can select zone sets, zones, and ports in the following ways: Click a zone, zone set, or port icon.
0 3 – Managing Fabrics Zoning a Fabric Table 3-4. Edit Zoning Dialog Tool Bar Buttons and Icons (Continued) Tool Bar Button Description Switch port icon – not logged in Switch port icon – logged in NL_Port (loop) device icon – logged in to fabric NL_Port (loop) device icon – not logged in to fabric N_Port device icon – logged in to fabric N_Port device icon – not logged in to fabric 3.7.3.
0 3 – Managing Fabrics Zoning a Fabric 3.7.3.2.1 Interop Auto Save The Interop Auto Save parameter determines whether changes to the active zone set that a switch receives from other switches in the fabric will be saved to the zoning database on that switch. Changes are saved when an updated zone set is activated. Zoning changes are always saved to temporary memory.
0 3 – Managing Fabrics Zoning a Fabric 3.7.3.4 Restoring the Zoning Database from a File CAUTION! Restoring the zoning database from a file will replace the current zoning database on the switch. Do the following to restore the zoning database from a file to a switch: 1. In the faceplate display, open the Zoning menu and select Edit Zoning to open the Edit Zoning window. 2. Open the File menu and select Open File. A popup window will prompt you to select an XML zoning database file. 3.
0 3 – Managing Fabrics Zoning a Fabric 3.7.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 4. 5. To create new zones in a zone set, do one of the following: Right-click a zone set and select Create A Zone from the popup menu. In the Create a Zone dialog, enter a name for the new zone, and click the OK button. The new zone name is displayed in the Zone Sets dialog. Select a zone set in the zone sets tree, and click the Zone button in the Zoning toolbar. In the Create a Zone dialog, enter a name for the new zone, and click the OK button.
0 3 – Managing Fabrics Zoning a Fabric 3.7.4.4 Removing a Zone from a Zone Set or from All Zone Sets You can remove a zone from a zone set or from all zone sets in the database. 1. In the faceplate display, open the Zoning menu and select Edit Zoning to open the Edit Zoning dialog. 2. In the Zone Sets tree, select the zone(s) to be removed. 3. Open the Edit menu, and select Remove to remove the zone from the zone set, or select Remove from All Zones to remove the zone from all zone sets. 4.
0 3 – Managing Fabrics Zoning a Fabric 3.7.5 Managing Zones Managing zones involves the following: Creating a Zone in a Zone Set Adding Zone Members Renaming a Zone or a Zone Set Removing a Zone Member Removing a Zone from a Zone Set Removing a Zone from All Zone Sets Changing Zone Types Note: Changes that you make to the zoning database are limited to the managed switch and do not propagate to the rest of the fabric.
0 3 – Managing Fabrics Zoning a Fabric 5. 6. To add switch ports or attached devices to the zone, do one of the following: In the zone set tree, select the zone set. In the graphic window, select the port to add to the zone. Open the Edit menu and select Add Members. Select a port by port number, Fibre Channel address, or World Wide Name in the Port/Device tree, and drag it into the zone. Select a port by port number, Fibre Channel address, or World Wide Name in the Port/Device tree.
0 3 – Managing Fabrics Zoning a Fabric 3. Click the OK button to add the member and save the change. Note: Domain ID conflicts can result in automatic reassignment of switch domain IDs. These reassignments are not reflected in zones that use domain ID/port number pair to define their membership. Be sure to reconfigure zones that are affected by a domain ID change. 3.7.5.3 Renaming a Zone or a Zone Set To rename a zone, do the following: 1.
0 3 – Managing Fabrics Zoning a Fabric 3.7.5.6 Removing a Zone from All Zone Sets Zones that are no longer members of any zone set are moved to the orphan zone set. The orphan zone set is saved on the switch. To remove a zone from all zone sets including the orphan zone set, do the following: 1. In the Edit Zoning dialog, select the zone to be removed. 2. Open the Edit menu and select Remove Zone from All Sets. 3. Click the OK button to save changes and close the Edit Zoning dialog. 3.7.5.
0 3 – Managing Fabrics Zoning a Fabric 3.7.6.1 Creating an Alias To create an alias, do the following: 1. Open the Zoning menu, and select Edit Zoning to open the Edit Zoning dialog. 2. Open the Edit menu, and select Create Alias to open the Create Alias dialog. 3. Enter a name for the alias, and click the OK button. The alias name is displayed in the Zone Sets dialog. An alias name must begin with a letter and be no longer than 64 characters. Valid characters are 0-9, A-Z, a-z, _, $, ^, and -. 4.
0 3 – Managing Fabrics Zoning a Fabric If the port/device you want to add is not in the Port/Device tree, you can add it by doing the following: 3. a. Right click the selected alias. b. Open the Edit menu and select Create Members. c. Choose the WWN, Domain/Port, or First Port Address radio button. d.
0 3 – Managing Fabrics Zoning a Fabric 3.7.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 59022-11 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 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 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 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. Click an Account Expiration Date radio button.
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 SANbox2-8c and SANbox2-16 switches. Figure 4-5.
0 4 – Managing Switches Displaying Switch Information The fabric updates the topology and faceplate displays by forwarding changes in status to the management workstation as they occur. You can allow the fabric to update the switch status, or you can refresh the display at any time. To refresh switch status in the display, do one of the following: Click the Refresh button. Open the View menu and select Refresh. Press the F5 key.
0 4 – Managing Switches Displaying Switch Information Table 4-2.
0 4 – Managing Switches Displaying Switch Information Table 4-2. Switch Data Window Entries (Continued) Entry 4-10 Description Interop Mode Zoning merge status. When a zone set is activated on an FC-SW-2 compliant switch, only the active zone set is propagated to all switches in the fabric. When a zone set is activated on a non-FC-SW-2 compliant switch, the active zone set and all inactive zone sets (the entire zoning database) are stored in permanent memory.
0 4 – Managing Switches Displaying Switch Information Table 4-2. Switch Data Window Entries (Continued) Entry 59022-11 A Description Warning Temperature Non-configurable temperature threshold (65° Celsius) above which a warning condition alarm is generated. Failure Temperature Non-configurable temperature threshold (70° Celsius) above which a failure condition alarm is generated. NTP Client Enabled Enabled or disabled. Allows for switches to synchronize their time a centralized server.
0 4 – Managing Switches Displaying Switch Information Table 4-2. Switch Data Window Entries (Continued) Entry Description CIM Enabled Common Information Model status. The CIM agent is based on the SNIA Storage Management Initiative Specification (SMI-S), which is the standard for SAN management in a heterogeneous environment. FTP Enabled FTP status Management Server Enabled Management server status. 4.2.
0 4 – Managing Switches Displaying Switch Information 4.2.4 Port Information Data Window The Port Information data window displays port detail information for the selected ports. To open the Port Statistics data window, click the Port Info tab below the data window in the faceplate display. Refer to Table 5-6 for a description of the Port Information data window entries. Figure 4-6.
4 – Managing Switches Displaying Switch Information 0 4.2.5 Configured and Active Zonesets Data Window The Configured Zonesets data window displays all zone sets, zones, aliases, and zone membership in the zoning database, as shown in Figure 4-7. To open the Configured Zonesets data window, click the Configured Zonesets tab below the data window in the faceplate display.
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-9. 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, time, and time zone on a switch, or to enable the 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 Common administrative operations that change the fabric include: Zoning modifications. Adding, moving or removing devices attached to the switch fabric. This includes powering up or powering down attached devices. Adding, moving or removing ISLs or other connections. Management Interfaces: After an NDCLA operation is complete, management connections must be re-initiated: SANsurfer Switch Manager sessions will re-connect automatically.
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 4.7.2 Switch Properties To open the Switch Properties dialog, either select a switch in the topology display or open the faceplate display for the switch you be configuring, and then open the Switch menu and select Switch Properties. You may also right-click a switch graphic in the topology display or faceplate display, and select Switch Properties from the popup menu.
0 4 – Managing Switches Configuring a Switch 4.7.2.1 Symbolic Name The symbolic name is a user-defined name of up to 32 characters that identifies the switch. The symbolic name is used in the topology and faceplate displays, as well as many data windows to more easily identify switches. The illegal characters are the pound sign (#), semi-colon (;), and comma (,). 4.7.2.2 Switch Administrative States The switch administrative state determines the operational state of the switch.
0 4 – Managing Switches Configuring a Switch 4.7.2.3 Domain ID and Domain ID Lock The domain ID is a unique Fibre Channel identifier for the switch. The Fibre Channel address consists of the domain ID, port ID, and the Arbitrated Loop Physical Address (ALPA). The maximum number of switches within a fabric is 239 with each switch having a unique domain ID. Switches come from the factory with the domain IDs unlocked.
0 4 – Managing Switches Configuring a Switch 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.
4 – Managing Switches Configuring a Switch 0 4.7.2.5 Broadcast Support Broadcast is supported on the switch which 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.3 Advanced Switch Properties The Advanced Switch Properties dialog enables you to set the timeout values, Interop Mode, and Legacy Address Format settings. The Advanced Switch Properties dialog is available for only the entry switch, because an in-band switch can not be taken offline. The switch will automatically be taken offline temporarily and will be restored to its original state after the changes are completed.
0 4 – Managing Switches Configuring a Switch 4.7.3.2 Legacy Port Address Format Legacy Address Format should be enabled only to permit interoperation with certain older non-FC-SW-2 compliant switches. Enabling this setting under other circumstances will disable zoning that is defined by domain ID and port number. This Legacy Address Format option is available only when the Interop_1 setting is enabled on the Advanced Switch Properties dialog.
0 4 – Managing Switches Configuring a Switch 4.7.4 System Services Dialog The System Services dialog provides a central location for you to enable or disable any of the external user services such as Simple Network Management Protocol (SNMP), Secure Sockets Layer (SSL), Secure SHell (SSH), embedded switch management application, command line interface, Network Time Protocol (NTP), and Common Information Model (CIM). To display the System Services dialog, open the Switch menu and select Services.
4 – Managing Switches Configuring a Switch 0 SSL - Secure Sockets Layer. Provides secure encrypted communications between the switch management application (GUI) and the switch. SSL must be enabled for configuration of security and RADIUS servers with the switch management application (GUI). SSL certificates are generated on the switch with the switch date/time and validated with the workstation’s date/time.
0 4 – Managing Switches Configuring a Switch 4.7.6 Network Properties Use the Network Properties dialog shown in Figure 4-13 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-13.
0 4 – Managing Switches Configuring a Switch 4.7.6.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-30 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.6.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.7 SNMP Properties Use the SNMP Properties dialog shown in Figure 4-14 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.7.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 59022-11 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.7.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 4.9 Restoring a Switch Restoring a switch loads the archived switch configuration parameters to the switch. The switch configuration must be archived before it can be restored. The switch archive must be compatible with the switch to be restored; that is, you can restore a SANbox2-8c switch only with an archive from a SANbox2-8c switch. Refer to ”Archiving a Switch” on page 4-35 for more information.
0 59022-11 A 4 – Managing Switches Restoring a Switch 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. Configuration backup files created with the Config Backup command are not compatible with the SANsurfer Switch Manager Restore function. 4. To restore all configuration settings, click the Full Restore tab, then click the Restore button.
0 4 – Managing Switches Restoring the Factory Default Configuration 4.10 Restoring the Factory Default Configuration You can restore the switch and port configuration settings to the factory default values. To restore the factory configuration on a switch, open the Switch menu and select Restore Factory Defaults. Table 4-9 lists the factory default switch configuration settings. Restoring the switch to the factory default configuration does not restore the account name and password settings.
0 4 – Managing Switches Downloading a Support File Table 4-9. Factory Default Configuration Settings (Continued) Setting Value Remote Logging False Remote Logging host IP address 10.0.0.254 Contact Undefined NTP Client Enabled False NTP Server IP Address 10.0.0.254 Location Undefined Trap enabled False Trap Port 162 Trap Address Trap 1: 10.0.0.254; Traps 2-5: 0.0.0.
0 4 – Managing Switches Installing Firmware 4.12 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. The pending firmware version will only differ from the active version during the brief period while the switch is resetting to activate the firmware.
0 4 – Managing Switches Displaying Hardware Status 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. Click the OK button to continue firmware installation or click the Cancel button to cancel the firmware installation. 4.
4 – Managing Switches Displaying Hardware Status 0 Notes 4-42 59022-11 A
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. Transceiver Media View Media Icon Description Optical SFP (Green), logged-in, active, and ready to send data.
0 5 – Managing Ports Displaying Port Information Table 5-5. Port Statistics Data Window Entries Entry 59022-11 A Description Start Time The beginning of the period over which the statistics apply. The start time for the Absolute view is not applicable. The start time for the Rate view is the beginning of polling interval. The start time for the Baseline view is the last time the baseline was set. End Time The last time the statistics were updated on the display.
0 5 – Managing Ports Displaying Port Information Table 5-5. Port Statistics Data Window Entries (Continued) Entry 5-6 Description Flow Errors Number of times a frame is received and all the switch ports receive buffers are full. The normal Fabric Login exchange of flow control credit should prevent this from occurring. The frame will be discarded. FReject Number of frames, from devices, that have been rejected. Frames can be rejected for any of a large number of reasons.
0 5 – Managing Ports Displaying Port Information Table 5-5. Port Statistics Data Window Entries (Continued) Entry Description Total Errors Total number of primitive and non-primitive port link errors. Total Link Resets Number of link-reset primitives the transmitted by the port. Total LIPs Received Number of loop initialization primitive frames received. Total LIPs Transmitted Number of loop initialization primitive frames transmitted.
0 5 – Managing Ports Displaying Port Information Table 5-6. Port Information Data Window Entries (Continued) Entry 5-8 Description Administrative Port State The port state (Online, Offline, Diagnostics, or Down) which has been set by the user. This state may be different from the configured administrative state if the user has not saved it in the switch configuration. This state is used at the time it is set to try to set the port operational state.
0 5 – Managing Ports Displaying Port Information Table 5-6. Port Information Data Window Entries (Continued) Entry 59022-11 A Description Symbolic Name Port symbolic name Ext Credits Requested Whether extended credits have been requested for ports. Credits to Donate Number of requested credits. Donor Group The donor group of the selected port. Valid Donor Groups The number of separate groups within which extended credits may be donated and assigned.
0 5 – Managing Ports Configuring Ports 5.2 Configuring Ports The port settings or characteristics are configured using the Port Properties dialog shown in Figure 5-2. To open the Port Properties dialog, select one or more ports, open the Port menu and select Port Properties. Figure 5-2. Port Properties Dialog The Port Properties dialog displays the switch name and the selected ports.
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 exists in two forms: the configured administrative state and the current administrative state. The configured administrative state is the state that is saved in the switch configuration and is preserved across switch resets. SANsurfer Switch Manager always makes changes to the configured administrative state.
0 5 – Managing Ports Configuring Ports 5.2.2 Changing Port Speeds 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 ports in the faceplate display. 2. Open the Port menu and select Port Properties. 3.
0 5 – Managing Ports Configuring Ports 5.2.3 Changing Port Types The ports can be configured to self-discover the proper type to match the device or switch to which it is connected. Table 5-9 describes the port types. To change the port type, do the following: 1. Select one or more ports in the faceplate display. 2. Open the Port menu and select Port Properties to open the Port Properties dialog. 3. Click the Port Type radio button for the port type you want. 4.
0 5 – Managing Ports Using the Extended Credits Wizard 5.2.5 Device Scan The Device Scan feature queries the connected device during login for FC-4 descriptor information. Disable this parameter only if the scan creates a conflict with the connected device. 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.
0 5 – Managing Ports Using the Extended Credits Wizard 3. Designate Donor Ports: Select available ports and click >> to move the port into the Selected Donor Port column shown in Figure 5-3. Match the number of ports needed with the number of designated donor ports. Click the Next button. 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.
0 5 – Managing Ports Resetting a Port 5.4 Resetting a Port The Reset Port option reinitializes the port using the saved configuration. To reset a port, do the following: 1. In the faceplate display, select the ports to be reset. 2. Open the Port menu and select Reset Port. 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.
0 5 – Managing Ports Testing Ports SFP level (External) - The SFP level test verifies port circuitry. The SFP level test sends a test frame from the ASIC through the SerDes chip, through the SFP transceiver fitted with an external loopback plug, and back to the ASIC for the selected ports. The port passes the test if the test frame that was sent by the ASIC matches the test frame that was received. This test requires that the port be in diagnostics mode, and therefore, disrupts 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 This section describes how to do the following: Starting SANsurfer Performance Viewer Exiting SANsurfer Performance Viewer Saving and Opening Performance View Files Changing the Default Performance View File Encryption Key Setting SANsurfer Performance Viewer Preferences Setting the Polling Frequency Displaying Graphs Saving Graph Statistics to a File 5.6.
5 – Managing Ports Graphing Port Performance 0 5.6.2 Exiting SANsurfer Performance Viewer To exit a SANsurfer Performance Viewer session, open the File menu and select Exit. The current fabric view is automatically saved to your default performance view file upon exit, if you have defined an encryption key. The key is encrypted and saved with your default performance view file.
0 5 – Managing Ports Graphing Port Performance In your next SANsurfer Performance Viewer session, the Load Default View File dialog shown in Figure 5-7 prompts you to load the default performance view file and to specify its encryption key, if there is one. In the Default File Encryption Key field, enter the encryption key and click the Load View File button.
0 5 – Managing Ports Graphing Port Performance 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. Open the File menu and select Save Default Performance View File to open the Save Default Performance View File dialog. 2. Enter the new encryption key in the Default File Encryption Key field. 3. Re-enter the same encryption key in the Re-enter Encryption Key to Confirm field. 4.
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]. SANsurfer Performance Viewer will update the graphs once during the interval.
5 – Managing Ports Graphing Port Performance 0 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 5.6.7.3 Setting Global Graph Type The Set Global Graph Type option enables you to view port activity using two types of graphs: Line Graph - plots continuous port activity in horizontal line format. Bar Graph - the last polling value received by the application in bar graph format. To set the global graph type, open the Graph menu and select Line Bar or Bar Graph. 5.6.7.
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.1 Modifying a Configuration A switch supports up to 10 configurations including the default configuration. Each switch configuration contains switch, port, port threshold alarm, and zoning configuration components. The Show Switch command displays the name of the active configuration. A configuration name can have up to 31 characters excluding the pound symbol (#), semicolon (;), and comma (,).
A – Command Line Interface Working with Switch Configurations 0 A.3.2 Backing up and Restoring Switch Configurations Backing up and restoring a configuration is useful to protect your work or for use as a template in configuring other switches. The Config Backup command creates a file on the switch, named configdata. This file can be used to restore a switch configuration only from the command line interface; it cannot be used to restore a switch using SANsurfer Switch Manager.
0 A – Command Line Interface Working with Switch Configurations 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-77.
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 CIM Command CIM Command Manages CIM listener and subscription configurations on the switch. Refer to the ”CIMListener Command” on page A-12 for information about creating and modifying CIM listeners. Refer to the ”CIMSubscription Command” on page A-14 for information about creating and modifying CIM subscriptions. Authority Admin session Syntax cim cancel clear edit limits save Keywords cancel Terminates the current CIM edit session without saving changes that were made.
0 A – Command Line Interface CIMListener Command CIMListener Command Configures CIM indication service listeners and adds subscriptions to listeners. Refer to the ”CIMSubscription Command” on page A-14 for information about configuring subscriptions. Authority Admin session and a CIM Edit session. Refer to the ”CIM Command” on page A-11 for information about opening a CIM edit session.
0 Examples A – Command Line Interface CIMListener Command The following is an example of the CIMListener Create command: SB5602-91.54 (admin-cim) #> cimlistener create listener_1 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 CIMSubscription Command CIMSubscription Command Creates, edits, or removes CIM subscriptions. Authority Admin session and a CIM Edit session. Refer to the ”CIM Command” on page A-11 for information about opening a CIM edit session.
0 Examples A – Command Line Interface CIMSubscription Command The following is an example of the CIMSubscription Create command: SANbox2 (admin-cim) #> cimsubscription create subscription_1 A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so.
A – Command Line Interface Config Command 0 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-60.
0 A – Command Line Interface Config Command restore Restores configuration settings to an out-of-band switch from a backup file named configdata, which must be first uploaded on the switch using FTP. You create the backup file using the Config Backup command. Use FTP to load the backup file on a switch, then enter the Config Restore command. After the restore is complete, the switch automatically resets. Refer to ”Backing up and Restoring Switch Configurations” on page A-4.
A – Command Line Interface Config Command 0 The following is an example of how to create a backup file (configdata) and download the file to the workstation.
0 A – Command Line Interface Create Command Create Command Creates support files for troubleshooting switch problems, and certificates for secure communications for SANsurfer Switch Manager. Authority Admin session Syntax create certificate support Keywords certificate Creates a security certificate on the switch. The security certificate is required to establish an SSL connection with a management application such as SANsurfer Switch Manager.
A – Command Line Interface Create Command 0 Would you like to continue downloading support file? (y/n) [n]: y Connected to 10.20.33.130 (10.20.33.130). 220 localhost.localdomain FTP server (Version wu-2.6.1-18) ready. 331 Password required for johndoe. Password: xxxxxxx 230 User johndoe logged in. cd bin/support 250 CWD command successful. lcd /itasca/conf/images Local directory now /itasca/conf/images bin 200 Type set to I. put dump_support.tgz local: dump_support.tgz remote: dump_support.
0 A – Command Line Interface Create Command The following is an example of the Create Certificate command: SANbox2 (admin) #> create certificate The current date and time is day mon date hh:mm:ss UTC yyyy. This is the time used to stamp onto the certificate. Is the date and time correct? (y/n): [n] y Certificate generation successful.
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. Authority Admin session except to display the date. Syntax date [MMDDhhmmCCYY] Keywords [MMDDhhmmCCYY] Specifies the date – this requires an admin session.
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.
A – Command Line Interface Group Command 0 Group Command Creates groups, manages membership within the group, and manages the membership of groups in security sets. Authority Admin session and a Security Edit session. Refer to the ”Security Command” on page A-52 for information about starting a Security Edit session. The List, Members, Securitysets, and Type keywords are available without an Admin session.
0 Keywords A – Command Line Interface Group Command add [group] Initiates an editing session in which to specify a group member and its attributes for the existing group given by [group]. ISL, Port, and MS member attributes are described in Table A-5, Table A-6, and Table A-7 respectively. The group name and group type attributes are read-only fields common to all three tables. Table A-5.
0 A – Command Line Interface Group Command Table A-6. Port Group Member Attributes Attribute A-26 Description Member Port worldwide name for the N_Port device that would attach to the switch. A member cannot belong to more than one group. Authentication Enables (CHAP) or disables (None) authentication using the Challenge Handshake Authentication Protocol (CHAP). The default is None.
0 A – Command Line Interface Group Command Table A-7. MS Group Member Attributes Attribute Description Member Port worldwide name for the N_Port device that would attach to the switch. CTAuthentication Common Transport (CT) authentication. Enables (True) or disables (False) authentication for MS group members. The default is False. Hash The hash function to use to decipher the encrypted Secret sent by the MS group member. Hash values are MD5 or SHA-1.
0 A – Command Line Interface Group Command edit [group] [member] Initiates an editing session in which to change the attributes of a worldwide name given by [member] in a group given by [group]. Member attributes that can be changed are described in Table A-8: Table A-8. Group Member Attributes Attribute A-28 Description Authentication (ISL and Port Groups) Enables (CHAP) or disables (None) authentication using the Challenge Handshake Authentication Protocol (CHAP).
0 A – Command Line Interface Group Command Table A-8. Group Member Attributes Attribute Description Secret (MS Groups) Hexadecimal string that is encrypted by the Hash function for authentication with MS group members. The string has the following lengths depending on the Hash function: MD5 hash: 16-byte SHA-1 hash: 20-byte Binding (ISL Groups) Domain ID of the switch to which to bind the ISL group member worldwide name.
0 A – Command Line Interface Group Command Examples The following is an example of the Group Add command: SANbox2 (admin-security) #> group add Group_1 A list of attributes with formatting and default values will follow Enter a new value or simply press the ENTER key to accept the current value with exception of the Group Member WWN field which is mandatory. 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 Group Command The following is an example of the Group List command: SANbox2 #> group list Group SecuritySet ----- ----------- group1 (ISL) alpha group2 (Port) alpha The following is an example of the Group Members command: SANbox2 #> group members group1 Current list of members for Group: group1 ---------------------------------10:00:00:c0:dd:00:71:ed 10:00:00:c0:dd:00:72:45 10:00:00:c0:dd:00:90:ef 10:00:00:c0:dd:00:b8:b7 59022-11 A A-31
A – Command Line Interface Hardreset Command 0 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-71. Authority Admin session Syntax Notes hardreset To reset the switch without a power-on self test, refer to the ”Reset Command” on page A-44.
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-71.
A – Command Line Interface Image Command 0 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.
0 Notes A – Command Line Interface Image Command To provide consistent performance throughout the fabric, ensure that all switches are running the same version of firmware. To install firmware when the management workstation has an FTP server, use the Image Install command or the ”Firmware Install Command” on page A-23. To install firmware when the management workstation does not have an FTP server, do the following: 1. Connect to the switch through the Ethernet port or the serial port. 2.
0 A – Command Line Interface Image Command 9. Open an Admin session to acquire the necessary authority. SANbox2 $>admin start 10. Display the list of firmware image files on the switch to confirm that the file was loaded. SANbox2 (admin) $>image list 11. Unpack the firmware image file to install the new firmware in flash memory. SANbox2 (admin) $>image unpack filename 12. Wait for the unpack to complete. image unpack command result: Passed 13.
0 A – Command Line Interface Lip Command 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.
0 A – Command Line Interface Ping Command Ping Command Initiates an attempt to communicate with another switch over an Ethernet network and reports the result. Authority None Syntax Keywords ping [ip_address] Examples The following is an example of a successful Ping command: [ip_address] The IP address of the switch to query. Broadcast IP addresses, such as 255.255.255.255, are not valid. SANbox2 #> ping 10.20.11.57 Ping command issued. Waiting for response...
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: SANbox2 #> ps PID A-42 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.
0 A – Command Line Interface Quit Command Quit Command Closes the Telnet session. Authority None Syntax Notes quit, exit, or logout 59022-11 A 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.
0 A – Command Line Interface Reset Command services Resets the switch services configuration to the default values as described in Table A-15. snmp Resets the SNMP configuration settings to the factory default values. Refer to Table A-13 for SNMP configuration default values. switch Resets the switch without a power-on self test. This is the default. This reset disrupts traffic and does the following: Activates the pending firmware. Closes all management sessions. Clears the event log.
0 A – Command Line Interface Reset Command Notes The following tables specify the various factory default settings: Enter the Show Config Switch command to display switch configuration values. Table A-9.
0 A – Command Line Interface Reset Command Enter the Show Config Port command to display port configuration values. Table A-10.
0 A – Command Line Interface Reset Command Enter Show Config Threshold command to display threshold alarm configuration values. Table A-11.
0 A – Command Line Interface Reset Command Enter the Show Setup SNMP command to display SNMP configuration values. Table A-13. SNMP Configuration Defaults Parameter 59022-11 A Default SNMPEnabled True Contact Location Description SANbox2-64 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.1.4.1.1663.1.1.1.1.
0 A – Command Line Interface Reset Command Enter the Show Setup Radius command to display RADIUS configuration values. Table A-14. RADIUS Configuration Defaults Parameter Default DeviceAuthOrder Local UserAuthOrder Local TotalServers 1 DeviceAuthServer False UserAuthServer False AccountingServer False ServerIPAddress 10.0.0.1 ServerUDPPort 1812 Timeout 2 seconds Retries 0 SignPackets False Enter the Show Setup Services command to display switch service configuration values.
0 A – Command Line Interface Reset Command Enter the Show Setup System command to display system configuration values. Table A-16. System Configuration Defaults Parameter 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.
A – Command Line Interface Security Command 0 Security Command Opens a Security Edit session in which to manage the security database on a switch. Refer to the ”Group Command” on page A-24 and the ”Securityset Command” on page A-56. Authority Admin session. The keywords Active, History, Limits, and List are available without an Admin session. Syntax security active cancel clear edit history limits list restore save Keywords active Displays the active security set, its groups, and group members.
0 A – Command Line Interface Security Command history Displays history information about the security database and the active security set including the account name that made changes and when those changes were made. This keyword does not require an Admin session. limits Displays the current totals and the security database limits for the number of security sets, groups, members per group, and total members. This keyword does not require an Admin session.
0 A – Command Line Interface Security Command The following is an example of the Security History command: SB211.
0 A – Command Line Interface Security Command The following is an example of the Security List command: SANbox2 (admin-security) #> security list SB211.192 #> security list Active Security Information SecuritySet Group GroupMember ----------- ----- ----------- No active securityset defined.
A – Command Line Interface Securityset Command 0 Securityset Command Manages security sets in the security database. Authority Admin session and a Security Edit session. Refer to the ”Security Command” on page A-52 for information about starting a Security Edit session. The Active, Groups, and List keywords are available without an Admin session. You must close the Security Edit session before using the Activate and Deactivate keywords.
0 A – Command Line Interface Securityset Command delete [security_set] Deletes the security set given by [security_set]. If the specified security set is active, the command is suspended until the security set is deactivated. groups [security_set] Displays all groups that are members of the security set given by [security_set]. This keyword is available without an Admin session. list Displays a list of all security sets. This keyword is available without an Admin session.
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] timezone Keywords alarm [option] Controls the display of alarms in the session output stream or clears the alarm log.
0 A – Command Line Interface Set Command pagebreak [state] Specifies how much information is displayed on the screen at a time according to the value given by [state]. This keyword does not require an admin session. [state] can be one of the following: 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).
0 A – Command Line Interface Set Config Command Set Config Command Sets switch, port, port threshold alarm, security, 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-16.
0 A – Command Line Interface Set Config Command Table A-18. Set Config Port Parameters Parameter 59022-11 A Description 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 Arbitration loop fairness. Enables (True) or disables (False) the switch’s priority to arbitrate on the loop. The default is False.
0 A – Command Line Interface Set Config Command Table A-18. Set Config Port Parameters Parameter Description LCFEnable Link control frame preference routing. This parameter appears only if AutoPerfTuning is False. Enables (True) or disables (False) preferred routing of frames with R_CTL = 1100 (Class 2 responses). The default is False. Enabling LCFEnable will disable MFSEnable. MFSEnable Multi-Frame Sequence bundling. This parameter appears only if AutoPerfTuning is False.
0 A – Command Line Interface Set Config Command parameter, enter a new value or press the Enter key to accept the current value shown in brackets. Enter “q” or "Q" to end the editing session. Table A-19 describes the Set Config Security parameters. Table A-19. Security Configuration Parameters Parameter Description AutoSave Enables (True) or disables (False) the saving of changes to active security set in the switch’s permanent memory. The default is True.
0 A – Command Line Interface Set Config Command Table A-20. Set Config Switch Parameters Parameter A-64 Description SymbolicName Descriptive name for the switch. The name can be up to 32 characters excluding #, semicolon (;), and comma (,). The default is SANbox2. R_A_TOV Resource Allocation Timeout Value. The number of milliseconds the switch waits to allow two ports to allocate enough resources to establish a link. The default is 10000. E_D_TOV Error Detect Timeout Value.
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-22.
0 A – Command Line Interface Set Config Command ALFairness (True / False) [False ] DeviceScanEnable (True / False) [True ForceOfflineRSCN (True / False) [False ] ARB_FF [False ] (True / False) ] InteropCredit (decimal value, 0-255) [0 ] ExtCredit (dec value, increments of 11, non-loop only) [0 ] FANEnable (True / False) [True ] AutoPerfTuning (True / False) [False ] LCFEnable (True / False) [False ] MFSEnable (True / False) [False ] VIEnable (True / False) [False ] MSEnabl
0 A – Command Line Interface Set Config Command The following is an example of the Set Config Security command: SANbox2 #> admin start SANbox2 (admin) #> config edit SANbox2 (admin-config) #> set config security 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 Config Command The following is an example of the Set Config Threshold command: SANbox2 #> admin start SANbox2 (admin) #> config edit SANbox2 (admin-config) #> set config threshold 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 Config Command The following is an example of the Set Config Zoning command. SANbox2 #> admin start SANbox2 (admin) #> config edit SANbox2 (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 level [filter] Specifies the severity level given by [filter] to use in monitoring and logging events for the specified components or ports. [filter] can be one of the following values: Critical Monitors critical events. The critical level describes events that are generally disruptive to the administration or operation of the fabric, but require no action. Warn Monitors warning and critical events.
A – Command Line Interface Set Log Command Notes A-74 0 In addition to critical, warn, and informative severity levels, the highest event severity level is alarm. The alarm level describes events that are disruptive to the administration or operation of a fabric and require administrator intervention. Alarms are always logged and always displayed on the screen.
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 state [state] Specifies one of the following administrative states for the specified port: Online Places the port online. This activates and prepares the port to send data. Offline Places the port offline. This prevents the port from receiving signal and accepting a device login. Diagnostics Prepares the port for testing. This prepares the port for testing and prevents the port from accepting a device login.
0 A – Command Line Interface Set Setup Command Set Setup Command Manages configuration settings for Remote Authentication Dial-In User Service (RADIUS) servers, switch services, SNMP, and system configurations. Authority Admin session Syntax set setup radius services snmp system Keywords radius Prompts you in a line-by-line fashion to configure RADIUS servers for user account and device authentication. Table A-23 describes the RADIUS server configuration fields. Table A-23.
0 A – Command Line Interface Set Setup Command Table A-23. RADIUS Service Settings Entry A-78 Description UserAuthServer Enable (True) or disable (False) this server for user account authentication. A user authentication RADIUS server requires a secure management connection (SSL). The default is True. AccountingServer Enable (True) or disable (False) this server for auditing of activity during a user session. When enabled, user activity is audited whether UserAuthServer is enabled or not.
0 A – Command Line Interface Set Setup Command services Prompts you in a line-by-line fashion to enable or disable switch services. Table A-24 describes the switch service parameters. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets. Note: Use caution when disabling TelnetEnabled and GUIMgmtEnabled; it is possible to disable all Ethernet access to the switch. Table A-24.
0 A – Command Line Interface Set Setup Command Table A-24. Switch Services Settings Entry A-80 Description EmbeddedGUIEnabled Enables (True) or disables (False) the SANsurfer Switch Manager web applet. The web applet enables you to point at a switch with an internet browser and run SANsurfer Switch Manager through the browser. This parameter is the master control for the Set Setup System command parameter, EmbeddedGUIEnabled. The default is True.
0 A – Command Line Interface Set Setup Command snmp Prompts you in a line-by-line fashion to change SNMP configuration settings. Table A-25 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-25. SNMP Configuration Settings Entry 59022-11 A Description SNMPEnabled Enables (True) or disables (False) SNMP on the switch. The default is True.
0 A – Command Line Interface Set Setup Command Table A-25. SNMP Configuration Settings Entry Description TrapCommunity Trap community password that authorizes an SNMP agent to receive traps. This is a write-only field. The value on the switch and the SNMP management server must be the same. The trap 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-26. System Configuration Settings Entry 59022-11 A Description LocalLogEnabled Enables (True) or disables (False) the saving of log information on the switch. The default is True. RemoteLogEnabled Enables (True) or disables (False) the recording of the switch event log on a remote host that supports the syslog protocol. The default is False.
0 A – Command Line Interface Set Setup Command Examples The following is an example of the Set Setup RADIUS command: SANbox2 (admin) #> set setup radius 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 attributes for the server being processed, press 'q' or 'Q' and the ENTER key to do so.
0 A – Command Line Interface Set Setup Command The following is an example of the Set Setup SNMP command: SANbox2 #> admin start SANbox2 (admin) #> set setup snmp A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so.
0 A – Command Line Interface Set Setup Command The following is an example of the Set Setup System command: SANbox2 (admin) #> set setup system A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so.
0 A – Command Line Interface Show Command Show Command Displays fabric, switch, and port operational information.
A – Command Line Interface Show Command 0 alarm [option] Displays the alarm log and session display setting. If you omit [option], the command displays the last 200 alarm entries. The alarm log is cleared when the switch is reset or power cycled. [option] has the following value: setting Displays the status of the parameter that controls the display of alarms in the session output stream. This parameter is set using the Set Alarm command.
0 A – Command Line Interface Show Command log [option] Displays log entries. Refer to the ”Show Log Command” on page A-106. The log is cleared when the switch is reset or power cycled. lsdb Displays Link State database information mem [count] Displays information about memory activity for the number of seconds given by [count]. If you omit [count], the value 1 is used. Displayed memory values are in 1K block units.
0 A – Command Line Interface Show Command port [port_number] Displays operational information for the port given by [port_number]. Ports are numbered beginning with 0. If [port number] is omitted, information is displayed for all ports. Table A-27 describes the port parameters. Table A-27. Show Port Parameters Entry A-90 Description AIinit Incremented each time the port begins AL initialization. AIinitError Number of times the port entered initialization and the initialization failed.
0 A – Command Line Interface Show Command Table A-27. Show Port Parameters Entry 59022-11 A Description LIP_F8_AL_PS This LIP denotes a loop failure detected by the L_Port identified by AL_PS. LIP_F7_F7 A loop initialization primitive frame used to acquire a valid AL_PA. LIP_F8_F7 A loop initialization primitive frame used to indicate that a loop failure has been detected at the receiver. Link Failures Number of optical link failures detected by this port.
0 A – Command Line Interface Show Command Table A-27. Show Port Parameters Entry Description TotalTxFrames Total number of frames issued by this port. TotalTxWords Total number of words issued by this port. TxLinkResets Number of Link Resets issued by this port. TxOfflineSeq Total number of Offline Sequences issued by this port. post log Displays the Power On Self Test (POST) log which contains results from the most recently failed POST.
0 A – Command Line Interface Show Command Whoami Zoneset (Active, List) Zoning (History, Limits, List) switch Displays switch operational information.Table A-28 describes the switch operational parameters. Table A-28.
0 A – Command Line Interface Show Command Table A-28. Switch Operational Parameters Parameter Description BeaconOnStatus Beacon status as set by the Set Beacon command. OperationalState Switch operational state PrincipalSwitchRole Principal switch status. True indicates that this switch is the principal switch.
0 Examples A – Command Line Interface Show Command The following is an example of the Show Chassis command: SANbox2 #> show chassis Chassis Information ------------------BoardTemp (1) - Degrees Celsius 32 BoardTemp (2) - Degrees Celsius 36 FanStatus (1) Good FanStatus (2) Good PowerSupplyStatus (1) Good PowerSupplyStatus (2) Good HeartBeatCode 1 HeartBeatStatus Normal The following is an example of the Show Domains command: SANbox2 #> show domains Principal switch is (remote): 10:00:00:60:
0 A – Command Line Interface Show Command The following is an example of the Show FDMI command: SANbox2 #> 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: SANbox2 #> show fdmi 21:00:00:e0:8b:09:3b:17 FDMI Information ---------------Manufacturer QLogic Corporation S
0 A – Command Line Interface Show Command The following is an example of the Show NS (local domain) command: SANbox2 #> 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:27:a7:b
0 A – Command Line Interface Show Command The following is an example of the Show Interface command: SANbox2 #> show interface eth0 Link encap:Ethernet HWaddr 00:C0:DD:00:BD:ED inet addr:10.20.68.107 Bcast:10.20.68.255 UP BROADCAST RUNNING MULTICAST MTU:1500 Mask:255.255.255.0 Metric:1 RX packets:4712 errors:0 dropped:0 overruns:0 frame:0 TX packets:3000 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:100 RX bytes:415313 (405.5 Kb) TX bytes:716751 (699.
0 A – Command Line Interface Show Command The following is an example of the Show Port command: SANbox2 #> show port 1 Port Number: 1 ------------ 59022-11 A 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: SANbox2 #> show switch Switch Information -----------------SymbolicName sw .108 SwitchWWN 100000c0dd00bc56 SwitchType SANbox2-64 BootVersion Vx.x.x.x-0 (day month date time year) CreditPool 0 DomainID 19 (0x13) FirstPortAddress 130000 FlashSize - MBytes 128 LogLevel Critical MaxPorts 16 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: SANbox2 #> show topology 1 Local Link Information ---------------------PortNumber 1 PortID 650100 PortWWN 20:01:00:c0:dd:00:91:11 PortType F Remote Link Information ----------------------Device 0 NodeWWN 50:80:02:00:00:06:d5:38 PortType NL Description (NULL) IPAddress 0.0.0.0 Device 1 NodeWWN 20:00:00:20:37:2b:08:c9 PortType NL Description (NULL) IPAddress 0.0.0.
0 A – Command Line Interface Show Command The following is an example of the Show Version command: SANbox2 #> show version ***************************************************** * * * Command Line Interface SHell (CLISH) * * * ***************************************************** A-102 SystemDescription SANbox2-64 FC Switch Eth0NetworkAddress 10.20.11.
0 A – Command Line Interface Show Config Command Show Config Command Displays switch, port, alarm threshold, security, and zoning for the current configuration. Authority None Syntax show config port [port_number] security 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.
0 A – Command Line Interface Show Config Command MSEnabled True NoClose False IOStreamGuard Disabled VIEnabled False PDISCPingEnable True The following is an example of the Show Config Switch command: SANbox2 #> show config switch Configuration Name: default ------------------Switch Configuration Information -------------------------------- A-104 AdminState Online BroadcastEnabled False InbandEnabled True FDMIEnabled False FDMIEntries 10 DomainID 19 (0x13) DomainIDLock True Symbo
0 A – Command Line Interface Show Config Command The following is an example of the Show Config Threshold command: SANbox2 #> show config threshold Configuration Name: default -----------Threshold Configuration Information ----------------------------------ThresholdMonitoringEnabled False CRCErrorsMonitoringEnabled True RisingTrigger 25 FallingTrigger 1 SampleWindow 10 DecodeErrorsMonitoringEnabled True RisingTrigger 25 FallingTrigger 0 SampleWindow 10 ISLMonitoringEnabled True RisingTri
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: SANbox2 #> 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: SANbox2 #> show log level Current settings for log -----------------------FilterLevel Info DisplayLevel Critical The following is an example of the Show Log Options command:
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. Authority None Syntax show perf byte inbyte outbyte frame inframe outframe errors Keywords byte Displays continuous performance data in total bytes/second transmitted and received for all ports.
0 A – Command Line Interface Show Perf Command Examples The following is an example of the Show Perf command: SANbox2 #> show perf Port Bytes/s Number Bytes/s (in) Bytes/s Frames/s Frames/s Frames/s (out) (total) (in) (out) (total) ------ ------- ------- ------- -------- -------- -------- 0 7K 136M 136M 245 68K 68K 1 58K 0 58K 1K 0 1K 2 0 0 0 0 0 0 3 0 0 0 0 0 0 4 0 0 0 0 0 0 5 0 0 0 0 0 0 6 0 7K 7K 0 245 245 7 136M 58K 136M 68K 1K
0 A – Command Line Interface Show Setup Command Show Setup Command Displays the current SNMP and system settings. Authority None Syntax show setup mfg radius services snmp system Keywords mfg Displays manufacturing information about the switch. radius Displays RADIUS server information. services Displays switch service status information. 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 Services command: SANbox2 #> show setup services System Services ----------------------------TelnetEnabled True SSHEnabled False GUIMgmtEnabled True SSLMgmtEnabled False EmbeddedGUIEnabled True SNMPEnabled True NTPEnabled True CIMEnabled True FTPEnabled True ManagementServerEnabled True The following is an example of the Show Setup RADIUS command: SANbox2 #> show setup radius Radius Informati
0 A – Command Line Interface Show Setup Command The following is an example of the Show Setup Snmp command: SANbox2 #> show setup snmp SNMP Information ---------------- 59022-11 A SNMPEnabled True Contact Location N_107 System Test Lab Description SANbox2-64 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: SANbox2 #> show setup system System Information ------------------ A-114 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.
A – Command Line Interface Test Command 0 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-58 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 The online loopback (node-to-node) test requires that port be online and connected to a remote device. To run the online loopback test, do the following: 1. To start an admin session, enter the following command and press the Enter key. admin start 2. To run the online loopback test, enter the following command and press the Enter key. test port x online 3. A series of test parameters are displayed on the screen.
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: SANbox2 (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 Add com
0 A – Command Line Interface User Command The following is an example of the User Delete command: SANbox2 (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: SANbox2 (admin) #> user list A-122 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-130 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: SANbox2 #> zone list Zone ZoneSet ------------------wwn_b0241f zone_set_1 wwn_23bd31 zone_set_1 wwn_221416 zone_set_1 wwn_2215c3 zone_set_1 wwn_0160ed zone_set_1 wwn_c001b0 zone_set_1 wwn_401248 zone_set_1 wwn_02402f zone_set_1 wwn_22412f zone_set_1 The following is an example of the Zone Members command: SANbox2 #> zone members wwn_b0241f Current List of Members for Zone: wwn_b0241f ----
0 A – Command Line Interface Zone Command The following is an example of the Zone Zonesets command: SANbox2 #> zone zonesets zone1 Current List of ZoneSets for Zone: zone1 ---------------------------------zone_set_1 59022-11 A A-127
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-130 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-124 and the ”Zoneset Command” on page A-128. Authority Admin session except for the Active, History, Limits, and List keywords. The Clear keyword also requires a zoning edit session.
0 A – Command Line Interface Zoning Command history Displays a history of zoning modifications. This keyword does not require an Admin session. History information includes the following: Time of the most recent zone set activation or deactivation and the user who performed it Time of the most recent modifications to the zoning database and the user who made them.
0 A – Command Line Interface Zoning Command Examples The following is an example of the Zoning Edit command: SANbox2 #> admin start SANbox2 (admin) #> zoning edit SANbox2 (admin-zoning) #> . . SANbox2 (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: SANbox2 #> 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:06:04:82:bf
A – Command Line Interface Zoning Command 0 Notes A-134 59022-11 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 SANbox2-8c/16 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 In-Order-Delivery A feature that requires that frames be received in the same order in which they were sent. Input Power LED A chassis LED that indicates that the switch logic circuitry is receiving proper DC voltages. Inter-Switch Link The connection between two switches using E_Ports. IP Internet Protocol LIP Loop Initialization Primitive sequence SANbox2-8c/16 Switch Management User’s Guide Management Workstation PC workstation that manages the fabric through the fabric management switch.
0 SANbox2-8c/16 Switch Management User’s Guide Power On Self Test (POST) Diagnostics that the switch chassis performs at start up. World Wide Name (WWN) A unique 64-bit address assigned to a device by the device manufacturer. Principal Switch The switch in the fabric that manages domain ID assignments. WWN World Wide Name SANsurfer Switch Manager Switch management application. SFP Small Form-Factor Pluggable.
Index A access control list zone 3-39, 3-53 account name 3-22 display A-120, A-123 factory A-2 active zone set 3-33, 3-39 Active Zoneset data window 3-33 Admin account name A-7 authority A-7 Admin command A-8 Admin session timeout A-82 administrative state configured 4-21, 5-11 current 4-21, 5-11 port 5-11, A-76 switch 4-21, A-59 alarm configuration 4-15, A-65 configuration defaults A-48 configuration display A-103 description A-74 log A-58, A-88 alias add members 3-54, A-9 copy A-9 create 3-54, A-9 delete
0 SANbox2-8c/16 Switch Management User’s Guide configuration activate A-16 archive 4-35 backup A-16 copy A-16 delete A-16 edit A-16 list A-16 reset A-44 restore 4-36, A-17 save A-17 wizard 4-19 configured administrative state 4-21 connection Secure Socket Layer A-19 security 3-7, A-79 contact 4-33 CRC error 4-15 Create command A-19 credits 5-14 current administrative state 4-21 D data window active security 3-19 Active Zoneset 3-33 configured security 3-19 Configured Zonesets 4-14 description 2-24, 2-27,
0 SANbox2-8c/16 Switch Management User’s Guide event logging by component A-71, A-106 by port A-73, A-107 by severity level A-107 display A-106 restore defaults A-73 save settings A-73 settings A-107 severity level A-73 start A-73 stop A-73 event severity 3-29 extended credit wizard 5-14 external test 5-17, A-116 F F_Port 5-2, 5-13 fabric add 3-22 add a switch 3-24 database 3-22 delete 3-23 displaying information 3-26 loop port 5-2, 5-13 management 3-1 management workstation 2-2 merge 3-55 port 5-2, 5-13
0 SANbox2-8c/16 Switch Management User’s Guide group add member 3-15, A-25 copy A-27 create 3-13, A-27 edit member attributes 3-16, A-28 list A-29 list members A-29 Management Server A-27 remove 3-16 remove member 3-16, A-29 rename 3-16, A-29 type A-27, A-29 Group command A-24 GUI management service 4-27 H hard reset 4-18 Hardreset command A-32 hardware status 4-41 Heartbeat LED 4-41 help 2-18 Help command A-33 History command A-34 host bus adapter A-88 hot reset 4-18 Hotreset command A-35 I I/O Stream
0 SANbox2-8c/16 Switch Management User’s Guide M Management Server group A-27 service 4-28, A-80 manufacturer information A-111 mask address A-82 MD5 authentication A-26 media status 5-4 memory activity A-89 workstation 2-2 menu structure 2-20 Multi-Frame Sequence bundling A-62 N name server display A-89 export 3-35 zone 3-38 NDCLA - See Non-disruptive code load and activation network configuration reset A-45 discovery 4-30, A-82 gateway address A-82 interfaces A-88 IP address A-82 mask A-82 properties 4
0 SANbox2-8c/16 Switch Management User’s Guide port administrative state 5-11, A-76 buffer credits 5-14 configuration 5-10, A-60 configuration defaults A-47 configuration display A-103 counters A-75 displaying information 5-1 external test A-116 group A-27 initialize A-44 internal test A-116 loopback test A-116 mode 5-2 online test A-116 operational information A-90 operational state 5-3 performance 5-18, A-89, A-109 performance tuning A-61 reset 5-16 selecting 2-29 speed 5-3, A-75 status 2-28 symbolic na
0 SANsurfer Performance Viewer arrange graphs 5-24 customize graphs 5-24 display graphs 5-23 exit 5-20 preferences 5-22 start 5-19 SANsurfer Switch Manager default fabric file 2-12 Linux install 2-3 Mac OS X install 2-4 preferences 2-16, 5-22 Solaris install 2-3 start 2-9 uninstall 2-13, 2-15 user interface 2-19 version 2-18 web applet A-80, A-83 Windows install 2-3 scan device 5-14 secret A-26 Secure Shell description 3-7 service 4-28, A-79 Secure Socket Layer certificate A-19 description 3-7 service 4-28,
0 SANbox2-8c/16 Switch Management User’s Guide Simple Network Management Protocol configuration 4-33, A-81 configuration display A-111 defaults A-49 enable 3-19, 4-33 proxy 4-33 reset A-45 service 4-28, A-80 trap configuration 4-34 soft zone 3-38, 3-53 static boot method 4-30 status icon color 2-23 steering A-92 subnet mask address 4-30 subscription create A-14 delete A-14 display A-88 support file 4-39, A-19 switch add 3-24 administrative state 4-21, A-59 advanced properties 4-25 configuration 4-19, A-6
0 SANbox2-8c/16 Switch Management User’s Guide version snapshot compare 3-21 export 3-21 save 3-20 Virtual Interface preference routing A-62 time zone A-59 timeout Admin session A-82 Telnet session A-82 values 4-26 tool bar standard 2-22 zoning 3-43 topology display arrange icons 2-26 data windows 2-27 description 2-19 usage 2-25 transceiver status 5-4 trap authentication 4-33 community 4-33 configuration 4-34 SNMP version 4-34 W U Uptime command A-119 user account add A-120 admin A-2 admin account A-2
SANbox2-8c/16 Switch Management User’s Guide 0 zone merge description 3-55 failure 3-55 failure recovery 3-56 zone set activate 3-48, A-128 active 3-33, 3-39, A-130 add member zone A-128 copy A-128 create 3-47, A-128 deactivate 3-48, A-45, A-128 definition 3-39 delete A-128 delete member zone 3-49, A-129 discard inactive 3-45 display A-129 display active A-128 display members A-129 display zones A-125 management 3-47 orphan 3-39 remove 3-49 rename 3-52, A-129 tree 3-43 Zoneset command A-128 zoning 4-25 co
