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

Chapter 7 Command reference

7.6 hanetparam Command

[Name]

hanetparam - The setting value of various functions is changed or displayed

[Synopsis]

/opt/FJSVhanet/usr/sbin/hanetparam {-w sec | -m times | -l times | -p sec | -o times | -d {plumb | unplumb} | -c {on | off} | -s {on | off}}
/opt/FJSVhanet/usr/sbin/hanetparam print

[Feature description]

The hanetparam command sets up the monitoring function when the Fast switching operation or the standby patrol function is used. This command also changes the method of activating and inactivating Fast switching mode and NIC switching mode.

[Option]

You can specify the following options:

< Valid options in fast switching mode >

-w value

Specify the interval (value) for monitoring the communication target in Fast switching mode. A value from 0 to 300 can be specified. No monitoring is performed if 0 is specified in value. By default, 5 is specified. This parameter is enabled only for Fast switching mode.

-m value

Specify the monitoring retry count (value) before message output when the message output function for a line failure is enabled.

Specify the monitoring retry count (value) before message output. A value from 0 to 100 can be specified. No message is output if 0 is specified in value. By default, no message is output. This parameter is enabled only for Fast switching mode.

-l value

Specify the cluster failover function.

Specify how many times (count) communication with the communication target can fail consecutively before cluster failover is performed. A value from 0 to 100 can be specified. No cluster failover is performed if 0 is specified in value. When performing cluster failover, the number of times for repeating surveillance is specified in the range from 1 time to 100 times until it cluster failover. By default, cluster failover is specified to be performed if communication fails five consecutive times. This parameter is enabled only for Fast switching mode on a cluster system.

-c value

When operating Fast switching mode on a cluster system and when an error occurred in all transfer routes at the activation of a userApplication, sets if or not to execute failover between clusters (job switching between nodes).
Specify "on" to value for executing failover between clusters (job switching between nodes) when an error occurred in all transfer routes at activation of a userApplication.
Specify "off" to value for not executing failover between clusters when an error occurred in all transfer routes at activation of a userApplication.
"off" is set to value as an initial setting value.

-s value

Specify if or not to output a message when a physical interface, which a virtual interface uses, changed the status (detected an error in a transfer route or recovery). A value possible to specify is "on" or "off". When specified "on", a message is output (message number: 990, 991, and 992). When specified "off", a message is not output. The initial value is "off". This parameter is valid only in fast switching mode.

< Valid options in NIC switching mode >

-p value

Specify the interval (value) for monitoring the communication target when the standby patrol function is enabled. A value from 0 to 100 can be specified. No monitoring is performed if 0 is specified in value.
Do not specify 0 to this parameter when set a user command execution function (executing a user command when standby patrol detected an error or recovery). User command execution does not function if specified 0.
By default, 15 is specified. This parameter is enabled only for NIC switching mode.

-o value

Specify the monitoring retry count (value) before message output when the message output function for a standby patrol failure is enabled.
Specify the monitoring retry count (value) before message output. A value from 0 to 100 can be specified.
When specified 0, stop outputting messages and make monitoring by a standby patrol function invalid. Do not specify 0 to this parameter when set a user command execution function (executing a user command when standby patrol detected an error or recovery). User command execution does not function, if specified 0.
By default, 3 is specified. This parameter is enabled only for NIC switching mode. The number of the times of continuous monitoring is "a set value of this option x 2" immediately after started standby patrol.

-d value

Use this parameter to change the method of inactivating the standby interface in NIC switching mode. Specify "plumb" in value to inactivate the standby interface and set "0.0.0.0" as the IP address. This procedure allows "INTERSTAGE Traffic Director", etc. to be used as the host application. Alternatively, specify "unplumb" in value to inactivate and delete the standby interface. Initially, "unplumb" is specified in value. If you specify a physical interface of NIC switching for the network setting of the Solaris container (zone), be sure to specify "plumb" for the parameter. If the Solaris zone is started without the "plumb" setting, Solaris zone startup will fail because the physical interface (standby interface) has not been used. Specifying "plumb" will deactivate the standby interface after NIC switching so that zone startup will properly be performed.

