1<!-- doc/src/sgml/config.sgml --> 2 3<sect1 id="runtime-watchdog-config"> 4 <title>Watchdog</title> 5 6 <indexterm zone="runtime-watchdog-config"> 7 <!-- 8 <primary>configuring watchdog</primary> 9 --> 10 <primary>Watchdogの設定</primary> 11 </indexterm> 12 <para> 13 <!-- 14 Watchdog configuration parameters are described in pgpool.conf. 15 There is sample configuration in the WATCHDOG section of 16 <filename>pgpool.conf.sample</filename> file. 17 All following options are required to be specified in watchdog process. 18 --> 19 Watchdogの設定パラメータはpgpool.confに記述されています。 20 <filename>pgpool.conf.sample</filename>のWATCHDOG節に設定の例があります。 21 以下のすべてのオプションがwatchdogプロセスでは指定されている必要があります。 22 </para> 23 24 <sect2 id="config-enable-watchdog"> 25 <!-- 26 <title>Enable watchdog</title> 27 --> 28 <title>Watchdogを有効にする</title> 29 30 <variablelist> 31 <varlistentry id="guc-use-watchdog" xreflabel="use_watchdog"> 32 <term><varname>use_watchdog</varname> (<type>boolean</type>) 33 <indexterm> 34 <!-- 35 <primary><varname>use_watchdog</varname> configuration parameter</primary> 36 --> 37 <primary><varname>use_watchdog</varname>設定パラメータ</primary> 38 </indexterm> 39 </term> 40 <listitem> 41 <para> 42 <!-- 43 If on, activates the watchdog. Default is off 44 --> 45 onならwatchdogを有効にします。 46 デフォルトはoffです。 47 </para> 48 <para> 49 <!-- 50 This parameter can only be set at server start. 51 --> 52 このパラメータは、サーバ起動時にのみ設定できます。 53 </para> 54 </listitem> 55 </varlistentry> 56 </variablelist> 57 </sect2> 58 59 <sect2 id="config-communication-watchdog"> 60 <!-- 61 <title>Watchdog communication</title> 62 --> 63 <title>Watchdog通信</title> 64 65 <variablelist> 66 67 <varlistentry id="guc-wd-hostname" xreflabel="wd_hostname"> 68 <term><varname>wd_hostname</varname> (<type>string</type>) 69 <indexterm> 70 <!-- 71 <primary><varname>wd_hostname</varname> configuration parameter</primary> 72 --> 73 <primary><varname>wd_hostname</varname>設定パラメータ</primary> 74 </indexterm> 75 </term> 76 <listitem> 77 <para> 78 <!-- 79 Specifies the hostname or IP address of 80 <productname>Pgpool-II</productname> server. 81 This is used for sending/receiving queries and packets, 82 and also as an identifier of the watchdog node. 83 --> 84 <productname>Pgpool-II</productname>サーバのホスト名またはIPアドレスを指定します。 85 クエリやパケットの送受信の他、watchdogの識別子としても用います。 86 </para> 87 <para> 88 <!-- 89 This parameter can only be set at server start. 90 --> 91 </para> 92 </listitem> 93 </varlistentry> 94 95 <varlistentry id="guc-wd-port" xreflabel="wd_port"> 96 <term><varname>wd_port</varname> (<type>integer</type>) 97 <indexterm> 98 <!-- 99 <primary><varname>wd_port</varname> configuration parameter</primary> 100 --> 101 <primary><varname>wd_port</varname> 設定パラメータ</primary> 102 </indexterm> 103 </term> 104 <listitem> 105 <para> 106 <!-- 107 Specifies the port number to be used by watchdog 108 process to listen for connections. Default is 9000. 109 --> 110 watchdogが接続を受け付けるために監視するポート番号です。 111 デフォルト値は9000です。 112 </para> 113 <para> 114 <!-- 115 This parameter can only be set at server start. 116 --> 117 このパラメータは、サーバ起動時にのみ設定できます。 118 </para> 119 </listitem> 120 </varlistentry> 121 122 <varlistentry id="guc-wd-authkey" xreflabel="wd_authkey"> 123 <term><varname>wd_authkey</varname> (<type>string</type>) 124 <indexterm> 125 <!-- 126 <primary><varname>wd_authkey</varname> configuration parameter</primary> 127 --> 128 <primary><varname>wd_authkey</varname>設定パラメータ</primary> 129 </indexterm> 130 </term> 131 <listitem> 132 <para> 133 <!-- 134 Specifies the authentication key used for all watchdog communications. 135 All <productname>Pgpool-II</productname> must have the same key. 136 Packets from watchdog having different key will get rejected. 137 This authentication is also applied to the heatrbeat singals 138 when the <literal>heartbeat</> mode is used as a lifecheck method. 139 --> 140 wachdog間通信で用いられる認証キーを指定します。 141 全ての<productname>Pgpool-II</productname>で同じキーを指定する必要があります。 142 認証キーが異なるwatchdogからの通信は拒絶されます。 143 死活監視を<literal>heartbeat</>モードで行う場合には、この認証はハートビート信号にも適用されます。 144 </para> 145 <para> 146 <!-- 147 Since in <productname>Pgpool-II</productname><emphasis>V3.5</emphasis> or beyond 148 <varname>wd_authkey</varname> is also used to authenticate 149 the watchdog IPC clients, 150 all clients communicating with <productname>Pgpool-II</productname> 151 watchdog process needs to provide this wd_authkey value 152 for <literal>"IPCAuthKey"</literal> key in the JSON data 153 of the command. 154 --> 155 <productname>Pgpool-II</productname><emphasis>V3.5</emphasis>以降では<varname>wd_authkey</varname>がwatchdog IPCクライアントの認証にも使われるため、<productname>Pgpool-II</productname>と通信するwatchdogプロセスは、<literal>"IPCAuthKey"</literal>のコマンドのJSONデータにwd_authkey値を設定しなければなりません。 156 </para> 157 <para> 158 <!-- 159 Default is <literal>''</literal> (empty) which means disables 160 the watchdog authentication. 161 --> 162 デフォルトは<literal>''</literal>(空文字)で、この場合watchdogの認証は行われません。 163 </para> 164 <para> 165 <!-- 166 This parameter can only be set at server start. 167 --> 168 このパラメータは、サーバ起動時にのみ設定できます。 169 </para> 170 </listitem> 171 </varlistentry> 172 </variablelist> 173 </sect2> 174 175 <sect2 id="config-watchdog-upstream-connections"> 176 <!-- 177 <title>Upstream server connection</title> 178 --> 179 <title>上流サーバへの接続</title> 180 181 <variablelist> 182 183 <varlistentry id="guc-trusted-servers" xreflabel="trusted_servers"> 184 <term><varname>trusted_servers</varname> (<type>string</type>) 185 <indexterm> 186 <!-- 187 <primary><varname>trusted_servers</varname> configuration parameter</primary> 188 --> 189 <primary><varname>trusted_servers</varname>設定パラメータ</primary> 190 </indexterm> 191 </term> 192 <listitem> 193 <para> 194 <!-- 195 Specifies the list of trusted servers to check the up stream connections. 196 Each server in the list is required to respond to ping. 197 Specify a comma separated list of servers such as 198 <literal>"hostA,hostB,hostC"</literal>. 199 If none of the server are reachable, watchdog will regard it as 200 failure of the <productname>Pgpool-II</productname>. 201 Therefore, it is recommended to specify multiple servers. 202 Please note that you should not assign PostgreSQL servers to this parameter. 203 --> 204 上位接続を確認するための信頼できるサーバのリストを指定します。 205 リスト中の各サーバは、pingの応答に答える必要があります。 206 <literal>"hostA,hostB,hostC"</literal>のようにカンマで区切って複数のサーバを指定できます。 207 全てのサーバに到達できなくなると、watchdogは<productname>Pgpool-II</productname>に障害が発生したと判断します。 208 そのため、複数のサーバを指定することを推奨します。 209 なお、このパラメータにPostgreSQLサーバを指定することはしないでください。 210 </para> 211 <para> 212 <!-- 213 This parameter can only be set at server start. 214 --> 215 このパラメータは、サーバ起動時にのみ設定できます。 216 </para> 217 </listitem> 218 </varlistentry> 219 220 <varlistentry id="guc-ping-path" xreflabel="ping_path"> 221 <term><varname>ping_path</varname> (<type>string</type>) 222 <indexterm> 223 <!-- 224 <primary><varname>ping_path</varname> configuration parameter</primary> 225 --> 226 <primary><varname>ping_path</varname>設定パラメータ</primary> 227 </indexterm> 228 </term> 229 <listitem> 230 <para> 231 <!-- 232 Specifies the path of a ping command for monitoring 233 connection to the upper servers. Set the only path of the directory containing the 234 ping utility, such as <literal>"/bin"</literal> or such directory. 235 --> 236 上位サーバへの接続監視に利用するpingコマンドのパスを指定します。 237 <literal>"/bin"</literal>のようにパスだけを指定します。 238 </para> 239 <para> 240 <!-- 241 This parameter can only be set at server start. 242 --> 243 このパラメータは、サーバ起動時にのみ設定できます。 244 </para> 245 </listitem> 246 </varlistentry> 247 </variablelist> 248 </sect2> 249 250 <sect2 id="config-watchdog-vip-control"> 251 <!-- 252 <title>Virtual IP control</title> 253 --> 254 <title>仮想IP制御</title> 255 256 <variablelist> 257 258 <varlistentry id="guc-delegate-IP" xreflabel="delegate_IP"> 259 <term><varname>delegate_IP</varname> (<type>string</type>) 260 <indexterm> 261 <!-- 262 <primary><varname>delegate_IP</varname> configuration parameter</primary> 263 --> 264 <primary><varname>delegate_IP</varname>設定パラメータ</primary> 265 </indexterm> 266 </term> 267 <listitem> 268 <para> 269 <!-- 270 Specifies the virtual IP address (VIP) of pgpool-II that is 271 connected from client servers (application servers etc.). 272 When a <productname>Pgpool-II</productname> is switched from standby to active, 273 the <productname>Pgpool-II</productname> takes over 274 this VIP. 275 Default is <literal>''</literal>(empty): which means virtual 276 IP will never be brought up. 277 --> 278 (アプリケーションサーバなど)クライアントサーバから接続される<productname>Pgpool-II</productname>の仮想IP(VIP) アドレスを指定します。 279 <productname>Pgpool-II</productname>がスタンバイからアクティブに切り替わった時、<productname>Pgpool-II</productname>はこのVIPを引き継ぎます。 280 <emphasis>クォーラムが存在しなければVIPは立ち上がりません</emphasis>。 281 デフォルトは<literal>''</literal>(空文字)で、この場合仮想IPは決して立ち上がりません。 282 </para> 283 <para> 284 <!-- 285 This parameter can only be set at server start. 286 --> 287 このパラメータは、サーバ起動時にのみ設定できます。 288 </para> 289 </listitem> 290 </varlistentry> 291 292 <varlistentry id="guc-if-cmd-path" xreflabel="if_cmd_path"> 293 <term><varname>if_cmd_path</varname> (<type>string</type>) 294 <indexterm> 295 <!-- 296 <primary><varname>if_cmd_path</varname> configuration parameter</primary> 297 --> 298 <primary><varname>if_cmd_path</varname>設定パラメータ</primary> 299 </indexterm> 300 </term> 301 <listitem> 302 <para> 303 <!-- 304 Specifies the path to the command that <productname>Pgpool-II</productname> 305 will use to switch the virtual IP on the system. 306 Set only the path of the directory containing the binary, 307 such as <literal>"/sbin"</literal> or such directory. 308 --> 309 <productname>Pgpool-II</productname>が仮想IPを切り替えるために使用するコマンドへのパスを指定します。 310 <literal>"/bin"</literal>のようにパスだけを指定します。 311 </para> 312 <para> 313 <!-- 314 This parameter can only be set at server start. 315 --> 316 このパラメータは、サーバ起動時にのみ設定できます。 317 </para> 318 </listitem> 319 </varlistentry> 320 321 <varlistentry id="guc-if-up-cmd" xreflabel="if_up_cmd"> 322 <term><varname>if_up_cmd</varname> (<type>string</type>) 323 <indexterm> 324 <!-- 325 <primary><varname>if_up_cmd</varname> configuration parameter</primary> 326 --> 327 <primary><varname>if_up_cmd</varname>設定パラメータ</primary> 328 </indexterm> 329 </term> 330 <listitem> 331 <para> 332 <!-- 333 Specifies the command to bring up the virtual IP. 334 Set the command and parameters such as 335 <command>"ip addr add $_IP_$/24 dev eth0 label eth0:0"</command> 336 <literal>$_IP_$</literal> will get replaced by the IP address 337 specified in the <xref linkend="guc-delegate-IP">. 338 --> 339 仮想IPを起動するために実行するコマンドを指定します。 340 <command>"ip addr add $_IP_$/24 dev eth0 label eth0:0"</command>のようにコマンドとパラメータを指定します。 341 <literal>$_IP_$</literal>は<xref linkend="guc-delegate-IP">で指定されたIPアドレスに置換されます。 342 </para> 343 <para> 344 このパラメータは、サーバ起動時にのみ設定できます。 345 </para> 346 </listitem> 347 </varlistentry> 348 349 <varlistentry id="guc-if-down-cmd" xreflabel="if_down_cmd"> 350 <term><varname>if_down_cmd</varname> (<type>string</type>) 351 <indexterm> 352 <!-- 353 <primary><varname>if_down_cmd</varname> configuration parameter</primary> 354 --> 355 <primary><varname>if_down_cmd</varname>設定パラメータ</primary> 356 </indexterm> 357 </term> 358 <listitem> 359 <para> 360 <!-- 361 Specifies the command to bring down the virtual IP. 362 Set the command and parameters such as 363 <literal>"ip addr del $_IP_$/24 dev eth0"</literal>. 364 --> 365 仮想IPを停止するために実行するコマンドを指定します。 366 <literal>"ip addr del $_IP_$/24 dev eth0"</literal>のようにコマンドとパラメータを指定します。 367 </para> 368 <para> 369 <!-- 370 This parameter can only be set at server start. 371 --> 372 このパラメータは、サーバ起動時にのみ設定できます。 373 </para> 374 </listitem> 375 </varlistentry> 376 377 <varlistentry id="guc-arping-path" xreflabel="arping_path"> 378 <term><varname>arping_path</varname> (<type>string</type>) 379 <indexterm> 380 <!-- 381 <primary><varname>arping_path</varname> configuration parameter</primary> 382 --> 383 <primary><varname>arping_path</varname>設定パラメータ</primary> 384 </indexterm> 385 </term> 386 <listitem> 387 <para> 388 <!-- 389 Specifies the path to the command that <productname>Pgpool-II</productname> 390 will use to send the ARP requests after the virtual IP switch. 391 Set only the path of the directory containing the binary, 392 such as <literal>"/usr/sbin"</literal> or such directory. 393 --> 394 IPアドレス切り替え後に<productname>Pgpool-II</productname>がARPリクエストを送信するコマンドへのパス指定します。 395 <literal>"/usr/sbin"</literal>のようにパスだけを指定します。 396 </para> 397 <para> 398 <!-- 399 This parameter can only be set at server start. 400 --> 401 このパラメータは、サーバ起動時にのみ設定できます。 402 </para> 403 </listitem> 404 </varlistentry> 405 406 <varlistentry id="guc-arping-cmd" xreflabel="arping_cmd"> 407 <term><varname>arping_cmd</varname> (<type>string</type>) 408 <indexterm> 409 <!-- 410 <primary><varname>arping_cmd</varname> configuration parameter</primary> 411 --> 412 <primary><varname>arping_cmd</varname>設定パラメータ</primary> 413 </indexterm> 414 </term> 415 <listitem> 416 <para> 417 <!-- 418 Specifies the command to use for sending the ARP requests 419 after the virtual IP switch. 420 Set the command and parameters such as 421 <literal>"arping -U $_IP_$ -w 1"</literal>. 422 <literal>$_IP_$</literal> will get replaced by 423 the IP address specified in the <varname>delegate_IP</varname>. 424 --> 425 IPアドレス切り替え後にARPリクエストを送信するコマンドです。 426 <literal>"arping -U $_IP_$ -w 1"</literal>のようにコマンドとパラメータを指定します。 427 <literal>$_IP_$</literal>は<varname>delegate_IP</varname>で指定されたIPアドレスに置換されます。 428 </para> 429 <para> 430 <!-- 431 This parameter can only be set at server start. 432 --> 433 このパラメータは、サーバ起動時にのみ設定できます。 434 </para> 435 </listitem> 436 </varlistentry> 437 438 </variablelist> 439 </sect2> 440 441 <sect2 id="config-watchdog-escalation-de-escalation"> 442 <!-- 443 <title>Behaivor on escalation and de-escalation</title> 444 --> 445 <title>昇格および降格時の振る舞い</title> 446 <para> 447 <!-- 448 Configuration about behavior when <productname>Pgpool-II</productname> 449 escalates to active (virtual IP holder) 450 --> 451 <productname>Pgpool-II</productname>がアクティブ(仮想IPを保持しているステータス)に昇格した時の振る舞いを指定します。 452 </para> 453 454 <variablelist> 455 456 <varlistentry id="guc-clear-memqcache-on-escalation" xreflabel="clear_memqcache_on_escalation"> 457 <term><varname>clear_memqcache_on_escalation</varname> (<type>boolean</type>) 458 <indexterm> 459 <!-- 460 <primary><varname>clear_memqcache_on_escalation</varname> configuration parameter</primary> 461 --> 462 <primary><varname>clear_memqcache_on_escalation</varname>設定パラメータ</primary> 463 </indexterm> 464 </term> 465 <listitem> 466 <para> 467 <!-- 468 When set to on, watchdog clears all the query cache in the shared memory 469 when pgpool-II escaltes to active. This prevents the new active <productname>Pgpool-II</productname> 470 from using old query caches inconsistence to the old active. 471 --> 472 このオプションがonの場合、pgpool-II がアクティブに昇格した時に、共有メモリ上のクエリキャッシュを全て削除します。 473 これにより、新しいアクティブの<productname>Pgpool-II</productname>が旧アクティブと非整合な古いクエリキャッシュを使うことを防止します。 474 </para> 475 <para> 476 <!-- 477 Default is on. 478 --> 479 デフォルトはonです。 480 </para> 481 <para> 482 <!-- 483 This works only if <xref linkend="guc-memqcache-method"> 484 is <literal>'shmem'</literal>. 485 --> 486 <xref linkend="guc-memqcache-method">が'shmem'の場合のみ有効です。 487 </para> 488 <para> 489 <!-- 490 This parameter can only be set at server start. 491 --> 492 このパラメータは、サーバ起動時にのみ設定できます。 493 </para> 494 </listitem> 495 </varlistentry> 496 497 <varlistentry id="guc-wd-escalation-command" xreflabel="wd_escalation_command"> 498 <term><varname>wd_escalation_command</varname> (<type>string</type>) 499 <indexterm> 500 <!-- 501 <primary><varname>wd_escalation_command</varname> configuration parameter</primary> 502 --> 503 <primary><varname>wd_escalation_command</varname>設定パラメータ</primary> 504 </indexterm> 505 </term> 506 <listitem> 507 <para> 508 <!-- 509 Watchdog executes this command on the node that is escalated 510 to the master watchdog. 511 --> 512 マスターwatchdogに昇格した時に、ここで指定したコマンドがwatchdogによって実行されます。 513 </para> 514 <para> 515 <!-- 516 This command is executed just before bringing up the 517 virtual/floating IP if that is configured on the node. 518 --> 519 コマンドは、そのノードに仮想IPが設定されていた場合、それが立ち上がる直前のタイミングで実行されます。 520 </para> 521 <para> 522 <!-- 523 This parameter can only be set at server start. 524 --> 525 このパラメータは、サーバ起動時にのみ設定できます。 526 </para> 527 </listitem> 528 </varlistentry> 529 530 <varlistentry id="guc-wd-de-escalation-command" xreflabel="wd_de_escalation_command"> 531 <term><varname>wd_de_escalation_command</varname> (<type>string</type>) 532 <indexterm> 533 <!-- 534 <primary><varname>wd_de_escalation_command</varname> configuration parameter</primary> 535 --> 536 <primary><varname>wd_de_escalation_command</varname>設定パラメータ</primary> 537 </indexterm> 538 </term> 539 <listitem> 540 <para> 541 <!-- 542 Watchdog executes this command on the master <productname>Pgpool-II</productname> 543 watchdog node when that node resigns from the master node responsibilities. 544 A master watchdog node can resign from being a master node, 545 when the master node <productname>Pgpool-II</productname> shuts down, detects a network 546 blackout or detects the lost of quorum. 547 --> 548 <productname>Pgpool-II</productname>のマスターwatchdogが責務を辞退し降格するときに、ここで指定したコマンドが実行されます。 549 マスターwatchdogノードは、そのマスターノードの<productname>Pgpool-II</productname>が停止したとき、ネットワーク切断やクォーラムが失われたことを検出した時に、マスターから辞任します。 550 </para> 551 <para> 552 <!-- 553 This command is executed before bringing down the virtual/floating IP address 554 if it is configured on the watchdog node. 555 --> 556 このコマンドは、watchdogノードに仮想IPアドレスが設定されていた場合、それが停止される直前のタイミングで実行されます。 557 </para> 558 <para> 559 <!-- 560 <varname>wd_de_escalation_command</varname> is not available prior to 561 <productname>Pgpool-II</productname><emphasis>V3.5</emphasis>. 562 --> 563 <varname>wd_de_escalation_command</varname>は、<productname>Pgpool-II</productname><emphasis>V3.5</emphasis>より前のバージョンには提供されていません。 564 </para> 565 <para> 566 <!-- 567 This parameter can only be set at server start. 568 --> 569 このパラメータは、サーバ起動時にのみ設定できます。 570 </para> 571 </listitem> 572 </varlistentry> 573 </variablelist> 574 </sect2> 575 576 <sect2 id="config-watchdog-failover-behavior" xreflabel="Controlling the Failover behavior"> 577 <!-- 578 <title>Controlling the Failover behavior</title> 579 --> 580 <title>フェイルオーバの挙動の制御</title> 581 582 <para> 583 <!-- 584 These settings are used to control the behavior of backend node failover when the watchdog is enabled. 585 The effect of these configurations is limited to the failover/degenerate requests initiated by 586 <productname>Pgpool-II</productname> internally, while the user initiated detach backend requests 587 (using PCP command) by-pass these configuration settings. 588 --> 589 これらの設定は、<application>watchdog</application>機能が有効な場合に、バックエンドノードのフェイルオーバの動作を制御するために使用されます。 590 これらの設定の影響は、内部的な<productname>Pgpool-II</productname>のフェイルオーバ/縮退要求のみに影響します。 591 一方、(PCPコマンドを使った)ユーザが起動したバックエンド切り離し操作では、これらの設定項目は迂回され適用されません。 592 </para> 593 594 <variablelist> 595 596 <varlistentry id="guc-failover-when-quorum-exists" xreflabel="failover_when_quorum_exists"> 597 <term><varname>failover_when_quorum_exists</varname> (<type>boolean</type>) 598 <indexterm> 599 <!-- 600 <primary><varname>failover_when_quorum_exists</varname> configuration parameter</primary> 601 --> 602 <primary><varname>failover_when_quorum_exists</varname> 設定パラメータ</primary> 603 </indexterm> 604 </term> 605 <listitem> 606 <para> 607 <!-- 608 When enabled, <productname>Pgpool-II</productname> will perform the degenerate/failover on 609 backend node if the quorum exists. In the absence of the quorum, <productname>Pgpool-II</productname> 610 node that detects the backend failure will quarantine the failed backend node until the quorum exists again. 611 --> 612 このパラメータを有効にすると、クォーラムが存在する場合、<productname>Pgpool-II</productname>はバックエンドノードで縮退/フェイルオーバを実行します。 613 クォーラムが存在しない場合、クォーラムが再び存在するまで、バックエンドの障害を検出する<productname>Pgpool-II</productname>ノードは、障害の発生したバックエンドノードを隔離します。 614 </para> 615 <para> 616 <!-- 617 The quarantine nodes behaves similar to the detached backend nodes but unlike failed/degenerated backends 618 the quarantine status is not propagated to the other <productname>Pgpool-II</productname> nodes in the 619 watchdog cluster, So even if the backend node is in the quarantine state on one 620 <productname>Pgpool-II</productname> node, other <productname>Pgpool-II</productname> nodes may 621 still continue to use that backend. 622 --> 623 隔離されたノードの動作は切り離されたバックエンドノードと似ていますが、フェイルオーバ/縮退と異なり、隔離ステータスはwatchdogクラスタ内の他の<productname>Pgpool-II</productname>ノードに伝播されません。 624 したがって、他の<productname>Pgpool-II</productname>ノードは引き続きそのバックエンドを使用し続ける可能性があります。 625 </para> 626 <para> 627 <!-- 628 Although there are many similarities in quarantine and failover operations, but they both differ in a very 629 fundamental way. The quarantine operations does not executes the <xref linkend="guc-failover-command"> 630 and silently detaches the problematic node, So in the case when the master backend node is quarantined, the 631 <productname>Pgpool-II</productname> will not promote the standby to take over the master responsibilities 632 and until the master node is quarantined the <productname>Pgpool-II</productname> will not have 633 any useable master backend node. 634 --> 635 隔離とフェイルオーバ操作には多くの類似点がありますが、どちらも非常に基本的な方法で異なります。 636 隔離操作は<xref linkend="guc-failover-command">を実行せず、障害の発生したノードを隔離します。 637 この隔離されたノードがマスタの場合、<productname>Pgpool-II</productname>はスタンバイをマスタに昇格させないので、マスタノードが隔離されている間は、使用可能なマスタバックエンドノードはありません。 638 </para> 639 <para> 640 <!-- 641 Default is on. 642 --> 643 デフォルト値はonです。 644 </para> 645 <para> 646 <!-- 647 <varname>failover_when_quorum_exists</varname> is not available prior to 648 <productname>Pgpool-II </productname><emphasis>V3.7</emphasis>. 649 --> 650 failover_when_quorum_existsは<productname>Pgpool-II </productname><emphasis>V3.7</emphasis>より前では利用できません。 651 </para> 652 <para> 653 <!-- 654 This parameter can only be set at server start. 655 --> 656 このパラメータは、サーバーの起動時にのみ設定できます。 657 </para> 658 <note> 659 <para> 660 <!-- 661 enabling <varname>failover_when_quorum_exists</varname> is not allowed in native replication mode. 662 --> 663 ネイティブレプリケーションモードでは<varname>failover_when_quorum_exists</varname>機能は利用できません。 664 </para> 665 </note> 666 </listitem> 667 </varlistentry> 668 669 <varlistentry id="guc-failover-require-consensus" xreflabel="failover_require_consensus"> 670 <term><varname>failover_require_consensus</varname> (<type>boolean</type>) 671 <indexterm> 672 <!-- 673 <primary><varname>failover_require_consensus</varname> configuration parameter</primary> 674 --> 675 <primary><varname>failover_require_consensus</varname> 設定パラメータ</primary> 676 </indexterm> 677 </term> 678 <listitem> 679 <para> 680 <!-- 681 When enabled, <productname>Pgpool-II</productname> will perform the degenerate/failover on a 682 backend node if the watchdog quorum exists and at-least minimum number of nodes necessary 683 for the quorum vote for the failover. 684 --> 685 このパラメータを有効にすると、<productname>Pgpool-II</productname>は、<application>watchdog</application>クォーラムが存在し、少なくともクォーラム投票に必要なノードの最小数があれば、バックエンドノードで縮退/フェイルオーバを実行します。 686 </para> 687 <para> 688 <!-- 689 For example, in a three node watchdog cluster, the failover will only be performed until at 690 least two nodes ask for performing the failover on the particular backend node. 691 --> 692 たとえば、3ノードの<application>watchdog</application>のクラスタでは、フェイルオーバは、少なくとも2つのノードが特定のバックエンドノードに対してフェイルオーバの実行要求をするときのみ実行されます。 693 </para> 694 <para> 695 <!-- 696 Default is on. 697 --> 698 デフォルト値はonです。 699 </para> 700 <para> 701 702 <!-- 703 <caution> 704 <para> 705 When <varname>failover_require_consensus</varname> is 706 enabled, <productname>Pgpool-II</productname> does not 707 execute the failover until it get enough votes from 708 other <productname>Pgpool-II</productname> nodes. So it is 709 strongly recommended to enable the backend health check on 710 all 711 <productname>Pgpool-II</productname> nodes to ensure 712 proper detection of backend node failures. For more 713 details of health check, 714 see <xref linkend="runtime-config-health-check">. 715 </para> 716 </caution> 717 --> 718 <caution> 719 <para> 720 <varname>failover_require_consensus</varname>が有効な場合、<productname>Pgpool-II</productname>は他 の<productname>Pgpool-II</productname>ノードから充分な投票を得るまでフェイルオーバしません。 721 ですから、正しくバックエンドの障害を検出するために、すべての<productname>Pgpool-II</productname>ノードでヘルスチェックを有効にすることを強く推奨します。 722 ヘルスチェックに関する詳細については、<xref linkend="runtime-config-health-check">をご覧ください。 723 </para> 724 </caution> 725 726 <note> 727 <para> 728 <!-- 729 enabling <varname>failover_require_consensus</varname> is not allowed in native replication mode. 730 --> 731 ネイティブレプリケーションモードでは<varname>failover_require_consensus</varname>機能は利用できません。 732 </para> 733 </note> 734 735 <!-- 736 <varname>failover_require_consensus</varname> is not available prior to 737 <productname>Pgpool-II </productname><emphasis>V3.7</emphasis>. and it is only 738 effective when <xref linkend="guc-failover-when-quorum-exists"> is enabled 739 --> 740 <productname>Pgpool-II</productname> <emphasis>V3.7</emphasis>より前では<varname>failover_require_consensus</varname>は利用できません。 741 <xref linkend="guc-failover-when-quorum-exists">が有効な場合にのみ有効です。 742 </para> 743 <para> 744 <!-- 745 This parameter can only be set at server start. 746 --> 747 このパラメータは、サーバの起動時にのみ設定できます。 748 </para> 749 </listitem> 750 </varlistentry> 751 752 <varlistentry id="guc-allow-multiple-failover-requests-from-node" xreflabel="allow_multiple_failover_requests_from_node"> 753 <term><varname>allow_multiple_failover_requests_from_node</varname> (<type>boolean</type>) 754 <indexterm> 755 <!-- 756 <primary><varname>allow_multiple_failover_requests_from_node</varname> configuration parameter</primary> 757 --> 758 <primary><varname>allow_multiple_failover_requests_from_node</varname> 設定パラメータ</primary> 759 </indexterm> 760 </term> 761 <listitem> 762 <para> 763 <!-- 764 This parameter works in connection with the 765 <xref linkend="guc-failover-require-consensus">. When enabled, a single <productname>Pgpool-II</productname> 766 node can cast multiple votes for the failover. 767 --> 768 このパラメータは、<xref linkend="guc-failover-require-consensus">と連携して動作します。 769 有効にすると、単一の<productname>Pgpool-II</productname>ノードが複数のフェイルオーバ投票をできます。 770 </para> 771 <para> 772 <!-- 773 For example, in a three node watchdog cluster, if one <productname>Pgpool-II</productname> node sends two 774 failover requests for a particular backend node failover, Both requests will be counted as a separate 775 vote in the favor of the failover and <productname>Pgpool-II</productname> will execute the failover, 776 even if it does not get the vote from any other <productname>Pgpool-II</productname> node. 777 --> 778 たとえば、3ノードの<application>watchdog</application>クラスタでは、1つの<productname>Pgpool-II</productname>ノードが特定のバックエンドノードのフェイルオーバに対して2つのフェイルオーバ要求を送信すると、両方の要求が別の投票としてカウントされ、たとえ他の<productname>Pgpool-II</productname>ノードからの投票を得なくても、<productname>Pgpool-II</productname>がフェイルオーバを実行します。 779 </para> 780 <para> 781 <!-- 782 Default is off. 783 --> 784 デフォルト値はoffです。 785 </para> 786 <para> 787 <!-- 788 <varname>allow_multiple_failover_requests_from_node</varname> is not available prior to 789 <productname>Pgpool-II </productname><emphasis>V3.7</emphasis>. and it is only 790 effective when both <xref linkend="guc-failover-when-quorum-exists"> and 791 <xref linkend="guc-failover-require-consensus"> are enabled 792 --> 793 <varname>allow_multiple_failover_requests_from_node</varname>は、<productname>Pgpool-II </productname><emphasis>V3.7</emphasis>以前では利用できません。 794 <xref linkend="guc-failover-when-quorum-exists">と<xref linkend="guc-failover-require-consensus">の両方が有効な場合にのみ有効です。 795 </para> 796 <para> 797 <!-- 798 This parameter can only be set at server start. 799 --> 800 このパラメータは、サーバの起動時にのみ設定できます。 801 </para> 802 </listitem> 803 </varlistentry> 804 805 </variablelist> 806 </sect2> 807 808 <sect2 id="config-watchdog-lifecheck"> 809 <!-- 810 <title>Life checking <productname>Pgpool-II</productname> </title> 811 --> 812 <title><productname>Pgpool-II</productname>の死活監視</title> 813 814 <para> 815 <!-- 816 Watchdog checks pgpool-II status periodically. This is called "life check". 817 --> 818 Watchdogは、定期的にpgpool-IIの状態を監視します。 819 820 </para> 821 822 <variablelist> 823 824 <varlistentry id="guc-wd-lifecheck-method" xreflabel="wd_lifecheck_method"> 825 <term><varname>wd_lifecheck_method</varname> (<type>string</type>) 826 <indexterm> 827 <!-- 828 <primary><varname>wd_lifecheck_method</varname> configuration parameter</primary> 829 --> 830 <primary><varname>wd_lifecheck_method</varname>設定パラメータ</primary> 831 </indexterm> 832 </term> 833 <listitem> 834 <para> 835 <!-- 836 Specifies the method of life check. This can be either of <literal>'heartbeat'</literal> (default), 837 <literal>'query'</literal> or <literal>'external'</literal>. 838 --> 839 死活監視の方法を指定します。 840 指定できる値は <literal>'heartbeat'</literal> (デフォルト)、<literal>'query'</literal>、または<literal>'external'</literal> です。 841 </para> 842 <para> 843 <!-- 844 <literal>heartbeat</literal>: In this mode, watchdog sends the heartbeat singals (<acronym>UDP</acronym> packets) 845 periodically to other <productname>Pgpool-II</productname>. Similarly watchdog also receives the signals 846 from other <productname>Pgpool-II</productname> . 847 If there are no signal for a certain period, watchdog regards is as failure 848 of the <productname>Pgpool-II</productname> . 849 --> 850 <literal>'heartbeat'</literal>を指定した場合には、監視は「ハートビートモード」で行われます。 851 watchdog は一定間隔でハートビート信号(UDP パケット)を他の<productname>Pgpool-II</productname>へ送信します。 852 またwatchdogは他の<productname>Pgpool-II</productname>から送られてくる信号を受信します。 853 これが一定時間以上途絶えた場合にはその<productname>Pgpool-II</productname>に障害が発生したと判断します。 854 </para> 855 <para> 856 <!-- 857 <literal>query</literal>: In this mode, watchdog sends the monitoring queries 858 to other <productname>Pgpool-II</productname> and checks the response 859 --> 860 <literal>query</literal>: このモードではwatchdogは監視用のクエリを<productname>Pgpool-II</productname>に発行し、それが成功するかどうかで pgpool-II が生きているかどうかを判断します。 861 <caution> 862 <para> 863 <!-- 864 In query mode, you need to set <xref linkend="guc-num-init-children"> 865 large enough if you plan to use watchdog. 866 This is because the watchdog process connects to 867 <productname>Pgpool-II</productname> as a client. 868 --> 869 クエリモードでは、<xref linkend="guc-num-init-children">を十分大きな値にしてください。 870 watchdogプロセスも<productname>Pgpool-II</productname>にクライアントとして接続するからです。 871 </para> 872 </caution> 873 </para> 874 <para> 875 <!-- 876 <literal>external</literal>: This mode disables the built 877 in lifecheck of <productname>Pgpool-II</productname> watchdog 878 and relies on external system to provide node health checking 879 of local and remote watchdog nodes. 880 --> 881 <literal>external</literal>: このモードでは、<productname>Pgpool-II</productname>に組み込みの死活監視は無効になり、watchdogはローカルとリモートのノード死活監視を行うために外部システムを使います。 882 </para> 883 884 <para> 885 <!-- 886 <literal>external</literal> mode is not available in versions prior to 887 <productname>Pgpool-II</productname> <emphasis>V3.5</emphasis>. 888 --> 889 <literal>external</literal>モードは<productname>Pgpool-II</productname> <emphasis>V3.5</emphasis>よりも前のバージョンでは提供されていません。 890 </para> 891 892 <para> 893 <!-- 894 This parameter can only be set at server start. 895 --> 896 このパラメータは、サーバ起動時にのみ設定できます。 897 </para> 898 </listitem> 899 </varlistentry> 900 901 <varlistentry id="guc-wd-monitoring-interfaces-list" xreflabel="wd_monitoring_interfaces_list"> 902 <term><varname>wd_monitoring_interfaces_list</varname> (<type>string</type>) 903 <indexterm> 904 <!-- 905 <primary><varname>wd_monitoring_interfaces_list</varname> configuration parameter</primary> 906 --> 907 <primary><varname>wd_monitoring_interfaces_list</varname>設定パラメータ</primary> 908 </indexterm> 909 </term> 910 <listitem> 911 <para> 912 <!-- 913 Specify a comma separated list of network device names, to be monitored by the watchdog process 914 for the network link state. If all network interfaces in the list becomes inactive 915 (disabled or cable unplugged), the watchdog will consider it as a complete network failure 916 and the <productname>Pgpool-II</productname> node will commit the suicide. 917 Specifying an <literal>''</literal>(empty) list disables the network interface monitoring. 918 Setting it to <literal>'any'</literal> enables the monitoring on all available network interfaces 919 except the loopback. Default is <literal>''</literal> empty list (monitoring disabled). 920 --> 921 watchdogプロセスがネットワークリンクの状態を監視するネットワークデバイス名をカンマ区切りのリストで指定します。 922 リスト中の全てのネットワークインタフェースが(無効化あるいはケーブルを抜かれることで)非アクティブになると、watchdog はネットワークが完全に故障したと見なし自らを停止させませす。 923 <literal>''</literal>(空文字)を指定するとネットワークインタフェースの監視が無効になります。 924 <literal>'any'</literal>を指定すると、ループバック以外の存在する全てのネットワークインタフェースを監視します。 925 デフォルトの値は<literal>''</literal>空リスト '' (監視は無効)です。 926 </para> 927 928 <para> 929 <!-- 930 <varname>wd_monitoring_interfaces_list</varname> is not available in versions prior to 931 <productname>Pgpool-II</productname> <emphasis>V3.5</emphasis>. 932 --> 933 <varname>wd_monitoring_interfaces_list</varname>は、<productname>Pgpool-II</productname> <emphasis>V3.5</emphasis>よりも前のバージョンでは提供されていません。 934 </para> 935 936 <para> 937 <!-- 938 This parameter can only be set at server start. 939 --> 940 このパラメータは、サーバ起動時にのみ設定できます。 941 </para> 942 </listitem> 943 </varlistentry> 944 945 <varlistentry id="guc-wd-interval" xreflabel="wd_interval"> 946 <term><varname>wd_interval</varname> (<type>integer</type>) 947 <indexterm> 948 <primary><varname>wd_interval</varname> configuration parameter</primary> 949 <!-- 950 <primary><varname>wd_interval</varname>設定パラメータ</primary> 951 --> 952 </indexterm> 953 </term> 954 <listitem> 955 <para> 956 <!-- 957 Specifies the interval between life checks of <productname>Pgpool-II</productname> 958 in seconds. (A number greater than or equal to 1) Default is 10. 959 --> 960 <productname>Pgpool-II</productname>が死活監視を行う間隔を秒単位で指定します(1以上の数字)。 961 デフォルトは10です。 962 </para> 963 964 <para> 965 <!-- 966 This parameter can only be set at server start. 967 --> 968 このパラメータは、サーバ起動時にのみ設定できます。 969 </para> 970 </listitem> 971 </varlistentry> 972 973 <varlistentry id="guc-wd-priority" xreflabel="wd_priority"> 974 <term><varname>wd_priority</varname> (<type>integer</type>) 975 <indexterm> 976 <!-- 977 <primary><varname>wd_priority</varname> configuration parameter</primary> 978 --> 979 <primary><varname>wd_priority</varname>設定パラメータ</primary> 980 </indexterm> 981 </term> 982 <listitem> 983 <para> 984 <!-- 985 This parameter can be used to elevate the local watchdog node priority in the elections 986 to select master watchdog node. 987 The node with the higher <varname>wd_priority</varname> value will get selected 988 as master watchdog node when cluster will be electing its new master node 989 in the event of old master watchdog node failure. 990 <varname>wd_priority</varname> is also valid at the time of cluster startup. 991 When some watchdog nodes start up at same time,a node with the higher <varname>wd_priority</varname> 992 value is selected as a master node. 993 So we should start watchdog nodes in order of <varname>wd_priority</varname> priority to prevent 994 unintended nodes from being selected as masters. 995 --> 996 このパラメータによってローカルのwatchdogノードがマスターに選ばれる優先度を上げることができます。 997 古いマスターノードが故障した状況でクラスタがマスターノードの選択を行う際に、<varname>wd_priority</varname>が高いノードがマスターwatchdogノードに選ばれます。 998 <varname>wd_priority</varname>はクラスタの初期起動時にも有効なので、 999 複数のwatchdogノードを同時に起動した場合、<varname>wd_priority</varname>が高いノードがマスターwatchdogノードに選ばれます。 1000 このため、watchdogノードは意図しないノードがマスターに選ばれることが無いように<varname>wd_priority</varname>の優先順位が高い順に起動するべきです。 1001 </para> 1002 <para> 1003 <!-- 1004 <varname>wd_priority</varname> is not available in versions prior to 1005 <productname>Pgpool-II</productname> <emphasis>V3.5</emphasis>. 1006 --> 1007 <varname>wd_priority</varname>は、<productname>Pgpool-II</productname> <emphasis>V3.5</emphasis>よりも前のバージョンでは提供されていません。 1008 </para> 1009 1010 <para> 1011 <!-- 1012 This parameter can only be set at server start. 1013 --> 1014 このパラメータは、サーバ起動時にのみ設定できます。 1015 </para> 1016 </listitem> 1017 </varlistentry> 1018 1019 <varlistentry id="guc-wd-ipc-socket-dir" xreflabel="wd_ipc_socket_dir"> 1020 <term><varname>wd_ipc_socket_dir</varname> (<type>string</type>) 1021 <indexterm> 1022 <!-- 1023 <primary><varname>wd_ipc_socket_dir</varname> configuration parameter</primary> 1024 --> 1025 <primary><varname>wd_ipc_socket_dir</varname>設定パラメータ</primary> 1026 </indexterm> 1027 </term> 1028 <listitem> 1029 <para> 1030 <!-- 1031 The directory where the <acronym>UNIX</acronym> domain socket 1032 accepting <productname>Pgpool-II</productname> 1033 watchdog <acronym>IPC</acronym> connections will be created. 1034 Default is <literal>'/tmp'</literal>. 1035 Be aware that this socket might be deleted by a cron job. 1036 We recommend to set this value to <literal>'/var/run'</literal> or such directory. 1037 --> 1038 <productname>Pgpool-II</productname> watchdog の<acronym>IPC</acronym>通信で受け付ける UNIX ドメインソケットが作成されるディレクトリを指定します。 1039 デフォルトは<literal>'/tmp'</literal>です。 1040 このソケットが cron ジョブで削除されることのないよう気をつけてください。 1041 この値は <literal>'/var/run'</literal>などのディレクトリに設定することを推奨します。 1042 </para> 1043 <para> 1044 <!-- 1045 <varname>wd_ipc_socket_dir</varname> is not available in versions prior to 1046 <productname>Pgpool-II</productname> <emphasis>V3.5</emphasis>. 1047 --> 1048 <varname>wd_ipc_socket_dir</varname>は、<productname>Pgpool-II</productname> <emphasis>V3.5</emphasis>よりも前のバージョンでは提供されていません。 1049 </para> 1050 <para> 1051 <!-- 1052 This parameter can only be set at server start. 1053 --> 1054 このパラメータは、サーバ起動時にのみ設定できます。 1055 </para> 1056 </listitem> 1057 </varlistentry> 1058 1059 </variablelist> 1060 </sect2> 1061 1062 <sect2 id="config-watchdog-lifecheck-heartbeat"> 1063 <!-- 1064 <title>Lifecheck Heartbeat mode configuration</title> 1065 --> 1066 <title>死活監視:ハートビートモードの設定</title> 1067 1068 <variablelist> 1069 <varlistentry id="guc-wd-heartbeat-port" xreflabel="wd_heartbeat_port"> 1070 <term><varname>wd_heartbeat_port</varname> (<type>integer</type>) 1071 <indexterm> 1072 <!-- 1073 <primary><varname>wd_heartbeat_port</varname> configuration parameter</primary> 1074 --> 1075 <primary><varname>wd_heartbeat_port</varname>設定パラメータ</primary> 1076 </indexterm> 1077 </term> 1078 <listitem> 1079 <para> 1080 <!-- 1081 Specifies the <acronym>UDP</acronym> port number to receive heartbeat signals. 1082 Default is 9694. 1083 <varname>wd_heartbeat_port</varname> is only applicable if the 1084 <xref linkend="guc-wd-lifecheck-method"> is set to <literal>'heartbeat'</literal> 1085 --> 1086 ハートビート信号を受信する<acronym>UDP</acronym>ポート番号を指定します。 1087 デフォルトは 9694 です。 1088 <xref linkend="guc-wd-lifecheck-method">が<literal>'heartbeat'</literal>に設定されている場合のみ有効です。 1089 </para> 1090 <para> 1091 <!-- 1092 This parameter can only be set at server start. 1093 --> 1094 このパラメータは、サーバ起動時にのみ設定できます。 1095 </para> 1096 </listitem> 1097 </varlistentry> 1098 1099 <varlistentry id="guc-wd-heartbeat-keepalive" xreflabel="wd_heartbeat_keepalive"> 1100 <term><varname>wd_heartbeat_keepalive</varname> (<type>integer</type>) 1101 <indexterm> 1102 <!-- 1103 <primary><varname>wd_heartbeat_keepalive</varname> configuration parameter</primary> 1104 --> 1105 <primary><varname>wd_heartbeat_keepalive</varname>設定パラメータ</primary> 1106 </indexterm> 1107 </term> 1108 <listitem> 1109 <para> 1110 <!-- 1111 Specifies the interval time in seconds between sending the heartbeat signals. 1112 Default is 2. 1113 <varname>wd_heartbeat_keepalive</varname> is only applicable if the 1114 <xref linkend="guc-wd-lifecheck-method"> is set to <literal>'heartbeat'</literal> 1115 --> 1116 ハートビート信号を送信する間隔(秒)を指定します。 1117 デフォルトは2です。 1118 <varname>wd_heartbeat_keepalive</varname>は、<xref linkend="guc-wd-lifecheck-method">が<literal>'heartbeat'</literal>に設定されている場合のみ有効です。 1119 </para> 1120 1121 <para> 1122 <!-- 1123 This parameter can only be set at server start. 1124 --> 1125 このパラメータは、サーバ起動時にのみ設定できます。 1126 </para> 1127 </listitem> 1128 </varlistentry> 1129 1130 <varlistentry id="guc-wd-heartbeat-deadtime" xreflabel="wd_heartbeat_deadtime"> 1131 <term><varname>wd_heartbeat_deadtime</varname> (<type>integer</type>) 1132 <indexterm> 1133 <!-- 1134 <primary><varname>wd_heartbeat_deadtime</varname> configuration parameter</primary> 1135 --> 1136 <primary><varname>wd_heartbeat_deadtime</varname>設定パラメータ</primary> 1137 </indexterm> 1138 </term> 1139 <listitem> 1140 <para> 1141 <!-- 1142 Specifies the time in seconds before marking the remote watchdog node as failed/dead node, 1143 if no heartbeat signal is received within that time. 1144 DDefault is <literal>30</literal> 1145 <varname>wd_heartbeat_deadtime</varname> is only applicable if the 1146 <xref linkend="guc-wd-lifecheck-method"> is set to <literal>'heartbeat'</literal> 1147 --> 1148 このオプションで指定された間隔(秒)の間ハートビート信号が途絶えた場合、リモートのwatchdogに障害が発生したとみなされます。 1149 デフォルトは<literal>30</literal>です。 1150 </para> 1151 <para> 1152 <!-- 1153 This parameter can only be set at server start. 1154 --> 1155 このパラメータは、サーバ起動時にのみ設定できます。 1156 </para> 1157 1158 </listitem> 1159 </varlistentry> 1160 <varlistentry id="guc-heartbeat-destination" xreflabel="heartbeat_destination<emphasis>0</emphasis>"> 1161 <term><varname>heartbeat_destination0</varname> (<type>string</type>) 1162 <indexterm> 1163 <!-- 1164 <primary><varname>heartbeat_destination</varname> configuration parameter</primary> 1165 --> 1166 <primary><varname>heartbeat_destination</varname>設定パラメータ</primary> 1167 </indexterm> 1168 </term> 1169 <listitem> 1170 <para> 1171 <!-- 1172 Specifies the <acronym>IP</acronym> address or <acronym>hostname</acronym> of destination the remote 1173 <productname>Pgpool-II</productname> for sending the heartbeat signals. 1174 Multiple destinations can be configured for the heartbeat singnals, 1175 the number at the end of the parameter name is 1176 referred as the "destination number", that starts from 0. 1177 --> 1178 ハートビート信号の送る先の<acronym>IP</acronym>アドレスまたは <acronym>ホスト名</acronym>を指定します。 1179 複数のハートビート信号の送り先が指定可能です。 1180 0から始まるパラメータの最後の部分は送り先の番号です。 1181 </para> 1182 <para> 1183 <!-- 1184 <varname>heartbeat_destination</varname> is only applicable if the 1185 <xref linkend="guc-wd-lifecheck-method"> is set to <literal>'heartbeat'</literal> 1186 --> 1187 <varname>heartbeat_destination</varname>は、<xref linkend="guc-wd-lifecheck-method">が<literal>'heartbeat'</literal>に設定されている場合のみ有効です。 1188 </para> 1189 <para> 1190 <!-- 1191 This parameter can only be set at server start. 1192 --> 1193 このパラメータは、サーバ起動時にのみ設定できます。 1194 </para> 1195 </listitem> 1196 </varlistentry> 1197 1198 <varlistentry id="guc-heartbeat-destination-port" xreflabel="heartbeat_destination_port<emphasis>0</emphasis>"> 1199 <term><varname>heartbeat_destination_port0</varname> (<type>integer</type>) 1200 <indexterm> 1201 <!-- 1202 <primary><varname>heartbeat_destination_port</varname> configuration parameter</primary> 1203 --> 1204 <primary><varname>heartbeat_destination_port</varname>設定パラメータ</primary> 1205 </indexterm> 1206 </term> 1207 <listitem> 1208 <para> 1209 <!-- 1210 Specifies the destination port number for the heartbeat_destinationX of the remote 1211 <productname>Pgpool-II</productname> for sending the heartbeat signals. 1212 Multiple destinations can be configured for the heartbeat singnals, 1213 the number at the end of the parameter name is 1214 referred as the "destination number", that starts from 0. 1215 --> 1216 ハートビート信号の送る先のポート番号を指定します。 1217 複数のハートビート信号の送り先が指定可能です。 1218 0から始まるパラメータの最後の部分は送り先の番号です。 1219 </para> 1220 <para> 1221 <!-- 1222 <varname>heartbeat_destination_port</varname> is only applicable if the 1223 <xref linkend="guc-wd-lifecheck-method"> is set to <literal>'heartbeat'</literal> 1224 --> 1225 <varname>heartbeat_destination_port</varname>は、<xref linkend="guc-wd-lifecheck-method"> が <literal>'heartbeat'</literal>に設定されている場合のみ有効です。 1226 </para> 1227 <para> 1228 <!-- 1229 This parameter can only be set at server start. 1230 --> 1231 このパラメータは、サーバ起動時にのみ設定できます。 1232 </para> 1233 </listitem> 1234 </varlistentry> 1235 1236 <varlistentry id="guc-heartbeat-device" xreflabel="heartbeat_device"> 1237 <term><varname>heartbeat_device0</varname> (<type>string</type>) 1238 <indexterm> 1239 <!-- 1240 <primary><varname>heartbeat_device</varname> configuration parameter</primary> 1241 --> 1242 <primary><varname>heartbeat_device</varname>設定パラメータ</primary> 1243 </indexterm> 1244 </term> 1245 <listitem> 1246 <para> 1247 <!-- 1248 Specifies the network device name for sending the heartbeat signals to the destination specified by 1249 heartbeat_destinationX:heartbeat_destination_portX. 1250 Different heartbeat devices can be configured for each heartbeat destination 1251 by changing the value of X(destination number) 1252 at the end of parameter name. The destination index number starts from 0. 1253 --> 1254 heartbeat_destinationX:heartbeat_destination_portXで指定されるハートビートの送信先に用いるネットワークデバイス名を指定します。 1255 パラメータ名の最後にあるXの値(送信先番号)を変えることにより、ハートビートの送信先ごとに異なるハートビートデバイス番号を設定することが可能です。 1256 送信先番号は0から始まります。 1257 </para> 1258 <para> 1259 <!-- 1260 <varname>heartbeat_device</varname> is only applicable if the 1261 <xref linkend="guc-wd-lifecheck-method"> is set to <literal>'heartbeat'</literal> 1262 --> 1263 <varname>heartbeat_device</varname>は、<productname>Pgpool-II</productname>をroot権限で起動しているときのみ使用可能です。 1264 それ以外の場合は空文字('')のままにしておいてください。 1265 </para> 1266 <para> 1267 <varname>heartbeat_device</varname>は、<xref linkend="guc-wd-lifecheck-method">が<literal>'heartbeat'</literal>に設定されている場合のみ有効です。 1268 </para> 1269 <para> 1270 <!-- 1271 This parameter can only be set at server start. 1272 --> 1273 このパラメータは、サーバ起動時にのみ設定できます。 1274 </para> 1275 </listitem> 1276 </varlistentry> 1277 1278 </variablelist> 1279 </sect2> 1280 1281 <sect2 id="config-watchdog-lifecheck-query"> 1282 <title>死活監視:クエリモードの設定</title> 1283 <variablelist> 1284 1285 <varlistentry id="guc-wd-life-point" xreflabel="wd_life_point"> 1286 <term><varname>wd_life_point</varname> (<type>integer</type>) 1287 <indexterm> 1288 <!-- 1289 <primary><varname>wd_life_point</varname> configuration parameter</primary> 1290 --> 1291 <primary><varname>wd_life_point</varname>設定パラメータ</primary> 1292 </indexterm> 1293 </term> 1294 <listitem> 1295 <para> 1296 <!-- 1297 Specifies the number of times to retry a failed life check of pgpool-II. 1298 Valid value could be a number greater than or equal to 1. 1299 Default is 3. 1300 --> 1301 監視クエリの応答が得られなかった場合のリトライ回数を指定します。 1302 有効な値は1以上の整数です。 1303 デフォルトは3です。 1304 </para> 1305 <para> 1306 <!-- 1307 <varname>wd_life_point</varname> is only applicable if the 1308 <xref linkend="guc-wd-lifecheck-method"> is set to <literal>'query'</literal> 1309 --> 1310 <xref linkend="guc-wd-lifecheck-method">が<literal>'query'</literal>の場合のみ、<varname>wd_life_point</varname>は有効です。 1311 </para> 1312 <para> 1313 <!-- 1314 This parameter can only be set at server start. 1315 --> 1316 このパラメータは、サーバ起動時にのみ設定できます。 1317 </para> 1318 </listitem> 1319 </varlistentry> 1320 1321 <varlistentry id="guc-wd-lifecheck-query" xreflabel="wd_lifecheck_query"> 1322 <term><varname>wd_lifecheck_query</varname> (<type>string</type>) 1323 <indexterm> 1324 <!-- 1325 <primary><varname>wd_lifecheck_query</varname> configuration parameter</primary> 1326 --> 1327 <primary><varname>wd_lifecheck_query</varname>設定パラメータ</primary> 1328 </indexterm> 1329 </term> 1330 <listitem> 1331 <para> 1332 <!-- 1333 Specifies the query to use for the life check of remote <productname>Pgpool-II</productname>. 1334 Default is <literal>"SELECT 1"</literal>. 1335 --> 1336 リモートの<productname>Pgpool-II</productname>の死活監視に使うクエリを指定します。 1337 デフォルトは<literal>"SELECT 1"</literal>です。 1338 </para> 1339 <para> 1340 <!-- 1341 <varname>wd_lifecheck_query</varname> is only applicable if the 1342 <xref linkend="guc-wd-lifecheck-method"> is set to <literal>'query'</literal> 1343 --> 1344 <xref linkend="guc-wd-lifecheck-method">が<literal>'query'</literal>の場合のみ、<varname>wd_lifecheck_query</varname>は有効です。 1345 </para> 1346 <para> 1347 <!-- 1348 This parameter can only be set at server start. 1349 --> 1350 このパラメータは、サーバ起動時にのみ設定できます。 1351 </para> 1352 </listitem> 1353 </varlistentry> 1354 1355 <varlistentry id="guc-wd-lifecheck-dbname" xreflabel="wd_lifecheck_dbname"> 1356 <term><varname>wd_lifecheck_dbname</varname> (<type>string</type>) 1357 <indexterm> 1358 <!-- 1359 <primary><varname>wd_lifecheck_dbname</varname> configuration parameter</primary> 1360 --> 1361 <primary><varname>wd_lifecheck_dbname</varname>設定パラメータ</primary> 1362 </indexterm> 1363 </term> 1364 <listitem> 1365 <para> 1366 <!-- 1367 Specifies the database name for the connection used for the 1368 life check of remote <productname>Pgpool-II</productname>. 1369 Default is <literal>"template1"</literal>. 1370 --> 1371 リモートの<productname>Pgpool-II</productname>の死活監視用の接続先のデータベース名です。 1372 デフォルトは<literal>'template1'</literal>です。 1373 </para> 1374 <para> 1375 <!-- 1376 <varname>wd_lifecheck_dbname</varname> is only applicable if the 1377 <xref linkend="guc-wd-lifecheck-method"> is set to <literal>'query'</literal> 1378 --> 1379 <xref linkend="guc-wd-lifecheck-method">が<literal>'query'</literal>の場合のみ、<varname>wd_lifecheck_dbname</varname>は有効です。 1380 </para> 1381 <para> 1382 <!-- 1383 This parameter can only be set at server start. 1384 --> 1385 このパラメータは、サーバ起動時にのみ設定できます。 1386 </para> 1387 </listitem> 1388 </varlistentry> 1389 1390 <varlistentry id="guc-wd-lifecheck-user" xreflabel="wd_lifecheck_user"> 1391 <term><varname>wd_lifecheck_user</varname> (<type>string</type>) 1392 <indexterm> 1393 <!-- 1394 <primary><varname>wd_lifecheck_user</varname> configuration parameter</primary> 1395 --> 1396 <primary><varname>wd_lifecheck_user</varname>設定パラメータ</primary> 1397 </indexterm> 1398 </term> 1399 <listitem> 1400 <para> 1401 <!-- 1402 Specifies the user name for the connection used for the life 1403 check of remote <productname>Pgpool-II</productname>. 1404 Default is <literal>"nobody"</literal>. 1405 --> 1406 リモートの<productname>Pgpool-II</productname>の死活監視用の接続先のユーザ名です。 1407 デフォルトは<literal>'nobody'</literal>です。 1408 </para> 1409 <para> 1410 <!-- 1411 <varname>wd_lifecheck_user</varname> is only applicable if the 1412 <xref linkend="guc-wd-lifecheck-method"> is set to <literal>'query'</literal> 1413 --> 1414 <xref linkend="guc-wd-lifecheck-method">が<literal>'query'</literal>の場合のみ、<varname>wd_lifecheck_user</varname>は有効です。 1415 </para> 1416 <para> 1417 <!-- 1418 This parameter can only be set at server start. 1419 --> 1420 このパラメータは、サーバ起動時にのみ設定できます。 1421 </para> 1422 </listitem> 1423 </varlistentry> 1424 1425 <varlistentry id="guc-wd-lifecheck-password" xreflabel="wd_lifecheck_password"> 1426 <term><varname>wd_lifecheck_password</varname> (<type>string</type>) 1427 <indexterm> 1428 <!-- 1429 <primary><varname>wd_lifecheck_password</varname> configuration parameter</primary> 1430 --> 1431 <primary><varname>wd_lifecheck_password</varname>設定パラメータ</primary> 1432 </indexterm> 1433 </term> 1434 <listitem> 1435 <para> 1436 <!-- 1437 Specifies the password for the user used for the life check of remote <productname>Pgpool-II</productname>. 1438 Default is <literal>''</literal>(empty). 1439 --> 1440 リモートの<productname>Pgpool-II</productname>の死活監視用の接続先のパスワードです。 1441 デフォルトは<literal>''</literal>(空文字)です。 1442 </para> 1443 <para> 1444 <!-- 1445 <varname>wd_lifecheck_password</varname> is only applicable if the 1446 <xref linkend="guc-wd-lifecheck-method"> is set to <literal>'query'</literal> 1447 --> 1448 <xref linkend="guc-wd-lifecheck-method">が<literal>'query'</literal>の場合のみ、<varname>wd_lifecheck_password</varname>は有効です。 1449 </para> 1450 <para> 1451 <!-- 1452 This parameter can only be set at server start. 1453 --> 1454 このパラメータは、サーバ起動時にのみ設定できます。 1455 </para> 1456 </listitem> 1457 </varlistentry> 1458 1459 </variablelist> 1460 </sect2> 1461 1462 <sect2 id="config-watchdog-server-configuration"> 1463 <!-- 1464 <title>Watchdog servers configurations</title> 1465 --> 1466 <title>Watchdogサーバの設定</title> 1467 <variablelist> 1468 1469 <varlistentry id="guc-other-pgpool-hostname" xreflabel="other_pgpool_hostname"> 1470 <term><varname>other_pgpool_hostname0</varname> (<type>string</type>) 1471 <indexterm> 1472 <!-- 1473 <primary><varname>other_pgpool_hostname</varname> configuration parameter</primary> 1474 --> 1475 <primary><varname>other_pgpool_hostname</varname>設定パラメータ</primary> 1476 </indexterm> 1477 </term> 1478 <listitem> 1479 <para> 1480 <!-- 1481 Specifies the hostname of remote <productname>Pgpool-II</productname> server for watchdog node. 1482 The number at the end of the parameter name is referred as "server id", and it starts from 0. 1483 --> 1484 リモートのwatchdogノードに対する<productname>Pgpool-II</productname>サーバのホスト名を指定します。 1485 パラメータ名の最後にある数字は「サーバ番号」で、0から始まります。 1486 </para> 1487 <para> 1488 <!-- 1489 This parameter can only be set at server start. 1490 --> 1491 このパラメータは、サーバ起動時にのみ設定できます。 1492 </para> 1493 </listitem> 1494 </varlistentry> 1495 1496 <varlistentry id="guc-other-pgpool-port" xreflabel="other_pgpool_port"> 1497 <term><varname>other_pgpool_port0</varname> (<type>integer</type>) 1498 <indexterm> 1499 <!-- 1500 <primary><varname>other_pgpool_port</varname> configuration parameter</primary> 1501 --> 1502 <primary><varname>other_pgpool_port</varname>設定パラメータ</primary> 1503 </indexterm> 1504 </term> 1505 <listitem> 1506 <para> 1507 <!-- 1508 Specifies the port number of the remote <productname>Pgpool-II</productname> 1509 server for watchdog node. 1510 The number at the end of the parameter name is referred 1511 as "server id", and it starts from 0. 1512 --> 1513 リモートのwatchdogノードに対する<productname>Pgpool-II</productname>サーバのポート番号を指定します。 1514 パラメータ名の最後にある数字は「サーバ番号」で、0から始まります。 1515 </para> 1516 <para> 1517 <!-- 1518 This parameter can only be set at server start. 1519 --> 1520 このパラメータは、サーバ起動時にのみ設定できます。 1521 </para> 1522 </listitem> 1523 </varlistentry> 1524 1525 <varlistentry id="guc-other-wd-port" xreflabel="other_wd_port"> 1526 <term><varname>other_wd_port0</varname> (<type>integer</type>) 1527 <indexterm> 1528 <!-- 1529 <primary><varname>other_wd_port0</varname> configuration parameter</primary> 1530 --> 1531 <primary><varname>other_wd_port0</varname>設定パラメータ</primary> 1532 </indexterm> 1533 </term> 1534 <listitem> 1535 <para> 1536 <!-- 1537 Specifies the watchdog port number of the remote 1538 <productname>Pgpool-II</productname> server for watchdog node. 1539 The number at the end of the parameter name is referred 1540 as "server id", and it starts from 0. 1541 --> 1542 リモートの<productname>Pgpool-II</productname>サーバにおけるwatchdogのポート番号を指定します。 1543 パラメータ名の最後にある数字は「サーバ番号」で、0から始まります。 1544 </para> 1545 <para> 1546 <!-- 1547 This parameter can only be set at server start. 1548 --> 1549 このパラメータは、サーバ起動時にのみ設定できます。 1550 </para> 1551 </listitem> 1552 </varlistentry> 1553 1554 </variablelist> 1555 </sect2> 1556</sect1> 1557