QLogic 5602 - Manual

59183-01 A Page v SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide A 6.6.1 Online Tests for Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-12 6.6.2 Offline Tests for Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6...

Page vi 59183-01 A SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide S 7.8.5 Add Members to an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-18 7.8.6 Remove Members from an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-18 Section 8 C...

59183-01 A Page vii SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide A Section 11 Event Log Configuration 11.1 Starting and Stopping Event Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11-1 11.2 Displaying the Event Log . . . . . . . . . . . . . . . . . . . ....

59183-01 A Page ix SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide A Show FDMI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-111Show Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13-113...

Page x 59183-01 A SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide S List of Tables Table Page 2-1 Command-Line Completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-3 3-1 Factory User Accounts . . . . . . . . . . . . . . . . . . . . . ...

59183-01 A 1-1 Section 1 Introduction This guide describes the features and use of the command line interface for SANbox 5000 Series switches running firmware version 6.7. This guide is organized as follows: „ Section 1 describes switch models and features, the intended audience, related materials, ...

1 – Introduction Switch Models and Examples 1-2 59183-01 A S 1.1 Switch Models and Examples The commands and displays of the command line interface vary depending on the switch model. All examples in this guide are taken from a SANbox 5600 switch unless stated otherwise. 1.2 Intended Audience This g...

1 – Introduction New in This Release 59183-01 A 1-3 A 1.4 New in This Release The following features are new in this release: „ The switch is equipped with the QuickTools embedded graphical user interface. QuickTools is a web applet that provides basic fabric management tools. „ The following option...

1 – Introduction Technical Support 1-4 59183-01 A S 1.5 Technical Support Customers should contact their authorized maintenance provider for technical support of their QLogic switch products. QLogic-direct customers may contact QLogic Technical Support; others will be redirected to their authorized ...

1 – Introduction Technical Support 59183-01 A 1-5 A 1.5.3 Contact Information Support Headquarters QLogic Corporation12984 Valley View RoadEden Prairie, MN 55344-3657USA QLogic Web Site www.qlogic.com Technical Support Web Site support.qlogic.com Technical Support Email [email protected] Technical ...

1 – Introduction Technical Support 1-6 59183-01 A S Notes

59183-01 A 2-1 Section 2 Command Line Interface Usage This section describes the following tasks: „ Logging In to the Switch „ Opening and Closing an Admin Session „ Entering Commands „ Getting Help „ Setting Page Breaks „ Creating a Support File „ Downloading and Uploading Files NOTE: Throughout th...

2 – Command Line Interface Usage Logging In to the Switch 2-2 59183-01 A S 2.1 Logging In to the Switch To log in to a switch through Telnet, open a command line window on the workstation and enter the Telnet command followed by the switch IP address: # telnet ip_address The Telnet window opens prom...

2 – Command Line Interface Usage Opening and Closing an Admin Session 59183-01 A 2-3 A 2.2 Opening and Closing an Admin Session The command line interface performs monitoring and configuration tasks. Commands that perform monitoring tasks are available to all user accounts. Commands that perform con...

2 – Command Line Interface Usage Getting Help 2-4 59183-01 A S 2.4 Getting Help To display help for a command, enter the Help command followed by the command. The following is an example of the help that is available for the Config Edit command. SANbox #> help config edit config edit [CONFIG_NAME...

2 – Command Line Interface Usage Creating a Support File 59183-01 A 2-5 A 2.6 Creating a Support File If you contact technical support about a problem with your switch, they may request that you create and send a support file. This support file contains all of the switch configuration information wh...

2 – Command Line Interface Usage Creating a Support File 2-6 59183-01 A S If your workstation does not have an FTP server, enter the Create Support command to create the support file, and use FTP to download the support file from the switch to your workstation as shown in the following example: SANb...

2 – Command Line Interface Usage Downloading and Uploading Files 59183-01 A 2-7 A 2.7 Downloading and Uploading Files There are several files that reside on the switch that you can download to the workstation for examination or for safekeeping. These files include the following: „ Backup configurati...

59183-01 A 3-1 Section 3 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 specia...

3 – User Account Configuration Displaying User Account Information 3-2 59183-01 A S 3.1 Displaying User Account Information You can display all user accounts defined on the switch ( User Accounts command) or just those user accounts that are logged on (User List or Show Users commands). The followin...

3 – User Account Configuration Creating User Accounts 59183-01 A 3-3 A 3.2 Creating User Accounts A user account consists of an account name, an authority level, and an expiration date. The account name can be up to 15 characters and must begin with an alphanumeric character. The authority level gra...

3 – User Account Configuration Modifying User Accounts and Passwords 3-4 59183-01 A S 3.3 Modifying User Accounts and Passwords Only the Admin user account can modify a user account, delete a user account, or change the password of another user account. However, all user accounts can change their ow...

59183-01 A 4-1 Section 4 Network and Fabric Configuration The switch network configuration consists of the following: „ 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 fro...

4 – Network and Fabric Configuration Displaying Name Server Information 4-2 59183-01 A S 4.1 Displaying Name Server Information The Show NS command displays the list of WWNs in fabric as shown in the following example: SANbox #> show ns all Seq Domain Port Port No ID ID Type COS PortWWN NodeWWN -...

4 – Network and Fabric Configuration Displaying the Ethernet Network Configuration 59183-01 A 4-3 A 4.2 Displaying the Ethernet Network Configuration The Show Fabric command displays IP addresses (Enet IP Addr) for all switches in the fabric as shown in the following example. SANbox #> show fabri...

4 – Network and Fabric Configuration Configuring the Ethernet Port 4-4 59183-01 A S 4.3 Configuring the Ethernet Port Configure the switch Ethernet port using the Set Setup System command within an Admin session. The following example configures a new IP address, subnet mask, and gateway address. SA...

4 – Network and Fabric Configuration Verifying a Switch in the Network 59183-01 A 4-5 A 4.4 Verifying a Switch in the Network You can verify that a switch is communicating in the network using the Ping command. The following example successfully tests the network for a switch with IP address 10.20.1...

4 – Network and Fabric Configuration Verifying and Tracing Fibre Channel Connections 4-6 59183-01 A S Enter the Fctrace command to display Fibre Channel routing information between two devices as shown in the following example. The devices can be defined as Fibre Channel addresses or WWNs. SANbox#&g...

59183-01 A 5-1 Section 5 Switch Configuration Switch configuration consists of the following tasks: „ Displaying Switch Information „ Managing Switch Services „ Managing Switch Configurations „ Paging a Switch „ Setting the Date and Time „ Resetting a Switch „ Installing Firmware „ Managing Switch F...

5 – Switch Configuration Displaying Switch Information 5-2 59183-01 A S 5.1.1 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 i...

5 – Switch Configuration Displaying Switch Information 59183-01 A 5-3 A 5.1.2 System Process Information The Ps command displays system process information to help you determine what processes are running and CPU usage. The following example displays current system processes. SANbox #> ps PID PPI...

5 – Switch Configuration Displaying Switch Information 5-4 59183-01 A S 5.1.3 Elapsed Time Between Resets The Uptime command displays the elapsed time since the switch was last reset and the reset method. A hot reset or non-disruptive firmware activation does not reset the elapsed time reported by t...

5 – Switch Configuration Displaying Switch Information 59183-01 A 5-5 A 5.1.4 Configuration Information The Show Config command displays a variety of configuration information at the port and switch levels. In addition to the basic switch configurations, the Show Config command displays parameters t...

