To download a new image from a TFTP server to the switch or switch stack and to overwrite or keep the existing image, use the archive download-sw privileged EXEC command.

Command Default

The current software image is not overwritten with the downloaded image. Both the software image and HTML files are downloaded. The new image is downloaded to the flash: file system. The BOOT environment variable is changed to point to the new software image on the flash: file system. Image files are case-sensitive; the image file is provided in TAR format. Compatibility of the stack protocol version of the image to be downloaded is checked with the version on the stack.

Command Modes

Privileged EXEC

Usage Guidelines

The /imageonly option removes the HTML files for the existing image if the existing image is being removed or replaced. Only the Cisco IOS image (without the HTML files) is downloaded.

Using the /safe or /leave-old-sw option can cause the new image download to fail if there is insufficient flash memory. If you leave the software in place, the new image does not have enough flash memory due to space constraints, and an error message is displayed.

If you used the /leave-old-sw option and did not overwrite the old image when you downloaded the new one, you can remove the old image by using the delete privileged EXEC command. For more information, see the delete section.

If you want to download an image that has a different stack protocol version than the one existing on the stack, use the /no-version-check option. You must use this option with the /destination-system option to specify the specific member to be upgraded with the image.

Note	Stacking is supported only on switches running the LAN Base image.

Note	Use the /no-version-check option carefully. All members, including the master, must have the same stack protocol version to be in the same stack. This option allows an image to be downloaded without first confirming the compatibility of its stack protocol version with the version of the stack.

You can upgrade more than one specific stack member by repeating the /destination-system option in the command for each stack member to be upgraded.

Use the /overwrite option to overwrite the image on the flash device with the downloaded one.

If you specify the command without the /overwrite option, the download algorithm determines whether or not the new image is the same as the one on the switch flash device or is running on any stack members. If the images are the same, the download does not occur. If the images are different, the old image is deleted, and the new one is downloaded.

After downloading a new image, enter the reload privileged EXEC command to begin using the new image, or specify the /reload or /force-reload option in the archive download-sw command.

To create a TAR file, list files in a TAR file, or extract the files from a TAR file, use the archive tar privileged EXEC command.

Command Modes

Privileged EXEC

Usage Guidelines

Filenames and directory names are case sensitive.

Image names are case sensitive.

To upload an existing image to the server, use the archive upload-sw privileged EXEC command.

Command Default

Uploads the currently running image from the flash: file system.

Command Modes

Privileged EXEC

Usage Guidelines

You must specify the /source-system-num option to use the /version option. Using these options together uploads the specified image, not the running image, of a specific stack member.

Use the upload feature only if the HTML files associated with embedded Device Manager have been installed with the existing image.

The files are uploaded in this sequence: the Cisco IOS image, the HTML files, and info. After these files are uploaded, the software creates the TAR file.

Image names are case sensitive.

To create a warning message to be displayed when you try to save the configuration file to NVRAM, use the banner config-save global configuration command.

Command Default

None

Command Modes

Global configuration

To load and boot an executable image and display the command-line interface (CLI), use the boot command in boot loader mode.

Command Default

None

Command Modes

Boot loader

Usage Guidelines

When you enter the boot command without any arguments, the switch attempts to automatically boot the system by using the information in the BOOT environment variable, if any. If you supply an image name for the file-url variable, the boot command attempts to boot the specified image.

When you specify boot loader boot command options, they are executed immediately and apply only to the current boot loader session. These settings are not saved for the next boot operation.

Filenames and directory names are case sensitive.

To configure the NVRAM buffer size, use the boot buffersize global configuration command.

Command Default

The default NVRAM buffer size is 512 KB.

Command Modes

Global configuration

Usage Guidelines

After you configure the NVRAM buffer size, reload the switch or switch stack.

When you add a switch to a stack and the NVRAM size differs, the new switch synchronizes with the stack and reloads automatically.

To enable the interruption of the automatic boot process on a standalone switch, use the boot enable-break global configuration command. Use the no form of this command to return to the default setting.

Syntax Description

This command has no arguments or keywords.

Command Default

Disabled. The automatic boot process cannot be interrupted by pressing the Break key on the console.

Command Modes

Global configuration

Usage Guidelines

This command works properly only from a standalone switch. When you enter this command, you can interrupt the automatic boot process by pressing the Break key on the console after the flash: file system is initialized.

