D Simplify SANbox 5200 Switch Management User’s Guide 59056-00 Rev.
D SANbox 5200 Switch Management User’s Guide Information furnished in this manual is believed to be accurate and reliable. However, QLogic Corporation assumes no responsibility for its use, nor for any infringements of patents or other rights of third parties which may result from its use. QLogic Corporation reserves the right to change product specifications at any time without notice. Applications described in this document for any of these products are for illustrative purposes only.
Table of Contents Section 1 Introduction 1.1 1.2 1.3 1.4 1.4.1 1.4.2 1.4.3 Intended Audience ............................................................................................. 1-1 Related Materials ............................................................................................... 1-1 JDOM License.................................................................................................... 1-2 Technical Support..................................................................
SANbox 5200 Switch Management User’s Guide D 2.13.4 2.13.5 2.13.6 2.14 2.14.1 2.14.2 2.14.2.1 2.14.2.2 2.14.2.3 2.14.3 2.15 2.15.1 2.15.2 2.15.2.1 2.15.2.2 2.15.3 Graphic Window ...................................................................................... 2-24 Data Window and Tabs............................................................................ 2-24 Working Status Indicator.......................................................................... 2-24 Using the Topology Display ......
D SANbox 5200 Switch Management User’s Guide 3.4.1 3.4.1.1 3.4.1.2 3.4.1.3 3.4.1.4 3.4.1.5 3.4.2 3.4.2.1 3.4.2.2 3.4.3 3.4.4 3.4.4.1 3.4.5 3.4.6 3.4.7 3.4.7.1 3.4.7.2 3.4.7.3 3.4.7.4 3.4.7.5 3.4.7.6 3.4.8 3.4.8.1 3.4.8.2 3.4.8.3 3.4.8.4 3.4.8.5 3.4.8.6 3.4.8.7 3.4.8.8 3.4.9 3.4.9.1 3.4.9.2 3.4.9.3 3.4.10 Zoning Concepts ..................................................................................... 3-14 Zones...........................................................................................
SANbox 5200 Switch Management User’s Guide 4.1.3 4.1.4 4.2 4.2.1 4.2.2 4.2.3 4.2.4 4.2.5 4.2.6 4.2.7 4.3 4.4 4.5 4.6 4.7 4.8 4.9 4.10 4.10.1 4.10.2 4.10.2.1 4.10.2.2 4.10.2.3 4.10.2.4 4.10.2.5 4.10.2.6 4.10.2.7 4.10.2.8 4.10.2.9 4.10.3 4.10.3.1 4.10.3.2 4.10.3.3 4.10.3.4 4.11 4.12 4.13 4.14 4.15 Page vi D Changing a User Account Password......................................................... 4-5 Modifying a User Account..........................................................................
D SANbox 5200 Switch Management User’s Guide 4.15.1 4.15.2 4.15.3 4.16 Installing Firmware .................................................................................. 4-34 Activating the Pending Firmware............................................................. 4-35 Changing the Pending Firmware ............................................................. 4-35 Displaying Hardware Status .............................................................................
SANbox 5200 Switch Management User’s Guide D Hardreset Command ...............................................................................A-16 Help Command........................................................................................A-17 History Command....................................................................................A-18 Hotreset Command .................................................................................A-19 Image Command .....................................
D B.10 B.11 B.12 SANbox 5200 Switch Management User’s Guide Printing Graphs ..................................................................................................B-9 Rescaling a Selected Graph...............................................................................B-9 Saving Graph Statistics to a File ........................................................................B-9 Appendix C Messages C.1 C.2 C.3 C.4 C.5 C.6 C.7 C.8 C.9 C.10 C.11 C.12 C.13 C.14 Fabrics File—Open, Save ......
D SANbox 5200 Switch Management User’s Guide 3-3 3-4 3-5 3-6 4-1 4-2 4-3 4-4 4-5 4-6 4-7 4-8 4-9 4-10 4-11 4-12 4-13 4-14 4-15 4-16 5-1 5-2 5-3 5-4 B-1 B-2 B-3 B-4 B-5 Filter Events Dialog ...................................................................................................... 3-12 Active Zone Set Data Window ..................................................................................... 3-13 Zoning Config Dialog.........................................................................
D 4-7 4-8 4-9 4-10 4-11 4-12 5-1 5-2 5-3 5-4 5-5 5-6 5-7 5-8 5-9 A-1 A-2 A-3 A-4 A-5 A-6 A-7 A-8 A-9 A-10 A-11 A-12 A-13 A-14 A-15 A-16 C-1 C-2 C-3 C-4 C-5 C-6 C-7 C-8 C-9 C-10 C-11 C-12 C-13 C-14 SANbox 5200 Switch Management User’s Guide Timeout Values ............................................................................................................ 4-24 IP Configuration Parameters........................................................................................
SANbox 5200 Switch Management User’s Guide D Notes Page xii 59056-00 Rev.
Section 1 Introduction This manual describes the switch management tools which include the SANboxÆ Manager application (version 4.00) and the Command Line Interface (CLI) for the SANbox 5200 Fibre Channel switch (firmware version 4.0). The SANbox 5200 switch is a 20 port non-blocking Fibre Channel switch. This manual defines the features, components, and performance characteristics of the SANbox 5200 switch.
D 1 – Introduction JDOM License 1.3 JDOM License This product includes software developed by the JDOM Project (http://www.jdom.org/). Copyright (C) 2000-2002 Brett McLaughlin & Jason Hunter. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions, and the following disclaimer. 2.
D 1 – Introduction Technical Support 1.4 Technical Support Customers should contact their authorized maintenance provider for technical support of their QLogic switch products. QLogic-direct customers may contact QLogic Technical Support; others will be redirected to their authorized maintenance provider. Visit the QLogic support Web site listed in Contact Information for the latest firmware and software updates. 1.4.
1 – Introduction Technical Support D Notes 1-4 59056-00 Rev.
Section 2 Using SANbox Manager This section describes how to use the SANbox Manager application and its menus.
D 2 – Using SANbox Manager Installing SANbox Manager Your switch was shipped with either a SANsurfer Management Suite Disk or a SANbox Installation Disk.
D 2 – Using SANbox Manager Installing SANbox Manager 2.1.2 SANsurfer Management Suite Disk - Linux Installation To install the SANsurfer application on Linux from the SANsurfer Management Suite Disk, do the following: 1. Insert the SANsurfer Management Suite Disk into the management workstation CD-ROM drive. If a file browser dialog opens showing icons for the contents of the CD-ROM, double-click the Start_Here.htm file to open the SANsurfer Management Suite start page.
D 2 – Using SANbox Manager Installing SANbox Manager 2.1.3 SANsurfer Management Suite Disk - Solaris Installation To install the SANsurfer application on Solaris from the SANsurfer Management Suite CD-ROM, do the following: 1. Insert the SANsurfer Management Suite Disk into the management workstation CD-ROM drive. If the SANsurfer Management Suite start page does not open in your default browser, do the following: a. Right-click the Workspace Menu. b. Select File, then select File Manager. c.
D 2 – Using SANbox Manager Starting SANsurfer Management Suite 2.2 Starting SANsurfer Management Suite To start the SANsurfer application for the first time, choose one of the following methods: For a Windows platform, double-click the SANsurfer shortcut, or select SANsurfer from Start menu, depending on how you installed the SANsurfer application. From a command line, you can enter the SANsurfer command: \SANsurfer.
2 – Using SANbox Manager Exiting SANsurfer Management Suite D Click the Open Existing Fabric View File radio button to open the Open View dialog which prompts you to specify a fabric view file that you saved earlier. Refer to ”Opening a Fabric View File” on page 3-4. Click the Start Application Without Specifying a Fabric radio button to open the SANbox Manager window shown in Figure 2-6.
D 2 – Using SANbox Manager Uninstalling SANsurfer Management Suite To prevent SANbox Manager from prompting you to save the default fabric view file between SANbox Manager sessions, set the View File Auto Save and Load preferences setting to Enable (default). Refer to ”Setting SANbox Manager Preferences” on page 2-14 for more information. Figure 2-3.
2 – Using SANbox Manager Uninstalling SANsurfer Management Suite D For Windows, browse for the uninstall program file or the shortcut/link that points to the uninstall program file. The uninstall program shortcut is in the same folder as the program shortcut (Start menu, program group, on desktop, or user specified) that is used to start the SANbox Manager application. Double-click the uninstall program file or shortcut/link, and follow the instructions to uninstall the SANsurfer application.
D 2 – Using SANbox Manager Starting SANbox Manager 2. Execute the install program and follow the SANbox Manager installation instructions. 2.4.3 SANbox Manager Installation Disk - Solaris Installation To install the SANbox Manager application on Solaris from the SANbox Manager Installation Disk, do the following: 1. Insert the SANbox Installation Disk into the management workstation CD-ROM drive. 2. Open a terminal window. If the disk isn’t already mounted, enter the following command: volcheck 3.
D 2 – Using SANbox Manager Starting SANbox Manager Figure 2-5. Initial Startup Dialog 2-10 Click the Open Existing Fabric radio button to open the Add a New Fabric dialog, which prompts you for a fabric name, IP address, account name, and password. Refer to ”Adding a Fabric” on page 3-3. Click the Open Existing Fabric View File radio button to open the Open View dialog which prompts you to specify a fabric view file that you saved earlier. Refer to ”Opening a Fabric View File” on page 3-4.
D 2 – Using SANbox Manager Exiting SANbox Manager Figure 2-6. SANbox Manager Window 2.6 Exiting SANbox Manager To exit a SANbox 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-7, prompts you to save the current fabric view as the default fabric view file. Enter an encryption key in the Default Fabric File Encryption Key field.
D 2 – Using SANbox Manager Uninstalling SANbox Manager Figure 2-7. Save Default Fabric View File Dialog – SANbox Manager In your next SANbox Manager session, the Load Default Fabric File dialog shown in Figure 2-8 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.
D 2 – Using SANbox Manager Changing the Encryption Key for the Default Fabric View File desktop, or user specified) that is used to start the SANbox Manager application. Double-click the uninstall program file or shortcut/link, and follow the instructions to uninstall the SANbox Manager application. For Linux, execute the link to Uninstall_SANbox_Manager.
D 2 – Using SANbox Manager Saving and Opening Fabric View Files 2.9 Saving and Opening Fabric View Files A fabric view file is one or more fabrics saved to a file. In addition to the SANbox Manager default fabric view file, you can save and open your own fabric view files. To save a set of fabrics to a file, do the following: 1. Open the File menu and select Save View As to open the Save View dialog. 2. Enter a name for the fabric file or click the Browse button to select an existing file.
D 2 – Using SANbox Manager Setting SANbox Manager Preferences Enable (default) or disable the Event Browser. Refer to ”Displaying the Event Browser” on page 3-9. If the Event Browser is enabled using the Preferences dialog, the next time SANbox Manager is started, all events from the switch alarm log will be displayed. If the Event Browser is disabled when SANbox Manager is started and later enabled, only those events from the time the Event Browser was enabled and forward will be displayed.
2 – Using SANbox Manager Using Online Help D 2.11 Using Online Help Online help is available for the SANbox Manager application and its functions. The two ways to open the online help file are: open the Help menu and select Help Topics, or click the Help button in the tool bar. You can also display context-sensitive help for all SANbox Manager dialogs by choosing the Help button in the dialog. 2.
D 2 – Using SANbox Manager SANbox Manager User Interface 2.13 SANbox Manager User Interface The SANbox Manager application uses two basic displays to manage the fabric and individual switches: the topology display and the faceplate display. The topology display shows all switches that are able to communicate and all connections between switches. The faceplate display shows the front of a single switch and its ports. Both displays share some common elements as shown in Figure 2-10.
2 – Using SANbox Manager SANbox Manager User Interface D 2.13.1 Menu Bars The menus and the options offered in them vary depending on the display. For example, the Port menu and many of the Switch menu selections are available only in the faceplate display. 2.13.1.1 Topology Display Menu The menu options available in the topology display are described below. Figure 2-11. Topology Display Menu 2-18 59056-00 Rev.
D 2 – Using SANbox Manager SANbox Manager User Interface 2.13.1.2 Faceplate Display Menu The menu options available in the faceplate display are described below. Figure 2-12. Faceplate Display Menu The keyboard shortcut keys available vary by display type: topology display and faceplate display. In addition to the menu bar, both the topology and faceplate displays have context sensitive menus that pop up when you right-click in the graphic window.
D 2 – Using SANbox Manager SANbox Manager User Interface 2.13.1.3 Topology Display Shortcut Keys The shortcut keys for the topology display are shown in Table 2-2. The shortcut key combinations are not case-sensitive. Table 2-2.
D 2 – Using SANbox Manager SANbox Manager User Interface 2.13.1.4 Faceplate Display Shortcut Keys The shortcut keys for the faceplate display are shown in Table 2-3. The shortcut key combinations are not case-sensitive. Table 2-3. Faceplate Display Shortcut Keys Shortcut 59056-00 Rev.
D 2 – Using SANbox Manager SANbox Manager User Interface 2.13.2 Tool Bar The tool bar consists of a row of graphical buttons that you can use to access SANbox Manager functions as shown in Table 2-4. The tool bar buttons are an alternative method to using the menu bar. The tool bar can be relocated in the display by clicking and dragging the handle at the left edge of the tool bar. Table 2-4. Tool Bar Buttons Tool Bar Button Description Add Fabric button - adds a new fabric to the fabric view.
D 2 – Using SANbox Manager SANbox Manager User Interface 2.13.3 Fabric Tree The fabric tree lists the managed fabrics and their switches as shown in Figure 2-13. The window width can be adjusted by clicking and dragging the moveable window border. An entry handle located to the left of an entry in the tree indicates that the entry can be expanded or collapsed. Click this handle or double-click the entry to expand or collapse a fabric tree entry. A fabric entry expands to show its member switches.
2 – Using SANbox Manager SANbox Manager User Interface D To open the topology display from the fabric tree, click a fabric entry. To open the faceplate display from the fabric tree, click a switch entry. 2.13.4 Graphic Window The graphic window, as shown in Figure 2-10, 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.
D 2 – Using SANbox Manager Using the Topology Display 2.14 Using the Topology Display The topology display shown in Figure 2-14 receives information from the selected fabric and displays its topology. Switches and inter-switch links (ISLs) appear in the graphic window and use color to indicate status. Consider the following topology display features: Switch and link status Working with switches and links Topology data windows Figure 2-14. Topology Display 2.14.
2 – Using SANbox Manager Using the Topology Display D 2.14.2 Working with Switches and Links Switch and link icons are selectable and moveable, and serve as access points for other displays and menus. You select switches and links to display information about them, modify their configuration, or delete them from the display. Context-sensitive popup menus are displayed when you right-click on a switch or link icon, or in the background of the topology display graphic window. 2.14.2.
D 2 – Using SANbox Manager Using the Topology Display 2.14.2.3 Opening the Faceplate Display and Topology Popup Menus The faceplate display shows the front of a single switch and its ports. To open the faceplate display when viewing the topology display, click the switch entry/icon in the fabric tree, or double-click the switch graphic. The topology display also offers a fabric, switch, and a link popup menu: To open the fabric popup menu, right-click the graphic window background.
D 2 – Using SANbox Manager Using the Faceplate Display 2.15 Using the Faceplate Display The faceplate display shown in Figure 2-15 displays the switch name and operational state, and port status. Consider the following functional elements of the faceplate display: Port views and status Working with ports Faceplate data windows Figure 2-15. Faceplate Display 2.15.1 Port Views and Status Port color and text provide information about the port and its operational state.
D 2 – Using SANbox Manager Using the Faceplate Display 2.15.2 Working with Ports Ports are selectable and serve as access points for other displays and menus. You select ports to display information about them in the data window or to modify them. Context-sensitive popup menus are displayed when you right-click the faceplate image or on a port icon in the faceplate display. 2.15.2.1 Selecting Ports You can select ports in the following ways. Selected ports are outlined in white.
D 2 – Using SANbox Manager Using the Faceplate Display 2.15.3 Faceplate Data Windows The faceplate display provides the following data windows corresponding to the data window tabs: 2-30 Name Server – displays all devices connected to the switch that are logged with the name server. Switch – displays current switch configuration data. Port Statistics – displays performance data for the selected ports. Port Information – displays information for the selected ports.
Section 3 Managing Fabrics This section describes the following tasks that manage fabrics: Securing a fabric Managing the fabric database Displaying fabric information Zoning a fabric 3.1 Fabric Security The components of Fibre Channel fabric security are: User account security Fabric services 3.1.1 User Account Security User account security is the process by which your user account and password are authenticated with the list of valid user accounts and passwords.
D 3 – Managing Fabrics Fabric Security Manager grants access to its menus according to your authority level. If you do not have Admin authority, you are limited to monitoring tasks. Note: If a user is logged into a switch using SANbox Manager or CLI, and an administrator changes user access rights, passwords, or UserAuthentication security settings, existing logins will not be affected by the new settings. Login access and privileges are only checked for a new login request. 3.1.
D 3 – Managing Fabrics Managing the Fabric Database 1. On the faceplate display, open the Switch menu and select Switch Properties to open the Switch Properties dialog. 2. Click the In-band Management Enable button. 3. Click the OK button to save the change to the database. 3.2 Managing the Fabric Database A fabric database contains the set of fabrics that you have added during a SANbox Manager session.
D 3 – Managing Fabrics Managing the Fabric Database 4. Click the Add Fabric button. Note: A switch supports a combined maximum of 19 logins or sessions reserved as follows: 4 logins or sessions for internal applications such as management server and SNMP 9 high priority Telnet sessions 6 logins or sessions for SANbox Manager inband and out-of-band logins, Application Programming Interface (API) inband and out-of-band logins, and Telnet logins. Additional logins will be refused. 3.2.
D 3 – Managing Fabrics Managing the Fabric Database 3.2.5 Rediscovering a Fabric After making changes to or deleting switches from a fabric view, it may be helpful to again view the actual fabric configuration. The rediscover fabric option clears out the current fabric information being displayed, and rediscovers all switch information. To rediscover a fabric, open the Fabric menu, and select Rediscover Fabric. The rediscover function is more comprehensive than the refresh function. 3.2.
D 3 – Managing Fabrics Managing the Fabric Database 3.2.7 Replacing a Failed Switch The archive/restore works for all switches. However, the Restore menu item is not available for the in-band switches. You can only restore a switch out-of-band (the fabric management switch). There are certain parameters that are not archived, and these are not restored by SANbox Manager. Refer to ”Archiving a Switch” on page 4-30 and ”Restoring a Switch” on page 4-30 for information about archive and restore.
D 3 – Managing Fabrics Displaying Fabric Information 3.2.8 Deleting Switches and Links The SANbox Manager application does not automatically delete switches or links that have failed or have been physically removed from the Fibre Channel network. 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 SANbox Manager application will restore it automatically. You can also refresh the display.
D 3 – Managing Fabrics Displaying Fabric Information yellow indicates a condition that may require attention to maintain maximum performance, and red indicates a potential failure. Table 3-1 shows the different switch icons and their meanings. Table 3-1.
D 3 – Managing Fabrics Displaying Fabric Information 3.3.2 Displaying the Event Browser The Event Browser displays a list of recorded events and alarms generated by the switches in the fabric and the SANbox Manager application. Events are generated by the SANbox Manager application and are not saved on the switch, but can be saved to a file during the SANbox Manager session.
D 3 – Managing Fabrics Displaying Fabric Information Column Sorting Buttons Severity Column Figure 3-2. Events Browser Severity is indicated in the severity column using icons as described in Table 3-2. Table 3-2. Severity Levels Severity Icon Description Alarm – An alarm is an event generated by the switch that specifically requests attention. Critical event – An event generated by the SANbox Manager application and indicates a potential failure.
D 3 – Managing Fabrics Displaying Fabric Information Note: Events (Critical, Warning, Normal, and Informative) are generated by the application and are not saved on the switch. They are permanently discarded when you close a SANbox Manager session, but you can save these events to a file on the workstation before you close SANbox Manager and read it later with a text editor or browser. Alarms are generated by the switch, stored on switch, and will be retrieved when the application is restarted.
D 3 – Managing Fabrics Displaying Fabric Information Figure 3-3. Filter Events Dialog 3.3.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.
D 3 – Managing Fabrics Displaying Fabric Information 3.3.3 Active Zone Set Data Window The Active Zoneset data window displays the zone membership for the active zone set that resides on the fabric management switch. The active zone set is the same on all switches in the fabric – you can confirm this by adding a fabric through another switch and comparing Active Zone Set displays. To open the Active Zoneset data window, click the Active Zoneset tab below the data window in the topology display.
D 3 – Managing Fabrics Zoning a Fabric 3.4 Zoning a Fabric Zoning enables you to divide the ports and devices of the fabric into zones for more efficient and secure communication among functionally grouped nodes. This subsection addresses the following topics: Zoning concepts Using the Zoning Config dialog Restoring default zoning Merging fabrics and zoning Using the Edit Zoning dialog Merging fabrics and zoning Managing zone sets Managing zones Managing aliases 3.4.
D 3 – Managing Fabrics Zoning a Fabric FCID entries define zone membership by the Fibre Channel address of the attached device. With this membership method you can replace a device on the same port without having to edit the member entry as you would with a WWN member. Domain ID/Port number entries define zone membership by switch domain ID and port number. All devices attached to the specified port become members of the zone. The specified port must be an F_Port or an FL_Port.
D 3 – Managing Fabrics Zoning a Fabric 3.4.1.2 Aliases To make it easier to add a group of ports or devices to one or more zones, you can create an alias. An alias is a named set of ports or devices that are grouped together for convenience. Unlike zones, aliases impose no communication restrictions between its members. You can add an alias to one or more zones. However, you cannot add a zone to an alias, nor can an alias be a member of another alias. 3.4.1.
D 3 – Managing Fabrics Zoning a Fabric MaxTotalMembers is 2000. The maximum number of total zone and alias members that can be configured on the switch. This will be enforced during the configuration of zoning and during a zoning database merge from the fabric. Aliases are considered zone members since they can be added to a zone just like a normal zone member. MaxZonesInZoneSets is 1000. The maximum number of zone linkages to zonesets that can be configured on the switch.
D 3 – Managing Fabrics Zoning a Fabric 3.4.2.1 FC-SW-2 Auto Save The FC-SW-2 Auto Save parameter determines whether changes to the active zone set that a switch receives from other switches in the fabric will be saved to the zoning database on that switch. Changes are saved when an updated zone set is activated. Zoning changes are always saved to temporary memory. However, if Auto Save is enabled, the switch firmware saves changes to the active zone set in temporary memory and to the zoning database.
D 3 – Managing Fabrics Zoning a Fabric 3.4.4 Merging Fabrics and Zoning If you join two fabrics with an inter-switch link, the active zone sets from the two fabrics attempt to merge automatically. The fabrics may consist of a single switch or many switches already connected together. The switches in the two fabrics attempt to create a new active zone set containing the union of each fabric's active zone set.
D 3 – Managing Fabrics Zoning a Fabric Refer to ”Managing Zones” on page 3-25 for information about adding and removing zone members. Refer to ”Resetting a Port” on page 5-16 for information about resetting a port. 3.4.6 Using the Edit Zoning Dialog 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-6.
D 3 – Managing Fabrics Zoning a Fabric Note: If the FC-SW2-Auto-Save parameter is enabled on the Switch Properties dialog, then every time the active zone set changes, the switch will copy it into an inactive zone set stored on the switch. You can edit this copy of the active zone set stored on the switch, and activate the updated copy to conveniently apply the changes to the active zone set. The edited copy then becomes the active zone set.
D 3 – Managing Fabrics Zoning a Fabric Table 3-3.
D 3 – Managing Fabrics Zoning a Fabric Creating zone sets Activating and deactivating zone sets Copying a zone to a zone set Removing a zone from one zone set or from all zone sets Removing a zone set Removing all zoning definitions Note: Changes that you make to the zoning database are limited to the managed switch and do not propagate to the rest of the fabric.
D 3 – Managing Fabrics Zoning a Fabric The purpose of the deactivate function is to suspend all fabric zoning which results in free communication fabric wide or no communication depending on the default visibility setting. Refer to ”Default Visibility” on page 3-18 for more information. It is not necessary to deactivate the active zone set before activating a new one. To activate a zone set, open the Zoning menu and select Activate Zone Set to open the Activate Zone Set dialog.
D 3 – Managing Fabrics Zoning a Fabric 2. In the Zone Sets tree, select the zone set to be removed. 3. Open the Edit menu, and select Remove to remove the zone set. 4. Click the Apply button to save changes to the zoning database. Alternatively, you may use shortcut menus to remove a zone set from the database. 3.4.7.6 Removing All Zoning Definitions To clear all zone and zone set definitions from the zoning database, choose one of the following: Open the Edit menu and select Clear Zoning.
D 3 – Managing Fabrics Zoning a Fabric 3.4.8.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-28 for more information. Refer to ”Zones” on page 3-14 for information on zone types (soft and hard). To create a zone in a zone set, do the following: 1. Open the Zoning menu, and select Edit Zoning to open the Edit Zoning dialog. 2. Select a zone set. 3.
D 3 – Managing Fabrics Zoning a Fabric Open the Edit menu or right click on the selected zone and select Create Members. Choose the WWN, Domain/Port, or First Port Address radio button and enter the port hex value. Click the Apply button to save changes to the zoning database. Note: Domain ID conflicts can result in automatic reassignment of switch domain IDs. These reassignments are not reflected in zones that use domain ID/port number pair to define their membership.
D 3 – Managing Fabrics Zoning a Fabric 3.4.8.5 Removing a Zone Member Removing a zone member will affect every zone and zone set in which that zone is a member. To remove a member from a zone: 1. In the Edit Zoning dialog, select the zone member to be removed. 2. Open the Edit menu and select Remove. 3. Click the OK button to save changes and close the Edit Zoning dialog. 3.4.8.6 Removing a Zone from a Zone Set Zones that are no longer members of any zone set are moved to the orphan zone set.
D 3 – Managing Fabrics Zoning a Fabric 3.4.9 Managing Aliases An alias is a collection of objects that can be zoned together. An alias is not a zone, and can not have a zone or another alias as a member. Note: Changes that you make to the zoning database are limited to the managed switch and do not propagate to the rest of the fabric. To distribute changes to configured zone sets fabric wide, you must edit the zoning databases on the individual switches. You will not see aliases in the active zone set.
D 3 – Managing Fabrics Zoning a Fabric 1. Open the Zoning menu, and select Edit Zoning to open the Edit Zoning dialog. 2. In the left pane, select an alias. 3. In the right pane, select the member to add to the selected alias. 4. Choose one of the following: 5. Open the Edit menu and select Add Members. Click the Insert button. Click the OK button to save changes and close the Edit Zoning dialog. 3.4.9.
Section 4 Managing Switches This section describes the following tasks that manage switches in the fabric.
D 4 – Managing Switches Managing User Accounts Switches come from the factory with the following user accounts: Table 4-1. Factory User Accounts Account Name Password Admin Authority Expiration admin admin true never expires images images false never expires The Admin account is the only user that can manage all user accounts with the User Account Administration dialogs. The Admin account can create, remove, or modify user accounts, and change account passwords.
D 4 – Managing Switches Managing User Accounts 4.1.1 Creating User Accounts To create a user account on a switch, open the Switch menu in the faceplate display and select User Accounts.... This displays the User Account Administration dialog shown in Figure 4-1. A switch can have a maximum of 15 user accounts. Figure 4-1. User Account Administration Dialog – Add Account 1. To open the User Account Administration dialogs, open the Switch menu in the faceplate display, and select User Accounts.... 2.
4 – Managing Switches Managing User Accounts D 4.1.2 Removing a User Account To remove a user account on a switch, open the Switch menu in the faceplate display and select User Accounts.... Click the Remove Account tab in the dialog to present the display shown in Figure 4-2. Select the account (login) name from the list of accounts at the top of the dialog and click the Remove Account button. Figure 4-2. User Account Administration Dialog – Remove Account 4-4 59056-00 Rev.
D 4 – Managing Switches Managing User Accounts 4.1.3 Changing a User Account Password To change the password for an account on a switch, open the Switch menu in the faceplate display and select User Accounts.... Click the Change Password tab in the dialog to present the display shown in Figure 4-3. Select the account (login) name from the list of accounts at the top of the dialog, then enter the old password, the new password, and verify the new password in the corresponding fields.
4 – Managing Switches Displaying Switch Information D 4.1.4 Modifying a User Account To modify a user account on a switch, open the Switch menu in the faceplate display and select User Accounts.... This displays the User Account Administration dialog shown in Figure 4-4. Click the Modify Account tab. Select the account (login) name from the list of accounts at the top of the dialog. Click the Admin authority Enabled check box to grant admin authority to the account name.
D 4 – Managing Switches Displaying Switch Information Performance statistics Port information Configured zone sets Figure 4-5 shows the faceplate display for the SANbox 5200 switch. Figure 4-5. Faceplate Display - Switch Information The fabric updates the topology and faceplate displays by forwarding changes in status to the management workstation as they occur. You can allow the fabric to update the switch status, or you can refresh the display at any time.
D 4 – Managing Switches Displaying Switch Information Table 4-2 for a description of the entries in the Name Server data window. Refer to ”Exporting Name Server Information to a File” on page 4-16 for exporting name server information. Table 4-2.
D 4 – Managing Switches Displaying Switch Information Table 4-3.
D 4 – Managing Switches Displaying Switch Information 4.2.3 Switch Data Window The Switch data window displays current network and switch information for the selected switches. Refer to ”Configuring a Switch” on page 4-19 for more information about the Switch data window. To open the Switch data window, select one or more switches in the topology display, or open the faceplate display, and click the Switch tab below the data window. Table 4-4 describes the Switch data window entries. Table 4-4.
D 4 – Managing Switches Displaying Switch Information Table 4-4. Switch Data Window Entries (Continued) Entry 59056-00 Rev. B Description Domain ID Lock Domain ID lock status. Prevents (True) or permits (False) dynamic domain ID reassignment. Number of Ports Number of ports activated on the switch.
D 4 – Managing Switches Displaying Switch Information Table 4-4. Switch Data Window Entries (Continued) Entry Description Power Supply 2 Status This field does not apply to this switch. Beacon Status Beacon status. Switch LEDs are blinking (On) or not (off). Broadcast Support Broadcast support status. Broadcast support is enabled or disabled (default). In-band Enabled In-band management status. Permits (True) or prevents (False) a switch from being managed over an ISL.
D 4 – Managing Switches Displaying Switch Information 4.2.5 Port Statistics Data Window The Port Statistics data window displays port performance data for the selected ports. To open the Port Statistics data window, click the Port Stats tab below the data window in the faceplate display. Refer to Table 5-5 for a description of the Port Statistics data window entries.
4 – Managing Switches Configuring Port Threshold Alarms D Figure 4-7. Configured Zonesets Data Window 4.3 Configuring Port Threshold Alarms You can configure the switch to generate alarms for selected events. Configuring an alarm involves choosing an event type, rising and falling triggers, a sample window, and finally enabling or disabling the alarm. To configure port threshold alarms, do the following: 1.
D 4 – Managing Switches Configuring Port Threshold Alarms Figure 4-8. Port Threshold Alarm Configuration Dialog 2. Check the Enable All Port Threshold Alarms check box to enable monitoring for all the individual alarm types that are enabled. The Enable All Port Threshold Alarms check box is the master control for the individual alarms. For example, the switch will monitor CRC errors only if both the CRC Error Enable box and the Enable All Port Threshold Alarms check box are checked. 3.
D 4 – Managing Switches Exporting Name Server Information to a File Generate rising trigger alarm; eligibility ends Generate rising trigger alarm; eligibility ends Rising Trigger Event Count Generate falling trigger alarm; eligibility is reset Falling Trigger Sample Window Figure 4-9. Port Threshold Alarm Example 7. Enter a sample window in seconds. The sample window defines the period of time in which to count events. 8. Repeat steps 3 through 7 for each alarm you want to configure or enable.
D 4 – Managing Switches Paging a Switch 4. Click the Save button. 4.6 Paging a Switch You can use the beacon feature to page a switch. The beacon feature causes all Logged-In LEDs to flash, making it easier to recognize. To page a switch, open the Switch menu in the faceplate display and enable the Toggle Beacon selection. To cancel the beacon, reselect Toggle Beacon. 4.7 Setting the Date and Time To set the date and time on a switch, do the following: 1.
D 4 – Managing Switches Resetting a Switch 4.9 Resetting a Switch Resetting a switch reboots the switch using configuration parameters in memory. Depending on the reset type, a switch reset may or may not include a power-on self test or it may or may not disrupt traffic. Table 4-4 describes the types of switch resets. During a hotreset operation, fabric services will be unavailable for a short period (30-75 seconds depending on switch model).
D 4 – Managing Switches Configuring a Switch Table 4-5. Switch Resets Type Description Reset without POST Resets a switch without a power-on self test. This reset activates the pending firmware and it is disruptive to switch traffic. Hard Reset Resets a switch with a power-on self test. This reset activates the pending firmware and it is disruptive to switch traffic. To reset a switch using SANbox Manager, do the following: 1. Select the switch to be reset and open the faceplate display. 2.
D 4 – Managing Switches Configuring a Switch Replace or restore a switch in an existing fabric. Recover or edit the IP configuration of an existing switch 4.10.
D 4 – Managing Switches Configuring a Switch 4.10.2.1 Symbolic Name The symbolic name is a user-defined name of up to 63 characters that identifies the switch. The symbolic name is used in the topology and faceplate displays, as well as many data windows to more easily identify switches. The illegal characters are the pound sign (#), semi-colon (;), and comma (,). 4.10.2.2 Switch Administrative States The switch administrative state determines the operational state of the switch.
D 4 – Managing Switches Configuring a Switch both switches will flash to show the affected ports. Refer to the ”Set Config Command” on page A-31 for information about the switch keyword and the Domain ID Lock and Principal Priority parameters. If you connect a new switch to an existing fabric with its domain ID unlocked, and a domain conflict occurs, the new switch will isolate as a separate fabric. However, you can remedy this by resetting the new switch or taking it offline then back online.
D 4 – Managing Switches Configuring a Switch 4.10.2.5 Broadcast Support Broadcast is supported on the SANbox which allows for TCP/IP support. Broadcast is implemented using the proposed standard specified in Multi-Switch Broadcast for FC-SW-3, T11 Presentation Number T11/02-031v0. Fabric Shortest Path First (FSPF) is used to set up a fabric spanning tree used in transmission of broadcast frames. Broadcast frames are retransmitted on all ISLs indicated in the spanning tree and all online F_Ports.
D 4 – Managing Switches Configuring a Switch Note: The Legacy Address Format setting must be the same on all switches in the fabric, otherwise the inter-switch links will not connect. 4.10.2.9 Timeout Values The switch timeout values determine the timeout values for all ports on the switch. Table 4-7 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.
D 4 – Managing Switches Configuring a Switch 4.10.3 Network Properties Use the Network Properties dialog shown in Figure 4-12 to change IP and SNMP configuration parameters. 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.
D 4 – Managing Switches Configuring a Switch 4.10.3.1 IP Configuration The IP configuration identifies the switch on the Ethernet network and determines which network discovery method to use. Table 4-8 describes the IP configuration parameters. Table 4-8. IP Configuration Parameters Parameter 4-26 Description Network Discovery Choose one of the following methods by which to assign the IP address: Static - Uses the IP configuration parameters entered in the Switch Properties dialog.
D 4 – Managing Switches Configuring a Switch 4.10.3.2 SNMP Configuration The SNMP configuration defines how authentication traps are managed.Table 4-9 describes the SNMP configuration parameters. The illegal characters for the user-defined fields are the pound sign (#), semi-colon (;), and comma (,). Table 4-9. SNMP Configuration Parameters 59056-00 Rev. B Parameter Description SNMP Enabled Enables or disables SNMP communication with other switches in the fabric.
D 4 – Managing Switches Configuring a Switch 4.10.3.3 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-10 describes the SNMP configuration parameters. Table 4-10. SNMP Trap Configuration Parameters Parameter Description Trap Version Specifies the SNMP version (1 or 2) with which to format traps. Trap 1 Enabled Enables or disables the trap. If disabled, traps are not configurable.
D 4 – Managing Switches Archiving a Switch 4.11 Archiving a Switch You can create an .XML archive file containing the configuration parameters. Basically any data received by SANbox Manager is archived. However, user authentication and passwords are available only through the command line interface, and are not received by the SANbox Manager, and thus are not archived.
D 4 – Managing Switches Restoring a Switch 2. Open the Switch menu in the faceplate display and select Restore to display the Restore dialog shown in Figure 4-13. The Restore dialog offers a Full Restore and a Selective Restore tab. Figure 4-13. Restore Dialogs – Full and Selective 4-30 3. Enter the archive file name or browse for the file. This archive file must be one that was produced by the SANbox Manager Archive function.
D 4 – Managing Switches Restoring the Factory Default Configuration Port Properties: Restores all settings presented in the Port properties dialog. Refer to ”Configuring Ports” on page 5-10. Configured Zoning: Restores all zone sets, zones, and aliases in the switch’s zoning database. 4.13 Restoring the Factory Default Configuration You can restore the switch and port configuration settings to the factory default values.
D 4 – Managing Switches Upgrading the SANbox 5200 Switch Using Port Licensing Table 4-11. Factory Default Configuration Settings (Continued) Setting Value FDMI Enabled True FDMI HBA Entry Level 1000 Subnet Mask Address 255.0.0.0 Gateway Address 10.0.0.254 Network Discovery Static Remote Logging False Remote Logging Host Ip Address 10.0.0.254 Contact Undefined Location Undefined Trap Enabled False Trap Port 162 Trap Address Trap 1: 10.0.0.254; Traps 2-5: 0.0.0.
D 4 – Managing Switches Managing Firmware 3. Open the faceplate display for the switch you want to upgrade. 4. Open the Switch Menu and select Features to open the Feature Licenses dialog shown in Figure 4-14. Figure 4-14. Features License Key Dialog 5. In the Feature Licenses dialog, click the Add button to open the Add License Key dialog shown in Figure 4-15. Figure 4-15. Add License Key Dialog 6. In the Add License Key dialog, enter the license key in the Key field. 7.
D 4 – Managing Switches Managing Firmware Install and activate new firmware Activate the pending firmware Change the pending firmware Note: To provide consistent performance throughout the fabric, ensure that all switches are running the same version of firmware. 4.15.1 Installing Firmware Installing firmware involves loading, unpacking, and activating the firmware image on the switch. SANbox Manager does this in one operation.
D 4 – Managing Switches Managing Firmware 2. In the Firmware Upload dialog, click the Select button to browse and select the firmware file to be uploaded. 3. Click the Start button to begin the firmware load process. 4. SANbox Manager prompts you to activate the new firmware using a hot (non-disruptive) reset, if possible. Click the OK button to reset the switch and activate the new firmware. 4.15.
D 4 – Managing Switches Displaying Hardware Status 4.16 Displaying Hardware Status To display a summary of the hardware status information in a popup text box, rest the cursor over the chassis LED cluster in the faceplate display. Input Power LED - indicates the voltage status of the switch. Heartbeat LED - indicates the status of the internal switch processor and the results of the POST. System Fault LED - indicates an over temperature condition or a POST (Power On Self Tests) error.
Section 5 Managing Ports This section describes the following tasks that manage ports and devices: Displaying port information Configuring ports Testing ports 5.1 Displaying Port Information Port information is available primarily in the faceplate display shown in Figure 5-1. The faceplate display data windows provide information and statistics for switches and ports. Use the topology display to view status information on fabrics, switches, and links between switches. Figure 5-1.
D 5 – Managing Ports Displaying Port Information 5.1.1 Monitoring Port Status The faceplate display provides the following port related information: Port type Port operational state Port speed Port media To display port number and status information for a port, position the cursor over a port on the faceplate display. The status information changes depending on the View menu option selected. 5.1.1.
D 5 – Managing Ports Displaying Port Information 5.1.1.2 Displaying Port Operational States To display the operational state on each port in the faceplate display, open the View menu and select View Port States. Table 5-2 lists the possible operational states and their meanings. The port operational state refers to actual port state and not the administrative state you may have assigned. Table 5-2. Port Operational States State Description On Online – port is active and ready to send data.
D 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) Optical SFP, Offline (Gray) Copper SFP, (Copper) XPAK Interface, Online (Green) XPAK Interface, Offline (Gray) None Empty port, no transceiver installed 5.1.
D 5 – Managing Ports Displaying Port Information Table 5-5. Port Statistics Data Window Entries Entry 59056-00 Rev. B Description Start Time The beginning of the period over which the statistics apply. The start time for the Absolute view is not applicable. The start time for the Rate view is the beginning of polling interval. The start time for the Baseline view is the last time the baseline was set. End Time The last time the statistics were updated on the display.
D 5 – Managing Ports Displaying Port Information Table 5-5. Port Statistics Data Window Entries (Continued) Entry 5-6 Description Flow Errors Number of times a frame is received and all the switch ports receive buffers are full. The normal Fabric Login exchange of flow control credit should prevent this from occurring. The frame will be discarded. FReject Number of frames, from devices, that have been rejected. Frames can be rejected for any of a large number of reasons.
D 5 – Managing Ports Displaying Port Information Table 5-5. Port Statistics Data Window Entries (Continued) Entry Description Total Errors Total number of primitive and non-primitive port link errors. Total Link Resets Number of link-reset primitives the transmitted by the port. Total LIPs Received Number of loop initialization primitive frames received. Total LIPs Transmitted Number of loop initialization primitive frames transmitted.
D 5 – Managing Ports Displaying Port Information Table 5-6. Port Information Data Window Entries (Continued) Entry 5-8 Description Operational Port Type The port type that is currently active. This will be set during port auto-configuration based on the administrative port type. Administrative Port State The port state (Online, Offline, Diagnostics, or Down) which has been set by the user.
D 5 – Managing Ports Displaying Port Information Table 5-6. Port Information Data Window Entries (Continued) Entry Description Device Scan Queries the connected device during login for FC-4 descriptor information. Disable this parameter only if the scan creates a conflict with the connected device. Symbolic Name Port symbolic name Ext Credits Requested Whether extended credits have been requested for ports. Credits to Donate The number of credits available to be donated by the selected port.
D 5 – Managing Ports Configuring Ports 5.2 Configuring Ports The port settings or characteristics for 1Gbps/2Gbps and 10Gbps ports 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 1G/2G or Port PropertiesProperties 10G. Figure 5-2.
D 5 – Managing Ports Configuring Ports 5.2.1 Changing Port Administrative States The port administrative state determines the operational state of a port. The port administrative state exists in two forms: the configured administrative state and the current administrative state. The configured administrative state is the state that is saved in the switch configuration and is preserved across switch resets. SANbox Manager always makes changes to the configured administrative state.
D 5 – Managing Ports Configuring Ports 3. Click the radio button that corresponds to the port speed you want. 4. Click the OK button to write the new port speed to the switch. Table 5-8. Port Speeds State Description Auto-Detect Matches the transmission speed of the connected device. This is the default. 1 Gbps Sets the transmission speed to 1 Gbps. 2 Gbps Sets the transmission speed to 2 Gbps. 5.2.
D 5 – Managing Ports Configuring Ports 5.2.4 Changing Interoperability Credits SANbox switches negotiate with other switches to resolve differences in the number of port buffer credits (on 1Gbps/2Gbps ports only). However, certain non-FC-SW-2-compliant switches do not negotiate and will isolate when connected. To remedy this situation, disconnect the switches, then reconfigure the SANbox E_Port to match the number of port buffer credits on the other switch.
D 5 – Managing Ports Configuring Ports 5.2.5 Changing Port Symbolic Name To change the symbolic name of a port from the faceplate display, do the following: 1. Open the faceplate display and select a port. 2. Open the Port menu and select Port Symbolic Name. 3. In the Port Symbolic Name dialog, choose one of the following: 4. Enter a new name for the port in the Set Port Symbolic Name field. Check the Restore Default Port Symbolic Name check box to restore the default name.
D 5 – Managing Ports Configuring Ports Only 1Gbps/2Gbps ports can donate or borrow credits. To extend credits, open the Wizards menu and select Ext Credit Wizard. The Extended Credit Wizard leads you through the following process to extend credits based on transmission distance requirements: 1. Extended Distance on SANbox: Explains the concepts and principles of extending port credits. Click the Next button. 2.
D 5 – Managing Ports Testing Ports 5.2.9 Resetting a Port The Reset Port option reinitializes the port using the saved configuration. To reset a port, do the following: 1. In the faceplate display, select the port(s) to be reset. 2. Open the Port menu and select Reset Port. 5.3 Testing Ports The port loopback tests verify correct port operation by sending a frame out through the loop, and then verifying that the frame received matches the frame that was sent.
D 5 – Managing Ports Testing Ports to the ASIC for the selected ports. The port passes the test if the test frame that was sent by the ASIC matches the test frame that was received. This test requires that the port be in diagnostics mode, and therefore, disrupts communication. Node-to-Node (Online) - The Node-to-Node test verifies communications between the port and its device node or device loop. The port being tested must be online and connected to a remote device.
5 – Managing Ports Testing Ports D Notes 5-18 59056-00 Rev.
Appendix A Command Line Interface The command line interface (CLI) enables you to perform a variety of fabric and switch management tasks through an Ethernet or a serial port connection. This section describes the following: Logging on to a switch User accounts Working with switch configurations Commands A.
A – Command Line Interface Working with Switch Configurations Note: D A switch supports a combined maximum of 19 logins or sessions reserved as follows: 4 logins or sessions for internal applications such as management server and SNMP 15 logins or sessions for SANbox Manager in-band and out-of-band logins, Application Programming Interface (API) in-band and out-of-band logins, and Telnet logins. Of these 15, there can be a combined maximum of 6 SANbox Manager and API logins.
D A – Command Line Interface Working with Switch Configurations Set Config commands with which you make modifications to the port, switch, port threshold alarm, or zoning configuration components as shown: SANbox #> admin start SANbox (admin) #> config edit default The config named default is being edited. SANbox (admin-config)#> set config port . . . SANbox (admin-config)#> set config switch . . . SANbox (admin-config)#> set config threshold . . . SANbox (admin-config)#> set config zoning . . .
A – Command Line Interface Working with Switch Configurations D 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. Transfer the file in binary mode with the Get command as shown: >ftp ip_address user:images password: images ftp>bin ftp>get configdata xxxxx bytes sent in xx secs.
D A – Command Line Interface Commands A.4 Commands The command syntax is as follows: command keyword keyword [value] keyword [value1] [value2] The Command is followed by one or more keywords. Consider the following rules and conventions: Commands and keywords are case insensitive. Required keyword values appear in standard font: [value]. Optional values are shown in italics: [value]. Underlined portions of the keyword in the command format indicate the abbreviated form that can be used.
D A – Command Line Interface Commands The command set performs monitoring and configuration tasks. Commands related to monitoring tasks are available to all account names. Commands related to configuration tasks are available only within an admin session. An account must have Admin authority to enter the Admin Start command, which opens an admin session. Refer to the ”Admin Command” on page A-7. The commands and their page numbers are listed in Table A-2. Table A-2.
D A – Command Line Interface Admin Command Admin Command Opens and closes an Admin session. The Admin session provides commands that change the fabric and switch configurations. Only one Admin session can be open on the switch at any time. An inactive Admin session will time out after a period of time which can be changed using the Set Setup System command. Refer to the ”Set Setup Command” on page A-50.
D 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.
D A – Command Line Interface Alias Command members [alias] Displays all members of the alias given by [alias]. This keyword does not require an admin session. remove [alias] [member_list] Removes the ports/devices given by [member_list] from the alias given by [alias]. Use a to delimit ports/devices in [member_list]. A port/device in [member_list] can have any of the following formats: Domain ID and port number pair (Domain ID, Port Number). Domain IDs can be 1–-239; port numbers can be 0–-255.
A – Command Line Interface Config Command D 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-33.
D A – Command Line Interface Config Command restore Restores configuration settings to an out-of-band switch from a backup file named configdata, which must be first uploaded on the switch using FTP. You create the backup file using the Config Backup command. Use FTP to load the backup file on a switch, then enter the Config Restore command. After the restore is complete, the switch automatically resets. Refer to ”Backing up and Restoring Switch Configurations” on page A-3.
A – Command Line Interface Config Command D The following is an example of how to create a backup file (configdata) and download the file to the workstation.
D A – Command Line Interface Date Command Date Command This command displays or sets the system date and time. To set the date and time the information string must be provided in this format: MMDDhhmmCCYY. The new date and time takes effect immediately. Authority Admin session except to display the date. Syntax date [MMDDhhmmCCYY] Keywords [MMDDhhmmCCYY] Specifies the date – this requires an admin session.
D A – Command Line Interface Fallback Command Fallback Command Assigns the pending firmware status back and forth between the active and inactive firmware images stored in switch memory. Authority Admin session Syntax Notes fallback Examples The Show Switch command displays the two firmware images, active firmware, inactive firmware, and pending firmware versions. After executing the Fallback command, reset the switch to activate the pending firmware.
D A – Command Line Interface Feature Command Feature Command Adds license key features to the switch and displays the license key feature log. To order a license key contact your switch distributor or your authorized reseller. After the upgrade is complete, the switch automatically resets. Authority Admin session for Add keyword only Syntax feature add [license_key] log Keywords add [license_key] Adds the feature that corresponds to the value given by [license_key].
A – Command Line Interface Hardreset Command D Hardreset Command Resets the switch and performs a power-on self test. This reset disrupts traffic, activates the pending firmware, and clears the alarm log. To save the alarm log before resetting, refer to the ”Set Log Command” on page A-45. Authority Admin session Syntax Notes hardreset To reset the switch without a power-on self test, refer to the ”Reset Command” on page A-26.
D A – Command Line Interface Help Command Help Command Displays a brief description of the specified command, its keywords, and usage. Authority None Syntax Keywords help [command] [keyword] [command] Displays a summary of the command given by [command] and its keywords. If you omit [command], the system displays all available commands. [keyword] Displays a summary of the keyword given by [keyword] belonging to the command given by [command].
D A – Command Line Interface History Command History Command Displays a numbered list of the previously entered commands from which you can re-execute selected commands. Authority None Syntax Notes history Examples Use the History command to provide context for the ! command: Enter ![command] to re-enter the most recent execution of that command.
D 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 alarm log. After the pending firmware is activated, the configuration is recovered. This process takes less than 80 seconds. To save the alarm log to a file before resetting, refer to the ”Set Log Command” on page A-45.
D 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] 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.
D A – Command Line Interface Lip Command Lip Command Reinitializes the specified loop port. Authority Admin session Syntax Keywords lip [port_number] Examples The following is an example of the Lip command: [port_number] The number of the port to be reinitialized. SANbox (admin) #> lip 2 59056-00 Rev.
D A – Command Line Interface Passwd Command Passwd Command Changes a user account’s password. Authority Admin account name and an admin session to change another account’s password; You can change you own password without an Admin session. Syntax Keywords passwd [account_name] Examples The following is an example of the Passwd command: [account_name] The user account name. To change the password for an account name other than your own, you must open an admin session with the account name Admin.
D 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 #> ping 10.20.11.57 Ping command issued. Waiting for response... SANbox #> Response successfully received from 10.20.11.57.
D A – Command Line Interface Ps Command Ps Command Displays current system process information. Authority None Syntax Examples ps The following is an example of the Ps command: SANbox #> ps PID A-24 PPID %CPU TIME ELAPSED COMMAND 338 327 0.0 00:00:00 3-01:18:35 cns 339 327 0.0 00:00:01 3-01:18:35 ens 340 327 0.0 00:00:21 3-01:18:35 dlog 341 327 0.1 00:05:35 3-01:18:35 ds 342 327 0.2 00:11:29 3-01:18:35 mgmtApp 343 327 0.0 00:00:04 3-01:18:35 fc2 344 327 0.
D A – Command Line Interface Quit Command Quit Command Closes the Telnet session. Authority None Syntax Notes quit, exit, or logout You can also enter Control-D to close the Telnet session. 59056-00 Rev.
D 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.
D A – Command Line Interface Reset Command Clears the alarm log. To save the alarm log before resetting, refer to the ”Set Log Command” on page A-45. To reset the switch with a power-on self test, refer to the ”Hardreset Command” on page A-16. To reset the switch without disrupting traffic, refer to the ”Hotreset Command” on page A-19. system Resets the system configuration settings to the factory default values. Refer to Table A-8 for system configuration default values.
D A – Command Line Interface Reset Command Table A-4.
D A – Command Line Interface Reset Command Table A-5.
D A – Command Line Interface Reset Command Table A-7. SNMP Configuration Defaults Parameter Default Trap [1-5] Port 162 Trap [1-5] Severity Warning Trap [1-5] Version 2 Trap [1-5] Enabled False ObjectID 1.3.6.14.1.1663.1.1.1.1.17 AuthFailureTrap False ProxyEnabled True Table A-8. System Configuration Defaults Parameter A-30 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.
D A – Command Line Interface Set Command Set Command Sets a variety of switch parameters. Authority Admin session for all keywords except Beacon and Pagebreak which are available without an Admin session. Syntax set alarm clear beacon [state] config [option] log [option] pagebreak [state] port [option] setup [option] switch [state] Keywords alarm clear Clears the alarm log. beacon [state] Enables or disables the flashing of the Logged-In LEDs according to [state].
A – Command Line Interface Set Command D port [option] Sets port state and speed for the specified port. The previous Set Config Port settings are restored after a switch reset or a reactivation of a switch configuration. Refer to the ”Set Port Command” on page A-48. setup [option] Changes SNMP and system configuration settings. Refer to the ”Set Setup Command” on page A-50. switch [state] Changes the administrative state for all ports on the switch to the state given by [state].
D A – Command Line Interface Set Config Command Set Config Command Sets switch, port, port threshold alarm, and zoning configuration parameters. The changes you make with this command are not retained when you reset or power cycle the switch unless you save them using the Config Save command. Refer to the ”Config Command” on page A-10.
D A – Command Line Interface Set Config Command Table A-9. Set Config Port Parameters (Continued) Parameter A-34 Description PortType Port type: 1Gbps/2Gbps Ports: GL, G, F, FL, Donor. The default is GL. 10 Gbps Ports: G SymbolicPortName Descriptive name for the port. The name can be up to 32 characters excluding #, semicolon (;), and comma (,). The default is Port n where n is the port number. ALFairness (1Gbps/2Gbps ports only) Arbitration loop fairness.
D A – Command Line Interface Set Config Command Table A-9. Set Config Port Parameters (Continued) Parameter 59056-00 Rev. B Description LCFEnable Link control frame preference routing. Enables (True) or disables (False) preferred routing of frames with R_CTL = 1100 (Class 2 responses). The default is False. Enabling LCFEnable will disable MFSEnable. MFSEnable Multi-Frame Sequence bundling. Prevents (True) or allows (False) the interleaving of frames in a sequence. The default is False.
D A – Command Line Interface Set Config Command switch Initiates an editing session in which to change switch configuration settings. The system displays each parameter one line at a time and prompts you for a value. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets. Table A-10 describes the Set Config Switch parameters. Table A-10.
D A – Command Line Interface Set Config Command Table A-10. Set Config Switch Parameters (Continued) Parameter Description E_D_TOV Error Detect Timeout Value. The number of milliseconds a port is to wait for errors to clear. The default is 2000. PrincipalPriority The priority used in the FC-SW-2 principal switch selection algorithm. 1 is high, 255 is low. The default is 254. ConfigDescription Switch configuration description.
D A – Command Line Interface Set Config Command Table A-11. Set Config Threshold Parameters Parameter Description Threshold Monitoring Enabled Master enable/disable parameter for all events. Enables (True) or disables (False) the generation of all enabled event alarms. The default is False. CRCErrorsMonitoringEnabled DecodeErrorsMonitoringEnabled ISLMonitoringEnabled LoginMonitoringEnabled LogoutMonitoringEnabled LOSMonitoringEnabled The event type enable/disable parameter.
D A – Command Line Interface Set Config Command Table A-12. Set Config Zoning Parameters Parameter 59056-00 Rev. B Description FC-SW-2 AutoSave Available only when the FC-SW-2 Compliant parameter is True, this parameter enables (True) or disables (False) the saving of changes to active zone set in the switch’s permanent memory. Refer to ”FC-SW-2 Compliant” on page A-37. The default is True.
D 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. 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.
D A – Command Line Interface Set Config Command 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.
D 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. 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.
D A – Command Line Interface Set Config Command RisingTrigger (decimal value, 1-1000) [200 ] FallingTrigger (decimal value, 0-1000) [0 ] SampleWindow (decimal value, 1-1000 sec) [10 ] ISLMonitoringEnabled (True / False) [True ] RisingTrigger (decimal value, 1-1000) [2 ] FallingTrigger (decimal value, 0-1000) [0 ] SampleWindow (decimal value, 1-1000 sec) [10 ] (True / False) [True ] RisingTrigger (decimal value, 1-1000) [5 ] FallingTrigger (decimal value, 0-1000) [1 ] S
D 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. 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.
D A – Command Line Interface Set Log Command Set Log Command Specifies the type of entries to be entered in the event log. Log entries are created for ports, components, and event severity levels.
A – Command Line Interface Set Log Command D Port Monitors all port events Switch Monitors switch management events. Zoning Monitors zoning conflict events. level [level] Specifies the severity level given by [level] to use in monitoring events for the specified components or ports. [level] can be one of the following values: Critical Monitors critical events. Warn Monitors warning events. Info Monitors informational events.
D A – Command Line Interface Set Log Command stop Stops logging of events. Notes To maintain optimal switch performance, do not set the Component keyword to All and the Level keyword to Info at the same time. 59056-00 Rev.
D A – Command Line Interface Set Port Command Set Port Command Sets port state and speed for the specified port temporarily until the next switch reset or new configuration activation. This command also clears port counters. Authority Admin session except for the Clear keyword. Syntax set port [port_number] bypass [alpa] clear enable speed [transmission_speed] state [state] Keywords [port_number] Specifies the port. Ports are numbered beginning with 0.
D A – Command Line Interface Set Port Command Diagnostics Prepares the port for testing. This prepares the port for testing and prevents the port from accepting a device login. Down Disables the port by removing power from the port lasers. 59056-00 Rev.
D A – Command Line Interface Set Setup Command Set Setup Command Changes SNMP and system configuration settings. The switch maintains one SNMP configuration and one system configuration. Authority Admin session Syntax set setup snmp system Keywords snmp Prompts you in a line-by-line fashion to change SNMP configuration settings. Table A-13 describes the SNMP fields. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets. Table A-13.
D A – Command Line Interface Set Setup Command Table A-13. SNMP Configuration Settings (Continued) Entry Description ReadCommunity Read community password that authorizes an SNMP agent to read information from the switch. This is a write-only field. The value on the switch and the SNMP management server must be the same. The read community password can be up to 32 characters excluding #, semicolon (;), and comma (,). The default is “public”.
D A – Command Line Interface Set Setup Command Table A-14. System Configuration Settings (Continued) Entry Examples Description Eth0NetworkMask Ethernet subnet mask address. Eth0GatewayAddress Ethernet IP address gateway. AdminTimeout Specifies the amount of time in minutes the switch waits before terminating an idle Admin session. Zero (0) disables the time out threshold. The default is 30, the maximum is 1440.
D A – Command Line Interface Set Setup Command press 'q' or 'Q' and the ENTER key to do so. Trap Severity Options --------------------unknown, emergency, alert, critical, error, warning, notify, info, debug, mark 59056-00 Rev. B SNMPEnabled (True / False) [True Contact (string, max=64 chars) [
D 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.
D A – Command Line Interface Show Command Show Command Displays fabric, switch, and port operational information. Authority None Syntax show about alarm broadcast chassis config [option] domains donor fabric fdmi [node_wwn] interface log [option] lsdb mem [count] ns [option] pagebreak perf [option] port [port_number] post log setup [option] steering [domain_id] support switch topology users version Keywords about Displays an introductory set of information about operational attributes of the switch.
D A – Command Line Interface Show Command config [option] Displays switch, port, and zoning configuration attributes. Refer to the ”Show Config Command” on page A-67. domains Displays list of each domain and its worldwide name in the fabric. donor Displays list of current donor configuration for all ports. fabric Displays list of each domain, symbolic name, worldwide name, node IP address, and port IP address.
D A – Command Line Interface Show Command [port_id] Displays name server information for the port given by [port_id]. [port_id] is a port Fibre Channel address. pagebreak Displays the current pagebreak setting. The pagebreak setting limits the display of information to 20 lines (On) or allows the continuous display of information without a break (Off). perf [option] Displays performance information for all ports. Refer to the ”Show Perf Command” on page A-74.
D A – Command Line Interface Show Command Table A-15. Show Port Parameters (Continued) Entry A-58 Description FReject Number of frames from devices that were rejected. InvalidCRC Invalid CRC detected. InvalidDestAddr Invalid destination address detected. LIP_AL_PD_ALPS Number of F7, AL_PS LIPs, or AL_PD (vendor specific) resets, performed. LIP_F7_AL_PS This LIP is used to reinitialize the loop.
D A – Command Line Interface Show Command Table A-15. Show Port Parameters (Continued) Entry Description TotalLIPsRecvd Number of loop initialization primitive frames received by this port. TotalLIPsXmitd Number of loop initialization primitive frames transmitted by this port. TotalLinkResets Total number of link reset primitives. TotalOfflineSeq Total number of Offline Sequences issued and received by this port. TotalRxFrames Total number of frames received by this port.
D A – Command Line Interface Show Command Ps Show (About, Alarm, Backtrace, Chassis, Config Port, Config Switch, Config Threshold, Dev, Dev Settings, Domains, Donor, Fabric, Log, Log Settings, Lsdb, Mem, Ns, Perf, Port, Setup Mfg, Setup Snmp, Setup System, Steering, Switch, Topology, Users) Uptime User Accounts Whoami Zoneset (Active, List) Zoning (History, Limits, List) switch Displays switch operational information. topology Displays all connected devices.
D A – Command Line Interface Show Command Domain 104 (0x68) WWN = 10:00:00:c0:dd:00:b8:b7 The following is an example of the Show Fabric command: SANbox #> show fabric Domain WWN Enet IP Addr FC IP Addr SymbolicName ------ --- ------------ ---------- ------------ 16 (0x10) 10:00:00:c0:dd:00:77:81 10.20.68.11 0.0.0.0 gui sb1 .11 17 (0x11) 10:00:00:c0:dd:00:6a:2d 10.20.68.12 0.0.0.0 sw12 18 (0x12) 10:00:00:c0:dd:00:c3:04 10.20.68.160 0.0.0.0 sw .
D A – Command Line Interface Show Command OSDeviceName qla2300(0) The following is an example of the Show NS (local domain) command: SANbox #> show ns Seq Domain Port Port No ID Type COS PortWWN NodeWWN ------ ---- --- ------- ------- ID --- -----1 19 (0x13) 1301e1 NL 3 21:00:00:20:37:73:13:69 20:00:00:20:37:73:13:69 2 19 (0x13) 1301e2 NL 3 21:00:00:20:37:73:12:9b 20:00:00:20:37:73:12:9b 3 19 (0x13) 1301e4 NL 3 21:00:00:20:37:73:05:26 20:00:00:20:37:73:05:26 4 19 (0x13) 130d00 N
D A – Command Line Interface Show Command RX bytes:415313 (405.5 Kb) TX bytes:716751 (699.9 Kb) Interrupt:11 Base address:0xfcc0 lo Link encap:Local Loopback inet addr:127.0.0.1 Mask:255.0.0.0 UP LOOPBACK RUNNING MTU:16436 Metric:1 RX packets:304 errors:0 dropped:0 overruns:0 frame:0 TX packets:304 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:0 RX bytes:20116 (19.6 Kb) TX bytes:20116 (19.
D A – Command Line Interface Show Command FReject 0 TotalRxWords 0 InvalidCRC 0 TotalTxFrames 0 InvalidDestAddr 0 TotalTxWords 0 LIP_AL_PD_AL_PS 0 TxLinkResets 54 LIP_F7_AL_PS 0 TxOfflineSeq 14 LIP_F7_F7 0 The following is an example of the Show Switch command: SANbox #> show switch Switch Information ------------------ A-64 SymbolicName sw .108 SwitchWWN 100000c0dd00bc56 SwitchType SANbox 5200 BootVersion V1.0.0.
D A – Command Line Interface Show Command The following is an example of the Show Topology command: SANbox #> show topology Unique ID Key ------------A = ALPA, Port D = Domain ID, P = Port ID Local Local Number Type PortWWN ------ ----- ------- Remote Remote Unique Type NodeWWN ID ------ ------- ------ 5 F 20:05:00:c0:dd:00:bd:ec N 20:00:00:00:c9:22:1e:93 010500 P 10 E 20:0a:00:c0:dd:00:bd:ec E 10:00:00:c0:dd:00:80:21 4(0x4) D The following is an example of the Show Topology co
D A – Command Line Interface Show Command IPAddress 0.0.0.0 The following is an example of the Show Version command: SANbox #> show version ***************************************************** * * * Command Line Interface SHell (CLISH) * * * ***************************************************** SystemDescription SANbox 5200 FC Switch Eth0NetworkAddress 10.20.11.
D A – Command Line Interface Show Config Command Show Config Command Displays switch, port, alarm threshold, and zoning for the current configuration. Authority None Syntax show config port [port_number] switch threshold zoning Keywords port [port_number] Displays configuration parameters for the port number given by [port_number]. Ports are numbered beginning with 0. If [port_number] is omitted, all ports are specified. switch Displays configuration parameters for the switch.
D A – Command Line Interface Show Config Command The following is an example of the Show Config Port command for a 10 Gbps port: SANbox #> show config port 16 Configuration Name: default ------------------Port Number: 16 -----------AdminState Online LinkSpeed 10Gb/s PortType G SymbolicName 10G-16 DeviceScanEnabled True ForceOfflineRSCN False LCFEnabled False MFSEnabled False MSEnabled True IOStreamGuard Disabled VIEnabled False PDISCPingEnabled True The following is an example of t
D A – Command Line Interface Show Config Command SANbox #> show config threshold Configuration Name: default -----------Threshold Configuration Information ----------------------------------ThresholdMonitoringEnabled False CRCErrorsMonitoringEnabled True RisingTrigger 25 FallingTrigger 1 SampleWindow 10 DecodeErrorsMonitoringEnabled True 1 RisingTrigger 25 FallingTrigger 0 SampleWindow 10 ISLMonitoringEnabled True RisingTrigger 2 FallingTrigger 0 SampleWindow 10 LoginMonitoringEn
D 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 -------------------------------- A-70 FC-SW-2 AutoSave True Default Visibility All 59056-00 Rev.
D A – Command Line Interface Show Log Command Show Log Command Displays the contents of the log or the parameters used to create entries in the log. The log contains a maximum of 200 entries. When the log reaches its entry capacity, subsequent entries overwrite the existing entries, beginning with the oldest. Authority None Syntax show log component level options port settings Keywords component Displays the components currently being monitored for events.
D A – Command Line Interface Show Log Command Critical Monitors critical events. Warn Monitors warning events. Info Monitors informational events. None Monitors none of the severity levels. options Displays the options used to set the component and severity level attributes. port Displays the ports being monitored for events. If an event occurs which is of the defined level and on a defined component, but not on a defined port, no entry is made in the log.
D A – Command Line Interface Show Log Command The following is an example of the Show Log Options command: SANbox #> show log options Allowed options for log ----------------------component level All, None, NameServer, MgmtServer, Zoning, Switch, Chassis, Blade, Port, Eport, Snmp, Other,CimServer Critical,Warn,Info,None 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
A – Command Line Interface Show Perf Command D 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.
D A – Command Line Interface Show Perf Command errors [port_number] Displays continuous error counts for the port group (0–15 or 16–19) that includes [port_number]. If you omit [port_number], ports 0–15 are displayed. Type “q” and press the Enter key to stop the display.
D A – Command Line Interface Show Perf Command 0 0 0 0 0 0 0 0 136M 58K 0 0 0 0 8K 136M 0 0 0 0 0 0 0 0 136M 58K 0 0 0 0 7K 136M q A-76 59056-00 Rev.
D A – Command Line Interface Show Setup Command Show Setup Command Displays the current SNMP and system settings. Authority None Syntax show setup mfg snmp system Keywords mfg Displays manufacturing information about the switch. snmp Displays the current SNMP settings. system Displays the current system settings.
D A – Command Line Interface Show Setup Command Trap1Enabled False Trap2Address 0.0.0.0 Trap2Port 162 Trap2Severity warning Trap2Version 2 Trap2Enabled False Trap3Address 0.0.0.0 Trap3Port 162 Trap3Severity warning Trap3Version 2 Trap3Enabled False Trap4Address 0.0.0.0 Trap4Port 162 Trap4Severity warning Trap4Version 2 Trap4Enabled False Trap5Address 0.0.0.0 Trap5Port 162 Trap5Severity warning Trap5Version 2 Trap5Enabled False ObjectID 1.3.6.1.4.1.1663.1.1.1.1.
D A – Command Line Interface Shutdown Command Shutdown Command Terminates all data transfers on the switch at convenient points and closes the Telnet session. Always power cycle the switch after entering this command. Authority Admin session Syntax Notes shutdown Always use this command to perform an orderly shut down before removing power from the switch. When the shutdown is complete, the Heartbeat LED is extinguished. 59056-00 Rev.
D 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-31 for information about changing the port administrative state. While the test is running, the remaining ports on the switch remain fully operational.
D A – Command Line Interface Test Command 1. To start an admin session, enter the following command and press the Enter key. admin start 2. Place the port in Diagnostics mode, enter the following command (x = port number) and press the Enter key. set port x state diagnostics 3. Choose the type of port loopback test to run: To run an internal loopback test, enter the following: test port x internal To run an external loopback test, enter the following command.
D A – Command Line Interface Test Command 3. A series of test parameters are displayed on the screen. Press the Enter key to accept each default parameter value, or type a new value for each parameter and press the Enter key. The TestLength parameter is the number of frames sent, the FrameSize (256 byte maximum in some cases) parameter is the number of bytes in each frame, and the DataPattern parameter is the pattern in the payload.
D 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 Examples uptime The following is an example of the Uptime command: SANbox #> uptime Elapsed up time : 0 day(s), 2 hour(s), 28 min(s), 44 sec(s) Reason last reset: NormalReset 59056-00 Rev.
D 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 add delete [account_name] edit list Keywords accounts Displays all user accounts that exist on the switch. This keyword is available to all account names without an Admin session. add Add a user account to the switch.
D Examples A – Command Line Interface User Command The following is an example of the User Accounts command: SANbox (admin) #> user accounts Current list of user accounts ----------------------------images (admin authority = False, never expires) admin (admin authority = True , never expires) chuckca (admin authority = False, expires in < 50 days) gregj (admin authority = True , expires in < 100 days) fred (admin authority = True , never expires) The following is an example of the User Add comma
D A – Command Line Interface User 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) #> user list User ---- A-86 Ethernet Addr-Port ------------------ Logged in Since --------------- admin@OB-session1 10.20.68.108-1031 day month date time year admin@OB-session2 10.20.68.
D 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 Examples whoami The following is an example of the Whoami command: SANbox #> whoami User name : admin@session2 Switch name : SANbox Switch domain ID: 21 (0x15) 59056-00 Rev.
D 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-94 for information about starting a Zoning Edit session. The List, Members, and Zonesets keywords are available without an Admin session.
D A – Command Line Interface Zone Command list Displays a list of all zones and the zone sets of which they are components. This keyword does not require an Admin session. members [zone] Displays all members of the zone given by [zone]. This keyword does not require an Admin session. remove [zone] [member_list] Removes the ports/devices given by [member_list] from the zone given by [zone]. Use a to delimit aliases and ports/devices in [member_list].
D 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 The following is an example of the Zone Members command: SANbox #> zone members wwn_b0241f Current List of Members for Zone: wwn_b0241f ----------------
D 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 59056-00 Rev.
A – Command Line Interface Zoneset Command D 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-94 for information about starting a Zoning Edit session. The Active, List, and Zones keywords are available without an Admin session. You must close the Zoning Edit session before using the Activate and Deactivate keywords.
D A – Command Line Interface Zoneset Command list Displays a list of all zone sets. This keyword does not require an Admin session. remove [zone_set] [zone_list] Removes a list of zones given by [zone_list] from the zone set given by [zone_set]. Use a to delimit zone names in [zone_list]. If [zone_set] is the active zone set, the zone will not be removed until the zone set has been deactivated.
A – Command Line Interface Zoning Command D 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-88 and the ”Zoneset Command” on page A-92. Authority Admin session except for the Active, History, Limits, and List keywords. Syntax zoning active cancel clear edit history limits list restore save Keywords active Displays information for the active zone set including component zones and zone members.
D A – Command Line Interface Zoning Command limits Displays the number of zone sets, zones, aliases, members per zone, members per alias, and total members in the zoning database. This keyword also displays the switch zoning database limits, excluding the active zone set, which are described in Table A-16. This keyword does not require an Admin session. Table A-16.
D A – Command Line Interface Zoning Command SANbox (admin-zoning) #> . . SANbox (admin-zoning) #> zoning cancel Zoning edit mode will be canceled.
D A – Command Line Interface Zoning Command SANbox #> zoning list Active ZoneSet Information ZoneSet Zone ZoneMember -------------------------------wwn wwn_b0241f 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 21:00:00:e0:8b:02:41:2f wwn_23bd31 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 10:00:00:00:c9:23:bd:31 wwn_221416 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 10:00:00:00:c9:22:14:16 wwn_2215c3 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 10:00:00:00:c9:22:15:c3 Configured Zoning Infor
D A – Command Line Interface Zoning Command wwn_221416 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 10:00:00:00:c9:22:14:16 wwn_2215c3 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 10:00:00:00:c9:22:15: A-98 59056-00 Rev.
Appendix B Graphing Port Performance SANsurfer Fabric View application displays port performance using graphs. SANsurfer Fabric View plots data communication rates and total errors for selected ports as shown in Figure B-1. When graphing data communication rates, you can choose either frames/second or KB/second.
D B – Graphing Port Performance Starting SANsurfer Fabric View Save and Open SANsurfer Fabric View Default Fabric View Files Change the SANsurfer Fabric View Default Fabric File Password Set SANsurfer Fabric View preferences Set the polling frequency Display graphs Print graphs Rescale a selected graph Save graph statistics to a file B.
D B – Graphing Port Performance Saving and Opening Fabric View Files In the Save Default Fabric View File dialog, enter an encryption key in the Default Fabric File Encryption Key field. Re-enter the encryption key in the Re-enter Encryption Key to Confirm field. Click the OK button to save the current set of SANsurfer Fabric View fabrics to the default fabric view file in the working directory.
D B – Graphing Port Performance Changing the Default Fabric View File Encryption Key 2. Enter a name for the fabric file or click the Browse button to select an existing file. Files are saved in the working directory. 3. Enter a password. When you attempt to open this fabric file, you will be prompted for this password. If you leave the File Password field blank, no password is required. To open a fabric view file, do the following: 1.
D B – Graphing Port Performance Setting the Polling Frequency Figure B-4. Preferences – SANsurfer Fabric View B.6 Setting the Polling Frequency Fabric View updates the graphs once per second by default. To change this polling frequency, do the following: 1. Open the Graph menu, and select Set Polling Frequency to open the Set Graph Polling Frequency dialog. 2. Enter the new polling interval in seconds [1–60]. Fabric View will update the graphs once during the interval.
D B – Graphing Port Performance Arranging Graphs in the Display To remove a graph, click the graph Remove button. To remove all graphs, open the Window menu and select Close All. To remove a fabric and its graphs, select the fabric in the fabric tree, then select Remove Fabric from the Fabric menu. You can also right click on a fabric and select Remove Fabric for the popup menu.
D B – Graphing Port Performance Customizing Graphs B.9 Customizing Graphs You can customize the graph polling frequency, what is plotted in the graphs, and the graph color scheme. To set the polling frequency for all graphs, open the Graph menu and select Set Polling Frequency.... Enter an interval in seconds (0–60) in the dialog box and click the OK button. To choose what is to be plotted, open the Graph menu and select Modify Graph Options....
D B – Graphing Port Performance Customizing Graphs Total frames transmitted and received (Total Frames) Total frames transmitted (Total Tx Frames) Total frames received (Total Rx Frames) In addition to these, you can also plot total errors by selecting the Total Errors check box. 3. Display or hide the unit grid. Select the Display Grid on Graph check box to display the unit grid. 4. Choose the color scheme for the graph.
D B – Graphing Port Performance Printing Graphs B.10 Printing Graphs To print a graph, select a graph, then open the File menu and select Print Graph Window. You can also right click on a graph and select Print Graph Window from the popup menu. B.11 Rescaling a Selected Graph The Rescale Selected Graph option auto-scales downward and re-positions the data within a graphic window to display all new data captured by the graph. To rescale a selected graph, do the following: 1. Select a displayed graph.
B – Graphing Port Performance Saving Graph Statistics to a File D Notes B-10 59056-00 Rev.
Appendix C Messages This appendix lists the SANbox Manager messages by task, dialog, or display. To find a message and what to do about it, consider what task you are performing, and refer to the corresponding subsection.
D C – Messages Add a Fabric C.2 Add a Fabric Table C-2. Add a Fabric Messages Message C-2 User Action Fabric fabricname already exists! Or Fabric name already in use. Specify a name for the fabric that is not already assigned to an existing fabric. Invalid IP Address Verify that the IP address specified is syntactically correctly. The entry switch is of a type that is not supported. The switch hardware or firmware version of the switch at the specified IP address is not supported.
D C – Messages Network Properties Dialog C.3 Network Properties Dialog Table C-3. Network Properties Dialog Messages Message 59056-00 Rev. B User Action Attempt to change snmp community strings failed. Or Attempt to change syslog configuration failed. Verify that the data is valid, that the user has permissions to modify the configuration on the switch, that the switch is reachable in the fabric, and that the fabric is reachable from the user’s workstation, then retry the configuration change.
D C – Messages Switch Properties Dialog C.4 Switch Properties Dialog Table C-4. Switch Properties Dialog Messages C-4 Message User Action Attempt to change chassis name failed Or Attempt to set ISL security failed. Or Attempt to set in-band management failed. Or Attempt to change domain ID lock failed.
D C – Messages Switch Properties Dialog Table C-4. Switch Properties Dialog Messages (Continued) 59056-00 Rev. B Message User Action If you set this in-band switch offline you will need an ethernet connection to the switch to put it back online. Do you want to set switch offline? Or If you set this in-band switch in diagnostics mode you will need an ethernet connection to the switch to put it back online.
D C – Messages Switch Properties Dialog Table C-4. Switch Properties Dialog Messages (Continued) C-6 Message User Action Received error in attempting to edit switch configuration. Or Received error in attempting to save switch configuration. Or Received error in attempting to activate switch configuration.
D C – Messages Port Properties Dialog C.5 Port Properties Dialog Table C-5. Port Properties Dialog Messages 59056-00 Rev. B Message User Action Invalid value entered for interop credits. Or Failed to set I/O stream guard change. Or Failed to set new interop credits. Or Request to save and activate config failed. Or Received error in attempting to edit switch configuration. Or Received error in attempting to save switch configuration. Or Received error in attempting to activate switch configuration.
D C – Messages Port Properties Dialog Table C-5. Port Properties Dialog Messages (Continued) C-8 Message User Action Unable to apply changes. Failed to obtain admin privileges. Verify that another user is not currently modifying the switch configuration, using either the management application, or a Telnet login, or any other application, and then retry the operation. Unable to confirm that port changes were successful. The application did not receive a required response from the switch.
D C – Messages Faceplate Display C.6 Faceplate Display Table C-6. Faceplate Display Messages Message 59056-00 Rev. B User Action Failed to clear the trap log. Verify that the user has permissions to modify the configuration on the switch, that the switch is reachable in the fabric, and that the fabric is reachable from the user’s workstation, then retry the configuration change. Necessary information is missing for this switch. Firmware version on this switch is unsupported.
D C – Messages Faceplate Display Table C-6. Faceplate Display Messages (Continued) Message C-10 User Action Request for switch reset failed because admin access was not available. Verify that another user is not currently modifying the switch configuration, using either the management application, or a telnet login, or any application, and then retry the operation. Reset will complete shortly. There will be a brief loss of connectivity with switch. Wait for the switch to become reachable again.
D C – Messages Faceplate Display Table C-6. Faceplate Display Messages (Continued) Message 59056-00 Rev. B User Action The zoning information you are about to edit is incomplete. If you apply changes you will possibly lose zoning information. The application has not been able to completely read the current zoning database from the switch. If the user edits the incomplete database information and applies the changes, then any information which has not been read from the switch will be lost.
D C – Messages Firmware Fallback Dialog C.7 Firmware Fallback Dialog Table C-7. Firmware Fallback Dialog Messages Message User Action Attempt to revert to fallback firmware failed The switch was unable to fall back to the previous firmware. Correct the problem specified and retry the operation. Request to get admin privileges failed.
D C – Messages Load Firmware Dialog Table C-8. Load Firmware Dialog Messages (Continued) Message 59056-00 Rev. B User Action Firmware upload complete. The switch must be reset to activate new firmware. Reset now? The new firmware will not be executed until the switch is reset. Resetting a switch in the fabric will cause the servers and storage systems attached to the fabric to lose communications until the switch reset is complete and the fabric has reinitialized.
D C – Messages Port Loopback Test Dialog C.9 Port Loopback Test Dialog Table C-9. Port Loopback Test Dialog Messages C-14 Message User Action Attempt to put port in diagnostic state has failed. Unable to continue with port test. Verify that the user has permissions to modify the configuration on the switch, that the switch is reachable in the fabric, and that the fabric is reachable from the user’s workstation, then retry the configuration change.
D C – Messages Port Loopback Test Dialog Table C-9. Port Loopback Test Dialog Messages (Continued) 59056-00 Rev. B Message User Action Switch is currently unreachable. Unable to accurately report status of port test. The application lost communications with the switch while the switch was running the loopback tests, and could not determine whether the tests completed. If the problem was temporary, restart the loopback tests. The port selected for online port test must be online with active login.
D C – Messages Extended Credits Wizard C.10 Extended Credits Wizard Table C-10. Extended Credits Wizard Messages Message User Action Request for admin failed. Verify that another user is not currently modifying the switch configuration, using either the management application, or a telnet login, or any application, and then retry the operation.
D C – Messages Zoning Dialog Table C-11. Zoning Dialog Messages (Continued) Message 59056-00 Rev. B User Action Error saving zoning Verify that the specified zoning configuration file exists on a file system that is reachable, and that the user has permissions to write the file. Failed to obtain admin privileges Verify that another user is not currently modifying the switch configuration, using either the management application, or a telnet login, or any application, and then retry the operation.
D C – Messages Zoning Dialog Table C-11. Zoning Dialog Messages (Continued) C-18 Message User Action The zone set you attempting to activate contains port based zoning and there are switches in the fabric that might not support this type of zoning. Some E_Ports may isolate. Do you wish to continue? Not all switch vendors support port-based zoning. Consult the manual for these vendors’ switches to determine whether to apply this zoning configuration to the fabric.
D C – Messages Restore Configuration Dialog C.12 Restore Configuration Dialog Table C-12. Restore Configuration Dialog Messages Message User Action Failed parsing filename Verify that the file specified is a valid archive file, and retry the operation. Possibly failed check switch! The application lost communications with the switch while restoring the archived configuration, and could not determine whether the operation completed. If the problem was temporary, retry the operation.
D C – Messages Trap Configuration Dialog C.14 Trap Configuration Dialog Table C-14. Trap Configuration Dialog Messages Message C-20 User Action Invalid rising threshold Or Invalid falling threshold Or Invalid sample interval. Verify that the information is correct and then retry. You must wait for trap information to be read first. Or You must wait for alarm threshold information to be read first.
Glossary Access Control List Zone Access Control List zoning divides the fabric for purposes of controlling discovery and inbound traffic. Arbitrated Loop A Fibre Channel topology where ports use arbitration to establish a point-to-point circuit. Active Zone Set The zone set that defines the current zoning for the fabric. Arbitrated Loop Physical Address (AL_PA) A unique one-byte value assigned during loop initialization to each NL_Port on a loop.
D SANbox 5200 Switch Management User’s Guide Class 3 Service A service which multiplexes frames at frame boundaries to or from one or more N_Ports without acknowledgment. Fabric View File A file containing a set of fabrics that were opened and saved during a previous SANbox Manager session. Configured Zone Sets The zone sets stored on a switch excluding the active zone set. Fan Fail LED An LED that indicates that a cooling fan in the switch is operating below standard.
D SANbox 5200 Switch Management User’s Guide Initiator The device that initiates a data exchange with a target device. Management Workstation PC workstation that manages the fabric through the fabric management switch. In-Order-Delivery A feature that requires that frames be received in the same order in which they were sent. Mesh Topology A fabric in which each chassis has at least one port directly connected to each other chassis in the fabric.
D SANbox 5200 Switch Management User’s Guide Principal Switch The switch in the fabric that manages domain ID assignments. Zone A set of ports or devices grouped together to control the exchange of information. SANbox Manager Switch management application. Zone Set A set of zones grouped together. The active zone set defines the zoning for a fabric. SFP Small Form-Factor Pluggable.
Index A access control list zone 3-15, 3-28 account name 3-3, A-1, A-87 display A-87 active firmware 4-33 active zone set 3-13, 3-16, 4-23 Active Zoneset data window 3-13 Admin account name A-6 authority 3-1, A-6 admin authority 3-1 Admin command A-7 administrative state configured 4-21, 5-11 current 4-21, 5-11 port 5-11, A-48 switch 4-21, A-32 alarm configuration 4-14, A-37 configuration display A-67 log A-31, A-55 alias add members 3-29, A-8 copy A-8 create 3-29, A-8 delete A-8 delete members A-9 descript
D SANbox 5200 Switch Management User’s Guide Configured Zonesets 4-13 description 2-24, 2-27, 2-30 Name Server 4-7 port information 5-7 port statistics 5-4 switch 4-10 database fabric 3-3 zoning 3-20 date 4-17 Date command A-13 Decode error 4-15 default configuration 4-31 user account 3-1 visibility 3-18, 3-24 zoning 3-18 default fabric view file auto save 2-14 SANbox Manager 2-14 Detailed FDMI Display Dialog 4-9 device scan 5-14 device scan 5-14 disk space 2-1 distance 5-14, 5-15 domain ID description 4-
D SANbox 5200 Switch Management User’s Guide auto save B-4 open 3-4 password B-2 save 3-4 faceplate display data window 2-30 description 2-17, 2-28 open 2-27 factory defaults 4-31, A-26 Fallback command A-14 FC-4 descriptor 5-14 FC-SW-2 compliance 4-23 Feature command A-15 firmware activate pending 4-35 active 4-33 change pending 4-35 fallback 4-35 image file 4-34, A-20 inactive 4-33 install with SANbox Manager 4-34 list image files A-20 non-disruptive activation 4-34, A-19 pending 4-33, A-14 remove image
D SANbox 5200 Switch Management User’s Guide M management workstation 2-1 manufacturer information A-77 media status 5-4 memory activity A-56 workstation 2-1 menu structure 2-18 messages C-1 N name server display A-56 export 4-16 zone 3-15 Name Server data window 4-7 network configuration reset A-27 discovery 4-26 interfaces A-56 properties 4-25 node-to-node test 5-17 non-disruptive activation 4-35, A-19 O online help 2-16 test 5-17 online test A-80 operating systems 2-1 orphan zone set 3-16 P page bre
D SANbox 5200 Switch Management User’s Guide R read community 4-27 receive buffer 5-13 refresh 3-7, 4-7 Registered State Control Notification 5-14 remote logging 4-28 reset with POST 4-19 without POST 4-19 Reset command A-26 Resource Allocation Timeout 4-24 restore configuration 4-29 Reverse Address Resolution Protocol 4-26 S SANbox Manager default fabric file 2-6, 2-11 exit 2-6, 2-11 preferences 2-14, B-4 uninstall 2-7, 2-12 user interface 2-17 version 2-16 SANbox Manager installation Linux 2-3, 2-8 Sol
D SANbox 5200 Switch Management User’s Guide temperature threshold 4-17 Test command A-80 testing ports 5-16 time 4-17, A-13 timeout values 4-24 tool bar standard 2-22 zoning 3-21 topology display arrange icons 2-26 data windows 2-27 description 2-17 usage 2-25 transceiver status 5-4 transmission speed 5-11 trap authentication 4-27 community 4-27 configuration 4-28 SNMP version 4-28 U upgrade A-15 Uptime command A-83 user account A-1 authentication A-52 logged in A-60 user account create 4-3 default 4-2
D 1 – Index orphan 3-16 remove 3-24 rename 3-27, A-93 tree 3-21 Zoneset command A-92 zoning configuration 3-17, A-38 configuration display A-67 database 3-16, 3-20, 4-23, A-27 default 3-18 edit A-94 history A-94 limits A-95 list definitions A-95 remove all 3-25 revert changes A-95 save edits A-95 Zoning command A-94 59056-00 Rev.
1 – Index D Notes 1-8 59056-00 Rev.
