To enable debugging of remote commands, use the debug platform remote-commands command in privileged EXEC mode. To disable debugging, use the no form of this command.

Syntax Description

This command has no keywords or arguments.

Command Default

Debugging is disabled.

Command Modes

Privileged EXEC

Usage Guidelines

The undebug platform remote-commands command is the same as the no debug platform remote-commands command.

When you enable debugging on a switch stack, 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. 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 the stack manager software, use the debug platform stack-manager command in privileged EXEC mode. To disable debugging, use the no form of this command.

Command Default

Debugging is disabled.

Command Modes

Privileged EXEC

Usage Guidelines

This command is supported only on stacking-capable switches.

The undebug platform stack-manager command is the same as the no debug platform stack-manager command.

When you enable debugging on a switch stack, 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 EXEC command. Enter the debug command at the command-line prompt of the stack member. You also can use the remote command stack-member-number LINE EXEC command on the stack master switch to enable debugging on a member switch without first starting a session.

To reload the stack member and to apply a configuration change, use the reload command in privileged EXEC mode.

Command Default

Immediately reloads the stack member and puts a configuration change into effect.

Command Modes

Privileged EXEC

Usage Guidelines

If there is more than one switch in the switch stack, and you enter the reload slot stack-member-number command, you are not prompted to save the configuration.

To monitor all or specified stack members, use the remote command privileged EXEC command.

Command Modes

Privileged EXEC

Usage Guidelines

The commands that you use in the LINE command-to-execute string (such as debug, show, or clear) apply to a specific stack member or to the switch stack.

To access a specific stack member use the session command in privileged EXEC mode on the stack master.

Command Default

None

Command Modes

Privileged EXEC

Usage Guidelines

When you access the member, its member number is appended to the system prompt.

Use the session command from the master to access a member switch.

Use the session command with processor 1 from the master or a standalone switch to access the internal controller. A standalone switch is always member 1.

To display switch stack compatibility information, use the show platform stack compatibility configuration command in privileged EXEC mode.

Command Default

None

Command Modes

Privileged EXEC

Usage Guidelines

Use this command only when you are working directly with your technical support representative while troubleshooting a problem. Do not use this command unless your technical support representative asks you to do so.

To display switch stack state machine and message trace feature compatibility information, use the show platform stack compatibility feature command in privileged EXEC mode.

Command Default

None

Command Modes

Privileged EXEC

Usage Guidelines

The show platform stack compatibility commands display feature incompatibility information between stack members in a mixed stack. Compatibility checks ensure that features that are supported across members of a stack using a forwarding ASIC with different capabilities will function effortlessly and error free.

Use this command only when you are working directly with your technical support representative while troubleshooting a problem. Do not use this command unless your technical support representative asks you to do so.

To display feature compatibility tables for the switch stack, use the show platform stack compatibility table command in privileged EXEC mode.

Command Default

None

Command Modes

Privileged EXEC

Usage Guidelines

The show platform stack compatibility commands display feature incompatibility information between stack members in a mixed stack. Compatibility checks ensure that features that are supported across members of a stack using a forwarding ASIC with different capabilities will function effortlessly and error free.

Use this command only when you are working directly with your technical support representative while troubleshooting a problem. Do not use this command unless your technical support representative asks you to do so.

To display platform-dependent switch-stack information, use the show platform stack manager command in privileged EXEC mode.

Command Default

None

Command Modes

Privileged EXEC

Usage Guidelines

Use this command only when you are working directly with your technical support representative while troubleshooting a problem. Do not use this command unless your technical support representative asks you to do so.

Note	This command is supported only on stacking-capable switches.

The summary information about the switch stack shows these states:

• Waiting—A switch is booting up and waiting for communication from other switches in the stack. The switch has not determined whether or not it is stack master.Stack members not participating in election remain in the waiting state until the stack master is elected and ready.
• Initializing—A switch has determined whether it is stack master. If not, the switch receives its system- and interface-level configuration from the stack master and loads it.
• Ready—The member has completed loading the system- and interface-level configurations and can forward traffic.
• Master Re-Init—The state immediately after a reelection and a different member is elected the stack master. The new stack master is reinitializing its configuration. This state applies only to the new stack master.
• Ver Mismatch—A switch in version mismatch mode. Version-mismatch mode is when a switch that joins the stack has a different stack protocol minor version number than the stack master.

