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.