5 – Switch Configuration Displaying Switch Information 5-6 59183-01 A S 5.1.4.2 Zoning Configuration Parameters Enter the Show Config Zoning command to display zoning configuration parameters. These parameters determine how zoning is applied to the switch. Refer to Table 13-19 for a description of t...

5 – Switch Configuration Displaying Switch Information 59183-01 A 5-7 A 5.1.5 Hardware Information Enter the Show Chassis command to display the status of the switch hardware including fans, power supplies, internal temperature, and Heartbeat LED status. The following is an example of the Show Chass...

5 – Switch Configuration Displaying Switch Information 5-8 59183-01 A S 5.1.6 Firmware Information Enter the Show Version command to display a summary of switch identity information including the firmware version. The following is an example of the Show Version command: SANbox #> show version ***...

5 – Switch Configuration Managing Switch Services 59183-01 A 5-9 A 5.2 Managing Switch Services You can configure your switch to suit the demands of your environment by enabling or disabling a variety of switch services. You manage the switch services using the Show Setup Services and Set Setup Serv...

5 – Switch Configuration Managing Switch Configurations 59183-01 A 5-11 A 5.3 Managing Switch Configurations The switch configuration determines the basic operational characteristics of the switch. A switch supports up to 10 configurations including the default configuration, named Default Config. T...

5 – Switch Configuration Managing Switch Configurations 5-12 59183-01 A S 5.3.3 Copy a Switch Configuration Enter the Config Copy command to create a copy of an existing configuration as shown in the following example: SANbox (admin) config copy config_1 config_2 5.3.4 Delete a Switch Configuration ...

5 – Switch Configuration Managing Switch Configurations 59183-01 A 5-13 A The following is an example of the Set Config Switch command. Refer to Table 13-17 for a description of the switch configuration parameters. SANbox #> admin start SANbox (admin) #> config edit SANbox (admin-config) #>...

5 – Switch Configuration Managing Switch Configurations 5-14 59183-01 A S 5.3.6 Back Up and Restore a Switch Configuration Successful management of switches and fabrics depends on the effective use of switch configurations. Backing up and restoring a configuration is useful to protect your work or f...

5 – Switch Configuration Managing Switch Configurations 59183-01 A 5-15 A 5.3.6.2 Downloading the Configuration File You use FTP to download the configdata file to your workstation for safe keeping and to upload the file back to the switch for the restore function. To download the configdata file, o...

5 – Switch Configuration Managing Switch Configurations 5-16 59183-01 A S 5.3.6.3 Restoring the Configuration File 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 ...

5 – Switch Configuration Paging a Switch 59183-01 A 5-17 A 5.4 Paging a Switch To help you locate a particular switch in a rack of switches, you can turn on the beacon feature with the Set Beacon command. This causes all port Logged-In LEDs to flash in unison. The following is an example of how to t...

5 – Switch Configuration Setting the Date and Time 5-18 59183-01 A S Enter the Set Timezone to change the time zone as shown in the following example: SANbox (admin) #> set timezone Africa America Antarctica Asia Atlantic Australia Europe Indian Pacific UTC Press ENTER for more options or 'q' to ...

5 – Switch Configuration Setting the Date and Time 59183-01 A 5-19 A To configure the switch to use an NTP server, enter the Set Setup System command to enable the NTP client and to specify the NTP server IP address. SANbox #> admin start SANbox (admin) #> set setup system A list of attributes...

5 – Switch Configuration Resetting a Switch 5-20 59183-01 A S 5.6 Resetting a Switch Table 5-2 describes the methods for resetting a switch, the corresponding command, and the impact on the switch. 5.7 Installing Firmware New firmware becomes available periodically either on CD-ROM or from the QLogi...

5 – Switch Configuration Installing Firmware 59183-01 A 5-21 A 5.7.1 Nondisruptive Activation You can load and activate new firmware on a switch disruptively or nondisruptively depending on the condition of the fabric and the commands you choose. If you attempt to perform a non-disruptive activation...

5 – Switch Configuration Installing Firmware 5-22 59183-01 A S „ Pathname for the firmware image file 1. Enter the following commands to download the firmware from a remote host to the switch, install the firmware, then reset the switch to activate the firmware. SANbox #> admin start SANbox #>...

5 – Switch Configuration Installing Firmware 59183-01 A 5-23 A 5.7.3 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 ...

5 – Switch Configuration Managing Switch Feature Upgrades 5-24 59183-01 A S 5.8 Managing Switch Feature Upgrades The following features are available to upgrade your switch through the purchase and installation of a license key: „ Enterprise Fabric Suite 2007 is a workstation-based Java® application...

5 – Switch Configuration Managing Switch Feature Upgrades 59183-01 A 5-25 A 5.8.2 Install a Feature License Key Enter the Feature Add command to install a license key on your switch as shown in the following example: SANbox #> admin start SANbox (admin) #> feature add 1-LCVXOWUNOJBE6 License u...

59183-01 A 6-1 Section 6 Port Configuration This section describes the following topics: „ Displaying Port Information „ Modifying Port Operating Characteristics „ Port Binding „ Resetting a Port „ Configuring Port Threshold Alarms „ Testing a Port „ Extending Port Transmission Distance 6.1 Displayi...

6 – Port Configuration Displaying Port Information 6-2 59183-01 A S 6.1.1 Port Configuration Parameters Enter the Show Config Port command to display the port configuration parameters. These parameters determine the operational characteristics of the port. Refer to Table 13-14 for a description of t...

6 – Port Configuration Displaying Port Information 59183-01 A 6-3 A 6.1.2 Port Operational Information Enter the Show Port command to display port operational information. SANbox #> show port 1 Port Number: 1 ------------ AdminState Online OperationalState Offline AsicNumber 0 PerfTuningMode Norm...

6 – Port Configuration Displaying Port Information 6-4 59183-01 A S 6.1.3 Port Threshold Alarm Configuration Parameters Enter the Show Config Threshold command to display the port threshold alarm parameters. These parameters determine the error thresholds at which the switch issues alarms. Refer to ...

6 – Port Configuration Displaying Port Information 59183-01 A 6-5 A 6.1.4 Port Performance Enter the Show Perf command to display port performance in terms of the volume of data transmitted, data received, or errors. You can display continuous live performance information for one or more ports, or a...

6 – Port Configuration Displaying Port Information 6-6 59183-01 A S 6.1.5 Transceiver Information Enter the Show Media command to display operational information about one or more transceivers as shown in the following example. Refer to Table 13-25 for a description of the transceiver information in...

6 – Port Configuration Modifying Port Operating Characteristics 59183-01 A 6-7 A 6.2 Modifying Port Operating Characteristics You can make permanent or temporary changes to port operating characteristics. You make permanent port configuration changes using the Set Config Port command. These changes ...

6 – Port Configuration Port Binding 6-8 59183-01 A S You can configure all ports based a specified source port using the Set Config Ports command. The following example configures ports 0–20 based on port 3. SANbox #> admin start SANbox (admin) config edit SANbox (admin) #> set config ports 3 ...

6 – Port Configuration Resetting a Port 59183-01 A 6-9 A Enter the Set Config Security Portbinding command to enable port binding for the selected port and to specify the world wide names of the authorized ports/devices. The following example enables port binding on port 1 and specifies two device w...

