cphaprob

In the R81.10.X releases, this command is available starting from the R81.10.00 version.

Description

Defines and manages the critical cluster member properties of the appliance. When a critical process fails, the appliance is considered to have failed.

Syntax

cphaprob [-i[a]] [-d <device>] [-s {ok|init|problem}] [-f <file>] [-p] [register|unregister|report|list|state|if]

Parameters

Parameter

Description

register

Registers <appliance> as a critical process.

-a

Lists all devices in the cluster.

-d <device>

The name of the device as it appears in the output of the cphaprob list.

-p

The configuration change is permanent and applies after the appliance reboots.

-t <timeout>

If <device> fails to contact ClusterXL in <timeout> seconds, <device> is considered to have failed.

To disable this parameter, enter the value 0.

-s

Status to be reported.

ok - <appliance> is alive

init - <appliance> is initializing

problem - <appliance> has failed

-f <file> register

Option to automatically register several appliances. The file defined in the <file> field should contain the list of appliances with these parameters:

  • <device>

  • <timeout>

  • Status

unregister

Unregisters <device> as a critical process.

report

Reports the status of the <device> to the gateway.

list

Displays that state of:

-i - Internal (as well as external) devices, such as interface check and High Availability initialization.

-e - External devices, such as devices registered by the user or outside the kernel. For example, fwd, sync, filter.

-ia - All devices, including those used for internal purposes, such as note initialization and load-balance configuration.

state

Displays the state of all the gateways in the High Availability configuration.

if

Displays the state of interfaces.

Example Command

cphaprob -d $process -t 0 -s ok -p register

Example Output

Success prints OK. Failure shows an appropriate error message.

These are some typical scenarios for the cphaprob command.

Argument

Description

cphaprob -d <device> -t <timeout(sec)> -s <ok|init|problem> [-p] register

Register <device> as a critical process, and add it to the list of devices that must be running for the cluster member to be considered active.

cphaprob -f <file> register

Register all the user defined critical devices listed in <file>.

cphaprob -d <device> [-p] unregister

Unregister a user defined <device> as a critical process. This means that this device is no longer considered critical.

cphaprob -a unregister

Unregister all the user defined <device>.

cphaprob -d <device> -s <ok|init|problem> report

Report the status of a user defined critical device to ClusterXL.

cphaprob [-i[a]] [-e] list

View the list of critical devices on a cluster member, and of all the other machines in the cluster.

cphaprob state

View the status of a cluster member, and of all the other members of the cluster.

cphaprob [-a] if

View the state of the cluster member interfaces and the virtual cluster interfaces.

Examples

cphaprob -d <device> -t <timeout(sec)> -s <ok|init|problem> [-p] register
cphaprob -f <file> register
cphaprob -d <device> [-p] unregister
cphaprob -a unregister
cphaprob -d <device> -s <ok|init|problem> report
cphaprob [-i[a]] [-e] list
cphaprob state
cphaprob [-a] if