pg_createcluster-クラウドでのオンライン

プログラム：

NAME

pg_createcluster-新しいPostgreSQLクラスターを作成します

SYNOPSIS

pg_createcluster [オプション] バージョン 名 [-- initdb オプション]

DESCRIPTION

pg_createcluster 新しいPostgreSQLサーバークラスター（つまり、データベースのコレクション）を作成します
によって提供 ポストマスター（1）インスタンス）そしてそれをマルチバージョン/マルチクラスターに統合します
のアーキテクチャ postgresql-共通 パッケージ。

すべてのクラスターは、そのバージョンと名前によって一意に識別されます。 名前は任意にすることができます。
サーバーパッケージのインストール時に作成されるデフォルトのクラスターはメインです。 でも、
他のスーパーユーザーと一緒に、テスト用に他のクラスターを作成することもできます。
共有サーバーなどの各ユーザー。pg_createclusterを実行しようとすると、エラーが発生して中止されます。
そのバージョンにすでに存在する名前でクラスターを作成します。

互換性のため systemd サービスユニットの場合、クラスタ名には何も含まれていてはなりません
ダッシュ（-). pg_ctlcluster 問題について警告しますが、操作は成功します。

主要なPostgreSQLを考えると バージョン （「8.2」や「8.3」など）とクラスター 名、それは作成します
/ etc / postgresql /にある必要な構成ファイルバージョン/名/; 特にこれらは
postgresql.conf、pg_ident.conf、pg_hba.conf、postgresql-一般的な特定の構成
ファイルstart.conf（を参照） 起動 CONTROL 以下）、pg_ctl.conf、およびシンボリックリンクログ
ログファイルを指します（デフォルトでは、/ var / log / postgresql / postgresql-バージョン-名。ログ）。

postgresql.confは、次に使用可能なポート、つまり最初のポートを使用するように自動的に調整されます
既存のクラスターによってまだ使用されていないポート（5432以降）。

データディレクトリがまだ存在しない場合、PostgreSQLの initdb（1）コマンドは
新しいクラスター構造を生成します。 データディレクトリがすでに存在する場合は、統合されます
に postgresql-共通 構成ファイルを移動し、
data_directoryオプション。 これに注意してください の だったデータディレクトリのために働く
で直接作成 initdb、つまりすべての構成ファイル（postgresql.confなど）
データディレクトリに存在する必要があります。

カスタムソケットディレクトリが指定されていて、それが存在しない場合は、作成されます。

ログファイルが存在しない場合は作成されます。 いずれの場合も、権限は次のように調整されます
クラスタ所有者への書き込みアクセスを許可します。 postgresql.confは次のようになる可能性があることに注意してください
log_directoryおよび/またはlog_filenameを指定するようにカスタマイズされています。 これらのオプションの少なくともXNUMXつが
が存在する場合、クラスタ構成ディレクトリのシンボリックリンクログは無視されます。

デフォルトのスネークオイルSSL証明書が存在する場合（/etc/ssl/certs/ssl-cert-snakeoil.pem 　
/etc/ssl/private/ssl-cert-snakeoil.key）、postgresユーザーはssl-certUnixを使用しています
グループ、 pg_createcluster この証明書を使用するようにクラスターを構成し、SSLを有効にします。
したがって、すべてのクラスターはデフォルトで同じSSL証明書を使用します。 最大バージョンの場合
9.1、データディレクトリにシンボリックリンクが作成されます（server.crtおよびserver.key）。 9.2の場合
その後、適切なpostgresql.confオプションが設定されます（ssl_cert_fileおよび
ssl_key_file）。 もちろん、これをクラスター固有の証明書に置き換えることができます。
同様に、/ etc / postgresql-common /root.crtおよび/etc/postgresql-common/root.crlの場合、これらは
ファイルは、存在する場合、クライアント証明書CAおよび失効リストとして構成されます。
（root.crtは最初は、実際の証明書が追加された場合にのみ使用されるプレースホルダーです。
ファイルに。）

OPTIONS

-u user, --user =user
クラスタを所有し、データベースのスーパーユーザーになるユーザーを指定された名前に設定します
またはuid。 デフォルトでは、これはユーザーです ポストグレス。 クラスターはrootが所有してはなりません。

-g グループヘッド, --group =グループヘッド
クラスター関連のデータファイルのグループを変更します。 デフォルトでは、これは
データベース所有者のプライマリグループ。

-d DIR, --datadir =DIR
実際のすべてを保存するために使用されるデータディレクトリパスを明示的に設定します
データベースとテーブル。 これはかなり大きくなります（簡単にXNUMX倍程度）
クラスタに保存されている実際のデータの量）。 デフォルトは
/ var / lib / postgresql /バージョン/ .

-s DIR, --socketdir =DIR
明示的にディレクトリを設定します ポストマスター（1）サーバーはUnixソケットを保存します
ローカル接続。 ユーザーが所有するクラスターのデフォルトは/ var / run / postgresql /です
ポストグレス, / tmpに 他のユーザーが所有するクラスターの場合。 ご注意ください / tmpに あります
誰もがそこにソケットを作成して偽装できるため、安全でないディレクトリ
データベースサーバー。 指定されたディレクトリが存在しない場合は、適切に作成されます
パーミッション。

-l path, --logfile =path
のパスを明示的に設定します ポストマスター（1）サーバーログファイル。 デフォルトは
/ var / log / postgresql / postgresql-バージョン- 。ログ。

--locale =ローカル
データベースクラスターのデフォルトロケールを設定します。 このオプションが指定されていない場合、
ロケールは、 pg_createcluster で実行されます。