6 – Port Configuration Configuring Port Threshold Alarms 6-10 59183-01 A S 6.5 Configuring Port Threshold Alarms The switch can monitor a set of port errors and generates alarms based on user-defined sample windows and thresholds. These port errors include the following: „ Cyclic Redundancy Check (C...

6 – Port Configuration Testing a Port 6-12 59183-01 A S 6.6 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 „ Offline Tests for Ports...

6 – Port Configuration Testing a Port 59183-01 A 6-13 A 6.6.2 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: i...

6 – Port Configuration Testing a Port 6-14 59183-01 A S 6.6.3 Display Port Test Results You can display the test status while the test is in progress by entering the Test Status Port command as shown in the following example: SANbox (admin) #> test status port 1 Port Test Test Loop Test Num Port ...

6 – Port Configuration Extending Port Transmission Distance 59183-01 A 6-15 A 6.7 Extending Port Transmission Distance You can extend the distance over which an F_Port or G_Port port can transmit by borrowing buffer credits from other ports. Refer to the SANbox 5000 Series Fibre Channel Switch Insta...

59183-01 A 7-1 Section 7 Zoning Configuration This section describes the following tasks: „ Displaying Zoning Database Information „ Configuring the Zoning Database „ Modifying the Zoning Database „ Resetting the Zoning Database „ Managing Zone Sets „ Managing Zones „ Managing Aliases Consider devic...

7 – Zoning Configuration Displaying Zoning Database Information 7-2 59183-01 A S 7.1 Displaying Zoning Database Information You can display the following information about the zoning database: „ Configured Zone Set Information „ Active Zone Set Information „ Zone Set Membership Information „ Zoning ...

7 – Zoning Configuration Displaying Zoning Database Information 7-4 59183-01 A S 7.1.2 Active Zone Set Information The Zoning Active and Zoneset Active commands display information about the active zone set. Enter the Zoning Active command to display component zones and zone members as shown in the ...

7 – Zoning Configuration Displaying Zoning Database Information 59183-01 A 7-5 A 7.1.3 Zone Set Membership Information The Zoneset Zones and Zone Zonesets commands display zone set membership information. Enter the Zoneset Zones command to display the member zones for a specified zone set as shown i...

7 – Zoning Configuration Displaying Zoning Database Information 7-6 59183-01 A S 7.1.5 Alias and Alias Membership Information The Alias List and Alias Members commands display information about aliases. Enter the Alias List command to display a list of all aliases as shown in the following example: ...

7 – Zoning Configuration Displaying Zoning Database Information 59183-01 A 7-7 A 7.1.6 Zoning Modification History Enter the Zoning History command to display a record of zoning modifications as shown in the following example: SANbox #> zoning history Active Database Information -----------------...

7 – Zoning Configuration Displaying Zoning Database Information 7-8 59183-01 A S 7.1.7 Zoning Database Limits Enter the Zoning Limits command to display a summary of the objects in the zoning database and their maximum limit as shown in the following example: SANbox #> zoning limits Zoning Attrib...

7 – Zoning Configuration Configuring the Zoning Database 59183-01 A 7-9 A 7.2 Configuring the Zoning Database You can configure how the zoning database is applied to the switch and exchanged with the fabric through the zoning configuration parameters. The following zoning configuration parameters ar...

7 – Zoning Configuration Configuring the Zoning Database 7-10 59183-01 A S The Config Edit session provides access to the Set Config Zoning command as shown in the following example: SANbox #> admin start SANbox (admin) #> config edit The config named default is being edited. SANbox (admin-con...

7 – Zoning Configuration Modifying the Zoning Database 59183-01 A 7-11 A 7.3 Modifying the Zoning Database To modify the zoning database, you must open an Admin session with the Admin Start command. An Admin session prevents other accounts from making changes at the same time through Telnet, Enterpr...

7 – Zoning Configuration Resetting the Zoning Database 7-12 59183-01 A S 7.4 Resetting the Zoning Database There are two ways to remove all aliases, zones, and zone sets from the zoning database: „ Enter the Zoning Clear command as shown in the following example: SANbox #> admin start SANbox (adm...

7 – Zoning Configuration Managing Zone Sets 59183-01 A 7-13 A 7.6 Managing Zone Sets Managing Zone Sets consists of the following tasks: „ Create a Zone Set „ Delete a Zone Set „ Rename a Zone Set „ Copy a Zone Set „ Add Zones to a Zone Set „ Remove Zones from a Zone Set „ Activate a Zone Set „ Deac...

7 – Zoning Configuration Managing Zone Sets 7-14 59183-01 A S 7.6.3 Rename a Zone Set Enter the Zoneset Rename command to rename a zone set as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoning) #> zoneset rename zoneset_old zoneset_new ...

7 – Zoning Configuration Managing Zones 59183-01 A 7-15 A 7.6.8 Deactivate a Zone Set Enter the Zoneset Deactivate command to deactivate the active zone set and disable zoning in the fabric: SANbox #> admin start SANbox (admin) #> zoneset deactivate 7.7 Managing Zones Managing Zones consists o...

7 – Zoning Configuration Managing Zones 7-16 59183-01 A S 7.7.3 Rename a Zone Enter the Zone Rename command to rename zone_1 to zone_a as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoning) #> zone rename zone_1 zone_a SANbox (admin-zoni...

7 – Zoning Configuration Managing Aliases 59183-01 A 7-17 A 7.8 Managing Aliases Managing aliases consists of the following tasks: „ Create an Alias „ Delete an Alias „ Rename an Alias „ Copy an Alias „ Add Members to an Alias „ Remove Members from an Alias All of these tasks require an Admin sessio...

7 – Zoning Configuration Managing Aliases 7-18 59183-01 A S 7.8.4 Copy an Alias Enter the Alias Copy command to copy alias_1 and its contents to alias_2 as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoning) #> alias copy alias_1 alias_2...

59183-01 A 8-1 Section 8 Connection Security Configuration This section describes the following tasks: „ Managing SSL and SSH Services „ Displaying SSL and SSH Services „ Creating an SSL Security Certificate The switch supports secure connections with Telnet and switch management applications. The S...

8 – Connection Security Configuration Displaying SSL and SSH Services 59183-01 A 8-3 A 8.2 Displaying SSL and SSH Services Enter the Show Setup Services command to display the status of the SSH and SSL services as shown in the following example: SANbox #> show setup services System Services -----...

59183-01 A 9-1 Section 9 Device Security Configuration This section describes the following tasks: „ Displaying Security Database Information „ Configuring the Security Database „ Modifying the Security Database „ Resetting the Security Database „ Managing Security Sets „ Managing Groups Device secu...

9 – Device Security Configuration Displaying Security Database Information 9-2 59183-01 A S 9.1 Displaying Security Database Information You can display the following information about the security database: „ Configured Security Set Information „ Active Security Set Information „ Security Set Membe...

9 – Device Security Configuration Displaying Security Database Information 9-4 59183-01 A S 9.1.2 Active Security Set Information The Security Active and Securityset Active commands display information about the active security set. Enter the Security Active command to display component groups and g...

9 – Device Security Configuration Displaying Security Database Information 59183-01 A 9-5 A 9.1.3 Security Set Membership Information The Securityset Groups and Group Securitysets commands display security set membership information. Enter the Securityset Groups command to display the member groups ...

9 – Device Security Configuration Displaying Security Database Information 9-6 59183-01 A S 9.1.5 Security Database Modification History Enter the Security History command to display a record of security database modifications as shown in the following example: SANbox #> security history Active D...

9 – Device Security Configuration Configuring the Security Database 59183-01 A 9-7 A 9.2 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 configur...

9 – Device Security Configuration Modifying the Security Database 59183-01 A 9-9 A 9.3 Modifying the Security Database To modify the security database, you must open an Admin session with the Admin Start command. An Admin session prevents other accounts from making changes at the same time either th...