Setting

Interface

Operating

Standby

Status

IP address

Allocation of logical I/F

Status

IP address

Allocation of logical I/F

unplumb

Active

Yes

Possible

Unused

-

Impossible

plumb

Active

Yes

Possible

Inactive

None (0.0.0.0)

Possible

< Valid options in all modes >

print:

Outputs a list of settings.

The following shows the output format:

image

Item

Explanation

Line monitor interval (w)

Outputs the setting for the transmission line monitoring interval.

Line monitor message output (m)

Outputs the monitoring retry count before message output when a line failure occurs.

Cluster failover (l)

Outputs the consecutive monitoring failure count before execution of cluster failover.

Standby patrol interval (p)

Outputs the monitoring interval of the standby patrol.

Standby patrol message output (o)

Outputs the consecutive monitoring failure count before output of a message when a standby patrol failure occurs.

NIC switching mode (d)

Outputs the method of inactivating the standby interface in NIC switching mode.

NIC switching mode (d)

Unplumb

Inactivates the standby interface and deletes.

Plumb

Inactivates the standby interface and sets the IP address as "0.0.0.0".

Cluster failover in unnormality(c)

Workings when an error occurred in all transfer routes at activating a userApplication.

Cluster failover in unnormality(c)

ON

Cluster switching immediately occurs.

OFF

Cluster switching does not occur at activating a userApplication.

Line status message output (s)

With or without a message output when a physical interface changed the status.

Line status message output (s)

ON

A message is output.

OFF

A message is not output.

[Related command]

hanetpoll

[Notes]

[Examples]

< Example of Fast switching mode >

(1) Example of setting line failure monitoring interval

The following shows an example of using this command to perform monitoring at intervals of 5 seconds.

# /opt/FJSVhanet/usr/sbin/hanetparam -w 5

(2) Example of enabling or disabling the message output function used when a line failure occurs

The following shows an example of using this command to output a message if communication with the communication target fails five consecutive times.

# /opt/FJSVhanet/usr/sbin/hanetparam -m 5

(3) Example of setting the cluster failover function

The following shows an example of using this command to perform cluster failover if communication with the communication target fails five consecutive times.

# /opt/FJSVhanet/usr/sbin/hanetparam -l 5

(4) A setting example of the workings when an error occurred in every transfer route at the activation of a userApplication

An example of a command to execute failover between clusters when an error occurred in every transfer route immediately after activated a userApplication is as follows:

# /opt/FJSVhanet/usr/sbin/hanetparam -c on

(5) An example of setting with/without outputting a message when a physical interface, which a virtual interfaces uses, changed the status

An example of a command to output a message when a physical interface, which a virtual interface uses, changed the status is as follows:

# /opt/FJSVhanet/usr/sbin/hanetparam -s on

< Example of NIC switching mode >

(1) Example of setting the standby patrol monitoring interval

The following shows an example of using this command to perform monitoring at intervals of five seconds.

# /opt/FJSVhanet/usr/sbin/hanetparam -p 5

(2) Example of setting the message output function used when a standby patrol failure occurs

The following shows an example of using this command to output a message when communication with the communication target fails five consecutive times.

# /opt/FJSVhanet/usr/sbin/hanetparam -o 5

(3) Example of changing the method of inactivating the standby interface

The following shows an example of using this command to inactivate the standby interface and set "0.0.0.0" as the IP address (using "INTERSTAGE Traffic Director", Solaris Containers, etc. as the host application).

# /opt/FJSVhanet/usr/sbin/hanetparam -d plumb

< Example common to all modes >

(1) Example of executing the status display command

The following shows an example of displaying the settings made using the hanetparam command.

# /opt/FJSVhanet/usr/sbin/hanetparam print



Contents Index PreviousNext

All Rights Reserved, Copyright (C) FUJITSU LIMITED 2005