<!--
doc/src/sgml/ref/pcp_promote_node.sgml
Pgpool-II documentation
-->

<refentry id="PCP-PROMOTE-NODE">
 <indexterm zone="pcp-promote-node">
  <primary>pcp_promote_node</primary>
 </indexterm>

 <refmeta>
  <refentrytitle>pcp_promote_node</refentrytitle>
  <manvolnum>1</manvolnum>
  <refmiscinfo>PCP Command</refmiscinfo>
 </refmeta>

 <refnamediv>
  <refname>pcp_promote_node</refname>
  <refpurpose>
  <!--
	promotes the given node as new master to Pgpool-II</refpurpose>
    -->
	<productname>Pgpool-II</productname> のノードをマスターに昇格させる</refpurpose>
 </refnamediv>

 <refsynopsisdiv>
  <cmdsynopsis>
   <command>pcp_promote_node</command>
   <arg rep="repeat"><replaceable>options</replaceable></arg>
   <arg><replaceable>node_id</replaceable></arg>
   <arg><replaceable>gracefully</replaceable></arg>
  </cmdsynopsis>
 </refsynopsisdiv>

 <refsect1 id="R1-PCP-PROMOTE-NODE-1">
 <!--
  <title>Description</title>
  -->
  <title>説明</title>
  <para>
  <command>pcp_promote_node</command>
  <!--
  promotes the given node as new master to Pgpool-II. In master/slave streaming replication only. Please note that this command does not actually promote standby PostgreSQL backend: it just changes the internal status of Pgpool-II and trigger failover and users have to promote standby PostgreSQL outside Pgpool-II.
  -->
  は <productname>Pgpool-II</productname> のノードをマスターに昇格させます。
  これは、マスタースレーブモードで ストリーミングレプリケーション構成の場合のみ使用できます。
  このコマンドは実際に <productname>PostgreSQL</productname> のスタンバイサーバを昇格するわけではないことに注意してください。
  単に <productname>Pgpool-II</productname> の内部ステータスを変更し、フェイルオーバするだけです。
  ですので、ユーザはこのコマンドを使う際には自分で <productname>PostgreSQL</productname> のスタンバイを昇格させるようにしてください。
  </para>
 </refsect1>

 <refsect1>
 <!--
  <title>Options</title>
  -->
  <title>オプション</title>
   <para>
    <variablelist>

     <varlistentry>
      <term><option>-n <replaceable class="parameter">node_id</replaceable></option></term>
      <term><option>--node-id=<replaceable class="parameter">node_id</replaceable></option></term>
      <listitem>
       <para>
    <!--
	 The index of backend node to promote as new master.
     -->
     マスターに昇格させるバックエンドノードのインデックスを指定します。
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><option>-g </option></term>
      <term><option>--gracefully</option></term>
      <listitem>
       <para>
       <!--
	 Wait until all clients are disconnected (unless client_idle_limit_in_recovery is -1 or recovery_timeout is expired).
     -->
     すべてのクライアントが接続を終了するまでノードを復帰しません。
     （ただし、<xref linkend="guc-client-idle-limit-in-recovery"> が -1 あるいは、
     <xref linkend="guc-recovery-timeout"> が設定されている場合を除く）
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
     <!--
      <term><option>Other options </option></term>
      -->
      <term><option>その他 </option></term>
      <listitem>
       <para>
    <!--
	 See <xref linkend="pcp-common-options">.
     -->
	 <xref linkend="pcp-common-options"> を参照してください。
       </para>
      </listitem>
     </varlistentry>

    </variablelist>
   </para>
 </refsect1>

</refentry>
