[Name]
hanetnic - Dynamic addition/deletion/switching of physical interfaces
[Synopsis]
/opt/FJSVhanet/usr/sbin/hanetnic command [args]
[Feature description]
The hanetnic command can add, delete, or switch physical interfaces to be used dynamically while the relevant virtual interface is active.
Command | Process outline | Authority |
|---|---|---|
add | Adds physical interfaces | Super user |
delete | Deletes physical interfaces | Super user |
change | Changes physical interface used | Super user |
Note
When adding, deleting, or switching interfaces dynamically using this command, the virtual interface must be active.
(1) add command
This command adds physical interfaces bundled by a virtual interface in Fast switching mode, Virtual NIC mode, or GS linkage mode dynamically. (Real interfaces are added while the virtual interface is active.) However, only physical interfaces specified in configuration information can be specified. The following is the format of the add command:
/opt/FJSVhanet/usr/sbin/hanetnic add -n devicename -i interface [-f] |
Specify a virtual interface name to which the physical interface to be added belongs. It is possible to specify only virtual interface names with Fast switching mode, Virtual NIC mode, or GS linkage mode specified.
Specify a name of an interface to be added.
When dynamically adding (which requires to modification of the configuration information) a virtual interface, set a name of a new interface.
Similarly, for actively exchanging an interface (which does not require modification in the configuration information), run the dsphanet command in order to identify the name of the interface to be added. Moreover, within the interface name displayed in "Device" field, specify the interface name displayed as "(CUT)".
Specifies when changes the configuration information of a virtual interface at the same time. (Permanent dynamic addition.)
Note that this option cannot be configured when operating in GS linkage mode.
(2) delete command
This command deletes physical interfaces bundled by a virtual interface in Fast switching mode, Virtual NIC mode, or GS linkage mode dynamically (Real interfaces are deleted while the virtual interface is active). However, only physical interfaces specified in configuration information can be specified. The following is the format of the delete command. When a virtual interface bundles only one physical interface, this command cannot be executed.
/opt/FJSVhanet/usr/sbin/hanetnic delete -n devicename -i interface [-f] |
Specify a virtual interface name to which the physical interface to be deleted belongs. It is possible to specify only virtual interface names with Fast switching mode, Virtual NIC mode, or and GS linkage mode.
Specify the name of the interface for deletion.
First, run the dsphanet command to identify the name of the interface subjected for deletion. Then, specify the interface name in the "Device" field where virtual interface displayed.
Specifies when changes the configuration information of a virtual interface at the same time. (Permanent dynamic deletion.)
Note that this option cannot be configured when operating in GS linkage mode.
(3) change command
This command switches physical interfaces used in a virtual interface in NIC switching mode or Virtual NIC mode to those of the standby system. The following is the format of the change command. If there is no standby interface, which means that an interface is temporarily cut off by the "delete" command or it is linked down, this command cannot be executed.
NIC switching mode:
/opt/FJSVhanet/usr/sbin/hanetnic change -n devicename |
Virtual NIC mode:
/opt/FJSVhanet/usr/sbin/hanetnic change -n devicename [-i interface] |
Specify the virtual interface name of the used physical interface to be changed. It is possible to specify only virtual interface names with NIC switching mode (operation mode "d" or "e") or Virtual NIC mode (operation mode "v") specified.
Specify the physical interface name of the communication destination. Only Virtual NIC mode can be specified for the operation mode of the virtual interface.
[Notes]
As for an actual interface to dynamically add for a virtual interface of Fast switching mode (the operation mode is "t"), be sure to define to use in TCP/IP before adding dynamically. (Check if or not there is /etc/sysconfig/network-scripts/ifcfg-ethX file. If not, create it. Then execute "/sbin/ifup ethX " command, and activate the interface.)
In GS linkage mode, only temporary dynamic addition/deletion is possible.
If you want to execute this command for a virtual interface of NIC switching mode on the host OS of virtual machine function repeatedly, wait at least 1 minute.
You can check whether there are physical interfaces in the OFF state by using the "dsphanet" command for physical interfaces in the standby state.
You cannot execute the "hanetnic change" command when virtual interfaces are in the inactive state.
To dynamically add or delete physical interfaces used by virtual interfaces in Virtual NIC mode by using this command with "-f" option, change monitoring destinations according to the connection status between physical interfaces and switch/HUB.
[Examples]
The following example adds eth0 to the bundled physical interfaces in the virtual interface sha0. It is assumed that sha0 has already been defined in Fast switching mode (operation mode "t"), Virtual NIC mode (operation mode "v"), or GS linkage mode (operation mode "c"), and eth0 has been deleted by using the "hanetnic delete" command.
# /opt/FJSVhanet/usr/sbin/hanetnic add -n sha0 -i eth0 |
The following example deletes eth1 from the bundled physical interfaces in the virtual interface sha0. It is assumed that sha0 has already been defined in Fast switching mode (operation mode "t"), Virtual NIC mode (operation mode "v"), or GS linkage mode (operation mode "c").
# /opt/FJSVhanet/usr/sbin/hanetnic delete -n sha0 -i eth1 |
The following example replaces physical interfaces used in the virtual interface sha0 with those of the standby system. It is assumed that sha0 has already been defined in NIC switching mode (operation mode "d").
# /opt/FJSVhanet/usr/sbin/hanetnic change -n sha0 |
The following example replaces physical interfaces used in the virtual interface sha0 with those of the standby system. It is assumed that sha0 has already been defined in Virtual NIC mode (operation mode "v"). In addition, the standby physical interface is defined as eth2.
# /opt/FJSVhanet/usr/sbin/hanetnic change -n sha0 -i eth2 |
