QLogic 5802V - Manual

59263-01 A Page v SANbox 5802V Fibre Channel Switch Command Line Interface Guide A Backing Up and Restoring a Switch Configuration . . . . . . . . . . . . . . . 5-14 Creating the Backup File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15 Downloading the Configuration File . . . . ....

Page vi 59263-01 A SANbox 5802V Fibre Channel Switch Command Line Interface Guide S Display Port Test Results. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15 Cancel a Port Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15 7 Zoning Con...

59263-01 A Page vii SANbox 5802V Fibre Channel Switch Command Line Interface Guide A Copy an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-20 Add Members to an Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-20 Remove Member...

Page viii 59263-01 A SANbox 5802V Fibre Channel Switch Command Line Interface Guide S 11 Event Log Configuration Starting and Stopping Event Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-2 Displaying the Event Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ....

59263-01 A Page ix SANbox 5802V Fibre Channel Switch Command Line Interface Guide A Create an SNMP Version 3 User Account . . . . . . . . . . . . . . . . . . . . . . 13-7 Display SNMP Version 3 User Accounts . . . . . . . . . . . . . . . . . . . . . . . 13-7 Modify an SNMP Version 3 User Account . ....

Page xii 59263-01 A SANbox 5802V Fibre Channel Switch Command Line Interface Guide S Zoning Merged . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-221Zoning Restore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-222Zoning...

1 – Introduction Intended Audience 1-2 59263-01 A S Intended Audience This guide is intended for individuals who are responsible for installing and servicing Fibre Channel equipment using the command line interface. Related Materials The following manuals and materials are referenced in the text and...

1 – Introduction Technical Support 59263-01 A 1-3 A 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 main...

1 – Introduction Technical Support 1-4 59263-01 A S Contact Information Support Headquarters QLogic Corporation4601 Dean Lakes BoulevardShakopee, MN 55379USA QLogic Web Site www.qlogic.com Technical Support Web Site support.qlogic.com Technical Support Email [email protected] Technical Training Ema...

59263-01 A 2-1 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 this docum...

2 – Command Line Interface Usage Logging In to the Switch 2-2 59263-01 A S Logging In to the Switch To log in to a switch through Telnet, do the following: 1. Open a command line window on the workstation and enter the Telnet command followed by the switch IP address. The IP address can be one of th...

2 – Command Line Interface Usage Opening and Closing an Admin Session 59263-01 A 2-3 A 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 configu...

2 – Command Line Interface Usage Entering Commands 2-4 59263-01 A S Entering Commands The command-line completion feature makes entering and repeating commands easier. Table 2-1 describes the command-line completion keystrokes. Getting Help To display help for a command, enter the Help command follo...

2 – Command Line Interface Usage Setting Page Breaks 59263-01 A 2-5 A 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 by turning on page breaks. By default, page breaks are turned off...

2 – Command Line Interface Usage Creating a Support File 2-6 59263-01 A S 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, which...

2 – Command Line Interface Usage Downloading and Uploading Files 59263-01 A 2-7 A If your workstation does not have an FTP server, enter the Create Support command to create the support file, and then use FTP to download the support file from the switch to your workstation, as shown in the following...

2 – Command Line Interface Usage Downloading and Uploading Files 2-8 59263-01 A S 3. Set binary mode and use the Get command to download the file (configdata). ftp>bin ftp>get configdata xxxxx bytes sent in xx secs. ftp>quit To upload a file from the workstation to the switch, do the follow...

59263-01 A 3-1 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 special purpos...

3 – User Account Configuration Displaying User Account Information 3-2 59263-01 A S 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 following ex...

3 – User Account Configuration Creating User Accounts 59263-01 A 3-3 A 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: the first character must be alphanumeric; the remaining characters must b...

3 – User Account Configuration Modifying User Accounts and Passwords 3-4 59263-01 A S 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 own pa...

59263-01 A 4-1 4 Network Configuration Network configuration consists of the IP parameters that identify the switch in the network and provide for IP security. This section describes the following network configuration tasks: „ Displaying the Network Configuration „ Configuring the Ethernet Port „ V...

4 – Network Configuration Configuring the Ethernet Port 4-2 59263-01 A S The Show Setup System command displays the entire switch network configuration, which includes the following: „ IP configurations (versions 4 and 6) „ DNS server configuration To display specific information, add the correspond...

4 – Network Configuration Configuring the Ethernet Port 4-4 59263-01 A S IP Version 6 Configuration The switch supports IP version 6, which includes the following: „ Network discovery method „ IP address „ IP gateway address The network discovery method determines how the switch acquires its IP addr...

4 – Network Configuration Configuring the Ethernet Port 59263-01 A 4-5 A DNS Server Configuration A DNS server manages the host names for a fabric. This enables you to specify servers and switches by a meaningful name rather than IP address. To configure a DNS server, enter the Set Setup System Dns ...

4 – Network Configuration Verifying a Switch in the Network 4-6 59263-01 A S 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.11.57. SANbox #&...

4 – Network Configuration Managing IP Security 59263-01 A 4-7 A To remove all IP security policies and associations, enter the Reset Ipsec command. SANbox (admin) #> reset ipsec The following subsections present IP security concepts and management tasks: „ IP Security Concepts „ Displaying IP Sec...

4 – Network Configuration Managing IP Security 4-8 59263-01 A S A security association defines the encryption algorithm and encryption key to apply when called by a security policy. A security policy may call several associations at different times, but each association is related to only one policy...

4 – Network Configuration Managing IP Security 59263-01 A 4-9 A The following example displays all active policies and associations: SANbox #> ipsec list Active IPsec Information Security Association Database ----------------------------- h2h-sh-sa h2h-hs-sa Security Policy Database -------------...

4 – Network Configuration Managing IP Security 4-10 59263-01 A S IP Security Configuration Limits To display a summary of the objects in the IP Security configuration and their maximum limit, enter the Ipsec Limits command to as shown in the following example: SANbox #> ipsec limits Configured (s...

4 – Network Configuration Managing IP Security 59263-01 A 4-11 A Creating a Policy To create a policy, enter the Ipsec Policy Create command as shown in the following example: SANbox #> admin start SANbox (admin) #> ipsec edit SANbox (admin-ipsec) #> ipsec policy create h2h-sh-sp A list of ...

4 – Network Configuration Managing IP Security 4-12 59263-01 A S Deleting a Policy To delete a user-defined policy, enter the Ipsec Policy Delete command as shown in the following example: SANbox #> admin start SANbox (admin) #> ipsec edit SANbox (admin-ipsec) #> ipsec policy delete policy_...

4 – Network Configuration Managing IP Security 59263-01 A 4-13 A Modifying a User-Defined Policy To modify an existing user-defined policy, enter the Ipsec Policy Edit command in an Admin session and an Ipsec Edit session as shown in the following example. An asterisk (*) indicates a required entry....

4 – Network Configuration Managing IP Security 4-14 59263-01 A S Renaming a User-Defined Policy To rename a policy (policy_1), enter the Ipsec Policy Rename command as shown in the following example: SANbox #> admin start SANbox (admin) #> ipsec edit SANbox (admin-ipsec) #> ipsec policy ren...

4 – Network Configuration Managing IP Security 59263-01 A 4-15 A Creating an Association To create an association, enter the Ipsec Association Create command as shown in the following example: SANbox #> admin start SANbox (admin) #> ipsec edit SANbox (admin-ipsec) #> ipsec association creat...

4 – Network Configuration Managing IP Security 4-16 59263-01 A S Deleting an Association To delete a user-defined association, enter the Ipsec Association Delete command as shown in the following example: SANbox #> admin start SANbox (admin) #> ipsec edit SANbox (admin-ipsec) #> ipsec assoc...

