pg_ctl start [-w] [-s] [-D datadir] [-l filename] [-o options] [-p path]
pg_ctl stop [-W] [-s] [-D datadir] [-m
s[mart] | f[ast] | i[mmediate]
]
pg_ctl restart [-w] [-s] [-D datadir] [-m
s[mart] | f[ast] | i[mmediate]
] [-o options]
pg_ctl reload [-s] [-D datadir]
pg_ctl status [-D datadir]
pg_ctl は PostgreSQL のバックエンドサーバである postmaster を起動、停止、再起動、あるいは稼働中の postmaster の状態を表示するためのユーティリティです。 postmaster は手動で起動することも可能ですが、pg_ctl はログ出力のリダイレクトや、ターミナルとプロセスグループの的確な分離などの作業をカプセル化し、さらにシャットダウン制御のための便利なオプションも提供します。
start モードでは、新しい postmaster が立ち上がります。サーバはバックグラウンドで起動され、標準入力は /dev/null に接続されます。標準出力と標準エラーは、-l オプションが使われた場合ログファイルに、そうでない場合は pg_ctl の標準出力 (標準エラー出力ではありません) にリダイレクトされます。ログファイルを指定しない場合、pg_ctl の標準出力は、ファイルにリダイレクトするか、例えばログ回転プログラムのような別プロセスにパイプで渡すべきです。 そうしないと、postmaster は出力を (バックグラウンドから) 制御ターミナルに書き出すので、シェルのプロセスグループから切り離せません。
stop モードは、指定されたデータディレクトリで稼働している postmaster を停止 (シャットダウン) します。-m オプションで 3 つの異なる停止方式を選択することができます。"Smart" モードは全てのクライアントが切断するまで待ちます。これがデフォルトです。"Fast" モードはクライアントが切断するまで待ちません。すべての実行中のトランザクションはロールバックされ、クライアントとの接続は強制的に切断され、その後データベースの停止が行なわれます。"Immediate" モードは、クリーンアップ処理なしで、全てのサーバプロセスを中断します。この指定により、再起動時に回復処理が実行されることになります。
restart モードは、効果的に停止を行い、そして次に起動を実行します。これは postmaster コマンドラインオプションの変更を可能にします。
reload モードは単に postmaster に SIGHUP シグナルを送り、(postgresql.conf、pg_hba.conf などの) 設定ファイルを再度読み込みます。これにより、完全な再起動することなく、設定ファイルのオプションの変更を反映させることができます。
status モードは postmaster が起動しているかを確認し、起動している場合は PID と、postmaster を起動する時に使われたコマンドラインオプションを表示します。
データベースファイルのファイルシステム上の場所を指定します。これが省略された場合、環境変数 PGDATA が使われます。
サーバログ出力を filename に追加します。そのファイルが存在しない場合は作成されます。 umask は 077 に設定されるため、他のユーザからのログファイルへのアクセスはデフォルトでは許可されません。
停止 (シャットダウン) モードを指定します。mode は smart、fast、または immediate、もしくはこれらの 3 つのうちのどれかの最初の文字になります。
直接 postmaster に渡されるオプションを指定します。
パラメータは通常、1 つのグループとして渡されることを保障するために、単一引用符または二重引用符で囲まれます。
postmaster の実行プログラムの位置を指定します。 デフォルトでは postmaster は pg_ctl と同じディレクトリ、そうでない場合は構築時に指定したインストールディレクトリとなります。このオプションは何か異例なことをしていて postmaster が見つからないというようなエラーが出ない限り、使う必要はありません。
エラーメッセージのみを表示し、その他の情報を表示しません。
起動もしくは停止処理が完了するのを待ちます。60 秒でタイムアウトします。停止 (シャットダウン) 処理のデフォルトです。
起動もしくは停止が完了するのを待ちません。起動と再起動のデフォルトです。
postmaster.opts.default がデータディレクトリにある場合、そのファイルの内容は -o オプションで上書きされていない限り postmaster へのオプションとして渡されます。
完全な起動を行うためにすべての条件が揃う事を待つ操作は洗練されたものではなく、もしアクセス制御の設定が、ローカルクライアントが手動による対話なしでは接続できないようになっていた場合には失敗します。これは避けるべきです。
postmaster を起動するためには下記のようにします。
$ pg_ctl start
下記は postmaster が立ち上がるまでブロックをする postmaster の起動方法の例です。
$ pg_ctl -w start
ポート 5433 を使い fsync なしで起動する postmaster は下記を使います。
$ pg_ctl -o "-F -p 5433" start
$ pg_ctl stop
これは postmaster を停止します。-m オプションを使うと どのように バックエンドを停止 (シャットダウン) させるかを制御できます。
この手順は postmaster を停止して再度起動させるのと同じですが、違うのは、pg_ctl が以前起動していたインスタンスに渡されていたコマンドラインオプションを保存し再利用することです。下記は postmaster を再起動するもっとも簡単な方法です。
$ pg_ctl restart
下記は postmaster のシャットダウンを待ってから立ち上げを行なう方法です。
$ pg_ctl -w restart
下記は、ポート 5433 を使って再起動し、再起動後に fsync を無効にする方法です。
$ pg_ctl -o "-F -p 5433" restart