Note	Despite setting this command, you can interrupt the automatic boot process at any time by pressing the MODE button on the switch front panel.

This command changes the setting of the ENABLE_BREAK environment variable.

To configure the switch to download files from a DHCP server, use the boot host dhcp global configuration command.

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Global configuration

To set the amount of time for which the system tries to download a configuration file, use the boot host retry timeout global configuration command.

Command Default

There is no default. If you do not set a timeout, the system indefinitely tries to obtain an IP address from the DHCP server.

Command Modes

Global configuration

To enable the ability to manually boot a standalone switch during the next boot cycle, use the boot manual global configuration command. Use the no form of this command to return to the default setting.

Syntax Description

This command has no arguments or keywords.

Command Default

Manual booting is disabled.

Command Modes

Global configuration

Usage Guidelines

This command works properly only from a standalone switch.

The next time you reboot the system, the switch is in boot loader mode, which is shown by the switch: prompt. To boot up the system, use the boot boot loader command, and specify the name of the bootable image.

This command changes the setting of the MANUAL_BOOT environment variable.

To specify the name of the configuration file that is used as a boot image, use the boot system global configuration command.

Command Default

None

Command Modes

Global configuration

To display the contents of one or more files, use the cat command in boot loader mode.

Command Default

None

Command Modes

Boot loader

Usage Guidelines

Filenames and directory names are case sensitive.

If you specify a list of files, the contents of each file appears sequentially.

To clear all of the on-board failure logging (OBFL) data, use the clear logging onboard privileged EXEC command on the switch stack or on a standalone switch. The command clears all of the OBFL data except for the uptime and CLI-command information stored in the flash memory.

Command Modes

Privileged EXEC

Usage Guidelines

We recommend that you keep OBFL enabled and do not erase the data stored in the flash memory.

To delete a specific dynamic address, all dynamic addresses on a particular interface, all dynamic addresses on stack members, or all dynamic addresses on a particular VLAN from the MAC address table, use the clear mac address-table privileged EXEC command. This command also clears the MAC address notification global counters.

Command Default

No default is defined.

Command Modes

Privileged EXEC

To clear the mac address-table-move update-related counters, use the clear mac address-table move update privileged EXEC command.

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Privileged EXEC

To specify the cluster command MAC address on a cluster member switch, when the member has lost communication with the cluster command switch, use the cluster commander-address global configuration command. Use the no form of this global configuration command from the cluster member switch console port to remove the switch from a cluster only during debugging or recovery procedures.

Command Default

The switch is not a member of any cluster.

Command Modes

Global configuration

Usage Guidelines

This command is available only on the cluster command switch. The cluster command switch automatically provides its MAC address to cluster member switches when these switches join the cluster. The cluster member switch adds this information and other cluster information to its running configuration file.

A cluster member can have only one cluster command switch.

The cluster member switch retains the identity of the cluster command switch during a system reload by using the mac-address parameter.

You can enter the no form on a cluster member switch to remove it from the cluster during debugging or recovery procedures. You usually use this command from the cluster member switch console port only when the member has lost communication with the cluster command switch. With a typical switch configuration, we recommend that you remove cluster member switches only by entering the no cluster member n global configuration command on the cluster command switch.

When a standby cluster command switch becomes active (becomes the cluster command switch), it removes the cluster commander address line from its configuration.

To set the hop-count limit for extended discovery of candidate switches, use the cluster discovery hop-count global configuration command on the cluster command switch. Use the no form of this command to return to the default setting.

Command Default

The default hop count is 3.

Command Modes

Global configuration

Usage Guidelines

This command is available only on the cluster command switch. This command does not operate on cluster member switches.

If the hop count is set to 1, extended discovery is disabled. The cluster command switch discovers only candidates that are one hop from the edge of the cluster. The edge of the cluster is the point between the last discovered cluster member switch and the first discovered candidate switch.

To enable a command-capable switch as the cluster command switch, assign a cluster name, and optionally assign a member number to it, use the cluster enable global configuration command. Use the no form of the command to remove all members and to make the cluster command switch a candidate switch.

Command Default

The switch is not a cluster command switch.

No cluster name is defined.

The member number is 0 when the switch is the cluster command switch.

Command Modes

Global configuration

Usage Guidelines

Enter this command on any command-capable switch that is not part of any cluster. This command fails if a device is already configured as a member of the cluster.

