Guest

Cisco Catalyst 3500 XL Series Switches

Release Notes for the Catalyst 2900 Series XL and 3500 Series XL Cisco IOS Release 12.0(5)XW

Table Of Contents

Release Notes for the
Catalyst 2900 Series XL and 3500 Series XL Cisco IOS Release 12.0(5)XW

Contents

System Requirements

Hardware Supported

Software Compatibility

Browser Support

Creating Clusters with Different Releases of IOS Software

Creating Clusters with Catalyst 1900 and 2820 Switches

Minimum IOS Release for Major Features

Upgrading to a New Software Release

Upgrading a Switch by Using the VSM or Cluster Manager

Using VSM to Upgrade a Switch

Recovering from an Incomplete VSM Software Upgrade

Upgrading a Switch by Using the CLI

Which Files to Use

Downloading the New Software

Upgrading Catalyst 3500 Series XL Switches

Upgrading 8-MB Catalyst 2900 Series XL Switches

Installing the Required Plug-In

Windows 95, Windows 98, and Windows NT 4.0 Users

Solaris Users

New Features in This Release

New Hardware Features in Release 12.0(5)XW

New Software Features in Release 12.0(5)XW

Limitations and Restrictions

Important Notes

Caveats

Open Caveats

Resolved Caveats

Documentation Updates

Documentation Notes

Setting Up the Catalyst 2900 XL Initial Configuration

Configuring Voice Ports to Carry Voice and Data Traffic on Different VLANs

Understanding Cross-Stack UplinkFast

How CSUF Works

Events that Cause Fast Convergence

Limitations

Connecting the Stack Ports

Configuring Cross-Stack UplinkFast

Understanding DHCP-Based Autoconfiguration

DHCP Client Request Process

Configuring the DHCP Server

Configuring the TFTP Server

Configuring the DNS

Configuring the Relay Device

Obtaining Configuration Files

Example Configuration

New and Changed Commands

show interface

show spanning-tree

spanning-tree stack-port

Syslog Error Messages

Related Documentation

Obtaining Documentation

World Wide Web

Documentation CD-ROM

Ordering Documentation

Documentation Feedback

Obtaining Technical Assistance

Cisco.com

Technical Assistance Center

Contacting TAC by Using the Cisco TAC Website

Contacting TAC by Telephone


Release Notes for the
Catalyst 2900 Series XL and 3500 Series XL Cisco IOS Release 12.0(5)XW


December 18, 2000 (Document revised April, 2001)

Cisco IOS Release 12.0(5)XW runs on Catalyst 3500 series XL switches and Catalyst 2900 series XL 8-MB CPU DRAM switches. Catalyst 2900 series XL 4-MB CPU DRAM switches are not supported.

These release notes include important information about this IOS release and any limitations, restrictions, and caveats that apply to it. See the "Related Documentation" section for the complete list of Catalyst 2900 and 3500 XL switch documentation.


Note Before upgrading your switch to Release 12.0(5)XW, read the "Upgrading to a New Software Release" section for important information.


This IOS release is part of a special release of Cisco IOS software that is not released on the same 8-week maintenance cycle that is used for other platforms. As maintenance releases and future IOS releases become available, they will be posted to CCO in the Cisco IOS software area.

Contents

This document has the following sections:

"System Requirements" section

"Upgrading to a New Software Release" section

"New Features in This Release" section

"Limitations and Restrictions" section

"Important Notes" section

"Caveats" section

"Documentation Updates" section

"Related Documentation" section

"Obtaining Documentation" section

"Obtaining Technical Assistance" section

System Requirements

This section describes these system requirements for Release 12.0(5)XW:

"Hardware Supported" section

"Software Compatibility" section

"Minimum IOS Release for Major Features" section

Hardware Supported

Table 1 lists the supported Catalyst 3500 XL switches, and Table 2 lists the supported 8-MB Catalyst 2900 XL switches.

Catalyst 2900 series XL 4-MB switches run original edition software and are not supported. These switches can be updated only to Release 11.2(8.6)SA6.

Table 1 Catalyst 3500 Series XL Switches

Switch
Description

Catalyst 3508G XL

8 Gigabit module slots

Catalyst 3512 XL

12 autosensing 10/100 ports and 2 Gigabit module slots

Catalyst 3524 XL

24 autosensing 10/100 ports and 2 Gigabit module slots

Catalyst 3524-PWR XL

24 autosensing 10/100 inline-power ports and 2 Gigabit module slots

Catalyst 3548 XL

48 autosensing 10/100 ports and 2 Gigabit module slots


Table 2 8-MB Catalyst 2900 Series XL Switches

Switch
Description

Catalyst 2912MF XL

12 100BaseFX ports and 2 high-speed expansion slots

Catalyst 2912 XL

12 autosensing 10/100 ports

Catalyst 2924M XL

24 autosensing 10/100 ports and 2 high-speed expansion slots

Catalyst 2924M DC XL

24 autosensing 10/100 ports and 2 high-speed expansion slots (DC power)

Catalyst 2924 XL

24 autosensing 10/100 ports

Catalyst 2924C XL

22 autosensing 10/100 ports and 2 100BaseFX ports


Software Compatibility

This section describes these software compatibility requirements for Release 12.0(5)XW:

"Browser Support" section

"Creating Clusters with Different Releases of IOS Software" section

"Creating Clusters with Catalyst 1900 and 2820 Switches" section

Browser Support

You can access the web-based interfaces through the browsers listed in Table 3. The switch checks the browser version when starting a session to ensure that the browser is supported. If the browser is not supported, the switch displays an error message, and the session does not start.

Table 3 Browser Support

Operating System
Minimum Operating System Requirements
Netscape Communicator
Microsoft Internet Explorer

Windows 95

Service Pack 1

4.61, 4.7

4.01a or 5.0

Windows 98

Second Edition

4.61, 4.7

4.01a or 5.0

Windows NT 4.0

Service Pack 3 or later

4.61, 4.7

4.01a or 5.0

Solaris 2.5.1 or higher

SUN-recommended patch cluster for the OS and Motif library patch 103461-24

4.61, 4.7

Not supported


Netscape Communicator version 4.60 is not supported.


Note If your browser is Internet Explorer and you receive an error message stating that the page might not display correctly because your security settings prohibit running activeX controls, this might indicate that your security settings are set too high. To lower security settings, go to Tools > Internet Options and select the Security tab. Select the indicated Zone, and move the Security Level for this Zone slider from High to Medium (the default).


To use the Cluster Management Suite (CMS), complete the browser-configuration instructions described in the Cisco IOS Desktop Switching Software Configuration Guide.

Creating Clusters with Different Releases of IOS Software

Some versions of the Catalyst 2900 and 3500 XL software do not support clustering, and other versions do not support some of the features in this release. To ensure that all cluster switches are operating with the same level of software, we recommend that you upgrade all cluster switches to Release 12.0(5)XP or later. Table 4 lists the available versions of clustering software and their capabilities.

If you have a cluster with switches that are running different versions of IOS software, changes on the latest release might not be reflected on switches running the older versions. For example, if you start Visual Switch Manager (VSM) on a switch running Release 11.2(8)SA6, the windows and functionality can be different from a switch running Release 12.0(5)XU or later.

Table 4 Cluster Software Caveats

IOS Release
Cluster Status
Caveats

Release 12.0(5)XU

Member or commander switch

Features introduced with Release 12.0(5)XW, such as cross-stack UplinkFast and the 1000BaseT Gigabit Interface Converter (GBIC), are not supported.

Release 12.0(5)XP and earlier

Member switch

Features introduced with Release 12.0(5)XU, such as Virtual Local Area Network (VLAN) Trunk Protocol (VTP) pruning, appear as read-only.

Release 12.0(5)XP and earlier

Command switch

A 1000BaseT module installed in a switch running Release 12.0(5)XU does not display in Cluster Manager or VSM.

Release 11.2(8)SA6

Member switch

Features introduced with Release 12.0(5)XU, such as VTP pruning, appear as read-only.

Release 11.2(8)SA5 and earlier

Edge device

No clustering capabilities.


Creating Clusters with Catalyst 1900 and 2820 Switches

Catalyst 1900 and 2820 switches are always member switches, not command switches. However, a cluster with a command switch that is running Release 11.2(8)SA6 cannot communicate with a Catalyst 1900 or 2820. This means that if the command switch is running Release 11.2(8)SA6, the CMS does not support a Catalyst 1900 or 2820 switch in these CMS features:

Visual Switch Manager

Device report

Link graph

Bandwidth graph

Minimum IOS Release for Major Features

Table 5 lists the minimum IOS release required to support the major features of the Catalyst 2900 and 3500 XL switches.

Table 5 Catalyst 2900 and 3500 Series XL Features and the Minimum IOS Release Required  

Feature
Minimum Release Required

Cross-stack UplinkFast

Release 12.0(5)XW

Dynamic Host Configuration Protocol (DHCP)-based autoconfiguration

Release 12.0(5)XW

Support for the single-port 1000BaseT Gigabit Ethernet GBIC (WS-G5482)

Release 12.0(5)XW

WS-C3524-PWR XL switch with 10/100 inline-power ports

Release 12.0(5)XU

WS-C2924M-XL-EN-DC switch with DC power connector

Release 12.0(5)XU

Hot Standby Router Protocol (HSRP) for clustering

Release 12.0(5)XU

Extended discovery of cluster candidates up to 7 hops from the command switch

Release 12.0(5)XU

Support for up to 16 switches in a cluster

Release 12.0(5)XU

VTP pruning

Release 12.0(5)XU

Change management VLAN for a cluster

Release 12.0(5)XU

Private VLAN edge support

Release 12.0(5)XU

UniDirectional Link Detection (UDLD) for detecting unidirectional links

Release 12.0(5)XU

Extended cluster member functionality for Catalyst 1900 and 2820 switches

Release 12.0(5)XP

Remote monitoring (RMON) support through the command-line interface (CLI) or Simple Network Management Protocol (SNMP)

Release 12.0(5)XP

Change management VLAN

Release 12.0(5)XP

Quality of service (QoS) based on IEEE 802.1p class of service (CoS) values

Release 12.0(5)XP

Catalyst 3500 series XL switches (except 3548 XL)

Release 11.2(8)SA6

Catalyst 3548 XL switch

Release 12.0(5)XP

Cluster management

Release 11.2(8)SA6

Terminal Access Control Access Server+ (TACACS+)

Release 11.2(8)SA6 (Enterprise Edition Software)

Network Time Protocol (NTP)

Release 11.2(8)SA6

Spanning Tree Protocol (STP) UplinkFast

Release 11.2(8)SA6
(Enterprise Edition Software)

250 VLANs (some models: see the "Limitations and Restrictions" section)

Release 11.2(8)SA6

Catalyst 2900 series XL 1000BaseX modules

Release 11.2(8)SA5

Catalyst 2900 series XL ATM modules

Release 11.2(8)SA5

VLAN Membership Policy Server (VMPS)

Release 11.2(8)SA4 (Enterprise Edition Software)

8192 media access control (MAC) addresses on modular switches

Release 11.2(8)SA4

Inter-Switch Link (ISL) trunking

Release 11.2(8)SA4
(Enterprise Edition Software)

IEEE 802.1Q trunking

Release 11.2(8)SA5
(Enterprise Edition Software)

Switch Network View stack management

Release 11.2(8)SA3

Web-based switch management

Release 11.2(8)SA

Fast EtherChannel port groups

Release 11.2(8)SA


Upgrading to a New Software Release

This section describes these procedures for upgrading your switch software:

"Upgrading a Switch by Using the VSM or Cluster Manager" section

"Upgrading a Switch by Using the CLI" section

"Upgrading Catalyst 3500 Series XL Switches" section

"Upgrading 8-MB Catalyst 2900 Series XL Switches" section

"Installing the Required Plug-In" section


Caution The 4-MB Catalyst 2900 series XL switches do not have sufficient memory to be upgraded to this release.


