Troubleshooting the Cisco EtherSwitch Service Module Software

This section describes how to troubleshoot the Cisco EtherSwitch service module:

Recovering from a Corrupted Software Image Using Xmodem

This section describes how to recover from a corrupted software image by using Xmodem.

Note

Note:  The router should have the switch image in the router flash memory or have network connectivity to the TFTP server.

The Cisco EtherSwitch service module software can be corrupted while upgrading the software, by downloading the wrong file to the Cisco EtherSwitch service module, and by deleting the image file. In all of these cases, the service module does not pass the power-on self-test (POST), and there is no connectivity.

This procedure uses the Xmodem Protocol to recover from a corrupt or wrong image file. Many software packages support the Xmodem Protocol, and this procedure is largely dependent on the emulation software you are using.

To start the Xmodem protocol process, issue the password reset command. After you issue the password reset command, this message appears:

Password reset process is complete...
The system has been interrupted prior to initializing the
flash filesystem.  The following commands will initialize
the flash filesystem, and finish loading the operating
system software:
    flash_init
    load_helper
    boot
Switch:

Restrictions

This procedure is recommended only for recovery of a corrupted image. To perform this procedure, the Cisco EtherSwitch service module must be at the boot loader prompt, and the console from the router to the Cisco EtherSwitch service module must be disconnected for the Xmodem Protocol to work.

SUMMARY STEPS

  1. service-module interface slot/port password-reset
  2. flash_init
  3. load_helper filesystem:/file-url ... (optional)
  4. control+shift+6 x
  5. disconnect
  6. copy flash: xmodem: (Use this command to download the software image from the router flash memory. Use this command from the router prompt.)

or

copy tftp: xmodem: (Use this command to download the software image from a TFTP server. Use this command only if the image is not on the router flash memory.)

  1. service-module interface slot/port session
  2. dir flash:
  3. boot flash: image

DETAILED STEPS

Command or Action
Purpose

Step 1

service-module interface slot/port password-reset

Example:

Router# service-module gigabitethernet2/0 password-reset

Ensures that the switch stays at the boot loader prompt, so that you can copy a new image through the Xmodem Protocol.

Step 2

flash_init

Example:

Switch: flash_init

Initializes the flash memory file system on the switch.

Step 3

load_helper filesystem:/file-url ...

Example:

Switch: load_helper flash: xyz

Loads and initializes one or more helper images.

Step 4

control+shift+6 x

Example:

Switch: control+shift+6 x

Returns you to the router console while keeping the console session to the switch intact.

Step 5

disconnect

Example:

Router# disconnect 1

Disconnects the switch session to begin the Xmodem download.

Step 6

copy flash: xmodem:

Example:

Router# copy flash: xmodem:

or

Starts the file transfer from the router flash memory by using the Xmodem Protocol from the router prompt.

copy tftp: xmodem:

Example:

Router# copy tftp: xmodem:

Starts the file transfer from a TFTP server from the router prompt.

Step 7

service-module interface slot/port session

Example:

Router# service-module gigabitethernet1/0 session

Connects to the service module and opens a Cisco EtherSwitch service module session.

Step 8

dir flash:

Example:

rommon> dir flash:

Displays a list of all files and directories in flash memory on the service module.

Step 9

boot flash: image

Example:

rommon> boot flash:c3825-i5-mz.050404

Boots the Cisco EtherSwitch service module image if all files and directories are in flash memory on the service module.

Troubleshooting

If the downloaded image (files and directories) are not in flash memory on the Cisco EtherSwitch service module, repeat Step 1 through Step 6. If the procedure fails again, ensure that your TFTP connection is up and that your TFTP session is open when you download the image.

Examples

This section provides the following examples:

Sample Output for the copy flash: xmodem Command

The following example shows what appears when you enter the copy flash: xmodem command:

Router# copy flash: xmodem
**** WARNING ****
x/ymodem is a slow transfer protocol limited to the current speed
settings of the auxiliary/console ports. The use of the auxiliary
port for this download is strongly recommended.
During the course of the download no exec input/output will be
available.
---- ******* ----
Proceed? [confirm]

