Editing Switch Control (section)

= Upgrading Software in Catalyst 2900XL and 3500XL Switches = 
== Via Command Line Interface ==

http://www.cisco.com/en/US/products/hw/switches/ps607/products_tech_note09186a00800946e5.shtml

<pre>switch-p23#dir flash:
Directory of flash:/

  2  -rwx     1645824   Jan 01 1970 00:40:12  c2900XL-c3h2s-mz-120.5.2-XU.bin
  3  -rwx        1877   May 06 1997 23:54:44  config.text
  4  -rwx         780   Mar 01 1993 00:17:49  vlan.dat

3612672 bytes total (1962496 bytes free)

switch-p23#delete flash:c2900XL-c3h2s-mz-120.5.2-XU.bin
Delete filename [c2900XL-c3h2s-mz-120.5.2-XU.bin]?
Delete flash:c2900XL-c3h2s-mz-120.5.2-XU.bin? [confirm]
switch-p23#tar /x tftp://10.1.2.1/c2900xl-c3h2s-tar.120-5.WC17.tar flash:
Loading c2900xl-c3h2s-tar.120-5.WC17.tar from 10.1.2.1 (via VLAN300): !
extracting c2900xl-c3h2s-mz.120-5.WC17.bin (1929757 bytes)!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
switch-p23#dir flash:
Directory of flash:/

  2  -rwx     1929757   Mar 01 1993 05:19:09  c2900xl-c3h2s-mz.120-5.WC17.bin
  3  -rwx        1877   May 06 1997 23:54:44  config.text
  4  -rwx         780   Mar 01 1993 00:17:49  vlan.dat
  5  -rwx        8192   Mar 01 1993 05:19:10  e2rb.bin
  6  drwx         704   Mar 01 1993 05:20:02  html
 18  -rwx         135   Mar 01 1993 05:20:04  info
 19  -rwx         135   Mar 01 1993 05:20:04  info.ver
 20  drwx         320   Mar 01 1993 05:20:06  lre-bin

3612672 bytes total (499712 bytes free)
spare#verify flash:c2900xl-c3h2s-mz.120-5.WC17.bin
switch-p23#conf t
switch-p23(config)#boot system flash:c2900xl-c3h2s-mz.120-5.WC17.bin 
switch-p23(config)#end
switch-p23#reload

System configuration has been modified. Save? [yes/no]: y
Building configuration...

Proceed with reload? [confirm]</pre>

== Via Common TFTP Procedure ==

This section lists the steps for the TFTP upgrade procedure on the XL switches.
Note: All these commands are run from the privileged EXEC mode.

 switch>enable
 switch#