Note Before upgrading your switch to Release 12.0(5)XW, read this section for important information.


Upgrading a Switch by Using the VSM or Cluster Manager

If your switch is running Release 11.2(8)SA3, SA4, or SA5, we recommend that you upgrade the switch software by using the web-based VSM. If you are upgrading a switch running Release 11.2(8)SA6 or later to this release, we recommend that you use Cluster Manager.

If you are using VSM to upgrade a switch running Release 11.2(8)SA6 or later, follow the procedure in the "Using VSM to Upgrade a Switch" section.

General instructions for upgrading switch software are included in the Cisco IOS Desktop Switching Software Configuration Guide; detailed instructions are provided in the online help files.


Note You cannot use the web-based interface to upgrade a switch running Release 11.2(8)SA2 or previous releases. Use the CLI to perform the upgrade in such cases.


Using VSM to Upgrade a Switch


Note If you use VSM to upgrade your switch from a release prior to Release 11.2(8)SA6 to this release, you must rename the image file to ensure that you can reload the software. You can rename the image file by accessing the CLI through Telnet or by connecting to the switch console port.



Tips If your switch is not configured for Telnet, follow the procedure described in the "Configuring the Switch for Telnet" section in the Cisco IOS Desktop Switching Software Configuration Guide.



Note You do not need to perform this procedure if you are using Cluster Manager or VSM to upgrade from Release 11.2(8)SA6 or later. This issue also does not apply to the current release of IOS.


Follow these steps to rename the image file by using the CLI, and then use VSM to upgrade the software:


Step 1 Access the CLI by starting a Telnet session or by connecting to the switch console port through the RS-232 connector.

To start a Telnet session on your PC or workstation, enter the following command:

server% telnet switch_ip_address

Enter the Telnet password if you are prompted to do so.

Step 2 Enter privileged EXEC mode:

switch> enable 
switch#

Enter the password if you are prompted to do so.

Step 3 Display the files in Flash memory:

switch# dir flash:
Directory of flash:/

  2  -rwx        4484   Mar 05 1993 00:31:09  vlan.dat
  3 -rwx         110   Mar 01 1993 19:50:50  info
 92  -rwx         877   Mar 06 1993 18:39:38  placement.txt
  5  -rwx     1644050   Mar 01 1993 19:36:14  c2900XL-c3h2s-mz-112.8.SA6.bin
  6  drwx        6720   Mar 01 1993 00:18:36  html
 86  -rwx         110   Mar 01 1993 19:37:00  info.ver
116  -rwx        3686   Mar 01 1993 19:55:33  config.text
 89  -rwx          25   Mar 01 1993 00:26:30  snmpengineid
  7  -rwx         313   Mar 01 1993 19:34:57  env_vars

Step 4 Rename the image file to boot.bin:

switch# rename flash:c2900XL-c3h2s-mz-112.8.SA6.bin flash:boot.bin

Ensure that there are no other image files in Flash memory.

Step 5 Start VSM as usual and display the System Configuration page by selecting
System > System Configuration from the menu bar.

Step 6 In the Cisco IOS Image File field, enter boot.bin.

Step 7 Check the Retain Current IOS Image File Name check box.

Step 8 Complete the other fields on the page as described in the "Reloading and Upgrading the Switch Software" section of the Cisco IOS Desktop Switching Software Configuration Guide.

Step 9 Click Upgrade IOS Software and Visual Switch Manager.

Step 10 Verify the upgrade by displaying the contents of Flash memory. The file boot.bin should be present:

switch# dir flash:
Directory of flash:/

  2  -rwx        4484   Mar 05 1993 00:31:09  vlan.dat
  4  -rwx         110   Mar 01 1993 19:50:50  info
 92  -rwx         877   Mar 06 1993 18:39:38  placement.txt
  5  -rwx     1644050   Mar 01 1993 19:36:14  boot.bin
  6  drwx        6720   Mar 01 1993 00:18:36  html
 86  -rwx         110   Mar 01 1993 19:37:00  info.ver
116  -rwx        3686   Mar 01 1993 19:55:33  config.text
 89  -rwx          25   Mar 01 1993 00:26:30  snmpengineid
  7  -rwx         313   Mar 01 1993 19:34:57  env_vars

3612672 bytes total (840704 bytes free)

Step 11 Verify that the switch reloads correctly by displaying the boot variable (BOOT path-list), which should also be boot.bin.

switch# show boot
BOOT path-list:      flash:boot.bin
Config file:         flash:config.text
Enable Break:        no
Manual Boot:         no
HELPER path-list:    
NVRAM/Config file
      buffer size:   32768

Recovering from an Incomplete VSM Software Upgrade

If you do not follow the procedure described in "Using VSM to Upgrade a Switch," an upgrade can fail due to insufficient space because of multiple software images or other files in Flash memory. When the upgrade fails, the image file is copied to Flash memory, but there is insufficient space for the HTML files, and you lose access to VSM.

In the event of a failure, ensure that the image file in Flash memory has the same name as the contents of the boot variable. You can compare these two names by following the last two steps in the procedure described in the "Using VSM to Upgrade a Switch" section.

If the contents of the boot variable and the image file name are the same, the switch can reset successfully. If they are different, rename the image file, or reset the boot variable by entering the system boot name global configuration command. The boot variable and the image file name should be the same.

To recover from the incomplete download of the HTML files, log in to the switch, and upgrade the software as described in the "Upgrading a Switch by Using the CLI" section.

Upgrading a Switch by Using the CLI

The CLI upgrade procedure consists of these major steps:

1. Downloading the combined .tar file from CCO, as described in the "Downloading the New Software" section. This file contains the IOS image and the HTML files. The tar command extracts the IOS image and the HTML files from the combined .tar file during the TFTP copy to the switch.

2. Downloading the TFTP server application to copy the switch software from your PC to the switch, if necessary.

3. Using the CLI to upgrade your switch or cluster to the new software.

Which Files to Use

Table 6 describes the file extensions and what they mean for the upgrade procedure. It is easier to upgrade the switch software by using a combined .tar file that contains the HTML files and the IOS image. The upgrade procedures in these release notes describe how to perform the upgrade by using a combined .tar file, and you must use a combined .tar file to upgrade a switch through the CMS.

Table 7 and Table 8 list the software files for this IOS release.

Table 6 Possible Extensions for IOS Software Files

Extension
Description

.tar

A compacted file from which you can extract files by using the tar command. There are two types of .tar files:

A combined .tar file that contains both the IOS image file and the HTML files.

An HTML .tar file that has the letters HTML in its name and contains just the HTML files for the IOS release. From the CLI, you can upgrade the switch software with this HTML file and the IOS image file.

.bin

The IOS image file that you can copy to the switch through TFTP.


Table 7 Catalyst 2900 Series XL Cisco IOS Software Files

Filename
Description

c2900XL-c3h2s-mz-120.5-XW.bin

IOS image-only file

c2900XL-c3h2s-mz-120.5-XW.tar

IOS image and HTML files

c2900XL-html-plus.120.5-XW.tar

HTML files


Table 8 Catalyst 3500 Series XL Cisco IOS Software Files

Filename
Description

c3500XL-c3h2s-mz-120.5-XW.bin

IOS image file

c3500XL-c3h2s-mz-120.5-XW.tar

IOS image file and HTML files

c3500XL-html-plus.120.5-XW.tar

HTML files


Downloading the New Software

Follow these steps to download the new software and, if necessary, the TFTP server application.


Step 1 Use Table 6 to Table 8 to identify the files that you want to download.


Note We recommend that you download the combined .tar file that contains the image file and the HTML files. The procedures in these release notes are for upgrading a switch by using the combined .tar file, and the VSM and Cluster Manager are designed to upgrade a switch by using this combined file.


Step 2 Download the files from the following location:

If you have a SmartNet support contract, log in to one of the following URLs and download the appropriate files:

http://www.cisco.com/pcgi-bin/tablebuild.pl/cat2900XL
http://www.cisco.com/pcgi-bin/tablebuild.pl/cat3500XL

If you do not have a SmartNet contract, download the appropriate files from one of the following URLs:

http://www.cisco.com/pcgi-bin/tablebuild.pl/cat2900XL
http://www.cisco.com/pcgi-bin/tablebuild.pl/cat3500XL

Step 3 Download the TFTP server from the URL listed in Step 2, if necessary. The readme.txt file describes how to download the TFTP server.

After you have downloaded the correct files to your PC or workstation, you can use the CLI to perform a TFTP transfer of the file or files to the switch.


Upgrading Catalyst 3500 Series XL Switches

This procedure is only for upgrading Catalyst 3500 XL switches by copying the combined .tar file to the switch. You copy the files to the switch from a TFTP server and extract the files by entering the tar command.

Follow these steps to upgrade the switch software by using a TFTP transfer:


Step 1 If your PC or workstation cannot act as a TFTP server, copy the file to a TFTP server to which you have access.

Step 2 Access the CLI by starting a Telnet session or by connecting to the switch console port through the RS-232 connector.

To start a Telnet session on your PC or workstation, enter the following command:

server% telnet switch_ip_address

Enter the Telnet password if you are prompted to do so.

Step 3 Enter privileged EXEC mode:

switch> enable 
switch#

Enter the password if you are prompted to do so.

Step 4 Display the name of the running (default) image file (BOOT path-list). The following example shows the name in italic:

switch# show boot 
BOOT path-list:    flash:current_image 
Config file:       flash:config.text 
Enable Break:      1 
Manual Boot:       no 
HELPER path-list:  
NVRAM/Config file 
buffer size: 32768

Step 5 If there is no file defined in the BOOT path-list, enter dir flash: to display the contents of Flash memory.

Step 6 Using the exact, case-sensitive name of the combined .tar file that you downloaded, rename the running image file to that name, and replace the .tar extension with .bin. The image filename is then the same as the downloaded filename but with a .bin extension. This step does not affect the operation of the switch.

switch# rename flash:current_image flash:new_image 
Source filename [current_image]?  
Destination filename [new_image]? 

For example:

switch# rename flash:c3500XL-c3h2-mz-112.8.2-SA6.bin flash:c3500XL-c3h2s-mz-120.5-XW.bin 

Step 7 Display the contents of Flash memory to verify the renaming of the file:

switch# dir flash: 
Directory of flash:/

  2  ---x     1644045   Apr 04 1993 15:17:15  c3500XL-c3h2s-mz-120.5-XW.bin
  3  -rwx         415   Jun 13 1993 05:15:37  placement.txt
  4  d--x        6848   May 03 2000 10:47:58  html
 70  -rwx          20   Mar 21 1993 09:17:03  prefs.text
  6  ---x         106   Mar 01 1993 21:56:52  info
228  ---x         106   Apr 04 1993 15:17:54  info.ver
 69  -rwx        2188   Mar 13 1993 03:38:28  config.text
230  -rwx         744   Mar 25 1993 19:16:46  vlan.dat
115  -rwx         354   Mar 13 1993 04:17:15  env_vars

3612672 bytes total (936960 bytes free) 

Step 8 Enter global configuration mode:

switch# config terminal 
Enter configuration commands, one per line. End with CNTL/Z. 

Step 9 Disable access to the switch HTML pages:

switch(config)# no IP http server

Step 10 If you entered the boot command with the name of the image file, enter this command to change it to the new name:

switch(config)# boot system flash:new_image

For example:

switch(config)# boot system flash:c3500XL-c3h2s-mz-120.5-XW.bin

Note If the show boot command entered in Step 4 displays no image name, you do not need to enter this command; the switch automatically finds the correct file to use when it resets.


Step 11 Return to privileged EXEC mode:

switch(config)# end

Step 12 Remove the HTML files:

switch# delete flash:html/* 

Press Enter to confirm the deletion of each file. Do not press any other keys during this process.


Caution In the following step, the tar command copies the combined.tar file that contains both the image and the HTML files. You do not need to copy an HTML.tar file in this procedure.

Step 13 Enter the following command to copy the new image and HTML files to the switch Flash memory:

