[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 and 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 and 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 and 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:
/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 (operation mode "t") and GS linkage mode (operation mode "c").
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 changes physical interfaces used in a virtual interface in NIC switching mode to those of the standby system. The following is the format of the change command:
/opt/FJSVhanet/usr/sbin/hanetnic change -n devicename |
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") specified.
[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.
[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") 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") 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 |