Editing Switch Control (section)

== 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.