9 – Device Security Configuration Managing Security Sets 9-10 59183-01 A S 9.5 Managing Security Sets Managing Security Sets consists of the following tasks: „ Create a Security Set „ Delete a Security Set „ Rename a Security Set „ Copy a Security Set „ Add Groups to a Security Set „ Remove Groups f...

9 – Device Security Configuration Managing Security Sets 59183-01 A 9-11 A 9.5.5 Add Groups to a Security Set Enter the Securityset Add command to add a group to a security set as shown in the following example: SANbox (admin-security) #> securityset add securityset_1 group_isl group_port 9.5.6 R...

9 – Device Security Configuration Managing Groups 9-12 59183-01 A S 9.6 Managing Groups Managing Groups consists of the following tasks: „ Create a Group „ Delete a Group „ Rename a Group „ Copy a Group „ Add Members to a Group „ Modify a Group Member „ Remove Members from a Group All of these tasks...

9 – Device Security Configuration Managing Groups 59183-01 A 9-13 A 9.6.4 Copy a Group Enter the Group Copy command to copy the contents of an existing group (group_port) to a new group (port_1) as shown in the following example: SANbox (admin-security) #> group copy group_port port_1 9.6.5 Add M...

9 – Device Security Configuration Managing Groups 9-14 59183-01 A S 9.6.6 Modify 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. „ Fo...

59183-01 A 10-1 Section 10 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 ...

10 – RADIUS Server Configuration Displaying RADIUS Server Information 10-2 59183-01 A S 10.1 Displaying RADIUS Server Information Enter the Show Setup Radius command to display RADIUS server information as shown in the following example. Refer to Table 13-20 for a description of the RADIUS server co...

10 – RADIUS Server Configuration Configuring a RADIUS Server on the Switch 59183-01 A 10-3 A 10.2 Configuring a RADIUS Server on the Switch Enter the Set Setup Radius command to configure a RADIUS server on the switch as shown in the following example. Refer to Table 13-20 for a description of the R...

59183-01 A 11-1 Section 11 Event Log Configuration This section describes the following tasks: „ Starting and Stopping Event Logging „ Displaying the Event Log „ Managing the Event Log Configuration „ Clearing the Event Log „ Logging to a Remote Host „ Creating and Downloading a Log File Event messa...

11 – Event Log Configuration Displaying the Event Log 11-2 59183-01 A S 11.2 Displaying the Event Log Enter the Show Log command to display the event log. Each message has the following format: [ordinal][time_stamp][severity][message_ID][source][message_text] [ordinal] –A number assigned to each mes...

11 – Event Log Configuration Displaying the Event Log 59183-01 A 11-3 A 11.2.1 Filtering the Event Log Display You can customize what events are displayed according to the component or severity level. Enter the Show Log Display command to filter the events in the display. You can choose from the fol...

11 – Event Log Configuration Managing the Event Log Configuration 11-4 59183-01 A S 11.3 Managing the Event Log Configuration Managing the Event Log Configuration consists of the following tasks: „ Configure the Event Log „ Display the Event Log Configuration „ Restore the Event Log Configuration 11...

11 – Event Log Configuration Clearing the Event Log 59183-01 A 11-5 A 11.3.2 Display the Event Log Configuration Enter the Show Log Settings command to display all event log configuration settings as shown in the following example: SANbox #> show log settings Current settings for log ------------...

11 – Event Log Configuration Logging to a Remote Host 11-6 59183-01 A S 11.5 Logging to a Remote Host The switch comes from the factory with local logging enabled, which instructs the switch firmware to maintain an event log in switch memory. The switch can also be configured to log events to a remo...

11 – Event Log Configuration Creating and Downloading a Log File 59183-01 A 11-7 A 11.6 Creating and Downloading a Log File Enter the Set Log Archive command to collect the event log messages in a file on the switch named logfile . This file can have a maximum of 1200 event messages. Use FTP to down...

59183-01 A 12-1 Section 12 Simple Network Management Protocol Configuration This section describes the following tasks: „ Managing the SNMP Service „ Displaying SNMP Information „ Modifying the SNMP Configuration „ Resetting the SNMP Configuration The Simple Network Management Protocol (SNMP) provid...

12 – Simple Network Management Protocol Configuration Displaying SNMP Information 59183-01 A 12-3 A 12.2 Displaying SNMP Information Enter the Show Setup SNMP command to display SNMP configuration information as shown in the following example. Refer to Table 13-22 for a description of the SNMP param...

12 – Simple Network Management Protocol Configuration Modifying the SNMP Configuration 12-4 59183-01 A S 12.3 Modifying the SNMP Configuration Enter the Set Setup SNMP command to modify the SNMP configuration as shown in the following example. Refer to Table 13-22 for SNMP parameters descriptions. S...

12 – Simple Network Management Protocol Configuration Resetting the SNMP Configuration 59183-01 A 12-5 A 12.4 Resetting the SNMP Configuration Enter the Reset SNMP command to reset the SNMP configuration back to the factory defaults as shown in the following example. Refer to Table 13-9 for a listin...

59183-01 A 13-1 Section 13 Command Reference This section describes the commands of the CLI and the format in which they are presented. The command format presents the following: „ Access Authority „ Syntax and Keywords „ Notes and Examples The commands are listed in “Command Listing” on page 13-3 ....

13 – Command Reference Syntax and Keywords 13-2 59183-01 A S 13.2 Syntax and Keywords The Syntax paragraph defines the command syntax using the following convention: command keywordkeyword [value] keyword [value1] [value2] The Command is followed by one or more keywords. Consider the following rules...

13 – Command Reference Command Listing 59183-01 A 13-3 A 13.4 Command Listing The commands are listed in alphabetical order as follows: A Admin , Alias C Config , Create D Date E Exit F Fcping , Fctrace , Feature , Firmware Install G Group H Hardreset , Help , History , Hotreset I Image L Lip , Logo...

13 – Command Reference Admin 13-4 59183-01 A S Admin 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 period...

13 – Command Reference Alias 59183-01 A 13-5 A Alias 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 keywords except List an...

13 – Command Reference Alias 13-6 59183-01 A S delete [alias] Deletes the specified alias given by [alias] from the zoning database. If the alias is a member of the active zone set, the alias will not be removed from the active zone set until the active zone set is deactivated. list Displays a list ...

13 – Command Reference Config 59183-01 A 13-7 A Config Manages the Fibre Channel configurations on a switch. For information about setting the port and switch configurations, refer to the “Set Config Switch” command on page 13-70 . Authority Admin session for all keywords except Backup and List Synt...

13 – Command Reference Config 13-8 59183-01 A S edit [config_name] Opens an edit session for the configuration given by [config_name]. If you omit [config_name], the currently active configuration is used. list Displays a list of all available configurations on the switch. This keyword does not requ...

13 – Command Reference Create 13-10 59183-01 A S Create Creates support files for troubleshooting switch problems, and certificates for secure communications for Enterprise Fabric Suite 2007 and SMI-S. Authority Admin session for the Certificate keyword Syntax create certificatesupport Keywords cert...

13 – Command Reference Create 13-12 59183-01 A S 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 an...

13 – Command Reference Date 59183-01 A 13-13 A Date 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 dat...

13 – Command Reference Exit 13-14 59183-01 A S Exit Closes the Telnet session. Authority None Syntax exit Notes You can also enter Control-D to close the Telnet session.

13 – Command Reference Fcping 59183-01 A 13-15 A Fcping Verifies a Fibre Channel connection with another switch or a device and reports status. Authority None Syntax fcping destination [address] count [number]timeout [seconds] Keywords [address] The address of the port or device with which to verify...