You are prompted for the source filename and destination filename:

Source filename [loader_bs.img]?
Destination filename [loader_bs.img]?

You are prompted for the Cisco EtherSwitch service module slot number:

Service Module slot number? [1]:  

You are prompted for the service module interface number. Accept the default:

Service Module interface number? [0]:  

You are prompted to confirm the buffer. Accept the default:

1k buffer? [confirm]  

You are prompted for the max retry count. Accept the default:

Max Retry Count [10]:  

You are prompted to confirm the transfer to the Cisco EtherSwitch service module:

Xmodem send on slot 2 interface 0. Please be sure there is enough space on receiving side.
Continue? [confirm]

The following appears when the image is downloaded to the service module:

Ready to send
file...........C!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!!
262144 bytes copied in 101.744 secs (2577 bytes/sec)

Sample Output for the copy tftp: xmodem: Command

The following example shows what appears when you enter the copy tftp: xmodem: command:

Router# copy tftp: xmodem:
**** WARNING ****
x/ymodem is a slow transfer protocol limited to the current speed
settings of the auxiliary/console ports. The use of the auxiliary
port for this download is strongly recommended.
During the course of the download no exec input/output will be
available.
---- ******* ----
Proceed? [confirm]

You are prompted for the IP address of the TFTP server:

Address or name of remote host []? 223.255.254.254  

You are prompted for the source filename and destination filename:

Source filename [loader_bs.img]?
Destination filename [loader_bs.img]?

The following appears when you are connected to the TFTP server:

Accessing tftp://223.255.254.254/anyname/loader_bs.img...  

You are prompted for the Cisco EtherSwitch service module slot number:

Service Module slot number? [1]:2  

You are prompted for the service module interface number. Accept the default:

Service Module interface number? [0]:  

You are prompted to confirm the buffer. Accept the default:

1k buffer? [confirm]  

You are prompted for the max retry count. Accept the default:

Max Retry Count [10]:  

You are prompted to confirm the transfer to the Cisco EtherSwitch service module:

Xmodem send on slot 2 interface 0. Please be sure there is enough space on receiving side.
Continue? [confirm]

The following appears when the image is downloaded to the service module:

Ready to send file...........
Loading anyname/loader_bs.img from 223.255.254.254 (via
GigabitEthernet0/0):!C!.!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!.!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!.!!!!
!!!!!!!!!!!!!!!!!!!!!!!!!.!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!.!!!!!!!!!!!!!!!!!!!!!!!!!!!!!.!!!
!!!!!!!!!!!!!!!!!!!!!!!!!!!.!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!.!!!!!!!!!!!!!!!!!!!!!!!!!!!!!.!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!.!!!!!!!!!!!!.!!!!!!.!!!!!!!!!!!!!!!!!!!!!
[OK - 262144 bytes]
!
Verifying checksum...  OK (0x4F76)
262144 bytes copied in 22.368 secs (11720 bytes/sec)

Sample Output for the service-module session Command on the Cisco EtherSwitch Service Module

The following example shows what appears when you enter the service-module session command:

Router# service-module gigabitethernet1/0 session
Trying 41.0.0.1, 2130 ... Open
Switch:

Sample Output for the dir flash: Command on the Cisco EtherSwitch Service Module

The following example shows what appears when you enter the dir flash: command:

rommon> dir flash:
Directory of flash:/
4  -rwx        2056   Mar 1 1993 00:01:29 +00:00  vlan.dat
6  -rwx     6636204   Mar 1 1993 00:19:19 +00:00  c3750-i5-mz.122204
   7  -rwx        1709  Jan 12 2005 00:56:39 +00:00  config.text
   8  -rwx           5  Jan 12 2005 00:56:39 +00:00  private-config.text
32514048 bytes total (19113472 bytes free)

Sample Output for the service-module password-reset Command on the Cisco EtherSwitch Service Module

The following example shows what appears when you enter the service-module password-reset command:

Router# service-module gigabitethernet2/0 password-reset
Do you want to proceed with password reset process?[confirm]
Starting password reset process...
Wait for 50 secs for password reset process to complete
Router#
[Resuming connection 1 to 100.0.2.1 ... ]
Password reset process is complete...
Base ethernet MAC Address: 00:00:00:20:60:80
Xmodem file system is available.
The password-recovery mechanism is enabled.
The system has been interrupted prior to initializing the
flash filesystem.  The following commands will initialize
the flash filesystem, and finish loading the operating
system software:
   flash_init
   load_helper
   boot
Router:

Sample Output for the flash_init Command on the Cisco EtherSwitch Service Module

The following example shows what appears when you enter the flash_init command:

Switch: flash_init
Initializing Flash...
flashfs[0]:7 files, 1 directories
flashfs[0]:0 orphaned files, 0 orphaned directories
flashfs[0]:Total bytes:32514048
flashfs[0]:Bytes used:13400576
flashfs[0]:Bytes available:19113472
flashfs[0]:flashfs fsck took 18 seconds.
...done Initializing Flash.
Boot Sector Filesystem (bs) installed, fsid:3
Setting console baud rate to 9600...

Recovering from a Lost or Forgotten Password

This section shows how to recover from a lost or forgotten password.

The default configuration for the Cisco EtherSwitch service module allows an end user to recover from a lost password by entering a new password.

Note Note:  To enable or disable password recovery, use the service-module password-recovery global configuration command from the Cisco EtherSwitch service module. When you enter the service-module password-recovery command from the Cisco EtherSwitch service module or the no service-module password-recovery command from the stack master, password recovery is propagated throughout the stack and applied to all modules in the stack.

During auto boot loader operation, you are not presented with the boot loader command-line prompt. You gain access to the boot loader command line if the switch is set to manually boot or, if an error occurs, the operating system (a corrupted Cisco IOS image) is loaded. You can also access the boot loader if you have lost or forgotten the switch password.

Note Note:  The default configuration for Cisco EtherSwitch service modules allows an end user to recover from a lost password. The password recovery disable feature allows the system administrator to protect access to the switch password by disabling part of this functionality and allowing the user to interrupt the boot process only by agreeing to set the system back to the default configuration. With password recovery disabled, the user can still interrupt the boot process and change the password, but the configuration file (config.text) and the VLAN database file (vlan.dat) are deleted.

Prerequisites

This recovery procedure requires that you have physical access to the Cisco EtherSwitch service module.

SUMMARY STEPS

  1. service-module interface slot/port session
  2. dir flash:
  3. service-module interface slot/port password-reset
  4. flash_init
  5. (Optional) load_helper filesystem:/file-url ...
  6. rename
  7. boot
  8. copy flash:
  9. configure terminal
  10. enable secret password
  11. exit
  12. copy running-configuration startup-configuration
  13. reload

DETAILED STEPS

Command or Action
Purpose

Step 1

service-module interface slot/port session

Example:

Router# service-module gigabitethernet1/0 session

Connects to the service module and opens a Cisco EtherSwitch service module session.

Step 2

dir flash:

Example:

rommon> dir flash:

Displays a list of all files and directories in flash memory on the service module.

Step 3

service-module interface slot/port password-reset

Example:

Router# service-module gigabitethernet1/0 password-reset

Enables password recovery.

Step 4

flash_init

Example:

Switch: flash_init

Initializes the flash memory file system.

Step 5

load_helper filesystem:/file-url ...

Example:

Switch: load_helper flash:xyz

Loads and initializes one or more helper images.

Step 6

rename

Example:

Switch: rename flash:config.text flash:config.text.old

Renames the configuration file to config.text.old.

Before continuing to the next command, power up any connected stack members and wait until they have completely initialized.

Step 7

boot [-x] [-v] [device:][imagename]

Example:

Switch: boot

Use the boot command to boot up an external process.

Step 8

copy flash:

Example:

Switch: copy flash:config.text system:running-config

Copies the configuration file into memory.

Step 9

configure terminal

Example:

Switch# configure terminal

Enters global configuration mode.

Step 10

enable secret password

Example:

Switch(config): enable secret 5 $1$LiBw$0Xc1wyT.PXPkuhFwqyhVi0