switch# tar /x tftp://server_ip_address//path/filename.tar flash: 
Loading /path/filename.tar from server_ip_address (via VLAN1):!) 
extracting info (110 bytes)
extracting c3500XL-c3h2s-mz-120.5-XW.bin (1271095 bytes)!!!!!!!!!!!!!!!!!!!!
html/ (directory)
extracting html/Detective.html.gz (1139 bytes)!
extracting html/ieGraph.html.gz (553 bytes)
extracting html/DrawGraph.html.gz (787 bytes)
extracting html/GraphFrame.html.gz (802 bytes)!
... 

Depending on the TFTP server being used, you might need to enter only one slash (/) after the server_ip_address in the tar command.

Step 14 Enter global configuration mode:

switch# config terminal 
Enter configuration commands, one per line. End with CNTL/Z. 

Step 15 Re-enable access to the switch HTTP pages:

switch(config)# IP http server

Step 16 Return to privileged EXEC mode:

switch(config)# end

Step 17 Reload the new software with the following command:

switch# reload 
System configuration has been modified. Save? [yes/no]:y 
Proceed with reload? [confirm] 

Step 18 Press Return to confirm the reload.

Your Telnet session ends when the switch resets.

Step 19 After the switch reboots, use Telnet to return to the switch, and enter the privileged EXEC mode show version command to verify the upgrade procedure. If you have a previously-opened browser session to the upgraded switch, close the browser, and start it again to ensure that you are using the latest HTML files.


Upgrading 8-MB Catalyst 2900 Series XL Switches

This procedure is for upgrading Catalyst 2900 XL switches with 8 MB of DRAM. You upgrade a switch by extracting the IOS image file and the HTML files from a combined.tar file. You copy the files to the switch from a TFTP server and extract the files by entering the tar command.


Note If you want to copy the IOS image file or HTML files separately to the switch, refer to the Catalyst 2900 series XL release notes for Release 11.2(8)SA4 on CCO.


If you are unsure whether your switch has 4 MB or 8 MB of memory, you can verify memory capacity at Step 4.

Follow these steps to upgrade the switch software by using the tar command to start a TFTP transfer:


Step 1 If your PC or workstation cannot act as a TFTP server, copy the file to a TFTP server to which you have access.

Step 2 Access the CLI by starting a Telnet session or by connecting to the switch console port through the RS-232 connector.

To start a Telnet session on your PC or workstation, enter the following command:

server% telnet switch_ip_address

Enter the Telnet password if you are prompted to do so.

Step 3 Enter privileged EXEC mode:

switch> enable 
switch#

Enter a password if you are prompted to do so.

Step 4 Confirm that you have an 8-MB switch:

switch# show version
Cisco Internetwork Operating System Software IOS (tm) 
C2900XL Software (C2900XL-HS-M), Version 11.2(8.2)SA6, RELEASE SOFTWARE (fc1)
Copyright (c) 1986-1998 by cisco Systems, Inc.
Compiled Mon 23-Nov-98 20:59 by paulines
Image text-base: 0x00003000, data-base: 0x00202144

ROM: Bootstrap program is C2900XL boot loader

2900XL-EN-84.3 uptime is 1 day, 22 hours, 23 minutes
System restarted by power-on
Running default software


cisco WS-C2924-XL (PowerPC403GA) processor (revision 0x11) 
with 8192K/1024K bytes of memory.
Processor board ID 0x0E, with hardware revision 0x01
Last reset from power-on

Processor is running Enterprise Edition Software
24 Ethernet/IEEE 802.3 interface(s)

32K bytes of flash-simulated non-volatile configuration memory.
Base ethernet MAC Address: 00:50:80:39:EC:40
Motherboard assembly number: 73-3382-04
Power supply part number: 34-0834-01
Motherboard serial number: FAA02499G7X
Model number: WS-C2924-XL-EN
System serial number: FAA0250U03P
Configuration register is 0xF

Step 5 Display the name of the running (default) image file (BOOT path-list). The following example shows the name in italic:

switch# show boot 
BOOT path-list:    flash:current_image 
Config file:       flash:config.text 
Enable Break:      1 
Manual Boot:       no 
HELPER path-list:  
NVRAM/Config file 
buffer size: 32768

Step 6 If there is no file defined in the BOOT path-list, enter dir flash: to display the contents of Flash memory. The file named c2900XL-h2-mz-112.8.2.11-SA6.bin is your image file. c2900XL-h2-mz-112.8.2.11-SA6.bin

switch# dir flash:
Directory of flash:/

  2  ---x     1644046   Apr 04 1993 15:22:13  c2900XL-c3h2s-mz-120.5-XU.bin
  4  d--x        6848   Apr 04 1993 15:23:11  html
  6  -rwx          79   Apr 04 1993 15:20:34  env_vars
  5  ---x         106   Apr 04 1993 15:20:36  info
 68  -rwx        1399   May 16 2000 14:43:42  config.text
259  ---x         106   Apr 04 1993 15:23:12  info.ver

3612672 bytes total (940032 bytes free) 

Step 7 Using the exact, case-sensitive name of the combined .tar file that you downloaded, rename the running image file to that name, and replace the .tar extension with a .bin extension. The image file name is then the same as the downloaded file name but with a .bin extension. This step does not affect the operation of the switch.

switch# rename flash:current_image flash:new_image 
Source filename [current_image]?  
Destination filename [new_image]? 

For example:

switch# rename flash:c2900XL-h2-mz-112.8.2-SA6.bin flash:c2900XL--c3h2s-mz-120.5-XW.bin 
Source filename [c2900XL-h2-mz-112.8.2-SA6.bin]? 
Destination filename [c2900XL-c3h2s-mz-120.5-XW.bin]? 

Step 8 Enter global configuration mode:

switch# config terminal 
Enter configuration commands, one per line. End with CNTL/Z. 

Step 9 Disable access to the switch HTML pages:

switch(config)# no IP http server

Step 10 If you entered the boot command with the name of the image file, enter this command to change it to the new name.

switch(config)# boot system flash:new_image

For example:

switch(config)# boot system flash:c2900XL-c3h2s-mz-120.5-XW.bin

Note If the show boot command entered in Step 5 displays no image name, you do not need to enter this command; the switch automatically finds the correct file to use when it resets


Step 11 Return to privileged EXEC mode:

switch(config)# end

Step 12 Remove the HTML files:

switch# delete flash:html/* 

Press Enter to confirm the deletion of each file. Do not press any other keys during this process.

Step 13 If upgrading from Release 11.2(8)SA5 or earlier, remove the files in the Snmp directory:

switch# delete flash:html/Snmp/*

Make sure the S in Snmp is uppercase.

Press Enter to confirm the deletion of each file. Do not press any other keys during this process.


Caution In the following step, the tar command copies the combined .tar file that contains both the image and the HTML files. You do not need to copy an HTML.tar file in this procedure.

Step 14 Enter the following command to copy the new image and HTML files to the switch Flash memory:

switch# tar /x tftp://server_ip_address//path/filename.tar flash: 
Loading /path/filename.tar from server_ip_address (via VLAN1):!) 
extracting info (111 bytes)
extracting c2900XL-c3h2s-mz-120.5-XW.bin (1557286 bytes)!!!!!!!!!!!!!!!!!!!!
html/ (directory)
extracting html/Detective.html.gz (1139 bytes)!
extracting html/ieGraph.html.gz (553 bytes)
extracting html/DrawGraph.html.gz (787 bytes)!
. . . 

Depending on the TFTP server being used, you might need to enter only one slash (/) after the server_ip_address in the tar command.

Step 15 Enter global configuration mode:

switch# configure terminal 
Enter configuration commands, one per line. End with CNTL/Z. 

Step 16 Re-enable access to the switch HTTP pages:

switch(config)# IP http server

Step 17 Return to privileged EXEC mode:

switch(config)# end

Step 18 Reload the new software with the following command:

switch# reload 
System configuration has been modified. Save? [yes/no]:y 
Proceed with reload? [confirm] 

Step 19 Press Return to confirm the reload.

Your Telnet session ends when the switch resets.

Step 20 After the switch reboots, use Telnet to return to the switch, and enter the privileged EXEC mode show version command to verify the upgrade procedure. If you have a previously opened browser session to the upgraded switch, close the browser, and start it again to ensure that you are using the latest HTML files.


Installing the Required Plug-In

A browser Java plug-in is required to access the HTML-based CMS. Download and install the plug-in before you start CMS.

If the Java applet does not initialize after you have installed the plug-in, open the Java Plug-in Control Panel (Start > Programs > Java Plug-in Control Panel), and verify the following setting:

In the Proxies tab, verify that Use browser settings is checked and that no proxies are enabled.

Windows 95, Windows 98, and Windows NT 4.0 Users

If you have a SmartNet support contract, log in to one of the following URLs and download the plug-in:

http://www.cisco.com/pcgi-bin/tablebuild.pl/cat2900XL
http://www.cisco.com/pcgi-bin/tablebuild.pl/cat3500XL

If you do not have a SmartNet contract, download the plug-in from one of the following URLs:

http://www.cisco.com/pcgi-bin/tablebuild.pl/cat2900XL
http://www.cisco.com/pcgi-bin/tablebuild.pl/cat3500XL

If you start CMS without having installed the required Java plug-in, the switch automatically detects the lack of the plug-in. If you are using a supported Netscape browser, the browser displays a Cisco Connection Online (CCO) page that contains the Java plug-in and instructions to install it. If you are using a supported Internet Explorer browser, it automatically downloads and installs the browser.

Solaris Users

Solaris users need to download the Java plug-in and the JRE 1.2.2_05.

Download the Java plug-in for Solaris from the following URL:

http://www.sun.com/software/solaris/netscape/ipis/

Install the plug-in by following the instructions that are posted on the URL.

Install the JRE 1.2.2_05 from the following URL:

http://www.sun.com/software/solaris/java/download.html

Follow the links in the section titled J2SE: Java[tm] 2 SDK, Standard Edition (1.2.2_05) to download and install the JRE.

New Features in This Release

This section describes the new supported hardware and the new software features for the Catalyst 2900 series XL and Catalyst 3500 series XL switches that are provided in this release.

"New Hardware Features in Release 12.0(5)XW" section

"New Software Features in Release 12.0(5)XW" section


Note New major software features, more detailed descriptions, as well as procedures for implementation, are in the "Documentation Updates" section. This information will be incorporated into the next version of the software documentation.


New Hardware Features in Release 12.0(5)XW

This release supports the single-port 1000BaseT GBIC (WS-G5482). Switches running earlier software versions do not recognize and automatically enable this GBIC.


Note If the GBIC is not securely inserted, the switch might fail to recognize it or might display an incorrect media type following a show interface command entry. If this happens, remove and reinsert the GBIC.


New Software Features in Release 12.0(5)XW

This release contains the following new software features:

Cross-stack UplinkFast

Cross-stack UplinkFast provides a fast spanning-tree transition (fast convergence in less than 2 seconds under normal network conditions) across a stack of switches that use the GigaStack GBICs connected in a shared cascaded configuration (multidrop backbone). During the fast transition, an alternate redundant link on the stack of switches is placed into the forwarding state without causing temporary loops or loss of connectivity to the backbone. With this feature, you can have a redundant and resilient network. For more information, see the "Understanding Cross-Stack UplinkFast" section.

DHCP-based autoconfiguration

The DHCP provides configuration information to Internet hosts and internetworking devices. With DHCP-based autoconfiguration, your switch (DHCP client) can be automatically configured during bootup with IP address information and a configuration file that it receives during DHCP-based autoconfiguration. DHCP replaces BOOTP for autoconfiguration to ensure retrieval of configuration files by unicast TFTP messages. For more information, see the "Understanding DHCP-Based Autoconfiguration" section.

The following new features were added to CMS:

Port Search window: From the main menu, select Port > Port Search. In this window, you can search for ports by their description. After a search is complete, you can select one of the ports and click View Details to display its run-time status.

