Technical Documentation

Downloads
bypassStatus Command Reference

bypassStatus Command Reference

Syntax

bypassStatus interval iterations

Description

Displays status of internal bypass processes.

Options

Table 1 describes bypassStatus options and arguments and provides examples of command syntax.

Table 1: Command Reference: bypassStatus

Options	Usage and Examples
[none]	Displays the status of the NIC bypass daemon, settings for the watchdog timer, and the status of traffic interfaces. For an overview of the NIC bypass feature, see the IDP Concepts and Examples Guide. The watchdog timer setting and watchdog loop interval are default settings in the `idp.cfg` file. You should not change these settings unless advised to do so by JTAC. The current state reported is Normal when the operating system is available and the virtual router receives its reset signal from the interface within the threshold (3 seconds); NICs off or Bypass when the timer has not received its reset signal within the threshold. The following example shows the output of the bypassStatus command on IDP200, IDP600, and IDP1100 appliances: `[root@localhost ~]# bypassStatus` BYPASS STATUS: Wed Apr 8 10:11:43 PDT 2009 Status for nicBypass daemon : on Watchdog timer setting(sec) : 3 Watchdog loop reset interval(sec): 200000 NIC Status Current State WD Time Left(ms) --------------------------------------------------------------- eth2,eth3 ENABLED Normal 2548 eth4,eth5 ENABLED Normal 2580 eth6,eth7 ENABLED Normal 2836 eth8,eth9 ENABLED Normal 3108 eth10,eth11 ENABLED Normal 2036 [root@localhost ~]# Note: The watchdog loop reset interval is 200,000 microseconds, not seconds.
	The following examples show the output of the bypassStatus command on IDP75, IDP250, IDP800, and IDP8200 appliances: `[root@idp51 ~]# bypassStatus` BYPASS STATUS: Wed Apr 8 10:08:38 PDT 2009 Status for nicBypass daemon : on Watchdog timer setting(sec) : 3 Watchdog loop reset interval(sec): 200000 NIC Current State --------------------------------------------------------------- eth2,eth3 Normal or NICs off eth4,eth5 Normal eth6,eth7 Normal eth12,eth13 Normal eth14,eth15 Normal [root@idp51 ~]# `[root@defaulthost ~]# bypassStatus` BYPASS STATUS: Wed Mar 4 14:47:01 IST 2009 Status for nicBypass daemon : off Watchdog timer setting(sec) : 3 Watchdog loop reset interval(sec): 200000 NIC Current State --------------------------------------------------------------- eth2,eth3 Bypass or NICs off eth4,eth5 Bypass or NICs off eth6,eth7 Bypass or NICs off eth10,eth11 Bypass or NICs off eth12,eth13 Normal Note: Due to a hardware limitation, the bypassStatus command does not report status or the watchdog timer time left for IDP75, IDP250, IDP800, and IDP8200 appliances.
interval	Specifies a number of seconds at which to refresh the status display. The status is updated every interval seconds until you press Ctrl-C. `[root@defaulthost admin]# bypassStatus 3`
iterations	If you specify an interval, you can also specify a number of iterations after which the status display exits and returns to the command prompt. `[root@defaulthost admin]# bypassStatus 3 3` BYPASS STATUS: Wed Oct 22 18:47:03 EDT 2008 Status for nicBypass daemon : on Watchdog timer setting(sec) : 3 Watchdog loop reset interval(sec): 200000 NIC Status Current State WD Time Left(ms) --------------------------------------------------------------- eth2,eth3 ENABLED Normal 3110 eth4,eth5 disabled Normal (wdt inactive) eth6,eth7 disabled Normal (wdt inactive) eth8,eth9 disabled Normal (wdt inactive) eth10,eth11 disabled Normal (wdt inactive) --------------------------------------------------------------- eth2,eth3 ENABLED Normal 3060 eth4,eth5 disabled Normal (wdt inactive) eth6,eth7 disabled Normal (wdt inactive) eth8,eth9 disabled Normal (wdt inactive) eth10,eth11 disabled Normal (wdt inactive) --------------------------------------------------------------- eth2,eth3 ENABLED Normal 3000 eth4,eth5 disabled Normal (wdt inactive) eth6,eth7 disabled Normal (wdt inactive) eth8,eth9 disabled Normal (wdt inactive) eth10,eth11 disabled Normal (wdt inactive)

Additional Information

Due to a hardware limitation with IDP800 and IDP8200 I/O modules, the current state reported by the bypassStatus command is ambiguous for these interfaces. A bypass NIC has two physical states: on or off. The programmed behavior supports three possibilities: normal, bypass, or NICs off.

For fiber interfaces, the bypassStatus command reliably reports Bypass when the NIC is in bypass state. It reports Normal or NICSs off when not in bypass.

For copper interfaces, the bypassStatus command reliably reports Normal during normal operations. It reports Bypass or NICSs off when not normal.

When using the bypassStatus command, we recommend you refresh your recollection of your NIC state settings and use logs to disambiguate the bypassStatus output. For example, if you know you have not configured NICs off but instead always use Bypass, you can disambiguate the status. In addition, when you shutdown the IDP appliance, it sends a log to NSM that clearly indicates the action to change NIC state to your specified setting.