4 – Network Configuration Managing IP Security 59263-01 A 4-17 A Modifying a User-Defined Association To modify an existing user-defined association, enter the Ipsec Association Edit command in an Admin session and an Ipsec Edit session as shown in the following example. An asterisk (*) indicates a ...

4 – Network Configuration Managing IP Security 4-18 59263-01 A S Renaming a User-Defined Association To rename a user-defined association (associaton_1), enter the Ipsec Association Rename command as shown in the following example: SANbox #> admin start SANbox (admin) #> ipsec edit SANbox (adm...

4 – Network Configuration Managing IP Security 4-20 59263-01 A S Notes

59263-01 A 5-1 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 „ Testing a Switch „ Verify...

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

5 – Switch Configuration Displaying Switch Information 59263-01 A 5-3 A 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 ...

5 – Switch Configuration Displaying Switch Information 5-4 59263-01 A S 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 PPID %CPU...

5 – Switch Configuration Displaying Switch Information 59263-01 A 5-5 A 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 this co...

5 – Switch Configuration Displaying Switch Information 5-6 59263-01 A S Switch Configuration Parameters Enter the Show Config Switch command to display the switch configuration parameters. These parameters determine the operational characteristics of the switch. Refer to Table 14-22 for a descriptio...

5 – Switch Configuration Displaying Switch Information 59263-01 A 5-7 A Security Configuration Parameters Enter the Show Config Security command to display security configuration and port binding parameters. These parameters determine how security is applied to the switch. Refer to Table 14-20 for a...

5 – Switch Configuration Displaying Switch Information 5-8 59263-01 A S 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. SANbox #> show chassis Chassis Information -----...

5 – Switch Configuration Displaying Switch Information 59263-01 A 5-9 A 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 5-10 59263-01 A S 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 Service...

5 – Switch Configuration Managing Switch Configurations 5-12 59263-01 A S Managing Switch Configurations The switch configuration determines the basic operational characteristics of the switch. A switch can save up to 10 configurations including the default configuration, named Default Config. The c...

5 – Switch Configuration Managing Switch Configurations 59263-01 A 5-13 A Deleting a Switch Configuration Enter the Config Delete command in an Admin session to delete a configuration from the switch as shown in the following example. You cannot delete the active configuration nor the default config...

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

5 – Switch Configuration Managing Switch Configurations 59263-01 A 5-15 A Creating the Backup File The Config Backup command creates a file on the switch, named configdata . This file can be used to restore a switch configuration only from the command line interface; it cannot be used to restore a s...

5 – Switch Configuration Managing Switch Configurations 5-16 59263-01 A S 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 the conf...

5 – Switch Configuration Paging a Switch 59263-01 A 5-17 A 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 turn ...

5 – Switch Configuration Setting the Date and Time 5-18 59263-01 A S 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 America/North Dakota, for example), enter the Set Timezone command in an Admin ses...

5 – Switch Configuration Setting the Date and Time 59263-01 A 5-19 A Setting the Date and Time through NTP 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 Ntp command in an Admin session to enable the NTP client o...

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

5 – Switch Configuration Installing Firmware 59263-01 A 5-21 A Non-disruptive Activation You can load and activate firmware upgrades on an operating switch without disrupting data traffic or having to re-initialize attached devices. If the non-disruptive activation fails, you will usually be prompte...

5 – Switch Configuration Installing Firmware 5-22 59263-01 A S One-Step Firmware Installation The Firmware Install and Image Install commands download the firmware image file from an FTP or TFTP server to the switch, unpacks the image file, and performs a disruptive activation in one step. The one-s...

5 – Switch Configuration Installing Firmware 5-24 59263-01 A S 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...

5 – Switch Configuration Testing a Switch 59263-01 A 5-25 A 5. A message will prompt you to reset the switch to activate the firmware. Use the Hotreset command to attempt a non-disruptive activation. SANbox (admin) $> hotreset Testing a Switch You can test all ports on a switch using the Test Swi...

5 – Switch Configuration Testing a Switch 5-26 59263-01 A S Offline Tests for Switches An offline test is a disruptive test that exercises all port connections for a switch in the diagnostics state. You must place the switch in the diagnostics state using the Set Switch State command before starting...

5 – Switch Configuration Testing a Switch 59263-01 A 5-27 A Connectivity Tests for Switches A connectivity test is a disruptive test that exercises all port and inter-port connections for a switch in the diagnostics state. You must place the switch in the diagnostics state using the Set Switch State...

5 – Switch Configuration Verifying and Tracing Fibre Channel Connections 5-28 59263-01 A S Displaying Switch Test Status You can display the test status while the test is in progress by entering the Test Status Switch command as shown in the following example: SANbox (admin) #> test status switch...

5 – Switch Configuration Managing Switch Feature Upgrades 59263-01 A 5-29 A 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#> fctrace 970400 970e00 h...

5 – Switch Configuration Managing Idle Session Timers 5-30 59263-01 A S Displaying Feature Licenses Enter the Feature Log command to display the license keys that are installed on your switch as shown in the following example: SANbox #> feature log Mfg Feature Log: ---------------- Switch License...

59263-01 A 6-1 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 Displaying Port Information You can display the following p...

6 – Port Configuration Displaying Port Information 6-2 59263-01 A S 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 14-19 for a description of these p...

6 – Port Configuration Displaying Port Information 59263-01 A 6-3 A 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 Normal Asi...

6 – Port Configuration Displaying Port Information 6-4 59263-01 A S 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 Table ...

6 – Port Configuration Displaying Port Information 59263-01 A 6-5 A 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 an inst...

6 – Port Configuration Modifying Port Operating Characteristics 6-6 59263-01 A S 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 14-39 for a description of the transceiver informa...

6 – Port Configuration Port Binding 59263-01 A 6-9 A 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 32 are refused access to the port. Enter the Show Config Security Portbinding c...

6 – Port Configuration Resetting a Port 6-10 59263-01 A S 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 ...

6 – Port Configuration Configuring Port Threshold Alarms 59263-01 A 6-11 A 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 (CRC) ...

6 – Port Configuration Testing a Port 59263-01 A 6-13 A 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 „ D...

6 – Port Configuration Testing a Port 6-14 59263-01 A S 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: interna...

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

7 – Zoning Configuration Displaying Zoning Database Information 7-2 59263-01 A S Displaying Zoning Database Information A switch maintains three zoning databases: „ Non-volatile–This zoning database is permanent and contains all zone sets, zones, and aliases that you create and save on a switch. The...

7 – Zoning Configuration Displaying Zoning Database Information 7-4 59263-01 A S Active Zone Set Information The Zoning List 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 followin...

7 – Zoning Configuration Displaying Zoning Database Information 59263-01 A 7-5 A Merged Zone Set Information A merged zone set is a zone set that is received from another switch as a result of a change in active zone sets. You can display the merged zone set on your switch if the MergeAutoSave param...

7 – Zoning Configuration Displaying Zoning Database Information 7-6 59263-01 A S Zone Set Membership Information The Zoneset Zones, Zone List, 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 s...

7 – Zoning Configuration Displaying Zoning Database Information 59263-01 A 7-7 A Zone Membership Information Enter the Zone Members command to display the members for a specified zone as shown in the following example: SANbox #> zone members wwn_b0241f Current List of Members for Zone: wwn_b0241f...

