pswitch(8) · carta

NAME

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

SYNOPSIS

pswitch [OPTION ...] SUBCOMMAND

DESCRIPTION

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.

OPTIONS

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.

SUBCOMMANDS

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.

EXAMPLE

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
#