Update example command of install pgpool-II for Rocky linux 10.1.
authorTaiki Koshino <koshino@sraoss.co.jp>
Fri, 5 Dec 2025 02:06:49 +0000 (11:06 +0900)
committerTaiki Koshino <koshino@sraoss.co.jp>
Fri, 5 Dec 2025 02:06:49 +0000 (11:06 +0900)
doc.ja/src/sgml/example-cluster.sgml
doc.ja/src/sgml/installation-rpm.sgml
doc/src/sgml/example-cluster.sgml
doc/src/sgml/installation-rpm.sgml

index bd0f1d0f1a3c5b3dfee6c03f5cf4d089999414e8..1561889f8aca9e4980812effe3922a06e3f8f22d 100644 (file)
     <tbody>
      <row>
       <entry>Pgpool-IIバージョン</entry>
-      <entry>4.6.1</entry>
+      <entry>4.7.0</entry>
       <entry>-</entry>
      </row>
      <row>
@@ -278,12 +278,19 @@ exclude=pgpool*
 
   <para>
    <productname>Pgpool-II</productname>をインストールします。
-   <productname>Pgpool-II</productname>のインストールに必要なlibmemcachedライブラリをインストールするために、<literal>crb</literal>リポジトリを有効にする必要があります。
-   <literal>Rocky Linux 8</literal>を使用する場合、<literal>crb</literal>リポジトリではなく、<literal>powertools</literal>リポジトリを使用してください。
-   
+   Rocky Linux 10で<productname>PgPool-II</productname>をインストールするには、依存関係を満たすためにEPELリポジトリの有効化とlibmemcached-awesome-develが必要です。
+  </para>
+  <programlisting>
+[全サーバ]# dnf install -y https://www.pgpool.net/yum/rpms/4.7/redhat/rhel-10-x86_64/pgpool-II-release-4.7-1.noarch.rpm
+[全サーバ]# dnf install -y epel-release
+[全サーバ]# dnf install -y libmemcached-awesome-devel
+[全サーバ]# dnf install -y pgpool-II-pg18-*
+  </programlisting>
+  <para>
+   <literal>Rocky Linux 9</literal>を使用する場合、<literal>epel</literal>リポジトリではなく、<literal>crb</literal>リポジトリを、
+   <literal>Rocky Linux 8</literal>を使用する場合は<literal>powertools</literal>リポジトリを有効化してください。
   </para>
   <programlisting>
-[全サーバ]# dnf install -y https://www.pgpool.net/yum/rpms/4.6/redhat/rhel-10-x86_64/pgpool-II-release-4.6-1.noarch.rpm
 [全サーバ]# dnf install -y --enablerepo=crb pgpool-II-pg18-*
   </programlisting>
  </sect2>
@@ -1213,11 +1220,11 @@ Password for user pgpool:
     <command>pcp_recovery_node</command>コマンドで<filename>recovery_1st_stage</filename>と<filename>pgpool_remote_start</filename>スクリプトが実行されるので(<filename>recovery_1st_stage</filename>は<varname>recovery_1st_stage_command</varname>パラメータに設定したスクリプト)、この2つのスクリプトが現在稼働中のプライマリサーバ<literal>server1</literal>のデータベースクラスタに存在することを確認してください。
    </para>
    <programlisting>
-[いずれかのサーバ]# pcp_recovery_node -h 192.168.100.50 -p 9898 -U pgpool -n 1 -W
+[いずれかのサーバ]# pcp_recovery_node -h 192.168.100.50 -p 9898 -U pgpool -n 1
 Password:
 pcp_recovery_node -- Command Successful
 
-[いずれかのサーバ]# pcp_recovery_node -h 192.168.100.50 -p 9898 -U pgpool -n 2 -W
+[いずれかのサーバ]# pcp_recovery_node -h 192.168.100.50 -p 9898 -U pgpool -n 2
 Password:
 pcp_recovery_node -- Command Successful
    </programlisting>
@@ -1244,7 +1251,7 @@ Password for user pgpool:
     最初に起動した<productname>Pgpool-II</productname>がリーダーになります。
    </para>
    <programlisting>
-[いずれかのサーバ]# pcp_watchdog_info -h 192.168.100.50 -p 9898 -U pgpool -W
+[いずれかのサーバ]# pcp_watchdog_info -h 192.168.100.50 -p 9898 -U pgpool
 Password:
 3 3 YES server1:9999 Linux server1 server1
 
@@ -1259,7 +1266,7 @@ server3:9999 Linux server3 server3 9999 9000 7 STANDBY 0 MEMBER # スタンバ
    <programlisting>
 [root@server1 ~]# systemctl stop pgpool.service
 