A typical state transition for a stack member (including stack master) booting up is Waiting > Initializing > Ready.

A typical state transition for a stack member to stack master after an election is Ready > Master Re-Init > Ready.

A typical state transition for a stack member in version mismatch (VM) mode is Waiting > Ver Mismatch.

To display information that is related to the stack member or the switch stack, use the show switch command in EXEC mode.

Command Default

None

Command Modes

User EXEC

Privileged EXEC

Usage Guidelines

This command displays these states:

• Waiting—A switch is booting up and waiting for communication from other switches in the stack. The switch has not determined whether or not it is a stack master. Stack members not participating in a stack master election remain in the waiting state until the stack master is elected and ready.
• Initializing—A switch has determined whether it has stack master status. If it is not the stack master, it is receiving its system- and interface-level configuration from the stack master and loading it.
• Ready—The member has completed loading the system- and interface-level configurations and can forward traffic.
• Master Re-Init—The state immediately after a master reelection and a different member is elected master. The new master is reinitializing its configuration. This state applies only to the new master.
• Ver Mismatch—A switch in version mismatch mode. Version-mismatch mode is when a switch joining the stack has a different stack protocol minor version number than the master.
• SDM Mismatch—A switch in Switch Database Management (SDM) mismatch mode. SDM mismatch is when a member does not support the SDM template running on the master.
• Provisioned—The state of a preconfigured switch before it becomes an active member of a switch stack, or the state of a stack member after it has left the switch stack. The MAC address and the priority number in the display are always 0 for the provisioned switch.

A typical state transition for a stack member (including a master) booting up is Waiting > Initializing > Ready.

A typical state transition for a stack member becoming a stack master after a stack master election is Ready > Master Re-Init > Ready.

A typical state transition for a stack member in version mismatch (VM) mode is Waiting > Ver Mismatch.

You can use the show switch command to identify whether the provisioned switch exists in the switch stack. The show running-config and the show startup-config privileged EXEC commands do not provide this information.

The display also includes stack MAC-persistency wait-time if persistent MAC address is enabled.

To enable the persistent MAC address feature, use the stack-mac persistent timer command in global configuration mode on the switch stack or on a standalone switch. To disable the persistent MAC address feature, use the no form of this command.

Command Default

Persistent MAC address is disabled. The MAC address of the stack is always that of the first stack master.

When the command is entered with no value, the default time before the MAC address changes is four minutes. We recommend that you configure an explicit value for this command.

Command Modes

Global configuration

Usage Guidelines

The MAC address of the switch stack is determined by the MAC address of the stack master. In the default state (persistent MAC address disabled), if a new switch becomes stack master, the stack MAC address changes to the MAC address of the new stack master.

When persistent MAC address is enabled, the stack MAC address does not change for a time period. During that time, if the previous stack master rejoins the stack as a stack member, the stack retains its MAC address for as long as that switch is in the stack. If the previous stack master does not rejoin the stack during the specified time period, the switch stack takes the MAC address of the new stack master as the stack MAC address.

You can set the time period to be from 0 to 60 minutes.

• If you enter the command with no value, the default delay is 4 minutes.
• If you enter 0, the stack continues to use the current stack MAC address until you enter the no stack-mac persistent timer command.
• If you enter a time delay of 1 to 60 minutes, the stack MAC address of the previous stack master is used until the configured time period expires or until you enter the no stack-mac persistent timer command.

Note	When you enter the stack-mac persistent timer command with or without keywords, a message appears warning that traffic might be lost if the old master MAC address appears elsewhere in the network domain. You should use this feature cautiously.

If you enter the no stack-mac persistent timer command after a switchover, before the time expires, the switch stack moves to the current stack master MAC address.

