pswitch - Tests the remote connection to a power switch in a cluster.

pswitch [OPTION ...] SUBCOMMAND

The pswitch command tests the remote connection to a power switch in a cluster. After installing the cluster hardware, invoke the command on each cluster system to ensure that it can remotely power cycle the other cluster system.

The pswitch command can accurately test a power switch only if the cluster software is not running, because only one program at a time can access the serial port that connects a power switch to a cluster system. When you invoke the pswitch command, it checks the status of the cluster software. If the cluster software is running, the command exits with a message to stop the cluster software.

You can specify the following pswitch options:

-d serial_device, --device serial_device

Specifies the serial device to which the power switch is remotely connecte (for example, /dev/ttyS0.)

-t type, --type type

Specifies the type of power switch (for example, RPS10).

-v, --verbose

Displays detailed command output.

-h, --help

Displays help about the command

--usage

Displays a brief description of the command format.

-V, --version

Displays information about the command version.

You must specify one of the following pswitch subcommands:

status

Displays the status of the power switch.

open

Opens the power switch, which removes power from the cluster system.

close

Closes the power switch, which restores power to the cluster system.

reboot

Opens the power switch for 5 seconds, which removes power from the cluster system, and then closes the power switch, which restores power to the cluster system.

The following example of pswitch command output shows that the power switch is operational:

# pswitch status
switch status:
switch is: On
error? No
timedout? No
initialized? Yes
# 

If the pswitch command output shows that the error or timedout fields are Yes, or if the initialized field is No, the cluster software will not function correctly.

See the Installation and Administration manual for more information.