7 – Zoning Configuration Displaying Zoning Database Information 7-8 59263-01 A S 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 59263-01 A 7-9 A 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 Configured (saved i...

7 – Zoning Configuration Configuring the Zoning Database 7-10 59263-01 A S 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 are a...

7 – Zoning Configuration Modifying the Zoning Database 7-12 59263-01 A S Modifying the Zoning Database To modify the non-volatile 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...

7 – Zoning Configuration Saving the Active and Merged Zone Sets 59263-01 A 7-13 A Saving the Active and Merged Zone Sets You can save the active zone set and merged zone set to the non-volatile zoning database. Enter the Zoning Active Capture to save the active zone set as shown in the following exa...

7 – Zoning Configuration Removing Inactive Zone Sets, Zones, and Aliases 7-14 59263-01 A S Removing Inactive Zone Sets, Zones, and Aliases Enter the Zoning Delete Orphans command to delete all objects from the zoning database except those in the active zone set. SANbox #> admin start SANbox (admi...

7 – Zoning Configuration Managing Zone Sets 59263-01 A 7-15 A Delete a Zone Set Enter the Zoneset Delete command to delete a zone set as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoning) #> zoneset delete zoneset_1 SANbox (admin-zoning...

7 – Zoning Configuration Managing Zones 7-16 59263-01 A S Remove Zones from a Zone Set Enter the Zoneset Remove command to remove zones from a zone set as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoning) #> zoneset remove zoneset_1 zo...

7 – Zoning Configuration Managing Zones 59263-01 A 7-17 A Create a Zone Enter the Zone Create command to create a new zone as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoning) #> zone create zone_1 SANbox (admin-zoning) #> zoning sa...

7 – Zoning Configuration Managing Zones 7-18 59263-01 A S Add Members to a Zone Enter the Zone Add command to add ports/devices to zone_1 as shown in the following example: SANbox #> admin start SANbox (admin) #> zoning edit SANbox (admin-zoning) #> zone add zone_1 alias_1 1,4 1,5 SANbox (a...

7 – Zoning Configuration Managing Aliases 59263-01 A 7-19 A 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 session an...

7 – Zoning Configuration Managing Aliases 7-20 59263-01 A S 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 SANbo...

8 – Connection Security Configuration Managing SSL and SSH Services 8-2 59263-01 A S Managing SSL and SSH Services Consider the following when enabling SSH and SSL services: „ To establish a secure Telnet connection, your workstation must use an SSH client. „ To enable secure SSL connections, you mu...

8 – Connection Security Configuration Displaying SSL and SSH Services 59263-01 A 8-3 A 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 ---------...

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

9 – Device Security Configuration Displaying Security Database Information 9-4 59263-01 A S 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 group m...

9 – Device Security Configuration Displaying Security Database Information 59263-01 A 9-5 A 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 for a ...

9 – Device Security Configuration Displaying Security Database Information 9-6 59263-01 A S 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 Databas...

9 – Device Security Configuration Configuring the Security Database 59263-01 A 9-7 A 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 configuratio...

9 – Device Security Configuration Modifying the Security Database 59263-01 A 9-9 A 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 throug...

9 – Device Security Configuration Resetting the Security Database 9-10 59263-01 A S Resetting the Security Database There are two ways to remove all groups and security sets from the security database: „ Enter the Security Clear command as shown in the following example: SANbox (admin-security) #>...

9 – Device Security Configuration Managing Groups 9-12 59263-01 A S 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 req...

9 – Device Security Configuration Managing Groups 59263-01 A 9-13 A Add Members to a Group Adding a member to a group involves specifying a group, the member worldwide name, and the member attributes. The member attributes define the authentication method, encryption method, secrets, and fabric bind...

9 – Device Security Configuration Managing Groups 9-14 59263-01 A S 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. „ For ISL ...

10 – RADIUS Server Configuration Displaying RADIUS Server Information 10-2 59263-01 A S Displaying RADIUS Server Information Enter the Show Setup Radius command to display RADIUS server information as shown in the following example. Refer to Table 14-26 for a description of the RADIUS configuration ...

10 – RADIUS Server Configuration Configuring a RADIUS Server on the Switch 59263-01 A 10-3 A Configuring a RADIUS Server on the Switch Enter the Set Setup Radius command to configure a RADIUS server on the switch. There are two groups of RADIUS configuration parameters. One group of parameters is co...

10 – RADIUS Server Configuration Configuring a RADIUS Server on the Switch 10-4 59263-01 A S The following example configures RADIUS server 1: SANbox (admin) #> set setup radius server 1 A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENT...

11 – Event Log Configuration Starting and Stopping Event Logging 11-2 59263-01 A S Starting and Stopping Event Logging Enter the Set Log Stop command in an Admin session to stop recording event messages in the switch Log as shown in the following example: SANbox (admin) #> set log stop Enter the ...

11 – Event Log Configuration Displaying the Event Log 59263-01 A 11-3 A The following is an example of the Show Log command: SANbox #> show log [327][day month date time year][I][Eport Port:0/8][Eport State= E_A0_GET_DOMAIN_ID] [328][day month date time year][I][Eport Port: 0/8][FSPF PortUp state...

11 – Event Log Configuration Managing the Event Log Configuration 11-4 59263-01 A S Controlling Messages in the Output Stream Enter the Set Log Display command in an Admin session to specify the severity level filter to use to determine what messages are automatically displayed on the screen when th...

11 – Event Log Configuration Clearing the Event Log 59263-01 A 11-5 A 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 59263-01 A S 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 remote ho...

11 – Event Log Configuration Creating and Downloading a Log File 59263-01 A 11-7 A 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 download ...

59263-01 A 12-1 12 Call Home Configuration This section describes the following topics: „ Call Home Concepts „ Configuring the Call Home Service „ Managing the Call Home Database „ Testing a Call Home Profile „ Changing SMTP Servers „ Clearing the Call Home Message Queue „ Resetting the Call Home Da...

12 – Call Home Configuration Call Home Concepts 12-2 59263-01 A S Call Home Requirements In addition to enabling the Call Home service, you must also do the following to ensure that email messages can be sent: „ Configure the Call Home service. The Call Home service configuration consists of primary...

12 – Call Home Configuration Call Home Concepts 59263-01 A 12-3 A Call Home Messages The Call Home service generates email messages for the specified event severity level and the following switch actions: „ Switch comes online „ Switch goes offline „ Reboot „ Power up „ Power down 1 „ SFP failure Wh...

12 – Call Home Configuration Call Home Concepts 12-4 59263-01 A S The following is an example of a full-text email including profile and SNMP contact information: From: [email protected] [mailto:[email protected]] Sent: Wednesday, July 25, 2007 5:03 PM Subject: [CallHome: Test] Alarm generated on Sw...

12 – Call Home Configuration Configuring the Call Home Service 59263-01 A 12-5 A Configuring the Call Home Service Enter the Set Setup Callhome command in an Admin session to configure the Call Home service as shown in the following example. Refer to Table 14-25 for a description of the Call Home se...

12 – Call Home Configuration Managing the Call Home Database 12-6 59263-01 A S Enter the Show Setup Callhome command to display the Call Home service configuration as shown in the following example. SANbox #> show setup callhome Callhome Information -------------------- PrimarySMTPServerAddr 0.0....

12 – Call Home Configuration Managing the Call Home Database 59263-01 A 12-7 A The Admin End command releases the Admin session for other administrators when you are done making changes to the switch. To remove all Call Home profiles and restore the Call Home service configuration to its factory sta...

12 – Call Home Configuration Managing the Call Home Database 59263-01 A 12-9 A Creating a Profile Enter the Profile Create command to create a Call Home profile as shown in the following example: SANbox #> admin start SANbox (admin) #> callhome edit SANbox (admin-callhome) #> profile create...