-[root@server1 ~]# pcp_watchdog_info -p 9898 -h 192.168.100.50 -U pgpool -W
+[root@server1 ~]# pcp_watchdog_info -p 9898 -h 192.168.100.50 -U pgpool
 Password:
 3 3 YES server2:9999 Linux server2 server2
 
@@ -1273,7 +1280,7 @@ server3:9999 Linux server3 server3 9999 9000 7 STANDBY 0 MEMBER   # server3が
    <programlisting>
 [root@server1 ~]# systemctl start pgpool.service
 
-[root@server1 ~]# pcp_watchdog_info -p 9898 -h 192.168.100.50 -U pgpool -W
+[root@server1 ~]# pcp_watchdog_info -p 9898 -h 192.168.100.50 -U pgpool
 Password: 
 3 3 YES server2:9999 Linux server2 server2
 
@@ -1368,7 +1375,7 @@ reply_time       | 2023-11-10 17:17:23.886477+00
     <command>pcp_recovery_node</command>コマンドで<filename>recovery_1st_stage</filename>と<filename>pgpool_remote_start</filename>スクリプトが実行されるので(<filename>recovery_1st_stage</filename>は<varname>recovery_1st_stage_command</varname>パラメータに設定したスクリプト)、この2つのスクリプトが現在稼働中のプライマリサーバ<literal>server2</literal>のデータベースクラスタに存在することを確認してください。
    </para>
    <programlisting>
-[いずれかのサーバ]# pcp_recovery_node -h 192.168.100.50 -p 9898 -U pgpool -n 0 -W
+[いずれかのサーバ]# pcp_recovery_node -h 192.168.100.50 -p 9898 -U pgpool -n 0
 Password:
 pcp_recovery_node -- Command Successful
    </programlisting>
@@ -1378,11 +1385,11 @@ pcp_recovery_node -- Command Successful
    <programlisting>
 [any server]# psql -h 192.168.100.50 -p 9999 -U pgpool postgres -c "show pool_nodes"
 Password for user pgpool:
-node_id | hostname | port | status | lb_weight |  role   | select_cnt | load_balance_node | replication_delay | replication_state | replication_sync_state | last_status_change  
+ node_id | hostname | port | status | pg_status | lb_weight |  role   | pg_role | select_cnt | load_balance_node | replication_delay | replication_state | replication_sync_state | last_status_change
 ---------+----------+------+--------+-----------+-----------+---------+---------+------------+-------------------+-------------------+-------------------+------------------------+---------------------
  0       | server1  | 5432 | up     | up        | 0.333333  | standby | standby | 0          | true              | 0                 | streaming         | async                  | 2023-11-10 17:22:03
  1       | server2  | 5432 | up     | up        | 0.333333  | primary | primary | 0          | false             | 0                 |                   |                        | 2023-11-10 17:05:40
- 2       | server3  | 5432 | up     | up        | 0.333333  | standby | standby | 0          | false             | 0                 | streaming         | async                  | 2023-11-10 17:05:51
+ 2       | server3  | 5432 | up     | up        | 0.333333  | standby | standby | 0          | falas             | 0                 | streaming         | async                  | 2023-11-10 17:05:51
 (3 rows)
    </programlisting>
    <para>
index 8f4c4ddd9082c2f17ade48a88717ad93534493ad..9f0beb0b0e9e0256ae21439202c0aba7a2c7980c 100644 (file)
@@ -156,10 +156,10 @@ exclude=pgpool*
   </para>
   <para>
    <!--
-   The following commands assume that you are using Pgpool-II 4.6.x for PostgreSQL 18 on RHEL10.
+   The following commands assume that you are using Pgpool-II 4.7.x for PostgreSQL 18 on RHEL10.
    If you are using other versions, replace "pgXX" with your PostgreSQL version.
    -->
-   以下の手順はRHEL10に<productname>PostgreSQL 18</productname>に対応した<productname>Pgpool-II 4.6.x</productname>をインストールすることが前提となります。
+   以下の手順はRHEL10に<productname>PostgreSQL 18</productname>に対応した<productname>Pgpool-II 4.7.x</productname>をインストールすることが前提となります。
    他のバージョンの<productname>PostgreSQL</productname>を利用している場合は、<productname>PostgreSQL</productname>のバージョンに応じて「pgXX」を適宜置き換えてください。
   </para>
   <para>