If the whole stack reloads, when it comes back up, the MAC address of the stack master is the stack MAC address.

To disable or enable the specified stack port on the member, use the switch command in privileged EXEC mode on a stack member.

Command Default

The stack port is enabled.

Command Modes

Privileged EXEC

Usage Guidelines

A stack is in the full-ring state when all members are connected through the stack ports and are in the ready state.

The stack is in the partial-ring state when the following occurs:

• All members are connected through their stack ports but some are not in the ready state.
• Some members are not connected through the stack ports.

Note	Be careful when using the switch stack-member-number stack port port-number disable command. When you disable the stack port, the stack operates at half bandwidth.

If you enter the switch stack-member-number stack port port-number disable privileged EXEC command and the stack is in the full-ring state, you can disable only one stack port. This message appears:

Enabling/disabling a stack port may cause undesired stack changes. Continue?[confirm] 

If you enter the switch stack-member-number stack port port-number disable privileged EXEC command and the stack is in the partial-ring state, you cannot disable the port. This message appears:

Disabling stack port not allowed with current stack configuration.

To change the stack member priority value, use the switch priority command in global configuration mode on the stack master.

Command Default

The default priority value is 1.

Command Modes

Global configuration

Usage Guidelines

The new priority value is a factor when a new stack master is elected. When you change the priority value the stack master is not changed immediately.

To supply a configuration to a new switch before it joins the switch stack, use the switch provision command in global configuration mode on the stack master. To delete all configuration information that is associated with the removed switch (a stack member that has left the stack), use the no form of this command.

Command Default

The switch is not provisioned.

Command Modes

Global configuration

Usage Guidelines

For type, enter the model number of a supported switch that is listed in the command-line help strings.

To avoid receiving an error message, you must remove the specified switch from the switch stack before using the no form of this command to delete a provisioned configuration.

To change the switch type, you must also remove the specified switch from the switch stack. You can change the stack member number of a provisioned switch that is physically present in the switch stack if you do not also change the switch type.

If the switch type of the provisioned switch does not match the switch type in the provisioned configuration on the stack, the switch stack applies the default configuration to the provisioned switch and adds it to the stack. The switch stack displays a message when it applies the default configuration.

Provisioned information appears in the running configuration of the switch stack. When you enter the copy running-config startup-config privileged EXEC command, the provisioned configuration is saved in the startup configuration file of the switch stack.

Caution

When you use the switch provision command, memory is allocated for the provisioned configuration. When a new switch type is configured, the previously allocated memory is not fully released. Therefore, do not use this command more than approximately 200 times, or the switch will run out of memory and unexpected behavior will result.

To change the stack member number, use the switch renumber command in global configuration mode on the stack master.

Command Default

The default stack member number is 1.

Command Modes

Global configuration

Usage Guidelines

If another stack member is already using the member number that you just specified, the stack master assigns the lowest available number when you reload the stack member.

Note	If you change the number of a stack member, and no configuration is associated with the new stack member number, that stack member loses its current configuration and resets to its default configuration.

Do not use the switch current-stack-member-number renumber new-stack-member-number command on a provisioned switch. If you do, the command is rejected.

Use the reload slot current stack member number privileged EXEC command to reload the stack member and to apply this configuration change.

To set the switch stack port speed to 10 Gbps and enable mixed stacking with one or more Catalyst 2960-S switches, use the switch stack port-speed 10 command in global configuration mode. To return to the default setting, use the no form of this command.

Syntax Description

This command has no keywords or arguments.

Command Default

The default port speed is 20 Gbps.

Usage Guidelines

By default, Catalyst 2960-X switches operate at a port speed of 20 Gbps while 2960-S switches have a maximum port speed of 10 Gbps. In a mixed stack of Catalyst 2960-X and Catalyst 2960-S switches, the stack must operate at the port speed of the Catalyst 2960-S switch; otherwise, the switches will not stack.

To set the port speed of the stack to 10 Gbps, use the switch stack port-speed 10 global configuration command on a Catalyst 2960-X stack member before you add a Catalyst 2960-S switch to the stack, and then reload the stack.