You must name the cluster when you enable the cluster command switch. If the switch is already configured as the cluster command switch, this command changes the cluster name if it is different from the previous cluster name.

To set the duration in seconds before a switch (either the command or cluster member switch) declares the other switch down after not receiving heartbeat messages, use the cluster holdtime global configuration command on the cluster command switch. Use the no form of this command to set the duration to the default value.

Command Default

The default holdtime is 80 seconds.

Command Modes

Global configuration

Usage Guidelines

Enter this command with the cluster timer global configuration command only on the cluster command switch. The cluster command switch propagates the values to all its cluster members so that the setting is consistent among all switches in the cluster.

The holdtime is typically set as a multiple of the interval timer (cluster timer). For example, it takes (holdtime-in-secs divided by the interval-in-secs) number of heartbeat messages to be missed in a row to declare a switch down.

To add candidates to a cluster, use the cluster member global configuration command on the cluster command switch. Use the no form of the command to remove members from the cluster.

Command Default

A newly enabled cluster command switch has no associated cluster members.

Command Modes

Global configuration

Usage Guidelines

Enter this command only on the cluster command switch to add a candidate to or remove a member from the cluster. If you enter this command on a switch other than the cluster command switch, the switch rejects the command and displays an error message.

You must enter a member number to remove a switch from the cluster. However, you do not need to enter a member number to add a switch to the cluster. The cluster command switch selects the next available member number and assigns it to the switch that is joining the cluster.

You must enter the enabled password of the candidate switch for authentication when it joins the cluster. The password is not saved in the running or startup configuration. After a candidate switch becomes a member of the cluster, its password becomes the same as the cluster command-switch password.

If a switch does not have a configured hostname, the cluster command switch appends a member number to the cluster command-switch hostname and assigns it to the cluster member switch.

If you do not specify a VLAN ID, the cluster command switch automatically chooses a VLAN and adds the candidate to the cluster.

To configure the outside interface for cluster Network Address Translation (NAT), use the cluster outside-interface global configuration command on the cluster command switch, so that a member without an IP address can communicate with devices outside the cluster. Use the no form of this command to return to the default setting.

Command Default

The default outside interface is automatically selected by the cluster command switch.

Command Modes

Global configuration

Usage Guidelines

Enter this command only on the cluster command switch. If you enter this command on a cluster member switch, an error message appears.

To enable clustering on a switch, use the cluster run global configuration command. Use the no form of this command to disable clustering on a switch.

Syntax Description

This command has no arguments or keywords.

Command Default

Clustering is enabled on all switches.

Command Modes

Global configuration

Usage Guidelines

When you enter the no cluster run command on a cluster command switch, the cluster command switch is disabled. Clustering is disabled, and the switch cannot become a candidate switch.

When you enter the no cluster run command on a cluster member switch, it is removed from the cluster. Clustering is disabled, and the switch cannot become a candidate switch.

When you enter the no cluster run command on a switch that is not part of a cluster, clustering is disabled on this switch. This switch cannot then become a candidate switch.

To set the number of seconds between heartbeat messages, use the cluster timer global configuration command on the cluster command switch. To set the interval to the default value, use the no form of the command

Command Default

The default interval is 8 seconds.

Command Modes

Global configuration

Usage Guidelines

Enter this command with the cluster holdtime global configuration command only on the cluster command switch. The cluster command switch propagates the values to all its cluster members so that the setting is consistent among all switches in the cluster.

The holdtime is typically set as a multiple of the heartbeat interval timer (cluster timer). For example, the number of heartbeat messages that are missed in a row before a switch is declared down is calculated by dividing the number of seconds of holdtime by the number of seconds in the interval.

To copy a file from a source to a destination, use the copy command in boot loader mode.

Command Default

None

Command Modes

Boot loader

Usage Guidelines

Filenames and directory names are case sensitive.

Directory names are limited to 127 characters between the slashes (/); the name cannot contain control characters, spaces, deletes, slashes, quotes, semicolons, or colons.

Filenames are limited to 127 characters; the name cannot contain control characters, spaces, deletes, slashes, quotes, semicolons, or colons.

If you are copying a file to a new directory, the directory must already exist.

Use the debug cluster privileged EXEC command to enable debugging of cluster-specific events. Use the no form of this command to disable debugging.

Command Default

Debugging is disabled.

Command Modes

Privileged EXEC

Usage Guidelines