If you upgrade a 2900XL switch, issue the show version command in order to confirm the amount of memory present on the switch.
See the [http://www.cisco.com/en/US/products/hw/switches/ps607/products_tech_note09186a00800946e5.shtml#amtmem How to Determine the Amount of Memory on the Switch Using Command Line Interface] section of this document for the details on how to verify the amount of memory present on the 2900XL switch.

Display the name of the running image file.
<pre>switch#show boot
BOOT path-list:      flash:c2900XL-c3h2-mz-112.8.5-SA6.bin
Config file:         flash:config.text
Enable Break:        no
Manual Boot:         no
HELPER path-list:    
NVRAM/Config file
buffer size:   32768</pre>

!--- In this case, an upgrade from the Cisco IOS Software 
!--- Release 11.2(8)SA6 image to a newer release takes place.

If there is no file defined in the BOOT path-list, enter the dir flash: command in order to display the contents of Flash memory.
The file with the .bin extension is your image file.
<pre>switch#dir flash:
Directory of flash:

  2  -rwx     1162890   Mar 01 1993 00:33:22  c2900XL-c3h2-mz-112.8.5-
 SA6.bin
 17  -r--         108   Mar 01 1993 00:32:28  info
  4  dr--       13888   Mar 01 1993 00:35:23  html
226  -r--         341   Jan 01 1970 00:03:16  env_vars
227  -rwx        1203   Mar 01 1993 00:24:07  config.text
  6  -r--        8192   Mar 08 1993 00:00:23  e2rb.bin
 18  -r--         108   Mar 01 1993 00:35:24  info.ver

3612672 bytes total (1729024 bytes free)</pre>

!--- The switch only has 1.7 MB Flash available. Since this is not enough  
!--- to load a new image, delete files in Flash in order to
!--- first free up some space.

If the size of the file to be loaded is larger than the available capacity, delete the image that exists in Flash in order to make space for a new image:
Issue the delete flash: filename command.
<pre>Switch#delete flash:current_image.bin
Delete filename [current_image.bin]?
Delete flash:current_image.bin? [confirm]</pre>
Choose Enter in order to confirm the deletion of the file.
Note: Once the image in Flash is deleted, do not reboot the switch for any reason until the new image is loaded. If you attempt to reload the switch now, it fails to boot up since there is no image in Flash.

If you upgrade a [http://www.cisco.com/en/US/products/hw/switches/ps607/products_tech_note09186a00800946e5.shtml#xlmodels 4 MB DRAM Catalyst 2900XL Switch] and a file that starts with the character string c2900XL-diag-mz appears in the Flash directory, you should remove it in order to make room for the new image.
This is a diagnostics file used at the factory in order to run certain tests on the switch and is never used by the customer. If you upgrade an [http://www.cisco.com/en/US/products/hw/switches/ps607/products_tech_note09186a00800946e5.shtml#xlmodels 8 MB DRAM Catalyst 2900XL Switch] or [http://www.cisco.com/en/US/products/hw/switches/ps607/products_tech_note09186a00800946e5.shtml#xlmodels Catalyst 3500XL Switch] you do not have to delete this file since you have sufficient Flash memory for the new image, but since this file is useless for you, it is advisable to delete it during the upgrade. The diagnostics file has a name in the format: c2900XL-diag-mz-version_name or c3500XL-diag-mz-version_name. The string version_name depends on the switch and software you run.
Note: Sometimes this file, might or might not be displayed when you issue the dir flash: command. In this case, issue the dir flash:c2900XL-diag-mz* command.
For Example:
On the 2900XL switch, issue this command in order to display the diagnostics filename:
<pre>switch# dir flash:c2900XL-diag-mz*
Directory of flash:

-rwx 80971 Sep 14 1998 03:10:38 c2900XL-diag-mz-112.0.0.11-SA2</pre> 
And delete it:
<pre>Switch#delete flash:c2900XL-diag-mz-112.0.0.11-SA2

Delete filename [c2900XL-diag-mz-112.0.0.11-SA2]?
Delete flash:c2900XL-diag-mz-112.0.0.11-SA2? [confirm]
Switch#</pre>

Enter global configuration mode:
<pre>switch#config terminal
Enter configuration commands, one per line. End with CNTL/Z.
switch(config)#</pre>

Disable access to the switch HTML pages:
<pre>switch(config)#no ip http server
Return to privileged EXEC mode:
switch(config)#end
Remove the HTML files, if any:
switch#delete flash:html/*</pre>

Choose Enter or y in order to confirm the deletion of each file.
Note: You might or might not have an HTML directory in Flash. The HTML directory is only installed during an upgrade that uses a .tar file.
Since HTML is a directory that contains all the HTML and GIF files used for the web interface, you have to choose Enter or y many times before all the files in the HTML directory are deleted.
Note: Do not press any other keys during this process. If you press any other key, it aborts the deletion of that particular file and go to the next file. You have to issue the delete flash:html/* command again in order to delete the aborted file.

If you upgrade from Cisco IOS Software 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.
Choose Enter or y in order to confirm the deletion of each file.
Note: Do not press any other keys during this process. If you press any other key, it aborts the deletion of that particular file and goes to the next file. You have to run the delete flash:html/* command again in order to delete the aborted file.

If you run Cisco IOS Software Release 11.2(8)SA2 or earlier releases on a [http://www.cisco.com/en/US/products/hw/switches/ps607/products_tech_note09186a00800946e5.shtml#xlmodels 4 MB DRAM Catalyst 2900XL switch], create a directory on the switch Flash memory to be used for the HTML files:
Note: This step is only for [http://www.cisco.com/en/US/products/hw/switches/ps607/products_tech_note09186a00800946e5.shtml#xlmodels 4 MB DRAM Catalyst 2900XL] switches that run Cisco IOS Software Release 11.2(8)SA2 or earlier.
 switch#mkdir flash:html/Snmp

Make sure the S in Snmp is uppercase.
Use the tar command in order to copy the combined .tar file to the switch.
Note: DO NOT copy the .tar file with the words html in the filename, available in Cisco IOS Software Release 11.2, that uses this procedure as the .tar file includes both the image and the HTML files into a single compressed file.
This command copies and automatically extracts the image .bin file as well as the necessary HTML files.
Note: If the switch is unable to connect to the TFTP server, verify that you have IP connectivity to the server and check in order to make sure that the TFTP server software is setup correctly.

<pre>switch#tar /x tftp://10.1.1.1/c2900xl-c3h2s-tar.120-5.WC8.tar flash:
Loading c2900xl-c3h2s-tar.120-5.WC8.tar from 10.1.1.1 (via VLAN1): !
extracting c2900xl-c3h2s-mz.120-5.WC8.bin (1803565 
bytes)!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
extracting e2rb.bin (8192 bytes)!!
html/ (directory)
extracting html/homepage.htm (3988 bytes)!
extracting html/not_supported.html (1392 bytes)
. . .

!--- Output suppressed.

[OK - 2723840 bytes]

!--- The OK message means that the TFTP process passed successfully  
!--- and both .bin and html files were extracted successfully.</pre>

Note: Dependent on the TFTP Server used, you might need to enter only one slash (/) after the server_ip_address in the tar command.
Note: Since Cisco IOS Software Release 12.0(5)WC5, the file with .tar extension also has tar in the filename itself. For example, c2900xl-c3h2s-tar.120-5.WC5.tar.
Enter the dir flash: command in order to determine the filename of the new image in Flash.
<pre>switch#dir flash:
Directory of flash:

  2  -rwx     1803565   Mar 01 1993 00:49:55  c2900xl-c3h2s-mz.120-5.WC8.bin
 17  -r--         108   Mar 01 1993 00:50:55  info
  4  dr--         832   Mar 01 1993 00:50:53  html
226  -r--         341   Jan 01 1970 00:03:16  env_vars
227  -rwx        1203   Mar 01 1993 00:24:07  config.text
  6  -r--        8192   Mar 01 1993 00:49:56  e2rb.bin
 18  -r--         108   Mar 01 1993 00:50:55  info.ver
	
3612672 bytes total (683520 bytes free)</pre>
Make note of the filename, it is used in the next few steps.

Enter global configuration mode:
<pre>switch#configure terminal
Enter configuration commands, one per line. End with CNTL/Z.</pre>
Set the boot parameters so that when the switch is reloaded after the upgrade, it boots with the new_image.
Issue this command in order to set the boot parameter to the new image. This command overwrites any previous boot image settings.
<pre>switch(config)#boot system flash:
c2900xl-c3h2s-mz.120-5.WC8.bin</pre>

Reenable access to the switch HTTP pages:
 switch(config)#ip http server
Return to privileged EXEC mode:
 switch(config)#end
Reload the new software with this command:
<pre>switch#reload
System configuration has been modified. Save? [yes/no]:y
Proceed with reload? [confirm]</pre>
Choose Return in order to confirm the reload.
After the switch reboots, use Telnet or Console login in order to access the switch and enter the privileged EXEC mode show version command in order to verify the upgrade procedure.

== Upgrading Software for the 2950/2955 with the CMS image (.tar file) ==
In this example, the software on a 2950 is upgraded from version 12.1(12c)EA1 to version 121-13.EA1 with the CMS image (.tar file). The procedure is the same for a 2955.
Issue the show version command to view the current version of software that you run. Here is a sample command output:
<pre>2950#sh ver
Cisco Internetwork Operating System Software
IOS (tm) C2950 Software (C2950-I6Q4L2-M), Version 12.1(12c)EA1,
RELEASE SOFTWARE (fc1)

!--- The current software version is 12.1(12c)EA1.</pre>

Go to the LAN Switching Software section of the [http://tools.cisco.com/support/downloads/go/Redirect.x?mdfid=268438038 Downloads] ( registered customers only) page.
Select Catalyst 2950 software and locate the image you want to download. Note the size of the image in bytes. This example uses the c2950-i6q4l2-mz.121-13.EA1.tar file. The image size is 4877312 bytes, or approximately 5 MB. Download the image you want.

Issue the dir flash: command on the 2950/2955 to verify how much free memory you have for the upgrade. Here is a sample command output:
<pre>2950#dir flash:
Directory of flash:/
  2  -rwx   2774747  Mar 01 1993 17:52:14  c2950-i6q4l2-mz.121-12c.EA1.bin
 21  -rwx   2665985  Mar 01 1993 18:02:04  c2950-i6q4l2-mz.121-11.EA1a.bin
   
!--- Two images are installed.
	
 4  -rwx       916   Mar 01 1993 03:31:05  vlan.dat
 22  -rwx      312   Mar 01 1993 18:03:19  env_vars
 7  drwx       832   Mar 01 1993 17:53:20  html
	    
!--- output suppressed ---
	
	 
!--- Notice the d in the permissions, which indicates that html is a
!--- directory that contains the CMS files extracted from the .tar image 
!--- during the upgrade.

7741440 bytes total (578048 bytes free)

!--- There is less than 1 MB of free memory in Flash, which is not enough
!--- for the upgrade. Delete one of the old IOS images (.bin files).
	
2950#</pre>

Issue the delete command to remove one of the old IOS images in order to make room for the upgrade. Here is a sample command output:
<pre>2950#delete flash:c2950-i6q4l2-mz.121-11.EA1a.bin
Delete filename [c2950-i6q4l2-mz.121-11.EA1a.bin]?
Delete flash:c2950-i6q4l2-mz.121-11.EA1a.bin? [confirm]
2950#
2950#dir flash:
Directory of flash:/
  2  -rwx   2774747  Mar 01 1993 17:52:14  c2950-i6q4l2-mz.121-12c.EA1.bin
    
!--- You can leave one old image as a backup if you prefer.

  4  -rwx       916  Mar 01 1993 03:31:05  vlan.dat
 22  -rwx       312  Mar 01 1993 18:03:19  env_vars
  7  drwx       832  Mar 01 1993 17:53:20  html
    
!--- output suppressed ---

7741440 bytes total (3244544 bytes free)
  
!--- Even though you freed up additional memory there is still not
!--- enough free memory for the upgrade. Delete the files in the
!--- html directory.

2950#</pre>


The html directory is where the CMS files are extracted from the .tar image and installed during the upgrade. Issue the dir html command to view these files. Here is a sample command output:
<pre>2950#dir html
Directory of flash:/html/
    3  -rwx        4010   Mar 01 1993 17:52:14  homepage.htm
    5  -rwx        1392   Mar 01 1993 17:52:14  not_supported.html
    8  -rwx        9448   Mar 01 1993 17:52:15  common.js
    9  -rwx       22152   Mar 01 1993 17:52:15  cms_splash.gif
   10  -rwx        1211   Mar 01 1993 17:52:15  cms_13.html
   11  -rwx        2823   Mar 01 1993 17:52:15  cluster.html
   
!--- output suppressed ---

   
!--- These are the files used by the CMS software.</pre>

Issue the delete flash:html/* command to delete all of these files before the upgrade. Here is a sample command output:
Note: Deletion of these files disables access to the HTML pages during the upgrade. After the upgrade, access becomes available again.
<pre>2950#delete flash:html/*
Delete filename [html/*]?
 
!--- Press ENTER or RETURN for each file.

Delete flash:html/homepage.htm? [confirm] 
Delete flash:html/not_supported.html? [confirm]
Delete flash:html/common.js? [confirm]
Delete flash:html/cms_splash.gif? [confirm]
Delete flash:html/cms_13.html? [confirm]
Delete flash:html/cluster.html? [confirm]

!--- output suppressed ---


2950#dir flash:
Directory of flash:/
    2  -rwx     2774747   Mar 01 1993 17:52:14  c2950-i6q4l2-mz.121-12c.EA1.bin
    4  -rwx         916   Mar 01 1993 03:31:05  vlan.dat
   22  -rwx         312   Mar 01 1993 18:03:19  env_vars
    7  drwx           0   Mar 01 1993 01:13:31  html
    
!--- output suppressed ---

7741440 bytes total (4960256 bytes free)
    
!--- There is now enough room to proceed with the upgrade.</pre>

Issue the archive tar command to copy over the .tar file and extract all the files. The full command syntax is archive tar /xtract tftp://<tftp server ip>/<filename> flash:. Here is a sample command output:
Note: If you want to upgrade from a release earlier than 12.1(6)EA2 on a 2950, issue the tar command instead of the archive tar command.
<pre>2950#archive tar /xtract tftp://20.20.20.2/c2950-i6q4l2-tar.121-13.EA1.tar flash:
Loading c2950-i6q4l2-tar.121-13.EA1.tar from 20.20.20.2 (via Vlan1): !

!--- The IOS image(.bin file) is being extracted into the flash: directory.

extracting c2950-i6q4l2-mz.121-13.EA1.bin (2888547 bytes)!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
html/ (directory)

!--- The CMS files are extracted into the html directory.

extracting html/homepage.htm (3994 bytes)!
extracting html/not_supported.html (1392 bytes)
extracting html/common.js (9529 bytes)!!
extracting html/cms_splash.gif (22152 bytes)!!!!!
extracting html/cms_13.html (1211 bytes)
extracting html/cluster.html (2823 bytes)!
extracting html/Redirect.jar (4195 bytes)!
extracting html/mono_disc.sgz (15899 bytes)!!!
extracting html/CMS.sgz (1344455 bytes)!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
extracting html/images.sgz (86918 bytes)!!!!!!!!!!!!!!!!!
extracting html/help.sgz (287994 bytes)!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!
extracting html/CiscoChartPanel.sgz (135599 bytes)!!!!!!!!!!!!!!!!!!!!!!
extracting html/cms_boot.jar (58864 bytes)!!!!!!!!!!!!
extracting info (109 bytes)
extracting info.ver (109 bytes)
[OK - 4877312 bytes]

!--- The archive tar operation completed successfully.

2950#
2950#verify flash:c2950-i6q4l2-mz.121-13.EA1.bin
Verified flash:c2950-i6q4l2-tar.121-13.EA1.bin

!--- Issue the verify command to verify the IOS image checksum.

2950#

2950#dir flash:
Directory of flash:/
  2  -rwx  2774747  Mar 01 1993 17:52:14  c2950-i6q4l2-mz.121-12c.EA1.bin
  3  -rwx  2888547  Mar 01 1993 02:00:32  c2950-i6q4l2-mz.121-13.EA1.bin
    
!--- The new IOS image has been extracted and installed in flash:.

  4  -rwx      916  Mar 01 1993 03:31:05  vlan.dat
 22  -rwx      312  Mar 01 1993 18:03:19  env_vars
  7  drwx      832  Mar 01 1993 02:03:41  html
    
!--- output suppressed ---

7741440 bytes total (93184 bytes free)
2950#
2950#dir html
Directory of flash:/html/
    5  -rwx        3994   Mar 01 1993 02:00:32  homepage.htm
    6  -rwx        1392   Mar 01 1993 02:00:32  not_supported.html
    8  -rwx        9529   Mar 01 1993 02:00:32  common.js
    9  -rwx       22152   Mar 01 1993 02:00:33  cms_splash.gif
   10  -rwx        1211   Mar 01 1993 02:00:33  cms_13.html
    
!--- output suppressed ---
!--- The new CMS files have been extracted and installed.</pre>

Set a boot system statement so the new image boots on the next reload. Here is a sample command output:
<pre>2950#conf t
2950(config)#boot system flash:c2950-i6q4l2-mz.121-13.EA1.bin
2950(config)#end
2950#
2950#sh boot
BOOT path-list:   flash:c2950-i6q4l2-mz.121-13.EA1.bin

!--- output suppressed ---
!--- The boot system statement does not show up in the config.
!--- Issue the show boot command to verify whether the 
!--- new image boots on the next reload of the switch.</pre>

You can set a boot system statement to boot a specific backup image if the new image fails for some reason. Otherwise, the 2950/2955 automatically attempts to boot the next valid image in the event of a failure.
Here is a sample command output to configure a boot system statement for multiple images:
<pre>2950#conf t
Enter configuration commands, one per line.  End with CNTL/Z.
2950(config)#boot system flash:
   c2950-i6q4l2-mz.121-13.EA1.bin;c2950-i6q4l2-mz.121-12c.EA1.bin

!--- A semi-colon separates the two images - primary and backup.

2950(config)#end
2950#

2950#sh boot
BOOT path-list: flash:
   c2950-i6q4l2-mz.121-13.EA1.bin;c2950-i6q4l2-mz.121-12c.EA1.bin

!--- output suppressed ---
!--- The boot system statement does not show up in the config.
!--- Issue the show boot command to verify whether the new image
!--- boots on the next reload of the switch.</pre>

Issue the wr mem command to save your changes and reload the switch. Here is a sample command output:
<pre>2950#wr mem
Building configuration...
[OK]
2950#reload
Proceed with reload? [confirm]

!--- Press RETURN or ENTER.

02:53:37: Bootstrap Emulator called with code 45
02:53:37: %SYS-5-RELOAD: Reload requested

!--- Press RETURN or ENTER.</pre>

Verify you run the new image with the show version command. Here is a sample command output:
<pre>2950#sh ver
Cisco Internetwork Operating System Software
IOS (tm) C2950 Software (C2950-I6Q4L2-M), Version 12.1(13)EA1,
RELEASE SOFTWARE

!--- You now run the new software.

(fc1)
Copyright (c) 1986-2003 by cisco Systems, Inc.

!--- output suppressed ---

System image file is "flash:c2950-i6q4l2-mz.121-13.EA1.bin"
cisco WS-C2950-24 (RC32300) processor (revision G0)
with 20839K bytes of memory.
Processor board ID FHK0650X0QY
Last reset from system-reset
Running Standard Image

!--- output suppressed ---
!--- You run the SI feature set. If this model of switch
!--- can run the EI, you see Running Enhanced Image.</pre>
This completes the upgrade procedure for a 2950 through the CMS image (.tar file).