Port Statistics window: From the main menu, select Port > Port Statistics. In this window, you can monitor the data traffic on the ports of a given device in three tabbed panels (Overview, Transmit Details, and Receive Details). You can also refresh the display or reset the statistics counters.

In Cluster Manager, a new port status LED indication has been added. You can now distinguish between ports that are disabled and have no links (LED shows brown) and ports that are disabled and have links (LED shows amber).

In Cluster Manager, a Describe button was added to the Port Configuration window. When you select a single (or multiple) row and click Describe, the Basic Port Description window opens. In this window, you can specify the port description.

Enhancements to the online help, which provide an index, a glossary, Back and Forward buttons for quick navigation within a set of topics, and a link to an online feedback form.

Limitations and Restrictions

You should review this section before you begin working with the switches. Some features might not work as documented, and some features could be affected by recent changes to the switch hardware or software.

Regardless of the switch model, only 64 possible instances of STP are supported.

When connecting to the Catalyst 3524-PWR XL 10/100 inline-power ports, observe the following caution:


Caution It takes a Catalyst 3524-PWR XL 10/100 port up to 10 seconds to initially detect, power, and link to a Cisco IP Phone. If you disconnect the Cisco IP Phone before link has been established, you must wait 10 seconds before connecting another network device (other than another Cisco IP phone) to that switch port. Failure to do so can result in damage to that network device.

The Cisco 600W Redundant Power System (RPS) supports all Catalyst 2900 and 3500 XL switches other than the Catalyst 3524-PWR XL switch to provide a quasi-redundant power source for four external devices that use up to 150W DC each. You can use a one-to-one cable (one connector at each end) to connect four external devices to the four DC output power modules. The power source is quasi-redundant because there are two AC input power modules for the Cisco RPS and one DC output power module for each external device. The AC input to the Cisco RPS is fully redundant, but the DC output to the external devices is not.

The Cisco RPS 300 Redundant Power System supports the Catalyst 3524-PWR XL switch and provides redundancy for up to six connected devices until one of these devices requires backup power. If a connected device has a power failure, the RPS immediately begins supplying power to that device and sends status information to other connected devices that it is no longer available as a backup power source. As described in device documentation, when the RPS LED is amber, the RPS is connected but down. However, this might merely indicate that the RPS is in standby mode. Press the Standby/Active button on the RPS to put it into active mode. Refer to the RPS 300 Hardware Installation Guide for more information.
You can view RPS status through the CLI by using the show rps privileged EXEC command.

You can connect the switch to a PC by using the switch console port and the supplied rollover cable and the DB-9 adapter. You need to provide a RJ-45-to-DB-25 female DTE adapter if you want to connect the switch console port to a terminal. You can order a kit (part number ACS-DSBUASYN=) with this RJ-45-to-DB-25 female DTE adapter from Cisco.

Certain combinations of port features create configuration conflicts. Refer to the section on "Managing Configuration Conflicts" in the Cisco IOS Desktop Switching Software Configuration Guide for a table that defines these conflicts.

Host names and Domain Name System (DNS) server names that contain commas on a cluster command switch, member switch, or candidate switch can cause CMS to behave unexpectedly. You can avoid this instability in the interface by not using commas in host names or DNS names. Do not enter commas when also entering multiple DNS names in the IP Configuration tab of the IP Management window in CMS.

The range of seconds for the span-tree max-age global configuration command is now 6 to 200 seconds. If you used this command in a release before 11.2(8)SA6 to set a value greater than this new range and then upgrade your software to Release 11.2(8.1)SA6 or later, the switch sets this value to the default: 20 seconds for IEEE STP and 10 seconds for IBM STP.

When using the SPAN feature, the monitoring port receives copies of sent and received traffic for all monitored ports. If the monitoring port is 50 percent oversubscribed for a sustained period of time, it will probably become congested. One or more of the ports being monitored might also experience a slowdown.

When using the Software Image Management (SWIM) application in the Resource Manager Essentials (RME) suite of the CiscoWorks2000 product family to perform automated system software and boot loader upgrades, you should note the following:

Catalyst 2900 series XL switches require Release 11.2(8)SA4 or later and RME version 2.1
or 2.2.

Catalyst 3500 series XL switches require Release 11.2(8.1)SA6 or later and RME version 2.2.

All Catalyst 3500 series XL and most Catalyst 2900 series XL switches support 250 VLANs. However, the Catalyst 2912 XL, Catalyst 2924 XL, and Catalyst 2924C XL support only 64 VLANs.

Important Notes

This section describes important information related to Release 12.0(5)XW.

When you are configuring a cascaded stack of Catalyst 3500 XL switches using the GigaStack GBIC and want to include more than one VLAN in the stack, be sure to configure all of the GigaStack GBIC interfaces as trunk ports by using the switchport mode trunk interface configuration command and to use the same encapsulation method by using the switchport encapsulation {isl | dot1q} interface configuration command. For more information about these commands, refer to the command reference publication for your switch.

Before upgrading your switch, read the "Documentation Updates" section for important information.

Caveats

Open Caveats

This section describes possible unexpected activity by Release 12.0(5)XW.

If no spanning-tree [vlan stp-list] is specified in the configuration file, when the switch is reloaded, vlan stp-list is pruned even if there is an active link on the VLAN.

There is no workaround. (CSCds40442)

The UniDirectional Link Detection (UDLD) protocol does not always detect a unidirectional link when there is a loop between the TX and RX strands on the same port (TX/RX loop condition).

This is an intermittent problem, and there is no workaround. (CSCds68177)

When UDLD is enabled on a port group and a unidirectional link is detected on one port in the group, UDLD shuts down all members of the group instead of only the port experiencing the unidirectional link.

There is no workaround. (CSCds87929)

If you select a switch in the tree by using Cluster Management and choose Console Baud Rate, the baud rate dialog appears with the selected switch in the Selected Device List. If you then click cancel and select Console Baud Rate again, two identical items for the same switch is listed.

There is no workaround. (CSCds86420)

If multiple devices have the same host name, selecting one of these devices using the tree view in Cluster Manager selects all the devices with the same host name.

The workaround is to not use the same host name for multiple switches in the cluster. (CSCdr86448)

If you connect two Catalyst 2924M XL switches through GBIC interfaces and then remove the cable, the GBIC LED remains green for up to 1 minute, even though the switches are not connected.

The workaround, if you need to reconnect the switches through their GBIC ports, is to wait until the green LED turns off, and then reconnect the switches. (CSCds89780)

When two switches are connected by GigaStack GBICs and duplex mode is manually set to full duplex or to autonegotiate on both ends, the link sometimes will not stabilize.

If this occurs, the workaround is to remove and reinsert one of the GBICs. (CSCds84479)

If you use Cluster Manager to choose Stack Area or Stack Bar graph types, the graph displays the data incorrectly.

The workaround is to use the graph types Line (default) or Bar to view the data. (CSCds54709)

The c2900InfoRedundantPowerSupplyInfo MIB object returns the wrong values for some RPS-to-switch conditions for the RPS 300. When the RPS is connected and in Standby mode, the expected status is "connectedNotFunctional;" the status returned is "functionalPrimaryFailed." When the RPS is in the Active state and no connected switch is being backed up, the expected status is "connectedFunctional;" the status returned is "connectedNotFunctional."

There is no workaround. (CSCds82026)

When you enter a show interface [interface-id] status privileged EXEC command for a WS-X2932-XL or GigaStack GBIC interface, the display shows Unknown in the interface Type field.

There is no workaround. This will be fixed in a future release. (CSCds82043)

The DHCP server should contain reserved addresses that are bound to each switch by the switch hardware address so that the switch does not obtain its IP address from the dynamic pool. If the switch gets configured from the dynamic IP pool, a duplicate or different IP address might be assigned. (CSCds58369)

Cluster Management Suite requires a Java plug-in from Sun Microsystems. If you are using Internet Explorer and you disable Java plug-ins by using the Java Plug-In Control Panel, the initial Splash screen shows that the plug-in and Java are enabled, but Internet Explorer crashes.

The workaround is to not disable Java plug-ins on the Java Plug-In Control Panel. (CSCdp67822)

If you right-click a device that is near the edge of the browser window, the second-level menu of the device pop-up menu might not display.

The workaround is to right-click again on the device until the pop-up menu displays correctly. (CSCdp61365)

The Cluster Manager System Time Management window supports the configuration of the Network Time Protocol (NTP) and system time. When you make changes on this window from a command switch, Java propagates the changes to all cluster members. A conflict can arise if you configure NTP and also use the Set Daylight Saving Time and Set Current Time tabs.

To avoid a possible conflict, either set the system time for the entire cluster on the command switch, or configure NTP on the command switch to use an NTP server to provide time to the cluster. Do not use both methods at the same time. (CSCdp82224)

You can use Cluster Manager to configure an Hot Standby Router Protocol (HSRP) standby group and bind it to a cluster. However, you cannot use Cluster Manager to configure more than one standby group. If you want to configure more than one standby group, use the CLI. (CSCdp82354)

The serial port shares the same status bit for hardware flow control and for ready.

The workaround is to not use flow control on the console port. (CSCdm24487)

When changing the management VLAN on a cluster with command-switch redundancy enabled, the cluster can break if HSRP is configured on any of the cluster members in the new management VLAN.

The workaround is to not change the management VLAN to a VLAN where a member is configured as part of a standby group. (CSCdp70389)

Root guard is inconsistent when configured on a port that is in the STP blocked state at the time of configuration. (CSCdp85954)

HSRP does not support entering a virtual MAC address or a built-in address (BIA) for a cluster. (CSCdp49419).

All members of an HSRP standby group must be cluster members. (CSCdp97517)

If a non-private VLAN edge port is configured to monitor a private VLAN edge port (to use SPAN), the SPAN port captures monitored traffic from the private VLAN edge port to other private VLAN edge ports. This happens even though the monitored private VLAN edge port is not forwarding traffic to other private VLAN edge ports. In effect, the SPAN port captures incorrect traffic.

The workaround is to not monitor private VLAN edge ports. (CSCdp84267)

If the storm control filter is enabled for unicast, multicast, or broadcast traffic and the rising threshold is reached, all traffic on the port is filtered. No unicast, multicast, or broadcast traffic is forwarded from the port. (CSCdp30543)

Cisco IOS does perform some checks on entered IP addresses. For example, it does not allow the broadcast address to be entered. However, it does not check for the broadcast address on the same subnet as the HSRP VIP or the management VLAN IP address. This means that you could configure HSRP with a virtual IP address that is the same as the network broadcast address.

There is no workaround. (CSCdp87748)

If you use the command switch DNS server name to start CMS for a member that is running an earlier software release, CMS might not display the switch image, or it might display the command switch image. This can also occur when a standby group is configured for a cluster and you access CMS by entering the command-switch IP address and not the virtual IP address.

The workaround is to always use the command-switch IP address to access CMS. If a standby group is configured for a cluster, always use the virtual IP address to access CMS. (CSCdp75220)

CMS can behave unexpectedly if host names or DNS server names that it processes contain commas. This means that host names or DNS server names on a cluster command switch, member, or neighbor can cause instability in the HTML interface.

The workaround is to not include commas in host names or DNS server names in CMS. (CSCdp85928)

If you click the list of switches in CMS and press the Page Down key on the keyboard, the entire list moves to the bottom of the window. This only happens with Windows NT.

The workaround is to collapse the list into a single icon, which returns the list to the top of the window. (CSCdp62807)

In VSM, you cannot see the individual menu items when you right-click the chassis image to display the device pop-up menu.

The workaround is to right-click another part of the chassis image to display the device pop-up menu. (CSCdp89945)

When STP Port Fast or STP root guard are configured on a module port, the configuration is not saved after the module is removed and reinserted. These features need to be reconfigured on the module ports after the module is reinserted. (CSCdr04281)

Resolved Caveats

You are no longer prompted twice for the enable password if you use the DNS name instead of the IP address to access a cluster. (CSCdp69639)