--lc-collat​​e =ローカル
--lc-ctype =ローカル
--lc-messages =ローカル
--lc-monetary =ローカル
--lc-numeric =ローカル
--lc-time =ローカル
いいね -ロケール、ただし、指定されたカテゴリのロケールのみを設定します。

-e エンコーディング, --encoding =エンコーディング
テンプレートデータベースのエンコーディングを選択します。 これはデフォルトのエンコーディングにもなります
後で上書きしない限り、後で作成するデータベースのデフォルトが派生します
ロケールから、またはそれが機能しない場合はSQL_ASCIIから。 でサポートされている文字セット
PostgreSQLサーバーについてはドキュメントで説明されています。

注意：このオプションを直接設定することはお勧めしません！ 代わりにロケールを設定してください。

-p ポート, --port =ポート
新しいクラスターがリッスンするポートを選択します（UnixソケットとTCPポートの場合）。
PostgreSQLはrootとして実行されないため、これは1024〜65535の数値である必要があります
したがって、非特権ポート番号が必要です。 デフォルトでは、次の空きポートが開始されます
5432から割り当てられます。

- 始める
クラスターを作成したらすぐにサーバーを起動します（つまり、pg_ctlclusterを呼び出します）
バージョン それから始めてください）。 デフォルトでは、クラスターは開始されません。

--start-conf = auto|マニュアル|無効
start.conf構成ファイルに初期値を設定します。 見る 起動 CONTROL を参照してください。
デフォルトでは、 オート が使用されます。これは、クラスターがによって処理されることを意味します
/etc/init.d/postgresql、つまり、システムの起動時に自動的に開始および停止します。

-o パワー=値, --pgoption パワー=値
新しいpostgresql.confファイルで設定する構成オプション。

--createclusterconf =file
Alternative createcluster.conf 使用するファイル。 デフォルトは
/etc/postgresql-common/createcluster.conf（または$ PGSYSCONFDIR / createcluster.conf）。

--environment =file
代替のデフォルト 環境 使用するファイル。 デフォルトは
/ etc / postgresql-common / environment（または$ PGSYSCONFDIR / environment）。 ファイルが
欠落している場合、プレースホルダー文字列が使用されます。 ％vと％cが置き換えられます。 デフォルト値を参照してください
を参照してください。

-- initdb オプション
に直接渡されるオプション initdbとします。

デフォルトでは、 pg_createcluster initdbによって生成されたpg_hba.confファイルをに更新します
ローカル（unix）接続ではピア認証を使用し、TCP（ホスト）ではmd5を使用します
接続。 明示的な認証構成がここに含まれている場合（-A, --認証,
--認証ホスト, --認証ローカル）、pg_hba.confファイルは変更されません。

起動 CONTROL

クラスタ構成ディレクトリのstart.confファイルは、開始/停止を制御します
そのクラスターのポストマスタープロセスの動作。 ファイルにはコメント行を含めることができます（開始
'＃'）、空の行を使用し、次のキーワードのいずれかを含む行をXNUMX行だけ持つ必要があります。

オート
postmasterプロセスは、initスクリプトで自動的に開始/停止されます。 これは
また、ファイルが欠落している場合のデフォルト。

マニュアル
postmasterプロセスは、initスクリプトでは処理されませんが、手動で制御します。
クラスター pg_ctlcluster（1）許可されます。

無効
initスクリプトも pg_ctlcluster（1）クラスターの開始/停止が許可されます。
これにより、クラスター所有者が下位レベルに電話をかけるのを止めることはできないことに注意してください
ポストマスタープロセスを制御するためのツール。 このオプションは、防止することのみを目的としています
メンテナンス中の事故、それ以上ではありません。

クラスタ構成ディレクトリのpg_ctl.confファイルには、追加のオプションを含めることができます
そのクラスターのpg_ctlに渡されます。

DEFAULT VALUES

によって使用されるいくつかのデフォルト値 pg_createcluster で変更できます
/etc/postgresql-common/createcluster.conf。 の発生 %v メジャーに置き換えられます
バージョン番号、および %c クラスタ名で。 つかいます %% リテラルの場合 %.

メインクラスターの作成 （ディフォルト： true)
作る メイン 新しいpostgresql-xyサーバーパッケージがインストールされたときのクラスター。

start_conf （ディフォルト： オート)
使用するデフォルトのstart.conf値。

データディレクトリ （ディフォルト： / var / lib / postgresql /％v /％c)
デフォルトのデータディレクトリ。

xlogdir （デフォルト：未設定）
トランザクションログのデフォルトディレクトリ。 使用する場合、 initdb からシンボリックリンクを作成します
この場所へのデータディレクトリのpg_xlog。 デフォルトでは設定されていません。つまり、pg_xlogは
データディレクトリに残ります。

initdb_options （デフォルト：未設定）
渡す他のオプション initdb.

その他のオプション
リストされている他のすべてのオプションは、新しいクラスターのpostgresql.confにコピーされます。例：

listen_addresses = '*'
log_line_prefix = '%% t'

一部のpostgresql.confオプションは特別に扱われます。

SSL デフォルトのスネークオイル証明書が存在し、
上記のように、クラスター所有者が読み取り可能です。

stats_temp_directory
存在する場合にのみpostgresql.confに追加され、クラスター所有者が書き込み可能、​​または
それ以外の場合、親ディレクトリが書き込み可能である場合。

onworks.netサービスを使用してオンラインでpg_createclusterを使用する