Page 1 S i m p l i f y SANbox 1400 Series Switch Management User’s Guide Firmware Version 5.0 59226-00 B Page i...
Page 2: Document Revision History
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.
Page 3: Table Of Contents
Table of Contents Section 1 Introduction Intended Audience ..........1-1 Related Materials .
Page 4 SANbox 1400 Series Switch Management User’s Guide 2.11.6 Working Status Indicator ........2-25 2.12 Using the Topology Display .
Page 5 SANbox 1400 Series Switch Management User’s Guide 3.4.2 Displaying the Event Browser .......3-11 3.4.2.1 Filtering the Event Browser .
Page 6 SANbox 1400 Series Switch Management User’s Guide 3.6.5 Managing Zones .........3-33 3.6.5.1 Creating a Zone in a Zone Set .
Page 7 SANbox 1400 Series Switch Management User’s Guide 4.7.2 Switch Properties.........4-18 4.7.2.1 Symbolic Name .
Page 8 SANbox 1400 Series Switch Management User’s Guide 5.2.6 Changing Port Symbolic Name ......5-14 Using the Extended Credits Wizard .
Page 9 SANbox 1400 Series Switch Management User’s Guide Ping Command ......... .A-28 Ps Command.
Page 10 SANbox 1400 Series Switch Management User’s Guide List of Figures Figure Page Initial Startup Dialog ..........2-11 SANsurfer Switch Manager Window .
Page 11 SANbox 1400 Series Switch Management User’s Guide List of Tables Table Page Workstation Requirements ..........2-2 Tool Bar Buttons.
Page 12 SANbox 1400 Series Switch Management User’s Guide Notes Page xii 59226-00 B...
Page 13: Introduction
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 1400 Series Fibre Channel switch (firmware version 5.0). The SANbox 1400 Series switch is a 10 port non-blocking Fibre Channel switch. This manual defines the features, components, and performance characteristics of the SANbox 1400 Series switch.
Page 14: Jdom License
1 – Introduction JDOM License JDOM License This product includes software developed by the JDOM Project (http://www.jdom.org/). Copyright (C) 2000-2002 Brett McLaughlin & Jason Hunter. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions, and the following disclaimer.
Page 15: Technical Support
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. 59226-00 B...
Page 16: Contact Information
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...
Page 18: Using Sansurfer Switch Manager Workstation Requirements
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”...
Page 19: 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 MacOS X workstation. To install the SANsurfer Switch Manager application from the SANsurfer Switch Manager installation disk, Close all programs currently running, and insert the SANsurfer Switch Manager Installation Disk into the management workstation CD-ROM drive.
Page 20: Sansurfer Management Suite
2 – Using SANsurfer Switch Manager Installing the Management Application For a Solaris platform: Open a terminal window. If the disk isn’t already mounted, enter the following command: volcheck Enter following command to move to the directory on the CD that contains the executable: cd /cdrom/cdrom0/Switch_Manager Execute the install program 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.
Page 22: Sms Installation For Linux
2 – Using SANsurfer Switch Manager Installing the Management Application In the SMS install directory, enter the following command to execute the chglax.bat file. If prompted to overwrite an existing file, enter Y to do so. chglax.bat Restart SANsurfer Switch Manager from SANsurfer Management suite as you did in step 7 and confirm that the new version is running.
Page 23 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.
Page 24: Sms Installation For Solaris
2 – Using SANsurfer Switch Manager Installing the Management Application 2.2.2.3 SMS Installation for Solaris To install the SANsurfer Switch Manager application on Solaris from the SANsurfer Management Suite CD-ROM, do the following: Insert the SANsurfer Management Suite Disk into the management workstation CD-ROM drive.
Page 25 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 26: Starting Sansurfer Switch Manager
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.
Page 27: Initial Startup Dialog
2 – Using SANsurfer Switch Manager Starting SANsurfer Switch Manager To start SANsurfer Switch Manager from SANsurfer Management Suite, do the following. Start the SANsurfer Management Suite application using one of the following methods: For Windows, double-click the SANsurfer shortcut, or select SANsurfer from Start menu, depending on how you installed the SANsurfer application.
Page 28: Sansurfer Switch Manager Window
2 – Using SANsurfer Switch Manager Starting SANsurfer Switch Manager Click the Open Existing Fabric radio button to open the Add a New Fabric dialog, which prompts you for a fabric name, IP address, account name, and password. Refer to “Adding a Fabric”...
Page 29: Exiting Sansurfer Switch Manager
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...
Page 30: Load Default Fabric File Dialog
2 – Using SANsurfer Switch Manager Exiting 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.
Page 31: Uninstalling Sansurfer Switch Manager
2 – Using SANsurfer Switch Manager Uninstalling SANsurfer Switch Manager Uninstalling SANsurfer Switch Manager The method you use to uninstall SANsurfer Switch Manager depends on how you installed it: If you installed SANsurfer Switch Manager as part of SANsurfer Management Suite, you must uninstall SANsurfer Management Suite. Refer “SMS Uninstall”...
Page 32: Standalone Uninstall
For Linux: /opt/QLogic_Corporation/SANsurfer_Switch_Manager For Solaris: /usr/opt/QLogic_Corporation/SANsurfer_Switch_Manager For MacOS X: Users/qlogic/Applications/QLogic_Corporation/SANsurfer_Switch_Manager 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...
Page 33: Changing The Encryption Key For The Default Fabric View File
2 – Using SANsurfer Switch Manager Changing the Encryption Key for the Default Fabric View File Changing the Encryption Key for the Default Fabric View File To change the encryption key for the SANsurfer Switch Manager default fabric view file, do the following: Open the File menu and select Save Default Fabric View File to open the Save Default Fabric View File dialog.
Page 34: Setting Sansurfer Switch Manager Preferences
2 – Using SANsurfer Switch Manager Setting SANsurfer Switch Manager Preferences Setting SANsurfer Switch Manager Preferences Using the preferences settings, you can: Change the location of the working directory in which to save files. Change the location of the browser used to view the online help. The Browser Location field is not supported/displayed for Mac OS X platforms.
Page 35: Using Online Help
2 – Using SANsurfer Switch Manager Using Online Help To set preferences for your SANsurfer Switch Manager sessions, do the following: Open the File menu, and select Preferences to open the Preferences dialog as shown in Figure 2-5. Enter, or browse, for paths to the working directory and browser. In the Application-wide Options area, choose the preferences you want.
Page 36: Sansurfer Switch Manager User Interface
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.
Page 37: Menu Bars
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.
Page 38: Faceplate Display Menu
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.
Page 39: Tool Bar
Event Browser button - opens the events browser. Edit Zoning button - opens the Edit Zoning dialog (available only in faceplate display). Help Topics button - opens the online help file. The QLogic logo opens a link to the QLogic web site. 59226-00 B 2-23...
Page 40: Fabric Tree
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.
Page 41: Graphic Window
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.
Page 42: Using The Topology Display
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...
Page 43: Switch And Link Status
2 – Using SANsurfer Switch Manager Using the Topology Display 2.12.1 Switch and Link Status Switch icon shape and color provide information about the switch and its operational state. Lines represent links between switches. The topology display uses green to indicate normal operation, yellow to indicate operational with errors, red to indicate a potential failure or non-operational state, and blue to indicate unknown, unreachable, or unmanageable.
Page 44: Arranging Switches In The Display
2 – Using SANsurfer Switch Manager Using the Topology Display 2.12.2.2 Arranging Switches in the Display You can arrange individual switch icons in the topology display or allow SANsurfer Switch Manager to arrange all switch icons for you: To move an individual switch icon, click and drag the icon to another location in the graphic window.
Page 45: Topology Data Windows
2 – Using SANsurfer Switch Manager Using the Topology Display 2.12.3 Topology Data Windows The topology display provides the following data windows corresponding to the data window tabs: Devices – displays information about devices (hosts and storage targets) connected to the switch. Refer to “Devices Data Window”...
Page 46: Using The Faceplate Display
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...
Page 47: Working With Ports
2 – Using SANsurfer Switch Manager Using the Faceplate Display 2.13.2 Working with Ports Ports are selectable and serve as access points for other displays and menus. You select ports to display information about them in the data window or to modify them.
Page 48: Faceplate Data Windows
2 – Using SANsurfer Switch Manager Using the Faceplate Display 2.13.3 Faceplate Data Windows The faceplate display provides the following data windows corresponding to the data window tabs: Devices – displays information about devices (hosts and storage targets) connected to the switch. Switch –...
Page 49: Managing Fabrics
Section 3 Managing Fabrics This section describes the following tasks that manage fabrics: Fabric Security Tracking Fabric Firmware and Software Versions Managing the Fabric Database Displaying Fabric Information Working with Device Information and Nicknames Zoning a Fabric Fabric Security The components of Fibre Channel fabric security are: User Account Security Fabric Services Security Consistency Checklist...
Page 50: Fabric Services
3 – Managing Fabrics Fabric Security 3.1.2 Fabric Services Fabric services security includes SNMP and In-band management. Simple Network Management Protocol (SNMP) is the protocol governing network management and monitoring of network devices. SNMP security consists of a read community string and a write community string, that are basically the passwords that control read and write access to the switch.
Page 51: Security Consistency Checklist
3 – Managing Fabrics Tracking Fabric Firmware and Software Versions 3.1.3 Security Consistency Checklist The Security Consistency Checklist dialog enables you to compare security-related features on switches to check for inconsistencies. Any changes must be made through the appropriate dialog, such as Network Properties dialog, Switch Properties dialog, or SNMP Properties dialog.
Page 52: Viewing And Comparing Version Snapshots
3 – Managing Fabrics Managing the Fabric Database 3.2.2 Viewing and Comparing Version Snapshots The Differences tab page shows a side-by-side comparison of two snapshots. The timestamp of each snapshot is displayed above the scroll area showing that snapshot. The background color of the older snapshot is darker than the background of the newer snapshot.
Page 53: Adding A Fabric
3 – Managing Fabrics Managing the Fabric Database 3.3.1 Adding a Fabric To add a fabric to the database, do the following: Open the Fabric menu and select Add Fabric to open the Add a New Fabric dialog as shown in Figure 3-2.
Page 54: Removing A Fabric
3 – Managing Fabrics Managing the Fabric Database 3.3.2 Removing a Fabric To delete a fabric file from the database, do the following: Select a fabric in the fabric tree. Open the Fabric menu and select Remove Fabric. 3.3.3 Opening a Fabric View File A fabric view file is one or more fabrics saved to a file.
Page 55: Deleting Switches And Links
3 – Managing Fabrics Managing the Fabric Database 3.3.6 Deleting Switches and Links The SANsurfer Switch Manager application does not automatically delete switches or links that have failed or have been physically removed from the fabric. In these cases, you can delete switches and links to bring the display up to date. If you delete a switch or a link that is still active, the SANsurfer Switch Manager application will restore it automatically.
Page 56: Replacing A Failed Switch
3 – Managing Fabrics Managing the Fabric Database Connect the devices to the switch. Make any necessary zoning changes using the Edit Zoning dialog. To open the Edit Zoning dialog, open the Zoning menu, and select Edit Zoning. If you changed the Default Visibility setting in the Zoning Config dialog from All to None, change that setting back to All.
Page 57: Displaying Fabric Information
3 – Managing Fabrics Displaying Fabric Information Reset the replacement switch to activate the configuration formerly possessed by the failed switch including the domain ID and the zoning database. Open the Switch menu and select Reset Switch. Reconnect the inter-switch links, target devices, and initiator devices to the replacement switch using the same ports as were used on the failed switch.
Page 58: Topology Display Switch And Status Icons
3 – Managing Fabrics Displaying Fabric Information The topology display uses switch and status icons to provide status information about switches, inter-switch links, and the Ethernet connection. The switch status icons, displayed on the left side of a switch, vary in shape and color. Switches controlled by an Ethernet Internet Protocol have a colored Ethernet icon displayed on the right side of the switch.
Page 59: Displaying The Event Browser
3 – Managing Fabrics Displaying Fabric Information 3.4.2 Displaying the Event Browser The Event Browser displays a list of events generated by the switches in the fabric and the SANsurfer Switch Manager application. Events that are generated by the SANsurfer Switch Manager application are not saved on the switch, but can be saved to a file during the SANsurfer Switch Manager session.
Page 60: Severity Levels
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.
Page 61: Filtering The Event Browser
3 – Managing Fabrics Displaying Fabric Information 3.4.2.1 Filtering the Event Browser Filtering the Event Browser enables you to display only those events that are of interest based on the event severity, timestamp, source, type, and description. To filter the Event Browser, open the Filter menu and select Filter Entries. This opens the Filter Events dialog shown in Figure 3-4.
Page 62: Sorting The Event Browser
3 – Managing Fabrics Displaying Fabric Information 3.4.2.2 Sorting the Event Browser Sorting the Event Browser enables you to display the events in alphanumeric order based on the event severity, timestamp, source, type, or description. Initially, the Event Browser is sorted in ascending order by timestamp. To sort the Event Browser, click the Severity, Timestamp, Source, Type, or Description column buttons.
Page 63: Devices Data Window
3 – Managing Fabrics Displaying Fabric Information 3.4.3 Devices Data Window The Devices data window displays information about devices (hosts and storage targets) connected to the switch. Click the Devices tab below the data window to display device information for all devices that are logged into the selected fabric. To narrow the display to devices that are logged into specific switches, select one or more switches in the fabric tree or the topology display.
Page 64: Active Zone Set Data Window
3 – Managing Fabrics Displaying Fabric Information 3.4.4 Active Zone Set Data Window The Active Zoneset data window displays the zone membership for the active zone set that resides on the fabric management switch. The active zone set is the same on all switches in the fabric –...
Page 65: Link Data Window
3 – Managing Fabrics Working with Device Information and Nicknames 3.4.5 Link Data Window The Link data window displays information about all switch links in the fabric or selected links. This information includes the switch name, the port number at the end of each link, and the link status icons.
Page 66: Exporting Device Information To A File
3 – Managing Fabrics Working with Device Information and Nicknames 3.5.2 Exporting Device Information to a File To save device information to a file, open the topology display and do the following: Select one or more switches. If no switches are selected, Devices information is gathered for all switches.
Page 67: Editing A Nickname
3 – Managing Fabrics Working with Device Information and Nicknames 3.5.3.2 Editing a Nickname A nickname must start with a letter and can have up to 64 characters. Valid characters include alphanumeric characters [aA-zZ][0-9] and special symbols [$ _ - ^ ]. You can access the Edit Nicknames dialog two ways. Choose one of the following methods to edit a nickname: In the topology or faceplate display, open the File menu and select Nicknames to open the Nicknames dialog.
Page 68: Importing A Nicknames File
3 – Managing Fabrics Zoning a Fabric 3.5.3.5 Importing a Nicknames File Importing a nicknames file copies its contents into and replaces the contents of the Nicknames.xml file which is used by SANsurfer Switch Manager. To import a nickname file, do the following: Open the File menu and select Nicknames to open the Nicknames dialog.
Page 69: Zones
3 – Managing Fabrics Zoning a Fabric 3.6.1.1 Zones A zone is a named group of ports or devices that can communicate with each other. Devices within a zone can only communicate with other devices in the same zone. A device may participate in more than one zone. Membership in a zone can be defined by switch domain ID and port number, device Fibre Channel address (FCID), or device World Wide Name (WWN).
Page 70: Aliases
3 – Managing Fabrics Zoning a Fabric 3.6.1.1.2 Access Control List Hard Zones Access Control List (ACL) zoning divides the fabric for purposes of controlling discovery and inbound traffic. ACL zoning is a type of hard zoning that is hardware enforced. This type of zoning is useful for controlling access to certain devices without totally isolating them from the fabric.
Page 71: Zoning Database
3 – Managing Fabrics Zoning a Fabric 3.6.1.4 Zoning Database Each switch has its own zoning database. The zoning database is made up of all aliases, zones, and zone sets that have been created on the switch or received from other switches. The switch maintains two copies of the inactive zoning database: one copy is maintained in temporary memory for editing purposes;...
Page 72: Using The Zoning Wizard
3 – Managing Fabrics Zoning a Fabric 3.6.2 Using the Zoning Wizard The Zoning Wizard is a series of dialogs that leads you through the process of zoning a fabric. To open the Zoning Wizard, open the Wizards menu in the faceplate display, and select Zoning Wizard.
Page 73: Editing The Zoning Database
3 – Managing Fabrics Zoning a Fabric 3.6.3.1 Editing the Zoning Database To edit the zoning database for a particular switch, open the Zoning menu from the faceplate display and select Edit Zoning to open the Edit Zoning dialog shown in Figure 3-7.
Page 74 3 – Managing Fabrics Zoning a Fabric NOTE: If the Interop Auto Save parameter is enabled on the Zoning Configuration dialog, then every time the active zone set changes, the switch will copy it into an inactive zone set stored on the switch. You can edit this copy of the active zone set stored on the switch, and activate the updated copy to conveniently apply the changes to the active zone set.
Page 75: Edit Zoning Dialog Tool Bar Buttons And Icons
3 – Managing Fabrics Zoning a Fabric Table 3-4. Edit Zoning Dialog Tool Bar Buttons and Icons Tool Bar Button Description Create Zone Set button - create a new zone set 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...
Page 76: Configuring The Zoning Database
3 – Managing Fabrics Zoning a Fabric 3.6.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-8.
Page 77: Saving The Zoning Database To A File
3 – Managing Fabrics Zoning a Fabric 3.6.3.2.2 Default Visibility Default visibility determines the level of communication that is permitted among ports/devices when there is no active zone set. The default visibility parameter can be set differently on each switch. When default visibility is enabled (ALL) on a switch, all ports/devices on the switch can communicate with all ports/devices on switches that also have default visibility enabled.
Page 78: Restoring The Default Zoning Database
3 – Managing Fabrics Zoning a Fabric 3.6.3.5 Restoring the Default Zoning Database Restoring the default zoning clears the switch of all zoning definitions. CAUTION! This command will deactivate the active zone set. To restore the default zoning for a switch: In the faceplate display, open the Zoning menu and select Restore Default Zoning.
Page 79: Managing Zone Sets
3 – Managing Fabrics Zoning a Fabric 3.6.4 Managing Zone Sets Zoning a fabric involves creating a zone set, creating zones as zone set members, then adding devices as zone members. The zoning database supports multiple zone sets to serve the different security and access needs of your storage area network, but only one zone set can be active at one time.
Page 80: Activating And Deactivating A Zone Set
3 – Managing Fabrics Zoning a Fabric 3.6.4.2 Activating and Deactivating a Zone Set You must activate a zone set to apply its zoning definitions to the fabric. Only one zone set can be active at one time. When you activate a zone set, the switch distributes that zone set to the temporary zoning database on every switch in the fabric.
Page 81: Removing A Zone Set
3 – Managing Fabrics Zoning a Fabric 3.6.4.5 Removing a Zone Set Removing a zone set from the database affects the member zones in the following ways. Member zones that are members of other zone sets are not affected. Member zones that are not members of other zone sets become members of the orphan zone set.
Page 82: Creating A Zone In A Zone Set
3 – Managing Fabrics Zoning a Fabric 3.6.5.1 Creating a Zone in a Zone Set When a zone is created, its zone type is soft. To change the zone type to a hard zone, refer to “Changing Zone Types” on page 3-37 for more information.
Page 83: Adding Zone Members
3 – Managing Fabrics Zoning a Fabric 3.6.5.2 Adding Zone Members You can zone a port/device by switch domain ID and port number, device port Fibre Channel address, or the device port WWN. Adding a port/device to a zone affects every zone set in which that zone is a member. To add ports/devices to a zone, do the following: Open the Zoning menu, and select Edit Zoning to open the Edit Zoning dialog.
Page 84: Renaming A Zone Or A Zone Set
3 – Managing Fabrics Zoning a Fabric 3.6.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.
Page 85: Changing Zone Types
3 – Managing Fabrics Zoning a Fabric 3.6.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.
Page 86: Adding A Member To An Alias
3 – Managing Fabrics Zoning a Fabric 3.6.6.2 Adding a Member to an Alias You can add a port/device to an alias by domain ID and port number, device port Fibre Channel address, or the device port WWN. To add ports/devices to an alias, do the following: Open the Zoning menu, and select Edit Zoning to open the Edit Zoning dialog.
Page 87: Merging Fabrics And Zoning
3 – Managing Fabrics Zoning a Fabric 3.6.7 Merging Fabrics and Zoning If you join two fabrics with an inter-switch link, the active zone sets from the two fabrics attempt to merge automatically. The fabrics may consist of a single switch or many switches already connected together.
Page 88: Zone Merge Failure Recovery
3 – Managing Fabrics Zoning a Fabric 3.6.7.2 Zone Merge Failure Recovery When a zone merge failure occurs, the conflict that caused the failure must be resolved. You can correct a failure due to a zone conflict by deactivating one of the active zone sets or by editing the conflicting zones so that their membership is the same.
Page 89: Managing Switches
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 Archiving a Switch Restoring a Switch Restoring the Factory Default Configuration...
Page 90: Managing User Accounts
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..
Page 91: Creating 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.
Page 92: Removing A User Account
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.
Page 93: Changing A User Account Password
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.
Page 94: Modifying A User Account
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.
Page 95: Displaying Switch Information
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 1400 Series switch.
Page 96: Devices Data Window
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 97 If false, changes to both the active zone set and zoning database are prop- agated throughout the fabric. Refer to the QLogic Switch Interoperability Guide found on the QLogic Web site. Legacy Address Format Legacy port addressing status.
Page 98 4 – Managing Switches Displaying Switch Information Table 4-2. Switch Data Window Entries (Continued) Entry Description Security Fabric Binding N/A - does not apply to this switch Enable Temperature Internal switch temperature °C Fan 1 Status N/A - does not apply to this switch Fan 2 Status N/A - does not apply to this switch Fan 3 Status...
Page 99: Port Statistics Data Window
4 – Managing Switches Displaying Switch Information Table 4-2. Switch Data Window Entries (Continued) Entry Description Inactivity Timeout Number of minutes the switch waits before terminating an idle command line interface session. Zero (0) disables the time out threshold. GUI Mgmt Enabled SANsurfer Switch Manager service status Telnet Enabled Telnet service status...
Page 100: Configured Zonesets Data Window
4 – Managing Switches Displaying Switch Information 4.2.5 Configured Zonesets Data Window 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.
Page 101: Configuring Port Threshold Alarms
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.
Page 102: Paging A Switch
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.
Page 103: Setting The Date/Time And Enabling Ntp Client
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 104: Switch Resets
4 – Managing Switches Resetting a Switch Common administrative operations that change the fabric include: Zoning modifications Adding, moving or removing devices attached to the switch fabric. This includes powering up or powering down attached devices. Adding, moving or removing ISLs or other connections. Management Interfaces: After an NDCLA operation is complete, management connections must be re-initiated:...
Page 105: Configuring A Switch
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.
Page 106: Switch Properties
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.
Page 107: Switch Administrative States
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.
Page 108: Domain Id And Domain Id Lock
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).
Page 109: Broadcast Support
4 – Managing Switches Configuring a Switch Use the FDMI Enabled radio button on the Switch Properties dialog to enable or disable FDMI. If FDMI is enabled on an HBA, the HBA forwards information about itself to the switch when the HBA logs into the switch. If FDMI is enabled on a switch, the switch stores the HBA information in its FDMI database.
Page 110: Advanced Switch Properties
4 – Managing Switches Configuring a Switch 4.7.3 Advanced Switch Properties The Advanced Switch Properties dialog enables you to set 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.
Page 111: Timeout Values
4 – Managing Switches Configuring a Switch 4.7.3.1 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.
Page 112: Interop Mode For Zoning
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.
Page 113: Network Properties
4 – Managing Switches Configuring a Switch 4.7.4 Network Properties Use the Network Properties dialog shown in Figure 4-11 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.
Page 114: Ip Configuration
4 – Managing Switches Configuring a Switch 4.7.4.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-...
Page 115: Remote Logging
4 – Managing Switches Configuring a Switch 4.7.4.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.
Page 116: Snmp Properties
4 – Managing Switches Configuring a Switch 4.7.5 SNMP Properties Use the SNMP Properties dialog shown in Figure 4-12 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.
Page 117: Snmp Configuration
4 – Managing Switches Configuring a Switch 4.7.5.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.
Page 118: Snmp Trap Configuration
4 – Managing Switches Configuring a Switch 4.7.5.2 SNMP Trap Configuration The SNMP trap configuration defines how traps are set. Choose from the tabs Trap1 – Trap 5 to configure each trap. Table 4-8 describes the SNMP configuration parameters. Table 4-8. SNMP Trap Configuration Parameters Parameter Description Trap Version...
Page 119: Archiving A Switch
4 – Managing Switches Archiving a Switch Archiving a Switch You can create an .XML archive file containing the configuration parameters. Basically any data received by SANsurfer Switch Manager is archived. However, passwords are not archived with the user account information. Archived parameters include the following: Switch properties and statistics IP configuration...
Page 120: Restoring A Switch
4 – Managing Switches Restoring a Switch 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 SANbox 1400 Series switch only with an archive from a SANbox 1400 Series switch.
Page 121 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.
Page 122: Restoring The Factory Default Configuration
4 – Managing Switches Restoring the Factory Default Configuration 4.10 Restoring the Factory Default Configuration You can restore the switch and port configuration settings to the factory default values. To restore the factory configuration on a switch, open the Switch menu and select Restore Factory Defaults.
Page 123: Downloading A Support File
4 – Managing Switches Downloading a Support File Table 4-9. Factory Default Configuration Settings (Continued) Setting Value Remote Logging False Remote Logging Host Ip Address 10.0.0.254 NTP Client Enabled False NTP Server IP Address 10.0.0.254 Contact Undefined Location Undefined Trap Enabled False Trap Port Trap Address...
Page 124: Installing Firmware
4 – Managing Switches Installing Firmware 4.12 Installing Firmware Installing firmware involves loading, unpacking, and activating the firmware image on the switch. SANsurfer Switch Manager does this in one operation. To provide consistent performance throughout the fabric, ensure that all switches are running the same version of firmware.
Page 125: Displaying Hardware Status
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.
Page 126 4 – Managing Switches Displaying Hardware Status Notes 4-38 59226-00 B...
Page 127: Managing Ports
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.
Page 128: Monitoring Port Status
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.
Page 129: Displaying Port Operational States
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.
Page 130: Displaying Transceiver Media Status
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)
Page 131: Port Statistics Data Window Entries
5 – Managing Ports Displaying Port Information Table 5-5. Port Statistics Data Window Entries Entry Description Start Time The beginning of the period over which the statistics apply. The start time for the Absolute view is not applicable. The start time for the Rate view is the beginning of polling interval.
Page 132 5 – Managing Ports Displaying Port Information Table 5-5. Port Statistics Data Window Entries (Continued) Entry Description Flow Errors Number of times a frame is received and all the switch ports receive buffers are full. The normal Fabric Login exchange of flow control credit should prevent this from occurring.
Page 133: Port Information Data Window
5 – Managing Ports Displaying Port Information Table 5-5. Port Statistics Data Window Entries (Continued) Entry Description Rx Link Resets Number of link reset primitives received from an attached device. Rx Offline Sequences Number of offline sequence primitives received by the port. Total Errors Total number of primitive and non-primitive port link errors.
Page 134 5 – Managing Ports Displaying Port Information Table 5-6. Port Information Data Window Entries (Continued) Entry Description Administrative Port Type The administrative port type (G, GL, F, FL, or Donor). This value is persistent; it will be maintained during a switch reset. Dur- ing port auto-configuration, it will be used to determine which operational port states are allowed.
Page 135 5 – Managing Ports Displaying Port Information Table 5-6. Port Information Data Window Entries (Continued) Entry Description Operational Port Speed The speed actually being used by the port. Max Credits The maximum number of credits granted to a port that can be used when extending port credits.
Page 136: Configuring Ports
5 – Managing Ports Configuring Ports Configuring Ports The port settings or characteristics are configured using the Port Properties dialogs shown in Figure 5-2. To open the corresponding type of Port Properties dialog, select one or more ports, open the Port menu and select Port Properties. Figure 5-2.
Page 137: Changing Port Administrative States
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.
Page 138: Changing Port Speeds
5 – Managing Ports Configuring Ports 5.2.2 Changing Port Speeds Ports are capable of transmitting and receiving at 1-Gbps or 2-Gbps. The ports can be configured for either transmission speed or to sense the transmission speed of the device to which it is connected. Table 5-8 describes the port speeds.
Page 139: Changing Port Types
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.
Page 140: I/O Stream Guard
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.
Page 141: Using The Extended Credits Wizard
5 – Managing Ports Using the Extended Credits Wizard Using the Extended Credits Wizard Each port is supported by a data-buffer with a 8-credit capacity; that is, 8 maximum sized frames. For fiber optic cables, this enables full bandwidth service over a distance of 13 kilometers at 1 Gbps (0.6 credits per Km) or 6 kilometers at 2 Gbps (1.2 credits per Km).
Page 142: Resetting A Port
5 – Managing Ports Resetting a Port 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.
Page 143 5 – Managing Ports Testing Ports SerDes level (Internal) - The SerDes level test verifies port circuitry. The SerDes level test sends a test frame from the ASIC through the SerDes chip and back to the ASIC for the selected ports. The port passes the test if the frame that was sent by the ASIC matches the test frame that was received.
Page 144: Graphing Port Performance
5 – Managing Ports Graphing Port Performance Graphing Port Performance SANsurfer Performance View application displays port performance using graphs. SANsurfer Performance View 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.
Page 145: Starting Sansurfer Performance View
5 – Managing Ports Graphing Port Performance This section describes how to do the following: Starting SANsurfer Performance View Exiting SANsurfer Performance View Saving and Opening Performance View Files Changing the Default Performance View File Encryption Key Setting SANsurfer Performance View Preferences Setting the Polling Frequency Displaying Graphs for a Switch Printing Graphs...
Page 146: Exiting Sansurfer Performance View
5 – Managing Ports Graphing Port Performance 5.6.2 Exiting SANsurfer Performance View To exit a SANsurfer Performance View 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.
Page 147: Saving And Opening Performance View Files
5 – Managing Ports Graphing Port Performance In your next SANsurfer Performance View 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.
Page 148: Changing The Default Performance View File Encryption Key
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.
Page 149: Setting The Polling Frequency
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.
Page 150: Arranging Graphs In The Display
5 – Managing Ports Graphing Port Performance 5.6.7.1 Arranging Graphs in the Display To arrange and size graphs in the display, open the Window menu and select Cascade, Tile, or Close All. Cascade overlaps the graphs so that all graphs are at least partially visible. Tile arranges the graphs in non-overlapping rows and columns.
Page 151: Default Graph Options Dialog
5 – Managing Ports Graphing Port Performance Figure 5-9. Default Graph Options Dialog To modify the graph options, do the following: Choose the units for the graph: Select the Show Bytes Data on Graph check box to plot data in KBytes/second Select the Show Frames Data on Graph check box to plot data in frames/second.
Page 152: Setting Global Graph Type
5 – Managing Ports Graphing Port Performance Choose the color scheme for the graph. Click a Select Color button to open its corresponding Select Color dialog, which allows you to select a new color scheme. You can select the color for each data type, the unit grid, and the background by clicking the corresponding color field or button.
Page 153: Printing Graphs
5 – Managing Ports Graphing Port Performance Open the Graph menu and select Rescale Selected Graph, or right-click on the graph and select Rescale from the popup menu. View the data in the graph window. 5.6.8 Printing Graphs To print a graph, select a graph, then open the File menu and select Print Graph Window.
Page 154 5 – Managing Ports Graphing Port Performance 5-28 59226-00 B...
Page 155: Appendix A Command Line Interface
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 connection. This section describes the following: Logging On to a Switch User Accounts Working with Switch Configurations Commands Logging On to a Switch To log on to a switch using Telnet, open a command line window on the...
Page 156: A.2 User Accounts
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.
Page 157: Modifying A Configuration
A – Command Line Interface Working with Switch Configurations A.3.1 Modifying a Configuration A switch supports up to 10 configurations including the default configuration. Each switch configuration contains switch, port, port threshold alarm, and zoning configuration components. The Show Switch command displays the name of the active configuration. A configuration name can have up to 31 characters excluding the pound symbol (#), semicolon (;), and comma (,).
Page 158: Backing Up And Restoring Switch Configurations
A – Command Line Interface Working with Switch Configurations The Config Save command saves the changes you made during the Config Edit session. In this case, changes to the configuration named Default are being saved to a new configuration named config_10132003. However, the new configuration does not take effect until you activate it with the Config Activate command as shown: SANbox (admin-config)#>...
Page 159 A – Command Line Interface Working with Switch Configurations You use FTP to download the configdata file to your workstation for safe keeping and to upload the file back to the switch for the restore function. To download the configdata file, open an FTP session on the switch and login with the account name images and password images.
Page 160: Commands
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].
Page 161: A-2 Commands Listed By Authority Level
A – Command Line Interface Commands The command set performs monitoring and configuration tasks. Commands related to monitoring tasks are available to all account names. Commands related to configuration tasks are available only within an admin session. An account must have Admin authority to enter the Admin Start command, which opens an admin session.
Page 162: Admin Command
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.
Page 163: Alias 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 164 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.
Page 165: Config Command
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-40. Authority Admin session for all keywords except List Syntax config activate [config_name]...
Page 166 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 167 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 #> admin start SANbox (admin) #> config backup SANbox (admin) #> admin end SANbox #>...
Page 168: Create Support Command
A – Command Line Interface Create Support Command Create Support Command Assembles all log files and switch memory data into a core dump file (dump_support.tgz zip) and prompts you to send it to a remote host. This file is useful to technical support personnel for troubleshooting switch problems. Use this command when directed by your authorized maintenance provider.
Page 169 A – Command Line Interface Create Support Command Examples The following is an example of the Create Support command: SANbox (admin) #> create support Log Msg: [day month date time UTC 2004][C][8400.003B][Switch][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 170: Date Command
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. Network Time Protocol (NTP) must be disabled to set the time with the Date command.
Page 171: Feature Command
A – Command Line Interface Feature Command Feature Command Displays the license key feature log. Authority None Syntax feature add [license_key] Keywords add [license_key] This keyword does not apply to this switch because there are no licensable features. Displays a list of installed license key features. 59226-00 B A-17...
Page 172: Firmware Install Command
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 to activate the firmware. This is disruptive to I/O traffic. To perform a non-disruptive firmware installation, refer to the “Image Command”...
Page 173: Hardreset Command
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”...
Page 174: Help 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.
Page 175: History Command
A – Command Line Interface History Command History Command Displays a numbered list of the previously entered commands from which you can re-execute selected commands. Authority 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].
Page 176: Hotreset Command
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.
Page 177: Image Command
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 178 A – Command Line Interface Image Command To install firmware when the management workstation does not have an FTP server, do the following: Connect to the switch through the Ethernet port. Move to the folder or directory on the workstation that contains the new firmware image file.
Page 179 A – Command Line Interface Image Command 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. Use the Hotreset command to attempt a non-disruptive activation.
Page 180: Lip Command
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 (admin) #>...
Page 181: Passwd Command
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.
Page 182: Ping Command
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. Examples The following is an example of a successful Ping command: SANbox #>...
Page 183: Ps Command
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 #> 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 3-01:18:35 dlog...
Page 184: Quit Command
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. A-30 59226-00 B...
Page 185: Reset Command
A – Command Line Interface Reset Command Reset Command Resets the switch configuration parameters. If you omit the keyword, the default is Reset Switch. Authority Admin session Syntax reset config [config_name] factory port [port_number] snmp switch (default) system zoning Keywords config [config_name] Resets the configuration given by [config_name] to the factory default values for switch, port, port threshold alarm, and zoning configuration.
Page 186: A-3 Switch Configuration Defaults
A – Command Line Interface Reset Command switch Resets the switch without a power-on self test. This is the default. This reset disrupts traffic and does the following: Activates the pending firmware. Closes all management sessions. Clears the event log. To save the event log before resetting, refer to the “Set Log Command”...
Page 187: A-4 Port Configuration Defaults
A – Command Line Interface Reset Command Table A-3. Switch Configuration Defaults Parameter Default Principal Priority Configuration Description Default Config InteropMode Standard LegacyAddressFormat False Table A-4. Port Configuration Defaults Parameter Default Admin State Online Link Speed Auto Port Type Symbolic Name Port n, where n is the port number ALFairness False...
Page 188: A-5 Port Threshold Alarm Configuration Defaults
A – Command Line Interface Reset Command Table A-5. Port Threshold Alarm Configuration Defaults Parameter Default ThresholdMonitoringEnabled False CRCErrorsMonitoringEnabled True RisingTrigger FallingTrigger SampleWindow DecodeErrorsMonitoringEnabled True RisingTrigger FallingTrigger SampleWindow ISLMonitoringEnabled True RisingTrigger FallingTrigger SampleWindow LoginMonitoringEnabled True RisingTrigger FallingTrigger SampleWindow LogoutMonitoringEnabled True RisingTrigger FallingTrigger SampleWindow...
Page 189: A-6 Zoning Configuration Defaults
A – Command Line Interface Reset Command Table A-6. Zoning Configuration Defaults Parameter Default InteropAutoSave True DefaultVisibility DiscardInactive False Table A-7. SNMP Configuration Defaults Parameter Default SNMPEnabled True Contact <syscontact undefined> Location <sysLocation undefined> Description SANbox 1400 FC Switch Trap [1-5] Address Trap 1: 10.0.0.254;...
Page 190: A-8 System Configuration Defaults
A – Command Line Interface Reset Command Table A-8. System Configuration Defaults Parameter Default Ethernet Network Discovery Static Ethernet Network IP Address 10.0.0.1 Ethernet Network IP Mask 255.0.0.0 Ethernet Gateway Address 10.0.0.254 Admin Timeout 30 minutes InactivityTimeout LocalLogEnabled True RemotelogEnabled False RemoteLogHostAddress 10.0.0.254...
Page 191: Set Command
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 192 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-51. pagebreak [state] Specifies how much information is displayed on the screen at a time according to the value given by [state].
Page 193 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 #>...
Page 194: Set Config Command
A – Command Line Interface Set Config Command Set Config Command Sets switch, port, port threshold alarm, and zoning configuration parameters. The changes you make with this command are not retained when you reset or power cycle the switch unless you save them using the Config Save command. Refer to “Config Command”...
Page 195 A – Command Line Interface Set Config Command Table A-9. Set Config Port Parameters (Continued) Parameter Description LinkSpeed Transmission speed: 1-Gbps, 2-Gbps, 4-Gbps, or Auto. The default is Auto. PortType Port type: GL, G, F, FL, Donor. The default is GL. SymbolicPortName Descriptive name for the port.
Page 196 A – Command Line Interface Set Config Command Table A-9. Set Config Port Parameters (Continued) Parameter Description AutoPerfTuning Automatic performance tuning for FL_Ports only. The default is True. If AutoPerfTuning is enabled (True) and the port is an FL_Port, MFSEnable is automatically enabled. LCFEnable and VIEnable are overridden to False.
Page 197: A-10 Set Config Switch Parameters
Disable – Allows free transmission and reception of RSCN messages. Auto – Suppresses the reception of RSCN mes- sages under the following conditions: 1) The port is connected to an initiator device with a QLogic HBA, 2) The DeviceScanEnable parameter is enabled. Auto is the default. PDISCPingEnable...
Page 198 A – Command Line Interface Set Config Command Table A-10. Set Config Switch Parameters (Continued) Parameter Description FDMIEntries The number of device entries to maintain in the FDMI database. Enter a number from 0–1000. The default is 1000. DefaultDomainID Default domain ID. The default is 1. DomainIDLock Prevents (True) or allows (False) dynamic reassign- ment of the domain ID.
Page 199: A-11 Set Config Threshold Parameters
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.
Page 200: A-12 Set Config Zoning Parameters
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 201 A – Command Line Interface Set Config Command Examples The following is an example of the Set Config Port command: SANbox #> admin start SANbox (admin) #> config edit SANbox (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 202 A – Command Line Interface Set Config Command The following is an example of the Set Config Switch command: SANbox #> admin start SANbox (admin) #> config edit SANbox (admin-config) #> set config switch 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.
Page 203 A – Command Line Interface Set Config Command The following is an example of the Set Config Threshold command: SANbox #> admin start SANbox (admin) #> config edit SANbox (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 204 A – Command Line Interface Set Config Command The following is an example of the Set Config Zoning command. SANbox #> admin start SANbox (admin) #> config edit SANbox (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.
Page 205: Set Log Command
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 206 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 207 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 208 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.
Page 209: Set Port 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 210 A – Command Line Interface Set Port Command state [state] Specifies one of the following administrative states for the specified port: Online Places the port online. This activates and prepares the port to send data. Offline Places the port offline. This prevents the port from receiving signal and accepting a device login.
Page 211: Set Setup Command
A – Command Line Interface Set Setup Command Set Setup Command Changes SNMP and system configuration settings. The switch maintains one SNMP configuration and one system configuration. Authority Admin session Syntax set setup snmp system Keywords snmp Prompts you in a line-by-line fashion to change SNMP configuration settings. Table A-13 describes the SNMP fields.
Page 212: A-14 System Configuration Settings
A – Command Line Interface Set Setup Command Table A-13. SNMP Configuration Settings (Continued) Entry Description ReadCommunity Read community password that authorizes an SNMP agent to read information from the switch. This is a write-only field. The value on the switch and the SNMP management server must be the same.
Page 213 A – Command Line Interface Set Setup Command Table A-14. System Configuration Settings (Continued) Entry Description Eth0NetworkMask Ethernet subnet mask address. Eth0GatewayAddress Ethernet IP address gateway. AdminTimeout Amount of time in minutes the switch waits before ter- minating an idle Admin session. Zero (0) disables the time out threshold.
Page 214 A – Command Line Interface Set Setup Command Examples The following is an example of the Set Setup SNMP command: SANbox #> admin start SANbox (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 215 A – Command Line Interface Set Setup Command The following is an example of the Set Setup System command: SANbox (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.
Page 216: Show Command
A – Command Line Interface Show Command Show Command Displays fabric, switch, and port operational information. Authority None Syntax show about alarm [option] broadcast chassis config [option] domains donor fabric fdmi [port_wwn] interface log [option] lsdb mem [count] ns [option] pagebreak perf [option] port [port_number]...
Page 217 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 218 A – Command Line Interface Show Command lsdb Displays Link State database information mem [count] Displays information about memory activity for the number of seconds given by [count]. If you omit [count], the value 1 is used. Displayed memory values are in 1K block units.
Page 219: A-15 Show Port Parameters
A – Command Line Interface Show Command port [port_number] Displays operational information for the port given by [port_number]. Ports are numbered beginning with 0. If [port number] is omitted, information is displayed for all ports. Table A-15 describes the port parameters. Table A-15.
Page 220 A – Command Line Interface Show Command Table A-15. Show Port Parameters (Continued) Entry Description LIP_F8_AL_PS This LIP denotes a loop failure detected by the L_Port identi- fied by AL_PS. LIP_F7_F7 A loop initialization primitive frame used to acquire a valid AL_PA.
Page 221 A – Command Line Interface Show Command Table A-15. Show Port Parameters (Continued) Entry Description TotalTxFrames Total number of frames issued by this port. TotalTxWords Total number of words issued by this port. TxLinkResets Number of Link Resets issued by this port. TxOfflineSeq Total number of Offline Sequences issued by this port.
Page 222: A-16 Switch Operational Parameters
A – Command Line Interface Show Command support Executes a series of commands that display a complete description of the switch, its configuration, and operation. The display can be captured from the screen and used for diagnosing problems. This keyword is intended for use at the request of your authorized maintenance provider.
Page 223 A – Command Line Interface Show Command Table A-16. Switch Operational Parameters (Continued) Parameter Description LogLevel Event severity level used to record events in the event log MaxPorts Number of ports available on the switch NumberOfResets Number of times the switch has been reset over its service life ReasonForLastReset Action that caused the last reset...
Page 224 0.0.0.0 sw12 The following is an example of the Show FDMI command: SANbox #> 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-70 59226-00 B...
Page 225 The following is an example of the Show FDMI WWN command: SANbox #> 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 226 A – Command Line Interface Show Command The following is an example of the Show NS [domain_ID] command: SANbox #> 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 #>...
Page 227 A – Command Line Interface Show Command The following is an example of the Show Port command: SANbox #> 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 EpConnState...
Page 228 A – Command Line Interface Show Command The following is an example of the Show Switch command: SANbox #> show switch Switch Information ------------------ SymbolicName sw .108 SwitchWWN 100000c0dd00bc56 SwitchType SANbox 1400 BootVersion Vx.x.x.x-0 (day month date time year) CreditPool DomainID 19 (0x13) FirstPortAddress...
Page 229 A – Command Line Interface Show Command The following is an example of the Show Topology command for port 1: SANbox #> 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 PortType NL...
Page 230 A – Command Line Interface Show Command The following is an example of the Show Version command: SANbox #> show version ***************************************************** Command Line Interface SHell (CLISH) ***************************************************** SystemDescription SANbox 1400 FC Switch Eth0NetworkAddress 10.20.116.37 (use 'set setup system' to update) MACAddress 00:c0:dd:07:02:17 WorldWideName...
Page 231: Show Config Command
A – Command Line Interface Show Config Command Show Config Command Displays switch, port, alarm threshold, and zoning for the current configuration. Authority None Syntax show config port [port_number] switch threshold zoning Keywords port [port_number] Displays configuration parameters for the port number given by [port_number]. Ports are numbered beginning with 0.
Page 232 A – Command Line Interface Show Config Command Examples The following is an example of the Show Config Port command: SANbox #> show config port 3 Port Number: 3 ------------ AdminState Offline LinkSpeed Auto PortType SymbolicName Port3 ALFairness False DeviceScanEnabled True ForceOfflineRSCN False...
Page 233 A – Command Line Interface Show Config Command The following is an example of the Show Config Threshold command: SANbox #> show config threshold Configuration Name: default ------------ Threshold Configuration Information ----------------------------------- ThresholdMonitoringEnabled False CRCErrorsMonitoringEnabled True RisingTrigger FallingTrigger SampleWindow DecodeErrorsMonitoringEnabled True RisingTrigger FallingTrigger SampleWindow...
Page 234 A – Command Line Interface Show Config Command The following is an example of the Show Config Zoning command: SANbox #> show config zoning Configuration Name: default ------------------- Zoning Configuration Information -------------------------------- InteropAutoSave True DefaultVisibility DiscardInactive False A-80 59226-00 B...
Page 235: Show Log Command
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 236 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 237 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 238 A – Command Line Interface Show Log Command The following is an example of the Show Log command: SANbox #> 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] [332][day month date time year][I][Eport Port: 0/8][EFP,WWN= 0x100000c0dd00b845,...
Page 239: Show Perf Command
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 240 A – Command Line Interface Show Perf Command Examples The following is an example of the Show Perf command: SANbox #> show perf Port Bytes/s Bytes/s Bytes/s Frames/s Frames/s Frames/s Number (in) (out) (total) (in) (out) (total) ------ ------- ------- ------- -------- --------...
Page 241: Show Setup Command
Displays the current SNMP settings. system Displays the current system settings. Examples The following is an example of the Show Setup Mfg command: SANbox #> show setup mfg Manufacturing Information ------------------------- BrandName QLogic Corporation BuildDate Unknown PartNumber SANbox 1400 SerialNumber FAM0331000011 LicensedPorts MACAddress...
Page 242 A – Command Line Interface Show Setup Command The following is an example of the Show Setup Snmp command: SANbox #> show setup snmp SNMP Information ---------------- SNMPEnabled True Contact <sysContact undefined> Location N_107 System Test Lab Description SANbox 1400 FC Switch Trap1Address 10.0.0.254 Trap1Port...
Page 243 A – Command Line Interface Show Setup Command The following is an example of the Show Setup System command: SANbox #> 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 10.0.0.254...
Page 244: Shutdown Command
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.
Page 245: Test Command
A – Command Line Interface Test Command Test Command Tests ports using internal (SerDes level), external (transceiver), and online loopback tests. Internal and external tests require that the port be placed in diagnostic mode. Refer to the “Set Command” on page A-37 for information about changing the port administrative state.
Page 246 A – Command Line Interface Test Command 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 key. admin start Place the port in Diagnostics mode, enter the following command (x = port number) and press the Enter key.
Page 247 A – Command Line Interface Test Command A series of test parameters are displayed on the screen. Press the Enter key to accept each default parameter value, or type a new value for each parameter and press the Enter key. The TestLength parameter is the number of frames sent, the FrameSize (256 byte maximum in some cases) parameter is the number of bytes in each frame, and the DataPattern parameter is the pattern in the payload.
Page 248: Uptime Command
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...
Page 249: User Command
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 250 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 (admin) #>...
Page 251 A – Command Line Interface User Command The following is an example of the User Delete command: SANbox (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 (admin) #>...
Page 252: Whoami Command
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 #> whoami User name : admin@session2 Switch name...
Page 253: Zone Command
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-106 for information about starting a Zoning Edit session. The List, Members, and Zonesets keywords are available without an Admin session.
Page 254 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 255 A – Command Line Interface Zone Command Examples The following is an example of the Zone List command: SANbox #> zone list Zone ZoneSet ------------------- wwn_b0241f zone_set_1 wwn_23bd31 zone_set_1 wwn_221416 zone_set_1 wwn_2215c3 zone_set_1 wwn_0160ed zone_set_1 wwn_c001b0 zone_set_1 wwn_401248 zone_set_1 wwn_02402f zone_set_1 wwn_22412f zone_set_1...
Page 256 A – Command Line Interface Zone Command The following is an example of the Zone Zonesets command: SANbox #> zone zonesets zone1 Current List of ZoneSets for Zone: zone1 ---------------------------------- zone_set_1 A-102 59226-00 B...
Page 257: Zoneset Command
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-106 for information about starting a Zoning Edit session. The Active, List, and Zones keywords are available without an Admin session.
Page 258 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 259 A – Command Line Interface Zoneset Command The following is an example of the Zoneset Zones command: SANbox #> zoneset zones ssss Current List of Zones for ZoneSet: ssss ---------------------------------- zone1 zone2 zone3 59226-00 B A-105...
Page 260: Zoning Command
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-99 and the “Zoneset Command” on page A-103. Authority Admin session except for the Active, History, Limits, and List keywords.
Page 261: A-17 Zoning Database Limits
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 262 A – Command Line Interface Zoning Command save Saves changes made during the current Zoning Edit session. The system will inform you that the zone set must be activated to implement any changes. This does not apply if you entered the Zoning Clear command during the Zoning Edit session.
Page 263 A – Command Line Interface Zoning Command The following is an example of the Zoning Limits command: SANbox #> zoning limits Zoning Attribute Maximum Current [Zoning Name] ---------------- ------- ------- ------------- MaxZoneSets MaxZones 2000 MaxAliases 2500 MaxTotalMembers 10000 MaxZonesInZoneSets 2000 MaxMembersPerZone 2000 D_1_JBOD_1...
Page 264 A – Command Line Interface Zoning Command The following is an example of the Zoning List command: SANbox #> 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 50:06:04:82:bf:d2:18:d2...
Page 265 A – Command Line Interface Zoning Command 59226-00 B A-111...
Page 266 A – Command Line Interface Zoning Command Notes A-112 59226-00 B...
Page 267 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 268 SANbox 1400 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 269 SANbox 1400 Series Switch Management User’s Guide Input Power LED A chassis LED that indicates that the Management Information Base switch logic circuitry is receiving proper DC voltages. Multistage Topology A fabric in which two or more edge Inter-Switch Link switches connect to one or more core The connection between two switches switches.
Page 270 SANbox 1400 Series Switch Management User’s Guide SNMP Simple Network Management Protocol Soft Zone Soft zoning divides the fabric for purposes of controlling discovery. Members of the same soft zone automatically discover and communicate freely with all other members of the same zone. Target A storage device that responds to an initiator device.
Page 271 Index access control list zone 3-22, 3-37 beacon A-37 account name BootP boot method 4-26 display A-98 broadcast 4-21, A-63 factory A-2 browser 2-2 active zone set 3-16, 3-22 browser location 2-18, 5-22 Active Zoneset data window 3-16 Admin account name A-7 authority A-7 chassis Admin command A-8...
Page 272 SANbox 1400 Series Switch Management User’s Guide event logging by component A-51, A-81 data window by port A-53, A-83 Active Zoneset 3-16 by severity level A-83 Configured Zonesets 4-12 display A-81 description 2-25, 2-29, 2-32 restore defaults A-53 Devices 3-15, 4-8 save settings A-54 port information 5-7 settings A-83...
Page 273 SANbox 1400 Series Switch Management User’s Guide faceplate display Hotreset command A-22 data window 2-32 description 2-20, 2-30 open 2-28 factory defaults 4-34, A-31 I/O Stream Guard 5-14, A-43 FC-4 descriptor 5-14 Image command A-23 FDMI - See Fabric Device Management inactivity timeout A-59 Interface in-band management 4-21...
Page 274 SANbox 1400 Series Switch Management User’s Guide loop port non-disruptive activation A-22 bypass A-55 Non-Disruptive Code Load and Activation 4-15 enable A-55 fabric 5-2, 5-13 initialization A-26 loopback test 5-16 loss of signal monitoring 4-13 online help 2-19 test 5-17 online test A-91 operating systems 2-2 manufacturer information A-87...
Page 275 SANbox 1400 Series Switch Management User’s Guide Ping command A-28 polling frequency 5-23 Quit command A-30 port administrative state 5-11, A-56 buffer credits 5-15 configuration 5-10, A-40 configuration display A-77 read community 4-29 counters A-55 refresh 3-9, 4-7 credit 5-15 Registered State Change Notification 5-14, displaying information 5-1 A-43...
Page 276 SANbox 1400 Series Switch Management User’s Guide Set Log command A-51 switch Set Port command A-55 add 3-7 Set Setup command A-57 administrative state 4-19, A-38 severity levels 3-12 advanced properties 4-22 SFP level test 5-17 configuration 4-17, A-43 shortcut key 2-22 configuration display A-77 Show command A-62 delete 3-7...
Page 277 SANbox 1400 Series Switch Management User’s Guide topology display working arrange icons 2-28 directory 2-18, 5-22 data windows 2-29 status indicator 2-25 description 2-20 workstation requirements 2-2 usage 2-26 write community 4-29 transceiver status 5-4 transmission speed 5-12 trap authentication 4-29 zone community 4-29 access control list 3-22...
Page 278 SANbox 1400 Series Switch Management User’s Guide zone set activate 3-32, A-103 active 3-16, 3-22, A-106 add member zone A-103 copy A-103 create 3-31, A-103 deactivate 3-32, A-32, A-104 definition 3-22 delete A-104 delete member zone 3-32, A-104 discard inactive 3-29 display A-104 display active A-103 display members A-104...

Qlogic SANbox 1400 Series User Manual

Introduction

Using Sansurfer Switch Manager Workstation Requirements

Figure

Managing Fabrics

Table

Managing Switches

Managing Ports

Appendix A Command Line Interface

Quick Links

Need help?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Qlogic SANbox 1400 Series

Summary of Contents for Qlogic SANbox 1400 Series