[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
Virtual NIC mode:
/opt/FJSVhanet/usr/sbin/hanethvrsc create -n devicename [-i {takeover-ipv4 | takeover-ipv6/prefix | takeover-ipv4,takeover-ipv6/prefix}] [-v vlan_id]
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, Virtual NIC 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 or Virtual NIC mode.
For NIC switching mode and GS linkage mode, one takeover IP can be applied against one virtual interface name.
Note
When the virtual interface of the Virtual NIC mode is registered in the cluster resource, it is activated regardless of ONBOOT setting in the setting file (/etc/sysconfig/network-scripts/ifcfg-shaX) of the virtual interface.
Specify a host name or an IP address of a takeover IP.
Specify this option when a virtual interface to specify by -n option is Fast switching mode and Virtual NIC mode.
In Virtual NIC mode, when you do not need to take over a virtual IP address between clusters, specifying the -i option is unnecessary. In addition, when you set a takeover IP address for a tagged VLAN interface (shaX.Y) in Virtual NIC mode, specify the takeover IP address with the -i option and VLAN ID (Y) with the -v option. This option is not necessary for NIC switching mode or GS linkage 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.
Note
When you specify a takeover IP address with the -i option in Virtual NIC mode, set a subnet mask by using the hanetmask command in advance. For example, when specifying the IP address "192.168.1.1", set the subnet mask for "192.168.1.0."
For details on the hanetmask command, see "7.5 hanetmask Command."
Specify the VLAN ID of a tagged VLAN interface for Virtual NIC mode.
In Virtual NIC mode, specify VLAN ID (Y) by -v option when you register a tagged VLAN interface (shaX.Y) for Virtual NIC mode to a cluster resource.
Note
In Virtual NIC mode, if you register a tagged VLAN interface for Virtual NIC mode to a cluster resource, you need to configure the setting file (/etc/sysconfig/network-scrips/ifcfg-shaX.Y) for a tagged VLAN interface for Virtual NIC mode beforehand.
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.
Point
The virtual interface name specified by the "delete" command is the name which is assigned by the virtual interface name specified by the "create" command at the timing of setting.
(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:
# /opt/FJSVhanet/usr/sbin/hanethvrsc print ifname takeover-ipv4 takeover-ipv6 vlan-id/logical ip address list +----------+----------------+----------------+--------------------------------+ sha0:65 takeovervip1 - - sha1:65 - takeovervip2/64 - sha2:65 192.168.50.1 fec0:1::123/64 - sha3:65 192.168.80.1 - 192.168.70.12,192.168.71.12 sha4:65 sha0-65 - - sha4:66 192.168.11.10 - - sha4:67 - fec0:1::69/64 5 |
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. |
vlan-id/logical ip address list | In Virtual NIC mode, VLAN ID of a tagged VLAN interface to which a takeover IP is set or a hyphen is displayed. |
'-'(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 Virtual NIC mode:
An example of using create command when registering a virtual interface sha0 with adding a takeover IP address (10.1.1.1) of IPv4 in the cluster resources.
# /opt/FJSVhanet/usr/sbin/hanethvrsc create -n sha0 -i 10.1.1.1 |
An example of using create command when setting Virtual NIC mode:
An example of using create command when registering a virtual interface sha0 without a takeover IP address in the cluster resources.
# /opt/FJSVhanet/usr/sbin/hanethvrsc create -n sha0 |
An example of using create command when setting Virtual NIC mode:
An example of using create command when registering a virtual interface sha0 with adding a takeover IP address (fec0:1::69/64) of IPv6 to a tagged VLAN interface sha0.5 on a virtual interface sha0 in the cluster resources.
# /opt/FJSVhanet/usr/sbin/hanethvrsc create -n sha0 -i fec0:1::69/64 -v 5 |
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 |