This command is available only on the cluster command switch stack or cluster command switch.

The undebug cluster command works the same as the no debug cluster command.

When you enable debugging, it is enabled only on the stack master. To enable debugging on a stack member, you can start a session from the stack master by using the session switch-number privileged EXEC command. Then enter the debug command at the command-line prompt of the stack member. You also can use the remote command stack-member-number LINE privileged EXEC command on the stack master switch to enable debugging on a member switch without first starting a session.

To enable debugging of MAC address-table move update message processing, use the debug matm move update privileged EXEC command. Use the no form of this command to return to the default setting.

Command Default

Debugging is disabled.

Command Modes

Privileged EXEC

Usage Guidelines

The undebug matm move update command works the same as the no debug matm move update command.

Note	To use this command, the switch must be running the LAN Base image.

When you enable debugging, it is enabled only on the stack master. To enable debugging on a stack member, you can start a session from the stack master by using the session switch-number privileged EXEC command. Then enter the debug command at the command-line prompt of the stack member. You can also use the remote command stack-member-number LINE privileged EXEC command on the stack master switch to enable debugging on a member switch without first starting a session.

To delete one or more files from the specified file system, use the delete command in boot loader mode.

Command Default

None

Command Modes

Boot loader

Usage Guidelines

Filenames and directory names are case sensitive.

The switch prompts you for confirmation before deleting each file.

To display the list of files and directories on the specified file system, use the dir command in boot loader mode.

Command Default

None

Command Modes

Boot loader

Usage Guidelines

Directory names are case sensitive.

To display the available commands, use the help command in boot loader mode.

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Boot loader

Usage Guidelines

You can also use the question mark (?) to display a list of available boot loader commands.

To enable on-board failure logging (OBFL), use the hw-module global configuration command on the switch stack or on a standalone switch. Use the no form of this command to disable this feature.

Command Default

OBFL is enabled, and all messages appear.

Command Modes

Global configuration

Usage Guidelines

We recommend that you keep OBFL enabled and do not erase the data stored in the flash memory.

To ensure that the time stamps in the OBFL data logs are accurate, you should manually set the system clock or configure it by using Network Time Protocol (NTP).

If you do not enter the message level level parameter, all the hardware-related messages generated by the switch are stored in the flash memory.

On a standalone switch, entering the hw-module module [switch-number] logging onboard [message level level] command is the same as entering the hw-module module logging onboard [message level level] command.

Entering the hw-module module logging onboard [message level level] command on a stack master enables OBFL on all the stack members that support OBFL.

To log messages to a UNIX syslog server host, use the logging global configuration command.

Command Default

None

Command Modes

Global configuration

Usage Guidelines

To build a list of syslog servers that receive logging messages, enter this command more than once.

To log messages to an internal buffer, use the logging buffered global configuration command. Use it on the switch or on a standalone switch or, in the case of a switch stack, on the stack master.

Command Default

The default buffer size is 4096 bytes.

Command Modes

Global configuration

Usage Guidelines

If a standalone switch or the stack master fails, the log file is lost unless you previously saved it to flash memory using the logging file flash global configuration command.

Do not make the buffer size too large because the switch could run out of memory for other tasks. Use the show memory privileged EXEC command to view the free processor memory on the switch. However, this value is the maximum number of bytes available, and the buffer size should not be set to this amount.

To limit messages logged to the console according to severity, use the logging console command. Use the no form of this command to disable message logging.

Command Default

By default, the console receives debugging messages and numerically lower levels.

Command Modes

Global configuration

To store log messages in a file in flash memory, use the logging file flash command. Use it on a standalone switch or, in the case of a switch stack, on the stack master.

Command Default

The default maximum file size is 4096 bytes and the default minimum file size is 1024 bytes.

Command Modes

Global configuration

To change the default level of syslog messages stored in the history file and sent to the SNMP server, use the logging history command.

Command Default

By default, warning, error, critical, alert, and emergency messages are sent.

Command Modes

Global configuration

To specify the number of syslog messages that can be stored in the history table, use the logging history global configuration command.

Note	When the history table contains the maximum number of message entries specified, the oldest message entry is deleted from the table to allow the new message entry to be stored.

Command Default

The default is to store one message. The range is 0 to 500 messages.

Command Modes

Global Configuration

To limit messages logged to the terminal lines according to severity, use the logging monitor command.

Command Default