After you enter the write erase privileged EXEC command on a Catalyst 2900 XL switch, the flash:config.text file is erased. Previously, the flash:config.text file was emptied but not erased, which prevented the switch from entering configuration mode when starting up. (CSCdr65397)

You can use the mouse to correctly select ports with Cluster Manager. (CSCdr72702)

Catalyst 2900 XL and 3500 XL switches no longer reload due to improper signaling on the console port. (CSCdr76698)

IOS context-sensitive help no longer incorrectly lists IEEE 802.1q encapsulation as 801.1q. (CSCdr77219)

Entering the verify flash:<filename> privileged EXEC command no longer causes traceback and CPU hog messages. (CSCdr77745)

Intermittent resets no longer occur with 3500 XL switches in clusters. (CSCdr78216)

Catalyst 3500 XL switches set the bridge-protocol data unit (BPDU) bit to 1 in the Inter-Switch Link (ISL) header for VLAN Trunk Protocol (VTP) packets. (CSCdr80902)

The no logging event link-status interface configuration command functions correctly. (CSCdr81479)

A Catalyst 3500 XL switch no longer resets when using a Telnet connection to a switch that switch has more than eight addresses cached for the host device. (CSCdr82333)

The interim local management interface (ILMI) peer address registration for Asynchronous Transfer Mode (ATM) no longer fails when the VLAN 1 management interface does not have a defined IP address. (CSCdr87528)

A request for a TFTP download can be done by using a directed unicast packet instead of a broadcast packet. Direct TFTP download capability is available with the DHCP-based autoconfiguration, a new software feature in 12.0(5)XW. (CSCdr91234)

When a Catalyst 2924M switch is running 12.0(5.x)XU, a WS-X2922-XL module negotiates a link on the other end of the fiber-optic cable. Previously, it was necessary to downgrade the firmware to Release 12.0(5.1)XP. (CSCdr92913)

Enabling the port storm-control multicast [threshold {rising rising-number falling falling-number}] interface configuration command no longer causes duplicate entries in the display. (CSCdr93010)

When configuring the Catalyst 2900 and Catalyst 3500 XL switches and the configuration line exceeds 80 characters, IOS no longer incorrectly parses the configuration line. (CSCdr95761)

The show interface status privileged EXEC command summarizes the states for all ports on the switch. (CSCdr98191)

Enabling Immediate Leave processing no longer causes IGMP packets to be dropped or degrades mtrace functionality. (CSCds02174)

Catalyst 2924 XL switches now support up to 65 VLANs. (CSCds18724)

When two Catalyst 2900 or 3500 XL series switches are connected through Fast EtherChannel, a single link failure no longer causes connectivity loss between the management interfaces of the switches. (CSCds27100)

When two Catalyst 3548 switches are stacked, 20 to 30 seconds of link flap no longer occurs when power is lost to the switch, when the switch is reloaded, or when a network topology changes. (CSCds31477)

The write network privileged EXEC command saves the configuration information with the filename hostname.txt instead of config.txt. (CSCds46010)

When PortFast is configured on a port running at 10 Mbps half duplex and devices are connected to the switch, the port status LEDs no longer turn amber instead of green on some ports after the switch reloads. (CSCds45990)

Documentation Updates

This section provides updates to the product documentation. These changes will be included in the next version of the documentation.

"Documentation Notes" section

"Setting Up the Catalyst 2900 XL Initial Configuration" section

"Configuring Voice Ports to Carry Voice and Data Traffic on Different VLANs" section

"Understanding Cross-Stack UplinkFast" section

"Understanding DHCP-Based Autoconfiguration" section

"New and Changed Commands" section

"Syslog Error Messages" section

Documentation Notes

The Catalyst 3508 XL switch (WS-C3508G-XL) now ships with a power rating of 1.5A/0.75A. The back-panel illustration of the Catalyst 3508 XL switch in Figure 1-17 on page 1-23 in the Catalyst 3500 Series XL Hardware Installation Guide shows an outdated power rating of 1A/0.5A.

In the Catalyst 3500 Series XL Hardware Installation Guide, there are references to the Cisco IP Phone 7940. This phone was not available at the time of this publishing. Check with your Cisco sales representative, or go to the Cisco Architecture for Voice, Video and Integrated Data (AVVID) web site.

The RJ-45-to-DB-9 female DTE (labeled PC) adapter is now the only adapter that ships with the switches. Disregard the text in the documentation that refers to the DB-45-to-DB-25 female DTE adapter. You can order a kit (part number ACS-DSBUASYN=) with the terminal adapter from Cisco.

Setting Up the Catalyst 2900 XL Initial Configuration

The procedure for setting up the initial configuration on the Catalyst 2900 XL switches, as described in the Catalyst 2900 Series XL Installation Guide, has been updated. Follow these steps to create an initial configuration for the switch:


Step 1 Enter Y at the first prompt.

Continue with configuration dialog? [yes/no]: y

Step 2 Enter the switch IP address, and press Return:

Enter IP address: ip_address

Step 3 Enter the subnet mask, and press Return:

Enter IP netmask: ip_netmask

Step 4 Enter Y at the next prompt to specify a default gateway (router):

Would you like to enter a default gateway address? [yes]: y 

Step 5 Enter the IP address of the default gateway, and press Return.

IP address of the default gateway: ip_address

Step 6 Enter a host name for the switch, and press Return.


Note On a command switch, the host name is limited to 28 characters; on a member switch to 31 characters. Do not use -n, where n is a number, as the last character in a host name for any switch.


Enter a host name: host_name 

Step 7 Enter a secret password, and press Return.


Note The password can be from 1 to 25 alphanumeric characters, can start with a number, is case sensitive, allows spaces, but ignores leading spaces.


Enter enable secret: secret_password

Step 8 Enter Y to enter a Telnet password:

Would you like to configure a Telnet password? [yes] y

Note The password can be from 1 to 25 alphanumeric characters, is case sensitive, allows spaces, but ignores leading spaces.


Step 9 Enter the Telnet password, and press Return:

Enter Telnet password: telnet_password

Step 10 Enter Y to configure the switch as the cluster command switch. Enter N to configure it as a member switch or as a standalone switch.


Note If you enter N, the switch appears as a candidate switch in Cluster Builder. In this case, the message in Step 11 is not displayed.


Would you like to enable as a cluster command switch? y

Step 11 Assign a name to the cluster, and press Return.

Enter cluster name: cls_name

Note The cluster name can be 1 to 31 alphanumeric characters, dashes, or underscores.


Step 12 The initial configuration is displayed:

The following configuration command script was created: 
 
ip subnet-zero 
interface VLAN1 
ip address 172.20.153.36 255.255.255.0 
ip default-gateway 172.20.153.01 
hostname host_name 
enable secret 5 $1$M3pS$cXtAlkyR3/6Cn8/ 
line vty 0 15 
password telnet_password 
snmp community private rw 
snmp community public ro 
cluster enable cls_name 
 
end 

Step 13 Verify that the information is correct.

If the information is correct, enter Y at the prompt, and press Return.

If the information is not correct, enter N at the prompt, press Return, and begin again at Step 1.

Use this configuration? [yes/no]: y 


After you complete the setup program, the switch can run the created default configuration. If you want to change this configuration or want to perform other management tasks, use one of these tools:

Command-line interface (CLI)

Cluster Management Suite from your browser

Configuring Voice Ports to Carry Voice and Data Traffic on Different VLANs

The Cisco 7960 IP Phone contains an integrated 3-port 10/100 switch that can connect to a PC or other device. You can configure a switch port to instruct the phone to forward voice and data traffic on different virtual LANs (VLANs).

In the following configuration, data traffic is carried by VLAN 1, and voice traffic is carried by VLAN 2. In this configuration, all IP phones and other voice-related devices must be connected to switch ports that belong to VLAN 2.

Beginning in privileged EXEC mode, follow these steps to configure a port to receive voice and data from an IP phone in different VLANs:

 
Command
Purpose

Step 1 

configure terminal

Enter global configuration mode.

Step 2 

interface interface

Enter interface configuration mode, and enter the port to be configured.

Step 3 

switchport priority default (0)

Assign an IEEE 802.1p priority to untagged traffic that is received on the switch port. The phone forwards this traffic through the native VLAN, VLAN 1.

Step 4 

switchport voice vlan (2)

Instruct the IP phone to forward all voice traffic through VLAN 2. The IP phone forwards the traffic with an 802.1p priority of 5.

Step 5 

end

Return to privileged EXEC mode.

Step 6 

show interface interface switchport

Verify the configuration of the port.

Understanding Cross-Stack UplinkFast

Cross-stack UplinkFast (CSUF) provides a fast spanning-tree transition (fast convergence in less than 2 seconds under normal network conditions) across a stack of switches that use the GigaStack GBICs connected in a shared cascaded configuration (multidrop backbone). During the fast transition, an alternate redundant link on the stack of switches is placed into the forwarding state without causing temporary spanning-tree loops or loss of connectivity to the backbone. With this feature, you can have a redundant and resilient network in some configurations.

CSUF might not provide a fast transition all the time; in these cases, the normal STP transition occurs, which completes in 30 to 40 seconds. For more information, see the "Events that Cause Fast Convergence" section.

How CSUF Works

CSUF ensures that one link in the stack is elected as the path to the root. As shown in Figure 1, Switches A, B, and C are cascaded through the Gigastack GBIC to form a multidrop backbone, which communicates control and data traffic across the switches at the access layer. The switches in the stack use their stack ports to communicate with each other and to connect to the stack backbone; stack ports are always in the STP forwarding state. The stack root port on Switch A provides the path to the root of the spanning tree; the alternate stack root ports on Switches B and C can provide an alternate path to the spanning-tree root if the current stack root switch fails or its link to the spanning-tree root fails.

Link A, the root link, is in the STP forwarding state; Links B and C are alternate redundant links that are in the STP blocking state. If Switch A fails, if its stack root port fails, or if Link A fails, CSUF selects either the Switch B or Switch C alternate stack root port and puts it into the forwarding state in less than 1 second.

Figure 1 Cross-Stack UplinkFast Topology

CSUF implements the Stack Membership Discovery Protocol and the Fast Uplink Transition Protocol. Using the Stack Membership Discovery Protocol, all stack switches build a neighbor list of stack members through the receipt of discovery hello packets. When certain link loss or STP events occur (described in "Events that Cause Fast Convergence" section), the Fast Uplink Transition Protocol uses the neighbor list to send fast-transition requests on the stack port to stack members.

The switch sending the fast-transition request needs to do a fast transition to the forwarding state of a port that it has chosen as the root port, and it must obtain an acknowledgement from each stack switch before performing the fast transition.

Each switch in the stack determines if the sending switch is a better choice than itself to be the stack root of this STP instance by comparing STP root, cost, and bridge ID. If the sending switch is the best choice as the stack root, the switch in the stack returns an acknowledgement; otherwise, it does not respond to the sending switch (drops the packet) and prevents the sending switch from receiving acknowledgements from all stack switches.

When acknowledgements are received from all stack switches, the Fast Uplink Transition Protocol on the sending switch immediately transitions its alternate stack root port to the forwarding state. If acknowledgements from all stack switches are not obtained by the sending switch, the normal STP transitions (blocking, listening, learning, forwarding) take place, and the spanning-tree topology converges at its normal rate (2 * forward-delay time + max-age time).

The Fast Uplink Transition Protocol is implemented on a per-VLAN basis and affects only one STP instance at a time.

Events that Cause Fast Convergence

Depending on the network event or failure, fast convergence provided by CSUF might or might not occur.

Fast convergence (within 2 seconds under normal network conditions) occurs under these circumstances:

The stack root port link goes down.

If two switches in the stack have alternate paths to the root, only one of the switches performs the fast transition.

The failed link, which connected the stack root to the STP root, comes back up.

A network reconfiguration causes a new stack root switch to be selected.

A network reconfiguration causes a new port on the current stack root switch to be chosen as the stack root port.