13 – Command Reference Fctrace 13-16 59183-01 A S Fctrace Displays the path from an initiator device port in the fabric to a target device port in the same zone. To trace the path between two initiator ports, you must disable the I/O StreamGuard feature. Use the Set Config Port command to change the...

13 – Command Reference Fctrace 59183-01 A 13-17 A Examples The following is an example of the Fctrace command: SANbox#> fctrace 970400 970e00 hops 5 36 bytes from 0x970400 to 0x970e00, 5 hops max Domain Ingress Port WWN Port Egress Port WWN Port ------ ---------------- ---- --------------- ---- 9...

13 – Command Reference Feature 13-18 59183-01 A S Feature 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. Au...

13 – Command Reference Feature 59183-01 A 13-19 A The following is an example of the Feature Log command: SANbox #> feature log Mfg Feature Log: ---------------- Switch Licensed for 8 ports Customer Feature Log: --------------------- 1) day month date 19:39:24 year - Switch Licensed for 20 ports ...

13 – Command Reference Firmware Install 13-20 59183-01 A S Firmware Install 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...

13 – Command Reference Group 13-22 59183-01 A S Group Creates groups, manages membership within the group, and manages the membership of groups in security sets. Authority Admin session and a Security Edit session. Refer to the “Security” command on page 13-52 for information about starting a Securi...

13 – Command Reference Group 59183-01 A 13-23 A 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 13-1 , Table 13-2 , and Table 13-3 respectively....

13 – Command Reference Group 13-24 59183-01 A S Table 13-2. Port Group Member Attributes Attribute Description Member Worldwide port name (WWPN) for the N_Port device that would attach to the switch. A member cannot belong to more than one group. All loop device WWPNs must be included in the group, ...

13 – Command Reference Group 59183-01 A 13-27 A 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]. This keyword is available without an Admin sessi...

13 – Command Reference Group 13-28 59183-01 A S Examples The following is an example of the Group Add command: SANbox #> admin start SANbox (admin) #> security edit SANbox (admin-security) #> group add Group_1 A list of attributes with formatting and default values will follow Enter a new v...

13 – Command Reference Group 59183-01 A 13-29 A The following is an example of the Group List command: SANbox #> group list Group SecuritySet ----- ----------- group1 (ISL) alpha group2 (Port) alpha The following is an example of the Group Members command: SANbox #> group members group_1 Curre...

13 – Command Reference Hardreset 13-30 59183-01 A S Hardreset Resets the switch and performs a power-on self test. This reset disrupts I/O traffic, activates the pending firmware, and clears the alarm log. To save the alarm log before resetting, refer to the “Set Log” command on page 13-76 . Authori...

13 – Command Reference Help 59183-01 A 13-31 A Help 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 syst...

13 – Command Reference History 13-32 59183-01 A S History 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-exe...

13 – Command Reference Hotreset 59183-01 A 13-33 A Hotreset 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 a...

13 – Command Reference Image 13-34 59183-01 A S Image Manages and installs switch firmware. Authority Admin session Syntax image cleanupfetch [account_name] [ip_address] [file_source] [file_destination]installlisttftp [ip_address] [file_source] [file_destination]unpack [file] Keywords cleanup Remove...

13 – Command Reference Image 59183-01 A 13-35 A unpack [file] Installs the firmware file given by [file]. After unpacking the file, a message appears confirming successful unpacking. The switch must be reset for the new firmware to take effect. Notes To provide consistent performance throughout the ...

13 – Command Reference Lip 59183-01 A 13-37 A Lip 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: S...

13 – Command Reference Logout 13-38 59183-01 A S Logout Closes the Telnet session. Authority None Syntax logout Notes You can also enter Control-D to close the Telnet session.

13 – Command Reference Passwd 59183-01 A 13-39 A Passwd 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 a...

13 – Command Reference Ping 13-40 59183-01 A S Ping 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.25...

13 – Command Reference Ps 59183-01 A 13-41 A Ps Displays current system process information. Authority None Syntax ps Examples The following is an example of the Ps command: SANbox #> ps PID PPID %CPU TIME ELAPSED COMMAND 338 327 0.0 00:00:00 3-01:18:35 cns 339 327 0.0 00:00:01 3-01:18:35 ens 340...

13 – Command Reference Quit 13-42 59183-01 A S Quit Closes the Telnet session. Authority None Syntax quit Notes You can also enter Control-D to close the Telnet session.

13 – Command Reference Reset 59183-01 A 13-43 A Reset Resets the switch configuration parameters. If you omit the keyword, the default is Reset Switch. Authority Admin session Syntax reset config [config_name] factoryport [port_list]radiussecurityservicessnmpswitch (default)systemzoning Keywords con...

13 – Command Reference Reset 13-44 59183-01 A S factory Resets switch configuration, port configuration, port threshold alarm configuration, zoning configuration, SNMP configuration, system configuration, security configuration, RADIUS configuration, switch services configuration, and zoning to the ...

13 – Command Reference Reset 59183-01 A 13-45 A switch Resets the switch without a power-on self test. This is the default. This reset disrupts traffic and does the following: „ Activates the pending firmware. „ Closes all management sessions. „ Clears the event log. To save the event log before res...

13 – Command Reference Reset 13-46 59183-01 A S Notes The following tables specify the various factory default settings: Enter the Show Config Switch command to display switch configuration values. Table 13-5. Switch Configuration Defaults Parameter Default Admin State Online Broadcast Enabled True ...

13 – Command Reference Reset 13-50 59183-01 A S Enter the Show Setup Radius command to display RADIUS configuration values. Enter the Show Setup Services command to display switch service configuration values. Table 13-10. RADIUS Configuration Defaults Parameter Default DeviceAuthOrder Local UserAut...

13 – Command Reference Reset 59183-01 A 13-51 A Enter the Show Setup System command to display system configuration values. Enter the Show Config Security command to display security configuration values. Table 13-12. System Configuration Defaults Parameter Default Ethernet Network Enable True Ether...

13 – Command Reference Security 13-52 59183-01 A S Security Opens a Security Edit session in which to manage the security database on a switch. Refer to the “Group” command on page 13-22 and the “Securityset” command on page 13-56 . Authority Admin session. The keywords Active, History, Limits, and ...

13 – Command Reference Security 59183-01 A 13-53 A edit Initiates a Security Edit session in which to make changes to the security database. A Security Edit session enables you to use the Group and Securityset commands to create, add, and delete security sets, groups, and group members. To close a S...

13 – Command Reference Security 13-54 59183-01 A S Examples The following is an example of the Security Active command: SANbox #> security active Active Security Information SecuritySet Group GroupMember ----------- ----- ----------- alpha group1 (ISL) 10:00:00:00:00:10:21:16 Authentication Chap ...

13 – Command Reference Security 59183-01 A 13-55 A The following is an example of the Security Limits command: SANbox #> security limits Security Attribute Maximum Current [Name] ------------------ ------- ------- ------ MaxSecuritySets 4 1 MaxGroups 16 2 MaxTotalMembers 1000 19 MaxMembersPerGrou...

13 – Command Reference Securityset 13-56 59183-01 A S Securityset Manages security sets in the security database. Authority Admin session and a Security Edit session. Refer to the “Security” command on page 13-52 for information about starting a Security Edit session. The Active, Groups, and List ke...

13 – Command Reference Securityset 59183-01 A 13-57 A copy [security_set_source] [security_set_destination] Creates a new security set named [security_set_destination] and copies into it the membership from the security set given by [security_set_source]. create [security_set] Creates the security s...