By default, the terminal receives debugging messages and numerically lower levels.

Command Modes

Global configuration

To limit messages logged to the syslog servers according to severity, use the logging trap command.

Command Default

By default, the syslog servers receive debugging messages and numerically lower levels.

Command Modes

Global configuration

To set the length of time that a dynamic entry remains in the MAC address table after the entry is used or updated, use the mac address-table aging-time global configuration command. Use the no form of this command to return to the default setting.

Command Default

The default is 300 seconds.

Command Modes

Global configuration

Usage Guidelines

The aging time applies to all VLANs or a specified VLAN. If you do not specify a specific VLAN, this command sets the aging time for all VLANs. Enter 0 seconds to disable aging.

To enable MAC address learning on a VLAN, use the mac address-table learning global configuration command. Use the no form of this command to disable MAC address learning on a VLAN to control which VLANs can learn MAC addresses.

Command Default

By default, MAC address learning is enabled on all VLANs.

Command Modes

Global configuration

Usage Guidelines

When you control MAC address learning on a VLAN, you can manage the available MAC address table space by controlling which VLANs, and therefore which ports, can learn MAC addresses.

You can disable MAC address learning on a single VLAN ID (for example, no mac address-table learning vlan 223) or on a range of VLAN IDs (for example,no mac address-table learning vlan 1-20, 15).

Before you disable MAC address learning, be sure that you are familiar with the network topology and the switch system configuration. Disabling MAC address learning on a VLAN could cause flooding in the network. For example, if you disable MAC address learning on a VLAN with a configured switch virtual interface (SVI), the switch floods all IP packets in the Layer 2 domain. If you disable MAC address learning on a VLAN that includes more than two ports, every packet entering the switch is flooded in that VLAN domain. We recommend that you disable MAC address learning only in VLANs that contain two ports and that you use caution before disabling MAC address learning on a VLAN with an SVI.

You cannot disable MAC address learning on a VLAN that the switch uses internally. If the VLAN ID that you enter in the no mac address-table learning vlan vlan-id command is an internal VLAN, the switch generates an error message and rejects the command. To view a list of which internal VLANs are being used, enter the show vlan internal usage privileged EXEC command.

If you disable MAC address learning on a VLAN configured as a private VLAN primary or a secondary VLAN, the MAC addresses are still learned on the other VLAN (primary or secondary) that belongs to the private VLAN.

You cannot disable MAC address learning on an RSPAN VLAN. The configuration is not allowed.

If you disable MAC address learning on a VLAN that includes a secure port, MAC address learning is not disabled on the secure port. If you later disable port security on the interface, the disabled MAC address learning state is enabled.

To display the MAC address learning status of all VLANs or a specified VLAN, enter the show mac-address-table learning [vlan vlan-id ] command.

To enable the MAC address table move update feature, use the mac address-table move update command in global configuration mode on the switch stack or on a standalone switch. To return to the default setting, use the no form of this command.

Syntax Description

Command Default

By default, the MAC address-table move update feature is disabled.

Command Modes

Global configuration

Command History

Usage Guidelines

The MAC address-table move update feature allows the switch to provide rapid bidirectional convergence if a primary (forwarding) link goes down and the standby link begins forwarding traffic.

You can configure the access switch to send the MAC address-table move update messages if the primary link goes down and the standby link comes up. You can configure the uplink switches to receive and process the MAC address-table move update messages.

To enable the MAC address notification feature on the switch stack, use the mac address-table notification global configuration command. Use the no form of this command to return to the default setting.

Command Default

By default, the MAC address notification, MAC move, and MAC threshold monitoring are disabled.

The default MAC utilization threshold is 50 percent.

The default time between MAC threshold notifications is 120 seconds.

Command Modes

Global configuration

Usage Guidelines

You can enable traps whenever a MAC address is moved from one port to another in the same VLAN by entering the mac address-table notification mac-move command and the snmp-server enable traps mac-notification move global configuration command.

To generate traps whenever the MAC address table threshold limit is reached or exceeded, enter the mac address-table notification threshold [limit percentage] | [interval time] command and the snmp-server enable traps mac-notification threshold global configuration command.

To send a notification of the dynamic changes to the MAC address-table, use the mac address-table notification change global configuration command. Use the no form of this command to return to the default setting.

Command Default

By default, the MAC address-table notification change feature is disabled.

Command Modes

Global configuration