@@ -172,7 +172,19 @@ exclude=pgpool*
    REHL9/8の場合は、<ulink url="https://www.pgpool.net/mediawiki/index.php/Yum_Repository">こちら</ulink>を参照してください。
   </para>
   <programlisting>
-dnf install https://www.pgpool.net/yum/rpms/4.6/redhat/rhel-10-x86_64/pgpool-II-release-4.6-1.noarch.rpm
+dnf install https://www.pgpool.net/yum/rpms/4.7/redhat/rhel-10-x86_64/pgpool-II-release-4.7-1.noarch.rpm
+  </programlisting>
+  <para>
+   <!--
+   To install <productname>Pgpool-II</productname> on Rocky Linux 10, you need to enable the EPEL repository and install libmemcached-awesome-devel to satisfy dependencies.
+   Before installing <productname>Pgpool-II</productname>, run the following commands.
+   -->
+   Rocky Linux 10で<productname>PgPool-II</productname>をインストールするには、依存関係を満たすためにEPELリポジトリの有効化とlibmemcached-awesome-develが必要です。
+   <productname>Pgpool-II</productname>インストール前に以下コマンドを実行してください。
+  </para>
+  <programlisting>
+dnf install epel-release
+dnf install libmemcached-awesome-devel
   </programlisting>
   <para>
    <!--
index 49d9e3d6bc97aeb1a97d59e2dd4495b537119454..76813c03dad87ceccbcbd6b509561dc78569a1e5 100644 (file)
     <tbody>
      <row>
       <entry>Pgpool-II Version</entry>
-      <entry>4.6.1</entry>
+      <entry>4.7.0</entry>
       <entry>-</entry>
      </row>
      <row>
@@ -276,14 +276,22 @@ exclude=pgpool*
   <para>
    Install <productname>Pgpool-II</productname> from
    <productname>Pgpool-II</productname> YUM repository.
-   To install the required libmemcached library for Pgpool-II,
-   you need to enable <literal>crb</literal> repository.
-   If you're using <literal>Rocky Linux 8</literal>,
-   use <literal>powertools</literal> repository instead of
-   <literal>crb</literal> repository.
+   To install <productname>Pgpool-II</productname> on Rocky Linux 10,
+   you need to enable <literal>epel</literal> repository and install libmemcached-awesome-devel to satisfy dependencies.
+  </para>
+  <programlisting>
+[all servers]# dnf install -y https://www.pgpool.net/yum/rpms/4.7/redhat/rhel-10-x86_64/pgpool-II-release-4.7-1.noarch.rpm
+[all servers]# dnf install -y epel-release
+[all servers]# dnf install -y libmemcached-awesome-devel
+[all servers]# dnf install -y pgpool-II-pg18-*
+  </programlisting>
+  <para>
+   If you're using <literal>Rocky Linux 9</literal>,
+   use <literal>crb</literal> repository insted of <literal>epel</literal>.
+   For <literal>Rocky Linux 8</literal>,
+   use <literal>powertools</literal> repository instead.
   </para>
   <programlisting>
-[all servers]# dnf install -y https://www.pgpool.net/yum/rpms/4.6/redhat/rhel-9-x86_64/pgpool-II-release-4.6-1.noarch.rpm
 [all servers]# dnf install -y --enablerepo=crb pgpool-II-pg18-*
   </programlisting>
  </sect2>
@@ -1299,11 +1307,11 @@ Password for user pgpool:
     primary server (<literal>server1</literal>).
    </para>
    <programlisting>
-[any server]# pcp_recovery_node -h 192.168.100.50 -p 9898 -U pgpool -n 1 -W
+[any server]# pcp_recovery_node -h 192.168.100.50 -p 9898 -U pgpool -n 1
 Password:
 pcp_recovery_node -- Command Successful
 
-[any server]# pcp_recovery_node -h 192.168.100.50 -p 9898 -U pgpool -n 2 -W
+[any server]# pcp_recovery_node -h 192.168.100.50 -p 9898 -U pgpool -n 2
 Password:
 pcp_recovery_node -- Command Successful
    </programlisting>
@@ -1330,7 +1338,7 @@ Password for user pgpool
     Confirm the watchdog status by using <command>pcp_watchdog_info</command>. The <command>Pgpool-II</command> server which is started first runs as <literal>LEADER</literal>.
    </para>
    <programlisting>
-[any server]# pcp_watchdog_info -h 192.168.100.50 -p 9898 -U pgpool -W
+[any server]# pcp_watchdog_info -h 192.168.100.50 -p 9898 -U pgpool
 Password:
 3 3 YES server1:9999 Linux server1 server1
 