13 – Command Reference Securityset 13-58 59183-01 A S Examples The following is an example of the Securityset Active command SANbox #> securityset active Active SecuritySet Information ------------------------------ ActiveSecuritySet alpha LastActivatedBy Remote LastActivatedOn day month date tim...

13 – Command Reference Set Alarm 59183-01 A 13-59 A Set Alarm Controls the display of alarms in the session output stream or clears the alarm log. Authority Admin session for the Clear keyword. Otherwise, none. Syntax set alarm [option] Keywords [option] [option] can be one of the following: clear C...

13 – Command Reference Set Beacon 13-60 59183-01 A S Set Beacon Enables or disables the flashing of the Logged-In LEDs for the purpose of locating a switch. Authority None Syntax set beacon [state] Keywords [state] [state] can be one of the following: on Enables the flashing beacon. off Disables the...

13 – Command Reference Set Config Port 59183-01 A 13-61 A Set Config Port 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...

13 – Command Reference Set Config Port 59183-01 A 13-65 A Examples The following is an example of the Set Config Port command: SANbox #> admin start SANbox (admin) #> config edit SANbox (admin-config) #> set config port 1 A list of attributes with formatting and current values will follow. ...

13 – Command Reference Set Config Security 59183-01 A 13-67 A Set Config Security 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 unles...

13 – Command Reference Set Config Security Portbinding 59183-01 A 13-69 A Set Config Security Portbinding Configures port binding. Authority Admin session and a Config Edit session Syntax set config security portbinding [port_number] Keywords [port_number] Initiates an editing session in which to ch...

13 – Command Reference Set Config Switch 13-70 59183-01 A S Set Config Switch 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 C...

13 – Command Reference Set Config Switch 59183-01 A 13-71 A Examples The following is an example of the Set Config Switch command: SANbox #> admin start SANbox (admin) #> config edit SANbox (admin-config) #> set config switch A list of attributes with formatting and default values will foll...

13 – Command Reference Set Config Threshold 13-72 59183-01 A S Set Config Threshold 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...

13 – Command Reference Set Config Threshold 59183-01 A 13-73 A Notes The switch will down a port if an alarm condition is not cleared within three consecutive sampling windows (by default 30 seconds). Reset the port to bring it back online. An alarm is cleared when the threshold monitoring detects t...

13 – Command Reference Set Config Zoning 13-74 59183-01 A S Set Config Zoning 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...

13 – Command Reference Set Config Zoning 59183-01 A 13-75 A Examples The following is an example of the Set Config Zoning command. SANbox #> admin start SANbox (admin) #> config edit The config named default is being edited. SANbox (admin-config) #> set config zoning A list of attributes wi...

13 – Command Reference Set Log 13-76 59183-01 A S Set Log 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...

13 – Command Reference Set Log 13-78 59183-01 A S 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 ...

13 – Command Reference Set Log 59183-01 A 13-79 A save Saves the log settings for the component, severity level, port, and display level. These settings remain in effect after a switch reset. The log settings can be viewed using the Show Log Settings command. To export log entries to a file, use the...

