pgxc_clean

Postgres-XC 1.1 Documentation
Prev | Up | Appendix F. Additional Supplied Modules | Next

# F.31. pgxc_clean

## F.31.1. Overview

> Note: The following description applies only to Postgres-XC

pgxc_clean has the following synopsis.

    pgxc_clean [ option ] [dbname[username]]

pgxc_clean is Postgres-XC utility to maintain transaction status after a crash. When some Postgres-XC node crashes and recovers or fails over, commit status of such node may be inconsistent with other nodes. pgxc_clean checks transaction commit status and corrects them.

You should run this utility against one of the available Coordinators. The tool cleans up transaction status of all the nodes automatically.

## F.31.2. Options

`-a`
`--all`

  Cleanup all the database available. `all`.

`-d`databasename``
`--dbname=`databasename``

  Database name to clean up. This option can be specified multiple times for more than one database.

`-h`hostname``
`--command=`hostname``

  Hostname of the Coordinator to connect to.

`-N`
`--no-clean`

  If this option is specified, pgxc_clean will not perform the cleanup. It just investigates transaction status.

`-o `filename``
`--output=`filename``

  Name of the file where pgxc_clean output will be written. If not specified, stdout and stderr will be used.

`-p `port_number``
`--port=`port_number``

  Specifies the port number of the Coordinator.

`-q`
`--quiet`

  Surpress messages as much as possible.

`-s`
`--status`

  Prints investigated two phase commit status.

`-U `username``
`--username=`username``

  User name to use. You must be a superuser of the database.

`-v`
`--verbose`

  Write as much information as possible.

`-V`
`--version`

  Writes the version of the utility and exits.

`-w`
`--no-password`

  Never issue a password prompt. If the server requires password authentication and a password is not available by other means such as a `.pgpass` file, the connection attempt will fail. This option can be useful in batch jobs and scripts where no user is present to enter a password.

  Note that this option will remain set for the entire session, and so it affects uses of the meta-command `\connect` as well as the initial connection attempt.

`-W`
`--password`

  Force psql to prompt for a password before connecting to a database.

  This option is never essential, since psql will automatically prompt for a password if the server demands password authentication. However, psql will waste a connection attempt finding out that the server wants a password. In some cases it is worth typing `-W` to avoid the extra connection attempt.

  Note that this option will remain set for the entire session, and so it affects uses of the meta-command `\connect` as well as the initial connection attempt.

`-?`
`--help`

  Show help about psql command line arguments, and exit.

Prev | Home | Next
pg_trgm | Up | pgxc_ctl