@@ -1352,7 +1360,7 @@ server3:9999 Linux server3 server3 9999 9000 7 STANDBY 0 MEMBER # running as STA
    <programlisting>
 [root@server1 ~]# systemctl stop pgpool.service
 
-[root@server1 ~]# pcp_watchdog_info -p 9898 -h 192.168.100.50 -U pgpool -W
+[root@server1 ~]# pcp_watchdog_info -p 9898 -h 192.168.100.50 -U pgpool
 Password:
 3 3 YES server2:9999 Linux server2 server2
 
@@ -1368,7 +1376,7 @@ server3:9999 Linux server3 server3 9999 9000 7 STANDBY 0 MEMBER   # server3 is r
    <programlisting>
 [root@server1 ~]# systemctl start pgpool.service
 
-[root@server1 ~]# pcp_watchdog_info -p 9898 -h 192.168.100.50 -U pgpool -W
+[root@server1 ~]# pcp_watchdog_info -p 9898 -h 192.168.100.50 -U pgpool
 Password: 
 3 3 YES server2:9999 Linux server2 server2
 
@@ -1469,7 +1477,7 @@ reply_time       | 2023-11-10 17:17:23.886477+00
     as a standby.
    </para>
    <programlisting>
-[any server]# pcp_recovery_node -h 192.168.100.50 -p 9898 -U pgpool -n 0 -W
+[any server]# pcp_recovery_node -h 192.168.100.50 -p 9898 -U pgpool -n 0
 Password: 
 pcp_recovery_node -- Command Successful
    </programlisting>
@@ -1480,11 +1488,11 @@ pcp_recovery_node -- Command Successful
    <programlisting>
 [any server]# psql -h 192.168.100.50 -p 9999 -U pgpool postgres -c "show pool_nodes"
 Password for user pgpool:
-node_id | hostname | port | status | lb_weight |  role   | select_cnt | load_balance_node | replication_delay | replication_state | replication_sync_state | last_status_change  
+ node_id | hostname | port | status | pg_status | lb_weight |  role   | pg_role | select_cnt | load_balance_node | replication_delay | replication_state | replication_sync_state | last_status_change
 ---------+----------+------+--------+-----------+-----------+---------+---------+------------+-------------------+-------------------+-------------------+------------------------+---------------------
  0       | server1  | 5432 | up     | up        | 0.333333  | standby | standby | 0          | true              | 0                 | streaming         | async                  | 2023-11-10 17:22:03
  1       | server2  | 5432 | up     | up        | 0.333333  | primary | primary | 0          | false             | 0                 |                   |                        | 2023-11-10 17:05:40
- 2       | server3  | 5432 | up     | up        | 0.333333  | standby | standby | 0          | false             | 0                 | streaming         | async                  | 2023-11-10 17:05:51
+ 2       | server3  | 5432 | up     | up        | 0.333333  | standby | standby | 0          | falas             | 0                 | streaming         | async                  | 2023-11-10 17:05:51
 (3 rows)
    </programlisting>
   </sect3>
index 1a88ea4d100d5243635f68dcee6375c6d4fed5da..994542ceb1a31db354136071acd13711717349e6 100644 (file)
@@ -120,7 +120,7 @@ exclude=pgpool*
   </para>
 
   <para>
-   The following commands assume that you are using Pgpool-II 4.6.x for PostgreSQL 18 on RHEL10.
+   The following commands assume that you are using Pgpool-II 4.7.x for PostgreSQL 18 on RHEL10.
    If you are using other versions, replace "pgXX" with your PostgreSQL version.
   </para>
   <para>
@@ -129,7 +129,15 @@ exclude=pgpool*
    For REHL9/8, see <ulink url="https://www.pgpool.net/mediawiki/index.php/Yum_Repository">here</ulink>.
   </para>
   <programlisting>
-dnf install https://www.pgpool.net/yum/rpms/4.6/redhat/rhel-10-x86_64/pgpool-II-release-4.6-1.noarch.rpm
+dnf install https://www.pgpool.net/yum/rpms/4.7/redhat/rhel-10-x86_64/pgpool-II-release-4.7-1.noarch.rpm
+  </programlisting>
+  <para>
+   To install <productname>Pgpool-II</productname> on Rocky Linux 10, you need to enable the EPEL repository and install libmemcached-awesome-devel to satisfy dependencies.
+   Before installing <productname>Pgpool-II</productname>, run the following commands.
+  </para>
+  <programlisting>
+dnf install epel-release
+dnf install libmemcached-awesome-devel
   </programlisting>
   <para>
    Then, install <productname>Pgpool-II</productname>.