Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

show system switchover

Syntax

Syntax (TX Matrix Router)

Syntax (TX Matrix Plus Router)

Syntax (MX Series Router)

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 primary Routing Engine because the kernel-replication process daemon does not run on the primary 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 primary 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 primary Routing Engine of the TX Matrix router (or switch-card chassis), the CLI displays graceful switchover information for the primary 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 primary Routing Engine of a TX Matrix Plus router (or switch-fabric chassis), the CLI displays output for the primary 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 primary 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

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 primary).

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

Platform Components

Platform Components:

FEB1:

  • Not Online—The backup FEB2 is not yet online.

  • Online—The backup FEB2 is online.

FEB1-PFE0, FEB1- PFE1:

  • Ready—Message for FEB1- PFE0, or FEB1- PFE1 being switchover ready. The backup PFE is ready for switchover (does not include time for routes or nexthops for a scaled configuration).

  • Not Online—The backup PFE is not yet online.

  • Sync In Progress—Two-minute synchronization in progress when information flow data-path is programmed on the backup PFE (does not include time for routes or next-hops programming).

Sample Output

show system switchover (Backup Routing Engine - Ready)

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:

show system switchover (Backup Routing Engine - Not Ready)

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 primary role switch, try after xxx secs, for example:

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

show system switchover (ACX7509)

The switchover status option for ACX7509 is only available on backup Routing Engine. The show outputs displayed system switchover status is "Ready" and "Not Ready" are as follows:

show system switchover (Backup Routing Engine - Junos OS Evolved)

Release Information

Command introduced before Junos OS Release 7.4.

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

Command support added for ACX7509 in 22.1R1 for High Availability Platform Redundancy RCB and FEB switchover.

Related Documentation