Pgpool-II 3.6.5 文書
前のページ | 上に戻る |  | 次のページ

# pgpool_setup

## 名前

pgpool_setup -- Pgpool-II クラスタのテスト環境を構築するツール

## 概要

`pgpool_setup` [`option`...]

## 説明

pgpool_setup はカレントディレクトリで Pgpool-II とノード数が指定できる複数の PostgreSQL のクラスタテスト環境を構築するツールです。 カレントディレクトリは空である必要があります。

pgpool_setup はテストのために使うツールなので、 実際の業務システムで利用することはおすすめしません。

現在、「ストリーミングレプリケーションモード」、「ネイティブレプリケーションモード」及び「raw モード」に対応しています。 Watchdog の対応については watchdog_setup をご参照下さい。

## オプション

pgpool_setup 以下のコマンドライン引数を受け付けます:

`-m `mode``

  動作モードを指定します。`mode`は `r` (ネイティブレプリケーションモード), `s` (ストリーミングレプリケーションモード)、または `n` (raw モード)を指定できます。 指定しない場合は、`s` (ストリーミングレプリケーションモード) です。

`-n `num_clusters``

  PostgreSQL のノード数を指定します。指定しない場合は、ノード数が 2 です。

`-p `base_port``

  ベースとなるポート番号を指定します。 Pgpool-II のポートは base_port、pcp のポートは base_port + 1、 最初の PostgreSQL ノードのポートは base_port + 2、 2 番目の PostgreSQL ノードのポートは base_port + 3 というようになります。

  -pg オプションを指定した場合、 最初の PostgreSQL ノードのポートは pg_base_port、 2 番目の PostgreSQL ノードのポートは pg_base_port + 1 というように割り当てていきます。

  指定しない場合、ベースとなるポート番号は 11000 です。

`-pg `pg_base_port``

  PostgreSQL のベースとなるポート番号を指定します。 最初の PostgreSQL ノードのポートは base_port + 2、 2 番目の PostgreSQL ノードのポートは base_port + 3 というようになります。

  省略した場合は、 `base_port`+2 が使われます。

`--no-stop`

  セットアップ終了後に Pgpool-II, PostgreSQL を終了しません。

`-d`

  デバッグモードで Pgpool-II を起動します。

## 環境変数

pgpool_setup 以下の環境変数を使用します:

`PGPOOL_INSTALL_DIR`

  Pgpool-II のインストールディレクトリを指定します。 Pgpool-II バイナリーは PGPOOL_INSTALL_DIR/bin ディレクトリ以下、 `pgpool.conf` と `pool_hba.conf` などは PGPOOL_INSTALL_DIR/etc ディレクトリ以にインストールされます。 デフォルトでは /usr/local ディレクトリ以下にインストールされます。

`PGPOOLDIR`

  Pgpool-II 設定ファイルへのパスを指定します。 デフォルトでは PGPOOL_INSTALL_DIR/etc です。

`PGBIN`

  initdb、pg_ctl と psql など PostgreSQL コマンドへのパスを指定します。 デフォルトでは、/usr/local/pgsql/bin です。

`PGLIB`

  PostgreSQL の共有ライブラリへのパスを指定します。 デフォルトでは、/usr/local/pgsql/lib です。

`PGSOCKET_DIR`

  Unixソケットのディレクトリへのパスを指定します。 デフォルトでは /tmp です。

`INITDBARG`

  initdb コマンドの引数を指定します。 デフォルトでは "--no-locale -E UTF_8" です。

## 出力例

    $ pgpool_setup
    Satrting set up in streaming replication mode
    creating startall and shutdownall
    creating failover script
    creating database cluster /home/t-ishii/tmp/test/data0...done.
    update postgreql.conf
    creating pgpool_remote_start
    creating basebackup.sh
    creating recovery.conf
    creating database cluster /home/t-ishii/tmp/test/data1...done.
    update postgreql.conf
    creating pgpool_remote_start
    creating basebackup.sh
    creating recovery.conf
    temporarily start data0 cluster to create extensions
    temporarily start pgpool-II to create standby nodes
    INFO:  unrecognized configuration parameter "debug_level"
     node_id | hostname | port  | status | lb_weight |  role   | select_cnt | load_balance_node | replication_delay
    ---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
     0       | /tmp     | 11002 | up     | 0.500000  | primary | 0          | true              | 0
     1       | /tmp     | 11003 | down   | 0.500000  | standby | 0          | false             | 0
    (2 rows)

    recovery node 1...pcp_recovery_node -- Command Successful
    done.
    creating follow master script
    Pager usage is off.
     node_id | hostname | port  | status | lb_weight |  role   | select_cnt | load_balance_node | replication_delay
    ---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
     0       | /tmp     | 11002 | up     | 0.500000  | primary | 0          | false             | 0
     1       | /tmp     | 11003 | up     | 0.500000  | standby | 0          | true              | 0
    (2 rows)

    shutdown all

    pgpool-II setting for streaming replication mode is done.
    To start the whole system, use /home/t-ishii/tmp/test/startall.
    To shutdown the whole system, use /home/t-ishii/tmp/test/shutdownall.
    pcp command user name is "t-ishii", password is "t-ishii".
    Each PostgreSQL, pgpool-II and pcp port is as follows:
    #1 port is 11002
    #2 port is 11003
    pgpool port is 11000
    pcp port is 11001
    The info above is in README.port.

    $ ls
    README.port  bashrc.ports  data1  log	   pgpool_reload     run	  startall
    archivedir   data0	   etc	  pcppass  pgpool_setup.log  shutdownall

    $ ./startall
    waiting for server to start....11840 2016-08-18 13:08:51 JST LOG:  redirecting log output to logging collector process
    11840 2016-08-18 13:08:51 JST HINT:  Future log output will appear in directory "pg_log".
     done
    server started
    waiting for server to start....11853 2016-08-18 13:08:52 JST LOG:  redirecting log output to logging collector process
    11853 2016-08-18 13:08:52 JST HINT:  Future log output will appear in directory "pg_log".
     done
    server started
    $ psql -p 11000 test
    Pager usage is off.
    psql (9.5.4)
    Type "help" for help.

    test=# show pool_nodes;
     node_id | hostname | port  | status | lb_weight |  role   | select_cnt | load_balance_node | replication_delay
    ---------+----------+-------+--------+-----------+---------+------------+-------------------+-------------------
     0       | /tmp     | 11002 | up     | 0.500000  | primary | 0          | false             | 0
     1       | /tmp     | 11003 | up     | 0.500000  | standby | 0          | true              | 0
    (2 rows)

前のページ | ホーム | 次のページ
pg_md5 | 上に戻る | watchdog_setup