12 – Call Home Configuration Managing the Call Home Database 12-10 59263-01 A S Deleting a Profile Enter the Profile Delete command to delete a Call Home profile as shown in the following example: SANbox #> admin start SANbox (admin) #> callhome edit SANbox (admin-callhome) #> profile delet...

12 – Call Home Configuration Managing the Call Home Database 59263-01 A 12-11 A Modifying a Profile Enter the Profile Edit command to modify an existing Call Home profile as shown in the following example: SANbox #> admin start SANbox (admin) #> callhome edit SANbox (admin-callhome) #> prof...

12 – Call Home Configuration Managing the Call Home Database 12-12 59263-01 A S Renaming a Profile Enter the Profile Rename command to rename profile_1 as shown in the following example: SANbox #> admin start SANbox (admin) #> callhome edit SANbox (admin-callhome) #> profile rename profile_...

12 – Call Home Configuration Managing the Call Home Database 59263-01 A 12-13 A Adding a Data Capture Configuration Enter the Capture Add command to add a data capture configuration to the Tech_Support_Center profile as shown in the following example. If the Tech_Support_Center profile does not exis...

12 – Call Home Configuration Managing the Call Home Database 12-14 59263-01 A S Modifying a Data Capture Configuration Enter the Capture Edit command to modify a data capture configuration in the Tech_Support_Center profile as shown in the following example: SANbox #> admin start SANbox (admin) #...

12 – Call Home Configuration Testing a Call Home Profile 59263-01 A 12-15 A Deleting a Data Capture Configuration Enter the Capture Remove command to delete a data capture configuration from the Tech_Support_Center profile as shown in the following example: SANbox #> admin start SANbox (admin) #&...

12 – Call Home Configuration Changing SMTP Servers 12-16 59263-01 A S Changing SMTP Servers The Call Home service configuration enables you to specify a primary and a secondary SMTP server to which the switch connects. The active server is the server that receives messages from the switch. By defaul...

13 – Simple Network Management Protocol Configuration Managing the SNMP Service 13-2 59263-01 A S Managing the SNMP Service You control the SNMP service SNMPEnabled parameters through the Set Setup SNMP or Set Setup Services commands. Refer to “Modifying the SNMP Configuration” on page 13-4 for more...

13 – Simple Network Management Protocol Configuration Displaying SNMP Information 59263-01 A 13-3 A Displaying SNMP Information Enter the Show Setup Snmp command to displays common and trap-specific SNMP configuration information as shown in the following example. Refer to Table 14-30 for a descript...

13 – Simple Network Management Protocol Configuration Modifying the SNMP Configuration 13-4 59263-01 A S Modifying the SNMP Configuration Enter the Set Setup SNMP command in an Admin session to configure SNMP on the switch. There are two groups of configuration parameters. One group is common to all...

13 – Simple Network Management Protocol Configuration Resetting the SNMP Configuration 59263-01 A 13-5 A The following example configures SNMP trap 1: SANbox (admin) #> set setup snmp trap 1 A list of attributes with formatting and current values will follow. Enter a new value or simply press the...

13 – Simple Network Management Protocol Configuration Managing the SNMP Version 3 Configuration 13-6 59263-01 A S Managing the SNMP Version 3 Configuration SNMP version 3 is an interoperable standards-based protocol for network management. SNMP version 3 provides secure access to devices by a combin...

13 – Simple Network Management Protocol Configuration Managing the SNMP Version 3 Configuration 59263-01 A 13-7 A Create an SNMP Version 3 User Account To create an SNMP version 3 user account, enter the Snmpv3user Add command as shown in the following example: SANbox #> admin start SANbox (admin...

13 – Simple Network Management Protocol Configuration Managing the SNMP Version 3 Configuration 13-8 59263-01 A S Modify an SNMP Version 3 User Account To modify an SNMP version 3 user account, enter the Snmpv3user Edit command as shown in the following example: SANbox #> admin start SANbox (admi...

59263-01 A 14-1 14 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 „ Command Listing Access Authority The Authority paragraph in each ...

14 – Command Reference Syntax and Keywords 14-2 59263-01 A S „ Commands that modify the Internet Protocol Security configuration require an Ipsec Edit session, which is opened by the Ipsec Edit command. These commands include the Ipsec , Ipsec Association and Ipsec Policy commands. Syntax and Keywor...

14 – Command Reference Admin 59263-01 A 14-3 A 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...

14 – Command Reference Alias 14-4 59263-01 A S 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...

14 – Command Reference Alias 59263-01 A 14-5 A 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 ...

14 – Command Reference Callhome 14-6 59263-01 A S Callhome Manages the Call Home database. The Callhome Edit command opens a session in which to create and manage Call Home profiles. Refer to the Profile command for more information about Call Home profiles. Authority Admin session except for the Hi...

14 – Command Reference Callhome 59263-01 A 14-7 A history Displays a history of Call Home modifications. This keyword does not require an Admin session. History information includes the following: „ Time of the most recent Call Home database modification and the user who performed it. „ Checksum for...

14 – Command Reference Callhome 14-8 59263-01 A S Examples The following is an example of the Callhome History command: SANbox #> callhome history CallHome Database History ------------------------- ConfigurationLastEditedBy admin@OB-session2 ConfigurationLastEditedOn day mmm dd hh:mm:ss yyyy Dat...

14 – Command Reference Callhome 59263-01 A 14-9 A The following is an example of the Callhome List Profile command: SANbox #> callhome list profile ProfileName: group4 ------------ Level Warn Format FullText MaxSize any size up to max of 100000 EmailSubject CallHome Warn RecipientEmail admin1@com...

14 – Command Reference Capture 14-10 59263-01 A S Capture Manages the data capture configuration for the Tech_Support_Center Call Home profile. The data capture configuration determines the time and frequency by which status and trend data is collected from the switch and sent to recipients specifie...

14 – Command Reference Capture 59263-01 A 14-11 A Examples The following is an example of the Capture Add command: SANbox #> admin start SANbox (admin) #> callhome edit SANbox (admin-callhome) #> capture add A list of attributes with formatting and default values will follow. Enter a value ...

14 – Command Reference Capture 14-12 59263-01 A S The following is an example of the Capture Remove command: SANbox #> admin start SANbox (admin) #> callhome edit SANbox (admin-callhome) #> capture remove Capture Entries for Profile: Tech_Support_Center Index TimeOfDay DayOfWeek Interval --...

14 – Command Reference Config 59263-01 A 14-13 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 14-95 . Authority Admin session for all keywords except Backup and List Syn...

