Top
PRIMECLUSTER Global Link Services Configuration and AdministrationGuide 4.3Redundant Line Control Function

7.9 hanetnic Command

[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]

-n devicename:

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.


-i interface:

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)".


-f:

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]

-n devicename:

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.


-i interface:

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.


-f:

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]

-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") or Virtual NIC mode (operation mode "v") specified.


-i interface

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]

[Examples]

(1) add command

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

(2) delete command

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

(3) change command

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