To add static addresses to the MAC address table, use the mac address-table static global configuration command. Use the no form of this command to remove static entries from the table.

Syntax Description

Command Default

No static addresses are configured.

Command Modes

Global configuration

Command History

To create one or more directories on the specified file system, use the mkdir command in boot loader mode.

Command Default

None

Command Modes

Boot loader

Usage Guidelines

Directory names are case sensitive.

Directory names are limited to 127 characters between the slashes (/); the name cannot contain control characters, spaces, deletes, slashes, quotes, semicolons, or colons.

To display the contents of one or more files, use the more command in boot loader mode.

Command Default

None

Command Modes

Boot loader

Usage Guidelines

Filenames and directory names are case sensitive.

If you specify a list of files, the contents of each file appears sequentially.

To start a Telnet session and to execute commands, use the rcommand user EXEC command. Use it on the switch stack, on the cluster command switch, or on a cluster member switch. To end the session, enter the exit command.

Syntax Description

Command Modes

User EXEC

Usage Guidelines

This command is available only on the cluster command switch stack or cluster command switch.

If the switch is the cluster command switch, but the cluster member switch n does not exist, an error message appears. To get the switch number, enter the show cluster members privileged EXEC command on the cluster command switch.

You can use this command to access a cluster member switch from the cluster command-switch prompt or to access a cluster command switch from the member-switch prompt.

For Catalyst 2900 XL, 3500 XL, 2950, 2960, 2970, 3550, 3560, and 3750 switches, the Telnet session accesses the member-switch command-line interface (CLI) at the same privilege level as on the cluster command switch. For example, if you execute this command at user level on the cluster command switch, the cluster member switch is accessed at user level. If you use this command on the cluster command switch at the privilege level, the command accesses the remote device at the privilege level. If you use an intermediate enable-level lower than the privilege, access to the cluster member switch is at the user level.

For Catalyst 1900 and 2820 switches running standard edition software, the Telnet session accesses the menu console (the menu-driven interface) if the cluster command switch is at privilege level 15. If the cluster command switch is at privilege level 1, you are prompted for the password before being able to access the menu console. Cluster command switch privilege levels map to the cluster member switches running standard edition software as follows:

• If the cluster command switch privilege level is from 1 to 14, the cluster member switch is accessed at privilege level 1.
• If the cluster command switch privilege level is 15, the cluster member switch is accessed at privilege level 15.

The Catalyst 1900 and 2820 CLI is available only on switches running Enterprise Edition Software.

This command will not work if the vty lines of the cluster command switch have access-class configurations.

You are not prompted for a password because the cluster member switches inherited the password of the cluster command switch when they joined the cluster.

To rename a file, use the rename command in boot loader mode.

Command Default

None

Command Modes

Boot loader

Usage Guidelines

Filenames and directory names are case sensitive.

Directory names are limited to 127 characters between the slashes (/); the name cannot contain control characters, spaces, deletes, slashes, quotes, semicolons, or colons.

Filenames are limited to 127 characters; the name cannot contain control characters, spaces, deletes, slashes, quotes, semicolons, or colons.

To perform a hard reset on the system, use the reset command in boot loader mode. A hard reset is similar to power-cycling the switch; it clears the processor, registers, and memory.

Command Default

None

Command Modes

Boot loader

To remove one or more empty directories from the specified file system, use the rmdir command in boot loader mode.

Command Default

None

Command Modes

Boot loader

Usage Guidelines

Directory names are case sensitive and limited to 45 characters between the slashes (/); the name cannot contain control characters, spaces, deletes, slashes, quotes, semicolons, or colons.

Before removing a directory, you must first delete all the files in the directory.

The switch prompts you for confirmation before deleting each directory.

To display messages with sequence numbers when there is more than one log message with the same time stamp, use the service sequence-numbers global configuration command.

Syntax Description

This command has no arguments or keywords.

Command Default

By default, sequence numbers in log messages are not displayed.

Command Modes

Global configuration

To set or display environment variables, use the set command in boot loader mode. Environment variables can be used to control the boot loader or any other software running on the switch.

Command Default

The environment variables have these default values:

MANUAL_BOOT: No (0)

BOOT: Null string

ENABLE_BREAK: No (Off or 0) (the automatic boot process cannot be interrupted by pressing the Break key on the console).

HELPER: No default value (helper files are not automatically loaded).

PS1 switch:

