[Name]
hanethvrsc - Sets the information of a virtual interface to register in the cluster resources.
[Synopsis]
/opt/FJSVhanet/usr/sbin/hanethvrsc command [args]
[Feature description]
hanethvrsc command makes it possible to create/delete/display the information of a virtual interface to register in the resources of PRIMECLUSTER.
Command | Process outline | Authority |
|---|---|---|
Create | Creates virtual interface information | Super user |
Delete | Deletes virtual interface information | Super user |
Displays virtual interface information | Super user |
(1) create command
Creates the information of a virtual interface to register in the resources of PRIMECLUSTER. The information of a virtual interface is consisted of a takeover virtual interface and a takeover IP address. It is possible to create up to 64 takeover virtual interfaces. A logical number of a takeover virtual interface (a number to add after ":") is automatically numbered from 65.
When creating the information of a virtual interface:
Fast switching mode:
/opt/FJSVhanet/usr/sbin/hanethvrsc create -n devicename -i {takeover-ipv4 | takeover-ipv6/prefix | takeover-ipv4,takeover-ipv6/prefix}
NIC switching mode:
/opt/FJSVhanet/usr/sbin/hanethvrsc create -n devicename
GS linkage mode
/opt/FJSVhanet/usr/sbin/hanethvrsc create -n devicename [-e nicaddress1[,nicaddress2,...]] |
Specify a name of the virtual interface for Fast switching, NIC switching mode, and GS linkage mode created with hanetconfig command.
A multiple takeover IP can be applied to a single virtual interface name for Fast switching mode.
For NIC switching mode and GS linkage mode, one takeover IP can be applied against one virtual interface name.
Specifies a host name or an IP address of a takeover IP. This option is necessary when a virtual interface to specify by -n option is Fast switching mode. Not necessary when NIC switching mode. In NIC switching mode and GS linkage mode, a value specified by -i option of hanetconfig create command is automatically set as a takeover IP.
Specify the host name or IP address to be used as the gateway address for the takeover virtual interface in GS linkage mode. This host name or IP address is assigned as the logical interface to the physical interface that you make redundant. The specification of the host name or IP address is possible only in GS linkage mode. Be sure to specify the host names or IP addresses corresponding to the number of physical interfaces that the takeover virtual interface in GS linkage mode bundles.
Point
You need to set the IP address to be configured by using the '-e' option under the following condition.
Communication type | Adapter type used by GS | |
|---|---|---|
LANC, ONA | LANC2, LR | |
Same network communication (local) | No setting required. | Setting required. |
Remote network communication (remote) | Setting required. | Setting required. |
You need to set the IP address by using the '-e' option when routers (including LANC2) are connected between the local nodes and GS host. In addition, if you specified the IP address with the '-e' option, you need to set the IP address specified with the '-e' option as the gateway to the local node's virtual IP address to the static route information for the routers for the local node.
Note
When you specify the IP address with the '-e' option, set the subnet mask beforehand with the hanetmask command. For example, when you specify the IP addresses "192.168.70.12" and "192.168.71.12" by using the '-e' option, set the subnet masks for "192.168.70.0" and "192.168.71.0". For details on the hanetmask command, see "7.5 hanetmask Command".
(2) delete command
Deletes the information of a virtual interface from the cluster resources.
# /opt/FJSVhanet/usr/sbin/hanethvrsc delete -n devicename |
Specifies a name of a logical virtual interface created by create command (shaXX:YY). However, it is not possible to delete while RMS is working.
(3) print command
Displays a list of the information of a virtual interface to register in the cluster resources.
# /opt/FJSVhanet/usr/sbin/hanethvrsc print |
An example of a display is as follows:
Display | Contents |
|---|---|
ifname | A name of a logical virtual interface to register in the cluster resources. |
takeover-ipv4 | A host name or an IP address of a takeover IP (IPv4) to add to a logical virtual interface. |
takeover-ipv6 | A host name or an IP address of a takeover IP (IPv6) to add to a logical virtual interface. |
logical ip address list | A host name or an IP address of a logical IP (IPv4) to be added to a physical interface used as a gateway address for a takeover virtual interface. |
'-'(hyphen) | Neither a hostname nor an IP address is set. |
[Notes]
When specified a host name to where to set a host name or an IP address with this command, it is not possible to change/delete the corresponding host name on the host database of such as /etc/hosts file. To change/delete the information of the host name, it is necessary to temporarily delete a definition of a Redundant Line Control Function to use the corresponding host name and to set the definition again.
When creating information of a virtual interface to register in the resources of PRIMECLUSTER by using this command, check that the virtual interface to be registered is deactivated before execution.
[Examples]
An example of using create command when setting Fast switching mode (IPv4):
An example of using create command when registering a virtual interface sha0 added a takeover IP address (10.1.1.1) in the cluster resources.
# /opt/FJSVhanet/usr/sbin/hanethvrsc create -n sha0 -i 10.1.1.1 |
An example of configuring Fast switching mode (IPv6):
The following is an example of registering the virtual interface sha0 in the cluster resource after applying the takeover IP address (fec0:1::1/64).
# /opt/FJSVhanet/usr/sbin/hanethvrsc create -n sha0 -i fec0:1::1/64 |
An example of configuring Fast switching mode (IPv4/IPv6):
The following is an example of registering the virtual interface sha0 in the cluster resource after applying IPv4 takeover IP address (10.1.1.1) and IPv6 takeover IP address (fec0:1::1/64).
# /opt/FJSVhanet/usr/sbin/hanethvrsc create -n sha0 -i 10.1.1.1,fec0:1::1/64 |
An example of using create command when setting NIC switching mode:
An example of using create command when registering a virtual interface sha1 in the cluster resources.
# /opt/FJSVhanet/usr/sbin/hanethvrsc create -n sha1 |
An example of using create command when setting GS linkage mode:
An example of using create command when registering a virtual interface sha2 in the cluster resources.
# /opt/FJSVhanet/usr/sbin/hanethvrsc create -n sha2 -e 192.168.70.12,192.168.71.12 |
An example of using create command when deleting a logical virtual interface sha1:65 from the cluster resources.
# /opt/FJSVhanet/usr/sbin/hanethvrsc delete -n sha1:65 |
An example of displaying a list of the information of a virtual interface to register to the cluster resources.
# /opt/FJSVhanet/usr/sbin/hanethvrsc print |
