Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

show system switchover

 

List of Syntax

Syntax

Syntax (TX Matrix Router)

Syntax (TX Matrix Plus Router)

Syntax (MX Series Router)

Syntax

Syntax (TX Matrix Router)

Syntax (TX Matrix Plus Router)

Syntax (MX Series Router)

Release Information

Command introduced before Junos OS Release 7.4.

Command introduced in Junos OS Release 9.0 for EX Series switches.

sfc option introduced for the TX Matrix Plus router in Junos OS Release 9.6.

Command introduced in Junos OS Release 13.2X51-D20 for QFX Series switches.

Description

Display whether graceful Routing Engine switchover is configured, the state of the kernel replication (ready or synchronizing), any replication errors, and whether the primary and standby Routing Engines are using compatible versions of the kernel database.

Note

Issue the show system switchover command only on the backup Routing Engine. This command is not supported on the master Routing Engine because the kernel-replication process daemon does not run on the master Routing Engine. This process runs only on the backup Routing Engine.

Beginning Junos OS Release 9.6, the show system switchover command has been deprecated on the master Routing Engine on all routers other than a TX Matrix (switch-card chassis) or a TX Matrix Plus (switch-fabric chassis) router.

However, in a routing matrix, if you issue the show system switchover command on the master Routing Engine of the TX Matrix router (or switch-card chassis), the CLI displays graceful switchover information for the master Routing Engine of the T640 routers (or line-card chassis) in the routing matrix. Likewise, if you issue the show system switchover command on the master Routing Engine of a TX Matrix Plus router (or switch-fabric chassis), the CLI displays output for the master Routing Engine of T1600 or T4000 routers in the routing matrix.

Options

all-chassis(TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix router, display graceful Routing Engine switchover information for all Routing Engines on the TX Matrix router and the T640 routers configured in the routing matrix. On a TX Matrix Plus router, display graceful Routing Engine switchover information for all Routing Engines on the TX Matrix Plus router and the T1600 or T4000 routers configured in the routing matrix.
all-lcc(TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix router, display graceful Routing Engine switchover information for all T640 routers (or line-card chassis) connected to the TX Matrix router. On a TX Matrix Plus router, display graceful Routing Engine switchover information for all connected T1600 or T4000 LCCs.

Note that in this instance, packets get dropped. The LCCs perform GRES on their own chassis (GRES cannot be handled by one particular chassis for the entire router) and synchronization is not possible as the LCC plane bringup time varies for each LCC. Therefore, when there is traffic on these planes, there may be a traffic drop.

all-members(MX Series routers only) (Optional) Display graceful Routing Engine switchover information for all Routing Engines on all members of the Virtual Chassis configuration.
lcc number(TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix router, display graceful Routing Engine switchover information for a specific T640 router connected to the TX Matrix router. On a TX Matrix Plus router, display graceful Routing Engine switchover information for a specific router connected to the TX Matrix Plus router.

Replace number with the following values depending on the LCC configuration:

  • 0 through 3, when T640 routers are connected to a TX Matrix router in a routing matrix.

  • 0 through 3, when T1600 routers are connected to a TX Matrix Plus router in a routing matrix.

  • 0 through 7, when T1600 routers are connected to a TX Matrix Plus router with 3D SIBs in a routing matrix.

  • 0, 2, 4, or 6, when T4000 routers are connected to a TX Matrix Plus router with 3D SIBs in a routing matrix.

local(MX Series routers only) (Optional) Display graceful Routing Engines switchover information for all Routing Engines on the local Virtual Chassis member.
member member-id(MX Series routers only) (Optional) Display graceful Routing Engine switchover information for all Routing Engines on the specified member of the Virtual Chassis configuration. Replace member-id with a value of 0 or 1.
scc(TX Matrix router only) (Optional) Display graceful Routing Engine switchover information for the TX Matrix router (or switch-card chassis).
sfc(TX Matrix Plus routers only) (Optional) Display graceful Routing Engine switchover information for the TX Matrix Plus router.

Additional Information

If you issue the show system switchover command on a TX Matrix backup Routing Engine, the command is broadcast to all the T640 backup Routing Engines that are connected to it.

Likewise, if you issue the show system switchover command on a TX Matrix Plus backup Routing Engine, the command is broadcast to all the T1600 or T4000 backup Routing Engines that are connected to it.

If you issue the show system switchover command on the active Routing Engine in the master router of an MX Series Virtual Chassis, the router displays a message that this command is not applicable on this member of the Virtual Chassis.

Required Privilege Level

view

List of Sample Output

show system switchover (Backup Routing Engine - Ready)

show system switchover (Backup Routing Engine - Not Ready)

show system switchover all-lcc (Routing Matrix and Routing Matrix Plus)

Output Fields

Table 1 describes the output fields for the show system switchover command. Output fields are listed in the approximate order in which they appear.

Table 1: show system switchover Output Fields

Field Name

Field Description

Graceful switchover

Display graceful Routing Engine switchover status:

  • On—Indicates graceful-switchover is specified for the routing-options configuration command.

  • Off—Indicates graceful-switchover is not specified for the routing-options configuration command.

Configuration database

State of the configuration database:

  • Ready—Configuration database has synchronized.

  • Synchronizing—Configuration database is synchronizing. Displayed when there are updates within the last 5 seconds.

  • Synchronize failed—Configuration database synchronize process failed.

Kernel database

State of the kernel database:

  • Ready—Kernel database has synchronized. This message implies that the system is ready for GRES.

  • Synchronizing—Kernel database is synchronizing. Displayed when there are updates within the last 5 seconds.

  • Version incompatible—The primary and standby Routing Engines are running incompatible kernel database versions.

  • Replication error—An error occurred when the state was replicated from the primary Routing Engine. Inspect Steady State for possible causes, or notify Juniper Networks customer support.

Peer state

Routing Engine peer state:

This field is displayed only when ksyncd is running in multichassis mode (LCC master).

  • Steady State—Peer completed switchover transition.

  • Peer Connected—Peer in switchover transition.

Switchover Status

Switchover Status:

  • Ready—Message for system being switchover ready.

  • Not Ready—Message for system not being ready for switchover.

Sample Output

show system switchover (Backup Routing Engine - Ready)

user@host> show system switchover

Switchover Status: Ready is the way the last line of the output reads if you are running Junos OS Release 16.1R1 or later. If you are running Junos OS Release 15.x, the last line of the output reads as Switchover Ready, for example:

user@host> show system switchover

show system switchover (Backup Routing Engine - Not Ready)

user@host> show system switchover

Switchover Status: Not Ready is the way the last line of the output reads if you are running Junos OS Release 16.1R1 or later. If you are running Junos OS Release 15.x, the last line of the output reads as Not ready for mastership switch, try after xxx secs, for example:

user@host> show system switchover

show system switchover all-lcc (Routing Matrix and Routing Matrix Plus)

user@host> show system switchover all-lcc