Sets the password.

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

Step 11

exit

Example:

Switch(config): exit

Returns you to privileged EXEC mode.

Step 12

copy running-configuration startup-configuration

Example:

Switch: copy running-config startup-config

Copies the configuration from the running configuration file to the switch startup configuration file.

  • This procedure is likely to leave your Cisco EtherSwitch service module virtual interface in a shut down state.
  • You can see which interface is in this state by entering the show running-configuration privileged EXEC command.
  • To reenable the interface, enter the interface vlan vlan-id global configuration command, and specify the VLAN ID of the shut down interface. With the Cisco EtherSwitch service module in interface configuration mode, enter the no shutdown command.

Step 13

reload

Example:

Switch: reload

Reloads the switch stack.

Recovering from a Lost or Forgotten Password When Password Recovery Is Disabled

This section shows how to recover from a lost or forgotten password when password recovery is disabled.

When password recovery is disabled, access to the boot loader prompt through the password-recovery mechanism is disallowed even though the password-recovery mechanism has been triggered. If you agree to let the system be reset to the default system configuration, access to the boot loader prompt is then allowed, and you can set the environment variables.

Prerequisites

This recovery procedure requires that you have physical access to the Cisco EtherSwitch service module or switch.

SUMMARY STEPS

  1. service-module interface slot/port password-reset
  2. service-module interface slot/port session
  3. (Optional) load_helper filesystem:/file-url ...
  4. boot
  5. enable
  6. configure terminal
  7. enable secret password
  8. exit
  9. copy running-configuration startup-configuration
  10. reload
  11. (Optional) set

DETAILED STEPS

Command or Action
Purpose

Step 1

service-module interface slot/port password-reset

Example:

Router# service-module gigabitethernet1/0 password-reset

Resets the password on the router.

Step 2

service-module interface slot/port session

Example:

Router# service-module gigabitethernet1/0 session

Connects to the service module and opens a service module session.

  • Entering no leaves the current configuration file intact, so you can rename it.
  • Entering yes deletes the configuration file.

Note This configuration can only be done if the service-module session command is entered within 50 seconds after entering the service-module password-reset command.

Step 3

dir flash:

Example:

rommon> dir flash:

Displays a list of all files and directories in flash memory on the service module.

Step 4

load_helper filesystem:/file-url ...

Example:

Switch: load_helper flash: xyz

Loads and initializes one or more helper images.

Step 5

boot

Example:

Switch: boot

Boots the system.

Step 6

enable

Example:

Switch: enable

Enters privileged EXEC mode from the service module prompt.

Step 7

configure terminal

Example:

Switch: configure terminal

Enters global configuration mode.

Step 8

enable secret password

Example:

Switch(config): enable secret 5 $1$LiBw$0Xc1wyT.PXPkuhFwqyhVi0

Changes the password.

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

Step 9

exit

Example:

Switch(config): exit

Returns you to privileged EXEC mode.

Step 10

copy running-configuration startup-configuration

Example:

Switch: copy running-config startup-config

Copies the configuration from the running configuration file to the switch startup configuration file.

  • This procedure is likely to leave your Cisco EtherSwitch service module virtual interface in a shut down state.
  • You can see which interface is in this state by entering the show running-configuration privileged EXEC command.
  • To reenable the interface, enter the interface vlan vlan-id global configuration command, and specify the VLAN ID of the shut down interface. With the Cisco EtherSwitch service module in interface configuration mode, enter the no shutdown command.

Step 11

reload

Example:

Switch# reload

Reloads the switch stack.

Step 12

set

Example:

Switch# set

Lists all environment variables, including the current baud rate.

Example

Sample Output for the set Command

The following example shows what appears when you enter the set command:

Switch: set
BAUD=9600
MAC_ADDR=00:00:00:20:30:80
MANUAL_BOOT=yes
SDM_TEMPLATE_ID=0
SWITCH_NUMBER=2
SWITCH_PRIORITY=1

 All contents are Copyright 1992–2009 Cisco Systems, Inc. All rights reserved.