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. QLogic Corporation makes no representation nor warranty that such applications are suitable for the specified use without further testing or modification.
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 SANbox 5600 Series Fibre Channel switches (firmware version 5.0). The SANbox 5600 Series switches are 20 port non-blocking Fibre Channel switches. This manual defines the features, components, and performance characteristics of the SANbox 5600 Series switches.
Page 14
1 – Introduction JDOM License Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions, and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions, and the disclaimer that follows these conditions in the documentation and/or other materials provided with the distribution.
Technical Certification courses include installation, maintenance and troubleshooting QLogic SAN products. Upon demonstrating knowledge using live equipment, QLogic awards a certificate identifying the student as a Certified Professional. The training professionals at QLogic may be reached by email at tech.training@qlogic.com. 59097-02 B...
1 – Introduction Technical Support 1.4.3 Contact Information Support Headquarters QLogic Corporation 12984 Valley View Road Eden Prairie, MN 55344-3657 QLogic Web Site www.qlogic.com Technical Support Web Site support.qlogic.com Technical Support Email support@qlogic.com Technical Training Email tech.training@qlogic.com North American Region Email support@qlogic.com...
Page 17
Section 2 Using SANsurfer Switch Manager This section describes how to use the SANsurfer Switch Manager application and its menus. The following topics are covered: Workstation Requirements Installing the Management Application Starting SANsurfer Switch Manager Exiting SANsurfer Switch Manager Uninstalling SANsurfer Switch Manager Changing the Encryption Key for the Default Fabric View File Saving and Opening Fabric View Files Setting SANsurfer Switch Manager Preferences...
You can manage the switch using SANsurfer Switch Manager as a standalone application or as a part of SANsurfer Management Suite™. SANsurfer Management Suite is QLogic’s integrated fabric management application, managing both HBAs and switches. If your switch was shipped with a SANsurfer Switch Manager Disk, refer to ”SANsurfer Switch Manager”...
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: Close all programs currently running, and insert the SANsurfer Switch Manager Installation Disk into the management workstation CD-ROM drive.
2 – Using SANsurfer Switch Manager Installing the Management Application For a Mac OS X platform: Open the CD and move to the following folder: data/files/Management_Software/MacOSX Double click the applicaton zip file (MacOSX_5.00.xx_xxxx.zip). This will place the install program on your desktop. Locate the Install program icon on your desktop, execute it, and follow the installation instructions.
Page 21
When prompted for the location in which to create the program icons, click the In an Existing Group radio button, then specify the same group that was used for the SMS installation. The default SMS group is "QLogic Management Suite". Click the Next button.
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. 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.
2 – Using SANsurfer Switch Manager Installing the Management Application 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. Select your switch model from the pull-down menu. Locate the description for SANsurfer Switch Manager for Linux under "Management Software".
Page 24
About ... and make note of the release version number. Close SANsurfer Management Suite. 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.
2 – Using SANsurfer Switch Manager Starting SANsurfer Switch Manager Starting SANsurfer Switch Manager You can start SANsurfer Switch Manager as a standalone application or from SANsurfer Management Suite. NOTE: After the switch is operational, you can also open the SANsurfer Switch Manager web applet, by entering the switch IP address in an internet browser.
2 – Using SANsurfer Switch Manager Starting SANsurfer Switch Manager In the Initial Start dialog, click the Open Configuration Wizard button. When you power up the switch, the Configuration Wizard will recognize the switch and lead you through the configuration process. The application opens with the Initial Start dialog shown in Figure 2-1.
2 – Using SANsurfer Switch Manager Starting SANsurfer Switch Manager Click the Start Application Without Specifying a Fabric radio button to open the SANsurfer Switch Manager window shown in Figure 2-2. Click the Open Configuration Wizard radio button to open the Config Wizard to configure a switch, add a new switch, replace/restore a switch, or recover or edit an IP configuration of an existing switch.
2 – Using SANsurfer Switch Manager Exiting SANsurfer Switch Manager Exiting SANsurfer Switch Manager 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...
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.
Uninstall SANsurfer_Switch_Manager. Also, a shortcut/link to the uninstall program was installed in the installation directory during the SANsurfer Switch Manager installation process. The default installation directories are: For Windows: C:\Program Files\QLogic_Corporation\SANsurfer_Switch_Manager For Linux: /opt/QLogic_Corporation/SANsurfer_Switch_Manager For Solaris: /usr/opt/QLogic_Corporation/SANsurfer_Switch_Manager For Mac OS X: Users/qlogic/Applications/QLogic_Corporation/SANsurfer_Switch_Manager 2-14 59097-02 B...
2 – Using SANsurfer Switch Manager Changing the Encryption Key for the Default Fabric View File To uninstall the SANsurfer Switch Manager application, do the following: For Windows, browse for the uninstall program file or the shortcut/link that points to the uninstall program file. The uninstall program shortcut is in the same folder as the program shortcut (Start menu, program group, on desktop, or user specified) that is used to start the SANsurfer Switch Manager application.
2 – Using SANsurfer Switch Manager Setting SANsurfer Switch Manager Preferences To open a fabric view file, do the following: Open the File menu and select Open View File to open the Open View dialog. Enter a name for the fabric view file or click the Browse button to select an existing file.
2 – Using SANsurfer Switch Manager Using Online Help ”Port Types” on page 5-2 ”Displaying Port Operational States” on page 5-3 ”Displaying Port Speeds” on page 5-3 ”Displaying Transceiver Media Status” on page 5-4 Figure 2-5. Preferences Dialog – SANsurfer Switch Manager To set preferences for your SANsurfer Switch Manager sessions, do the following: Open the File menu, and select Preferences to open the Preferences dialog.
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.
2 – Using SANsurfer Switch Manager SANsurfer Switch Manager User Interface 2.11.1 Menu Bars The menus and the options offered in them vary depending on the display. For example, the Port menu and many of the Switch menu selections are available only in the faceplate display.
2 – Using SANsurfer Switch Manager SANsurfer Switch Manager User Interface 2.11.1.2 Faceplate Display Menu The menu options available in the faceplate display are shown in Figure 2-8. Figure 2-8. Faceplate Display Menu The keyboard shortcut keys vary by display type: topology display and faceplate display.
Edit Zoning button - opens the Edit Zoning dialog (available only in faceplate display). Edit Security button - opens the Edit Security dialog (faceplate dis- play only) Help Topics button - opens the online help file. The QLogic logo opens a link to the QLogic web site. 59097-02 B 2-21...
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.
2 – Using SANsurfer Switch Manager SANsurfer Switch Manager User Interface 2.11.4 Graphic Window The graphic window, 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 – 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: Switch and Link Status Working with Switches and Links...
2 – Using SANsurfer Switch Manager Using the Topology Display 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.
2 – Using SANsurfer Switch Manager Using the Topology Display 2.12.2.3 Opening the Faceplate and Topology Display Popup Menus 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 Using the Faceplate Display 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 Working with Ports Faceplate Data Windows...
2 – Using SANsurfer Switch Manager Using the Faceplate Display 2.13.1 Port Views and Status Port color and text provide information about the port and its operational state. Green indicates active; gray indicates inactive. The faceplate display provides the following views of port status corresponding to the View menu options in the faceplate display.
2 – Using SANsurfer Switch Manager Using the Faceplate Display 2.13.2.2 Opening the Faceplate Popup Menu To open the popup menu, right-click on the faceplate image to present the following tasks. Refresh the switch Select all ports Manage switch properties Manage network properties Manage SNMP properties Extended credits wizard...
Page 46
2 – Using SANsurfer Switch Manager Using the Faceplate Display Notes 2-30 59097-02 B...
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 RADIUS Servers Remote Authentication Dial In User Service (RADIUS) provides a method to centralize the management of authentication passwords in larger networks.
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: Open the faceplate display, open the Switch menu, and select Radius Servers..
Page 49
3 – Managing Fabrics RADIUS Servers 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. 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.
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: Open the faceplate display, open the Switch menu, and select Radius Servers..
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 Server Information To edit information of a RADIUS server, do the following: Open the faceplate display, open the Switch menu, and select Radius Servers..
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: Open the faceplate display, open the Switch menu, and select Radius Servers..
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.
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.
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).
3 – Managing Fabrics Securing a Fabric Use the File menu to: Edit the security configuration on the switch. Open or edit security files. Save or rename security files Use the Edit menu to: Create security sets, security groups, and security group members Rename or remove a security group from a security set or a member from a security group Remove a group from all security sets...
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.
3 – Managing Fabrics Securing a Fabric Enter a security group name and select a security group type (ISL, Port, or MS). Remember, only one security group type (1 ISL, 1 Port, 1 MS) in each security set is allowed. The naming conventions for security groups are: Must start with a letter All alphanumeric chars [aA- zZ] [0-9] The symbols $ _ - and ^ are the only symbols allowed...
Page 60
3 – Managing Fabrics Securing a Fabric The conventions for Port 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 authentication choices are None and Chap. The Secret field is disabled if authentication is set to None.
3 – Managing Fabrics Securing a Fabric 3.2.4.6 Creating a Security Group Member To add a member to a security group, do the following: 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. Choose one of the following methods to open the Create a Security Group Member dialog: In the graphic window, click a security group and click the Security...
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: 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.
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: 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.
3 – Managing Fabrics Securing a Fabric Check the Fabric Binding Enabled check box to require the expected domain ID of a switch is verified before being allowed to attach to the fabric. NOTE: The fabric binding feature must be enabled on all switches in the fabric.
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 – Managing Fabrics Tracking Fabric Firmware and Software Versions 3.2.5.1 Enabling SNMP Configuration To enable SNMP configuration, do the following: On the faceplate display, open the Switch menu and select SNMP Properties to open the SNMP Properties dialog. In the SNMP Configuration area, place a check mark in the SNMP Enabled check box.
3 – Managing Fabrics Tracking Fabric Firmware and Software Versions 3.3.1 Saving a Version Snapshot To save the current snapshot to an XML file, open the Fabric menu, select Fabric Tracker, and select Save Snapshot. To view and analyze system version information, open the Fabric menu, select Fabric Tracker, and select Analyze Snapshots.
3 – Managing Fabrics Tracking Fabric Firmware and Software Versions 3.3.3 Exporting Version Snapshots to a File The Reports tab page enables you to select one of several reports to save to a text file. The are two types of reports. The Summary report type shows the same format displayed on the Summary tab page without the color highlighting.
3 – Managing Fabrics Managing the Fabric Database 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 – 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.
3 – Managing Fabrics Managing the Fabric Database 3.4.4 Saving a Fabric View File To save a fabric view file, do the following: Open the File menu, and select Save View As. In the Save View dialog, enter a new file name. Enter a file password, if necessary.
3 – Managing Fabrics Managing the Fabric Database 3.4.7 Adding a New Switch to a Fabric If there are no special conditions to be configured for the new switch, simply plug in the switch and the switch becomes functional with the default fabric configuration.
3 – Managing Fabrics Managing the Fabric Database 3.4.8 Replacing a Failed Switch The archive/restore works for all switches. However, the Restore menu item is not available for the in-band switches. You can only restore a switch out-of-band (the fabric management switch). There are certain parameters that are not archived, and these are not restored by SANsurfer Switch Manager.
3 – Managing Fabrics Displaying Fabric Information Displaying Fabric Information The topology display is your primary tool for monitoring a fabric. The graphic window of the topology display provides status information for switches, inter-switch links, and the Ethernet connection to the management workstation. The data window tabs show device, switch, and active zone set information.
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.
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.
Page 77
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 Description Icon Alarm – An Alarm is a "serviceable event". This means that attention by the user or field service is required.
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.
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.
3 – Managing Fabrics Displaying Fabric Information 3.5.3 Devices Data Window The Devices data window displays information about devices (hosts and storage targets) connected to the switch. Click the Devices tab below the data window to display device information for all devices that are logged into the selected fabric. To narrow the display to devices that are logged into specific switches, select one or more switches in the fabric tree or the topology display.
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 –...
3 – Managing Fabrics Working with Device Information and Nicknames 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 icons.
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: Select one or more switches. If no switches are selected, Devices information is gathered for all switches.
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: In the topology or faceplate display, open the File menu and select Nicknames to open the Nicknames dialog.
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: Open the File menu and select Nicknames to open the Nicknames dialog.
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).
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.
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;...
3 – Managing Fabrics Zoning a Fabric MaxAliases is 2500. The maximum number of aliases that can be configured on the switch. This will be enforced during the configuration of zoning and during a zoning database merge from the fabric. MaxTotalMembers is 10,000.
3 – Managing Fabrics Zoning a Fabric 3.7.3 Managing the Zoning Database Managing the zoning database consists of the following: Editing the Zoning Database Configuring the Zoning Database Saving the Zoning Database to a File Restoring the Zoning Database from a File Restoring the Default Zoning Database Removing All Zoning Definitions 3.7.3.1...
Page 91
3 – Managing Fabrics Zoning a Fabric You cannot edit an active zone set on a switch. You must configure an inactive zone set to your needs and then activate that updated zone set to apply the changes to the fabric. When you activate a zone set, the switch distributes that zone set to the temporary zoning database on every switch in the fabric.
Page 92
3 – Managing Fabrics Zoning a Fabric Table 3-4. Edit Zoning Dialog Tool Bar Buttons and Icons (Continued) Tool Bar Button Description Create Zone button - create a new zone Create Alias button - create another name for a set of objects Add Member button - adds selected port/device to a zone Remove Member button - delete the selected zone from a zone set, or delete the selected port/device from a zone...
3 – Managing Fabrics Zoning a Fabric 3.7.3.2 Configuring the Zoning Database Use the Zoning Config dialog to change the Auto Save, Default Visibility, and Discard Inactive configuration parameters. In the faceplate display, open the Zoning menu and select Edit Zoning Config to open the Zoning Config dialog shown in Figure 3-16.
3 – Managing Fabrics Zoning a Fabric 3.7.3.2.2 Default Visibility Default visibility determines the level of communication that is permitted among ports/devices when there is no active zone set. The default visibility parameter can be set differently on each switch. When default visibility is enabled (ALL) on a switch, all ports/devices on the switch can communicate with all ports/devices on switches that also have default visibility enabled.
3 – Managing Fabrics Zoning a Fabric 3.7.3.5 Restoring the Default Zoning Database Restoring the default zoning clears the switch of all zoning definitions. CAUTION! This command will deactivate the active zone set. To restore the default zoning for a switch: In the faceplate display, open the Zoning menu and select Restore Default Zoning.
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.
3 – Managing Fabrics Zoning a Fabric 3.7.4.2 Activating and Deactivating a Zone Set You must activate a zone set to apply its zoning definitions to the fabric. Only one zone set can be active at one time. When you activate a zone set, the switch distributes that zone set to the temporary zoning database on every switch in the fabric.
3 – Managing Fabrics Zoning a Fabric 3.7.4.5 Removing a Zone Set Removing a zone set from the database affects the member zones in the following ways. Member zones that are members of other zone sets are not affected. Member zones that are not members of other zone sets become members of the orphan zone set.
3 – Managing Fabrics Zoning a Fabric 3.7.5.1 Creating a Zone in a Zone Set When a zone is created, its zone type is soft. To change the zone type to a hard zone, refer to ”Changing Zone Types” on page 3-56 for more information.
3 – Managing Fabrics Zoning a Fabric 3.7.5.2 Adding Zone Members You can zone a port/device by switch domain ID and port number, device port Fibre Channel address, or the device port WWN. Adding a port/device to a zone affects every zone set in which that zone is a member. To add ports/devices to a zone, do the following: Open the Zoning menu, and select Edit Zoning to open the Edit Zoning dialog.
3 – Managing Fabrics Zoning a Fabric 3.7.5.3 Renaming a Zone or a Zone Set To rename a zone, do the following: In the Zone Sets tree of the Edit Zoning dialog, click the zone/zone set to be renamed. Open the Edit menu and select Rename. In the Rename Zone/Rename Zone Set dialog, enter a new name for the zone/zone set.
3 – Managing Fabrics Zoning a Fabric 3.7.5.7 Changing Zone Types To change a zone type, do the following: In the faceplate display, select the switch with the zone type to change. Click the Zoning button to open the Edit Zoning dialog. In the Zone Sets tree, select the zone to change.
3 – Managing Fabrics Zoning a Fabric 3.7.6.2 Adding a Member to an Alias You can add a port/device to an alias by domain ID and port number, device port Fibre Channel address, or the device port WWN. To add ports/devices to an alias, do the following: Open the Zoning menu, and select Edit Zoning to open the Edit Zoning dialog.
3 – Managing Fabrics Zoning a Fabric 3.7.7 Merging Fabrics and Zoning If you join two fabrics with an inter-switch link, the active zone sets from the two fabrics attempt to merge automatically. The fabrics may consist of a single switch or many switches already connected together.
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.
Section 4 Managing Switches This section describes the following tasks that manage switches in the fabric. Managing User Accounts Displaying Switch Information Configuring Port Threshold Alarms Paging a Switch Setting the Date/Time and Enabling NTP Client Resetting a Switch Configuring a Switch Managing Switch Stacks Archiving a Switch Restoring a Switch...
4 – Managing Switches Managing User Accounts 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..
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.
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.
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.
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.
4 – Managing Switches Displaying Switch Information Displaying Switch Information The faceplate display and data windows provide the following switch information: Device and HBA information Switch specifications and addresses Configuration parameters Port performance statistics Port information Configured zone sets Figure 4-5 shows the faceplate display for the SANbox 5600 Series switch.
4 – Managing Switches Displaying Switch Information 4.2.1 Devices Data Window The Devices data window displays information about devices (hosts and storage targets) connected to the switch. Click the Devices tab below the data window to display name server information for all devices that are logged into the selected fabric.
Page 115
4 – Managing Switches Displaying Switch Information Table 4-2. Switch Data Window Entries (Continued) Entry Description MAC Address Media Access Control address IP Address Internet Protocol address Subnet Mask Mask that determines the IP address subnet Gateway Gateway address SNMP Enabled SNMP enabled or disabled.
Page 116
4 – Managing Switches Displaying Switch Information Table 4-2. Switch Data Window Entries (Continued) Entry Description Zoning Default Visibility Zoning visibility status. Permits (All) or prevents (None) communication between attached devices in the absence of an active zone set. Temperature Internal switch temperature °C Security Auto Save N/A - does not apply to this switch...
Page 117
4 – Managing Switches Displaying Switch Information Table 4-2. Switch Data Window Entries (Continued) Entry Description FDMI Enable Fabric Device Management Interface status. If enabled, device information can be obtained, managed, and saved through the fabric using Name Service Management Server functions.
4 – Managing Switches Displaying Switch Information 4.2.3 Port Statistics Data Window The Port Statistics data window displays port performance data for the selected ports. To open the Port Statistics data window, click the Port Stats tab below the data window in the faceplate display. Refer to Table 5-6 for a description of the Port Statistics data window entries.
4 – Managing Switches Displaying Switch Information 4.2.5 Configured Zonesets Data Windows The Configured Zonesets data window displays all zone sets, zones, aliases, and zone membership in the zoning database, shown in Figure 4-6. To open the Configured Zonesets data window, click the Configured Zonesets tab below the data window in the faceplate display.
4 – Managing Switches Configuring Port Threshold Alarms 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: In the faceplate display, open the Switch menu and select Port Threshold Alarm Configuration.
4 – Managing Switches Paging a Switch 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.
4 – Managing Switches Setting the Date/Time and Enabling NTP Client Setting the Date/Time and Enabling NTP Client The Date/Time and Network Time Protocol (NTP) dialog enables you to manually set the date and time on a switch, or to enable the NTP Client to synchronize the date and time on the switch with an NTP server.
Page 123
4 – Managing Switches Resetting a Switch 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 Telnet sessions must be restarted manually. Applicable Code Versions: Future switch code releases will be upgraded non-disruptively unless specifically indicated in its associated release notes...
4 – Managing Switches Configuring a Switch 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.
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.
4 – Managing Switches Configuring a Switch 4.7.2.2 Switch Administrative States The switch administrative state determines the operational state of the switch. The switch administrative state exists in two forms: the configured administrative state and the current administrative state. The configured administrative state is the state that is saved in the switch configuration and is preserved across switch resets.
4 – Managing Switches Configuring a Switch 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).
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 4.7.2.5 Broadcast Support Broadcast is supported on the switch and allows for TCP/IP support. Broadcast is implemented using the proposed standard specified in Multi-Switch Broadcast for FC-SW-3, T11 Presentation Number T11/02-031v0. Fabric Shortest Path First (FSPF) is used to set up a fabric spanning tree used in transmission of broadcast frames.
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.
Advanced Switch Properties dialog. Contact your authorized maintenance provider for assistance in using this feature. Refer to the QLogic Switch Interoperability Guide on the QLogic Web site for a complete discussion of configuring for operation with non-Qlogic Switches.
4 – Managing Switches Configuring a Switch 4.7.3.3 Timeout Values The switch timeout values determine the timeout values for all ports on the switch. Table 4-5 describes the switch timeout parameters. The timeout values must be the same for all switches in the fabric. NOTE: Mismatched timeout values will disrupt the fabric.
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).
4 – Managing Switches Configuring a Switch 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.
4 – Managing Switches Configuring a Switch 4.7.6 Network Properties Use the Network Properties dialog shown in Figure 4-12 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.
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 Description Network Discov-...
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.
4 – Managing Switches Configuring a Switch 4.7.7 SNMP Properties Use the SNMP Properties dialog shown in Figure 4-13 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.
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.
4 – Managing Switches Managing Switch Stacks Managing Switch Stacks SANsurfer Switch Manager recognizes switches as a stack if they are connected by their high speed stacking ports. The switch management application will auto-detect switches connected by their 10-Gbps ports and display these stacked switches as a single stack entity in the topology and faceplate displays.
4 – Managing Switches Managing Switch Stacks Date/time and Network Time Protocol (NTP) settings. Refer to ”Setting the Date/Time and Enabling NTP Client” on page 4-16 for more information. Firmware load and activation. Refer to ”Installing Firmware” on page 4-44 more information.
4 – Managing Switches Archiving a Switch 4.8.2 Select Source Dialog The Select Source dialog enables you to select the initial zoning configuration to be loaded into the Edit Zoning dialog when making zoning changes to all switches in a stack. The Select Source dialog is only displayed if the zoning configuration on all switches in the stack is not identical.
4 – Managing Switches Restoring a Switch 4.10 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 switch only with an archive from a SANbox 5600 Series...
Page 145
4 – Managing Switches Restoring a Switch 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 – Managing Switches Restoring the Factory Default Configuration 4.11 Restoring the Factory Default Configuration You can restore the switch and port configuration settings to the factory default values. To restore the factory configuration on a switch, open the Switch menu and select Restore Factory Defaults.
Page 147
4 – Managing Switches Restoring the Factory Default Configuration Table 4-9. Factory Default Configuration Settings (Continued) Setting Value Network Discovery Static Remote Logging False Remote Logging Host Ip Address 10.0.0.254 NTP Client Enabled False NTP Server IP Address 10.0.0.254 Contact Undefined Location Undefined...
4 – Managing Switches Downloading a Support File 4.12 Downloading a Support File The Download Support File menu option assembles all log files and switch memory data into a core dump file (dump_support.tgz). This file can be sent to technical support personnel for troubleshooting switch problems. The menu option is not accessible (displayed) for switches that don't support the download support file function.
4 – Managing Switches Upgrading the Switch Using License Keys To upgrade the switch, do the following: Isolate the switch from the fabric. Add a fabric with the IP address of the switch you want to upgrade. Open the faceplate display for the switch you want to upgrade. Open the Switch Menu and select Features to open the Feature Licenses dialog shown in Figure...
4 – Managing Switches Installing Firmware 4.14 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.
4 – Managing Switches Displaying Hardware Status To install firmware, do the following: In the faceplate display, open the Switch menu and select Load Firmware. In the Firmware Upload dialog, click the Browse button to browse and select the firmware file to be uploaded. Click the Start button to begin the firmware load process.
Section 5 Managing Ports This section describes the following tasks that manage ports and devices: Displaying Port Information Configuring Ports Using the Extended Credits Wizard Resetting a Port Testing Ports Graphing Port Performance Displaying Port Information Port information is available primarily in the faceplate display shown in Figure 5-1.
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.
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.
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. Port Transceiver Media View Media Icon Description Optical SFP, Online (Green)
5 – Managing Ports Displaying Port Information 5.1.2 Port Statistics Data Window The Port Statistics data window displays statistics about port performance. To open the Port Statistics window, select one or more ports in the faceplate display and click the Port Stats tab below the data window. Table 5-5 describes the Port Statistics data window entries.
Page 158
5 – Managing Ports Displaying Port Information Table 5-5. Port Statistics Data Window Entries (Continued) Entry Description Class 3 Toss Number of class 3 frames that were discarded by this port. A frame can be discarded because of detection of a missing frame (based on SEQ_CNT), detection of an E_D_TOV time- out, receiving a reject frame, or receiving a frame on an offline port.
Page 159
5 – Managing Ports Displaying Port Information Table 5-5. Port Statistics Data Window Entries (Continued) Entry Description LIP(f8,AL_PS) This LIP denotes a loop failure detected by the L_port identi- fied by AL_PS. LIP(f8,f7) A loop initialization primitive frame used to indicate that a Loop Failure has been detected at its receiver and does not have a valid AL_PA.
5 – Managing Ports Displaying Port Information 5.1.3 Port Information Data Window The Port Information data window displays detail information for the selected port. To open the Port Information data window, click the Port Info tab below the data window in the faceplate display. Table 5-6.
Page 161
5 – Managing Ports Displaying Port Information Table 5-6. Port Information Data Window Entries (Continued) Entry Description E Port Isolation Reason Why E_Port is isolated. MFS Mode Multiple Frame Sequence bundling status. I/O Stream Guard RSCN message suppression status. Sta- tus can be enabled, disabled, or automati- cally determined by the switch.
5 – Managing Ports Configuring Ports Table 5-6. Port Information Data Window Entries (Continued) Entry Description Media Part Number The part number assigned to the SFP Media Revision Transceiver hardware version Configuring Ports The port settings or characteristics for 1/2/4-Gbps and 10-Gbps ports are configured using the Port Properties dialogs shown in Figure 5-2.
5 – Managing Ports Configuring Ports 5.2.1 Changing Port Administrative States The port administrative state determines the operational state of a port. The port administrative state has two forms: the configured administrative state and the current administrative state. The configured administrative state is the state that is saved in the switch configuration and is preserved across switch resets.
5 – Managing Ports Configuring Ports 5.2.2 Changing Port Speeds The 1/2/4-Gbps ports are capable of transmitting and receiving at 1-Gbps, 2-Gbps, or 4-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.
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: Select one or more ports in the faceplate display.
Disable: Allows free transmission and reception of RSCN messages. Auto: Suppresses the reception of RSCN messages when the port is connected to an initiator device with a QLogic HBA. For older QLogic HBAs, such as the QLA2200, Device Scan must be enabled. The default is Auto.
5 – Managing Ports Using the Extended Credits Wizard Using the Extended Credits Wizard Each 1/2/4-Gbps port is supported by a data-buffer with a 16-credit capacity; that is, 16 maximum sized frames. For fiber optic cables, this enables full bandwidth service over the following distances: 26 kilometers at 1-Gbps (0.6 credits per Km) 13 kilometers at 2-Gbps (1.2 credits per Km)
5 – Managing Ports Resetting a Port Figure 5-3. Designate Donor Ports Verify Requested Changes: Review the extended distance requests and the selected donor ports. Click the Finish button to apply the changes, and redistribute the credits. NOTE: As credits are used, the Logged-In LEDs on the corresponding donor ports illuminate continuously.
5 – Managing Ports Testing Ports Testing Ports The port loopback tests verify correct port operation by sending a frame out through the loop, and then verifying that the frame received matches the frame that was sent. Only one port can be tested at a time for each type of test. The Port Loopback Test dialog shown in Figure 5-4 presents the following loopback tests:...
Page 170
5 – Managing Ports Testing Ports Node-to-Node (Online) - The Node-to-Node test verifies communications between the port and its device node or device loop. The port being tested must be online and connected to a remote device. The port passes the test if the frame that was sent by the ASIC matches the frame that was received.
5 – Managing Ports Graphing Port Performance 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.
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 for a Switch Printing Graphs...
5 – Managing Ports Graphing Port Performance 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.
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 Fabric File Encryption Key field, enter the encryption key and click the Load View File button.
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: Open the File menu and select Save Default Performance View File to open the Save Default Performance View File dialog.
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: Open the Graph menu, and select Set Polling Frequency to open the Set Graph Polling Frequency dialog.
5 – Managing Ports Graphing Port Performance 5.6.7.1 Displaying Graphs for a Stack Graphs can be displayed for all ports on all switches in a stack or for only those ports on all switches that are logged in. To display graphs for a stack of switches, do the following: In the left-pane/fabric tree, right-click on a Stack icon.
5 – Managing Ports Graphing Port Performance 5.6.7.3 Customizing Graphs You can customize the graph polling frequency, what is plotted in the graphs, and the graph color scheme. To set the polling frequency for all graphs, open the Graph menu and select Set Polling Frequency..Enter an interval in seconds (0–60) in the dialog box and click the OK button.
Page 179
5 – Managing Ports Graphing Port Performance Choose what data type to plot. For example, if you selected Show Frames Data on Graph in step 1., you can plot one or all of the following: Total frames transmitted and received (Total Frames) Total frames transmitted (Total Tx Frames) Total frames received (Total Rx Frames) In addition to these, you can also plot total errors by selecting the Total...
5 – Managing Ports Graphing Port Performance 5.6.7.4 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.
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 – Command Line Interface User Accounts 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.
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 – Command Line Interface Working with Switch Configurations 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.
Page 185
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.
A – Command Line Interface Commands 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].
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.
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.
Page 190
A – Command Line Interface Alias Command delete [alias] Deletes the specified alias given by [alias] from the zoning database. If the alias is a member of the active zone set, the alias will not be removed from the active zone set until the active zone set is deactivated.
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-13 for information about creating and modifying CIM listeners. Refer to the ”CIMSubscription Command” on page A-15 for information about creating and modifying CIM subscriptions.
Page 192
A – Command Line Interface CIM Command The following is an example of the CIM Limits command: SANbox xxxx #> cim limits Cim Attribute Maximum ------------- ------- MaxListeners MaxSubscriptions MaxSubscriptionsPerListener A-12 59097-02 B...
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-15 for information about configuring subscriptions. Authority Admin session and a CIM Edit session. Refer to the ”CIM Command”...
A – Command Line Interface CIMListener Command edit [listener_name] Opens an editing session in which you can modify the CIM listener given by [listener_name]. Refer to Table A-3 for a description of the CIM listener configuration parameters. Examples The following is an example of the CIMListener Create command: SANbox xxxx (admin-cim) #>...
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. Syntax cimsubscription create [subscription_name] delete [subscription_name]...
Page 196
A – Command Line Interface CIMSubscription Command edit [subscription_name] Opens an editing session in which you can modify the CIM subscription given by [subscription_name]. Refer to Table A-4 for a description of the CIM subscription configuration parameters. Examples The following is an example of the CIMSubscription Create command: SANbox xxxx (admin-cim) #>...
A – Command Line Interface Config Command Config Command Manages the Fibre Channel configurations on a switch. For information about setting the port and switch configurations, refer to the ”Set Config Command” on page A-64. Authority Admin session for all keywords except List Syntax config activate [config_name]...
Page 198
A – Command Line Interface Config Command edit [config_name] Opens an edit session for the configuration given by [config_name]. If you omit [config_name], the currently active configuration is used. list Displays a list of all available configurations on the switch. This keyword does not require an admin session.
Page 199
A – Command Line Interface Config Command The following is an example of how to create a backup file (configdata) and download the file to the workstation. SANbox xxxx #> admin start SANbox xxxx (admin) #> config backup SANbox xxxx (admin) #> admin end SANbox xxxx #>...
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.
Page 201
A – Command Line Interface Create Command Examples The following is an example of the Create Support command when an FTP server is available on the workstation: SANbox xxxx (admin) #> create support Log Msg:[Creating the support file - this will take several seconds] FTP the dump support file to another machine? (y/n): y Enter IP Address of remote computer: 10.20.33.130 Login name: johndoe...
Page 202
A – Command Line Interface Create Command The following is an example of the Create Support command and how to download the support file to your workstation. When prompted to send the support file to another machine, decline, then close the Telnet session. Open an FTP session on the switch and log in with the account name images and password images.
A – Command Line Interface Date Command Date Command This command displays or sets the system date and time. To set the date and time the information string must be provided in this format: MMDDhhmmCCYY. The new date and time takes effect immediately. Authority Admin session except to display the date.
A – Command Line Interface Feature Command Feature Command Adds license key features to the switch and displays the license key feature log. To order a license key contact your switch distributor or your authorized reseller. Upgrading a switch is not disruptive, nor does it require a switch reset. Authority Admin session for Add keyword only Syntax...
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. This reset is disruptive. To perform a non-disruptive firmware installation, refer to the ”Image Command”...
A – Command Line Interface Group Command 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-54 for information about starting a Security Edit session.
A – Command Line Interface Group Command Keywords 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 – Command Line Interface Group Command Table A-6. Port Group Member Attributes Attribute 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 Chal- lenge Handshake Authentication Protocol (CHAP).
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 dis- ables (False) authentication for MS group members. The default is False.
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.
Page 211
A – Command Line Interface Group Command Table A-8. Group Member Attributes (Continued) Attribute Description Binding Domain ID of the switch to which to bind the ISL group mem- ber worldwide name. This option is available only if Fab- (ISL Groups) ricBindingEnabled is set to True using the Set Config Security command.
Page 212
A – Command Line Interface Group Command Examples The following is an example of the Group Add command: SANbox xxxx (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.
Page 213
A – Command Line Interface Group Command The following is an example of the Group List command: SANbox xxxx #> group list Group SecuritySet ----- ----------- group1 (ISL) alpha group2 (Port) alpha The following is an example of the Group Members command: SANbox xxxx #>...
A – Command Line Interface Hardreset Command Hardreset Command Resets the switch and performs a power-on self test. This reset disrupts traffic, activates the pending firmware, and clears the alarm log. To save the alarm log before resetting, refer to the ”Set Log Command”...
A – Command Line Interface Help Command Help Command Displays a brief description of the specified command, its keywords, and usage. Authority None Syntax help [command] [keyword] Keywords [command] Displays a summary of the command given by [command] and its keywords. If you omit [command], the system displays all available commands.
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 history Notes Use the History command to provide context for the ! command: Enter ![command_string] to re-execute the most recent command that matches [command_string].
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.
A – Command Line Interface Image Command Image Command Manages and installs switch firmware. Authority Admin session Syntax image cleanup fetch [account_name] [ip_address] [file_source] [file_destination] install list unpack [file] Keywords cleanup Removes all firmware image files from the switch. All firmware image files are removed automatically each time the switch is reset.
Page 219
A – Command Line Interface Image Command Notes To provide consistent performance throughout the fabric, ensure that all switches are running the same version of firmware. To perform a non-disruptive firmware installation and activation, do the following: Connect to the switch through the Ethernet port or the serial port. Move to the folder or directory on the workstation that contains the new firmware image file.
Page 220
A – Command Line Interface Image Command Unpack the firmware image file to install the new firmware in flash memory. SANbox xxxx (admin) $>image unpack filename Wait for the unpack to complete. image unpack command result: Passed A message will prompt you to reset the switch to activate the firmware. Resetting the switch is disruptive.
A – Command Line Interface Lip Command Lip Command Reinitializes the specified loop port. Authority Admin session Syntax lip [port_number] Keywords [port_number] The number of the port to be reinitialized. Ports are numbered beginning with 0. Examples The following is an example of the Lip command: SANbox xxxx (admin) #>...
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 passwd [account_name] Keywords [account_name] The user account name.
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 ping [ip_address] Keywords [ip_address] The IP address of the switch to query. Broadcast IP addresses, such as 255.255.255.255, are not valid.
A – Command Line Interface Ps Command Ps Command Displays current system process information. Authority None Syntax Examples The following is an example of the Ps command: SANbox xxxx #> ps PPID %CPU TIME ELAPSED COMMAND 0.0 00:00:00 3-01:18:35 cns 0.0 00:00:01 3-01:18:35 ens 0.0 00:00:21...
A – Command Line Interface Quit Command Quit Command Closes the Telnet session. Authority None Syntax quit, exit, or logout Notes You can also enter Control-D to close the Telnet session. 59097-02 B A-45...
A – Command Line Interface Reset Command Reset Command Resets the switch configuration parameters. If you omit the keyword, the default is Reset Switch. Authority Admin session Syntax reset config [config_name] factory port [port_number] radius security services snmp switch (default) system zoning Keywords...
Page 227
A – Command Line Interface Reset Command radius Resets the RADIUS configuration to the default values as described in Table A-14. security Clears the security database and deactivates the active security set. The security configuration value, autosave, and fabric binding remain unchanged. services Resets the switch services configuration to the default values as described in Table...
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. Switch Configuration Defaults Parameter Default Admin State Online Broadcast Enabled True InbandEnabled True...
A – Command Line Interface Reset Command Enter the Show Config Port command to display port configuration values. Table A-10. Port Configuration Defaults Parameter 1/2/4-Gbps Port Defaults 10-Gbps Port Defaults Admin State Online Online Link Speed Auto 10-Gbps Port Type Symbolic Name Portn, where n is the port 10G-n, where n is the port...
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...
A – Command Line Interface Security Command 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-26 and the ”Securityset Command” on page A-58. Authority Admin session.
Page 235
A – Command Line Interface Security Command edit Initiates a Security Edit session in which to make changes to the security database. A Security Edit session enables you to use the Group and Securityset commands to create, add, and delete security sets, groups, and group members. To close a Security Edit session and save changes, enter the Security Save command.
Page 236
A – Command Line Interface Security Command Examples The following is an example of the Security Active command: SANbox xxxx #> security active Active Security Information SecuritySet Group GroupMember ----------- ----- ----------- alpha group1 (ISL) 10:00:00:00:00:10:21:16 Authentication Chap Primary Hash Primary Secret ******** Secondary Hash...
Page 237
A – Command Line Interface Security Command The following is an example of the Security Limits command: SANbox xxxx #> security limits Security Attribute Maximum Current [Name] ------------------ ------- ------- ------ MaxSecuritySets MaxGroups MaxTotalMembers 1000 MaxMembersPerGroup 1000 group1 group2 The following is an example of the Security List command: SANbox xxxx (admin-security) #>...
A – Command Line Interface Securityset Command 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-54 for information about starting a Security Edit session. The Active, Groups, and List keywords are available without an Admin session.
Page 239
A – Command Line Interface Securityset Command create [security_set] Creates the security set with the name given by [security_set]. A security set name must begin with a letter and be no longer than 64 characters. Valid characters are 0-9, A-Z, a-z, _, $, ^, and -. The security database supports a maximum of 4 security sets.
Page 240
A – Command Line Interface Securityset Command The following is an example of the Securityset Groups command SANbox xxxx #> securityset groups alpha Current list of Groups for SecuritySet: alpha --------------------------------------- group1 (ISL) group2 (Port) The following is an example of the Securityset List command SANbox xxxx #>...
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 alarm [option] beacon [state] config [option] log [option] pagebreak [state] port [option]...
Page 242
A – Command Line Interface Set Command log [option] Specifies the type of entries to be entered in the event log. Refer to the ”Set Log Command” on page A-76. pagebreak [state] Specifies how much information is displayed on the screen at a time according to the value given by [state].
Page 243
A – Command Line Interface Set Command timezone Specifies the time zone for the switch and the workstation. The default is Universal Time (UTC) also known as Greenwich Mean Time (GMT). This keyword prompts you to choose a region, then a subregion to specify the time zone. Examples The following examples enables and disables the beacon: SANbox xxxx #>...
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.
Page 245
A – Command Line Interface Set Config Command Table A-18. Set Config Port Parameters (Continued) Parameter Description LinkSpeed Transmission speed: 1/2/4-Gbps Ports: 1-Gbps, 2-Gbps, 4-Gbps, or Auto. The default is Auto. 10-Gbps Ports: 10-Gbps PortType Port type: 1/2/4-Gbps Ports: GL, G, F, FL, Donor. The default is GL. 10-Gbps Ports: G SymbolicPortName Descriptive name for the port.
Page 246
Auto – Suppresses the reception of RSCN messages when the port is connected to an initiator device with a QLogic HBA. For older QLogic HBAs, such as the QLA2200, the DeviceScanEnabled parameter must also be enabled. The default is Auto.
A – Command Line Interface Set Config Command Table A-18. Set Config Port Parameters (Continued) Parameter Description PDISCPingEnable Enables (True) or disables (False) the transmission of ping messages from the switch to all devices on a loop port. The (1/2/4-Gbps ports only) default is True.
Page 248
A – Command Line Interface Set Config Command Table A-20. Set Config Switch Parameters (Continued) Parameter Description InbandEnabled Inband management. Enables (True) or disables (False) the ability to manage the switch over an ISL. The default is True. FDMIEnabled Fabric Device Monitoring Interface. Enables (True) or disables (False) the monitoring of target and initiator device information.
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.
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.
Page 251
A – Command Line Interface Set Config Command Examples The following is an example of the Set Config Port command: SANbox xxxx #> admin start SANbox xxxx (admin) #> config edit SANbox xxxx (admin-config) #> set config port 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.
Page 252
A – Command Line Interface Set Config Command The following is an example of the Set Config Port command for a 10-Gbps port: SANbox xxxx #> admin start SANbox xxxx (admin) #> config edit SANbox xxxx (admin-config) #> set config port 16 A list of attributes with formatting and current values will follow.
Page 253
A – Command Line Interface Set Config Command The following is an example of the Set Config Security command: SANbox xxxx #> admin start SANbox xxxx (admin) #> config edit SANbox xxxx (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.
Page 254
A – Command Line Interface Set Config Command The following is an example of the Set Config Threshold command: SANbox xxxx #> admin start SANbox xxxx (admin) #> config edit SANbox xxxx (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.
Page 255
A – Command Line Interface Set Config Command The following is an example of the Set Config Zoning command. SANbox xxxx #> admin start SANbox xxxx (admin) #> config edit SANbox xxxx (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.
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.
Page 257
A – Command Line Interface Set Log Command Eport Monitors all E_Ports. Mgmtserver Monitors management server status. Nameserver Monitors name server status. None Monitor none of the component events. Other Monitors other miscellaneous events. Port Monitors all port events. SNMP Monitors all SNMP events.
Page 258
A – Command Line Interface Set Log Command None Specifies no severity levels for display on the screen. 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.
Page 259
A – Command Line Interface Set Log Command save Saves the log settings for the component, severity level, port, and display level. These settings remain in effect after a switch reset. The log settings can be viewed using the Show Log Settings command. To export log entries to a file, use the Set Log Archive command.
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]...
Page 261
A – Command Line Interface Set Port Command Auto The port speed is automatically detected. This applies only to ports 0–15. 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.
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.
Page 263
A – Command Line Interface Set Setup Command Table A-23. RADIUS Service Settings (Continued) Entry Description ServerUDPPort User Datagram Protocol (UDP) port number on the RADIUS server. The default is 1812. DeviceAuthServer Enable (True) or disable (False) this server for device authentication.
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;...
Page 265
A – Command Line Interface Set Setup Command Table A-24. Switch Services Settings (Continued) Entry 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.
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.
A – Command Line Interface Set Setup Command Table A-25. SNMP Configuration Settings (Continued) 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 (,).
Page 268
A – Command Line Interface Set Setup Command Table A-26. System Configuration Settings (Continued) Entry Description LocalLogEnabled Enables (True) or disables (False) the saving of log infor- mation 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 sys- log protocol.
Page 269
A – Command Line Interface Set Setup Command Examples The following is an example of the Set Setup RADIUS command: SANbox xxxx (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.
Page 270
A – Command Line Interface Set Setup Command The following is an example of the Set Setup SNMP command: SANbox xxxx #> admin start SANbox xxxx (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.
Page 271
A – Command Line Interface Set Setup Command The following is an example of the Set Setup System command: SANbox xxxx (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.
A – Command Line Interface Show Command Show Command Displays fabric, switch, and port operational information. Authority None Syntax show about alarm [option] audit broadcast chassis cimlistener [listener_name] cimsubscription [subscription_name] config [option] domains donor fabric fdmi [port_wwn] interface log [option] lsdb mem [count] ns [option]...
Page 273
A – Command Line Interface Show Command 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.
Page 274
A – Command Line Interface Show Command fdmi [port_wwn] Displays detailed information about the device host bus adapter given by [port_wwn]. If you omit [port_wwn], the command displays a summary of host bus adapter information for all attached devices in the fabric. Illegal characters in the display appear as question marks (?).
A – Command Line Interface Show Command pagebreak Displays the current pagebreak setting. The pagebreak setting limits the display of information to 20 lines (On) or allows the continuous display of information without a break (Off). perf [option] Displays performance information for all ports. Refer to the ”Show Perf Command”...
Page 276
A – Command Line Interface Show Command Table A-27. Show Port Parameters (Continued) Entry Description InvalidDestAddr Invalid destination address detected. LIP_AL_PD_ALPS Number of F7, AL_PS LIPs, or AL_PD (vendor specific) resets, performed. LIP_F7_AL_PS This LIP is used to reinitialize the loop. An L_Port, identified by AL_PS, may have noticed a performance degradation and is trying to restore the loop.
Page 277
A – Command Line Interface Show Command Table A-27. Show Port Parameters (Continued) Entry Description TotalLinkResets Total number of link reset primitives. TotalOfflineSeq Total number of Offline Sequences issued and received by this port. TotalRxFrames Total number of frames received by this port. TotalRxWords Total number of words received by this port.
A – Command Line Interface Show Command Securityset (Active, List) Show (About, Alarm, Backtrace, Chassis, Config Port, Config Security, Config Switch, Config Threshold, Dev, Dev Settings, Domains, Donor, Fabric, Log, Log Archive, Log Settings, Lsdb, Mem, Ns, Perf, Port, Setup Mfg, Setup Snmp, Setup System, Steering, Switch, Topology, Users) Uptime User Accounts...
Page 279
A – Command Line Interface Show Command Table A-28. Switch Operational Parameters (Continued) Parameter Description PendingImageVersion - build date Firmware image version and build date that is pending. This image will become active at the next reset or power cycle. ActiveConfiguration Name of the switch configuration that is in use.
Page 280
Sb2 .108 The following is an example of the Show FDMI command: SANbox xxxx #> show fdmi HBA ID PortID Manufacturer Model Ports -------- ------ --------------- ------- ----- 21:01:00:e0:8b:27:aa:bc 610000 QLogic Corporation QLA2342 21:00:00:00:ca:25:9b:96 180100 QLogic Corporation QL2330 A-100 59097-02 B...
Page 281
The following is an example of the Show FDMI WWN command: SANbox xxxx #> show fdmi 21:00:00:e0:8b:09:3b:17 FDMI Information ---------------- Manufacturer QLogic Corporation SerialNumber [04202 Model QLA2342 ModelDescription QLogic QLA2342 PCI Fibre Channel Adapter PortID 610000 NodeWWN 20:00:00:e0:8b:07:aa:bc HardwareVersion FC5010409-10 DriverVersion 8.2.3.10 Beta 2 (W2K VI) OptionRomVersion 1.21 FirmwareVersion 03.02.13.
Page 282
A – Command Line Interface Show Command The following is an example of the Show NS [domain_ID] command: SANbox xxxx #> show ns 18 Seq Domain Port Port Type COS PortWWN NodeWWN --- ------ ------ ---- --- ------- ------- 18 (0x12) 120700 N 21:00:00:e0:8b:07:a7:bc 20:00:00:e0:8b:07:a7:bc The following is an example of the Show NS [port_ID] command: SANbox xxxx #>...
Page 283
A – Command Line Interface Show Command The following is an example of the Show Port command: SANbox xxxx #> show port 1 Port Number: 1 ------------ AdminState Online OperationalState Online AsicNumber PerfTuningMode Normal AsicPort PortID 0e0800 ConfigType PortWWN 20:08:00:c0:dd:03:d5:94 DiagStatus Passed RunningType...
Page 284
A – Command Line Interface Show Command The following is an example of the Show Switch command: SANbox xxxx #> show switch Switch Information ------------------ SymbolicName sw .108 SwitchWWN 100000c0dd00bc56 SwitchType SANbox 5600 Series BootVersion Vx.x.x.x-0 (day month date time year) CreditPool DomainID 19 (0x13)
Page 285
A – Command Line Interface Show Command The following is an example of the Show Topology command for port 1: SANbox xxxx #> show topology 1 Local Link Information ---------------------- PortNumber 1 PortID 650100 PortWWN 20:01:00:c0:dd:00:91:11 PortType Remote Link Information ----------------------- Device 0 NodeWWN 50:80:02:00:00:06:d5:38...
Page 286
A – Command Line Interface Show Command The following is an example of the Show Version command: SANbox xxxx #> show version ***************************************************** Command Line Interface SHell (CLISH) ***************************************************** SystemDescription SANbox 5600 Series FC Switch Eth0NetworkAddress 10.20.11.192 (use 'set setup system' to update) MACAddress 00:c0:dd:00:71:ee WorldWideName...
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.
Page 288
A – Command Line Interface Show Config Command Examples The following is an example of the Show Config Port command: SANbox xxxx #> show config port 3 Port Number: 3 ------------ AdminState Offline LinkSpeed Auto PortType SymbolicName Port3 ALFairness False DeviceScanEnabled True ForceOfflineRSCN...
Page 289
A – Command Line Interface Show Config Command The following is an example of the Show Config Switch command: SANbox xxxx #> show config switch Configuration Name: default ------------------- Switch Configuration Information -------------------------------- AdminState Online BroadcastEnabled False InbandEnabled True FDMIEnabled False FDMIEntries DomainID...
Page 290
A – Command Line Interface Show Config Command The following is an example of the Show Config Threshold command: SANbox xxxx #> show config threshold Configuration Name: default ------------ Threshold Configuration Information ----------------------------------- ThresholdMonitoringEnabled False CRCErrorsMonitoringEnabled True RisingTrigger FallingTrigger SampleWindow DecodeErrorsMonitoringEnabled True RisingTrigger FallingTrigger...
A – Command Line Interface Show Log Command 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.
Page 292
A – Command Line Interface Show Log Command Other Monitors other miscellaneous events. Port Monitors all port events SNMP SNMP events. Switch Monitors switch management events. Zoning Monitors zoning conflict events. display [filter] Displays log events on the screen according to the component or severity level filter given by [filter].
Page 293
A – Command Line Interface Show Log Command Switch Displays all events related to switch management. Zoning Displays all events related to zoning. level Displays the event severity level logging setting and the display level setting. options Displays the options that are available for configuring event logging and automatic display to the screen.
Page 294
A – Command Line Interface Show Log Command The following is an example of the Show Log command: SANbox xxxx #> show log [327][day month date time year][I][Eport Port:0/8][Eport State= E_A0_GET_DOMAIN_ID] [328][day month date time year][I][Eport Port: 0/8][FSPF PortUp state=0] [329][day month date time year][I][Eport Port: 0/8][Sending init hello] [330][day month date time year][I][Eport Port: 0/8][Processing EFP, oxid= 0x8] [331][day month date time year][I][Eport Port: 0/8][Eport State = E_A2_IDLE]...
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...
Page 296
A – Command Line Interface Show Perf Command outframe [port_number] Displays continuous performance data in frames/second transmitted for the port group (0–15 or 16–19) that includes [port_number]. If you omit [port_number], ports 0–15 are displayed. Type “q” and press the Enter key to stop the display. errors [port_number] Displays continuous error counts for the port group (0–15 or 16–19) that includes [port_number].
Page 297
A – Command Line Interface Show Perf Command The following is an example of the Show Perf Byte command: SANbox xxxx #> show perf byte Displaying bytes/sec (total)... (Press any key to stop display) -------------------------------------------------------------------------------- 137M 58K 137M 136M 58K 136M 135M 58K 135M...
Displays the current SNMP settings. system Displays the current system settings. Examples The following is an example of the Show Setup Mfg command: SANbox xxxx #> show setup mfg Manufacturing Information ------------------------- BrandName QLogic BuildDate Unknown PartNumber SANbox 5602 SerialNumber FAM0331000011 LicensedPorts MACAddress...
Page 299
A – Command Line Interface Show Setup Command The following is an example of the Show Setup Services command: SANbox xxxx #> show setup services System Services ----------------------------- TelnetEnabled True SSHEnabled False GUIMgmtEnabled True SSLMgmtEnabled False EmbeddedGUIEnabled True SNMPEnabled True NTPEnabled True CIMEnabled...
Page 300
A – Command Line Interface Show Setup Command The following is an example of the Show Setup Snmp command: SANbox xxxx #> show setup snmp SNMP Information ---------------- SNMPEnabled True Contact <sysContact undefined> Location N_107 System Test Lab Description SANbox 5602 FC Switch Trap1Address 10.0.0.254 Trap1Port...
Page 301
A – Command Line Interface Show Setup Command The following is an example of the Show Setup System command: SANbox xxxx #> show setup system System Information ------------------ Eth0NetworkDiscovery Static Eth0NetworkAddress 10.20.11.32 Eth0NetworkMask 255.255.252.0 Eth0GatewayAddress 10.20.8.254 AdminTimeout InactivityTimeout LocalLogEnabled True RemoteLogEnabled False RemoteLogHostAddress...
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 shutdown Notes Always use this command to perform an orderly shut down before removing power from the switch.
A – Command Line Interface Test Command Test Command Tests ports using internal (SerDes level), external (transceiver), and online loopback tests. Internal and external tests require that the port be placed in diagnostic mode. Refer to the ”Set Command” on page A-61 for information about changing the port administrative state.
Page 304
A – Command Line Interface Test Command cancel Cancels the online test in progress. status Displays the status of a test in progress, or if there is no test in progress, the status of the test that was executed last. Examples To run an internal or external port test, do the following: To start an admin session, enter the following command and press the Enter...
Page 305
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: To start an admin session, enter the following command and press the Enter key.
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. Authority None Syntax...
A – Command Line Interface User Command 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 delete [account_name] edit list...
Page 308
A – Command Line Interface User Command Notes Authority level or password changes that you make to an account that is currently logged in do not take effect until that account logs in again. Examples The following is an example of the User Accounts command: SANbox xxxx (admin) #>...
Page 309
A – Command Line Interface User Command The following is an example of the User Delete command: SANbox xxxx (admin) #> user del user3 The user account will be deleted. Please confirm (y/n): [n] y The following is an example of the User List command: SANbox xxxx (admin) #>...
A – Command Line Interface Whoami Command Whoami Command Displays the account name, session number, and switch domain ID for the Telnet session. Authority None Syntax whoami Examples The following is an example of the Whoami command: SANbox xxxx #> whoami User name : admin@session2 Switch name...
A – Command Line Interface Zone Command 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-138 for information about starting a Zoning Edit session. The List, Members, and Zonesets keywords are available without an Admin session.
Page 312
A – Command Line Interface Zone Command delete [zone] Deletes the specified zone given by [zone] from the zoning database. If the zone is a component of the active zone set, the zone will not be removed from the active zone set until the active zone set is deactivated. list Displays a list of all zones and the zone sets of which they are components.
Page 313
A – Command Line Interface Zone Command Examples The following is an example of the Zone List command: SANbox xxxx #> 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...
Page 314
A – Command Line Interface Zone Command The following is an example of the Zone Zonesets command: SANbox xxxx #> zone zonesets zone1 Current List of ZoneSets for Zone: zone1 ---------------------------------- zone_set_1 A-134 59097-02 B...
A – Command Line Interface Zoneset Command 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-138 for information about starting a Zoning Edit session. The Active, List, and Zones keywords are available without an Admin session.
Page 316
A – Command Line Interface Zoneset Command deactivate Deactivates the active zone set. Close the Zoning Edit session before using this keyword. delete [zone_set] Deletes the zone set given by [zone_set]. If the specified zone set is active, the command is suspended until the zone set is deactivated. list Displays a list of all zone sets.
Page 317
A – Command Line Interface Zoneset Command The following is an example of the Zoneset Zones command: SANbox xxxx #> zoneset zones ssss Current List of Zones for ZoneSet: ssss ---------------------------------- zone1 zone2 zone3 59097-02 B A-137...
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-131 and the ”Zoneset Command” on page A-135. Authority Admin session except for the Active, History, Limits, and List keywords.
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.
Page 320
A – Command Line Interface Zoning Command save Saves changes made during the current Zoning Edit session. The system informs you that the zone set must be activated to implement any changes. This does not apply if you entered the Zoning Clear command during the Zoning Edit session. Examples The following is an example of the Zoning Edit command: SANbox xxxx #>...
Page 321
A – Command Line Interface Zoning Command The following is an example of the Zoning List command: SANbox xxxx #> zoning list Active ZoneSet Information ZoneSet Zone ZoneMember -------------------------------- 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...
Page 322
A – Command Line Interface Zoning Command Notes A-142 59097-02 B...
Page 323
Glossary Access Control List Zone Arbitrated Loop Access Control List zoning divides the A Fibre Channel topology where ports use fabric for purposes of controlling discovery arbitration to establish a point-to-point and inbound traffic. circuit. Active Zone Set Arbitrated Loop Physical Address (AL_PA) The zone set that defines the current A unique one-byte value assigned during zoning for the fabric.
Page 324
SANbox 5600 Series Switch Management User’s Guide Class 3 Service Fabric View File A service which multiplexes frames at A file containing a set of fabrics that were frame boundaries to or from one or more opened and saved during a previous N_Ports without acknowledgment.
Page 325
SANbox 5600 Series Switch Management User’s Guide In-Order-Delivery Mesh Topology A feature that requires that frames be A fabric in which each chassis has at least received in the same order in which they one port directly connected to each other were sent.
Page 326
SANbox 5600 Series Switch Management User’s Guide Small Form-Factor Pluggable Zoning Database A transceiver device, smaller than a The set of zone sets, zones, and aliases GigaBit Interface Converter, that plugs into stored on a switch. the Fibre Channel port. SNMP Simple Network Management Protocol Soft Zone...
Page 327
Index authentication A-28 device 3-1 access control list zone 3-41, 3-56 trap 4-33 account name user 3-1 display A-127, A-130 authority A-6 factory A-2 auto save active zone set 3-35, 3-41 default fabric view file 2-16 Active Zoneset data window 3-35 graphing options 5-23 Admin zoning configuration 3-47...
Page 329
SANbox 5600 Series Switch Management User’s Guide event logging fabric view file 5-22 by component A-76, A-111 auto save 5-23 by port A-78, A-113 open 3-24 by severity level A-113 password 5-21 display A-111 save 3-25 restore defaults A-78 faceplate display save settings A-79 data window 2-29 settings A-113...
Page 330
SANbox 5600 Series Switch Management User’s Guide group internal test 5-17 add member 3-15, A-27 internet browser 2-2 copy A-29 interoperability 4-25 create 3-12, A-29 display 3-17 address 4-30 display member 3-17 configuration 4-30 edit member attributes 3-16, A-30 IP address A-87 list A-31 ISL group A-29 list members A-31...
Page 331
SANbox 5600 Series Switch Management User’s Guide loopback test 5-17 nickname loss of signal monitoring 4-14 create 3-37 delete 3-38 edit 3-38 export 3-38 import 3-39 Management Server node-to-node test 5-18 group A-29 non-disruptive activation A-37 service 4-28, A-85 Non-disruptive code load and activation 4-16 manufacturer information A-118 NTP - See Network Time Protocol mask address A-87...
Page 332
SANbox 5600 Series Switch Management User’s Guide port administrative state 5-11, A-81 Quit command A-45 buffer credits 5-15 configuration 5-10, A-64 configuration defaults A-49 configuration display A-107 counters A-80 RADIUS - See Remote Authentication Dial-In displaying information 5-1 User Service external test A-123 RADIUS server group A-29...
Page 335
SANbox 5600 Series Switch Management User’s Guide user account add A-127 Telnet admin A-2 service 4-28, A-84 admin account A-2 session timeout A-87 create 4-3 Test command A-123 default 4-2 testing ports 5-17 delete A-127 time 4-16, A-23 display A-127 time zone A-63 edit A-127 timeout...
Page 336
SANbox 5600 Series Switch Management User’s Guide zone set activate 3-51, A-135 zone active 3-35, 3-41, A-138 access control list 3-41 add member zone A-135 add member port 3-54, A-131 copy A-135 copy 3-51, A-131 create 3-50, A-135 create 3-53, A-131 deactivate 3-51, A-47, A-136 definition 3-40 definition 3-41...
Need help?
Do you have a question about the SANbox 5600 Series and is the answer not in the manual?
Questions and answers