PRIMECLUSTER Global Link Services Configuration and Administration Guide: Redundant Line Control Function 4.1 (for Solaris(TM) Operating System)

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

When adding, deleting, or switching interfaces dynamically using this command, the virtual interface must be active.

Dynamic addition or deletion of a redundant physical interface is enabled even when a virtual interface of fast switching or a redundant physical interface of NIC switching is set for the network setting of the Solaris zone.

(1) add command

This command adds physical interfaces bundled by a virtual interface in Fast switching mode, RIP mode, Fast switching/RIP mode, and NIC switching mode dynamically. (Physical 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 (operation mode "t") or Fast switching/RIP mode (operation mode "b") 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)".

The interface name specified in this option is an actual interface name (such as hmeX) for Fast switching, RIP and Fast switching/RIP modes. However, specification of the virtual interface (shaX) name used in operation mode "n" is required for GS/SURE linkage mode.

-f:

Specifies when changes the configuration information of a virtual interface at the same time. (Permanent dynamic addition.)

(2) delete command

This command deletes physical interfaces bundled by a virtual interface in Fast switching mode dynamically (Physical 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]

-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 (operation mode "t") or Fast switching/RIP mode (operation mode "b").

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

The interface name specified in this option is actual interface name (such as hmeX) for Fast switching, RIP and Fast switching/RIP mode. However, specification of the virtual interface (shaX) name used in operation mode "n" is required for GS/SURE linkage mode.

-f:

Specifies when changes the configuration information of a virtual interface at the same time. (Permanent dynamic deletion.)

(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

-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, RIP mode, and Fast switching/RIP mode (the operation mode is "t", "r", and "b"), be sure to define to use in TCP/IP before adding dynamically. (Check if or not there is /etc/hostname.interface file. If not, create it. Then execute "/usr/sbin/ifconfig a name of the actual interface plumb" command, and activate the interface.)

[Examples]

(1) add command

The following example adds hme0 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") and hme0 has been deleted by using the "hanetnic delete" command.

# /opt/FJSVhanet/usr/sbin/hanetnic add -n sha0 -i hme0

(2) delete command

The following example deletes hme1 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").

# /opt/FJSVhanet/usr/sbin/hanetnic delete -n sha0 -i hme1

(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