CONFIG_FILE: config.text

BAUD: 9600 b/s

SWITCH_NUMBER: 1

SWITCH_PRIORITY: 1

Note

Environment variables that have values are stored in the flash: file system in various files. Each line in the files contains an environment variable name and an equal sign followed by the value of the variable. A variable has no value if it is not listed in these files; it has a value if it is listed even if the value is a null string. A variable that is set to a null string (for example, “ ”) is a variable with a value. Many environment variables are predefined and have default values.

Command Modes

Boot loader

Usage Guidelines

Environment variables are case sensitive and must be entered as documented.

Environment variables that have values are stored in flash memory outside of the flash: file system.

Under typical circumstances, it is not necessary to alter the setting of the environment variables.

The MANUAL_BOOT environment variable can also be set by using the boot manual global configuration command.

The BOOT environment variable can also be set by using the boot system filesystem:/file-url global configuration command.

The ENABLE_BREAK environment variable can also be set by using the boot enable-break global configuration command.

The HELPER environment variable can also be set by using the boot helper filesystem: / file-url global configuration command.

The CONFIG_FILE environment variable can also be set by using the boot config-file flash: /file-url global configuration command.

The SWITCH_NUMBER environment variable can also be set by using the switch current-stack-member-number renumber new-stack-member-number global configuration command.

The SWITCH_PRIORITY environment variable can also be set by using the switch stack-member-number priority priority-number global configuration command.

The boot loader prompt string (PS1) can be up to 120 printable characters not including the equal sign (=).

To display the settings of the boot environment variables, use the show boot privileged EXEC command.

Syntax Description

This command has no arguments or keywords.

Command Default

None

Command Modes

Privileged EXEC

To display the pseudo-random binary sequence (PRBS) test results, use the show cable-diagnostics prbs command in privileged EXEC mode.

Command Default

None

Command Modes

Privileged EXEC

Usage Guidelines

PRBS is only supported on 10-Gigabit Ethernet ports. It is not supported on 10/100/100 copper Ethernet ports and small form-factor pluggable (SFP) module ports.

To display the Time Domain Reflector (TDR) results, use the show cable-diagnostics tdr command in privileged EXEC mode.

Command Default

None

Command Modes

Privileged EXEC

Usage Guidelines

TDR is supported only on 10/100/100 copper Ethernet ports. It is not supported on 10-Gigabit Ethernet ports and small form-factor pluggable (SFP) module ports.

To display the cluster status and a summary of the cluster to which the switch belongs, use the show cluster EXEC command. This command can be entered on the cluster command switch and cluster member switches.

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC

Privileged EXEC

Usage Guidelines

If you enter this command on a switch that is not a cluster member, the following error message appears:

Not a management cluster member.

On a cluster member switch, this command displays the identity of the cluster command switch, the switch member number, and the state of its connectivity with the cluster command switch.

On a cluster command switch stack or cluster command switch, this command displays the cluster name and the total number of members. It also shows the cluster status and time since the status changed. If redundancy is enabled, it displays the primary and secondary command-switch information.

To display a list of candidate switches, use the show cluster candidates EXEC command.

Command Modes

User EXEC

Privileged EXEC

Usage Guidelines

This command is available only on the cluster command switch stack or cluster command switch.

Note	Stacking is only supported on switches running the LAN Base image.

If the switch is not a cluster command switch, the command displays an empty line at the prompt.

The SN in the display means switch member number. If E appears in the SN column, it means that the switch is discovered through extended discovery. If E does not appear in the SN column, it means that the switch member number is the upstream neighbor of the candidate switch. The hop count is the number of devices the candidate is located from the cluster command switch.

To display information about cluster members, use the show cluster members privileged EXEC command.

Command Modes

Privileged EXEC

Usage Guidelines

This command is available only on the cluster command switch stack or cluster command switch.

Note	Stacking is supported only on switches running the LAN Base image.

If the cluster has no members, this command displays an empty line at the prompt.

Display the on-board failure logging (OBFL) information using the show logging onboard privileged EXEC command.

Command Modes

Privileged EXEC

Usage Guidelines

When OBFL is enabled, the switch records OBFL data in a continuous file that contains all of the data. The continuous file is circular. When the continuous file is full, the switch combines the data into a summary file, which is also known as a historical file. Creating the summary file frees up space in the continuous file so that the switch can write newer data to it.

