Scroll to navigation

pgagroal-cli(1) General Commands Manual pgagroal-cli(1)

Name

pgagroal-cli - Command line utility for pgagroal

SYNOPSIS

pgagroal-cli [ -c CONFIG_FILE ] [ COMMAND ]

DESCRIPTION

pgagroal-cli is a command line utility for pgagroal.

OPTIONS

Set the path to the pgagroal.conf file
Set the host name
Set the port number
Set the user name
Set the password
Set the logfile

Set the output format
Compress the wire protocol
Encrypt the wire protocol

Output text string of result
Display version information

-?, --help
Display help

COMMANDS

Flush connections according to [mode]. Allowed modes are:
  • 'gracefully' (default) to flush all connections gracefully
  • 'idle' to flush only idle connections
  • 'all' to flush all connections. USE WITH CAUTION!



If no [database] name is specified, applies to all databases.

Verifies if pgagroal is up and running
Enable the specified database, or all databases if not specified
Disable the specified database, or all databases if not specified
  • 'gracefully' (default): waits for active connections to quit
  • 'immediate': forces connections to close and terminate
  • 'cancel': avoid a previously issued 'shutdown gracefully'


Status of pgagroal, with optional details
Switches to the specified primary server
  • 'reload': issue a configuration reload
  • 'ls': list the configuration files used
  • 'get': obtain information about a runtime configuration value Usage: conf get <parameter_name>
  • 'set': modify a configuration value Usage: conf set <parameter_name> <parameter_value>


Resets either the Prometheus statistics or the specified server. <what> can be:
  • 'server' (default) followed by a server name
  • a server name on its own
  • 'prometheus' to reset the Prometheus metrics




REPORTING BUGS

pgagroal is licensed under the 3-clause BSD License.

SEE ALSO

pgagroal.conf(5), pgagroal_hba.conf(5), pgagroal_databases.conf(5), pgagroal_vault.conf(5), pgagroal(1), pgagroal-admin(1), pgagroal-vault(1)