Provided by: kimberlite_1.1.0-3.3_i386 bug

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
              #

       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 ALSO

       See the Installation and Administration manual for more information.

                                  August 2000                       pswitch(8)