14 – Command Reference Config 14-14 59263-01 A S delete [config_name] Deletes the configuration given by [config_name] from the switch. You cannot delete the default configuration (Default Config) nor the active configuration. edit [config_name] Opens an edit session for the configuration given by [...

14 – Command Reference Config 59263-01 A 14-15 A save [config_name] Saves changes made during a configuration edit session in the configuration given by [config_name]. If you omit [config_name], the value for [config_name] you chose for the most recent Config Edit command is used. [config_name] can ...

14 – Command Reference Create 59263-01 A 14-17 A 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...

14 – Command Reference Create 59263-01 A 14-19 A 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...

14 – Command Reference Date 14-20 59263-01 A S 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...

14 – Command Reference Exit 59263-01 A 14-21 A Exit Closes the Telnet session. Authority None Syntax exit Notes You can also press Control-D to close the Telnet session.

14 – Command Reference Fcping 14-22 59263-01 A S 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...

14 – Command Reference Fctrace 59263-01 A 14-23 A 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...

14 – Command Reference Fctrace 14-24 59263-01 A S 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...

14 – Command Reference Feature 59263-01 A 14-25 A 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. A...

14 – Command Reference Feature 14-26 59263-01 A S 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 24 ports ...

14 – Command Reference Firmware Install 59263-01 A 14-27 A 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...

14 – Command Reference Group 59263-01 A 14-29 A 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 14-77 for information about starting a Securi...

14 – Command Reference Group 14-30 59263-01 A S 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 14-2 , Table 14-3 , and Table 14-4 respectively....

14 – Command Reference Group 59263-01 A 14-31 A Table 14-3. 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, ...

14 – Command Reference Group 59263-01 A 14-35 A 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...

14 – Command Reference Group 14-36 59263-01 A S 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...

14 – Command Reference Hardreset 59263-01 A 14-37 A Hardreset 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, refer to the “Set Log” on page 14-101 . Authori...

14 – Command Reference Help 14-38 59263-01 A S 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...

14 – Command Reference History 59263-01 A 14-39 A 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...

14 – Command Reference Hotreset 14-40 59263-01 A S 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...

14 – Command Reference Image 59263-01 A 14-41 A 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...

14 – Command Reference Image 14-42 59263-01 A S 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 ...

14 – Command Reference Ipsec 14-44 59263-01 A S Ipsec Manages the IP Security database. The IP Security database consists of the Security Association database and the Security Policy database. The Ipsec Edit command opens a session in which to create and manage associations and policies. Authority A...

14 – Command Reference Ipsec 59263-01 A 14-45 A „ Checksums for the active and inactive IP security databases limits Displays the maximum and current numbers of configured associations and policies. This keyword does not require an Admin session nor an Ipsec Edit session. However, in an Ipsec Edit s...

14 – Command Reference Ipsec Association 14-46 59263-01 A S Ipsec Association Creates and manages associations in the Security Association database. Authority Admin session and an Ipsec Edit session Syntax ipsec association copy [association_source] [association_destination]create [association]delet...

14 – Command Reference Ipsec Association 14-48 59263-01 A S list [option] Displays the configuration for the policies given by [option]. If you omit [option], the command displays the configuration of all active associations. [option] can be one of the following: [association] Displays the configura...

14 – Command Reference Ipsec List 14-50 59263-01 A S Ipsec List Displays information about IP security associations and policies. Authority None Syntax ipsec list activeassociation [option] configurededitedpolicy [option] Keywords active Displays a summary of active associations and policies. This i...

14 – Command Reference Ipsec List 59263-01 A 14-51 A policy [option] Displays the configuration for the policies given by [option]. If you omit [option], the command displays the configuration of all active policies. [option] can be one of the following: [policy] Displays the configuration for the p...

14 – Command Reference Ipsec List 14-52 59263-01 A S The following is an example of the Ipsec List Association command: SANbox #> ipsec list association Active IPsec Information h2h-sh-sa Description: Host-to-host: switch->host Source: fe80::2c0:ddff:fe03:d4c1 Destination: fe80::250:daff:feb7:...

14 – Command Reference Ipsec Policy 59263-01 A 14-53 A Ipsec Policy Manages policies in the Security Policy database. Authority Admin session and an Ipsec Edit session Syntax ipsec policy copy [policy_source] [policy_destination]create [policy]delete [policy]edit [policy]list [option] rename [policy...

14 – Command Reference Ipsec Policy 14-54 59263-01 A S Protocol Protocol or application to which to apply IP security. Enter a key-word for one of the following protocols or an integer (0-255): „ Internet Control Message Protocol for IP version 4 (ICMP) „ Internet Control Message Protocol for IP ver...

14 – Command Reference Ipsec Policy 14-56 59263-01 A S Examples The following is an example of the Ipsec Policy Create command: SANbox #> admin start SANbox (admin) #> ipsec edit SANbox (admin-ipsec) #> ipsec policy create h2h-sh-sp A list of attributes with formatting will follow. Enter a ...

14 – Command Reference Lip 59263-01 A 14-57 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...

14 – Command Reference Logout 14-58 59263-01 A S Logout Closes the Telnet session. Authority None Syntax logout Notes You can also press Control-D to close the Telnet session.

14 – Command Reference Passwd 59263-01 A 14-59 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...

14 – Command Reference Ping 14-60 59263-01 A S Ping Initiates an attempt to communicate with another switch over an Ethernet network and reports the result. Authority None Syntax ping [host_name]-ipv4 [host_address]-ipv6 [host_address] Keywords [host_name] DNS host name of the switch you want to que...

14 – Command Reference Profile 59263-01 A 14-61 A Profile 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. Authority Admin session and a Callho...

14 – Command Reference Profile 59263-01 A 14-63 A Examples The following is an example of the Profile Create command: SANbox #> admin start SANbox (admin) #> callhome edit SANbox (admin-callhome) #> profile create profile_1 A list of attributes with formatting and default values will follow...

14 – Command Reference Profile 14-64 59263-01 A S The following is an example of the Profile Edit command: SANbox #> admin start SANbox (admin) #> callhome edit SANbox (admin-callhome) #> profile edit profile_1 A list of attributes with formatting and current values will follow. Enter a new...

14 – Command Reference Ps 59263-01 A 14-65 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 %MEM TIME ELAPSED COMMAND 244 224 0.0 0.3 00:00:04 2-03:02:31 cns 245 224 0.0 0.3 00:00:06 2-03:...

14 – Command Reference Quit 14-66 59263-01 A S Quit Closes the Telnet session. Authority None Syntax quit Notes You can also press Control-D to close the Telnet session.

14 – Command Reference Reset 59263-01 A 14-67 A Reset Resets the switch configuration parameters. If you omit the keyword, the default is Reset Switch. Authority Admin session Syntax reset callhomeconfig [config_name] factoryipsecport [port_list]radiussecurityservicessnmpswitch (default)systemzoning...

14 – Command Reference Reset 59263-01 A 14-69 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...

14 – Command Reference Reset 14-70 59263-01 A S Notes The following tables specify the various factory default settings: „ Table 14-9 shows the Call Home service configuration defaults. Enter the Show Setup Callhome command to display the Call Home service configuration values. „ Table 14-10 shows t...

14 – Command Reference Reset 59263-01 A 14-71 A StreetAddress <undefined> FromEmailAddress [email protected] ReplyToEmailAddress [email protected] ThrottleDupsEnabled True Table 14-10. Switch Configuration Defaults Parameter Default Admin State Online Broadcast Enabled Tr...

14 – Command Reference Reset 14-72 59263-01 A S Table 14-11. Port Configuration Defaults Parameter SFP Port Defaults XPAK Port Defaults Admin State Online Online Link Speed Auto 10-Gbps Port Type GL G Symbolic Name Portn, where n is the port number 10G-n, where n is the port number ALFairness False ...

14 – Command Reference Reset 59263-01 A 14-73 A Table 14-12. Port Threshold Alarm Configuration Defaults Parameter Default ThresholdMonitoringEnabled False CRCErrorsMonitoringEnabled „ RisingTrigger „ FallingTrigger „ SampleWindow True 25 1 10 DecodeErrorsMonitoringEnabled „ RisingTrigger „ FallingT...

14 – Command Reference Reset 14-74 59263-01 A S Table 14-13. Zoning Configuration Defaults Parameter Default MergeAutoSave True DefaultZone Allow DiscardInactive False Table 14-14. SNMP Configuration Defaults Parameter Default SNMPEnabled True Contact <syscontact undefined> Location <sysLoc...

14 – Command Reference Reset 59263-01 A 14-75 A Table 14-15. RADIUS Configuration Defaults Parameter Default DeviceAuthOrder Local UserAuthOrder Local TotalServers 0 DeviceAuthServer False UserAuthServer False AccountingServer False ServerIPAddress 10.0.0.1 ServerUDPPort 1812 Timeout 2 seconds Retri...

14 – Command Reference Reset 14-76 59263-01 A S Table 14-17. System Configuration Defaults Parameter Default Ethernet Network Enable True Ethernet Network Discovery Static Ethernet Network IP Address 10.0.0.1 Ethernet Network IP Mask 255.0.0.0 Ethernet Gateway Address 10.0.0.254 Admin Timeout 30 min...

14 – Command Reference Security 59263-01 A 14-77 A Security Opens a Security Edit session in which to manage the security database on a switch. Refer to the “Group” command on page 14-29 and the “Securityset” command on page 14-81 . Authority Admin session. The keywords Active, History, Limits, and ...

14 – Command Reference Security 14-78 59263-01 A S 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...

14 – Command Reference Security 59263-01 A 14-79 A 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 ...

14 – Command Reference Security 14-80 59263-01 A S The following is an example of the Security List command: SANbox #> security list Active Security Information SecuritySet Group GroupMember ----------- ----- ----------- No active securityset defined. Configured Security Information SecuritySet G...

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

14 – Command Reference Securityset 14-82 59263-01 A S 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...

14 – Command Reference Securityset 59263-01 A 14-83 A 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...

14 – Command Reference Set Alarm 14-84 59263-01 A S 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...

14 – Command Reference Set Beacon 59263-01 A 14-85 A 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...

14 – Command Reference Set Config Port 14-86 59263-01 A S 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...

14 – Command Reference Set Config Port 14-90 59263-01 A S 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. ...

14 – Command Reference Set Config Security 14-92 59263-01 A S 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...

14 – Command Reference Set Config Security 59263-01 A 14-93 A Examples The following is an example of the Set Config Security command: SANbox #> admin start SANbox (admin) #> config edit SANbox (admin-config) #> set config security A list of attributes with formatting and current values wil...

14 – Command Reference Set Config Security Portbinding 14-94 59263-01 A S 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...

14 – Command Reference Set Config Switch 59263-01 A 14-95 A 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...

14 – Command Reference Set Config Switch 14-96 59263-01 A S 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...

14 – Command Reference Set Config Threshold 59263-01 A 14-97 A 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...

14 – Command Reference Set Config Threshold 14-98 59263-01 A S 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 ...

14 – Command Reference Set Config Zoning 59263-01 A 14-99 A 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...

14 – Command Reference Set Config Zoning 14-100 59263-01 A S 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 w...

14 – Command Reference Set Log 59263-01 A 14-101 A 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 th...

14 – Command Reference Set Log 59263-01 A 14-103 A None Specifies no severity levels for display on the screen. level [filter] Specifies the severity level given by [filter] to use in monitoring and logging events for the specified components or ports. [filter] can be one of the following values: Cr...

14 – Command Reference Set Log 14-104 59263-01 A S 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 ...

14 – Command Reference Set Pagebreak 59263-01 A 14-105 A 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] [...

14 – Command Reference Set Pagebreak 14-106 59263-01 A S 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,...

14 – Command Reference Set Port 59263-01 A 14-107 A 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] clear...

14 – Command Reference Set Port 14-108 59263-01 A S Auto The port speed is automatically detected. state [state] Specifies one of the following administrative states for the specified port: Online Activates and prepares the port to send data. Offline Prevents the port from receiving signal and accep...

14 – Command Reference Set Setup Callhome 59263-01 A 14-109 A Set Setup Callhome 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 ...

14 – Command Reference Set Setup Callhome 14-110 59263-01 A S Notes „ The Callhome service must be active to support Call Home e-mail notification. Refer to the “Set Setup Services” command on page 14-116 . „ The primary, secondary, or both SMTP servers must be properly addressed and enabled on the ...

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

14 – Command Reference Set Setup Radius 14-112 59263-01 A S Set Setup Radius Configures RADIUS servers on the switch. Authority Admin session Syntax set setup radius commonserver [server_number] Keywords common Prompts you in a line-by-line fashion to configure parameters that are common to all RADI...

14 – Command Reference Set Setup Radius 14-114 59263-01 A S Examples The following is an example of the Set Setup Radius Common command: SANbox (admin) #> set setup radius common A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key t...

14 – Command Reference Set Setup Radius 59263-01 A 14-115 A The following is an example of the Set Setup Radius Server command: SANbox (admin) #> set setup radius server 1 A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accep...

14 – Command Reference Set Setup Services 14-116 59263-01 A S Set Setup Services 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 14-28 describes the switch service para...

14 – Command Reference Set Setup Services 14-118 59263-01 A S 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 pres...

14 – Command Reference Set Setup SNMP 59263-01 A 14-119 A Set Setup SNMP Configures SNMP on the switch. Authority Admin session Syntax set setup snmp commontrap [trap_number] Keywords common Prompts you in a line-by-line fashion to change SNMP configuration parameters that are common for all traps. ...

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

14 – Command Reference Set Setup SNMP 14-122 59263-01 A S The following is an example of the Set Setup Snmp Trap command: SANbox (admin) #> set setup snmp trap 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 curr...

14 – Command Reference Set Setup System 59263-01 A 14-123 A Set Setup System Configures the network, logging, NTP server, and timer configurations on the switch. Authority Admin session Syntax set setup system dnsipv4ipv6loggingntptimers Keywords dns Prompts you in a line-by-line fashion to change D...

14 – Command Reference Set Setup System 14-124 59263-01 A S ipv4 Prompts you in a line-by-line fashion to change the switch IPv4 Ethernet configuration parameters described in Table 14-32 . To configure all system parameters, omit the keyword. For each parameter, enter a new value or press the Enter...

14 – Command Reference Set Setup System 59263-01 A 14-125 A logging Prompts you in a line-by-line fashion to change the event logging configuration parameters described in Table 14-34 . To configure all system parameters, omit the keyword. For each parameter, enter a new value or press the Enter key...

14 – Command Reference Set Setup System 14-126 59263-01 A S timers Prompts you in a line-by-line fashion to change the timer configuration parameters described in Table 14-36 . To configure all system parameters, omit the keyword. For each parameter, enter a new value or press the Enter key to accep...

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

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

14 – Command Reference Set Setup System 59263-01 A 14-129 A The following is an example of the Set Setup System Logging command: SANbox (admin) #> set setup system logging A list of attributes with formatting and current values will follow. Enter a new value or simply press the ENTER key to accep...

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

14 – Command Reference Set Switch State 59263-01 A 14-131 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 ...

14 – Command Reference Set Timezone 14-132 59263-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. Changi...

14 – Command Reference Show About 59263-01 A 14-133 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 Notes Table 14-37 describes the entries in the Show About ...

14 – Command Reference Show About 14-134 59263-01 A S Examples The following is an example of the Show About command: SANbox #> show about ***************************************************** * * * Command Line Interface SHell (CLISH) * * * ***************************************************** S...

14 – Command Reference Show Alarm 59263-01 A 14-135 A 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 p...

14 – Command Reference Show Broadcast 14-136 59263-01 A S 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: SANb...

14 – Command Reference Show Chassis 59263-01 A 14-137 A 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 ------------------...

14 – Command Reference Show Config Port 14-138 59263-01 A S 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...

14 – Command Reference Show Config Security 14-140 59263-01 A S 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...

14 – Command Reference Show Config Security Portbinding 59263-01 A 14-141 A 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 ...

14 – Command Reference Show Config Switch 14-142 59263-01 A S 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 ...

14 – Command Reference Show Config Threshold 59263-01 A 14-143 A 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...

14 – Command Reference Show Config Zoning 14-144 59263-01 A S 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...

14 – Command Reference Show Domains 59263-01 A 14-145 A 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...

14 – Command Reference Show Donor 14-146 59263-01 A S Show Donor Displays list of current donors and extended credit configuration for all ports. Authority None Syntax show donor SANbox #> show donor Port Config Ext Credit Max Credit Donated Member of Valid Groups to Number Type Requested Availab...

14 – Command Reference Show Fabric 59263-01 A 14-147 A Show Fabric Displays list of each domain, symbolic name, worldwide name, node IP address, and port IP address in the fabric. Authority None Syntax show fabric brief Keywords brief Displays a table of switches in the fabric including domain ID, W...

14 – Command Reference Show FDMI 14-148 59263-01 A S Show FDMI Displays detailed information about the device host bus adapter. Authority None Syntax show fdmi [port_wwn] Keywords [port_wwn] The device worldwide port name for which to display information. If you omit [port_wwn], the command displays...

14 – Command Reference Show Interface 59263-01 A 14-149 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...

14 – Command Reference Show Log 14-150 59263-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...

14 – Command Reference Show Log 14-152 59263-01 A S level Displays the severity settings for event logging and the setting for the display level. options Displays the options that are available for configuring event logging and automatic display to the screen. Refer to the “Set Log” command on page ...

14 – Command Reference Show Log 59263-01 A 14-153 A The following is an example of the Show Log command: SANbox #> show log [327][day month date time year][I][Eport Port:0/8][Eport State= E_A0_GET_DOMAIN_ID] [328][day month date time year][I][Eport Port: 0/8][FSPF PortUp state=0] [329][day month ...

14 – Command Reference Show LSDB 14-154 59263-01 A S 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=...

14 – Command Reference Show Media 59263-01 A 14-155 A 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...

14 – Command Reference Show Media 59263-01 A 14-157 A 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...

14 – Command Reference Show Media 14-158 59263-01 A S 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) ---- --------...