Note The fast transition might not occur if multiple events occur simultaneously. For example, if a stack member switch is powered down, and at the same time, the a link connecting the stack root to the STP root comes back up, the normal STP convergence occurs.


Normal STP convergence (30 to 40 seconds) occurs under these conditions:

The stack root switch is powered down or the software failed.

The stack root switch, which was powered down or failed, is powered up.

A new switch, which might become the stack root, is added to the stack.

A switch, other than the stack root, is powered down or failed.

A link fails between stack ports on the multidrop backbone.


Note The fast transition of CSUF depends on the amount of network traffic and how you connect the GigaStack GBICs across the stack switches. Because the Fast Uplink Transition Protocol only waits for 2 seconds to receive acknowledgements from all stack switches, heavy network traffic might prevent the fast transition from occurring within this time frame. Instead of a fast transition, the normal STP convergence then occurs.


Limitations

The following limitations apply to CSUF:

CSUF uses the Gigastack GBIC and runs on all Catalyst 3500 XL switches but only on modular Catalyst 2900 XL switches.

Up to nine stack switches can be connected through their stack ports to the multidrop backbone. Only one stack port per switch is supported.

Each stack switch can be connected to the STP backbone through one uplink.

Up to 64 VLANs are supported.

Connecting the Stack Ports

A fast transition occurs across the stack of switches if the multidrop backbone connections are a continuous link from one GigaStack GBIC to another as shown in Figure 2. In addition, follow these guidelines:

Do not connect alternate stack root ports to stack ports.

Only one stack port is supported per switch.

All stack ports on the stack of switches must be connected to the multidrop backbone.

You can connect the open ports on the top and bottom GigaStack GBICs within the same stack to form a redundant link.

Figure 2 GigaStack GBIC Connections and STP Convergence

Configuring Cross-Stack UplinkFast

Before enabling CSUF, make sure your stack switches are properly connected. For more information, see the "Connecting the Stack Ports" section.

Beginning in privileged EXEC mode, follow these steps to enable CSUF:

 
Command
Purpose

Step 1 

configure terminal

Enter global configuration mode.

Step 2 

spanning-tree uplinkfast [max-update-rate pkts-per-second]

Enable UplinkFast on the switch.

(Optional) For max-update-rate pkts-per-second, specify the number of packets per second at which update packets are sent. The range is 0 to 65535; the default is 150 packets per second.

Step 1 

interface interface-id

Enter interface configuration mode, and specify the GBIC interface on which to enable CSUF.

Step 2 

spanning-tree stack-port

Enable CSUF on only one stack-port GBIC interface.

The stack port connects to GigaStack GBIC multidrop backbone. If you try to enable CSUF on a Fast Ethernet or a copper-based Gigabit Ethernet port, you receive an error message.

If CSUF is already enabled on an interface and you try to enable it on another interface, you receive an error message. You must disable CSUF on the first interface before enabling it on a new interface.

Use this command only on access switches.

Step 3 

end

Return to privileged EXEC mode.

Step 4 

show spanning-tree

Verify your entries.

Step 5 

copy running-config startup-config

(Optional) Save your entries in the configuration file.

To disable CSUF on an interface, use the no spanning-tree stack-port interface configuration command. To disable UplinkFast on the switch, use the no spanning-tree uplinkfast global configuration command.

Understanding DHCP-Based Autoconfiguration

The DHCP provides configuration information to internet hosts and internetworking devices. This protocol consists of two components: one for delivering configuration parameters from a DHCP server to a device and a mechanism for allocating network addresses to devices. DHCP is built on a client-server model, where designated DHCP servers allocate network addresses and deliver configuration parameters to dynamically configured devices.

With DHCP-based autoconfiguration, your switch (DHCP client) can be automatically configured at startup with IP address information and a configuration file that it receives during DHCP-based autoconfiguration.

With DHCP-based autoconfiguration, no DHCP client-side configuration is required on your switch. However, you need to configure the DHCP server for various lease options. You might also need to configure a TFTP server, a Domain Name System (DNS) server, and possibly a relay device if the servers are on a different LAN than your switch. A relay device forwards broadcast traffic between two directly connected LANs. A router does not forward broadcast packets, but it forwards packets based on the destination IP address in the received packet. DHCP-based autoconfiguration replaces the BOOTP client functionality on your switch.

DHCP Client Request Process

When you boot your switch, the DHCP client can be invoked and automatically request configuration information from a DHCP server under the following conditions:

The configuration file is not present on the switch.

The configuration file is present, but the IP address is not specified in it.

The configuration file is present, the IP address is not specified in it, and the service config global configuration command is included. This command enables the autoloading of a configuration file from a network server.

Figure 3 shows the sequence of messages that are exchanged between the DHCP client and the DHCP server.

Figure 3 DHCP Request for IP Information from a DHCP Server

The client, Switch A, broadcasts a DHCPDISCOVER message to locate a DHCP server. The DHCP server offers configuration parameters (such as an IP address, subnet mask, gateway IP address, DNS IP address, a lease for the IP address, and so forth) to the client in a DHCPOFFER unicast message.

In a DHCPREQUEST broadcast message, the client returns a formal request for the offered configuration information to the DHCP server. The formal request is broadcast so that all other DHCP servers that received the DHCPDISCOVER broadcast message from the client can reclaim the IP addresses that they offered to the client.

The DHCP server confirms that the IP address has been allocated to the client by returning a DHCPACK unicast message to the client. With this message, the client and server are bound, and the client uses configuration information received from the server. The amount of information the switch receives depends on how you configure the DHCP server. For more information, see the "Configuring the DHCP Server" section.

If the configuration parameters sent to the client in the DHCPOFFER unicast message by the DHCP server are invalid (a configuration error exists), the client returns a DHCPDECLINE broadcast message to the DHCP server.

The DHCP server sends the client a DHCPNAK denial broadcast message, which means the offered configuration parameters have not been assigned, an error has occurred during the negotiation of the parameters, or the client has been slow in responding to the DHCPOFFER message (the DHCP server assigned the parameters to another client) of the DHCP server.

A DHCP client might receive offers from multiple DHCP or BOOTP servers and can accept any one of the offers; however, the client usually accepts the first offer it receives. The offer from the DHCP server is not a guarantee that the IP address will be allocated to the client; however, the server usually reserves the address until the client has had a chance to formally request the address. If the switch accepts replies from a BOOTP server and configures itself, the switch will broadcast, instead of unicast, TFTP requests to obtain the switch configuration file.

Configuring the DHCP Server

You should configure the DHCP servers with reserved leases that are bound to each switch by the switch hardware address. If the DHCP server does not support reserved leases, the switch can obtain different IP addresses and configuration files at different boot instances. You should configure the DHCP server with the following lease options:

IP address of the client (required)

Subnet mask of the client (required)

DNS server IP address (required)

Router IP address (default gateway address to be used by the switch) (required)

TFTP server name (required)

Boot filename (the name of the configuration file that the client needs) (recommended)

Host name (optional)

If you do not configure the DHCP server with the lease options described earlier, then it replies to client requests with only those parameters that have available values. If the IP address and subnet mask are not in the reply, the switch is not configured. If the DNS server IP address, router IP address, or TFTP server name are not found, the switch might broadcast TFTP requests. Unavailability of other lease options does not affect autoconfiguration.


Note If the configuration file on the switch does not contain the IP address, the switch obtains its address, mask, gateway IP address, and host name from DHCP. If the service config global configuration command is specified in the configuration file, the switch receives the configuration file through TFTP requests. If the service config global configuration command and the IP address are both present in the configuration file, DHCP is not used, and the switch obtains the default configuration file by broadcasting TFTP requests.


The DHCP server can be on the same or a different LAN as the switch. If it is on a different LAN, the switch must be able to access it through a relay device. The DHCP server can be running on a UNIX or Linux operating system; however, the Windows NT operating system is not supported in this release.

For more information, see the "Configuring the Relay Device" section. You must also set up the TFTP server with the switch configuration files; for more information, see the next section.

Configuring the TFTP Server

The TFTP server must contain one or more configuration files in its base directory. The files can include the following:

The configuration file named in the DHCP reply (the actual switch configuration file)

The network-confg or the cisconet.cfg file (known as the default configuration files)

The router-confg or the ciscortr.cfg file (These files contain commands common to all switches. Normally, if the DHCP and TFTP servers are properly configured, these files are not accessed.)

You must specify the TFTP server name in the DHCP server lease database. You must also specify the TFTP server name-to-IP-address mapping in the DNS server database.

The TFTP server can be on the same or a different LAN as the switch. If it is on a different LAN, the switch must be able to access it through a relay device or a router. For more information, see the "Configuring the Relay Device" section.

If the configuration filename is provided in the DHCP server reply, the configuration files for a switch can be spread over multiple TFTP servers. However, if the configuration filename is not provided, then the configuration files must reside on a single TFTP server.

Configuring the DNS

The switch uses the DNS server to resolve the TFTP server name to a TFTP server IP address. You must configure the TFTP server name-to-IP address map on the DNS server. The TFTP server contains the configuration files for the switch.

You must configure the IP addresses of the DNS servers in the lease database of the DHCP server from where the DHCP replies will retrieve them. You can enter up to two DNS server IP addresses in the lease database.

The DNS server can be on the same or a different LAN as the switch. If it is on a different LAN, the switch must be able to access it through a relay device or router. For more information, see the "Configuring the Relay Device" section.

Configuring the Relay Device

You need to use a relay device if the DHCP, DNS, or TFTP servers are on a different LAN than the switch. You must configure this relay device to forward received broadcast packets on an interface to the destination host. This configuration ensures that broadcasts from the DHCP client can reach the DHCP, DNS, and TFTP servers and that broadcasts from the servers can reach the DHCP client.

If the relay device is a Cisco router, you enable IP routing (ip routing global configuration command) and configure it with helper addresses by using the ip helper-address interface configuration command.

For example, in Figure 4, you configure the router interfaces as follows:

On interface 10.0.0.2:

router(config-if)# ip helper-address 20.0.0.2
router(config-if)# ip helper-address 20.0.0.3
router(config-if)# ip helper-address 20.0.0.4

On interface 20.0.0.1

router(config-if)# ip helper-address 10.0.0.1

Figure 4 Relay Device Used in Autoconfiguration

Obtaining Configuration Files

Depending on the availability of the IP address and the configuration filename in the DHCP reserved lease, the switch obtains its configuration information in the following ways:

The IP address and the configuration filename is reserved for the switch and provided in the DHCP reply (one-file read method).

The switch receives its IP address, subnet mask, and configuration filename from the DHCP server. It also receives a DNS server IP address and a TFTP server name. The switch sends a DNS request to the DNS server, specifying the TFTP server name, to obtain the TFTP server address. Then the switch sends a unicast message to the TFTP server to retrieve the named configuration file from the base directory of the server, and upon receipt, completes its boot-up process.

Only the configuration filename is reserved for the switch. The IP address is dynamically allocated to the switch by the DHCP server (one-file read method).

The switch follows the same configuration process described above.

Only the IP address is reserved for the switch and provided in the DHCP reply. The configuration filename is not provided (two-file read method).

The switch receives its IP address and subnet mask from the DHCP server. It also receives a DNS server IP address and a TFTP server name. The switch sends a DNS request to the DNS server, specifying the TFTP server name, to obtain the TFTP server address.

The switch sends a unicast message to the TFTP server to retrieve the network-confg or cisconet.cfg default configuration file. (If the network-confg file cannot be read, the switch reads the cisconet.cfg file.)

The default configuration file contains the host names-to-IP-address mapping for the switch. The switch fills its host table with the information in the file and obtains its host name. If the host name is not found in the file, the switch uses the host name in the DHCP reply. If the host name is not specified in the DHCP reply, the switch uses the default "Switch" as its host name.

