A.2 rvnetstat command

[Name]

rvnetstat - Displays the state of virtual NICs of the virtual NIC mode

[Synopsis]

/opt/FJSVrvnet/bin/rvnetstat [-s] [-n fjvnet-link] [-o field[,...] [-p]] [-v]

[Feature description]

The rvnetstat command displays the current status of virtual NICs used in the virtual NIC mode: operation status, interface status, and monitoring status.

[Options]

The following options can be specified.

-s

The -s option displays the status of the interface bundled by a virtual NIC and its monitoring status.

Information

The monitoring is shared in the virtual interface which bundles the same physical NIC in the same order.
The status of the representative virtual interface is displayed when there are multiple virtual interfaces which bundle the same physical NIC in the same order, and also the virtual interfaces are not specified with the -n option.

-n fjvnet-link: Specify a virtual NIC to deal with. If this option is omitted, the entire virtual interfaces will be selected.

-o field[,...]: Specify the output field by listing delimited with a comma (,). If this option is omitted, the print command displays all the fields. This option cannot be used with the -s option at the same time.

-p: Output the field order specified with the -o option for each output line. Use a space () as the delimiter between values.

-v

Output the detailed information.

[Without -s option specified (operation status)]

Field		Description
VNET		The name of the virtual NIC.
STATE	active	The virtual NIC is active. (The virtual interface is in use.)
STATE	inactive	The virtual NIC is inactive. (The virtual interface is not in use.)
MODE	MAC-TRACK	Communicating with "MAC Tracking."
MODE	ACT-STANDBY	Communicating with "Active-Standby."
ACTIVE-LINK		The active interfaces bundled by a virtual NIC.
MAC-ADDR (Displays only when the -v option is specified.)		MAC address of a virtual NIC.

[With -s option specified (interface status)]

Field		Description
Monitoring Function	enable	The network monitoring function is enabled.
Monitoring Function	disable	The network monitoring function is disabled.
Monitoring Status	active	The network monitoring function operates normally.
	fail	The network monitoring function detects a failure.
	inactive	The network monitoring function is inactive.
Reachability	{LINK1,LINK2,...}	Displays the reachability of a heartbeat message between interfaces. Displays the reachable interface groups of heartbeat messages. Interfaces with link down are not displayed.
Reachability	----	Displays interfaces when the network monitoring function is disabled.
LINK		The interfaces bundled by a virtual NIC.
STATUS	active	Activated state Displays the status if the interface is in operation mode.
	standby	Standby state Displays the status if the interface is in standby mode.
	disconnect	Disconnected state Displays the status if the interface is disconnected temporarily by the rvnetadm disconnect command.
	fail	Failure detection state Displays the status if a failure is detected in the interface by the link down monitoring function.
	unknown	Unknown state Displays the status if the interface is unable to obtain its link status or there is no IP interface on the virtual NIC right after starting the operating system.
IF-LINK (Displays only when the -v option is specified)	up	Link up state Displays the status if the link state of the interface is in the up state.
	down	Link down state Displays the status if the link state of the interface is in the down state.
	unknown	Link state is unknown Displays the status if the link state of the interface is in the unknown state.

The following shows the display format used when no option is specified.

# /opt/FJSVrvnet/bin/rvnetstat
 VNET               STATE     MODE         ACTIVE-LINK
+------------------+---------+------------+-----------------------------------------+
 fjvnet0            active    ACT-STANDBY  net0
 fjvnet1            active    MAC-TRACK    net0,net1

The following shows the display format when the -v option and fjvnet0 are specified.

# /opt/FJSVrvnet/bin/rvnetstat -n fjvnet0 -v
 VNET               STATE     MODE         MAC-ADDR           ACTIVE-LINK
+------------------+---------+------------+------------------+----------------------+
 fjvnet0            active    ACT-STANDBY  2:11:22:33:44:55   net0

The following shows an example of the configuration status of the virtual interface.

Example) Configuration status of the virtual interface

Virtual NIC	Physical NIC	Network monitoring status	Link status
fjvnet0	net0, net1	Normal	Link up state
fjvnet1	net1, net2	Failure	Link down state
fjvnet2	net1, net2	Failure	Link down state
fjvnet3	net3, net4	Failure	Link up state
fjvnet4	net5, net6	Stop	A disconnected NIC exists.
fjvnet5	net6	Stop	Link up state

[Example when the -s option is specified]

# /opt/FJSVrvnet/bin/rvnetstat -s

Monitoring Function : enable


[fjvnet0]
 Monitoring Status  : active
 Reachability       : {net0, net1}

 LINK               STATUS
+------------------+----------+
 net0               active
 net1               standby

[fjvnet1, fjvnet2]
 Monitoring Status  : fail
 Reachability       : {net1}

 LINK               STATUS
+------------------+----------+
 net1               active
 net2               fail

[fjvnet3]
 Monitoring Status  : fail
 Reachability       : {net3},{net4}

 LINK               STATUS
+------------------+----------+
 net3               active
 net4               active

[fjvnet4]
 Monitoring Status  : inactive
 Reachability       : ----

 LINK               STATUS     
+------------------+----------+
 net5               disconnect
 net6               active

[fjvnet5]
 Monitoring Status  : inactive
 Reachability       : ----

 LINK               STATUS
+------------------+----------+
 net6               active

[Example when the -s option and -v option are specified]

# /opt/FJSVrvnet/bin/rvnetstat -s -v

Monitoring Function : enable


[fjvnet0]
 Monitoring Status  : active
 Reachability       : {net0, net1}

 LINK               STATUS     IF-LINK
+------------------+----------+-------+
 net0               active     up
 net1               standby    up

[fjvnet1, fjvnet2]
 Monitoring Status  : fail
 Reachability       : {net1}

 LINK               STATUS     IF-LINK
+------------------+----------+-------+
 net1               active     up
 net2               fail       down

[fjvnet3]
 Monitoring Status  : fail
 Reachability       : {net3},{net4}

 LINK               STATUS     IF-LINK
+------------------+----------+-------+
 net3               active     up
 net4               active     up

[fjvnet4]
 Monitoring Status  : inactive
 Reachability       : ----

 LINK               STATUS     IF-LINK
+------------------+----------+-------+
 net5               disconnect unknown
 net6               active     up

[fjvnet5]
 Monitoring Status  : inactive
 Reachability       : ----

 LINK               STATUS     IF-LINK
+------------------+----------+-------+
 net6               active     up