14 – Command Reference Show Mem 59263-01 A 14-159 A 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 ...

14 – Command Reference Show Ns 14-160 59263-01 A S 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...

14 – Command Reference Show Pagebreak 14-162 59263-01 A S Show Pagebreak Displays the current pagebreak setting. Authority None Syntax show pagebreak Notes The pagebreak setting limits the display of information to 20 lines (On) or allows the continuous display of information without a break (Off). ...

14 – Command Reference Show Perf 59263-01 A 14-163 A 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/second. Transmissio...

14 – Command Reference Show Perf 59263-01 A 14-165 A 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 ...

14 – Command Reference Show Port 14-166 59263-01 A S 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...

14 – Command Reference Show Port 14-170 59263-01 A S 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 2 PortID 3a0100 ConfigType GL PortWWN 20:01:...

14 – Command Reference Show Postlog 59263-01 A 14-171 A Show Postlog Displays the Power On Self Test (POST) log, which contains results from the most recently failed POST. Authority None Syntax show postlog or show port log Examples The following is an example of the Show Postlog command: SANbox #&g...

14 – Command Reference Show Setup Callhome 14-172 59263-01 A S Show Setup Callhome Displays the Call Home database configuration. Authority None Syntax show setup callhome Examples The following is an example of the Show Setup Callhome command: SANbox #> show setup callhome Callhome Information -...

