About this guide This guide provides information about using the command line interface (CLI): • Logging on and off of a switch, opening and closing an Admin session, entering commands, getting help, paging a switch, setting page breaks, and loading and retrieving files. •...
Document conventions and symbols Table 1 Document conventions Convention Element Figure 1 Medium blue text: Cross-reference links and e-mail addresses Medium blue, underlined text Web site addresses (http://www.hp.com) Bold font • Key names that are pressed • Text typed into a GUI element, such as into a box •...
HP technical support Telephone numbers for worldwide technical support are listed on the HP support web site: http://www.hp.com/support/. Collect the following information before calling: • Technical support registration number (if applicable) • Product serial numbers • Product model names and numbers •...
Command line interface usage This section describes the following tasks: • Logging in to the switch through Telnet, page 15 • Opening and closing an admin session, page 16 • Entering commands, page 16 • Getting help, page 16 • Setting page breaks, page 17 •...
Opening and closing an admin session The command line interface (CLI) performs monitoring and configuration tasks. Commands that perform monitoring tasks are available to all user accounts. Commands that perform configuration tasks are available only after entering the admin start command to open an Admin session. A user account must have Admin authority to enter the admin start command.
Setting page breaks Some display commands deliver so much information to the screen that it scrolls by too quickly to read it. You can limit the display to 20 lines at a time by turning on page breaks. By default, page breaks are turned off.The following is an example of how to turn page breaks on and how it affects the display.
The following example creates a support file and sends it to a remote host using a workstation with an FTP server. 8/20q FC Switch #> 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 Enter remote directory name: bin/support...
Page 19
You can upload firmware image files or backup configuration files to the switch to reinstall firmware or restore a corrupted configuration. The switch uses FTP to exchange files between the switch and the workstation. To download a file from the switch to the workstation: Enter the ftp command and the switch IP address or symbolic name.
User account configuration User accounts and their respective passwords are the first line of switch security. A user account consists of an account name, an authority level, and an expiration date. Switches come from the factory with certain user accounts defined for special purposes. Table 3 describes these accounts, their passwords, and their purpose.
Creating user accounts A user account consists of an account name, an authority level, and an expiration date, which have the following requirements: • The account name can be up to 15 characters: the first character must be alphanumeric; the remaining characters must be American Standard Code for Information Interchange (ASCII) characters except semicolon (;), comma (,), #, and period (.).
Page 23
In the following example, the admin user account changes the password for the user account named user2. 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #> passwd user2 Press 'q' and the ENTER key to abort this command. account OLD password : ******** account NEW password (8-20 chars)
Network and fabric configuration The switch network configuration consists of the following parameters: • Network discovery method • IP address • Subnet mask • IP gateway address The network discovery method determines how the switch acquires its IP address. The IP address can come from the IP address that resides on the switch or from a server.
Displaying name server information The show ns command displays the list of worldwide names (WWNs) in the fabric, as shown in the following example: 8/20q FC Switch #> show ns all Seq Domain Port Port Type COS PortWWN NodeWWN --- ------ ------ ---- --- ------- ------- No entries found for domain ID 1.
The show setup system command displays the switch network configuration, as shown in the following example: 8/20q FC Switch #> show setup system System Information ------------------ EthNetworkEnable True EthNetworkDiscovery Static EthNetworkAddress 10.20.11.32 EthNetworkMask 255.255.252.0 EthGatewayAddress 10.20.8.254 AdminTimeout InactivityTimeout LocalLogEnabled True RemoteLogEnabled False RemoteLogHostAddress...
Switch operational information The show switch command displays a variety of switch operational information. These include the switch WWN, domain ID, firmware version, administrative state, and operational state, as shown in the following example: 8/20q FC Switch #> show switch Switch Information ------------------ SymbolicName...
System process information The ps command displays system process information to help you determine what processes are running and central processing unit (CPU) usage. The column titles in the following example are: • PID—Process identifier • PPID—Parent process identifier • %CPU—Percentage CPU usage •...
Switch configuration parameters To display the switch configuration parameters, enter the show config switch command. These parameters determine the operational characteristics of the switch. See Table 29 for descriptions these parameters. 8/20q FC Switch #> show config switch Configuration Name: default ------------------- Switch Configuration Information --------------------------------...
Security configuration parameters To display security configuration and port binding parameters, enter the show config security command. These parameters determine how security is applied to the switch. See Table 27 for descriptions of the switch security configuration parameters. See Table 28 for descriptions of the port binding parameters.
Hardware information To display the status of the switch hardware, including fans, power supplies, internal temperature, and Heartbeat LED status, enter the show chassis command. The following is an example of the show chassis command: 8/20q FC Switch #> show chassis Chassis Information ------------------- BoardTemp (1) - Degrees Celsius...
Managing switch services You can configure your switch to suit the demands of your environment by enabling or disabling a variety of switch services using the set setup services commands. To display the status of the switch services, use the show setup services command. See Table 41 for descriptions of the switch services setttings.
Page 36
To configure the switch services, enter the set setup services command in an Admin session, as shown in the following example: 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #> set setup services 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.
Managing switch configurations The switch configuration determines the basic operational characteristics of the switch. A switch can store up to 10 configurations, including the default configuration (Default Config). The current switch operating characteristics are determined by the active configuration. Only one configuration can be active at a time.
Modifying a switch configuration To modify a switch configuration, you must open an Admin session with the admin start command. The Admin session prevents other accounts from making changes at the same time through Telnet, Simple SAN Connection Manager, or any other management application. You must also open a Config Edit session with the config edit command and indicate which configuration you want to modify.
Backing up and restoring a switch configuration Successful management of switches and fabrics depends on the effective use of switch configurations. Backing up and restoring a switch configuration is useful both to protect your work and to use the configuration as a template. Backing up and restoring the switch configuration involves the following tasks: •...
The restore process replaces all configuration information on the switch and afterwards the switch is automatically reset. If the restore process changes the IP address, all management sessions are terminated. Use the set setup system command to return the IP configuration to the values you want. To restore the switch, open a Telnet session (a new IP address may be required), then enter the config restore command from in an Admin session, as shown in the following example: 8/20q FC Switch #>...
Setting the date and time explicitly To set the switch date and time explicitly, use the set timezone and date commands. To change the time zone (to Americal/North Dakota, for example), enter the set timezone command in an Admin session, as shown in the following example: 8/20q FC Switch #>...
Setting the time through an NTP server An NTP server can automatically set the switch date and time. To configure the switch to use an NTP server, enter the set setup system command in an Admin session to enable the NTP client on the switch and specify the NPT server IP address, as shown in the following example: 8/20q FC Switch #>...
Installing firmware New firmware becomes available periodically either on CD-ROM or from the HP web site. Installing firmware on a switch involves the following steps: Downloading the firmware image file to the switch. Unpacking the firmware image file. Activating the new firmware. The activation can be disruptive or non-disruptive. See ”Non-disruptive activation”...
One-step firmware installation The firmware install and image install commands download the firmware image file from an FTP or Trivial File Transfer Protocol (TFTP) server to the switch, unpack the image file, and perform a disruptive activation all in one step. The one-step installation process prompts you to enter the following information: •...
Custom firmware installation A custom firmware installation downloads the firmware image file from a remote host to the switch, unpacks the image file, and resets the switch in separate steps. This allows you to choose the type of switch reset and whether the activation will be disruptive (reset switch command) or non-disruptive (Hotreset command).
Online tests for switches An online test is a non-disruptive test that exercises port-to-device connections for all ports that are online. The following is an example of an online test: 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #> test switch online A list of attributes with formatting and current values will follow.
The following example performs an internal connectivity test on a switch: 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #> set switch state diagnostics 8/20q FC Switch (admin) #> test switch connectivity internal A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the default value.
Managing switch feature upgrades The HP StorageWorks 8/20q 4-port Upgrade License enables additional Fibre Channel (FC) ports in four port increments up to the 20-port maximum. Installing a feature license key is not disruptive, nor does it require a switch reset. To order a license key, contact your switch distributor or your authorized reseller. TIP: To obtain the switch serial number and license key, follow the step-by-step instructions on the firmware feature entitlement request certificate for the license key.
Port configuration This section describes the following topics: • Displaying port information, page 49 • Modifying port operating characteristics, page 53 • Port binding, page 54 • Resetting a port, page 55 • Configuring port threshold alarms, page 55 • Testing a port, page 57 Displaying port information You can display the following port information:...
Port operational information To display port operational information, enter the show port command. 8/20q FC Switch #> show port 1 Port Number: 1 ------------ AdminState Online OperationalState Offline AsicNumber PerfTuningMode Normal AsicPort PortID 3a0100 ConfigType PortWWN 20:01:00:c0:dd:0d:4f:08 POSTFaultCode 00000000 RunningType Unknown POSTStatus Passed...
Port threshold alarm configuration parameters To display the port threshold alarm parameters, enter the show config threshold command. These parameters determine the error thresholds at which the switch issues alarms. See Table 30 for descriptions of these parameters. 8/20q FC Switch #> show config threshold Configuration Name: default ------------ Threshold Configuration Information...
Port performance To display port performance in terms of the volume of data transmitted, data received, or errors, enter the show perf command . You can display continuous live performance information for one or more ports, or an instantaneous summary. The following example displays an instantaneous summary in bytes and frames.
Modifying port operating characteristics You can make permanent or temporary changes to port operating characteristics. The set config port command makes permanent port configuration changes. These changes are saved in the active configuration and are preserved across switch or port resets. The set port command makes temporary changes that apply until the next port or switch reset, or until you activate a configuration.
Port binding Port binding establishes up to 32 switches or devices that are permitted to log in to a particular switch port. Switches or devices that are not among the established 32 are refused access to the port. To display the port binding configuration for all ports, enter the show config security portbinding command, as shown in the following example: 8/20q FC Switch #>...
Resetting a port To reinitialize one or more ports and to discard any temporary changes that have been made to the administrative state or link speed, enter the reset port command. The following example reinitializes port 1: 8/20q FC Switch #> reset port 1 Configuring port threshold alarms The switch can monitor a set of port errors and generate alarms based on user-defined sample windows and thresholds.
Page 56
To enable and configure port threshold monitoring on the switch, enter the set config threshold command: 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #> config edit 8/20q FC Switch (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.
Testing a port You can test a port using the test port command using online or offline tests. The following sections describe the test types, displaying test results, and cancelling a test: • Online tests for ports, page 57 • Offline tests for ports, page 58 •...
Offline tests for ports An offline test is a disruptive test that exercises the port connections. You must place the port in the diagnostics state using the set port command before starting the test. There are two types of offline test: internal loopback and external loopback.
Zoning configuration This section describes the following tasks: • Displaying zoning database information, page 59 • Configuring the zoning database, page 65 • Modifying the zoning database, page 67 • Saving the active and merged zone sets, page 67 • Resetting the zoning database, page 68 •...
Configured zone set information The zoneset list and the zoning list commands display information about all zone sets in the non-volatile zoning database. To display a list of the zone sets, enter the zoneset list command, as shown in the following example: 8/20q FC Switch #>...
Active zone set information The zoning list and zoneset active commands display information about the active zone set. To display component zones and zone members, enter the zoning active command, as shown in the following example: 8/20q FC Switch #> zoning active Active (enforced) ZoneSet Information ZoneSet Zone...
Merged zone set information A merged zone set is a zone set that is received from another switch as a result of a change to the active zone set. You can display the merged zone set on your switch if the MergeAutoSave parameter is set to False.
To display the zones and the zone sets to which they belong, enter the zone list command, as shown in the following example: 8/20q FC Switch #> zone list Zone ZoneSet ---- ------- wwn_b0241f zone_set_1 wwn_23bd31 zone_set_1 wwn_221416 zone_set_2 wwn_2215c3 zone_set_2 wwn_0160ed zone_set_3...
Alias and alias membership information The alias list and alias members commands display information about aliases. To display a list of all aliases, enter the alias list command, as shown in the following example: 8/20q FC Switch #> alias list Current list of Zone Aliases ---------------------------- alias1...
Zoning database limits To display a summary of the objects in the zoning database and their maximum limits, enter the zoning limits command, as shown in the following example: 8/20q FC Switch #> zoning limits Configured (saved in NVRAM) Zoning Information Zoning Attribute Maximum Current...
Page 66
If MergeAutoSave is False on a switch, and a new zone set is activated elsewhere in the fabric or a fabric merge occurs, you can choose how to dispose of the merged zone set: • To display the merged zone set, enter the zoning merged command. •...
Modifying the zoning database To modify the non-volatile zoning database: Enter the admin start command. 8/20q FC Switch #> admin start An Admin session prevents other accounts from making changes at the same time through Telnet, QuickTools, or any other management application. Take one of the following actions: •...
Resetting the zoning database There are two ways to remove all aliases, zones, and zone sets from the zoning database: • Enter the reset zoning command, as shown in the following example. This is the preferred method. 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #>...
Renaming a zone set To rename a zone set, enter the zoneset rename command, as shown in the following example: 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #> zoning edit 8/20q FC Switch (admin-zoning) #> zoneset rename zoneset_old zoneset_new 8/20q FC Switch (admin-zoning) #>zoning save Copying a zone set To copy a zone set and its contents to a new zone set, enter the zoneset copy command, as shown in...
Creating a zone To create a new zone, enter the zone create command, as shown in the following example: 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #> zoning edit 8/20q FC Switch (admin-zoning) #> zone create zone_1 8/20q FC Switch (admin-zoning) #>...
Managing aliases Managing aliases consists of the following tasks: • Creating an alias, page 71 • Deleting an alias, page 71 • Renaming an alias, page 71 • Copying an alias, page 71 • Adding members to an alias, page 71 •...
Removing members from an alias To remove ports/devices from alias_1, enter the alias remove command, as shown in the following example: 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #> zoning edit 8/20q FC Switch (admin-zoning) #> alias remove alias_1 1,4 1,5 8/20q FC Switch (admin-zoning) #>...
To manage both SSH and SSL services, enter the set setup services command, as shown in the following example: 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #> set setup services 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.
Creating an SSL security certificate Enabling SSL automatically creates a security certificate on the switch. The security certificate is required to establish an SSL connection with a management application such as Simple SAN Connection Manager or QuickTools. The certificate is valid 24 hours before the certificate creation date and expires 365 days after the creation date.
To display all security sets, groups, and group members in the security database, enter the security list command, as shown in the following example: 8/20q FC Switch #> security list Active Security Information SecuritySet Group GroupMember ----------- ----- ----------- No active securityset defined. Configured Security Information SecuritySet Group...
To display the name of the active security set and its activation history, enter the securityset active command, as shown in the following example: 8/20q FC Switch #> securityset active Active SecuritySet Information ------------------------------ ActiveSecuritySet alpha LastActivatedBy Remote LastActivatedOn day month date time year Security set membership information The securityset groups and group securitysets commands display security set membership information.
Security database modification history To display a record of security database modifications, enter the security history command, as shown in the following example: 8/20q FC Switch #> security history Active Database Information --------------------------- SecuritySetLastActivated/DeactivatedBy Remote SecuritySetLastActivated/DeactivatedOn day month date time year Database Checksum 00000000 Inactive Database Information...
Configuring the security database You can configure how the security database is applied to the switch and exchanged with the fabric through the security configuration parameters. The following security configuration parameters are available through the set config security command: • AutoSave—This parameter enables or disables the saving of changes to active security set in the switch’s non-volatile security database.
Modifying the security database To modify the security database: Open an Admin session with the admin start command. 8/20q FC Switch #> admin start An Admin session prevents other accounts from making changes at the same time either through Telnet, QuickTools, or Simple SAN Connection Manager.
Deleting a security set To delete a security set, enter the securityset delete command, as shown in the following example: 8/20q FC Switch (admin-security) #> securityset delete securityset_1 Renaming a security set To rename a security set. enter the securityset rename command, as shown in the following example: 8/20q FC Switch (admin-security) #>...
Creating a group Creating a group involves specifying a group name and a group type. There are three types of groups: • ISL group—secures connected switches • Port group—secures connected devices • MS group—secures management server commands To create a new port group, enter the group create command, as shown in the following example: 8/20q FC Switch (admin-security) #>...
Modifying a group member Modifying a group member involves changing the member attributes. The member attributes define the authentication method, encryption methods, secrets, and fabric binding, depending on the group type. • For ISL member attributes, see Table • For Port member attributes, see Table •...
RADIUS server configuration Authentication can be performed locally using the switch’s security database, or remotely using a Remote Dial-In User Service (RADIUS) server such as Microsoft RADIUS. With a RADIUS server, the security database for the entire fabric resides on the server. In this way, the security database can be managed centrally, rather than on each switch.
Configuring a RADIUS server on the switch To configure a RADIUS server on the switch, enter the set setup radius command, as shown in the following example. See Table 40 for a description of the RADIUS server configuration parameters. 8/20q FC Switch (admin) #> set setup radius A list of attributes with formatting and current values will follow.
Displaying the event log To display the event log, enter the show log command. Each log message has the following format: [ordinal][time_stamp][severity][message_ID][source][message_text] Table 6 describes the message format components. Table 6 Event log message format Component Description A number assigned to each message in sequence since the last time the alarm history was [ordinal] cleared.
Filtering the event log display You can customize which events are displayed according to either the component or the severity level. To filter the events in the display, enter the show log display command. You can choose from the following severity levels and component events: •...
The following example configures the event log to record switch management events with warning and critical severity levels associated with ports 0–3. Entering the set log save command ensures that this configuration is preserved across switch resets. 8/20q FC Switch (admin) #> set log component switch 8/20q FC Switch (admin) #>...
To control local logging (LocalLogEnabled parameter) and remote logging (RemoteLogEnabled and RemoteLogHostAddress parameters), enter the set setup system command in an Admin session, as shown in the following example: 8/20q FC Switch (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.
Call Home configuration NOTE: The 8/20q Fibre Channel Switch Call Home service provides an e-mail notification capability for the switch. This service has no relationship with the HP Call Home feature, which notifies HP services. This section describes the following topics: •...
Call Home messages The Call Home service generates e-mail messages for the specified event severity level and the following switch actions: • Switch comes online • Switch goes offline • Reboot • Power up • Power down • SFP failure NOTE: For a power-down event, if the switch is forced to power down before the message is sent to the SMTP server, no message will be transmitted.
Page 97
The following is an example of a full-text e-mail, including profile and SNMP contact information: From: john.doe@work.com [mailto:john.doe@work.com] Sent: Wednesday, July 25, 2007 5:03 PM Subject: [CallHome: Test] Alarm generated on Switch_8 ------------ Event Details SwitchName: Switch_8_83.215 SwitchIP: 10.20.30.40 SwitchWWN: 10:00:00:c0:dd:0c:66:f2 Level: Alarm...
Configuring the Call Home service To configure the Call Home service, enter the set setup callhome command in an Admin session, as shown in the following example. See Table 39 for a description of the Call Home service configuration entries. 8/20q FC Switch (admin) #>...
To display the Call Home service configuration, enter the show setup callhome command, as shown in the following example. 8/20q FC Switch (admin) #> show setup callhome Callhome Information -------------------- PrimarySMTPServerAddr 0.0.0.0 PrimarySMTPServerPort PrimarySMTPServerEnabled False SecondarySMTPServerAddr 0.0.0.0 SecondarySMTPServerPort SecondarySMTPServerEnabled False ContactEmailAddress nobody@localhost.localdomain PhoneNumber...
Displaying Call Home database information You can display the following Call Home database information: • Change history • List of profiles • List of profiles and their details • E-mail messages in the Call Home queue To display the Call Home data base change history information, enter the callhome history command, as shown in the following example: 8/20q FC Switch #>...
Page 101
To display a list of Call Home profiles and their details, enter the callhome list profile command, as shown in the following example: 8/20q FC Switch #> callhome list profile ProfileName: group4 ------------ Level Warn Format FullText MaxSize any size up to max of 100000 EmailSubject CallHome Warn RecipientEmail...
Creating a profile To create a Call Home profile, enter the profile create command, as shown in the following example: 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #> callhome edit 8/20q FC Switch (admin-callhome) #> profile create profile_1 A list of attributes with formatting and default values will follow.
Modifying a profile To modify an existing Call Home profile, enter the profile edit command, as shown in the following example: 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #> callhome edit 8/20q FC Switch (admin-callhome) #> profile edit profile_1 A list of attributes with formatting and current values will follow.
Testing a Call Home profile To test a Call Home profile, enter the callhome test profile command, as shown in the following example. This command generates a test message and routes it to the e-mail recipients specified in the profile. 8/20q FC Switch #>...
Simple Network Management Protocol configuration This section describes the following tasks: • Managing the SNMP service, page 105 • Displaying SNMP information, page 106 • Modifying the SNMP configuration, page 107 • Resetting the SNMP configuration, page 107 The Simple Network Management Protocol (SNMP) provides for the management of the switch through third-party applications that use SNMP.
Displaying SNMP information To display SNMP configuration information, enter the show setup snmp command, as shown in the following example. See Table 42 for a description of the SNMP parameters. 8/20q FC Switch #> show setup snmp SNMP Information ---------------- SNMPEnabled True Contact...
Modifying the SNMP configuration To modify the SNMP configuration, enter the set setup snmp command in an Admin session, as shown in the following example. See Table 42 for SNMP parameters descriptions. 8/20q FC Switch (admin) #> set setup snmp A list of attributes with formatting and current values will follow.
Command reference This section provides an alphabetical listing of the commands of the CLI and provides the following information for each command: • Access authority, page 109 • Syntax and operands, page 109 • Notes and examples, page 109 Access authority The Authority paragraph in each command description indicates what types of sessions are required to enter that command.
admin Description Opens and closes an Admin session. The Admin session provides access to 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 specified period of time, which is changed using the set setup system command.
alias Description 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 and Zoning Edit session for all operands except list and members Syntax alias add [alias] [member_list]...
Page 112
Examples The following is an example of the alias list command: 8/20q FC Switch #> alias list Current list of Zone Aliases ---------------------------- alias1 alias2 The following is an example of the alias members command: 8/20q FC Switch #> alias members alias1 Current list of members for Zone Alias: alias1 --------------------------------------- 50:06:04:82:bf:d2:18:c4...
callhome Description Opens a Callhome Edit session in which to create and manage Call Home profiles. NOTE: The 8/20q Fibre Channel Switch Call Home service provides an e-mail notification capability for the switch. This service has no relationship with the HP Call Home feature, which notifies HP services.
queue [option] Clears the Call Home e-mail queue or displays Call Home e-mail queue statistics depending on the value of [option]. The Call Home queue statistics parameters are described in Table 7 Table 7 Call Home queue statistics parameters Parameter Description Clears the Call Home e-mail queue.
Page 115
The following is an example of the callhome list profile command: 8/20q FC Switch #> callhome list profile ProfileName: group4 ------------ Level Warn Format FullText MaxSize any size up to max of 100000 EmailSubject CallHome Warn RecipientEmail admin1@company.com RecipientEmail admin2@company.com RecipientEmail admin3@company.com RecipientEmail...
config Description Manages the Fibre Channel configurations on a switch. Authority Admin session for all operands except backup and list Syntax config activate [config_name] backup export cancel copy [config_source] [config_destination] delete [config_name] edit [config_name] export [account_name] [ip_address] [file_name] import [account_name] [ip_address] [file_name] list restore import save [config_name]...
Page 117
restore import Restores configuration settings to the switch from a configuration backup file named configdata. You can create a backup file using the config backup command. Typically, you would upload this backup file from a server using FTP. The optional import operand imports the backup file from a remote server, prompting you for an account name, server IP address, configuration file name on the server, and a password if the server requires one.
Page 118
The following is an example of how to upload a configuration backup file (configdata) from the workstation to the switch and then restore the configuration. #> ftp symbolic_name or ip_address user: images password: images ftp> bin ftp> put configdata ftp> quit 8/20q FC Switch #>...
create Description Creates support files for troubleshooting switch problems, and certificates for secure communications for Simple SAN Connection Manager, QuickTools, and SMI-S. Authority Admin session for the certificate operand Syntax create certificate support Operands certificate Creates a security certificate on the switch. The security certificate is required to establish an SSL connection with a management application such as Simple SAN Connection Manager.
Page 120
The following is an example of the create support command to download the support file to your workstation. When prompted to send the support file to another machine, you decline, close the Telnet session, and open an FTP session on the switch and log in with the account name images and password images.
date Description Displays or sets the system date and time. To set the date and time, the information string must be provided in this format: MMDDhhmmCCYY. The new date and time takes effect immediately. Authority Admin session except to display the date. Syntax date [MMDDhhmmCCYY]...
exit Description Closes the switch connection. Authority None Syntax exit Notes You can also press Control-D to close the switch connection. 122 Command reference...
feature Description 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 operand only Syntax feature...
firmware install Description Downloads firmware from a remote host to the switch, installs the firmware, then resets the switch to activate the firmware. This is disruptive. The command prompts you for the following: • The file transfer protocol (FTP or TFTP) •...
Page 125
The following is an example of the firmware install command using TFTP: 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #> firmware install The switch will be reset. This process will cause a disruption to I/O traffic. Continuing with this action will terminate all management sessions, including any Telnet sessions.
group Description Creates groups, manages membership within the group, and manages the membership of groups in security sets. Authority Admin session and a Security Edit session. For information about starting a Security Edit session, see the security command. The list, members, securitysets, and type operands are available without an Admin session.
Table 8 ISL group member attributes (Continued) Attribute Description Hex string that is encrypted by the secondary hash and sent for SecondarySecret authentication. The string has the following lengths, depending on the secondary hash function: • MD5 hash: 16-byte • SHA- 1 hash: 20-byte Domain ID of the switch to which to bind the ISL group member WWN.
Table 10 MS group member attributes (Continued) Attribute Description The hash function to use to decipher the encrypted secret sent by the MS Hash group member. Hash values are MD5 or SHA-1. Hexadecimal string that is encrypted by the hash function for Secret authentication with MS group members.
Page 129
Table 12 Group member attributes (Continued) Attribute Description Hexadecimal string that is encrypted by the primary hash for PrimarySecret authentication with the member. The string has the following lengths (ISL and Port Groups) depending on the primary hash function: • MD5 hash: 16-byte •...
Page 130
Examples The following is an example of the group add command: 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #> security edit 8/20q FC Switch (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 131
The following is an example of the group members command: 8/20q FC Switch #> group members group_1 Current list of members for Group: group_1 ---------------------------------- 10:00:00:c0:dd:00:71:ed 10:00:00:c0:dd:00:72:45 10:00:00:c0:dd:00:90:ef 10:00:00:c0:dd:00:b8:b7 See also security, page 154 8/20q Fibre Channel Switch command line interface guide 131...
hardreset Description Resets the switch and performs a power-on self test (POST). This reset disrupts I/O traffic, activates the pending firmware, and clears the alarm log. To save the alarm log before resetting, see the set log command. Authority Admin session Syntax hardreset Notes To reset the switch without a power-on self test, see the reset command.
help Description Displays a brief description of the specified command, its operands, and usage. Authority None Syntax help [command] [operand] Operands [command] Displays a summary of the command given by [command] and its operands. If you omit [command], the system displays all available commands. [operand] Displays a summary of the operand given by [operand] belonging to the command given by [command].
history Description 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]. •...
hotreset Description Resets the switch for the purpose of activating the pending firmware without disrupting traffic. This command terminates all management sessions, saves all configuration information, and clears the event log. After the pending firmware is activated, the configuration is recovered. This process may take a few minutes.
image Description Manages and installs switch firmware. Authority Admin session Syntax image cleanup fetch [account_name] [ip_address] [file_source] [file_destination] install list tftp [ip_address] [file_source] [file_destination] unpack [file] Operands cleanup Removes all firmware image files from the switch. All firmware image files are removed automatically each time the switch is reset.
Page 137
Examples The following is an example of the image install command: 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #> image install Warning: Installing new firmware requires a switch reset. Continuing with this action will terminate all management sessions, including any Telnet sessions.
Description Reinitializes the specified loop port. Authority Admin session Syntax lip [port_number] Operands [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: 8/20q FC Switch (admin) #> lip 2 138 Command reference...
logout Description Closes the switch connection. Authority None Syntax logout Notes You can also press Control-D to close the switch connection. See also exit, page 122 logout, page 139 8/20q Fibre Channel Switch command line interface guide 139...
passwd Description Changes a user account’s password. Authority Admin account name and an Admin session to change another account’s password; you can change your own password without an Admin session. Syntax passwd [account_name] Operands [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.
ping Description Initiates an attempt to communicate with another switch over an Ethernet network and reports the result. Authority None Syntax ping [ip_address] Operands [ip_address] The IP address of the switch you want to query. Broadcast IP addresses, such as 255.255.255.255, are not valid.
profile Description Creates and modifies profiles with which to customize Call Home e-mail notification. A profile defines the event severity level at which to generate e-mails, e-mail subject and text, and e-mail recipients. NOTE: The Call Home service provides an e-mail notification capability for the switch. This service has no relationship with the HP Call Home feature, which notifies HP services.
Page 143
Operands delete [profile] Deletes the specified profile given by [profile] from the Call Home database. You must enter the callhome save command to save your changes. edit [profile] Opens an edit session in which to change the configuration of an existing profile given by [profile].
Page 144
The following is an example of the profile edit command: 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #> callhome edit 8/20q FC Switch (admin-callhome) #> profile edit profile_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 145
Description Displays current system process information. Authority None Syntax Examples The following is an example of the ps command: 8/20q FC Switch #> ps PPID %CPU %MEM TIME ELAPSED COMMAND 0.3 00:00:04 2-03:02:31 cns 0.3 00:00:06 2-03:02:31 ens 0.3 00:00:09 2-03:02:31 dlog 0.6 00:00:33 2-03:02:31 ds...
quit Description Closes the switch connection. Authority None Syntax quit Notes You can also press Control-D to close the switch connection. See also exit, page 122 logout, page 139 146 Command reference...
reset Description Resets the switch configuration parameters. If you omit the operand, the default is reset switch. Authority Admin session Syntax reset callhome config [config_name] factory port [port_list] radius security services snmp switch (default) system zoning Operands callhome Resets the Call Home database configuration to its default values. 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...
Page 148
switch Resets the switch without a power-on self test (POST). This is the default. This reset disrupts traffic and does the following: • Activates the pending firmware • Closes all management sessions • Clears the event log. To save the event log before resetting, see the ”set log”...
security Description Opens a Security Edit session in which to manage the security database on a switch. Authority Admin session. The operands active, history, limits, and list are available without an Admin session. Syntax security active cancel clear edit history limits list restore...
Page 155
restore Restores the volatile security database with the contents of the non-volatile security database. If the AutoSave parameter is False, you can use this operand to revert changes to the volatile security database that were propagated from another switch in the fabric through security set activation or merging fabrics.
Page 156
The following is an example of the security list command: 8/20q FC Switch #> security list Active Security Information SecuritySet Group GroupMember ----------- ----- ----------- No active securityset defined. Configured Security Information SecuritySet Group GroupMember ----------- ----- ----------- alpha group1 (ISL) 10:00:00:00:00:10:21:16 Authentication Chap...
securityset Description Manages security sets in the security database. Authority Admin session and a Security Edit session. For information about starting a Security Edit session, see the security command . The active, groups, and list operands are available without an Admin session.
Page 158
Examples The following is an example of the securityset active command 8/20q FC Switch #> securityset active Active SecuritySet Information ------------------------------ ActiveSecuritySet alpha LastActivatedBy Remote LastActivatedOn day month date time year The following is an example of the securityset groups command 8/20q FC Switch #>...
set alarm Description Controls the display of alarms in the session output stream or clears the alarm log. Authority Admin session for the clear operand. Otherwise, none. Syntax set alarm [option] Operands [option] Table 24 describes the output stream alarm parameters. Table 24 Output stream alarm parameters Parameter...
set beacon Description Enables or disables the flashing of the Logged-In LEDs for the purpose of locating a switch. Authority None Syntax set beacon [state] Operands [state] Table 25 describes the beacon state parameters. Table 25 Beacon state parameters Parameter Description Enables the flashing beacon.
set config port Description Sets the port configuration parameters for one or more ports. 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. Authority Admin session and a Config Edit session Syntax set config port [port_number]...
Page 162
Table 26 Port configuration parameters (Continued) Parameter Description Send ARB_FF (True) instead of IDLEs (False) on the loop. The default is ARB_FF False. Interoperability credit. The number of buffer-to-buffer credits per port. 0 InteropCredit means the default is unchanged. Default buffer-to-buffer credits are 16 per port.
Page 163
Examples The following is an example of the set config port command: 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #> config edit 8/20q FC Switch (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.
set config security Description Configures the security database for the automatic saving of changes to the active security set and fabric binding. 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. Authority Admin session and a Config Edit session Syntax set config security...
set config security portbinding Description Configures port binding. Authority Admin session and a Config Edit session Syntax set config security portbinding [port_number] Operands [port_number] Initiates an editing session in which to change the port binding configuration for the port given by [port_number].
set config switch Description Sets the switch 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. Authority Admin session and a Config Edit session Syntax set config switch This command initiates an editing session in which to change switch configuration settings.
Page 167
Examples The following is an example of the set config switch command: 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #> config edit 8/20q FC Switch (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.
set config threshold Description Sets the port alarm threshold parameters by which the switch monitors port performance and generates alarms. 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. Authority Admin session and a Config Edit session Syntax set config threshold...
Page 169
Examples The following is an example of the set config threshold command: 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #> config edit 8/20q FC Switch (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.
set config zoning Description Configures the zoning database. 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. Authority Admin session and a Config Edit session Syntax set config zoning Initiates an editing session in which to change the zoning database configuration.
set log Description 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 operands. You determine what events are automatically displayed on the screen using the display operand. Alarms are always displayed on the screen.
Table 33 Event display filter parameters Parameter Description Critical severity-level events. The critical level describes events that are generally Critical disruptive to the administration or operation of the fabric, but require no action. Warning severity-level events. The warning level describes events that are Warn generally not disruptive to the administration or operation of the fabric, but are more important than the informative-level events.
Page 173
restore Restores and saves the port, component, and level settings to the default values. save Saves the log settings for the component, severity level, port, and display level. These settings remain in effect after a switch reset. The log settings can be viewed using the show log settings command.
set pagebreak Description Specifies how much information is displayed on the screen at a time. This command is useful for disabling pagebreaks to allow command scripts to run without interruption. Authority None Syntax pagebreak [state] Operands [state] Table 36 describes the pagebreak state parameters. Table 36 Pagebreak state parameters Parameter...
set port Description 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 Syntax set port clear set port [port_number] clear speed [transmission_speed] state [state] Operands [port_number]...
set setup callhome Description Configures the Call Home database for managing e-mail notifications of fabric problems. Authority Admin session Syntax set setup callhome Prompts you in a line-by-line fashion to configure the Call Home database. Table 39 describes the Call Home configuration attributes. Table 39 Call Home service configuration attributes Parameter...
Page 177
Notes • The Callhome service must be active to support Call Home e-mail notification. See the set setup services command. • The primary, secondary, or both SMTP servers must be properly addressed and enabled on the switch to activate Call Home e-mail notification. If both SMTP servers are enabled, the primary server is active.
set setup radius Description Configures RADIUS servers on the switch. Authority Admin session Syntax set setup radius Prompts you in a line-by-line fashion to configure RADIUS servers for user account and device authentication. Table 40 describes the RADIUS server configuration attributes. Table 40 RADIUS service attributes Attribute...
Page 179
Table 40 RADIUS service attributes (Continued) Attribute Description Enable (True) or disable (False) the use of sign packets to protect the SignPackets RADIUS server packet integrity. The default is False. 22-byte ASCII string used as a password for authentication purposes Secret between the switch and the RADIUS server.
set setup services Description Configures services on the switch. Authority Admin session Syntax set setup services This command prompts you in a line-by-line fashion to enable or disable switch services. Table 41 describes the switch service parameters. For each parameter, enter a new value or press Enter to accept the current value shown in brackets.
Page 181
Table 41 Switch services settings (Continued) Parameter Description Enables (True) or disables (False) the management of the switch SNMPEnabled through third-party applications that use the Simple Network Management Protocol (SNMP). This parameter is the master control for the set setup snmp command parameter, SNMPEnabled. The default is True.
Page 182
Examples The following is an example of the set setup services command: 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #> set setup services 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 setup snmp Description Configures SNMP on the switch. Authority Admin session Syntax set setup snmp Prompts you in a line-by-line fashion to change SNMP configuration settings. Table 42 describes the SNMP configuration parameters. For each parameter, enter a new value or press Enter to accept the current value shown in brackets.
Page 184
Table 42 SNMP configuration settings (Continued) Parameter Description Enables (True) or disables (False) the generation of traps in response AuthFailureTrap to trap authentication failures. The default is False. Enables (True) or disables (False) SNMP communication with other ProxyEnabled switches in the fabric. The default is True. Examples The following is an example of the set setup snmp command: 8/20q FC Switch (admin) #>...
set setup system Description Configures the network, session, and logging settings on the switch. Authority Admin session Syntax set setup system Prompts you in a line-by-line fashion to change system configuration settings. Table 43 describes the system configuration parameters. For each parameter, enter a new value or press Enter to accept the current value shown in brackets.
Page 186
Table 43 System configuration settings (Continued) Parameter Description The IP address of the NTP server from which the NTP client NTPServerAddress acquires the time and date. The default is 10.0.0.254. Enables (True) or disables (False) the QuickTools management EmbeddedGUIEnabled application. Changing this parameter to False while QuickTools is running will terminate the application.
set switch state Description Changes the administrative state for all ports on the switch. The previous set config switch command settings are restored after a switch reset or a reactivation of a switch configuration. Authority Admin session Syntax set switch state [state] Operands [state] Table 44...
set timezone Description Specifies the time zone for the switch and the workstation. The default is Universal Time (UTC), also known as Greenwich Mean Time (GMT). This command prompts you to choose a region, then a subregion to specify the time zone. Changing the time zone converts the time to the time in the new time zone.
show about Description Displays introductory information about the operational attributes of the switch. This command is equivalent to the show version command. Authority None Syntax show about Table 45 describes the information returned by the show about command. Table 45 Show about display entries Attribute Description...
show alarm Description Displays the alarm log and session output stream display setting. Authority None Syntax show alarm settings Operands settings Displays the status of the parameter that controls the display of alarms in the session output stream. This parameter is set using the set alarm command. Notes The alarm log is cleared when the switch is reset or power-cycled.
show broadcast Description Displays the broadcast tree information and all ports that are currently transmitting and receiving broadcast frames. Authority None Syntax show broadcast Examples The following is an example of the show broadcast command: 8/20q FC Switch #> show broadcast Group Member Ports ISL Ports ----- ------------ --------- 8/20q Fibre Channel Switch command line interface guide 191...
show chassis Description Displays chassis component status and temperature. Authority None Syntax show chassis Examples The following is an example of the show chassis command. 8/20q FC Switch #> show chassis Chassis Information ------------------- BoardTemp (1) - Degrees Celsius PowerSupplyStatus (1) Good HeartBeatCode HeartBeatStatus...
show config port Description Displays configuration parameters for one or more ports. Authority None Syntax show config port [port_number] Operands [port_number] The number of the port. Ports are numbered beginning with 0. If you omit [port_number], all ports are specified. Examples The following is an example of the show config port command for port 3: 8/20q FC Switch #>...
show config security Description Displays the security database configuration parameters. Authority None Syntax show config security Examples The following is an example of the show config security command: 8/20q FC Switch #> show config security Configuration Name: default ------------------- Switch Security Configuration Information ----------------------------------------- FabricBindingEnabled False...
show config security portbinding Description Displays the port binding configuration for one or more ports. Authority None Syntax show config security portbinding [port_number] Operands [port_number] The number of the port. If you omit [port_number], the port binding configuration for all ports is displayed.
show config switch Description Displays the switch configuration parameters. Authority None Syntax show config switch Examples The following is an example of the show config switch command: 8/20q FC Switch #> show config switch Configuration Name: default ------------------- Switch Configuration Information -------------------------------- AdminState Online...
show config threshold Description Displays alarm threshold parameters for the switch. Authority None Syntax show config threshold Examples The following is an example of the show config threshold command: 8/20q FC Switch #> show config threshold Configuration Name: default ------------ Threshold Configuration Information ----------------------------------- ThresholdMonitoringEnabled...
show config zoning Description Displays zoning configuration parameters for the switch. Authority None Syntax show config zoning Examples The following is an example of the show config zoning command: 8/20q FC Switch #> show config zoning Configuration Name: default ------------------- Zoning Configuration Information -------------------------------- MergeAutoSave...
show domains Description Displays list of each domain and its WWN in the fabric. Authority None Syntax show domains Examples The following is an example of the show domains command: 8/20q FC Switch #> show domains Principal switch is (remote): 10:00:00:60:69:50:0b:6c Upstream Principal ISL is Domain ID List: Domain 97...
show donor Description Displays list of current donor and extended credit configuration for all ports. Authority None Syntax show donor Examples The following is an example of the show donor command: 8/20q FC Switch #> show donor Port Config Ext Credit Max Credit Donated Member of Valid Groups to Number Type...
show fabric Description Displays list of each domain, symbolic name, worldwide name, node IP address, and port IP address in the fabric. Authority None Syntax show fabric Examples The following is an example of the show fabric command: 8/20q FC Switch #> show fabric Domain Enet IP Addr FC IP Addr...
show fdmi Description Displays detailed information about the device host bus adapter. Authority None Syntax show fdmi [port_wwn] Operands [port_wwn] The device WWPN for which to display information. If you omit [port_wwn], the command displays a summary of host bus adapter information for all attached devices in the fabric. Illegal characters in the display appear as question marks (?).
show interface Description Displays the status of the active network interfaces. Authority None Syntax show interface Examples The following is an example of the show interface command: 8/20q FC Switch #> show interface eth0 Link encap:Ethernet HWaddr 00:C0:DD:0D:53:E7 inet addr:10.20.116.140 Bcast:10.20.116.255 Mask:255.255.255.0 UP BROADCAST RUNNING MULTICAST...
show log Description Displays the contents of the log or the parameters used to create and display entries in the log. The log contains a maximum of 1,200 entries. When the log reaches its entry capacity, subsequent entries overwrite the existing entries, beginning with the oldest. Authority None Syntax show log...
Table 47 Event log display filter parameters Parameter Description Displays all informative events Info Displays all warning events Warning Displays all critical events Critical Displays all events related to E_Ports Eport Displays all events related to the management server Mgmtserver Displays all events related to the name server Nameserver Port [port_number]...
Page 206
The following is an example of the show log command: 8/20q FC Switch #> show log [327][day month date time year][I][Eport Port:0/8][Eport State= E_A0_GET_DOMAIN_ID] [328][day month date time year][I][Eport Port: 0/8][FSPF PortUp state=0] [329][day month date time year][I][Eport Port: 0/8][Sending init hello] [330][day month date time year][I][Eport Port: 0/8][Processing EFP, oxid= 0x8] [331][day month date time year][I][Eport Port: 0/8][Eport State =...
show lsdb Description Displays link state database information, Authority None Syntax show lsdb Examples The following is an example of the show lsdb command: 8/20q FC Switch #> show lsdb Link State Database Information ------------------------------- LsID 34: Age=1176, Incarnation=0x800000e5 NeighborDomain=36, LocalPort=6, RemotePort=7, Cost=500 NeighborDomain=35, LocalPort=16, RemotePort=16, Cost=100 NeighborDomain=35, LocalPort=18, RemotePort=19, Cost=100 NeighborDomain=35, LocalPort=7, RemotePort=7, Cost=500...
show mem Description Displays information about memory activity. Authority None Syntax show mem [count] Operands [count] The number of seconds for which to display memory information. If you omit [count], the value 1 is used. Displayed memory values are in 1K block units. NOTE: This operand will display memory activity updates until [count] is reached–it cannot be interrupted.
show ns Description Displays the WWNs for devices in the fabric. Authority None Syntax show ns [option] Operands [option] The domain IDs or port IDs for which to display name server information. If you omit [option], name server information for the local domain ID is displayed. Table 48 describes the name server display options.
show pagebreak Description Displays the current pagebreak setting. Authority None Syntax show pagebreak Operands The pagebreak setting limits the display of information to 20 lines (ON) or allows the continuous display of information without a break (OFF). Examples The following is an example of the show pagebreak command: 8/20q FC Switch #>...
show perf Description Displays port performance in frames/second and bytes/second. If you omit the operand, the command displays data transmitted (out), data received (in), and total data transmitted and received in frames/second and bytes/second. Transmission rates are expressed in thousands (K) and millions (M).
Page 212
outframe [port_list] Displays continuous performance data in frames/second transmitted for the ports given by [port_list]. [port_list] can be a set of port numbers and ranges delimited by spaces. For example, 0 2 10-15 specifies ports 0, 2, 10, 1 1, 12, 13, 14, and 15. If you omit [port_list], the command displays performance data for ports 0–15.
show port Description Displays operational information for one or more ports. Authority None Syntax show port [port_list] Operands [port_list] The number of the port for which to display information. [port_list] can be a set of port numbers and ranges delimited by spaces. For example, 0 2 10-15 specifies ports 0, 2, 10, 1 1, 12, 13, 14, and 15.
Page 214
Table 49 Show Port parameters (Continued) Parameter Description Number of times the switch sent a fabric busy (F_BSY) frame because FBusy the Class 2 frame could not be delivered within ED_TOV time; or the number of class 2 and class 3 F_BSY frames generated by this port in response to incoming frames.
Page 215
Table 49 Show Port parameters (Continued) Parameter Description Transceiver vendor part number MediaPartNumber Transceiver revision number MediaRevision Transceiver type MediaType Transceiver manufacturer MediaVendor Transceiver manufacturer identifier MediaVendorID Operational state OperationalState AutoPerfTuning status PerfTuningMode Fibre Channel port address PortID Worldwide port name PortWWN Number of primitive sequence errors detected PrimSeqErrors...
Page 216
Examples The following is an example of the show port command: 8/20q FC Switch #> show port 1 Port Number: 1 ------------ AdminState Online OperationalState Offline AsicNumber PerfTuningMode Normal AsicPort PortID 3a0100 ConfigType PortWWN 20:01:00:c0:dd:0d:4f:08 POSTFaultCode 00000000 RunningType Unknown POSTStatus Passed MediaPartNumber FTLF8528P2BCV...
show postlog Description Displays the power-on self test log, which contains results from the most recently failed power-on self test (POST). Authority None Syntax show postlog show port log Examples The following is an example of the show postlog command: 8/20q FC Switch #>...
show setup callhome Description Displays the Call Home database configuration. NOTE: The 8/20q Fibre Channel Switch Call Home service provides an e-mail notification capability for the switch. This service has no relationship with the HP Call Home feature, which notifies HP services. Authority None Syntax show setup callhome...
show setup mfg Description Displays manufacturing information about the switch. Authority None Syntax show setup mfg Examples The following is an example of the show setup mfg command: 8/20q FC Switch #> show setup mfg Manufacturing Information ------------------------- BrandName BuildDate Tuesday, September 25, 2007 11:23 ChassisPartNumber HSTNM-N015...
show setup radius Description Displays RADIUS server information. Authority None Syntax show setup radius Examples The following is an example of the show setup radius command: 8/20q FC Switch #> show setup radius Radius Information ------------------ DeviceAuthOrder RadiusLocal UserAuthOrder RadiusLocal TotalServers Server: 1 ServerIPAddress...
show setup services Description Displays switch service status information. Authority None Syntax show setup services Examples The following is an example of the show setup services command: 8/20q FC Switch #> show setup services System Services ----------------------------- TelnetEnabled True SSHEnabled False GUIMgmtEnabled True...
show setup snmp Description Displays the current SNMP settings. Authority None Syntax show setup snmp Examples The following is an example of the show setup snmp command: 8/20q FC Switch #> show setup snmp SNMP Information ---------------- SNMPEnabled True Contact <sysContact undefined>...
show setup system Description Displays the current system settings. Authority None Syntax show setup system Examples The following is an example of the show setup system command: 8/20q FC Switch #> show setup system System Information ------------------ EthNetworkDiscovery Static EthNetworkAddress 10.20.11.32 EthNetworkMask 255.255.252.0...
show steering Description Displays the routes that data takes in the fabric. Authority None Syntax show steering [domain_id] Operands [domain_id] The domain ID for which to display route information. If you omit [domain_id], the system displays routes for all switches in the fabric. Examples The following is an example of the show steering command: 8/20q FC Switch #>...
show switch Description Displays switch operational information. Authority None Syntax show switch Notes Table 50 describes the switch operational parameters. Table 50 Switch operational parameters Parameter Description Descriptive name for the switch SymbolicName Switch worldwide name SwitchWWN Programmable Read-only Memory (PROM) boot version BootVersion Number of port buffer credits available to recipient ports CreditPool...
Page 226
Examples The following is an example of the show switch command: 8/20q FC Switch #> show switch Switch Information ------------------ SymbolicName 8/20q FC Switch SwitchWWN 10:00:00:c0:dd:00:bc:56 BootVersion Vx.x.x.x-0 (day month date time year) CreditPool DomainID 19 (0x13) FirstPortAddress 130000 FlashSize - MBytes LogFilterLevel Critical MaxPorts...
show testlog Description Displays the contents of the diagnostic field test log file. Authority None Syntax show testlog show test log Examples The following is an example of the show testlog command: 8/20q FC Switch #> show testlog Queue: Sequence Count: Success Count: Failed Count: 2023...
show timezone Description Displays the current time zone setting. Authority None Syntax show timezone Examples The following is an example of the show timezone command: 8/20q FC Switch #> show timezone America/Chicago See also timezone, page 188 228 Command reference...
show topology Description Displays all connected devices. Authority None Syntax show topology Examples The following is an example of the show topology command: 8/20q FC Switch #> show topology Unique ID Key ------------- A = ALPA, D = Domain ID, P = Port ID Port Local Local...
show users Description Displays a list of logged-in users. This is equivalent to the user list command. Authority None Syntax show users Examples The following is an example of the show users command: 8/20q FC Switch #> show users User Ethernet Addr-Port Logged in Since ----...
show version Description Displays introductory information about the operational attributes of the switch. This command is equivalent to the show about command. Authority None Syntax show version Notes Table 51 describes the information returned by the show version command. Table 51 Show version display entries Attribute Description...
shutdown Description Terminates all data transfers on the switch at convenient points and closes the switch connection. Always power-cycle the switch after entering this command. Authority Admin session Syntax shutdown Notes When the shutdown is complete, the Heartbeat LED is extinguished. 232 Command reference...
test cancel Description Cancels a port test that is in progress. Authority Admin session Syntax test cancel port [port_number] Operands port [port_number] Cancel the test for the port given by [port_number]. [port_number] can be 0–19. Examples The following example cancels the test running on port 15: 8/20q FC Switch (admin) #>...
test port Description Tests individual ports using an offline or online test. Authority Admin session Syntax test port [port_number] offline [loopback_type] online Operands [port_number] The port to be tested. [port_number] can be 0–19. offline [loopback_type] Performs an offline test of the type given by [loopback_type] on the port given by [port_number]. Use the set port command to place the port in the diagnostics state before running the test.
Page 235
Examples The following example performs an online test on port 1: 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #> test port 1 online A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the default 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.
test status Description Displays the status of a test in progress, or if there is no test in progress, the status of the last test that was executed. Authority None Syntax test status port [port_number] switch Operands port [port_number] Display test status for the port given by [port_number]. [port_number] can be 0–19. switch Display test status for the switch: Passed, Failed, NeverRun.
Page 237
See also test cancel, page 233 test port, page 234 test switch, page 238 8/20q Fibre Channel Switch command line interface guide 237...
test switch Description Tests all ports on the switch using a connectivity test, an offline test, or an online test. Authority Admin session Syntax test switch connectivity [loopback_type] offline [loopback_type] online Operands connectivity [loopback_type] Performs a connectivity test of the type given by [loopback_type] on all switch ports. You must place the switch in the diagnostics state using the set switch state command before starting the test.
Page 239
Table 56 Switch test parameters (Continued) Parameter Description Stops the test when an error occurs (True). Otherwise, the test continues to StopOnError completion. Restarts the test after completion and continues until you cancel it (True). LoopForever Otherwise, the test ends normally after completion. Examples The following example performs an offline internal test on a switch: 8/20q FC Switch #>...
uptime Description Displays the elapsed up time since the switch was last reset and the reset method. A hot reset or non-disruptive firmware activation does not reset the elapsed up time reported by this command. Authority None Syntax uptime Examples The following is an example of the uptime command: 8/20q FC Switch #>...
user Description Administers and displays user accounts. Authority Admin account name and an Admin session. The accounts and list operands are available to all account names without an Admin session. Syntax user accounts delete [account_name] edit list Operands accounts Displays all user accounts that exist on the switch. This operand is available to all account names without an Admin session.
Page 242
The following is an example of the user add command: 8/20q FC Switch (admin) #> user add Press 'q' and the ENTER key to abort this command. account name (1-15 chars) : user1 account password (8-20 chars) : ******* please confirm account password: ******* set account expiration in days (0-2000, 0=never): [0] 100 should this account have admin authority? (y/n): [n] y OK to add user account 'user1' with admin authority...
whoami Description 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: 8/20q FC Switch #> whoami User name : admin@session2 Switch name : HP StorageWorks 8/20q Fibre Channel Switch Switch domain ID: 21 (0x15) 8/20q Fibre Channel Switch command line interface guide 243...
Page 244
zone Description Manages zones and zone membership on a switch. Authority Admin session and a Zoning Edit session. See the zoning edit command. The list, members, and zonesets operands are available without an Admin session. Syntax zone add [zone] [member_list] list members [zone] orphans...
Page 245
remove [zone] [member_list] Removes the ports/devices given by [member_list] from the zone given by [zone]. Use a <space> to delimit aliases and ports/devices in [member_list]. [member_list] can have any of the following formats: • Domain ID and port number pair (Domain ID, Port Number). Domain IDs can be 1–239; port numbers can be 0–255.
Page 246
The following is an example of the zone zonesets command: 8/20q FC Switch #> zone zonesets zone1 Current List of ZoneSets for Zone: zone1 ---------------------------------- zone_set_1 See also zoneset, page 247 zoning edit, page 254 246 Command reference...
Page 247
zoneset Description Manages zone sets and component zones across the fabric. Authority Admin session and a Zoning Edit session. See the zoning edit command. The active, list, and zones operands are available without an Admin session. You must close the Zoning Edit session before using the activate and deactivate operand.
Page 248
rename [zone_set_old] [zone_set_new] Renames the zone set given by [zone_set_old] to the name given by [zone_set_new]. You can rename the active zone set. You must enter the zoning save command to save your changes. zones [zone_set] Displays all zones that are components of the zone set given by [zone_set]. This operand does not require an Admin session.
zoning active Description Displays information for the active zone set or saves the active zone set to the non-volatile zoning database. Authority Admin session for the capture operand. Syntax zoning active capture Operands capture Saves the active zone set to the non-volatile zoning data base. Examples The following is an example of the zoning active command: 8/20q FC Switch #>...
zoning cancel Description Closes the current Zoning Edit session. Any unsaved changes are lost. Authority Admin session and a Zoning Edit session. Syntax zoning cancel Examples The following is an example of the zoning cancel command: 8/20q FC Switch #> admin start 8/20q FC Switch (admin) #>...
zoning clear Description Clears all inactive zone sets from the volatile edit copy of the zoning database. This operand requires a zoning edit session. This operand does not affect the non-volatile zoning database. However, if you enter the zoning clear command followed by the zoning save command, the non-volatile zoning database will be cleared from the switch.
zoning configured Description Displays the contents of the non-volatile zoning database. Authority None Syntax zoning configured Examples The following is an example of the zoning configured command: 8/20q FC Switch #> zoning configured Configured (saved in NVRAM) Zoning Information ZoneSet Zone ZoneMember -------...
zoning delete orphans Description Deletes all objects that are not part of the active zone set, including zone sets, zones, and aliases. Authority Admin session Syntax zoning delete orphans Examples The following is an example of the zoning delete orphans command: 8/20q FC Switch #>...
zoning edit Description Opens a Zoning Edit session for the non-volatile zoning database or merged zone set in which to create and manage zone sets and zones. Authority Admin session Syntax zoning edit [database] Operands [database] Opens an edit session for the zoning database given by [database]. If you omit [database], an edit session for the non-volatile zoning database is opened.
zoning edited Description Displays the contents of the edited zoning database. Authority Admin session and a Zoning Edit session Syntax zoning edited Examples The following is an example of the zoning edited command: 8/20q FC Switch (admin-zoning) #> zoning edited Edited (unsaved) Zoning Information ZoneSet Zone...
zoning history Description Displays a history of zoning modifications. This operand 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.
zoning limits Description Displays the limits and numbers of zone sets, zones, aliases, members per zone, members per alias, and total members in the zoning database. Authority None Syntax zoning limits brief Operands brief Displays zoning limits for each category, the current number of objects, and the applicable zoning database (non-volatile or active).
zoning list Description Lists all zoning definitions, including the applicable zoning database. Authority None Syntax zoning list Examples The following is an example of the zoning list command: 8/20q FC Switch #> zoning list Active (enforced) ZoneSet Information ZoneSet Zone ZoneMember -------------------------------- wwn_23bd31...
zoning merged Description Displays the contents of the merged zone set, or saves the merged zone set to the non-volatile zoning database. Authority Admin session for the capture operand. Syntax zoning merged capture Operands capture Saves the merged zone set to the non-volatile zoning database. You must enter the zoning save command to save your changes.
zoning restore Description Restores the volatile zoning database with the contents of the non-volatile zoning database. If the MergeAutoSave parameter is False (see Table 18), you can use this command to revert changes to the merged zone set that were propagated from another switch in the fabric through zone set activation or merging fabrics.
zoning save Description Saves changes made during the current Zoning Edit session. The system informs you that the zone set must be activated to implement any changes. Authority Admin session and a Zoning Edit session. Syntax zoning save Examples The following is an example of the zoning save command: 8/20q FC Switch #>...
Index access authority backup file account name beacon feature activation binding firmware fabric security port switch configuration BootP See Bootstrap Protocol zoning Bootstrap Protocol active zone set broadcast tree information Admin account authority Call Home command concepts opening and closing a session database session timeout edit session...
Page 264
Restore example connection configuration network information activating port configuration backing up event copying message format deleting output stream control device security remote logging displaying severity level edit session event log editing clearing exporting configuration management importing configuring modifying displaying configuration resetting displaying contents restoring...
Page 265
removing image files retrieving image file I/O Stream Guard unpacking image Image command uploading image file Install example version informative event Firmware Install command internal loopback test example Inter-Switch Link FTP See File Transfer Protocol connection count full-text format group IP address ISL See Inter-Switch Link gateway address...
Page 266
POST See Power-on Self Test Power-on Self Test name server information network results configuration preference routing discovery primary secret gateway address profile interfaces copying IP address creating mask deleting resetting configuration editing Network Time Protocol modifying client renaming description testing interaction with Date command Profile command server address...
Page 267
Secure Socket Layer Copy example certificate Create example description Deactivate example service Delete example switch time Group example security List example certificate Remove example configuration Rename example configuration display services configuration parameters displaying connection managing database Set Beacon command edit session Set Config Port command group example...
Page 268
Show Chassis command information example modifying configuration Show Config Port command resetting example service Show Config Security command Simple SAN Connection Manager example SMI-S See Storage Management Initiative-Specification port binding SMTP See Simple Mail Transfer Protocol Show Config Security Port command soft Show Config Switch command reset...
Page 269
log file HP storage offline HP Subscriber’s choice online Whoami command Test Cancel command workstation Test Port command date and time example settings Test Status command Worldwide Name Test Switch command Worldwide Port Name TFTP See Trivial File Transfer Protocol WWN See Worldwide Name time WWPN See Worldwide Port Name...
Page 270
Create example Deactivate example Delete example List example Merged example Remove example Rename example Zones example zoning edit session hardware-enforced Zoning Active command Capture example example Zoning Cancel command Zoning Clear command example Zoning Configured command zoning database clearing discarding inactive components displaying configuration parameters displaying contents displaying limits...