After obtaining its host name from the default configuration file or the DHCP reply, the switch reads the configuration file that has the same name as its host name (hostname-confg or hostname.cfg, depending on whether network-confg or cisconet.cfg was read earlier) from the TFTP server. If the cisconet.cfg file is read, the filename of the host is truncated to eight characters.

If the switch cannot read the network-confg, cisconet.cfg, or the host-name file, it reads the router-confg file. If the switch cannot read the router-confg file, it reads the ciscortr.cfg file.


Note The switch broadcasts TFTP server requests if the TFTP server name is not obtained from the DHCP replies, if all attempts to read the configuration file through unicast transmissions fail, or if the TFTP server name cannot be resolved to an IP address.


Example Configuration

Figure 5 shows a sample network for retrieving IP information using DHCP-based autoconfiguration.

Figure 5 DHCP-Based Autoconfiguration Network Example

Table 9 shows the configuration of the reserved leases on the DHCP server.

Table 9 DHCP Server Configuration 

 
Switch-1
Switch-2
Switch-3
Switch-4

Binding key (hardware address)

00e0.9f1e.2001

00e0.9f1e.2002

00e0.9f1e.2003

00e0.9f1e.2004

IP address

10.0.0.21

10.0.0.22

10.0.0.23

10.0.0.24

Subnet mask

255.255.255.0

255.255.255.0

255.255.255.0

255.255.255.0

Router address

10.0.0.10

10.0.0.10

10.0.0.10

10.0.0.10

DNS server address

10.0.0.2

10.0.0.2

10.0.0.2

10.0.0.2

TFTP server name

maritsu or 10.0.0.3

maritsu or 10.0.0.3

maritsu or 10.0.0.3

maritsu or 10.0.0.3

Boot filename (configuration file) (optional)

switch1-confg

switch2-confg

switch3-confg

switch4-confg

Host name (optional)

switch1

switch2

switch3

switch4


DNS Server Configuration

The DNS server maps the TFTP server name maritsu to IP address 10.0.0.3.

TFTP Server Configuration (on UNIX)

The TFTP server base directory is set to /tftpserver/work/. This directory contains the network-confg file used in the two-file read method. This file contains the host name to be assigned to the switch based on its IP address. The base directory also contains a configuration file for each switch (switch1-confg, switch2-confg, and so forth) as shown in the following display:

prompt> cd /tftpserver/work/
prompt> ls
network-confg
switch1-confg
switch2-confg
switch3-confg
switch4-confg
prompt> cat network-confg
ip host switch1 10.0.0.21
ip host switch2 10.0.0.22
ip host switch3 10.0.0.23
ip host switch4 10.0.0.24

DHCP Client Configuration

No configuration file is present on Switch 1 through Switch 4.

Configuration Explanation

In Figure 5, Switch 1 reads its configuration file as follows:

It obtains its IP address 10.0.0.21 from the DHCP server.

If no configuration filename is given in the DHCP server reply, Switch 1 reads the network-confg file from the base directory of the TFTP server.

It adds the contents of the network-confg file to its host table.

It reads its host table by indexing its IP address 10.0.0.21 to its host name (switch1).

It reads the configuration file that corresponds to its host name; for example, it reads switch1-confg from the TFTP server.

Switches 2 through 4 retrieve their configuration files and IP addresses in the same way.

New and Changed Commands

This section describes the new and changed commands for this release and includes the following sections:

"show interface" section

"show spanning-tree" section

"spanning-tree stack-port" section

show interface

Use the show interface privileged EXEC command to display the administrative and operational status of a switching (nonrouting) port.

show interface [interface-id | vlan number] [flow-control | pruning | status | switchport [allowed-vlan | prune-elig | native-vlan]]

Syntax Description

interface-id

ID of the module and port number.

vlan number

VLAN number of the management VLAN. Valid IDs are from 1 to 1000.
Do not enter leading zeroes.

flow-control

Display flow-control information for the specified port.

pruning

(Optional) Display pruning information for the trunk port.

status

(Optional) Display the status of the interface.

switchport

(Optional) Display the administrative and operational status of a switching (nonrouting) port.

allowed-vlan—Display the VLAN IDs that receive and transmit all types of traffic on the trunk port. By default, all VLAN IDs are included.

prune-elig—Display the VLAN ID whose flooded traffic can be pruned. By default, all VLANs, except VLAN 1 and 1002 through 1005, are pruning-eligible on the trunk.

native-vlan—Display the native VLAN ID for untagged traffic when the port is in 802.1Q trunking mode.


Command Modes

Privileged EXEC

Command History

Release
Modification

11.2(8)SA4

This command was first introduced.

11.2(8)SA5

The native-vlan keyword was added.

12.0(5)XP

The vlan number keyword was added.

12.0(5)XU

The pruning keyword was added.

12.0(5)XW

The status keyword was added.


Examples

The following is sample output from the show interface gi0/1 flow-control command.

Switch# show interface gi0/1 flow-control
Any,Input only 

The display shows two values separated by a comma. The first value is the value you configured by using the flowcontrol interface configuration command or through the Cluster Management Suite (or the default value if you did not configure it). The first value displayed can be one of the following settings:

None—Flow control is not enabled.

Asymmetric—Only the transmit flow control is enabled.

Symmetric—Both the transmit and receive flow control are enabled.

Any—Any type of flow control is supported.

The second value in the display represents the flow control value that is autonegotiated with the link partner and can be one of the following settings:

None—Flow control with the link partner does not occur.

Output only—The interface can only transmit pause frames but not receive any.

Input only—The interface can only receive pause frames but not transmit any.

Output and Input—The interface can transmit and receive pause frames.


Note If you execute the show interface interface-id flow-control command on a GigaStack Gigabit Interface Converter (GBIC), the first value in the display is the setting for both GigaStack GBIC ports, and the second value is the autonegotiated setting for both ports.


The following is sample output from the show interface fa0/2 switchport command. Table 10 describes each field in the display.

Switch# show interface fa0/2 switchport
Name: fa0/2
Switchport: Enabled
Administrative Mode: Trunk
Operational Mode: Trunk
Administrative Trunking Encapsulation: ISL
Operational Trunking Encapsulation: ISL
Negotiation of Trunking: Disabled
Access Mode VLAN: 0 (inactive)
Trunking Native Mode VLAN: 1 (default)
Trunking VLANs Enabled: 1-30, 50, 100-1005
Trunking VLANs Active: 1-4
Pruning VLANs Enabled: 2-1001

Priority for untagged frames: 0
Voice VLAN: none
Appliance trust: none

Table 10 Show Interface fa0/2 Switchport Field Descriptions 

Field
Description

Name

Displays the port name.

Switchport

Displays the administrative and operational status of the port. In this display, the port is in switchport mode.

Administrative Mode

Operational Mode

Displays the administrative and operational mode.

Administrative Trunking Encapsulation

Operation Trunking Encapsulation

Negotiation of Trunking

Displays the administrative and operational encapsulation method. Also displays whether trunking negotiation is enabled.

Access Mode VLAN

Displays the VLAN ID to which the port is configured.

Trunking Native Mode VLAN

Trunking VLANs Enabled

Trunking VLANs Active

Lists the VLAN ID of the trunk that is in native mode. Lists the allowed VLANs on the trunk. Lists the active VLANs on the trunk.

Pruning VLANs Enabled

Lists the VLANs that are pruning eligible.

Priority for untagged frames

Displays the port priority on incoming untagged frames.

Voice VLAN

Displays the voice VLAN.

Appliance trust

Displays how the appliance (telephone) connected to the specified port handles priority traffic received on its incoming port.


The following is sample output from the show interface fa0/9 pruning command when pruning is enabled in the VTP domain:

Switch# show interface fa0/9 pruning 
Port    Vlans pruned for lack of request by neighbor
Fa0/9   3,4

Port    Vlans traffic requested of neighbor
Fa0/9   1-3

The following is sample output from the show interface status command:

Switch# show interface status
Port    Name               Status       Vlan     Duplex Speed   Type
------- ------------------ ------------ -------- ------ ------- ----
Fa0/1                      connected    trunk    A-Full   A-100 100BaseTX/FX
Fa0/2                      notconnect   1          Auto    Auto 100BaseTX/FX
Fa0/3                      notconnect   1          Auto    Auto 100BaseTX/FX
Fa0/4                      notconnect   1          Auto    Auto 100BaseTX/FX
Fa0/5                      notconnect   1          Auto    Auto 100BaseTX/FX
Fa0/6                      notconnect   1          Auto    Auto 100BaseTX/FX
Fa0/7                      notconnect   1          Auto    Auto 100BaseTX/FX
Fa0/8                      notconnect   1          Auto    Auto 100BaseTX/FX
Fa0/9                      notconnect   1          Auto    Auto 100BaseTX/FX 
<output truncated>

Related Commands

Command
Description

switchport access

Configures a port as a static-access or dynamic-access port.

switchport mode

Configures the VLAN membership mode of a port.

switchport multi

Configures a list of VLANs to which the port is associated.

switchport priority default

Provides a default port priority for the incoming untagged frames.

switchport trunk pruning

Configures the VLAN pruning-eligible list for ports in trunking mode.

switchport voice vlan

Configures the voice VLAN on the port.


show spanning-tree

Use the show spanning-tree privileged EXEC command to display spanning-tree information for the specified spanning-tree instances.

show spanning-tree [brief] | [summary] | [vlan stp-list] | [interface interface-list]

Syntax Description

brief

Display a brief status of the spanning tree.

summary

Display a summary of the spanning-tree states.

interface interface-list

List of ports for which spanning-tree information is displayed. Enter each port separated by a space. Ranges are not supported.

vlan stp-list

(Optional) List of spanning-tree instances. Each spanning-tree instance is associated with a VLAN ID. Enter each VLAN ID separated by a space. Valid IDs are from 1 to 1005; do not enter leading zeroes.
Ranges are not supported.


Command Modes

Privileged EXEC

Command History

Release
Modification

11.2(8)SA3

This command was first introduced.

12.0(5)XW

The brief and summary keywords were added.


Usage Guidelines

If the variable stp-list is omitted, the command applies to the Spanning Tree Protocol (STP) instance associated with VLAN 1.

Examples

The following is sample output from the show spanning-tree command for VLAN 1:

Switch# show spanning-tree vlan 1

Spanning tree 1 is executing the IEEE compatible Spanning Tree protocol
  Bridge Identifier has priority 49152, address 00b0.6476.08c0
  Configured hello time 2, max age 20, forward delay 15
  Current root has priority 32768, address 0001.42cd.a200
  Root port is 31, cost of root path is 42
  Topology change flag not set, detected flag not set, changes 1
  Times:  hold 1, topology change 35, notification 2
          hello 2, max age 20, forward delay 15
  Timers: hello 0, topology change 0, notification 0
  Fast uplink switchover is enabled
  Stack port is GigabitEthernet0/1

Interface Fa0/1 (port 13) in Spanning tree 1 is down
   Port path cost 3100, Port priority 128
   Designated root has priority 32768, address 0001.42cd.a200
   Designated bridge has priority 49152, address 00b0.6476.08c0
   Designated port is 13, path cost 42
   Timers: message age 0, forward delay 0, hold 0
   BPDU: sent 0, received 0
<output truncated>

The following is sample output from the show spanning-tree interface command for port 3:

Switch# show spanning-tree interface fa0/3

Interface Fa0/3 (port 3) in Spanning tree 1 is down
   Port path cost 100, Port priority 128
   Designated root has priority 6000, address 0090.2bba.7a40
   Designated bridge has priority 32768, address 00e0.1e9f.4abf
   Designated port is 3, path cost 410
   Timers: message age 0, forward delay 0, hold 0
   BPDU: sent 0, received 0 

The following is sample output from the show spanning-tree summary command:

Switch# show spanning-tree summary
UplinkFast is enabled
Stack port is GigabitEthernet0/1 

Name                 Blocking Listening Learning Forwarding STP Active
-------------------- -------- --------- -------- ---------- ----------
VLAN1                13       0         0        1          14
VLAN2                1        0         0        1          2
VLAN3                1        0         0        1          2
<output truncated>

