PRIMECLUSTER Global Link Services Configuration and Administration Guide: Redundant Line Control Function 4.2 (for Linux)

7.6 hanetparam Command

[Name]

hanetparam - Setting up the monitoring function when Fast switching mode, NIC switching mode, or the standby patrol function is used

[Synopsis]

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

[Feature description]

The hanetparam command sets up the monitoring function.

[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 switching, specify the number of repeatedly monitoring within the range between 1-100 for monitoring Cluster switching. The default is set to 5 (switch the Cluster if failure was detected on the entire transfer routes). This option is only available for Cluster operation on Fast switching mode.

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

< Valid options in all modes >

print:

Outputs a list of settings.

The following shows the output format:

Display		Contents
Line monitor interval (w)		The setting for the transmission line monitoring interval.
Line monitor message output (m)		The monitoring retry count before message output when a line failure occurs.
Cluster failover (l)		The consecutive monitoring failure count before execution of cluster failover.
Standby patrol interval (p)		The monitoring interval of the standby patrol.
Standby patrol message output (o)		The consecutive monitoring failure count before output of a message when a standby patrol failure occurs.
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]

• This command can be specified for a virtual interface in Fast switching mode (operation mode "t"), NIC switching mode (operation mode "d" or "e"), and standby patrol function (operation mode "p" or "q").
• The setting by this command is valid in the whole system. It is not possible to change in a unit of virtual interface.
• After executing this command, reboot the system immediately. The applied value will not be effective until the system restarts.

[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

< 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