PGPOOL(8)

NAME
pgpool - Pgpool-II main server

SYNOPSIS

pgpool [option...]

pgpool [option...] stop

pgpool [option...] reload

DESCRIPTION

the Pgpool-II main server

USAGES

pgpool runs in 3 modes: start, stop and reload. If none of stop or reload is given, it is assumed that "start" is specified.

COMMON OPTIONS

These are common options for 3 modes.

-a hba_config_file
--hba-file=hba_config_file
    Set the path to the pool_hba.conf configuration file. Mandatory if the file is placed other than the standard location.

-f config_file
--config-file=config_file
    Set the path to the pgpool.conf configuration file. Mandatory if the file is placed other than the standard location.

-F pc_config_file
--pcp-file=pcp_config_file
    Set the path to the pcp.conf configuration file. Mandatory if the file is placed other than the standard location.

-k key_file
--key-file=key_file
    Set the path to the .pgpoolkey file. Mandatory if you use AES256 encrypted password and the file is placed other than the standard location and used.

-h
--help
    Print help.

STARTING PGPOOL-II MAIN SERVER

Here are options for the start mode.

-d
--debug
    Run Pgpool-II in debug mode. Lots of debug messages are produced.

-n
--dont-detach
    Don't run in daemon mode, does not detach control ttys.

-x
--debug-assertions
    Turns on various assertion checks, This is a debugging aid.

-C
--clear-oidmaps
    Clear query cache oidmaps when memqcache_method is memcached.

    If memqcache_method is shmem, Pgpool-II always discards oidmaps at the start-up time. So this option is not necessary.

-D
--discard-status
    Discard pgpool_status file and do not restore previous status.

        Caution
        This option is testing purpose only for developers and you should not use it for other purposes. If pgpool_status is accidentally removed, Pgpool-II may go into split-brain (there are multiple primary servers exist).

STOPPING PGPOOL-II MAIN SERVER

Here are options for the stop mode.

-m shutdown_mode
--mode=shutdown_mode
    Stop Pgpool-II. shutdown_mode is either smart, fast or immediate. If smart is specified, Pgpool-II will wait for all clients are disconnected. If fast or immediate are specified, Pgpool-II immediately stops itself without waiting for all clients are disconnected. There's no difference between fast and immediate in the current implementation.

RELOADING PGPOOL-II CONFIGURATION FILES

Reload configuration file of Pgpool-II. No specific options exist for reload mode. Common options are applicable.