---
name: "pswitch"
section: "8"
platform: "linux"
package: "kimberlite"
version: "1.1.0-3"
release: "Debian 3.0 (Woody)"
platforms: ["linux"]
url: "https://new.carta.tech/pswitch"
---

# pswitch(8)

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

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