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

7.14 hanethvrsc Command

[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
print	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 logical virtual interface and a takeover IP address. It is possible to create up to 64 logical virtual interfaces. A logical number of a logical virtual interface (a number to add after ":") is automatically numbered from 65.

The following is the command format for creating a virtual interface information:

- When creating a virtual interface information

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/SURE linkage mode:
/opt/FJSVhanet/usr/sbin/hanethvrsc create -n devicename [-i takeover-ipv4]

-n devicename:

Specify a name of the virtual interface for Fast switching, NIC switching or GS/SURE 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/SURE linkage mode (operation mode 'c'), one takeover IP can be applied against one virtual interface name.

-i takeover-ipv4[,takeover-ipv6/prefix]:

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, a value specified by -i option of hanetconfig create command is automatically set as a takeover IP. In GS/SURE linkage mode (operation mode 'c'), this option is omissible. When it omits, IP address set as virtual interface is automatically set up as takeover IP address.

(2) delete command

Deletes the information of a virtual interface from the cluster resources.

/opt/FJSVhanet/usr/sbin/hanethvrsc delete -n {devicename1[,devicename2,...] | all}

-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 [-n devicename1[,devicename2,...]]

An example of a display is as follows:

Item	Explanation
ifname	A name of a logical virtual interface to register in the cluster resources is displayed.
takeover-ipv4	A host name or an IP address of a takeover IP (IPv4) to add to a logical virtual interface is displayed.
takeover-ipv6	A host name or an IP address of a takeover IP (IPv6) to add to a logical virtual interface is displayed.
'-'(hyphen)	Means that 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/inet/hosts and /etc/inet/ipnodes files. 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.

[Examples]

(1) create command

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 configuring GS/SURE linkage mode:
The following is an example of registering the virtual interface sha1 in the cluster resource.

# /opt/FJSVhanet/usr/sbin/hanethvrsc create -n sha1 -i 192.168.80.10

(2) delete command

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

(3) print command

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