| PostgreSQL 9.1.5文書 | ||||
|---|---|---|---|---|
| 前のページ | 巻戻し | 第 15章ソースコードからインストール | 早送り | 次のページ |
構成
インストール手順の最初のステップは、システムに合わせてソースツリーを設定し、使用するオプションを選択することです。 configureスクリプトを実行することでこれを行います。 デフォルトのインストールを行う場合は、単に以下を入力してください。
./configure
mkdir build_dir cd build_dir /path/to/source/tree/configure [options go here] gmake
デフォルトの構成では、サーバ、ユーティリティの他に、Cコンパイラだけを必要とするクライアントアプリケーションやインタフェースを構築します。 デフォルトでは、全てのファイルは/usr/local/pgsql以下にインストールされます。
configureに以下のコマンドラインオプションを1つ以上指定することで、構築処理やインストール処理を変更することができます。
/usr/local/pgsqlではなく、PREFIXディレクトリ以下に全てのファイルをインストールします。 ファイルは実際には様々なサブディレクトリにインストールされ、PREFIXディレクトリの直下にインストールされるファイルはありません。
特別な必要性があるのであれば、以下のオプションを使用して個々のサブディレクトリを変更することもできます。 しかし、これらをそのまま使用した場合、インストレーションは位置再変更可能になります。 つまり、インストールの後にディレクトリを移動することができます （manとdocの場所はこの影響を受けません。）
インストールの位置再変更のために、configureの--disable-rpathを使用しようと考えるかもしれません。 その場合は、オペレーティングシステムにその共有ライブラリの場所を通知する必要があるでしょう。
アーキテクチャ依存のファイルをPREFIXの設定とは別の接頭辞EXEC-PREFIX以下にインストールすることができます。 ホスト間でアーキテクチャ非依存のファイルを共有する場合に便利です。 省略した場合、EXEC-PREFIXはPREFIXと同じに設定され、アーキテクチャに依存するファイルも非依存なファイルも同じツリー以下にインストールされます。 ほとんどの場合、これが望まれています。
実行可能プログラム用のディレクトリを指定します。 デフォルトではEXEC-PREFIX/binであり、通常/usr/local/pgsql/binとなります。
各種設定ファイル用のディレクトリを設定します。 デフォルトではPREFIX/etcです。
ライブラリや動的ロード可能モジュールをインストールする場所を設定します。 デフォルトはEXEC-PREFIX/libです。
CおよびC++のヘッダファイルをインストールするディレクトリを設定します。 デフォルトはPREFIX/includeです。
いろいろな種類の読み取り専用データファイル用のルートディレクトリを設定します。これは後述のオプションの一部についてのデフォルトを設定するだけです。デフォルトはPREFIX/shareです。
インストールプログラムが使用する読み取り専用のディレクトリを設定します。デフォルトはDATAROOTDIRです。これはインストールするデータベースファイルがどこに設置されるかとは関係ないことを覚えておいてください。
特にメッセージ翻訳カタログファイルのロケールデータをインストールするディレクトリを設定します。デフォルトはDATAROOTDIR/localeです。
PostgreSQL付属のマニュアルページがこのディレクトリ以下の、対応するmanxサブディレクトリにインストールされます。 デフォルトはDATAROOTDIR/manです。
"man"ページを除いた、ドキュメント一式ファイルをインストールするルートディレクトリを設定します。これは以下のオプションのデフォルトのみを設定します。このオプションのデフォルト値はDATAROOTDIR/doc/postgresqlです。
PostgreSQLのHTML形式化文書一式はこのディレクトリの下にインストールされます。デフォルトはDATAROOTDIRです。
注意: （/usr/local/includeといった）共用のインストール場所に、システムの他の名前空間に影響を与えることなくPostgreSQLをインストールすることができるような配慮がなされています。 まず、完全に展開したディレクトリ名に"postgres"か"pgsql"という文字列が含まれていない場合、"/postgresql"という文字列が自動的にdatadir、sysconfdir、docdirに追加されます。 例えば、接頭辞として/usr/localを使用する場合、文書は/usr/local/doc/postgresqlにインストールされますが、接頭辞が/opt/postgresの場合は/opt/postgres/docにインストールされます。 クライアントインタフェース用の外部向けCヘッダファイルはincludedirにインストールされ、名前空間の問題はありません。 内部向けヘッダファイルやサーバ用ヘッダファイルは、includedir以下の非公開ディレクトリにインストールされます。 各インタフェース用のヘッダファイルにアクセスする方法についての情報は、そのインタフェースの文書を参照してください。 最後に、適切であれば、動的ロード可能モジュール用にlibdir以下にも非公開用のサブディレクトリが作成されます。
DIRECTORIESには、コンパイラがヘッダファイルを検索するディレクトリのリストをコロンで区切って指定します。 （GNU Readlineなどの）オプションのパッケージが非標準的な場所にインストールされている場合、このオプションと、おそらく対応する--with-librariesオプションを使用する必要があります。
例： --with-includes=/opt/gnu/include:/usr/sup/include
DIRECTORIESには、ライブラリを検索するディレクトリのリストをコロンで区切って指定します。 パッケージが非標準的な場所にインストールされている場合は、おそらくこのオプション（と対応する--with-includesオプション）を使用する必要があります。
例： --with-libraries=/opt/gnu/lib:/usr/sup/lib
各国語サポート（NLS）、つまり、英語以外の言語によるプログラムメッセージの表示機能を有効にします。 LANGUAGESはオプションであり、サポートさせたい言語コードを空白で区切ったリストを指定します。例えば、--enable-nls='de fr'などとします （指定したリストと実際に用意された翻訳との論理積が自動的に計算されます）。 リストに何も指定しなかった場合、利用可能な翻訳すべてがインストールされます。
このオプションを使用するためには、gettext APIの実装が必要です。 上記を参照してください。
サーバとクライアントのデフォルトのポート番号をNUMBERに設定します。 デフォルトは5432です。 このポートは後でいつでも変更することができますが、ここで指定した場合、サーバとクライアントはコンパイル時に同じデフォルト値を持つようになります。 これは非常に便利です。 通常、デフォルト以外の値を選択すべき唯一の理由は、同じマシンで複数のPostgreSQLを稼働させることです。
PL/Perlサーバサイド言語を構築します。
PL/Pythonサーバサイド言語を構築します。
PL/Tclサーバサイド言語を構築します。
Tclは、Tclへのインタフェースモジュールを構築するために必要な設定情報を含むtclConfig.shファイルをインストールします このファイルは通常、自動的に一般的に知られている場所にありますが、もしTclの別のバージョンを使いたい場合は、検索対象のディレクトリを指定することができます。
GSSAPI認証のサポートを構築します。 多くのシステムでは、GSSAPIシステム（通常Kerberosインストレーションの一部）はデフォルトの検索場所（例えば/usr/includeや/usr/lib）にインストールされていません。 そのため、--with-includesと--with-librariesオプションをさらに追加して使わなければいけません。 configureは、処理を進める前にGSSAPIが正しくインストールされていることを確認するために、必要とされるヘッダファイルとライブラリを検査します。
Kerberos 5 認証のサポートを構築します。 多くのシステムでは、Kerberosシステムはデフォルトの検索場所（例えば/usr/includeや/usr/lib）にインストールされていません。 そのため、--with-includesと--with-librariesオプションをさらに追加して使わなければいけません。 configureは、処理を進める前にKerberosが正しくインストールされていることを確認するために、必要とされるヘッダファイルとライブラリを検査します。
Kerberos のサービスプリンシパルのデフォルトの名前です（GSSAPIでも使用されます）。 デフォルトでは"postgres"です。 これを変える理由はWindows環境がない限り、特にありません。 Windows環境がある場合は大文字のPOSTGRESに設定する必要があります。
SSL（暗号化）接続のサポートを有効にして構築します。 これには、OpenSSLパッケージがインストールされていなければなりません。 configureは、処理を進める前にOpenSSLのインストールを確認するために、必要なヘッダファイルとライブラリを検査します。
PAM（プラガブル認証モジュール）のサポートを有効にして構築します。
認証および接続パラメータ検索用のLDAPサポートを有効にして構築します。 （項31.16および項19.3.8を参照してください。） Unixでは、OpenLDAPパッケージがインストールされていることが要求されます。WindowsではデフォルトのWinLDAPライブラリが使用されます。 configureは、処理を進める前にOpenLDAPのインストールが十分されているかどうかを確認するために、必要なヘッダファイルとライブラリを検査します。
Readlineライブラリ（およびlibedit）の使用を防止します。 これによりpsqlでのコマンドライン編集および履歴が無効となるため、推奨されません。
GPLライセンスのReadlineではなくBSDライセンスのlibeditライブラリを優先して使用します。 このオプションは両方のライブラリがインストールされている場合にのみ重要です。 この場合デフォルトでReadlineが使用されます。
Bonjourサポートを有効にして構築します。 これにはオペレーティングシステムがBonjourをサポートしていることが必要です。 Mac OS Xでは推奨します。
ビルドにOSSP UUIDライブラリを使用します。 具体的には、UUIDを生成する関数を提供する uuid-osspモジュールを構築します。
libxmlを使用して構築します（SQL/XMLサポートが有効になります）。 この機能のためにはlibxmlバージョン2.6.23以降が必要です。
libxmlがインストールするxml2-configプログラムを使用して、必要なコンパイラオプション、リンクオプションを検出することができます。 PostgreSQLは、見つけられればこのプログラムを使用します。 通常以外の場所にインストールしたlibxmlインストレーションを指定するためには、環境変数XML2_CONFIGがそのインストレーション用のxml2-configプログラムを指し示すように設定してください。 または、--with-includesおよび--with-librariesを使用してください。
xml2モジュールを構築する場合はlibxsltを使用してください。 xml2はXMLのXSL変換を行うために、このライブラリに依存します。
日付時刻および時間間隔の格納に64ビット整数格納方式を無効にし、その代わり浮動小数点で格納します。PostgreSQLリリース8.4以前では日付時刻の浮動小数点格納方式がデフォルトでしたが、timestamp値がとる値の全ての範囲でマイクロ秒精度をサポートしないため現在非推奨となりました。しかし、整数ベースの日付時刻格納には64-ビット整数型が必要です。従って、このオプションはこの型が使えない場合での使用、または以前のPostgreSQLバージョン用に書かれたアプリケーションとの互換性を保たなければならない場合に使用します。 詳細は 項8.5を参照してください。
float4値の"値"渡しを無効にし、"参照"渡しで渡すようにします。 このオプションは性能に関するコストがかかりますが、C言語で開発された古いユーザ定義の関数との互換性を保持する場合や"version 0"呼び出し規約を使用する場合に必要になります。 長期的に見てより良い解決方法はこうした関数を更新して、"version 1"呼び出し規約を使用するようにすることです。
float8値の"値"渡しを無効にし、"参照"渡しで渡すようにします。 このオプションは性能に関するコストがかかりますが、C言語で開発された古いユーザ定義の関数との互換性を保持する場合や"version 0"呼び出し規約を使用する場合に必要になります。 長期的に見てより良い解決方法はこうした関数を更新して、"version 1"呼び出し規約を使用するようにすることです。 このオプションはfloat8のみだけに影響するのではなく、int8やタイムスタンプなど一部の関連した型についても影響することに注意してください。 32ビットプラットフォームでは、--disable-float8-byvalがデフォルトで--enable-float8-byvalを選択することはできません。
セグメントサイズをギガバイト単位で指定します。 大規模なテーブルはこのセグメントサイズと同じサイズの複数のオペレーティングシステムのファイルに分割されます。 これにより多くのプラットフォームで存在するファイルサイズ上限に関する問題を防ぎます。 デフォルトのセグメントサイズは1ギガバイトで、サポートされるすべてのプラットフォームで安全です。 使用するオペレーティングシステムが"ラージファイル"をサポートしていれば（最近はほとんどサポートしています）、より大きなセグメントサイズを使用することができます。 非常に大規模なテーブルで作業する時のファイル記述子の消費数を減らすために、これが役に立つことができます。 しかし、プラットフォーム、または使用予定のファイルシステムでサポートされる値以上に大きな値を指定しないように注意してください。 tarなどの使用したい、その他のツールにも使用できるファイルサイズに制限があることがあります。 絶対に必要ではありませんが、この値を2のべき乗にすることを勧めます。 この値の変更にはinitdbが必要であることに注意してください。
キロバイト単位でブロック容量を設定します。これはテーブル内でのストレージとI/O単位です。８キロバイトのデフォルトはほとんどの場合適切ですが、特別な場合は他の値が役立ちます。値は1から32（キロバイト）の範囲の２のべき乗でなければなりません。この値の変更はinitdbを必要とすることを覚えておいてください。
メガバイト単位でWALセグメント容量を設定します。これはWALログ内のそれぞれ個別のファイルの容量です。この容量を調整することで、WALログ配送の粒度を制御するのに役立ちます。デフォルト容量は16メガバイトです。1から64（メガバイト）の範囲の２のべき乗でなければなりません。この値の変更はinitdbを必要とすることを覚えておいてください。
キロバイト単位でWALブロック容量を設定します。これはこれはWALログ内でのストレージとI/O単位です。８キロバイトのデフォルトはほとんどの場合適切ですが、特別な場合は大きめの値が役立ちます。値は1から64（キロバイト）の範囲の２のべき乗でなければなりません。この値の変更はinitdbを必要とすることを覚えておいてください。
PostgreSQLがそのプラットフォーム用のCPUスピンロックをサポートしない場合でも、構築に成功するようにします。 スピンロックのサポートの欠落により、性能は悪化します。 したがって、このオプションは、構築が失敗し、その原因が使用するプラットフォームでスピンロックサポートが欠落している場合にのみ使用してください。 使用するプラットフォームにおけるPostgreSQLの構築にこのオプションが必要とされた場合は、PostgreSQL開発者にその問題を報告してください。
クライアントライブラリのスレッドセーフを無効にします。 これにより、libpqやECPGプログラム内の同時実行スレッドは、安全にその固有の接続ハンドルを制御できなくなります。
PostgreSQLは、日付時刻に関する操作で必要な、独自の時間帯データベースを持ちます。 実際のところ、この時間帯データベースはFreeBSD、Linux、Solarisなどの多くのオペレーティングシステムで提供される"zoneinfo"時間帯データベースと互換性があります。 このため、これを再びインストールすることは冗長です。 このオプションが使用されると、DIRECTORYにあるシステムが提供する時間帯データベースがPostgreSQLソース配布物に含まれるものの代わりに使用されます。 DIRECTORYは絶対パスで指定しなければなりません。 /usr/share/zoneinfoがオペレーティングシステムの一部でよく使われます。 インストール処理が時間帯データが一致しない、またはエラーがあることを検知しないことに注意してください。 このオプションを使用する場合、指定した時間帯データがPostgreSQLで正しく動作するかどうかを検証するためにリグレッションテストを実行することが推奨されています。
このオプションの主な目的は、対象オペレーティングシステムを熟知しているパッケージ配布者向けです。 このオプションを使用する大きな利点は、多くの局所的な夏時間規則の変更があってもPostgreSQLパッケージを更新する必要がないことです。 他の利点として、時間帯データベースファイルをインストール時に構築する必要がありませんので、PostgreSQLのクロスコンパイルをより簡単に行うことができます。
Zlibライブラリの使用を抑制します。 これは、pg_dumpとpg_restoreにおける圧縮アーカイブのサポートを無効にします。 このオプションは、このライブラリが利用できないごく少数のシステム向けだけのものです。
全てのプログラムとライブラリをデバッグシンボル付きでコンパイルします。 これは、問題を解析するためにデバッガ内のプログラムを実行できることを意味します。 これはインストールする実行形式ファイルのサイズをかなり大きくし、また、GCC以外のコンパイラでは、通常はコンパイラによる最適化が行われなくなりますので、低速になります。 しかし、デバッグシンボルが利用できるということは、発生した問題に対応する時に非常に便利です。 現在のところ、GCC を使用している場合にのみ、稼働用のインストレーションにこのオプションを使用することを推奨します。 しかし、開発作業時やベータ版を実行する時は、常にこれを有効にすべきです。
GCCを使用している場合、すべてのプログラムとライブラリはコードカバレッジ試験機構付きでコンパイルされます。 実行すると、これらは構築用ディレクトリ内にコードカバレッジメトリックを持ったファイルを生成します。 詳細は項30.4を参照してください このオプションはGCC専用であり、また、開発作業中に使用するためのものです。
GCCを使用する場合、すべてのプログラムとライブラリがプロファイリング可能状態でコンパイルされます。 バックエンドの終了時、プロファイリングに使用するgmon.outファイルを含むサブディレクトリが作成されます。 このオプションはGCCを使用する場合のみ使用でき、開発作業を行う時に使用します。
サーバにおける、多くの"あり得ない"状態をテストするアサーションチェックを有効にします。 これは、プログラムの開発のためには測り知れない価値がありますが、このテストによりサーバはかなり低速になります。 また、このテストを有効にすると、サーバの安定性を向上させるとは限りません！ アサーションチェックは、重要度によって分類されていませんので、比較的害がないようなバグでも、アサーション失敗をトリガとした、サーバの再起動が行われてしまいます。 稼働用にこのオプションを使用することは推奨されませんが、開発作業時やベータ版を実行する場合は、これを有効にすべきです。
自動依存関係追跡を有効にします。 このオプションを使用すると、ヘッダファイルが変更された場合に、影響を受ける全てのオブジェクトファイルが再構築されるように、makefile が設定されます。 これは開発作業時には有用ですが、単に一度コンパイルしインストールするだけであれば、これは無駄なオーバーヘッドです。 現在のところ、GCC でのみ、このオプションは動作します。
動的追跡ツールDTraceのサポートを有効にしてPostgreSQLをコンパイルします。より詳細な情報は項27.4を参照してください。
dtraceプログラムを指し示すためにDTRACE環境変数を設定することができます。 dtraceは通常、検索パス内に存在しない可能性がある/usr/sbin以下にインストールされていますので、この設定はよく必要になります。
さらにdtraceプログラム用のコマンドラインオプションをDTRACEFLAGS環境変数で指定することができます。 Solarisで64ビットバイナリでDTraceをサポートするには、DTRACEFLAGS="-64"をconfigureに指定してください。 例えばGCCコンパイラを使用する場合は以下のようにします。
./configure CC='gcc -m64' --enable-dtrace DTRACEFLAGS='-64' ...
Sunのコンパイラを使用する場合は以下のようにします。
./configure CC='/opt/SUNWspro/bin/cc -xtarget=native64' --enable-dtrace DTRACEFLAGS='-64' ...
configureが選ぶものと違うCコンパイラを使いたいという場合には、CC 環境変数をその使用したいプログラムに設定することができます。 デフォルトでは、configureは利用できるのであればgccを、利用できなければプラットフォームのデフォルト（通常cc）を選択します。 同様に、デフォルトのコンパイラフラグは必要に応じてCFLAGS変数で上書きすることもできます。
次のようにして、configureコマンドラインに環境変数を指定することができます。
./configure CC=/opt/bin/gcc CFLAGS='-O2 -pipe'
以下は、この方式で設定可能な重要な環境変数の一覧です。
Bisonプログラム。
Cコンパイラ。
Cコンパイラに渡すオプション。
Cプリプロセッサ。
Cプリプロセッサに渡すオプション。
dtraceプログラムの場所。
dtraceプログラムに渡すオプション。
Flexプログラム。
実行ファイルや共有ライブラリにリンクする場合に使用するオプション。
実行ファイルのリンク時のみに追加されるオプション。
共有ライブラリのリンク時のみに追加されるオプション。
多言語サポート（NLS）用のmsgfmtプログラム。
Perlインタプリタのフルパス。 これは、PL/Perl構築に関する依存性を決定するために使用されます。
Pythonインタプリタのフルパス。 これは、PL/Python構築に関する依存性を決定するために使用されます。またここでPython 2または3を指定するかどうかで(あるいは暗黙的に選択されます)、どちらのPL/Python言語が利用可能になるかも決まります。項42.1を参照してください。
Tclインタプリタのフルパスです。 これは、PL/Tcl構築に関する依存性を決定するために使用され、Tclスクリプト内を置き換えます。
libxmlインストレーションの場所を特定するために使用するxml2-configプログラムです。
構築
構築作業を開始するには、以下を入力してください。
gmake
（GNU makeを使用することを忘れないでください。） ハードウェアに依存しますが、構築作業には数分かかります。 最後に以下のような行が表示されるはずです。
All of PostgreSQL is successfully made. Ready to install.
もし、ドキュメント(HTMLやman)や追加モジュール(contrib)を含め、構築可能なもの全てを構築したい場合、次の様に実施します。
gmake world
最終行は次のように表示されるはずです。
PostgreSQL, contrib and HTML documentation successfully made. Ready to install.
リグレッションテスト
インストールを行う前に、新しく構築したサーバをテストしたい場合、この時点でリグレッションテストを実行することができます。 リグレッションテストとは、使用するマシンにおいてPostgreSQLが、開発者の想定通りに動作することを検証するためのテストのまとまりです。 次のように入力します。
gmake check
（これは root では動作しません。 非特権ユーザとして実行してください。） 第30章にはテスト結果の表示に関する詳しい情報があります。 同じコマンドを入力することで、後にいつでもテストを繰り返すことができます。
ファイルのインストール
注意: もし既存のシステムのアップグレードをする場合、DBクラスタのアップグレードの解説が記載されている 項17.6を参照してください。
PostgreSQLをインストールするには、以下を入力してください。
gmake install
これは、ファイルをステップ1で指定されたディレクトリにインストールします。 その領域に書き込むための権限を持っていることを確認してください。 通常はこのステップはrootで行う必要があります。 代わりに対象とするディレクトリを前もって作成し、適切に権限を調整することも可能です。
ドキュメント(HTMLやman)をインストールするには、以下を入力して下さい。
gmake install-docs
先にすべてを(worldを付けて)構築していた場合には、代わりに以下を実行してください。
gmake install-world
これによりドキュメントもインストールされます。
gmake installの代わりにgmake install-stripを使用することで、インストール時に実行可能ファイルやライブラリをストリップ（strip）することができます。 これにより、多少の容量を節約できます。 デバッグをサポートするように構築している場合でも、ストリップするとデバッグのサポートは実質、除去されてしまいます。 したがって、これはデバッグが必要なくなった場合にのみ実行すべきです。 install-stripは容量を節約するために適切な作業を行おうとしますが、実行可能ファイルから全ての不必要なバイトを完全にストリップすることはできません。 可能な限りのディスク容量を全て節約したい場合は、手動で作業を行う必要があります。
この標準的なインストール方法では、クライアントアプリケーションの開発に必要なヘッダファイルと、Cで独自の関数やデータ型を作成するといったサーバ側のプログラムの開発用のヘッダファイルが用意されます （PostgreSQL 8.0より前まででは、後で別途gmake install-all-headersコマンドが必要でした。しかし、この手順は標準のインストールに含まれるようになりました）。
クライアント側のみのインストール：. クライアントアプリケーションとインタフェースライブラリのみをインストールしたい場合、下記のコマンドを使います。
gmake -C src/bin install gmake -C src/include install gmake -C src/interfaces install gmake -C doc install
src/binにはサーバ用の数個のバイナリがあります。これらは小さなものです。
Windowsにおけるeventlogの登録：. Windows eventlogライブラリをオペレーティングシステムに登録するには、インストール後に以下のコマンドを実行してください。
regsvr32 pgsql_library_directory/pgevent.dll
これによりイベントビューアで使用されるレジストリ項目が生成されます。
アンインストール：. インストールを取り消すには、gmake uninstall コマンドを使います。しかし、作成済みのディレクトリは削除されません。
クリーニング：. インストールが終わったら、gmake clean コマンドを使ってソースツリーから構築用のファイルを削除し、ディスク領域を解放することができます。 configureプログラムが作るファイルは保持されますので、後でgmakeコマンドですべてを再構築できます。 ソースツリーを配布された時の状態に戻したい場合は、gmake distcleanコマンドを使います。 同じソースツリー内で複数のプラットフォーム向けに構築する場合、これを実行して、それぞれのプラットフォームに対し再構成しなければなりません。 （または、未変更のソースツリーを維持するために、各プラットフォームで別々の構築用ツリーを使用してください。）
構築作業を行った後でconfigure用オプションが間違っていることに気付いた場合や、configureの調査結果に何らかの変更を加えた場合（例えば、ソフトウェアのアップグレードなど）、再設定と再構築の前にgmake distcleanを行うことをお勧めします。 さもないと、設定選択肢の変更は、必要なところ全てには反映されない可能性があります。