13 – Command Reference Set Pagebreak 13-80 59183-01 A S Set Pagebreak 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] Keywords [state] [s...

13 – Command Reference Set Pagebreak 59183-01 A 13-81 A Examples The following is an example of the Set Pagebreak command: SANbox #> set pagebreak on SANbox #> zone list Zone ZoneSet ---- ------- Zone1 alpha beta Zone2 delta echo Zone3 sierra tango Zone4 gamma delta Press any key to continue, ...

13 – Command Reference Set Port 13-82 59183-01 A S Set Port 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 or set port [port_number] bypass...

13 – Command Reference Set Port 59183-01 A 13-83 A speed [transmission_speed] Specifies the transmission speed for the specified port. Choose one of the following port speed values: 1Gb/s One gigabit per second. 2Gb/s Two gigabits per second. 4Gb/s Four gigabits per second. 10Gb/s Ten gigabits per s...

13 – Command Reference Set Setup Radius 13-84 59183-01 A S Set Setup Radius 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 13-20 describes the...

13 – Command Reference Set Setup Radius 13-86 59183-01 A S Examples The following is an example of the Set Setup RADIUS command: SANbox (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 cu...

13 – Command Reference Set Setup Services 59183-01 A 13-87 A Set Setup Services Configures services on the switch. Authority Admin session Syntax set setup services Prompts you in a line-by-line fashion to enable or disable switch services. Table 13-21 describes the switch service parameters. For ea...

13 – Command Reference Set Setup Services 59183-01 A 13-89 A Examples The following is an example of the Set Setup Services command: SANbox #> admin start SANbox (admin) #> set setup services A list of attributes with formatting and current values will follow. Enter a new value or simply press...

13 – Command Reference Set Setup SNMP 13-90 59183-01 A S Set Setup SNMP 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 13-22 describes the SNMP fields. For each parameter, enter a new val...

13 – Command Reference Set Setup SNMP 13-92 59183-01 A S Examples The following is an example of the Set Setup SNMP command: SANbox (admin) #> set setup snmp A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the current ...

13 – Command Reference Set Setup System 59183-01 A 13-93 A Set Setup System 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 13-23 describes the sy...

13 – Command Reference Set Setup System 13-94 59183-01 A S Examples The following is an example of the Set Setup System command: SANbox (admin) #> set setup system A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accept the cu...

13 – Command Reference Set Switch State 59183-01 A 13-95 A Set Switch State Changes the administrative state for all ports on the switch. The previous Set Config Switch settings are restored after a switch reset or a reactivation of a switch configuration. Authority Admin session Syntax set switch s...

13 – Command Reference Set Timezone 13-96 59183-01 A S Set Timezone Specifies the time zone for the switch and the workstation. The default is Universal Time (UTC) also known as Greenwich Mean Time (GMT). This keyword prompts you to choose a region, then a subregion to specify the time zone. Changin...

13 – Command Reference Show About 59183-01 A 13-97 A Show About Displays an introductory set of information about operational attributes of the switch. This command is equivalent to the Show Version command. Authority None Syntax show about Examples The following is an example of the Show About comm...

13 – Command Reference Show Alarm 13-98 59183-01 A S Show Alarm Displays the alarm log and session output stream display setting. Authority None Syntax show alarm settings Keywords settings Displays the status of the parameter that controls the display of alarms in the session output stream. This pa...

13 – Command Reference Show Broadcast 59183-01 A 13-99 A Show Broadcast 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: SANbo...

13 – Command Reference Show Chassis 13-100 59183-01 A S Show Chassis Displays chassis component status and temperature. Authority None Syntax show chassis Examples The following is an example of the Show Chassis command for model 5602. SANbox #> show chassis Chassis Information ------------------...

13 – Command Reference Show Config Port 59183-01 A 13-101 A Show Config Port Displays configuration parameters for one or more ports. Authority None Syntax show config port [port_number] Keywords [port_number] The number of the port. Ports are numbered beginning with 0. If you omit [port_number], al...

13 – Command Reference Show Config Security 59183-01 A 13-103 A Show Config Security Displays the security database configuration parameters. Authority None Syntax show config security Examples The following is an example of the Show Config Security command: SANbox #> show config security Configu...

13 – Command Reference Show Config Security Portbinding 13-104 59183-01 A S Show Config Security Portbinding Displays the port binding configuration for one or more ports. Authority None Syntax show config security portbinding [port_number] Keywords [port_number] The number of the port. If you omit ...

13 – Command Reference Show Config Switch 59183-01 A 13-105 A Show Config Switch Displays the switch configuration parameters. Authority None Syntax show config switch Examples The following is an example of the Show Config Switch command: SANbox #> show config switch Configuration Name: default ...

13 – Command Reference Show Config Threshold 13-106 59183-01 A S Show Config Threshold 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: SANbox #> show config threshold Configu...

13 – Command Reference Show Config Zoning 59183-01 A 13-107 A Show Config Zoning 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: SANbox #> show config zoning Configuration Nam...

13 – Command Reference Show Domains 13-108 59183-01 A S Show Domains Displays list of each domain and its worldwide name in the fabric. Authority None Syntax show domains Examples The following is an example of the Show Domains command: SANbox #> show domains Principal switch is (remote): 10:00:0...

13 – Command Reference Show Donor 59183-01 A 13-109 A Show Donor 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: SANbox #> show donor Port Config Ext Credit Max Credit ...

13 – Command Reference Show Fabric 13-110 59183-01 A S Show Fabric Displays list of each domain, symbolic name, worldwide name, node IP address, and port IP address. Authority None Syntax show fabric Examples The following is an example of the Show Fabric command: SANbox #> show fabric Domain WWN...

13 – Command Reference Show FDMI 59183-01 A 13-111 A Show FDMI Displays detailed information about the device host bus adapter. Authority None Syntax show fdmi [port_wwn] Keywords [port_wwn] The device world wide port name for which to display information. If you omit [port_wwn], the command display...

13 – Command Reference Show FDMI 13-112 59183-01 A S The following is an example of the Show FDMI WWN command: SANbox #> show fdmi 21:00:00:e0:8b:09:3b:17 FDMI Information ---------------- Manufacturer QLogic Corporation SerialNumber [04202 Model QLA2342 ModelDescription QLogic QLA2342 PCI Fibre ...

13 – Command Reference Show Interface 59183-01 A 13-113 A Show Interface Displays the status of the active network interfaces. Authority None Syntax show interface Examples The following is an example of the Show Interface command: SANbox #> show interface eth0 Link encap:Ethernet HWaddr 00:C0:DD...

13 – Command Reference Show Log 13-114 59183-01 A S Show Log 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, begin...

13 – Command Reference Show Log 59183-01 A 13-115 A 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. Warning Displays all warning events. Critical Disp...

13 – Command Reference Show Log 13-116 59183-01 A S port Displays the ports being monitored for events. If an event occurs which is of the defined level and on a defined component, but not on a defined port, no entry is made in the log. settings Displays the current filter settings for component, se...

13 – Command Reference Show LSDB 59183-01 A 13-117 A Show LSDB Displays Link State database information, Authority None Syntax show lsdb Examples The following is an example of the Show LSDB command: SANbox #> show lsdb Link State Database Information ------------------------------- LsID 34: Age=...

13 – Command Reference Show Media 13-118 59183-01 A S Show Media Displays transceiver operational and diagnostic information for one or more ports. Authority None Syntax show media [port_list]allinstalled Keywords [port_list] The port or ports for which to display transceiver information. [port_list...

13 – Command Reference Show Media 13-120 59183-01 A S Examples The following is an example of the Show Media command for port 4: SANbox #> show media 4 Port Number: 4 ------------- MediaType 400-M5-SN-I MediaVendor FINISAR CORP. MediaPartNumber FTRJ8524P2BNL MediaRevision A MediaSerialNumber P6G2...

13 – Command Reference Show Media 59183-01 A 13-121 A The following is an example of the Show Media command for all ports: SANbox #> show media Note: -- LowAlarm; - LowWarning; + HighWarning; ++ HighAlarm Port Vendor Name Temp Voltage Tx Bias Tx Pwr Rx Pwr Num (C) (V) (mA) (mW) (mW) ---- --------...

13 – Command Reference Show Mem 13-122 59183-01 A S Show Mem Displays information about memory activity. Authority None Syntax show mem [count] Keywords [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 ...

13 – Command Reference Show NS 59183-01 A 13-123 A Show NS Displays the WWNs for devices in the fabric. Authority None Syntax show ns [option] Keywords [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...

13 – Command Reference Show Pagebreak 59183-01 A 13-125 A Show Pagebreak Displays the current pagebreak setting. Authority None Syntax show pagebreak Notes The pagebreak setting limits the display of information to 20 lines or allows the continuous display of information without a break. Examples Th...

13 – Command Reference Show Perf 13-126 59183-01 A S Show Perf 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. Transmi...

13 – Command Reference Show Perf 13-128 59183-01 A S Examples The following is an example of the Show Perf command: SANbox #> show perf Port Bytes/s Bytes/s Bytes/s Frames/s Frames/s Frames/s Number (in) (out) (total) (in) (out) (total) ------ ------- ------- ------- -------- -------- -------- 0 ...

13 – Command Reference Show Port 59183-01 A 13-129 A Show Port Displays operational information for one or more ports. Authority None Syntax show port [port_list] Keywords [port_list] The number of the port for which to display information. [port_list] can be a set of port numbers and ranges delimit...

13 – Command Reference Show Port 59183-01 A 13-133 A Examples The following is an example of the Show Port command: SANbox #> show port 1 Port Number: 1 ------------ AdminState Online OperationalState Offline AsicNumber 0 PerfTuningMode Normal AsicPort 0 PortID 220000 ConfigType GL PortWWN 20:00:...

13 – Command Reference Show Post Log 13-134 59183-01 A S Show Post Log Displays the Power On Self Test (POST) log which contains results from the most recently failed POST. Authority None Syntax show post log Examples The following is an example of the Show Post Log command: SANbox #> show post l...

13 – Command Reference Show Setup Mfg 59183-01 A 13-135 A Show Setup Mfg Displays manufacturing information about the switch. Authority None Syntax show setup mfg Examples The following is an example of the Show Setup Mfg command for a model 5600 switch: SANbox #> show setup mfg Manufacturing Inf...

13 – Command Reference Show Setup Radius 13-136 59183-01 A S Show Setup Radius Displays RADIUS server information. Authority None Syntax show setup radius Examples The following is an example of the Show Setup RADIUS command: SANbox #> show setup radius Radius Information ------------------ Devic...

13 – Command Reference Show Setup Services 59183-01 A 13-137 A Show Setup Services Displays switch service status information. Authority None Syntax show setup services Examples The following is an example of the Show Setup Services command: SANbox #> show setup services System Services ---------...

13 – Command Reference Show Setup SNMP 13-138 59183-01 A S Show Setup SNMP Displays the current SNMP settings. Authority None Syntax show setup snmp The following is an example of the Show Setup Snmp command: SANbox #> show setup snmp SNMP Information ---------------- SNMPEnabled True Contact <...

13 – Command Reference Show Setup System 59183-01 A 13-139 A Show Setup System Displays the current system settings. Authority None Syntax show setup system Examples The following is an example of the Show Setup System command: SANbox #> show setup system System Information ------------------ Eth...

13 – Command Reference Show Steering 13-140 59183-01 A S Show Steering Displays the routes that data takes in the fabric. Authority None Syntax show steering [domain_id] Keywords [domain_id] The domain ID for which to display route information. If you omit [domain_id], the system displays routes for...

13 – Command Reference Show Switch 59183-01 A 13-141 A Show Switch Displays switch operational information. Authority None Syntax show switch Notes Table 13-27 describes the switch operational parameters. Table 13-27. Switch Operational Parameters Parameter Description SymbolicName Descriptive name ...

13 – Command Reference Show Switch 13-142 59183-01 A S Examples The following is an example of the Show Switch command: SANbox #> show switch Switch Information ------------------ SymbolicName SANbox SwitchWWN 10:00:00:c0:dd:00:bc:56 BootVersion Vx.x.x.x-0 (day month date time year) CreditPool 0 ...

13 – Command Reference Show Timezone 59183-01 A 13-143 A Show Timezone Displays the current time zone setting. Authority None Syntax show timezone Examples The following is an example of the Show Timezone command: SANbox #> show timezone America/Chicago

13 – Command Reference Show Topology 13-144 59183-01 A S Show Topology Displays all connected devices. Authority None Syntax show topology Examples The following is an example of the Show Topology command: SANbox #> show topology Unique ID Key ------------- A = ALPA, D = Domain ID, P = Port ID Po...

13 – Command Reference Show Topology 59183-01 A 13-145 A The following is an example of the Show Topology command for port 1: SANbox #> show topology 1 Local Link Information ---------------------- PortNumber 1 PortID 650100 PortWWN 20:01:00:c0:dd:00:91:11 PortType F Remote Link Information -----...

13 – Command Reference Show Users 13-146 59183-01 A S Show Users 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: SANbox #> show users User Ethernet Addr-Port Logged in...

13 – Command Reference Show Version 59183-01 A 13-147 A Show Version Displays an introductory set of information about operational attributes of the switch. This command is equivalent to the Show About command. Authority None Syntax show version Examples The following is an example of the Show Versi...

13 – Command Reference Shutdown 13-148 59183-01 A S Shutdown 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 When the shutdown is complete, the Hea...

13 – Command Reference Test Cancel 59183-01 A 13-149 A Test Cancel Cancels a port test that is in progress. Authority Admin session Syntax test cancel port [port_number] Keywords port [port_number] Cancel the test for the port given by [port_number]. [port_number] can be 0–19. Examples The following...

13 – Command Reference Test Port 13-150 59183-01 A S Test Port Tests individual ports using an offline or online test. Authority Admin session Syntax test port [port_number] offline [loopback_type]online Keywords [port_number] The port to be tested. [port_number] can be 0–19. offline [loopback_type]...

13 – Command Reference Test Port 59183-01 A 13-151 A Notes Table 13-28 describes the port test parameters. To cancel a port test that is in progress, enter the Test Cancel Port command. To display the status of the most recent port test or port test in progress, enter the Test Status Port command. T...

13 – Command Reference Test Port 13-152 59183-01 A S Examples The following example performs an online test on port 1: SANbox #> admin start SANbox (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...

13 – Command Reference Test Status 59183-01 A 13-153 A Test Status Displays the status of a test in progress, or if there is no test in progress, the status of the test that was executed last. Authority None Syntax test status port [port_number] Keywords port [port_number] Display test status for th...

13 – Command Reference Uptime 13-154 59183-01 A S Uptime 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 uptime Examples The following i...

13 – Command Reference User 59183-01 A 13-155 A User 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 accountsadddelete [account_name]editlist Keywords ac...

13 – Command Reference User 13-156 59183-01 A S Notes Authority level or password changes that you make to an account that is currently logged in do not take effect until that account logs in again. Examples The following is an example of the User Accounts command: SANbox (admin) #> user accounts...

13 – Command Reference User 59183-01 A 13-157 A The following is an example of the User Delete command: SANbox (admin) #> user del user3 The user account will be deleted. Please confirm (y/n): [n] y The following is an example of the User List command: SANbox (admin) #> user list User Ethernet...

13 – Command Reference Whoami 13-158 59183-01 A S Whoami Displays the account name, session number, and switch domain ID for the Telnet session. Authority None Syntax whoami Examples The following is an example of the Whoami command: SANbox #> whoami User name : admin@session2 Switch name : SANbo...

13 – Command Reference Zone 59183-01 A 13-159 A Zone Manages zones and zone membership on a switch. Authority Admin session and a Zoning Edit session. Refer to the “Zoning” command on page 13-166 for information about starting a Zoning Edit session. The List, Members, and Zonesets keywords are avail...

13 – Command Reference Zone 59183-01 A 13-161 A Examples The following is an example of the Zone List command: SANbox #> zone list Zone ZoneSet ------------------- wwn_b0241f zone_set_1 wwn_23bd31 zone_set_1 wwn_221416 zone_set_1 wwn_2215c3 zone_set_1 wwn_0160ed zone_set_1 wwn_c001b0 zone_set_1 w...

13 – Command Reference Zone 13-162 59183-01 A S The following is an example of the Zone Zonesets command: SANbox #> zone zonesets zone1 Current List of ZoneSets for Zone: zone1 ---------------------------------- zone_set_1

13 – Command Reference Zoneset 59183-01 A 13-163 A Zoneset Manages zone sets and component zones across the fabric. Authority Admin session and a Zoning Edit session. Refer to the “Zoning” command on page 13-166 for information about starting a Zoning Edit session. The Active, List, and Zones keywor...

13 – Command Reference Zoneset 13-164 59183-01 A S deactivate Deactivates the active zone set. Close the Zoning Edit session before using this keyword. delete [zone_set] Deletes the zone set given by [zone_set]. If the specified zone set is active, the command is suspended until the zone set is deac...

13 – Command Reference Zoneset 59183-01 A 13-165 A Examples The following is an example of the Zoneset Active command: SANbox #> zoneset active ActiveZoneSet Bets LastActivatedBy admin@OB-session6 LastActivatedOn day month date time year The following is an example of the Zoneset List command: SA...

13 – Command Reference Zoning 13-166 59183-01 A S Zoning Opens a Zoning Edit session in which to create and manage zone sets and zones. Refer to the “Zone” command on page 13-159 and the “Zoneset” command on page 13-163 . Authority Admin session except for the Active, History, Limits, and List keywo...

13 – Command Reference Zoning 59183-01 A 13-167 A edit Opens a Zoning Edit session. 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 us...

13 – Command Reference Zoning 13-168 59183-01 A S restore Restores the volatile zoning database with the contents of the non-volatile zoning database. If the InteropAutoSave parameter is False (see Table 13-8 ), you can use this keyword to revert changes to the volatile zoning database that were pro...

13 – Command Reference Zoning 59183-01 A 13-169 A The following is an example of the Zoning Limits command: SANbox #> zoning limits Zoning Attribute Maximum Current [Zoning Name] ---------------- ------- ------- ------------- MaxZoneSets 256 6 MaxZones 2000 17 MaxAliases 2500 1 MaxTotalMembers 10...

13 – Command Reference Zoning 13-170 59183-01 A S The following is an example of the Zoning List command: SANbox #> zoning list Active ZoneSet Information ZoneSet Zone ZoneMember -------------------------------- wwn wwn_b0241f 50:06:04:82:bf:d2:18:c2 50:06:04:82:bf:d2:18:d2 21:00:00:e0:8b:02:41:2...

59183-01 A Index-5 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide A logout errors 6-10loop port bypass 13-82enable 13-82initialization 13-37 loss-of-signal errors 6-10 M maintenance mode account name 3-1 Management Server group 9-1, 9-12, 13-25service 13-89 manufacturer informa...

SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide Index-10 59183-01 A S Test Port command 13-150 example 6-12 Test Status command 13-153TFTP - See Trivial File Transfer Protocoltime between resets 5-4set and display 5-17, 13-13zone 13-96, 13-143 time zone 5-17timeout Admin session...

59183-01 A Index-11 SANbox 5000 Series Fibre Channel Switch Command Line Interface Guide A zone set activate 7-14, 13-163active 7-1, 7-4, 13-166add member zone 13-163add zones 7-14configured 7-2copy 7-14, 13-163create 7-13, 13-163deactivate 7-15, 13-45, 13-164definition 7-1delete 7-13, 13-164delete ...