If you enter the module keyword, but do not enter the switch number, the switch displays OBFL information about the stack members that support OBFL.

Use the start and end keywords to display data collected only during a particular time period. When specifying the start and end times, follow these guidelines:

• hh:mm:ss—Enter the time as a two-digit number for a 24-hour clock. Make sure to use the colons (:). For example, enter 13:32:45.
• day—Enter the day of the month. The range is from 1 to 31.
• month—Enter the month in uppercase or lowercase letters. You can enter the full name of the month, such as January or august, or the first three letters of the month, such as jan or Aug
• year—Enter the year as a 4-digit number, such as 2008. The range is from 1993 to 2035.

Note	This command is supported only on switches running the LAN Base image.

To display a specific MAC address table entry, use the show mac address-table command in EXEC mode.

Syntax Description

This command has no arguments or keywords.

Command Modes

User EXEC

Privileged EXEC

Usage Guidelines

To use this command, the switch must be running the LAN Base image. This command can display static and dynamic entries or the MAC address table static and dynamic entries on a specific interface or VLAN.

To display MAC address table information for a specified MAC address, use the show mac address-table address command in EXEC mode.

Command Modes

User EXEC

Privileged EXEC

To display the aging time of address table entries, use the show mac address-table aging-time command in EXEC mode.

Command Modes

User EXEC

Privileged EXEC

Usage Guidelines

If no VLAN number is specified, the aging time for all VLANs appears. This command displays the aging time of a specific address table instance, all address table instances on a specified VLAN, or, if a specific VLAN is not specified, on all VLANs.

To display the number of addresses present in all VLANs or the specified VLAN, use the show mac address-table count command in EXEC mode.

Command Modes

User EXEC

Privileged EXEC

Usage Guidelines

If no VLAN number is specified, the address count for all VLANs appears.

To display only dynamic MAC address table entries, use the show mac address-table dynamic command in EXEC mode.

Command Modes

User EXEC

Privileged EXEC

To display the MAC address table information for a specified interface on a specified VLAN, use the show mac address-table interface EXEC command.

Command Modes

User EXEC

Privileged EXEC

To display the status of MAC address learning for all VLANs or a specified VLAN, use the show mac address-table learning command in EXEC mode.

Command Modes

User EXEC

Privileged EXEC

Usage Guidelines

Use the show mac address-table learning command without any keywords to display configured VLANs and whether MAC address learning is enabled or disabled on them. The default is that MAC address learning is enabled on all VLANs. Use the command with a specific VLAN ID to display the learning status on an individual VLAN.

Note	To use this command, the switch must be running the LAN Base image.

To display the MAC address-table move update information on the switch, use the show mac address-table move update command in EXEC mode.

Command Default

None

Command Modes

User EXEC

Privileged EXEC

To display information about the multicast MAC address table, use the show mac-address-table multicast command.

Usage Guidelines

For the MAC address table entries that are used by the routed ports, the routed port name is displayed in the "vlan" column, not the internal VLAN number.

To display the MAC address notification settings for all interfaces or the specified interface, use the show mac address-table notification command in EXEC mode.

Command Default

By default, the MAC address notification, MAC move, and MAC threshold monitoring are disabled.

The default MAC utilization threshold is 50 percent.

The default time between MAC threshold notifications is 120 seconds.

Command Modes

User EXEC

Privileged EXEC

Usage Guidelines

Use the show mac address-table notification change command without keywords to see if the MAC address change notification feature is enabled or disabled, the number of seconds in the MAC notification interval, the maximum number of entries allowed in the history table, and the history table contents.

Use the interface keyword to display the notifications for all interfaces. If the interface id is included, only the flags for that interface appear.

To display only secure MAC address table entries, use the show mac address-table secure command in EXEC mode.

Command Modes

User EXEC

Privileged EXEC

To display only static MAC address table entries, use the show mac address-table static command in EXEC mode.

Command Modes

User EXEC

Privileged EXEC

To display the MAC address table information for a specified VLAN, use the show mac address-table vlan command in EXEC mode.

Command Modes

User EXEC

Privileged EXEC

To display the Network Mobility Services Protocol (NMSP) configuration settings, use the show nmsp command.

Syntax Description

Command Default

None

Command Modes

Privileged EXEC

To shut down the system elements, use the shutdown command. To disable the configuration set, use the no form of this command.

Command Default

None

Command Modes

Global configuration