QLogic, SANbox, SANsurfer, SANblade, SANsurfer Switch Manager, and SANsurfer Management Suite are trademarks or registered trademarks of QLogic Corporation. Java and Solaris are registered trademarks of Sun Microsystems, Inc. Gnome is a trademark of the GNOME Foundation Corporation. Linux is a registered trademark of Linus Torvalds.
Page 4
SANbox 5602 Switch Management User’s Guide 2.11.6 Working Status Indicator... 2-24 2.12 Using the Topology Display ... 2-25 2.12.1 Switch and Link Status ... 2-25 2.12.2 Working with Switches and Links ... 2-26 2.12.2.1 Selecting Switches and Links ... 2-26 2.12.2.2...
Page 5
Exporting Nicknames to a File ... 3-37 3.6.3.5 Importing a Nicknames File ... 3-38 Zoning a Fabric ... 3-38 3.7.1 Zoning Concepts ... 3-38 3.7.1.1 Zones... 3-39 3.7.1.2 Aliases ... 3-40 3.7.1.3 Zone Sets ... 3-40 59097-01 A SANbox 5602 Switch Management User’s Guide Page v...
Page 6
SANbox 5602 Switch Management User’s Guide 3.7.1.4 Zoning Database ... 3-41 3.7.2 Using the Zoning Wizard ... 3-42 3.7.3 Managing the Zoning Database ... 3-42 3.7.3.1 Editing the Zoning Database ... 3-43 3.7.3.2 Configuring the Zoning Database ... 3-46 3.7.3.3 Saving the Zoning Database to a File...
Page 7
Restoring the Factory Default Configuration ... 4-39 4.12 Downloading a Support File ... 4-41 4.13 Upgrading the Switch Using License Keys... 4-41 4.14 Installing Firmware ... 4-42 4.14.1 Displaying Hardware Status ... 4-44 59097-01 A SANbox 5602 Switch Management User’s Guide Page vii...
Page 8
SANbox 5602 Switch Management User’s Guide Section 5 Managing Ports Displaying Port Information ... 5-1 5.1.1 Monitoring Port Status ... 5-2 5.1.1.1 Displaying Port Types ... 5-2 5.1.1.2 Displaying Port Operational States ... 5-3 5.1.1.3 Displaying Port Speeds ... 5-3 5.1.1.4...
Page 9
Set Setup Command ...A-81 Show Command ...A-91 Show Config Command...A-106 Show Log Command ...A-109 Show Perf Command ... A-112 Show Setup Command... A-114 Shutdown Command ... A-118 Test Command ... A-119 59097-01 A SANbox 5602 Switch Management User’s Guide Page ix...
Page 11
IP Configuration Parameters... 4-28 SNMP Configuration Parameters... 4-31 SNMP Trap Configuration Parameters ... 4-32 Factory Default Configuration Settings ... 4-39 Port Types... 5-2 Port Operational States... 5-3 Port Speeds ... 5-3 59097-01 A SANbox 5602 Switch Management Tables User’s Guide Page Page xi...
Page 12
SANbox 5602 Switch Management User’s Guide Port Transceiver Media View ... 5-4 Port Statistics Data Window Entries... 5-5 Port Information Data Window Entries ... 5-8 Port Administrative States... 5-11 Port Speeds ... 5-12 Port Types... 5-13 Command-Line Completion ...A-6 Commands Listed by Authority Level...A-7 CIM Listener Configuration Parameters...A-12...
This manual describes the switch management tools which include the SANsurfer Switch Manager application (version 5.00) and the Command Line Interface (CLI) for the SANbox 5602 Fibre Channel switch (firmware version 5.0). The SANbox 5602 switch is a 20-port non-blocking Fibre Channel switch. This manual defines the features, components, and performance characteristics of the SANbox 5602 switch.
1 – Introduction Technical Support Redistributions of source code must retain the above copyright notice, this list of conditions, and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions, and the disclaimer that follows these conditions in the documentation and/or other materials provided with the distribution.
1.4.2 Training QLogic offers certification training for the technical professional for both the SANblade™ HBAs and the SANbox 5602 switches. From the training link at www.qlogic.com, you may choose Electronic-Based Training or schedule an intensive "hands-on" Certification course. Technical Certification courses include installation, maintenance and troubleshooting QLogic SAN products.
Page 16
1 – Introduction Technical Support Notes 59097-01 A...
Using SANsurfer Switch Manager This section describes how to use the SANsurfer Switch Manager application and its menus. The following topics are covered: Workstation Requirements Installing the Management Application Starting SANsurfer Switch Manager Exiting SANsurfer Switch Manager Uninstalling SANsurfer Switch Manager Changing the Encryption Key for the Default Fabric View File Saving and Opening Fabric View Files Setting SANsurfer Switch Manager Preferences...
2 – Using SANsurfer Switch Manager Workstation Requirements Workstation Requirements The requirements for fabric management workstations running SANsurfer Switch Manager are described in Operating System Memory Disk Space Processor Hardware Internet Browser Telnet workstations require an RJ-45 Ethernet port or an RS-232 serial port and an operating system with a Telnet client.
2.2.1 SANsurfer Switch Manager You can install SANsurfer Switch Manager on a Windows, Linux, Solaris, or Mac OS X workstation. To install the SANsurfer Switch Manager application from the SANsurfer Switch Manager Installation Disk, do the following: For a Windows platform: Close all programs currently running, and insert the SANsurfer Switch Manager Installation Disk into the management workstation CD-ROM drive.
Management Suite start page in your default browser. On the SANsurfer Management Suite start page, click the SANbox Switch Software button. On the SANbox Switch Software page, scroll to the SANbox 5602 Series area. In the Operating System column, click the Win NT/2000 link.
Page 21
You can run the installation file from the CD-ROM or download the installation file to your hard drive. Choose one of the following: Open the installation file from the CD-ROM and follow the SANsurfer Switch Manager installation instructions. Specify a location in which to save the sansurfer_windows_install.exe file, and click the Save button.
The SANsurfer Management Suite start page opens in your browser. On the SANsurfer Management Suite start page, click the SANbox Switch Software button. On the SANbox Switch Software page, scroll to the SANbox 5602 Series area. In the Operating System column, click the Linux link.
Page 23
To ensure that you are using the most recent version of SANsurfer Switch Manager, visit the QLogic support web page and go to Manuals. Select your switch model from the pull-down menu. Locate the description for SANsurfer Switch Manager for Linux under "Management Software".
SANsurfer Management Suite start page in your default browser. On the SANsurfer Management Suite start page, click the SANbox Switch Software button. On the SANbox Switch Software page, scroll to the SANbox 5602 Series area. In the Operating System column, click the Solaris SPARC link.
Page 25
If the release version number (5.00.xx) is greater than what is currently installed on your workstation, down load the new version. Otherwise, no upgrade is needed. Open the tar file and save the SANsurferSwitchMgr_QLGCsol_5.00.xx.bin file in a folder and make the file executable.
2 – Using SANsurfer Switch Manager Starting SANsurfer Switch Manager Starting SANsurfer Switch Manager You can start SANsurfer Switch Manager as a standalone application or from SANsurfer Management Suite. Note: After the switch is operational, you can also open the SANsurfer Switch Manager web applet, by entering the switch IP address in an internet browser.
In the Initial Start dialog, click the Open Configuration Wizard button. When you power up the switch, the Configuration Wizard will recognize the switch and lead you through the configuration process. The application opens with the Initial Start dialog shown in not to see this dialog, check the Don’t show this dialog again box.
2 – Using SANsurfer Switch Manager Exiting SANsurfer Switch Manager Click the Start Application Without Specifying a Fabric radio button to open the SANsurfer Switch Manager window shown in Click the Open Configuration Wizard radio button to open the Config Wizard to configure a switch, add a new switch, replace/restore a switch, or recover or edit an IP configuration of an existing switch.
The encryption key is used to encrypt the sensitive data in the default fabric view file. Refer to ”Changing the Encryption Key for the Default Fabric View File” on page 2-15 for information about changing this encryption key. If an encryption key has been defined and the View File Auto Save and Load preferences settings are set to Enable, the current fabric view is automatically saved to your default fabric view file upon exit future SANsurfer Switch Manager sessions.
2 – Using SANsurfer Switch Manager Uninstalling SANsurfer Switch Manager 2.5.1 SMS Uninstall A program to uninstall SANsurfer Management Suite was included as part of the SANsurfer Management Suite installation process. Use this method only if you installed SANsurfer Switch Manager as part of SANsurfer Management Suite. The UninstallData folder in the installation directory contains the uninstall program, SANsurferUninstaller.
2.5.2 Standalone Uninstall A program to uninstall SANsurfer Switch Manager was included as part of the installation process. Use this method only if you installed SANsurfer Switch Manager as a standalone program. The UninstallerData folder in the Install directory contains the uninstall program, Uninstall_SANsurfer_Switch_Manager. Also, a shortcut/link to the uninstall program was installed in the installation directory during the SANsurfer Switch Manager installation process.
2 – Using SANsurfer Switch Manager Saving and Opening Fabric View Files Saving and Opening Fabric View Files A fabric view file is one or more fabrics saved to a file. In addition to the SANsurfer Switch Manager default fabric view file, you can save and open your own fabric view files.
Enable (default) or disable the Event Browser. Refer to Event Browser” on page Preferences dialog as shown in Manager is started, all events will be displayed. If the Event Browser is disabled when SANsurfer Switch Manager is started and later enabled, only those events from the time the Event Browser was enabled and forward will be displayed.
2 – Using SANsurfer Switch Manager Using Online Help Using Online Help Online help is available for the SANsurfer Switch Manager application and its functions. The two ways to open the online help file are: open the Help menu and select Help Topics, or click the Help button in the tool bar.
2.11 SANsurfer Switch Manager User Interface The SANsurfer Switch Manager application uses two basic displays to manage the fabric and individual switches: the topology display and the faceplate display. The topology display shows all switches that are able to communicate and all connections between switches.
2 – Using SANsurfer Switch Manager SANsurfer Switch Manager User Interface 2.11.1 Menu Bars The menus and the options offered in them vary depending on the display. For example, the Port menu and many of the Switch menu selections are available only in the faceplate display.
2.11.1.2 Faceplate Display Menu The menu options available in the faceplate display are shown in Note: The Stack menu is displayed when the stack faceplate is displayed. The Switch menu is displayed when a a switch faceplate is displayed. Figure 2-8. Faceplate Display Menu The keyboard shortcut keys vary by display type: topology display and faceplate display.
2 – Using SANsurfer Switch Manager SANsurfer Switch Manager User Interface 2.11.2 Tool Bar The tool bar consists of a row of graphical buttons that you can use to access SANsurfer Switch Manager functions as shown in 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.
2.11.3 Fabric Tree The fabric tree lists the managed fabrics and their switches as shown in Figure 2-9. The window width can be adjusted by clicking and dragging the moveable window border. An entry handle located to the left of an entry in the tree indicates that the entry can be expanded or collapsed.
2 – Using SANsurfer Switch Manager SANsurfer Switch Manager User Interface 2.11.4 Graphic Window The graphic window, as shown in fabrics and switches such as the fabric topology and the switch faceplate. The window height can be adjusted by clicking and dragging the window border that it shares with the data window.
2.12 Using the Topology Display The topology display shown in fabric and displays its topology. Switches and inter-switch links (ISLs) appear in the graphic window and use color to indicate status. Consider the following topology display features: Switch and Link Status Working with Switches and Links Topology Data Windows Figure 2-10.
2 – Using SANsurfer Switch Manager Using the Topology Display 2.12.2 Working with Switches and Links Switch and link icons are selectable and moveable, and serve as access points for other displays and menus. You select switches and links to display information about them, modify their configuration, or delete them from the display.
2.12.2.3 Opening the Faceplate and Topology Display Popup Menus The topology display shows all switches that are able to communicate and all connections between switches. The faceplate display shows the front of a single switch and its ports. Menu options vary with each type of popup menu. To open the fabric popup menu in the topology display, right-click the graphic window background.
2 – Using SANsurfer Switch Manager Using the Faceplate Display 2.13 Using the Faceplate Display The faceplate display shown in operational state, and port status. Consider the following functional elements of the faceplate display: Port Views and Status Working with Ports Faceplate Data Windows Figure 2-11.
2.13.2 Working with Ports Ports are selectable and serve as access points for other displays and menus. You select ports to display information about them in the data window or to modify them. Context-sensitive popup menus are displayed when you right-click the faceplate image or on a port icon in the faceplate display.
2 – Using SANsurfer Switch Manager Using the Faceplate Display 2.13.3 Faceplate Data Windows The faceplate display provides the following data windows corresponding to the data window tabs: Devices – displays information about devices (hosts and storage targets) connected to the switch. Switch –...
This section describes the following tasks that manage fabrics: RADIUS Servers Securing a Fabric Tracking Fabric Firmware and Software Versions Managing the Fabric Database Displaying Fabric Information Working with Device Information and Nicknames Zoning a Fabric RADIUS Servers Remote Authentication Dial In User Service (RADIUS) provides a method to centralize the management of authentication passwords in larger networks.
3 – Managing Fabrics RADIUS Servers 3.1.1 Adding a RADIUS Server When you add a RADIUS server, you provide a method to centralize the management of authentication passwords over a network. Figure 3-1. Add Radius Server To add a RADIUS server, do the following: Open the faceplate display, open the Switch menu, and select Radius Servers...
Page 49
In the Retries field, enter the the number of retries. This is the maximum number of times the RADIUS client will retry a request sent to the primary RADIUS server. Select the Sign Packet check box to enable the switch to include a digital signature (Message-Authenticator) in all RADIUS access request packets sent to the RADIUS server.
3 – Managing Fabrics RADIUS Servers 3.1.2 Removing a RADIUS Server When you remove a RADIUS server, you disable the management of authentication usernames and passwords over the network for that server. Figure 3-2. Remove Radius Server To remove a RADIUS server, do the following: Open the faceplate display, open the Switch menu, and select Radius Servers...
3.1.3 Editing RADIUS Server Information Editing information of a RADIUS server involves changing the configuration of a RADIUS server. Figure 3-3. Edit Radius Server Information To edit information of a RADIUS server, do the following: Open the faceplate display, open the Switch menu, and select Radius Servers...
3 – Managing Fabrics RADIUS Servers 3.1.4 Modifying Authentication Order RADIUS Server Information Editing information of a RADIUS server involves changing the configuration of a RADIUS server. Figure 3-4. Modify Authentication Order - Radius Server Information To modify the authentication order information of a RADIUS server, do the following: Open the faceplate display, open the Switch menu, and select Radius Servers...
Securing a Fabric Fabric security consists of the following: Connection Security User Account Security Security Consistency Checklist Device Security Fabric Services 3.2.1 Connection Security Connection security provides an encrypted data path for switch management methods. The switch supports the Secure Shell (SSH) protocol for the command line interface and the Secure Socket Layer (SSL) protocol for management applications such as SANsurfer Switch Manager and Common Information Module (CIM).
3 – Managing Fabrics Securing a Fabric 3.2.2 User Account Security User account security is the process by which your user account and password are authenticated with the list of valid user accounts and passwords. The switch validates your account and password when you attempt to add a fabric using SANsurfer Switch Manager or log in to a switch through Telnet.
3.2.4 Device Security Device security provides for the authorization and authentication of devices that you attach to a switch. You can configure a switch with a group of devices against which the switch authorizes new attachments by devices, other switches, or devices issuing management server commands.
3 – Managing Fabrics Securing a Fabric 3.2.4.1 Edit Security Dialog The Edit Security dialog, shown in button on the toolbar or selecting Edit Security from the Security menu. The Security dialogs are available only on a secure (SSL) fabric and on the entry switch (out of band switch).
Use the File menu to: Edit the security configuration on the switch. Open or edit security files. Save or rename security files Use the Edit menu to: Create security sets, security groups, and security group members Rename or remove a security group from a security set or a member from a security group Remove a group from all security sets Remove all security sets, groups, or members...
3 – Managing Fabrics Securing a Fabric 3.2.4.3 Create Security Group Dialog Use the Create Security Group dialog, shown in group to a security set. The Create Security Group dialog is displayed after clicking the Security Group button on the toolbar, or after you right-click on a security set in the graphic window and select Create a Security Group from the popup menu.
3.2.4.4 Creating a Security Group An empty (no members) security group in the active security set will prevent all connections for that security group type. For example, an empty ISL security group will cause the switch to refuse all logins from other switches. To add a security group to a security set, do the following: On the faceplate display, click the Security button on the toolbar, or open the Security menu and select Edit Security to open the Edit Security dialog.
3 – Managing Fabrics Securing a Fabric 3.2.4.5 Create Security Group Member Dialog Use the Create Security Group Member dialog, shown in member to a security group. Choose options from the Group Member (or manually type in a hex value) and Authentication pull-down menus, and enter values in the Secret and Binding (ISL groups only) fields.
The conventions for MS security group members are listed below: You can enter member world-wide name (WWN), which must be 16 hex characters, or 23 characters with valid WWN format xx:xx:xx:xx:xx:xx:xx:xx. The CT (common transport) authentication choices are None, MD5, and SHA-1.
3 – Managing Fabrics Securing a Fabric 3.2.4.7 Editing the Security Configuration on a Switch To edit a security configuration on the switch, do the following: On the faceplate display, click the Security button on the toolbar, or open the Security menu and select Edit Security to open the Edit Security dialog. By default, the security configuration on the switch is displayed in the Edit Security dialog.
3.2.4.8 Viewing Properties of a Security Set, Group, or Member To view the properties of a security set, group, or member, do the following: On the faceplate display and click the Security button on the toolbar, or open the Security menu and select Edit Security to open the Edit Security dialog.
3 – Managing Fabrics Securing a Fabric Check the Fabric Binding Enabled check box to require the expected domain ID of a switch is verified before being allowed to attach to the fabric. Note: The fabric binding feature must be enabled on all switches in the fabric.
3.2.4.13 Configured Security Data Window The Configured Security data window displays a graphical representation of all security sets, groups, and members in the database. To open the Configured Security data window, click the Configured Security tab below the data window in the faceplate display.
3 – Managing Fabrics Tracking Fabric Firmware and Software Versions 3.2.5.1 Enabling SNMP Configuration To enable SNMP configuration, choose one of the following: On the faceplate display, open the Switch menu. Select SNMP Properties to open the SNMP Properties dialog. In the SNMP Configuration area, place a check mark in the SNMP Enabled check box.
The Summary tab page shows a brief description of the changes that have occurred between the older snapshot and the newer one. Use the Summary tab page quickly view what has changed. 3.3.2 Viewing and Comparing Version Snapshots The Differences tab page shows a side-by-side comparison of two snapshots. The timestamp of each snapshot is displayed above the scroll area showing that snapshot.
3 – Managing Fabrics Managing the Fabric Database Managing the Fabric Database A fabric database contains the set of fabrics that you have added during a SANsurfer Switch Manager session. Initially, if you do not open an existing fabric or fabric view file, the SANsurfer Switch Manager application opens with an empty fabric database.
Note: Click the Add Fabric button. Note: 3.4.2 Removing a Fabric To delete a fabric file from the database, do the following: Select a fabric in the fabric tree. Open the Fabric menu and select Remove Fabric. 3.4.3 Opening a Fabric View File A fabric view file is one or more fabrics saved to a file.
3 – Managing Fabrics Managing the Fabric Database 3.4.4 Saving a Fabric View File To save a fabric view file, do the following: Open the File menu, and select Save View As. In the Save View dialog, enter a new file name. Enter a file password, if necessary.
3.4.7 Adding a New Switch to a Fabric If there are no special conditions to be configured for the new switch, simply plug in the switch and the switch becomes functional with the default fabric configuration. The default fabric configuration settings are: Fabric zoning is sent to the switch from the fabric.
3 – Managing Fabrics Managing the Fabric Database 3.4.8 Replacing a Failed Switch The archive/restore works for all switches. However, the Restore menu item is not available for the in-band switches. You can only restore a switch out-of-band (the fabric management switch). There are certain parameters that are not archived, and these are not restored by SANsurfer Switch Manager.
Displaying Fabric Information The topology display is your primary tool for monitoring a fabric. The graphic window of the topology display provides status information for switches, inter-switch links, and the Ethernet connection to the management workstation. The data window tabs show device, switch, and active zone set information. The Active Zoneset tab shows the zone definitions for the active zone set.
Page 74
3 – Managing Fabrics Displaying Fabric Information Table 3-1. Topology Display Switch and Status Icons Switch Icon 3-28 Description SANbox 5602 Switch Normal operation (Green) Warning–operational with errors (Yellow) Critical–potential failure (Red) Unknown–communication status unknown, unreachable, or unmanageable (Blue) Fabric Management Switch...
3.5.2 Displaying the Event Browser The Event Browser displays a list of events generated by the switches in the fabric and the SANsurfer Switch Manager application. Events that are generated by the SANsurfer Switch Manager application are not saved on the switch, but can be saved to a file during the SANsurfer Switch Manager session.
Page 76
3 – Managing Fabrics Displaying Fabric Information Severity is indicated in the severity column using icons as described in Severity Icon No icon Note: Events (Alarms, Critical, Warning, and Informative) generated by the application are not saved on the switch. They are permanently discarded when you close a SANsurfer Switch Manager session, but you can save these events to a file on the workstation before you close SANsurfer Switch Manager and read it later with a text...
3.5.2.1 Filtering the Event Browser Filtering the Event Browser enables you to display only those events that are of interest based on the event severity, timestamp, source, type, and description. To filter the Event Browser, open the Filter menu and select Filter Entries. This opens the Filter Events dialog shown in those events that meet all of the criteria in the Filter Events dialog.
3 – Managing Fabrics Displaying Fabric Information 3.5.2.2 Sorting the Event Browser Sorting the Event Browser enables you to display the events in alphanumeric order based on the event severity, timestamp, source, type, or description. Initially, the Event Browser is sorted in ascending order by timestamp. To sort the Event Browser, click the Severity, Timestamp, Source, Type, or Description column buttons.
3.5.3 Devices Data Window The Devices data window displays information about devices (hosts and storage targets) connected to the switch. Click the Devices tab below the data window to display device information for all devices that are logged into the selected fabric. To narrow the display to devices that are logged into specific switches, select one or more switches in the fabric tree or the topology display.
3 – Managing Fabrics Displaying Fabric Information 3.5.4 Active Zone Set Data Window The Active Zoneset data window displays the zone membership for the active zone set that resides on the fabric management switch. The active zone set is the same on all switches in the fabric –...
3.5.4.1 Link Data Window The Link data window displays information about all switch links in the fabric or selected links. This information includes the switch name, the port number at the end of each link, and the link status icons. To open the Link data window, click the Link tab below the data window in the topology display.
3 – Managing Fabrics Working with Device Information and Nicknames 3.6.2 Exporting Device Information to a File To save device information to a file, open the topology display and do the following: Select one or more switches. If no switches are selected, Devices information is gathered for all switches.
3.6.3.2 Editing a Nickname A nickname must start with a letter and can have up to 64 characters. Valid characters include alphanumeric characters [aA-zZ][0-9] and special symbols [$ _ - ^ ]. You can access the Edit Nicknames dialog two ways. Choose one of the following methods to edit a nickname.
3 – Managing Fabrics Zoning a Fabric 3.6.3.5 Importing a Nicknames File Importing a nicknames file copies its contents into and replaces the contents of the Nicknames.xml file which is used by SANsurfer Switch Manager. To import a nickname file, do the following: Open the File menu and select Nicknames to open the Nicknames dialog.
3.7.1.1 Zones A zone is a named group of ports or devices that can communicate with each other. Devices within a zone can only communicate with other devices in the same zone. A device may participate in more than one zone. Membership in a zone can be defined by switch domain ID and port number, device Fibre Channel address (FCID), or device World Wide Name (WWN).
3 – Managing Fabrics Zoning a Fabric 3.7.1.1.2 Access Control List Hard Zones Access Control List (ACL) zoning divides the fabric for purposes of controlling discovery and inbound traffic. ACL zoning is a type of hard zoning that is hardware enforced. This type of zoning is useful for controlling access to certain devices without totally isolating them from the fabric.
3.7.1.4 Zoning Database Each switch has its own zoning database. The zoning database is made up of all aliases, zones, and zone sets that have been created on the switch or received from other switches. The switch maintains two copies of the inactive zoning database: one copy is maintained in temporary memory for editing purposes;...
3 – Managing Fabrics Zoning a Fabric 3.7.2 Using the Zoning Wizard The Zoning Wizard is a series of dialogs that leads you through the process of zoning a fabric. To open the Zoning Wizard, open the Wizards menu in the faceplate display, and select Zoning Wizard.
3.7.3.1 Editing the Zoning Database To edit the zoning database for a particular switch, open the Zoning menu from the faceplate display and select Edit Zoning to open the Edit Zoning dialog shown in Figure stored in flash (non-volatile) memory and retained after resetting a switch. Zone Sets Tree Figure 3-15.
Page 90
3 – Managing Fabrics Zoning a Fabric The Edit Zoning dialog has a Zone Sets tree on the left and a Port/Device (or members) tree on the right. Both trees use display conventions similar to the fabric tree for expanding and contracting zone sets, zones, and ports. An expanded port shows the port Fibre Channel address;...
Page 91
3 – Managing Fabrics Zoning a Fabric Table 3-4. Edit Zoning Dialog Tool Bar Buttons and Icons Tool Bar Button Description Create Zone Set button - create a new zone set Create Zone button - create a new zone Create Alias button - create another name for a set of objects Add Member button - add selected port/device to a zone Remove Member button - delete the selected zone from a zone set, or delete the selected port/device from a zone...
3 – Managing Fabrics Zoning a Fabric 3.7.3.2 Configuring the Zoning Database Use the Zoning Config dialog to change the Interop Auto Save, Default Visibility, and Discard Inactive parameters. In the faceplate display, open the Zoning menu and select Edit Zoning Config to open the Zoning Config dialog shown in Figure 3-16.
3.7.3.2.2 Default Visibility Default visibility determines the level of communication that is permitted among ports/devices when there is no active zone set. The default visibility parameter can be set differently on each switch. When default visibility is enabled (ALL) on a switch, all ports/devices on the switch can communicate with all ports/devices on switches that also have default visibility enabled.
3 – Managing Fabrics Zoning a Fabric 3.7.3.5 Restoring the Default Zoning Database Restoring the default zoning clears the switch of all zoning definitions. CAUTION! This command will deactivate the active zone set. To restore the default zoning for a switch: In the faceplate display, open the Zoning menu and select Restore Default Zoning.
3.7.4 Managing Zone Sets Zoning a fabric involves creating a zone set, creating zones as zone set members, then adding devices as zone members. The zoning database supports multiple zone sets to serve the different security and access needs of your storage area network, but only one zone set can be active at one time.
3 – Managing Fabrics Zoning a Fabric To create new zones in a zone set, do one of the following: Right-click a zone set and select Create A Zone from the popup menu. In the Create a Zone dialog, enter a name for the new zone, and click the OK button.
3.7.4.4 Removing a Zone from a Zone Set or from All Zone Sets You can remove a zone from a zone set or from all zone sets in the database. In the faceplate display, open the Zoning menu and select Edit Zoning to open the Edit Zoning dialog.
3 – Managing Fabrics Zoning a Fabric 3.7.5 Managing Zones Managing zones involves the following: Creating a Zone in a Zone Set Adding Zone Members Renaming a Zone or a Zone Set Removing a Zone Member Removing a Zone from a Zone Set Removing a Zone from All Zone Sets Changing Zone Types Note:...
3.7.5.1 Creating a Zone in a Zone Set When a zone is created, its zone type is soft. To change the zone type to a hard zone, refer to ”Changing Zone Types” on page 3-56 ”Zones” on page 3-39 zone in a zone set, do the following: Open the Zoning menu, and select Edit Zoning to open the Edit Zoning dialog.
3 – Managing Fabrics Zoning a Fabric 3.7.5.2 Adding Zone Members You can zone a port/device by switch domain ID and port number, device port Fibre Channel address, or the device port WWN. Adding a port/device to a zone affects every zone set in which that zone is a member. To add ports/devices to a zone, do the following: Open the Zoning menu, and select Edit Zoning to open the Edit Zoning dialog.
3.7.5.3 Renaming a Zone or a Zone Set To rename a zone, do the following: In the Zone Sets tree of the Edit Zoning dialog, click the zone/zone set to be renamed. Open the Edit menu and select Rename. In the Rename Zone/Rename Zone Set dialog, enter a new name for the zone/zone set.
3 – Managing Fabrics Zoning a Fabric 3.7.5.7 Changing Zone Types To change a zone type, do the following: In the faceplate display, select the switch with the zone type to change. Click the Zoning button to open the Edit Zoning dialog. In the Zone Sets tree, select the zone to change.
3.7.6.2 Adding a Member to an Alias You can add a port/device to an alias by domain ID and port number, device port Fibre Channel address, or the device port WWN. To add ports/devices to an alias, do the following: Open the Zoning menu, and select Edit Zoning to open the Edit Zoning dialog.
3 – Managing Fabrics Zoning a Fabric 3.7.7 Merging Fabrics and Zoning If you join two fabrics with an inter-switch link, the active zone sets from the two fabrics attempt to merge automatically. The fabrics may consist of a single switch or many switches already connected together.
This section describes the following tasks that manage switches in the fabric. Managing User Accounts Displaying Switch Information Configuring Port Threshold Alarms Paging a Switch Setting the Date/Time and Enabling NTP Client Resetting a Switch Configuring a Switch Managing Switch Stacks Archiving a Switch Restoring a Switch Restoring the Factory Default Configuration...
Page 106
4 – Managing Switches Managing User Accounts Switches come from the factory with the following user accounts: Account Name admin images 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.
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 user accounts. Figure 4-1. User Account Administration Dialog – Add Account To open the User Account Administration dialogs, open the Switch menu in the faceplate display, and select User Accounts...
4 – Managing Switches Managing User Accounts 4.1.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 the list of accounts at the top of the dialog and click the Remove Account button.
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 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 Managing User Accounts 4.1.4 Modifying a User Account To modify a user account on a switch, open the Switch menu in the faceplate display and select User Accounts... This displays the User Account Administration dialog shown in the account (login) name from the list of accounts at the top of the dialog.
Port information Configured zone sets Figure 4-5 shows the faceplate display for the SANbox 5602 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.
4 – Managing Switches Displaying Switch Information 4.2.1 Devices Data Window The Devices data window displays information about devices (hosts and storage targets) connected to the switch. Click the Devices tab below the data window to display name server information for all devices that are logged into the selected fabric.
Page 113
Table 4-2. Switch Data Window Entries (Continued) Entry PROM/Boot Version MAC Address IP Address Subnet Mask Gateway SNMP Enabled Negotiated Domain ID Configured Domain ID Domain ID Lock Number of Ports Operational State Administrative State Configured Admin State R_A_TOV E_D_TOV Interop Mode Legacy Address Format Interop...
Page 114
4 – Managing Switches Displaying Switch Information Table 4-2. Switch Data Window Entries (Continued) Entry Zoning Default Visibility Security Auto Save Security Fabric Binding Enable Temperature Fan 1 Status Fan 2 Status Fan 3 Status Power Supply 1 Status Power Supply 2 Status Beacon Status Broadcast Support In-band Enabled...
Page 115
Table 4-2. Switch Data Window Entries (Continued) Entry FDMI Enable Number of Donor Groups Embedded GUI Inactivity Timeout GUI Mgmt Enabled Telnet Enabled SSH Enabled SSL Enabled CIM Enabled FTP Enabled Management Server Enabled 59097-01 A Displaying Switch Information Description Fabric Device Management Interface status.
4 – Managing Switches Displaying Switch Information 4.2.3 Port Statistics Data Window The Port Statistics data window displays port performance data for the selected ports. To open the Port Statistics data window, click the Port Stats tab below the data window in the faceplate display. Refer to Port Statistics data window entries.
4.2.5 Configured Zonesets Data Window The Configured Zonesets data window displays all zone sets, zones, aliases, and zone membership in the zoning database, as shown in Configured Zonesets data window, click the Configured Zonesets tab below the data window in the faceplate display. To view the active zone set in the Active Zonesets data window, open the topology display and click the Active Zonesets data window tab.
4 – Managing Switches Configuring Port Threshold Alarms Configuring Port Threshold Alarms You can configure the switch to generate alarms for selected events. Configuring an alarm involves choosing an event type, rising and falling triggers, a sample window, and finally enabling or disabling the alarm. To configure port threshold alarms, do the following: In the faceplate display, open the Switch menu and select Port Threshold Alarm Configuration.
Enter a value for the rising trigger. A rising trigger alarm is generated when the event count per interval exceeds the rising trigger. The switch will not generate another rising trigger alarm for that event until the count descends below the falling trigger and rises again above the rising trigger. Consider the example in Enter a value for the falling trigger.
4 – Managing Switches Setting the Date/Time and Enabling NTP Client Setting the Date/Time and Enabling NTP Client The Date/Time and Network Time Protocol (NTP) dialog enables you to manually set the date, time, and time zone on a switch, or to enable the NTP Client to synchronize the date and time on the switch with an NTP server.
Page 121
Common administrative operations that change the fabric include: Zoning modifications Adding, moving or removing devices attached to the switch fabric. This includes powering up or powering down attached devices. Adding, moving or removing ISLs or other connections. Management Interfaces: After an NDCLA operation is complete, management connections must be re-initiated: SANsurfer Switch Manager sessions will re-connect automatically Telnet sessions must be restarted manually.
4 – Managing Switches Configuring a Switch Configuring a Switch Switch configuration is divided into three areas: chassis configuration, network configuration, and SNMP configuration. Chassis configuration specifies switch-wide Fibre Channel settings. Network configuration specifies IP settings, remote logging, and the NTP client. SNMP configuration specifies SNMP settings and traps.
4.7.2 Switch Properties To open the Switch Properties dialog, open the faceplate display for a switch, open the Switch menu, and select Switch Properties. You may also right-click a switch graphic in the topology display or faceplate display, and select Switch Properties from the popup menu.
4 – Managing Switches Configuring a Switch 4.7.2.2 Switch Administrative States The switch administrative state determines the operational state of the switch. The switch administrative state exists in two forms: the configured administrative state and the current administrative state. The configured administrative state is the state that is saved in the switch configuration and is preserved across switch resets.
4.7.2.3 Domain ID and Domain ID Lock The domain ID is a unique Fibre Channel identifier for the switch. The Fibre Channel address consists of the domain ID, port ID, and the Arbitrated Loop Physical Address (ALPA). The maximum number of switches within a fabric is 239 with each switch having a unique domain ID.
4 – Managing Switches Configuring a Switch Use the FDMI Enabled radio button on the Switch Properties dialog to enable or disable FDMI. If FDMI is enabled on an HBA, the HBA forwards information about itself to the switch when the HBA logs into the switch. If FDMI is enabled on a switch, the switch stores the HBA information in its FDMI database.
4.7.3 Advanced Switch Properties The Advanced Switch Properties dialog enables you to set the timeout values, Interop Mode, and Legacy Address Format settings. The Advanced Switch Properties dialog is available for only the entry switch, because an in-band switch can not be taken offline. The switch will automatically be taken offline temporarily and will be restored to its original state after the changes are completed.
4 – Managing Switches Configuring a Switch 4.7.3.2 Legacy Port Address Format Legacy Address Format should be enabled only to permit interoperation with certain older non-FC-SW-2 compliant switches. Enabling this setting under other circumstances will disable zoning that is defined by domain ID and port number. This Legacy Address Format option is available only when the Interop_1 setting is enabled on the Advanced Switch Properties dialog.
4.7.4 System Services Dialog The System Services dialog provides a central location for you to enable or disable any of the external user services such as Simple Network Management Protocol (SNMP), Secure Sockets Layer (SSL),Secure SHell (SSH), embedded switch management application, command line interface, Network Time Protocol (NTP), and Common Information Model (CIM).
4 – Managing Switches Configuring a Switch SSL - Secure Sockets Layer. Provides secure encrypted communications between the switch management application (GUI) and the switch. SSL must be enabled for configuration of security and radius servers with the switch management application (GUI). SSL certificates are generated on the switch with the switch date/time and validated with the workstation’s date/time.
4.7.6 Network Properties Use the Network Properties dialog shown in configuration parameters and enable remote logging. After making changes, click the OK button to put the new values into effect. To open the Network Properties dialog, select a switch in the topology display or open the faceplate display, open the Switch menu and select Network Properties.
4 – Managing Switches Configuring a Switch 4.7.6.1 IP Configuration The IP configuration identifies the switch on the Ethernet network and determines which network discovery method to use. parameters. Parameter Network Discovery IP Address Subnet mask Gateway 4-28 Table 4-6 Table 4-6.
4.7.6.2 Remote Logging The Remote Logging (syslog) feature enables saving of the log information to a remote host that supports the syslog protocol. When enabled, the log entries are sent to the syslog host at the IP address that you specify in the Logging Host IP Address field.
4 – Managing Switches Configuring a Switch 4.7.7 SNMP Properties Use the SNMP Properties dialog shown in configuration parameters. After making changes, click the OK button to put the new values into effect. To open the SNMP Properties dialog, select a switch in the topology display or open the faceplate display, open the Switch menu and select SNMP Properties.
4.7.7.1 SNMP Configuration The SNMP configuration defines how authentication traps are describes the SNMP configuration parameters. The illegal characters for the user-defined fields are the pound sign (#), semi-colon (;), and comma (,). Parameter SNMP Enabled Contact Read Community Trap Community Trap community password (up to 32 characters) that authorizes an SNMP Proxy Location Authentication...
Managing Switch Stacks SANsurfer Switch Manager recognizes switches as a stack if they are connected by their high speed stacking ports. The switch management application will auto-detect switches connected by their 10-Gbps ports and display these stacked switches as a single stack entity in the topology and faceplate displays. The graphic window (upper right pane of the faceplate display) displays one faceplate image for each switch in the stack.
Page 138
4 – Managing Switches Managing Switch Stacks The stack dialogs are essentially the same as their corresponding switch dialogs, except for the Select Switch for Initial Configuration pull-down menu is added to each dialog. The stack dialogs display the information for the switch selected in the Select Switch for Initial Configuration pull-down menu.
4.8.1 Syslog The Syslog dialog enables you to save the log information for the stack to a remote host that supports the syslog protocol. Use the Syslog dialog to enable remote logging for the stack. Refer to information. 4.8.2 Select Source Dialog The Select Source dialog enables you to select the initial zoning configuration to be loaded into the Edit Zoning dialog when making zoning changes to all switches in a stack.
4 – Managing Switches Archiving a Switch Archiving a Switch You can create an .XML archive file containing the configuration parameters. Basically any data received by SANsurfer Switch Manager is archived. However, passwords are not archived with the user account information. Archived parameters include the following: Switch properties and statistics IP configuration...
The switch configuration must be archived before it can be restored. The switch archive must be compatible with the switch to be restored; that is, you can restore a SANbox 5602 switch only with an archive from a SANbox 5602 switch. Refer to ”Archiving a Switch”...
Page 142
4 – Managing Switches Restoring a Switch Enter the archive file name or browse for the file. This archive file must be one that was produced by the SANsurfer Switch Manager Archive function. Configuration backup files created with the Config Backup command are not compatible with the SANsurfer Switch Manager Restore function.
4.11 Restoring the Factory Default Configuration You can restore the switch and port configuration settings to the factory default values. To restore the factory configuration on a switch, open the Switch menu and select Restore Factory Defaults. configuration settings. Restoring the switch to the factory default configuration does not restore the account name and password settings.
Page 144
4 – Managing Switches Restoring the Factory Default Configuration Table 4-9. Factory Default Configuration Settings (Continued) Network Discovery Remote Logging Remote Logging Host Ip Address NTP Client Enabled NTP Server IP Address Contact Location Trap Enabled Trap Port Trap Address Trap Community Read Community Write Community...
4.12 Downloading a Support File The Download Support File menu option assembles all log files and switch memory data into a core dump file (dump_support.tgz). This file can be sent to technical support personnel for troubleshooting switch problems. The menu option is not accessible (displayed) for switches that don't support the download support file function.
4 – Managing Switches Installing Firmware Open the Switch Menu and select Features to open the Feature Licenses dialog shown in Figure 4-17. Features License Key Dialog In the Feature Licenses dialog, click the Add button to open the Add License Key dialog shown in Figure 4-18.
Page 147
During a hotreset operation, fabric services will be unavailable for a short period (30-75 seconds depending on switch model). To ensure that an NDCLA operation is successful, verify that all administrative changes to the fabric (if any) are complete. When you need to do NDCLA/hotreset to multiple switches, only perform the NDCLA/hotreset on one switch at a time, and allow a 75 second wait before performing the NDCLA/hotreset operation on the next switch.
4 – Managing Switches Installing Firmware 4.14.1 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.
This section describes the following tasks that manage ports and devices: Displaying Port Information Configuring Ports Using the Extended Credits Wizard Resetting a Port Testing Ports Graphing Port Performance Displaying Port Information Port information is available primarily in the faceplate display shown in The faceplate display data windows provide information and statistics for switches and ports.
5 – Managing Ports Displaying Port Information 5.1.1 Monitoring Port Status The faceplate display provides the following port related information: Port type Port operational state Port speed Port media To display port number and status information for a port, position the cursor over a port on the faceplate display.
5.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. states and their meanings. The port operational state refers to actual port state and not the administrative state you may have assigned. State 5.1.1.3 Displaying Port Speeds...
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 Media Icon None lists the port media states and their meanings. Table 5-4. Port Transceiver Media View Description Optical SFP, Online (Green) Optical SFP, Offline (Gray)
5.1.2 Port Statistics Data Window The Port Statistics data window displays statistics about port performance. To open the Port Statistics window, select one or more ports in the faceplate display and click the Port Stats tab below the data window. Statistics data window entries.
Page 154
5 – Managing Ports Displaying Port Information Table 5-5. Port Statistics Data Window Entries (Continued) Entry Class 3 Toss Class 3 Words In Class 3 Words Out Decode Errors Ep Connects FBusy Flow Errors FReject Invalid CRC Invalid Destination Address Link Failures LIP (AL_PD,AL_PS) LIP(f7,AL_PS)
Page 155
Table 5-5. Port Statistics Data Window Entries (Continued) Entry LIP(f7,f7) LIP(f8,AL_PS) LIP(f8,f7) Login Count Logout Count Loop Timeouts Loss Of Sync Primitive Sequence Errors Rx Link Resets Rx Offline Sequences Total Errors Total Link Resets Total LIPs Received Total LIPs Transmitted Tx Offline Sequences Total Rx Frames Total Rx Words...
5 – Managing Ports Displaying Port Information 5.1.3 Port Information Data Window The Port Information data window displays detail information for the selected port. To open the Port Information data window, click the Port Info tab below the data window in the faceplate display. Table 5-6.
Page 157
Table 5-6. Port Information Data Window Entries (Continued) Entry I/O Stream Guard Administrative Port Speed Operational Port Speed Max Credits Device Scan Symbolic Name Ext Credits Requested Credits to Donate Donor Group Valid Donor Groups Media Media Speed Media Type Media Transmitter Media Distance Media Vendor...
5 – Managing Ports Configuring Ports Configuring Ports The port settings or characteristics for 1-Gbps/2-Gbps/4-Gbps and 10-Gbps ports are configured using the Port Properties dialogs shown in corresponding type of Port Properties dialog, select one or more ports, open the Port menu and select Port Properties or Port Properties 10G.
5.2.1 Changing Port Administrative States The port administrative state determines the operational state of a port. The port administrative state has two forms: the configured administrative state and the current administrative state. The configured administrative state is the state that is saved in the switch configuration and is preserved across switch resets.
5 – Managing Ports Configuring Ports 5.2.2 Changing Port Speeds The 1-Gbps/2-Gbps/4-Gbps ports are capable of transmitting and receiving at 1-Gbps or 2-Gbps. The ports can be configured for either transmission speed or to sense the transmission speed of the device to which it is connected. describes the port speeds.
5.2.3 Changing Port Types The ports can be configured to self-discover the proper type to match the device or switch to which it is connected. To change the port type, do the following: Select one or more ports in the faceplate display. Open the Port menu and select Port Properties 1G/2G or Port Properties 10G to open the Port Properties dialog.
5 – Managing Ports Using the Extended Credits Wizard 5.2.5 Device Scan The Device Scan feature queries the connected device during login for FC-4 descriptor information. Disable this parameter only if the scan creates a conflict with the connected device. 5.2.6 Changing Port Symbolic Name To change the symbolic name of a port from the faceplate display, do the...
Designate Donor Ports: Select available ports and click >> to move the port into the Selected Donor Port column shown in of ports needed with the number of designated donor ports. Click the Next button. Figure 5-3. Designate Donor Ports Verify Requested Changes: Review the extended distance requests and the selected donor ports.
5 – Managing Ports Testing Ports Testing Ports The port loopback tests verify correct port operation by sending a frame out through the loop, and then verifying that the frame received matches the frame that was sent. Only one port can be tested at a time for each type of test. The Port Loopback Test dialog shown in Figure 5-4.
Page 165
Node-to-Node (Online) - The Node-to-Node test verifies communications between the port and its device node or device loop. The port being tested must be online and connected to a remote device. The port passes the test if the frame that was sent by the ASIC matches the frame that was received. This test does not disrupt communication on the selected port.
5 – Managing Ports Graphing Port Performance Graphing Port Performance SANsurfer Performance Viewer application displays port performance using graphs. SANsurfer Performance Viewer plots data communication rates and total errors for selected ports as shown in communication rates, you can choose either frames/second or KB/second. On Solaris platforms, if you launch the SANsurfer Performance Viewer application from the SANsurfer Switch Manager application and SANsurfer Performance Viewer can not connect to the fabric, (for example, if you have reached the...
This section describes how to do the following: Starting SANsurfer Performance Viewer Exiting SANsurfer Performance Viewer Saving and Opening Performance View Files Changing the Default Performance View File Encryption Key Setting SANsurfer Performance Viewer Preferences Setting the Polling Frequency Displaying Graphs for a Switch Printing Graphs Saving Graph Statistics to a File 5.6.1...
5 – Managing Ports Graphing Port Performance Figure 5-6, prompts you to save the current performance view file as the default performance view file. Refer to Encryption Key” on page 5-21 encryption key. In the Save Default Performance View File dialog, enter an encryption key in the Default Performance File Encryption Key field.
5.6.3 Saving and Opening Performance View Files In addition to the default performance view file, you can save and open your own performance view files. The performance view file contains the set of fabrics, graphs, and graphing options. To save a performance view file, do the following: Open the File menu and select Save View As to open the Save View dialog.
5 – Managing Ports Graphing Port Performance 5.6.5 Setting SANsurfer Performance Viewer Preferences To set preferences, open the File menu and select Preferences to open the Preferences dialog shown in the OK button to save the changes: Change the location of the working directory in which to save files Change the location of the browser used to view the online help.
5.6.7 Displaying Graphs for a Switch To display graphs, do the following: Open the Fabric menu and select Add Fabric or click the Add button. Enter a fabric name and an IP address in the Add a New Fabric dialog. Include an account name and a password if required.
5 – Managing Ports Graphing Port Performance 5.6.7.2 Arranging Graphs in the Display To arrange and size graphs in the display, open the Window menu and select Cascade, Tile, or Close All. Cascade overlaps the graphs so that all graphs are at least partially visible. Tile arranges the graphs in non-overlapping rows and columns.
Page 173
To modify the graph options, do the following: Choose the units for the graph: Select the Show Bytes Data on Graph check box to plot data in KBytes/second Select the Show Frames Data on Graph check box to plot data in frames/second.
5 – Managing Ports Graphing Port Performance 5.6.7.4 Setting Global Graph Type The Set Global Graph Type option enables you to view port activity using two types of graphs: Line Graph - plots continuous port activity in horizontal line format. Bar Graph - the last polling value received by the application in bar graph format.
Logging On to a Switch User Accounts Working with Switch Configurations Commands Logging On to a Switch To log on to a switch using Telnet, open a command line window on the workstation and enter the Telnet command followed by the switch IP address: # telnet ip_address A Telnet window opens prompting you for a login.
A – Command Line Interface User Accounts User Accounts Switches come from the factory with the following user account already defined: Account name: admin Password: password Authority: Admin This user account provides full access to the switch and its configuration. After planning your fabric management needs and creating your own user accounts, consider changing the password for this account.
A.3.1 Modifying a Configuration A switch supports up to 10 configurations including the default configuration. Each switch configuration contains switch, port, port threshold alarm, and zoning configuration components. The Show Switch command displays the name of the active configuration. A configuration name can have up to 31 characters excluding the pound symbol (#), semicolon (;), and comma (,).
A – Command Line Interface Working with Switch Configurations A.3.2 Backing up and Restoring Switch Configurations Backing up and restoring a configuration is useful to protect your work or for use as a template in configuring other switches. The Config Backup command creates a file on the switch, named configdata.
Page 179
The restore operation begins with FTP to upload the configuration file from the workstation to the switch, then finishes with a Telnet session and the Config Restore command. To upload the configuration file, config_switch_169_10112003 in this case, open and FTP session with account name images and password images.
A – Command Line Interface Commands Commands The command syntax is as follows: command keyword keyword [value] keyword [value1] [value2] The Command is followed by one or more keywords. Consider the following rules and conventions: Commands and keywords are case insensitive. Required keyword values appear in standard font: [value].
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.
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.
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. Authority Admin session for all keywords except List and Members Syntax alias add [alias] [member_list]...
Page 184
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 <space>...
CIM Command Manages CIM listener and subscription configurations on the switch. Refer to the ”CIMListener Command” on page A-12 modifying CIM listeners. Refer to the for information about creating and modifying CIM subscriptions. Authority Admin session Syntax cancel clear edit limits save Keywords...
A – Command Line Interface CIMListener Command CIMListener Command Configures CIM indication service listeners and adds subscriptions to listeners. Refer to the ”CIMSubscription Command” on page A-14 configuring subscriptions. Authority Admin session and a CIM Edit session. Refer to the page A-11 for information about opening a CIM edit session.
Page 187
Examples The following is an example of the CIMListener Create command: SB5602-91.54 (admin-cim) #> cimlistener create listener_1 A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so.
A – Command Line Interface CIMSubscription Command CIMSubscription Command Creates, edits, or removes CIM subscriptions. Authority Admin session and a CIM Edit session. Refer to the page A-11 for information about opening a CIM edit session. Syntax cimsubscription create [subscription_name] delete [subscription_name] edit [subscription_name] Keywords...
Page 189
Examples The following is an example of the CIMSubscription Create command: SANbox Manager (admin-cim) #> cimsubscription create subscription_1 A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so.
A – Command Line Interface Config Command Config Command Manages the Fibre Channel configurations on a switch. For information about setting the port and switch configurations, refer to the page A-61. Authority Admin session for all keywords except List Syntax config activate [config_name] backup...
Page 191
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.
Page 192
A – Command Line Interface Config Command The following is an example of how to create a backup file (configdata) and download the file to the workstation. SANbox Manager #> admin start SANbox Manager (admin) #> config backup SANbox Manager (admin) #> admin end SANbox Manager #>...
Create Command Creates support files for troubleshooting switch problems, and certificates for secure communications for SANsurfer Switch Manager. Authority Admin session Syntax create certificate support Keywords certificate Creates a security certificate on the switch. The security certificate is required to establish an SSL connection with a management application such as SANsurfer Switch Manager.
Page 194
A – Command Line Interface Create Command Examples The following is an example of the Create Support command when an FTP server is available on the workstation: SANbox Manager (admin) #> create support Log Msg:[Creating the support file - this will take several seconds] FTP the dump support file to another machine? (y/n): y Enter IP Address of remote computer: 10.20.33.130 Login name: johndoe...
Page 195
The following is an example of the Create Support command and how to download the support file to your workstation. When prompted to send the support file to another machine, decline, then close the Telnet session. Open an FTP session on the switch and log in with the account name images and password images.
A – Command Line Interface Date Command Date Command This command displays or sets the system date and time. To set the date and time the information string must be provided in this format: MMDDhhmmCCYY. The new date and time takes effect immediately. Authority Admin session except to display the date.
Feature Command Adds license key features to the switch and displays the license key feature log. To order a license key contact your switch distributor or your authorized reseller. Upgrading a switch is not disruptive, nor does it require a switch reset. Authority Admin session for Add keyword only Syntax...
Page 198
A – Command Line Interface Firmware Install Command About to install image. Connected to 10.20.33.130 (10.20.33.130). 220 localhost.localdomain FTP server (Version wu-2.6.1-18) ready. 331 Password required for johndoe. Password: xxxxxxxxx 230 User johndoe logged in. 200 Type set to I. verbose Verbose mode off.
Group Command Creates groups, manages membership within the group, and manages the membership of groups in security sets. Authority Admin session and a Security Edit session. Refer to the page A-53 for information about starting a Security Edit session. The List, Members, Securitysets, and Type keywords are available without an Admin session.
A – Command Line Interface Group Command Keywords add [group] Initiates an editing session in which to specify a group member and its attributes for the existing group given by [group]. ISL, Port, and MS member attributes are described in Table and group type attributes are read-only fields common to all three tables.
Attribute Member Authentication Primary Hash Primary Secret Secondary Hash Secondary Secret 59097-01 A Table A-6. Port Group Member Attributes Description Port worldwide name for the N_Port device that would attach to the switch. A member cannot belong to more than one group. Enables (CHAP) or disables (None) authentication using the Challenge Handshake Authentication Protocol (CHAP).
A – Command Line Interface Group Command Attribute Member CTAuthentication Hash Secret copy [group_source] [group_destination] Creates a new group named [group_destination] and copies the membership into it from the group given by [group_source]. create [group] [type] Creates a group with the name given by [group] with the type given by [type]. A group name must begin with a letter and be no longer than 64 characters.
edit [group] [member] Initiates an editing session in which to change the attributes of a worldwide name given by [member] in a group given by [group]. Member attributes that can be changed are described in Attribute Authentication (ISL and Port Groups) CTAuthentication (MS Groups) Primary Hash...
Page 204
A – Command Line Interface Group Command Table A-8. Group Member Attributes (Continued) Attribute Secret (MS Groups) Binding (ISL Groups) list Displays a list of all groups and the security sets of which they are members. This keyword is available without an Admin session. members [group] Displays all members of the group given by [group].
Page 205
Examples The following is an example of the Group Add command: SANbox Manager (admin-security) #> group add Group_1 A list of attributes with formatting and default values will follow Enter a new value or simply press the ENTER key to accept the current value with exception of the Group Member WWN field which is mandatory.
Page 206
A – Command Line Interface Group Command The following is an example of the Group List command: SANbox Manager #> group list Group SecuritySet ----- ----------- group1 (ISL) alpha group2 (Port) alpha The following is an example of the Group Members command: SANbox Manager #>...
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 Authority Admin session Syntax hardreset Notes To reset the switch without a power-on self test, refer to the page A-45.
A – Command Line Interface Help Command Help Command Displays a brief description of the specified command, its keywords, and usage. Authority None Syntax help [command] [keyword] Keywords [command] Displays a summary of the command given by [command] and its keywords. If you omit [command], the system displays all available commands.
History Command Displays a numbered list of the previously entered commands from which you can re-execute selected commands. Authority None Syntax history Notes Use the History command to provide context for the ! command: Enter ![command_string] to re-execute the most recent command that matches [command_string].
A – Command Line Interface Hotreset Command Hotreset Command Resets the switch for the purpose of activating the pending firmware without disrupting traffic. This command terminates all management sessions, saves all configuration information, and clears the event log. After the pending firmware is activated, the configuration is recovered.
Image Command Manages and installs switch firmware. Authority Admin session Syntax image cleanup fetch [account_name] [ip_address] [file_source] [file_destination] install list unpack [file] Keywords cleanup Removes all firmware image files from the switch. All firmware image files are removed automatically each time the switch is reset. fetch [account_name] [ip_address] [file_source] [file_destination] Retrieves image file given by [file_source] and stores it on the switch with the file name given by [file_destination].
Page 212
A – Command Line Interface Image Command Notes To provide consistent performance throughout the fabric, ensure that all switches are running the same version of firmware. To install firmware when the management workstation has an FTP server, use the Image Install command or the install firmware when the management workstation does not have an FTP server, do the following: Move to the folder or directory on the workstation that contains the new...
Page 213
Display the list of firmware image files on the switch to confirm that the file was loaded. SANbox Manager (admin) $>image list Unpack the firmware image file to install the new firmware in flash memory. SANbox Manager (admin) $>image unpack filename Wait for the unpack to complete.
A – Command Line Interface Lip Command Lip Command Reinitializes the specified loop port. Authority Admin session Syntax lip [port_number] Keywords [port_number] The number of the port to be reinitialized. Ports are numbered beginning with 0. Examples The following is an example of the Lip command: SANbox Manager (admin) #>...
Passwd Command Changes a user account’s password. Authority Admin account name and an admin session to change another account’s password; You can change you own password without an Admin session. Syntax passwd [account_name] Keywords [account_name] The user account name. To change the password for an account name other than your own, you must open an admin session with the account name Admin.
A – Command Line Interface Ping Command Ping Command Initiates an attempt to communicate with another switch over an Ethernet network and reports the result. Authority None Syntax ping [ip_address] Keywords [ip_address] The IP address of the switch to query. Broadcast IP addresses, such as 255.255.255.255, are not valid.
Ps Command Displays current system process information. Authority None Syntax Examples The following is an example of the Ps command: SANbox Manager #> ps PPID %CPU 0.0 00:00:00 0.0 00:00:01 0.0 00:00:21 0.1 00:05:35 0.2 00:11:29 0.0 00:00:04 0.0 00:02:16 0.0 00:02:44 0.8 00:35:12 0.0 00:00:29...
A – Command Line Interface Quit Command Quit Command Closes the Telnet session. Authority None Syntax quit, exit, or logout Notes You can also enter Control-D to close the Telnet session. A-44 59097-01 A...
Reset Command Resets the switch configuration parameters. If you omit the keyword, the default is Reset Switch. Authority Admin session Syntax reset config [config_name] factory port [port_number] radius security services snmp switch (default) system zoning Keywords config [config_name] Resets the configuration given by [config_name] to the factory default values for switch, port, port threshold alarm, and zoning configuration as described in Table A-9 through...
Page 220
A – Command Line Interface Reset Command security Clears the security database and deactivates the active security set. The security configuration value, autosave, and fabric binding remain unchanged. services Resets the switch services configuration to the default values as described in Table A-15.
Notes The following tables specify the various factory default settings: Enter the Show Config Switch command to display switch configuration values. Parameter Admin State Broadcast Enabled InbandEnabled FDMIEnabled FDMIEntries DefaultDomain ID Domain ID Lock Symbolic Name R_A_TOV E_D_TOV Principal Priority Configuration Description InteropMode LegacyAddressFormat...
A – Command Line Interface Reset Command Enter the Show Config Port command to display port configuration values. Parameter Admin State Link Speed Port Type Symbolic Name ALFairness DeviceScanEnabled ForceOfflineRSCN ARB_FF InteropCredit ExtCredit FANEnable AutoPerfTuning LCFEnable MFSEnable MSEnable NoClose IOStreamGuard VIEnable PDISCPingEnable A-48...
A – Command Line Interface Reset Command Enter the Show Setup System command to display system configuration values. Parameter Ethernet Network Discovery Ethernet Network IP Address Ethernet Network IP Mask Ethernet Gateway Address Admin Timeout InactivityTimeout LocalLogEnabled RemotelogEnabled RemoteLogHostAddress NTPClientEnabled NTPServerAddress EmbeddedGUIEnabled Enter the Show Config Security command to display security configuration...
Security Command Opens a Security Edit session in which to manage the security database on a switch. Refer to the Command” on page Authority Admin session. The keywords Active, History, Limits, and List are available without an Admin session. Syntax security active cancel...
Page 228
A – Command Line Interface Security Command history Displays history information about the security database and the active security set including the account name that made changes and when those changes were made. This keyword does not require an Admin session. limits Displays the current totals and the security database limits for the number of security sets, groups, members per group, and total members.
Page 229
The following is an example of the Security History command: SB211.192 #> security history Active Database Information --------------------------- SecuritySetLastActivated/DeactivatedBy SecuritySetLastActivated/DeactivatedOn Database Checksum Inactive Database Information ----------------------------- ConfigurationLastEditedBy ConfigurationLastEditedOn Database Checksum The following is an example of the Security Limits command: SANbox Manager #>...
Page 230
A – Command Line Interface Security Command The following is an example of the Security List command: SANbox Manager (admin-security) #> security list SB211.192 #> security list Active Security Information SecuritySet Group ----------- ----- No active securityset defined. Configured Security Information SecuritySet Group -----------...
Securityset Command Manages security sets in the security database. Authority Admin session and a Security Edit session. Refer to the page A-53 for information about starting a Security Edit session. The Active, Groups, and List keywords are available without an Admin session. You must close the Security Edit session before using the Activate and Deactivate keywords.
Page 232
A – Command Line Interface Securityset Command delete [security_set] Deletes the security set given by [security_set]. If the specified security set is active, the command is suspended until the security set is deactivated. groups [security_set] Displays all groups that are members of the security set given by [security_set]. This keyword is available without an Admin session.
Set Command Sets a variety of switch parameters. Authority Admin session for all keywords except Alarm, Beacon, and Pagebreak which are available without an Admin session. Syntax alarm [option] beacon [state] config [option] log [option] pagebreak [state] port [option] setup [option] switch [state] timezone Keywords...
Page 234
A – Command Line Interface Set Command pagebreak [state] Specifies how much information is displayed on the screen at a time according to the value given by [state]. This keyword does not require an admin session. [state] can be one of the following: Limits the display of information to 20 lines at a time.
Set Config Command Sets switch, port, port threshold alarm, security, and zoning configuration parameters. The changes you make with this command are not retained when you reset or power cycle the switch unless you save them using the Config Save command.
Page 236
A – Command Line Interface Set Config Command Table A-18. Set Config Port Parameters (Continued) Parameter PortType SymbolicPortName ALFairness (1-Gbps/2-Gbps ports only) DeviceScanEnabled ForceOfflineRSCN ARB_FF (1-Gbps/2-Gbps ports only) InteropCredit ExtCredit (1-Gbps/2-Gbps ports only) FANEnable (1-Gbps/2-Gbps ports only) A-62 Description Port type: 1-Gbps/2-Gbps Ports: GL, G, F, FL, Donor.
Page 237
Table A-18. Set Config Port Parameters (Continued) Parameter AutoPerfTuning LCFEnable MFSEnable VIEnable MSEnable NoClose (1-Gbps/2-Gbps ports only) 59097-01 A A – Command Line Interface Description Automatic performance tuning for FL_Ports only. The default is True. If AutoPerfTuning is enabled (True) and the port is an FL_Port, MFSEnable is automatically enabled.
A – Command Line Interface Set Config Command Table A-18. Set Config Port Parameters (Continued) Parameter IOStreamGuard PDISCPingEnable (1-Gbps/2-Gbps ports only) security Initiates an editing session in which to change the security 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.
Parameter AdminState BroadcastEnabled InbandEnabled FDMIEnabled FDMIEntries DefaultDomainID DomainIDLock SymbolicName R_A_TOV E_D_TOV PrincipalPriority ConfigDescription 59097-01 A Table A-20. Set Config Switch Parameters Switch administrative state: online, offline, or diagnostics. The default is Online. Broadcast. Enables (True) or disables (False) forwarding of broadcast frames. The default is True. Inband management.
Page 240
A – Command Line Interface Set Config Command Table A-20. Set Config Switch Parameters (Continued) Parameter InteropMode LegacyAddressFormat A-66 Description Propagates just the active zone set throughout the fabric (Standard, FC-SW-2 compliant) or the entire zoning database (Interop-1, non-compliant). The default is Standard.
threshold Initiates a configuration session by which to generate and log alarms for selected events. The system displays each event, its triggers, and sampling window one line at a time and prompts you for a value. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets.
A – Command Line Interface Set Config Command zoning Initiates an editing session in which to change switch zoning attributes. The system displays each parameter one line at a time and prompts you for a value. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets.
Page 243
Examples The following is an example of the Set Config Port command: SANbox Manager #> admin start SANbox Manager (admin) #> config edit SANbox Manager (admin-config) #> set config port 1 A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value.
Page 244
A – Command Line Interface Set Config Command The following is an example of the Set Config Port command for a 10-Gbps port: SANbox Manager #> admin start SANbox Manager (admin) #> config edit SANbox Manager (admin-config) #> set config port 16 A list of attributes with formatting and current values will follow.
Page 245
The following is an example of the Set Config Security command: SANbox Manager #> admin start SANbox Manager (admin) #> config edit SANbox Manager (admin-config) #> set config security A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value.
Page 246
A – Command Line Interface Set Config Command The following is an example of the Set Config Switch command: SANbox Manager #> admin start SANbox Manager (admin) #> config edit SANbox Manager (admin-config) #> set config switch A list of attributes with formatting and default values will follow. Enter a new value or simply press the ENTER key to accept the current value.
Page 247
The following is an example of the Set Config Threshold command: SANbox Manager #> admin start SANbox Manager SANbox Manager (admin-config) #> set config threshold A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so.
Page 248
A – Command Line Interface Set Config Command The following is an example of the Set Config Zoning command. SANbox Manager #> admin start SANbox Manager (admin) #> config edit SANbox Manager (admin-config) #> set config zoning A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value.
Set Log Command Specifies the events to record in the event log and display on the screen. You determine what events to record in the switch event log using the Component, Level, and Port keywords. You determine what events are automatically displayed on the screen using the Display keyword.
Page 250
A – Command Line Interface Set Log Command None Monitor none of the component events. Other Monitors other miscellaneous events. Port Monitors all port events. SNMP Monitors all SNMP events. Switch Monitors switch management events. Zoning Monitors zoning conflict events. display [filter] Specifies the log events to automatically display on the screen according to the event severity levels given by [filter].
Page 251
level [filter] Specifies the severity level given by [filter] to use in monitoring and logging events for the specified components or ports. [filter] can be one of the following values: Critical Monitors critical events. The critical level describes events that are generally disruptive to the administration or operation of the fabric, but require no action.
Page 252
A – Command Line Interface Set Log Command Notes In addition to critical, warn, and informative severity levels, the highest event severity level is alarm. The alarm level describes events that are disruptive to the administration or operation of a fabric and require administrator intervention. Alarms are always logged and always displayed on the screen.
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...
Page 254
A – Command Line Interface Set Port Command state [state] Specifies one of the following administrative states for the specified port: Online Places the port online. This activates and prepares the port to send data. Offline Places the port offline. This prevents the port from receiving signal and accepting a device login.
Set Setup Command Manages configuration settings for Remote Authentication Dial-In User Service (RADIUS) servers, switch services, SNMP, and system configurations. Authority Admin session Syntax set setup radius services snmp system Keywords radius Prompts you in a line-by-line fashion to configure RADIUS servers for user account and device authentication.
Page 256
A – Command Line Interface Set Setup Command Table A-23. RADIUS Service Settings (Continued) Entry UserAuthServer AccountingServer Timeout Retries SignPackets Secret A-82 Description Enable (True) or disable (False) this server for user account authentication. A user authentication RADIUS server requires a secure management connection (SSL). The default is True.
services Prompts you in a line-by-line fashion to enable or disable switch services. Table A-24 describes the switch service parameters. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets. Note: Use caution when disabling TelnetEnabled and GUIMgmtEnabled;...
Page 258
A – Command Line Interface Set Setup Command Table A-24. Switch Services Settings (Continued) Entry EmbeddedGUIEnabled SNMPEnabled NTPEnabled CIMEnabled FTPEnabled MgmtServerEnabled A-84 Description Enables (True) or disables (False) the SANsurfer Switch Manager web applet. The web applet enables you to point at a switch with an internet browser and run SANsurfer Switch Manager through the browser.
snmp Prompts you in a line-by-line fashion to change SNMP configuration settings. Table A-25 describes the SNMP fields. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets. Entry SNMPEnabled Contact Location Trap [1-5] Address...
A – Command Line Interface Set Setup Command Table A-25. SNMP Configuration Settings (Continued) Entry TrapCommunity AuthFailureTrap ProxyEnabled system Prompts you in a line-by-line fashion to change system configuration settings. Table A-26 describes the system configuration fields. For each parameter, enter a new value or press the Enter key to accept the current value shown in brackets.
Page 261
Table A-26. System Configuration Settings (Continued) Entry LocalLogEnabled RemoteLogEnabled RemoteLogHostAddress NTPClientEnabled NTPServerAddress EmbeddedGUIEnabled 59097-01 A A – Command Line Interface Description Enables (True) or disables (False) the saving of log information on the switch. The default is True. Enables (True) or disables (False) the recording of the switch event log on a remote host that supports the syslog protocol.
Page 262
A – Command Line Interface Set Setup Command Examples The following is an example of the Set Setup RADIUS command: SANbox Manager (admin) #> set setup radius A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the attributes for the server being processed, press 'q' or 'Q' and the ENTER key to do so.
Page 263
The following is an example of the Set Setup SNMP command: SANbox Manager #> admin start SANbox Manager (admin) #> set setup snmp A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. If you wish to terminate this process before reaching the end of the list press 'q' or 'Q' and the ENTER key to do so.
Page 264
A – Command Line Interface Set Setup Command The following is an example of the Set Setup System command: SANbox Manager (admin) #> set setup system A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current value. 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.
Show Command Displays fabric, switch, and port operational information. Authority None Syntax show about alarm [option] audit broadcast chassis cimlistener [listener_name] cimsubscription [subscription_name] config [option] domains donor fabric fdmi [port_wwn] interface log [option] lsdb mem [count] ns [option] pagebreak perf [option] port [port_number] post log setup [option]...
Page 266
A – Command Line Interface Show Command alarm [option] Displays the alarm log and session display setting. If you omit [option], the command displays the last 200 alarm entries. The alarm log is cleared when the switch is reset or power cycled. [option] has the following value: setting Displays the status of the parameter that controls the display of alarms in the session output stream.
Page 267
log [option] Displays log entries. Refer to the is cleared when the switch is reset or power cycled. lsdb Displays Link State database information mem [count] Displays information about memory activity for the number of seconds given by [count]. If you omit [count], the value 1 is used. Displayed memory values are in 1K block units.
A – Command Line Interface Show Command port [port_number] Displays operational information for the port given by [port_number]. Ports are numbered beginning with 0. If [port number] is omitted, information is displayed for all ports. Table A-27 Entry AIinit AIinitError Bad Frames ClassXFramesIn ClassXFramesOut...
Page 269
Entry LIP_F8_AL_PS LIP_F7_F7 LIP_F8_F7 Link Failures Login Logout LoopTimeouts LossOfSync PrimSeqErrors RxLinkResets RxOfflineSeq TotalErrors TotalLIPsRecvd TotalLIPsXmitd TotalLinkResets TotalOfflineSeq TotalRxFrames TotalRxWords 59097-01 A Table A-27. Show Port Parameters (Continued) This LIP denotes a loop failure detected by the L_Port identified by AL_PS. A loop initialization primitive frame used to acquire a valid AL_PA.
Page 270
A – Command Line Interface Show Command Entry TotalTxFrames TotalTxWords TxLinkResets TxOfflineSeq post log Displays the Power On Self Test (POST) log which contains results from the most recently failed POST. setup [option] Displays setup attributes for the system, SNMP, and the switch manufacturer. Refer to the ”Show Setup Command”...
Page 272
A – Command Line Interface Show Command Table A-28. Switch Operational Parameters (Continued) Parameter BeaconOnStatus OperationalState PrincipalSwitchRole BoardTemp (1) - Degrees Celsius SwitchDiagnosticsStatus SwitchTemperatureStatus timezone Displays the current time zone setting. topology Displays all connected devices. users Displays a list of logged-in users. This is equivalent to the User List command. version Displays an introductory set of information about operational attributes of the switch.
Page 273
The following is an example of the Show Domains command: SANbox Manager #> show domains Principal switch is (remote): 10:00:00:60:69:50:0b:6c Upstream Principal ISL is Domain ID List: Domain 97 Domain 98 Domain 99 Domain 100 (0x64) Domain 101 (0x65) Domain 102 (0x66) Domain 103 (0x67) Domain 104 (0x68) The following is an example of the Show Fabric command:...
Page 274
A – Command Line Interface Show Command The following is an example of the Show FDMI WWN command: SANbox Manager #> show fdmi 21:00:00:e0:8b:09:3b:17 FDMI Information ---------------- Manufacturer SerialNumber Model ModelDescription PortID NodeWWN HardwareVersion DriverVersion OptionRomVersion FirmwareVersion OperatingSystem MaximumCTPayload NumberOfPorts Port 21:01:00:e0:8b:27:aa:bc SupportedFC4Types...
Page 275
The following is an example of the Show NS [domain_ID] command: SANbox Manager #> show ns 18 Seq Domain --- ------ 18 (0x12) 120700 N The following is an example of the Show NS [port_ID] command: SANbox Manager #> show ns 1301e1 Port ID: 1301e1 -------- PortType...
Page 276
A – Command Line Interface Show Command The following is an example of the Show Port command: SANbox Manager #> show port 1 Port Number: 1 ------------ AdminState AsicNumber AsicPort ConfigType DiagStatus EpConnState EpIsoReason IOStreamGuard LinkSpeed LinkState LoginStatus ALInit ALInitError BadFrames Class2FramesIn Class2FramesOut 0...
Page 277
------ ----- ------- 20:05:00:c0:dd:00:bd:ec 20:0a:00:c0:dd:00:bd:ec 59097-01 A A – Command Line Interface sw .108 100000c0dd00bc56 SANbox 5602 Vx.x.x.x-0 (day month date time year) 19 (0x13) 130000 Critical PowerUp Vx.x.x.0-2 (day month date time year) Vx.x.x.0-17 (day month date time year)
Page 278
A – Command Line Interface Show Command The following is an example of the Show Topology command for port 1: SANbox Manager Local Link Information ---------------------- PortNumber 1 PortID 650100 PortWWN 20:01:00:c0:dd:00:91:11 PortType Remote Link Information ----------------------- Device 0 NodeWWN 50:80:02:00:00:06:d5:38 PortType NL Description (NULL) IPAddress 0.0.0.0...
Page 279
MACAddress WorldWideName ChassisSerialNumber SymbolicName ActiveSWVersion ActiveTimestamp DiagnosticsStatus 59097-01 A A – Command Line Interface (CLISH) SANbox 5602 FC Switch 10.20.11.192 (use 'set setup system' to update) 00:c0:dd:00:71:ee 10:00:00:c0:dd:00:71:ed FAM033100024 SANbox Manager V5.0.x.x.xx.xx day month date time year Passed Show Command...
A – Command Line Interface Show Config Command Show Config Command Displays switch, port, alarm threshold, security, and zoning for the current configuration. Authority None Syntax show config port [port_number] security switch threshold zoning Keywords port [port_number] Displays configuration parameters for the port number given by [port_number]. Ports are numbered beginning with 0.
Page 281
MSEnabled NoClose IOStreamGuard VIEnabled PDISCPingEnable The following is an example of the Show Config Switch command: SANbox Manager #> show config switch Configuration Name: default ------------------- Switch Configuration Information -------------------------------- AdminState BroadcastEnabled InbandEnabled FDMIEnabled FDMIEntries DomainID DomainIDLock SymbolicName R_A_TOV E_D_TOV PrincipalPriority ConfigDescription ConfigLastSavedBy...
Page 282
A – Command Line Interface Show Config Command The following is an example of the Show Config Threshold command: SANbox Manager #> show config threshold Configuration Name: default ------------ Threshold Configuration Information ----------------------------------- ThresholdMonitoringEnabled CRCErrorsMonitoringEnabled RisingTrigger FallingTrigger SampleWindow DecodeErrorsMonitoringEnabled True RisingTrigger FallingTrigger SampleWindow...
Show Log Command Displays the contents of the log or the parameters used to create and display entries in the log. The log contains a maximum of 1200 entries. When the log reaches its entry capacity, subsequent entries overwrite the existing entries, beginning with the oldest.
Page 284
A – Command Line Interface Show Log Command Zoning Monitors zoning conflict events. display [filter] Displays log events on the screen according to the component or severity level filter given by [filter]. [filter] can be one of the following: Info Displays all informative events.
Page 285
Examples The following is an example of the Show Log Component command: SANbox Manager #> show log component Current settings for log ------------------------ FilterComponent The following is an example of the Show Log Level command: SANbox Manager #> show log level Current settings for log ------------------------ FilterLevel...
A – Command Line Interface Show Perf Command Show Perf Command Displays port performance in frames/second and bytes/second. If you omit the keyword, the command displays data transmitted (out), data received (in), and total data transmitted and received in frames/second and bytes per second. Authority None Syntax...
Page 287
[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. Examples The following is an example of the Show Perf command: SANbox Manager #>...
A – Command Line Interface Show Setup Command Show Setup Command Displays the current SNMP and system settings. Authority None Syntax show setup radius services snmp system Keywords Displays manufacturing information about the switch. radius Displays RADIUS server information. services Displays switch service status information.
Page 289
The following is an example of the Show Setup RADIUS command: SANbox Manager #> show setup radius Radius Information ------------------ DeviceAuthOrder UserAuthOrder TotalServers Server: 1 ServerIPAddress ServerUDPPort DeviceAuthServer UserAuthServer AccountingServer Timeout Retries SignPackets Secret 59097-01 A RadiusLocal RadiusLocal 10.20.11.8 1812 False True False...
Page 291
The following is an example of the Show Setup System command: SANbox Manager #> show setup system System Information ------------------ Eth0NetworkDiscovery Eth0NetworkAddress Eth0NetworkMask Eth0GatewayAddress AdminTimeout InactivityTimeout LocalLogEnabled RemoteLogEnabled RemoteLogHostAddress NTPClientEnabled NTPServerAddress EmbeddedGUIEnabled 59097-01 A A – Command Line Interface Static 10.20.11.32 255.255.252.0 10.20.8.254...
A – Command Line Interface Shutdown Command Shutdown Command Terminates all data transfers on the switch at convenient points and closes the Telnet session. Always power cycle the switch after entering this command. Authority Admin session Syntax shutdown Notes Always use this command to perform an orderly shut down before removing power from the switch.
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 changing the port administrative state. While the test is running, the remaining ports on the switch remain fully operational.
Page 294
A – Command Line Interface Test Command Examples To run an internal or external port test, do the following: To start an admin session, enter the following command and press the Enter key. admin start Place the port in Diagnostics mode, enter the following command (x = port number) and press the Enter key.
Page 295
The online loopback (node-to-node) test requires that port be online and connected to a remote device. To run the online loopback test, do the following: To start an admin session, enter the following command and press the Enter key. admin start To run the online loopback test, enter the following command and press the Enter key.
A – Command Line Interface Uptime Command Uptime Command Displays the elapsed up time since the switch was last reset and reset method. A hot reset or non-disruptive firmware activation does not reset the elapsed up time reported by this command. Authority None Syntax...
User Command Administers and displays user accounts. Authority Admin account name and an Admin session. The Accounts and List keywords are available to all account names without an Admin session. Syntax user accounts delete [account_name] edit list Keywords accounts Displays all user accounts that exist on the switch. This keyword is available to all account names without an Admin session.
Page 298
A – Command Line Interface User Command Examples The following is an example of the User Accounts command: SANbox Manager (admin) #> user accounts Current list of user accounts ----------------------------- images (admin authority = False, never expires) admin (admin authority = True , never expires) chuckca (admin authority = False, expires in <...
Page 299
The following is an example of the User Delete command: SANbox Manager (admin) #> user del user3 The user account will be deleted. The following is an example of the User List command: SANbox Manager (admin) #> user list User ---- admin@OB-session1 admin@OB-session2...
A – Command Line Interface Whoami Command Whoami Command Displays the account name, session number, and switch domain ID for the Telnet session. Authority None Syntax whoami Examples The following is an example of the Whoami command: SANbox Manager #> whoami User name Switch name Switch domain ID: 21 (0x15)
Zone Command Manages zones and zone membership on a switch. Authority Admin session and a Zoning Edit session. Refer to the page A-133 for information about starting a Zoning Edit session. The List, Members, and Zonesets keywords are available without an Admin session. Syntax zone add [zone] [member_list]...
Page 302
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.
Page 303
Examples The following is an example of the Zone List command: SANbox Manager #> zone list Zone ZoneSet ------------------- wwn_b0241f zone_set_1 wwn_23bd31 zone_set_1 wwn_221416 zone_set_1 wwn_2215c3 zone_set_1 wwn_0160ed zone_set_1 wwn_c001b0 zone_set_1 wwn_401248 zone_set_1 wwn_02402f zone_set_1 wwn_22412f zone_set_1 The following is an example of the Zone Members command: SANbox Manager #>...
Page 304
A – Command Line Interface Zone Command The following is an example of the Zone Zonesets command: SANbox Manager #> zone zonesets zone1 Current List of ZoneSets for Zone: zone1 ---------------------------------- zone_set_1 A-130 59097-01 A...
Zoneset Command Manages zone sets and component zones across the fabric. Authority Admin session and a Zoning Edit session. Refer to the page A-133 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.
Page 306
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].
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-127 page A-131. Authority Admin session except for the Active, History, Limits, and List keywords. The Clear keyword also requires a zoning edit session.
A – Command Line Interface Zoning Command history Displays a history of zoning modifications. This keyword does not require an Admin session. History information includes the following: Time of the most recent zone set activation or deactivation and the user who performed it Time of the most recent modifications to the zoning database and the user who made them.
Page 309
Examples The following is an example of the Zoning Edit command: SANbox Manager #> admin start SANbox Manager (admin) #> zoning edit SANbox Manager (admin-zoning) #> SANbox Manager (admin-zoning) #> zoning cancel Zoning edit mode will be canceled. SANbox Manager (admin) #> admin end The following is an example of the Zoning Limits command: SANbox Manager #>...
Page 310
A – Command Line Interface Zoning Command The following is an example of the Zoning List command: SANbox Manager #> zoning list Active ZoneSet Information ZoneSet Zone -------------------------------- wwn_b0241f wwn_23bd31 wwn_221416 wwn_2215c3 Configured Zoning Information ZoneSet Zone -------------------------------- wwn_b0241f wwn_23bd31 wwn_221416 wwn_2215c3 A-136...
Page 311
Access Control List Zone Access Control List zoning divides the fabric for purposes of controlling discovery and inbound traffic. Active Zone Set The zone set that defines the current zoning for the fabric. Active Firmware The firmware image on the switch that is in use.
Page 312
SANbox 5602 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. Configured Zone Sets The zone sets stored on a switch excluding the active zone set.
Page 313
Management Workstation PC workstation that manages the fabric through the fabric management switch. 59097-01 A SANbox 5602 Switch Management Mesh Topology A fabric in which each chassis has at least one port directly connected to each other chassis in the fabric.
Page 314
SANbox 5602 Switch Management User’s Guide Small Form-Factor Pluggable A transceiver device, smaller than a GigaBit Interface Converter, that plugs into the Fibre Channel port. SNMP Simple Network Management Protocol Soft Zone Soft zoning divides the fabric for purposes of controlling discovery. Members of the...
Page 315
access control list zone 3-40, 3-56 account name display A-123, A-126 factory A-2 active zone set 3-34, 3-40 Active Zoneset data window 3-34 Admin account name A-7 authority A-7 Admin command A-8 Admin session timeout A-86 administrative state configured 4-20, 5-11 current 4-20, 5-11 port 5-11, A-80 switch 4-20, A-60...
Page 317
5-21 auto save 5-22 open 2-16, 3-23 password 5-19 save 2-16, 3-24 59097-01 A SANbox 5602 Switch Management faceplate display data window 2-30 description 2-19, 2-28 factory defaults 4-39, A-45 FC-4 descriptor 5-14 FDMI - See Fabric Device Management...
Page 318
SANbox 5602 Switch Management User’s Guide group add member 3-15, A-26 copy A-28 create 3-13, A-28 display 3-17 display member 3-17 edit member attributes 3-16, A-29 list A-30 list members A-30 Management Server A-28 remove 3-16 remove member 3-16, A-30...
Page 319
3-37 edit 3-37 export 3-37 import 3-38 node-to-node test 5-17 non-disruptive activation A-36 59097-01 A SANbox 5602 Switch Management Non-disruptive code load and activation 4-16 NTP - See Network Time Protocol online help 2-18 test 5-17 operating systems 2-2...
Page 320
SANbox 5602 Switch Management User’s Guide port administrative state 5-11, A-80 buffer credits 5-14 configuration 5-10, A-61 configuration defaults A-48 configuration display A-106 counters A-79 displaying information 5-1 external test A-119 group A-28 initialize A-45 internal test A-119 loopback test A-119...
Page 321
A-54 security edit session cancel A-53 initiate A-53 revert changes A-54 save changes A-54 59097-01 A SANbox 5602 Switch Management security set activate 3-18, A-57 add member group A-57 copy A-57 create 3-11, A-57 deactivate 3-18, A-57 delete A-58...
Page 323
3-42 working directory 2-16, 5-22 status indicator 2-24 workstation requirements 2-2 write community 4-31 59097-01 A SANbox 5602 Switch Management zone access control list 3-40 add member port 3-54, A-127 copy 3-50, A-127 create 3-53, A-127 definition 3-39 delete A-127...
Need help?
Do you have a question about the SANbox 5602 and is the answer not in the manual?
Questions and answers