Related Commands

Command
Description

spanning-tree

Enables STP on a VLAN.

spanning-tree forward-time

Sets the forwarding time for the specified spanning-tree instances.

spanning-tree max-age

Changes the interval between messages the spanning tree receives from the root switch.

spanning-tree port-priority

Configures a port priority, which is used when two switches tie for position as the root switch.

spanning-tree protocol

Specifies the STP to be used for specified spanning-tree instances.


spanning-tree stack-port

Use the spanning-tree stack-port interface configuration command to enable cross-stack UplinkFast (CSUF) on an interface and to accelerate the choice of a new root port when a link or switch fails or when Spanning Tree Protocol (STP) reconfigures itself. Use the no form of this command to return to the default setting.

spanning-tree stack-port

no spanning-tree stack-port

Syntax Description

This command has no arguments or keywords.

Defaults

CSUF is disabled on all interfaces.

Command Modes

Interface configuration

Command History

Release
Modification

12.0(5)XW

This command was first introduced.


Usage Guidelines

This command is effective only if you enable the UplinkFast feature by using the spanning-tree uplinkfast global configuration command.

Use this command only on access switches.

You can enable CSUF only on one stack-port GBIC interface. The stack port connects to the GigaStack GBIC multidrop backbone. If you try to enable CSUF on a Fast Ethernet or a copper-based Gigabit Ethernet port, you receive an error message.

If CSUF is already enabled on an interface and you try to enable it on another interface, you receive an error message. You must disable CSUF on the first interface before enabling it on a new interface.

Examples

The following command shows how to enable CSUF on the GBIC interface gi0/1:

Switch(config)# interface gi0/1
Switch(config-if)# spanning-tree stack-port 

You can verify the previous command by entering the show spanning-tree command in privileged EXEC mode.

Related Commands

Command
Description

show spanning-tree

Displays spanning-tree information for the specified spanning-tree instances.


Syslog Error Messages

The following messages can appear in the command-line interface (CLI).

 LINK_FLAP, RTD, LOG_ALERT, 0, "%s link down/up %d times per min 

Explanation    An excessive number of link down-up events has occurred on this interface. This might be the result of reconfiguring the port, or it might indicate a faulty device at the other end of the connection.

Action If someone is reconfiguring the interface or device at the other side of the interface, ignore this message. However, if no one is manipulating the interface or the other device, it is likely that the Ethernet transceiver at one end of the link is faulty, and you should replace it.

 ADDR_FLAP, RTD, LOG_ALERT, 0, "%s relearning %d addrs per min 

Explanation    Normally, MAC addresses are learned once on a port. Occasionally, when a switched network reconfigures, due to either manual or STP reconfiguration, addresses learned on one port are relearned on a different port. However, if there is a port anywhere in the switched domain that is looped back to itself, addresses jump back and forth between the real port and the port that is in the path to the looped back port.

Action Determine the real path (port) to the MAC address. Use the debug ethernet-controller addr privileged EXEC command to see the alternate path-port on which the address is being learned. Go to the switch attached to that port. Note that the show cdp neighbors privileged EXEC command is useful in determining the next switch. Repeat this procedure until you find the port that is receiving what it is transmitting, and remove that port from the network.

 MAC_TBL_SIZE, MODULES, LOG_ERR, 0, 

Explanation    Dynamic module insertion supports less MAC addresses.

Action Reboot system to use the module.

 SECURITYREJECT, PORT_SECURITY, LOG_CRIT, 0, 

Explanation    A packet with unexpected source address is received on a secure port.

Action Remove the station with the unexpected MAC address from the secure port, or add the MAC address to the secure address table of the secure port.

 SHUTDOWN, STORM_CONTROL, LOG_CRIT, 0, 

Explanation    Excessive traffic has been detected on a port that has been configured to be shut down if a storm event is detected.

Action When the source of the packet storm has been fixed, re-enable the port by using port-configuration commands.

 BLADE_EXTRACT, CHASSIS, LOG_NOTICE, 0,

Explanation    The hot-swap switch has been depressed.

Action Extract the module.

 LOOP_DETECTED, GIGASTACK, LOG_INFO, 0, Gigastack GBIC in %s is selected as Master 
Loop Breaker.

Explanation    Loop has been detected in the Gigastack, and this Gigastack (Gigabit Interface Converter) GBIC is selected as the Master Loop Breaker. Link 2 of this Gigastack GBIC is disabled to break the loop.

Action No action is required.

 LOOP_BROKEN, GIGASTACK, LOG_INFO, 0, Link loss is detected in the Gigastack loop 

Explanation    Loop formed by Gigastack modules is broken because of link loss. Link 2 of the Master Loop Breaker is re-enabled to replace the broken line.

Action No action is required.

 NO_LOOP_DETECT, GIGASTACK, LOG_ALERT, 0, The link neighbor of link %d of Gigastack  

Explanation    No acknowledgement for Gigastack loop detection request is received from one of the links on a Gigastack GBIC. Either the neighboring switch does not support the Gigastack Loop breaking algorithm, or the link between the two Gigastack GBICs is broken. Under this condition, a Gigastack loop topology is not automatically detected, and the connectivity between switches in the stack could be lost.

Action If loop topology is used in the Gigastack, make sure the latest software is running on all switches in the stack. Check the Gigastack GBICs involved to make sure they are functioning.

 ADD, CMP, LOG_NOTICE, 0, The Device is added to the cluster (Cluster Name:%s, CMDR 
IP Address %i) 

Explanation    The device is added to the cluster.

Action No action is required.

 REMOVE, CMP, LOG_NOTICE, 0, The Device is removed from the cluster (Cluster 
Name:%s) 

Explanation    The device is removed from the cluster.

Action No action is required.

 MEMBER_CONFIG_UPDATE, CMP, LOG_NOTICE, 0, Received member configuration from 
member %d 

Explanation    Received member configuration.

Action No action is required.

 FAN_FAULT, ENVIRONMENT, LOG_CRIT, 0,

Explanation    An internal fan fault is detected. This message is available only on the Catalyst 3524-PWR XL switch.

Action Either check the switch itself, or use the show env privileged EXEC command to check if a fan on the switch has failed. The Catalyst 3524-PWR XL switch can operate normally with one failed fan. Replace the switch at your convenience.

 OVER_TEMP, ENVIRONMENT, LOG_CRIT, 0,

Explanation    An overtemperature condition is detected. This message is available only on the Catalyst 3524-PWR XL switch.

Action Use the show env command to check if an overtemperature condition exists. If it does:

Place the switch in an environment that is within 32 to 113°F (0 to 45°C).

Make sure fan intake and exhaust areas are clear.

If a multiple-fan failure is causing the switch to overheat, replace the switch.

 LINK-4, LOG_WARNING, 0,%s is experiencing errors.

Explanation    Excessive errors have occurred on this interface.

Action Check for duplex mismatches between both ends of the link.


Note The previous error is a LINK-4-ERROR message, which is logged at the Warning level. LINK-3-ERROR messages are more severe and are logged at the Error level.


Related Documentation

The product documentation for the 3500 and 2900 XL switches and modules is as follows:

Quick Start Guide: Catalyst 2900 Series XL Switches

Quick Start Guide: Catalyst 3500 Series XL Switches

Catalyst 2900 Series XL Installation Guide

Catalyst 3500 Series XL Hardware Installation Guide

Cisco IOS Desktop Switching Software Configuration Guide for Cisco IOS Software Release 12.0(5)XU

Cisco IOS Desktop Command Reference (online only)

Using the Catalyst 2924M XL DC Ethernet Switch

Catalyst 2900 Series XL Modules Installation Guide

Catalyst 2900 Series XL Gigabit Ethernet Module Installation Guide

Catalyst 2900 Series XL ATM Modules Installation and Configuration Guide

Release Notes for the Catalyst 2900 Series XL ATM Modules

Catalyst GigaStack Gigabit Interface Converter Hardware Installation Guide

Release Notes for Catalyst GigaStack Gigabit Interface Converter.

Obtaining Documentation

The following sections provide sources for obtaining documentation from Cisco Systems.

World Wide Web

You can access the most current Cisco documentation on the World Wide Web at the following sites:

http://www.cisco.com

http://www-china.cisco.com

http://www-europe.cisco.com

Documentation CD-ROM

Cisco documentation and additional literature are available in a CD-ROM package, which ships with your product. The Documentation CD-ROM is updated monthly and may be more current than printed documentation. The CD-ROM package is available as a single unit or as an annual subscription.

Ordering Documentation

Cisco documentation is available in the following ways:

Registered Cisco Direct Customers can order Cisco Product documentation from the Networking Products MarketPlace:

http://www.cisco.com/public/ordsum.html

Registered Cisco.com users can order the Documentation CD-ROM through the online Subscription Store:

http://www.cisco.com/go/subscription

Nonregistered CCO users can order documentation through a local account representative by calling Cisco corporate headquarters (California, USA) at 408 526-7208 or, in North America, by calling 800 553-NETS(6387).

Documentation Feedback

If you are reading Cisco product documentation on the World Wide Web, you can submit technical comments electronically. Click Feedback in the toolbar and select Documentation. After you complete the form, click Submit to send it to Cisco.

You can e-mail your comments to bug-doc@cisco.com.

To submit your comments by mail, for your convenience many documents contain a response card behind the front cover. Otherwise, you can mail your comments to the following address:

Cisco Systems, Inc.
Document Resource Connection
170 West Tasman Drive
San Jose, CA 95134-9883

We appreciate your comments.

Obtaining Technical Assistance

Cisco provides Cisco.com as a starting point for all technical assistance. Customers and partners can obtain documentation, troubleshooting tips, and sample configurations from online tools. For Cisco.com registered users, additional troubleshooting tools are available from the TAC website.

Cisco.com

Cisco.com is the foundation of a suite of interactive, networked services that provides immediate, open access to Cisco information and resources at anytime, from anywhere in the world. This highly integrated Internet application is a powerful, easy-to-use tool for doing business with Cisco.

Cisco.com provides a broad range of features and services to help customers and partners streamline business processes and improve productivity. Through Cisco.com, you can find information about Cisco and our networking solutions, services, and programs. In addition, you can resolve technical issues with online technical support, download and test software packages, and order Cisco learning materials and merchandise. Valuable online skill assessment, training, and certification programs are also available.

Customers and partners can self-register on Cisco.com to obtain additional personalized information and services. Registered users can order products, check on the status of an order, access technical support, and view benefits specific to their relationships with Cisco.

To access Cisco.com, go to the following website:

http://www.cisco.com

Technical Assistance Center

The Cisco TAC website is available to all customers who need technical assistance with a Cisco product or technology that is under warranty or covered by a maintenance contract.

Contacting TAC by Using the Cisco TAC Website

If you have a priority level 3 (P3) or priority level 4 (P4) problem, contact TAC by going to the TAC website:

http://www.cisco.com/tac

P3 and P4 level problems are defined as follows:

P3—Your network performance is degraded. Network functionality is noticeably impaired, but most business operations continue.

P4—You need information or assistance on Cisco product capabilities, product installation, or basic product configuration.

In each of the above cases, use the Cisco TAC website to quickly find answers to your questions.

To register for Cisco.com, go to the following website:

http://www.cisco.com/register/

If you cannot resolve your technical issue by using the TAC online resources, Cisco.com registered users can open a case online by using the TAC Case Open tool at the following website:

http://www.cisco.com/tac/caseopen

Contacting TAC by Telephone

If you have a priority level 1(P1) or priority level 2 (P2) problem, contact TAC by telephone and immediately open a case. To obtain a directory of toll-free numbers for your country, go to the following website:

http://www.cisco.com/warp/public/687/Directory/DirTAC.shtml

P1 and P2 level problems are defined as follows:

P1—Your production network is down, causing a critical impact to business operations if service is not restored quickly. No workaround is available.

P2—Your production network is severely degraded, affecting significant aspects of your business operations. No workaround is available.