[Name]
rvnetadm - Manages virtual NICs
[Synopsis]
/opt/FJSVrvnet/bin/rvnetadm command [args]
[Feature description]
The rvnetadm command creates and deletes virtual NICs used in the virtual NIC mode. This command also adds and deletes links.
command | Process outline | Authority | |
|---|---|---|---|
Super user | General user | ||
Creates a virtual NIC | Y | - | |
Deletes a virtual NIC | Y | - | |
Adds a NIC that configure a virtual NIC | Y | - | |
Deletes a NIC that configure a virtual NIC | Y | - | |
Configures the actual NIC assigned under the virtual NIC for operation | Y | - | |
Displays the configuration definition of the virtual NIC | Y | Y | |
Sets the properties of the virtual NIC | Y | - | |
Displays the properties of the virtual NIC | Y | Y | |
Sets common parameters of the virtual NIC | Y | - | |
Displays common parameters of the virtual NIC | Y | Y | |
Reconnects a NIC to configure the virtual NIC | Y | - | |
Temporal disconnection of a NIC to configure the virtual NIC | Y | - | |
Enables the network monitoring function of the virtual NIC | Y | - | |
Disables the network monitoring function of the virtual NIC | Y | - | |
Displays version information | Y | Y | |
Note
Tagged VLAN interfaces (net2001, net4001002, etc.) cannot be configured under the virtual NIC.
Information
NICs that are possible to configure under the virtual NIC must correspond to GLDv3. The following shows the applicable types of interface:
Physical interfaces (net0, net1, etc.)
Link aggregation (with LACP) interfaces (aggr0, aggr1, etc.)
(1) create command
The create command creates a virtual NIC used in the virtual NIC mode. The configuration information is created after creating the virtual NIC. The following is the format of the create command:
/opt/FJSVrvnet/bin/rvnetadm create -n fjvnet-link [-i interface1[,interface2]] [-a MAC-address] [-v yes|no]
Specify the name of a new virtual NIC to be created. Specify the name of a virtual NIC begins with a string of arbitrary characters and is followed by a value (0 to 255) (such as fjvnet0,fjvnet10, etc.).
Note
Do not use "sha" for the name of the interfaces.
Specify a name different from that of the other interfaces.
Do not change a name with the dladm rename-link command after setting the name.
Use the rvnetadm delete command for deleting a virtual NIC. Do not use the dladm delete-vnic command.
Specify the interfaces to be bundled by a virtual NIC. Specify more than one interface, by listing them delimited with a comma (,).
Specify a MAC address to be allocated to the virtual NIC. Specify a MAC address used in the virtual NIC to MAC-address directly. Since the MAC addresses of the virtual NIC are automatically generated, normally specifying them to MAC-address is not necessary. However, if necessary, set the address which does not overlap with the assigned MAC address as follows:
Other virtual NICs
Physical NICs
Other nodes on the same segment
Possible format of MAC address is as follows:
XX:XX:XX:XX:XX:XX
Specify XX in a hexadecimal code and separated by colons (:).
Note
Multicast and broadcast addresses cannot be specified as a MAC address.
If a MAC address is not specified to a virtual NIC, a MAC address is automatically generated at OS startup. If you want to fix the MAC address, specify it with the -a option.
Specify whether to permit the creation of vnic on a virtual interface. The initial setting value is set to "no" so that the creation is not permitted. To connect a virtual interface to the virtual switch in the Oracle VM environment, set "yes" to permit the creation.
Note
When a network monitoring function is enabled, disable it with the rvnetadm stop-observ command, and then enable it again with the rvnetadm start-observ command.
(2) delete command
The delete command deletes a virtual NIC used in the virtual NIC mode. The configuration information is deleted after deleting the virtual NIC.
The following is the format of the delete command:
/opt/FJSVrvnet/bin/rvnetadm delete -n fjvnet-link
Note
Perform the following setting before executing this command:
When an IP interface which links to the virtual NIC exists.
Delete the IP interface with the ipadm delete-ip command.
When a network monitoring function is enabled.
Disable the network monitoring function with the rvnetadm stop-observ command.
After executing this command, enable the network monitoring function with the rvnetadm start-observ command.
If the case is both a. and b., perform a. first.
Specify the virtual NIC to be deleted.
(3) add-if command
The add-if command adds an interface to the virtual NIC. The configuration information is updated after adding the interface.
The following is the format of the add-if command:
/opt/FJSVrvnet/bin/rvnetadm add-if -n fjvnet-link -i interface
Note
When a network monitoring function is enabled, disable it with the rvnetadm stop-observ command, and then execute this command.
After executing this command, enable the network monitoring function with the rvnetadm start-observ command.
Specify the name of the virtual NIC.
Specify an interface to be added to the virtual NIC.
(4) remove-if command
The remove-if command deletes an interface from the virtual NIC. The configuration information is updated after deleting the interface.
The following is the format of the remove-if command:
/opt/FJSVrvnet/bin/rvnetadm remove-if -n fjvnet-link -i interface
Note
When a network monitoring function is enabled, disable it with the rvnetadm stop-observ command, and then execute this command.
After executing this command, enable the network monitoring function with the rvnetadm start-observ command.
Specify the name of the virtual NIC.
Specify an interface to be deleted from the virtual NIC.
(5) set-if command
The set-if command converts the status of a NIC assigned under the virtual NIC, from "Standby" to "Active." This enables the interface for communication. When the communication mode is in "Active-Standby", specifying the "Standby" state interface converts to that of "Active" state. Otherwise, the interface currently in the "Active" state converts to the "Standby" state.
When the communication mode is "MAC Tracking," the setting above cannot be performed.
The following is the format of the set-if command:
/opt/FJSVrvnet/bin/rvnetadm set-if -n fjvnet-link -i interface
Specify the name of the virtual NIC.
Specify an interface used for communication when the communication mode is in "Active-Standby."
Note
Check the status of the NIC assigned under virtual NIC and the virtual NIC by using the rvnetstat command before executing the command. For details, see "A.2 rvnetstat command."
(6) print command
The print command displays the current configuration information. The following is the format of the print command:
/opt/FJSVrvnet/bin/rvnetadm print [-n fjvnet-link] [-o field[,...] [-p]]
Specify the name of the virtual NIC. If this option is omitted, the print command displays all the virtual NICs.
Specify the output field by listing delimited with a comma (,). If this option is omitted, the print command displays all the fields.
Output the field order specified with the -o option for each output line. Use a space () as the delimiter between values.
Field | Description |
|---|---|
VNET | The name of the virtual NIC. |
MAC-ADDR | MAC address of the virtual NIC |
LINK | The interfaces bundled by a virtual NIC. |
The following shows an example of the configuration information.
# /opt/FJSVrvnet/bin/rvnetadm print VNET MAC-ADDR LINK +---------------+------------------+---------------------------+ fjvnet0 auto net0,net1 fjvnet1 2:34:56:78:90:12 net2,net3
The following shows an example of the virtual NIC name when "fjvnet1" is specified.
# /opt/FJSVrvnet/bin/rvnetadm print -n fjvnet1 VNET MAC-ADDR LINK +---------------+------------------+---------------------------+ fjvnet1 2:34:56:78:90:12 net2,net3
The following shows an example of the configuration information when the -o option is specified.
# /opt/FJSVrvnet/bin/rvnetadm print -o VNET,LINK VNET LINK +---------------+-------------------------------+ fjvnet0 net0,net1 fjvnet1 net2,net3
The following shows an example of the configuration information when the -o option and -p option are specified.
# /opt/FJSVrvnet/bin/rvnetadm print -o VNET,LINK -p fjvnet0 net0,net1 fjvnet1 net2,net3
(7) set-prop command
The set-prop command changes the properties of the virtual NIC. The configuration information is changed after changing the properties of the virtual NIC.
The following is the format of the set-prop command.
/opt/FJSVrvnet/bin/rvnetadm set-prop -n fjvnet-link [-a MAC-address] [-m on|off] [-l yes|no] [-p b|r] [-u bytes] [-v yes|no]
Specify the virtual NIC name which the properties are to be changed.
Specify a MAC address to be allocated to the virtual NIC. Specify a MAC address used in the virtual NIC to MAC-address directly. Since the MAC addresses of the virtual NIC are automatically generated, normally specifying them to MAC-address is not necessary. However, if necessary, set the address which does not overlap with the assigned MAC address as follows:
Other virtual NICs
Physical NICs
Other nodes on the same segment
Possible format of MAC address is as follows:
XX:XX:XX:XX:XX:XX
Specify XX in a hexadecimal code and separated by colons (:).
Note
Multicast and broadcast addresses cannot be specified as a MAC address.
Before executing the set-prop command, make sure the virtual NIC is inactive. For the procedure to inactivate the virtual NIC, see "3.4 Notes on setting a configuration."
When changing to auto configuration (auto) after specifying the MAC address, delete the Virtual NIC once and create it again.
Set the operation for "MAC Tracking." Initial value is set to "MAC Tracking" enabled (on).
Note
When a network monitoring function is enabled, disable it with the rvnetadm stop-observ command, and then execute this command.
After executing this command, enable the network monitoring function with the rvnetadm start-observ command.
This enables the communication that tracks a destination MAC address automatically according to the result of the network monitoring. Normally, the communication is carried out in "Active-Standby". When the network monitoring function detects a failure, the communication is carried out in "MAC Tracking."
"Active-Standby" is used all the time. Network monitoring of the specified virtual NIC is stopped.
Configure enable/disable Link Status Propagation of the virtual NIC. Initial value is set to Link Status Propagation disabled (no).
The change of the link status for interfaces bundled by a virtual NIC propagates to the link status of the virtual NIC. Enabling this setting will bring the virtual NIC's link status to fail when all the bundled interfaces are linked down.
The change of the link status for interfaces bundled by a virtual NIC does not propagate to the link status of the virtual NIC. To maintain the communication between zones in case of a link down occurred in a physical NIC, set Link Status Propagation to "no."
When performing communication via "MAC Tracking," the method for sending packets is according to the following cases: the MAC address that coincides with a destination MAC address has not learned, or the destination MAC address is a broadcast or multicast address. Initial value is set to the round robin system (r).
Copy the packets and simultaneously send from all the NICs.
In broadcast system, received packets may overlap because the same packet is sent from two or more interfaces. (*) The waiting time to send packet is faster than that of round robin mode. If the application cannot allow any overlapped receiving, use the round robin mode.
(*) It occurs when there are two or more servers adopted the virtual NIC mode exist and send UDP-based packets to the broadcast or multicast destination.
Send packets evenly-divided between NICs.
Though round robin mode takes time to send packets, use this mode if the application cannot allow overlapped receiving.
Changed the MTU value of a virtual interface. The default of the MTU value is 1500.
The MTU value of a virtual interface should be specified not to exceed the MTU value of the interfaces bundled by the virtual interface.
When the MTU value is different between the interfaces bundled by the virtual interface.
The maximum value of the MTU is the minimum value of the MTU among the interfaces bundled by the virtual interface.
When creating only for the virtual interface instead of specifying the interfaces bundled by the virtual interface.
The MTU value should be specified in the range of 64 to 65535.
When the bundled interfaces are shared by multiple virtual interfaces.
Specify the MTU value for each virtual NIC.
Point
Set the MTU value of the interfaces bundled by a virtual interface with the set-linkprop subcommand of dladm(1M). At the time, the MTU value of the interfaces should not be bundled by a virtual interface.
Note
Do not change the MTU value of the virtual interface with the set-linkprop subcommand of dladm(1M).
The following shows the example of changing the MTU value during the virtual NIC creation:
# /usr/sbin/dladm set-linkprop -p mtu=9000 net1 # /usr/sbin/dladm set-linkprop -p mtu=9000 net2 # /opt/FJSVrvnet/bin/rvnetadm create -n fjvnet0 -i net1,net2 # /opt/FJSVrvnet/bin/rvnetadm set-prop -n fjvnet0 -u 9000
The following shows the example of changing the MTU value after the virtual NIC creation:
# /opt/FJSVrvnet/bin/rvnetadm disconnect -i net1 # /usr/sbin/dladm set-linkprop -p mtu=9000 net1 # /opt/FJSVrvnet/bin/rvnetadm connect -i net1 # /opt/FJSVrvnet/bin/rvnetadm disconnect -i net2 # /usr/sbin/dladm set-linkprop -p mtu=9000 net2 # /opt/FJSVrvnet/bin/rvnetadm connect -i net2 # /opt/FJSVrvnet/bin/rvnetadm set-prop -n fjvnet0 -u 9000
Specify whether to permit the creation of vnic on a virtual interface. The initial setting value is set to "no" so that the creation is not permitted. To connect a virtual interface to the virtual switch in the Oracle VM environment, set "yes" to permit the creation. The setting change will be enabled after the OS is restarted next time.
(8) show-prop
The show-prop command displays the properties of a specified virtual NIC.
The following is the format of the show-prop command.
/opt/FJSVrvnet/bin/rvnetadm show-prop -n fjvnet-link
Specify the virtual NIC name which the properties are to be displayed.
Field | Description | |
|---|---|---|
VNET | The name of the virtual NIC. | |
MAC-ADDRESS | MAC address of the virtual NIC. | |
PROPAGATE-LINK | yes | Link Status Propagation is enabled. |
no | Link Status Propagation is disabled. | |
MAC-TRACKING | on | "MAC Tracking" is enabled. |
off | "MAC Tracking" is disabled. | |
PROBE-MODE | broadcast | Broadcast mode |
round-robin | Round robin mode | |
MTU | MTU value | |
ALLOW-UPPER-VNIC | yes | VNIC creation on a virtual interface is permitted. |
no | VNIC creation on a virtual interface is not permitted. | |
The flowing shows an example of the properties of a virtual NIC.
# /opt/FJSVrvnet/bin/rvnetadm show-prop -n fjvnet0 VNET : fjvnet0 MAC-ADDRESS : auto PROPAGATE-LINK : no MAC-TRACKING : on PROBE-MODE : round-robin MTU : 1500 ALLOW-UPPER-VNIC : no
(9) set-param command
The set-param command sets the common parameter of the virtual NIC.
The following is the format of the set-param command.
/opt/FJSVrvnet/bin/rvnetadm set-param [-i sec] [-c times] [-r times] [-d sec]
Specify the monitoring interval of the network monitoring function in seconds. A value from 1 to 100 can be specified (note that the product of sec and times must be 100 or less). Initially, 3 (seconds) is specified.
Specify the monitoring count of the network monitoring function. A value from 1 to 100 can be specified (note that the product of sec and times must be 100 or less). Initially, 3 (times) is specified.
Specify the count for recovery of the network monitoring function to be detected. A value from 1 to 100 can be specified. Initially, 1 (time) is specified.
Specify the time for error detection delay time of the network monitoring function. A value from 1 to 100 can be specified. Initially, 45 (seconds) is specified. In addition, if the value of the -d delay is less than the product of -i option and -c option, this option is ignored.
(10) show-param command
The show-param command displays the current common parameter of the virtual NIC.
The following is the format of the show-param command.
/opt/FJSVrvnet/bin/rvnetadm show-param
Field | Description |
|---|---|
INTERVAL(sec) | Monitoring interval of the network monitoring function. |
FAIL-DETECTION(times) | Frequency of error monitoring in the network monitoring function. |
REPAIR-DETECTION(times) | Frequency of recovery monitoring in the network monitoring function. |
DELAY-TIME(sec) | Error detection delay time of the network monitoring function. |
The following shows an example of the common parameter.
# /opt/FJSVrvnet/bin/rvnetadm show-param INTERVAL(sec) : 3 FAIL-DETECTION(times) : 3 REPAIR-DETECTION(times) : 1 DELAY-TIME(sec) : 45
(11) connect command
The connect command reconnects a disconnected interface. This does not reflect the configuration information.
The following is the format of the connect command.
/opt/FJSVrvnet/bin/rvnetadm connect [-n fjvnet-link] -i interface
Specify the name of the virtual NIC. If this option is omitted, the entire virtual interfaces will be selected.
Specify an interface to be reconnected.
Note
By using the rvnetstat command, check that the interface to be dealt with is "disconnect" before executing the connect command. For details, see "A.2 rvnetstat command."
(12) disconnect command
The disconnect command disconnects an interface temporarily, and then set its state to unused. This action is not reflected in the configuration information.
The following is the format of the disconnect command.
/opt/FJSVrvnet/bin/rvnetadm disconnect [-n fjvnet-link] -i interface
Specify the name of the virtual NIC. If this option is omitted, the entire virtual interfaces will be selected.
Specify an interface to be disconnected.
(13) start-observ command
The start-observ command enables the network monitoring function of the virtual NIC.
The following is the format of the start-observ command.
/opt/FJSVrvnet/bin/rvnetadm start-observ
(14) stop-observ command
The stop-observ command disables the network monitoring function of the virtual NIC.
The following is the format of the stop-observ command.
/opt/FJSVrvnet/bin/rvnetadm stop-observ
(15) version command
The version command displays the version of this product.
The following is the format of the version command.
/opt/FJSVrvnet/bin/rvnetadm version
The following shows an example of the version information:
# /opt/FJSVrvnet/bin/rvnetadm version FJSVrvnet version 1.2