14 – Command Reference Show Setup Mfg 59263-01 A 14-173 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: SANbox #> show setup mfg Manufacturing Information ---------------...

14 – Command Reference Show Setup Radius 14-174 59263-01 A S Show Setup Radius Displays RADIUS server information. Authority None Syntax show setup radius commonserver [server_number] Keywords common Displays the configuration parameters that are common for all RADIUS servers. To display common and ...

14 – Command Reference Show Setup Services 59263-01 A 14-175 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 ---------...

14 – Command Reference Show Setup Snmp 14-176 59263-01 A S Show Setup Snmp Displays the current SNMP settings. Authority None Syntax show setup snmp commontrap Keywords common Displays SNMP configuration parameters that are common to all traps. To display common and trap-specific parameters, omit th...

14 – Command Reference Show Setup System 59263-01 A 14-177 A Show Setup System Displays network, logging, NTP server, and timer parameters on the switch. Authority None Syntax show setup system dnsipv4ipv6loggingntptimers Keywords dns Displays DNS host name configuration parameters. To display all s...

14 – Command Reference Show Setup System 14-178 59263-01 A S Examples The following is an example of the Show Setup System Dns command: SANbox #> show setup system dns System Information ------------------ DNSClientEnabled False DNSLocalHostname <undefined> DNSServerDiscovery Static DNSServ...

14 – Command Reference Show Setup System 59263-01 A 14-179 A The following is an example of the Show Setup System Ntp command: SANbox #> show setup system System Information ------------------ NTPClientEnabled False NTPServerDiscovery Static NTPServerAddress 51.68.85.102 The following example of ...

14 – Command Reference Show Steering 14-180 59263-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...

14 – Command Reference Show Switch 59263-01 A 14-181 A Show Switch Displays switch operational information. Authority None Syntax show switch Notes Table 14-41 describes the switch operational parameters. Table 14-41. Switch Operational Parameters Parameter Description SymbolicName Descriptive name ...

14 – Command Reference Show Switch 59263-01 A 14-183 A 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 ...

14 – Command Reference Show System 14-184 59263-01 A S Show System Displays the operational status of the Ethernet and DNS host name configuration parameters. Authority None Syntax show system Examples The following is an example of the Show System command: SANbox #> show system Assigned System N...

14 – Command Reference Show Testlog 59263-01 A 14-185 A Show Testlog Displays the contents of the diagnostic field test log file. Authority None Syntax show testlog or show test log Examples The following is an example of the Show Testlog command: SANbox #> show testlog Queue: UID Sequence Count:...

14 – Command Reference Show Timezone 14-186 59263-01 A S 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

14 – Command Reference Show Topology 59263-01 A 14-187 A Show Topology Displays information about devices connected to the switch. Authority None Syntax show topology [port_number] Keywords [port_number] Displays the devices connected to the port given by [port_number]. Examples The following is an ...

14 – Command Reference Show Users 14-188 59263-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 brief Keywords brief Displays just the account name and client. Examples The following is an example of the Show Users co...

14 – Command Reference Show Version 59263-01 A 14-189 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 Notes Table 14-42 describes the Show Version command d...

14 – Command Reference Show Version 14-190 59263-01 A S Examples The following is an example of the Show Version command. SANbox #> show version ***************************************************** * * * Command Line Interface SHell (CLISH) * * * *************************************************...

14 – Command Reference Shutdown 59263-01 A 14-191 A 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...

14 – Command Reference Snmpv3user 14-192 59263-01 A S Snmpv3user Manages SNMP version 3 user accounts on the switch. Authority Admin session except for the List keyword Syntax snmpv3user adddelete [account]editlist Keywords add Creates an SNMP version 3 user account, prompting you for the parameters...

14 – Command Reference Snmpv3user 59263-01 A 14-193 A list Displays SNMP version 3 user accounts, group, authentication type, and privacy type. This keyword does not require an Admin session. Examples The following is an example of the Snmpv3user Add command: SANbox #> admin start SANbox (admin) ...

14 – Command Reference Test Cancel 14-194 59263-01 A S 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–23. Examples The following...

14 – Command Reference Test Port 59263-01 A 14-195 A 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–23. offline [loopback_type]...

14 – Command Reference Test Port 14-196 59263-01 A S Notes Table 14-44 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. E...

14 – Command Reference Test Status 59263-01 A 14-197 A Test Status 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 Keywords port [port_number] Display test status ...

14 – Command Reference Test Switch 14-198 59263-01 A S Test Switch 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 Keywords connectivity [loopback_type] ...

14 – Command Reference Test Switch 59263-01 A 14-199 A Notes Table 14-45 describes the switch test parameters. To cancel a switch test in progress, enter the Test Cancel Switch command. To display the status of a recent switch test or switch test in progress, enter the Test Status Switch command. Ex...

14 – Command Reference Uptime 14-200 59263-01 A S Uptime 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 followi...

14 – Command Reference User 59263-01 A 14-201 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 brief Keywo...

14 – Command Reference User 14-202 59263-01 A S list brief Displays the list of users currently logged in, the login date, and the login time. The User List command is equivalent to the Show Users command. This keyword is available to all account names without an Admin session. To display just the a...

14 – Command Reference User 59263-01 A 14-203 A The following is an example of the User Edit command: SANbox (admin) #> user edit Press 'q' and the ENTER key to abort this command. account name (1-15 chars) : user1 set account expiration in days (0-2000, 0=never): [0] should this account have adm...

14 – Command Reference Whoami 14-204 59263-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...

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

14 – Command Reference Zone 59263-01 A 14-207 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_2 wwn_2215c3 zone_set_2 wwn_0160ed zone_set_3 The following is an example of...

14 – Command Reference Zoneset 14-208 59263-01 A S Zoneset Manages zone sets and component zones across the fabric. Authority Admin session and a Zoning Edit session. Refer to the “Zoning Edit” command on page 14-216 for information about starting a Zoning Edit session. The Active, List, and Zones k...

14 – Command Reference Zoneset 14-210 59263-01 A S Examples The following is an example of the Zoneset Active command: SANbox #> zoneset active Active ZoneSet Information -------------------------- ActiveZoneSet Bets LastActivatedBy admin@OB-session6 LastActivatedOn day month date time year The f...

14 – Command Reference Zoning Active 59263-01 A 14-211 A Zoning Active 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 keyword. Syntax zoning active capture Keywords capture Saves the active zone s...

14 – Command Reference Zoning Cancel 14-212 59263-01 A S Zoning Cancel 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: SANbox #> admin s...

14 – Command Reference Zoning Clear 59263-01 A 14-213 A Zoning Clear Clears all inactive zone sets from the volatile edit copy of the zoning database. This keyword requires a zoning edit session. This keyword does not affect the non-volatile zoning database. However, if you enter the Zoning Clear co...

14 – Command Reference Zoning Configured 14-214 59263-01 A S Zoning Configured 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: SANbox #> zoning configured Configured (saved in...

14 – Command Reference Zoning Delete Orphans 59263-01 A 14-215 A Zoning Delete Orphans 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...

14 – Command Reference Zoning Edit 14-216 59263-01 A S Zoning Edit Opens a Zoning Edit session for the non-volatile zoning database or the merged zone set in which to create and manage zone sets and zones. Refer to the “Zone” command on page 14-205 and the “Zoneset” command on page 14-208 . Authorit...

14 – Command Reference Zoning Edited 59263-01 A 14-217 A Zoning Edited 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: SANbox (admin-zoning) #> zoning edi...

14 – Command Reference Zoning History 14-218 59263-01 A S Zoning History Displays a history of zoning modifications. This keyword does not require an Admin session. History information includes the following: „ Time of the most recent zone set activation or deactivation and the user who performed it...

14 – Command Reference Zoning Limits 59263-01 A 14-219 A Zoning Limits 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 Keywords brief Displays zoning limits for each...

14 – Command Reference Zoning List 14-220 59263-01 A S Zoning List 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: SANbox #> zoning list Active (enforced) ZoneSet Information...

14 – Command Reference Zoning Merged 59263-01 A 14-221 A Zoning Merged 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 keyword. Syntax zoning merged capture Keywords capture Saves the merged zone ...

14 – Command Reference Zoning Restore 14-222 59263-01 A S Zoning Restore Restores the volatile zoning database with the contents of the non-volatile zoning database. If the MergeAutoSave parameter is False (see Table 14-13 ), you can use this command to revert changes to the merged zone set that wer...

14 – Command Reference Zoning Save 59263-01 A 14-223 A Zoning Save 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 follow...

59263-01 A Index-1 Index A account name admin 2-2display 14-201, 14-204factory 3-1maintenance mode 3-1 activation firmware 5-20, 5-21security 9-9, 9-11switch configuration 5-12, 5-13zoning 7-12 active zone set 7-1, 7-4Admin account name 3-1, 14-1authority 2-3, 14-1session 2-3session timeout 14-126 A...

SANbox 5802V Fibre Channel Switch Command Line Interface Guide Index-4 59263-01 A S Fctrace command 14-23 example 5-29 FDMI - See Fabric Device Management Interface Feature command 14-25 Add example 5-30Log example 5-30 feature upgrade 5-29, 14-25Fibre Channel connection 5-28routing 5-29 file downlo...

59263-01 A Index-5 SANbox 5802V Fibre Channel Switch Command Line Interface Guide A I I/O Stream Guard 14-89idle session limits 5-30Image command 14-41 Install example 5-20 inactivty limits 5-30informative event 11-1internal test 6-13, 14-195, 14-198Internet Protocol security 4-6, 4-7, 4-18version 4...

SANbox 5802V Fibre Channel Switch Command Line Interface Guide Index-6 59263-01 A S MD5 authentication 14-31memory activity 14-159message format 12-3queue 12-8, 12-16 MS - See Management ServerMulti-Frame Sequence bundling 14-88 N name server information 5-2, 14-160network configuration 4-1configura...

59263-01 A Index-7 SANbox 5802V Fibre Channel Switch Command Line Interface Guide A process identifier 5-4processing time 5-4profile copy 12-12, 14-61create 12-9, 14-61delete 12-10, 14-62edit 14-62modify 12-11rename 12-12, 14-62Tech_Support_Center 12-4, 12-16test 12-15 Profile command 14-61 Copy exa...

SANbox 5802V Fibre Channel Switch Command Line Interface Guide Index-10 59263-01 A S Show Setup System command 14-177 example 4-2 Show Steering command 14-180Show Switch command 14-181Show System command 14-184Show Test Log command 14-185Show Timezone command 14-186Show Topology command 14-187Show U...

59263-01 A Index-11 SANbox 5802V Fibre Channel Switch Command Line Interface Guide A Test Port command 14-195 example 6-13 Test Status command 14-197Test Switch command 14-198TFTP - See Trivial File Transfer Protocoltime 5-19 between resets 5-5set and display 5-17, 14-20zone 14-132, 14-186 time zone...

SANbox 5802V Fibre Channel Switch Command Line Interface Guide Index-12 59263-01 A S Zone command 14-205 Add example 7-18Copy example 7-17Create example 7-17Delete example 7-17Members example 7-7Remove example 7-18Rename example 7-17Zonesets example 7-6 zone set activate 7-16, 14-208active 7-1, 7-4,...

59263-01 A Index-13 SANbox 5802V Fibre Channel Switch Command Line Interface Guide A Zoning Delete command example 7-14 Zoning Delete Orphans command 14-215Zoning Edit command 14-216 example 7-12 Zoning Edited command 14-217Zoning History command 14-218 example 7-8 Zoning Limits command 14-219 examp...