2.9. その他¶
このセクションではUNIX系の環境でGroongaをソースコードからインストールする方法を説明します。
インストール にある特定環境用のドキュメントに、その環境向けのより詳細な情報があります。特定環境用のドキュメントがある場合は、まずそちらを参照してください。
2.9.1. 依存関係¶
Groongaは特別なライブラリを必要としませんが、いくつかビルドに必要なツールがあります。
2.9.1.1. ツール¶
以下が必要なツールです:
wget
、curl
または Web ブラウザ(ソースアーカイブをダウンロードするため)
tar
とgzip
(ソースアーカイブを展開するため)シェル(
dash
、bash
、zsh
など、どのようなシェルでもたぶん大丈夫)CコンパイラーとC++コンパイラー (
gcc
とg++
がサポート対象だが、他のコンパイラーでもたぶん大丈夫)
make
(GNU makeがサポート対象だが、BSD makeなど他のmakeでもたぶん大丈夫)
これらを用意してください。
シェルの代わりに CMake を使うこともできますが、このドキュメントではCMakeを使ってビルドする方法については説明しません。
以下はあるとよいツールです:
pkg-config (ライブラリを検出するため)
sudo (ビルドしたGroongaをインストールするため)
追加のライブラリを使いたい場合はこれらのツールを用意しておかなければいけません。
2.9.1.2. ライブラリ¶
どのライブラリも必須ではありません。以下はオプションとして使えるライブラリです:
これらのライブラリを使いたい場合は、Groongaをインストールする前にライブラリをインストールしてください。
2.9.2. ソースからビルド¶
GroongaはGNUビルドシステムを使っています。以下は一番簡単なビルド手順です:
% wget https://packages.groonga.org/source/groonga/groonga-11.0.0.tar.gz
% tar xvzf groonga-11.0.0.tar.gz
% cd groonga-11.0.0
% ./configure
% make
% sudo make install
上記の手順を実行すると /usr/local/bin/groonga
に groonga 実行ファイル がインストールされます。
デフォルトのビルドでもうまく動くでしょうが、 configure
のときにGroongaをカスタマイズすることができます。
以下、それぞれの手順の詳細を説明します。
2.9.2.1. configure
¶
まず configure
を実行します。重要な configure
のオプションは以下の通りです:
2.9.2.1.1. --prefix=PATH
¶
インストール先となるディレクトリを指定します。Groonga関連のファイルは ${PATH}/
ディレクトリ以下にインストールされます。
デフォルトは /usr/local
。デフォルトの場合は groonga 実行ファイル は /usr/local/bin/groonga
にインストールされます。
以下はシステム全体にGroongaをインストールするのではなく、ユーザーが個人で使う目的で ~/local
にインストールする例です:
% ./configure --prefix=$HOME/local
2.9.2.1.2. --localstatedir=PATH
¶
ログファイル、PIDファイル、データベースなど頻繁に変更されるファイルを置くディレクトリを指定します。たとえば、ログファイルは ${PATH}/log/groonga.log
に置かれます。
デフォルトは /usr/local/var
です。
以下は頻繁に変更されるファイルをシステム全体で使う領域である /var
に置く例です:
% ./configure --localstatedir=/var
2.9.2.1.3. --with-log-path=PATH
¶
ログファイルのデフォルトのパスを指定します。ログファイルのデフォルトのパスは groonga 実行ファイル の --log-path
コマンドラインオプションで変更できます。そのため、このオプションはそんなに重要なビルドオプションではありません。少し便利にするためのオプションです。
デフォルトは /usr/local/var/log/groonga.log
です。 /usr/local/var
の部分は --localstatedir
オプションで変更できます。
以下はログファイルを共有しているNFSディレクトリ /nfs/log/groonga.log
に置く例です:
% ./configure --with-log-path=/nfs/log/groonga.log
2.9.2.1.4. --with-default-encoding=ENCODING
¶
デフォルトのエンコーディングを指定します。有効なエンコーディングは euc_jp
、 sjis
、 utf8
、 latin1
、 koi8r
、 none
です。
デフォルトは utf8
です。
以下はデフォルトのエンコーディングとしてShift_JISを使う例です:
% ./configure --with-default-encoding=sjis
2.9.2.1.5. --with-match-escalation-threshold=NUMBER
¶
マッチ演算でエスカレーションをするかどうかのデフォルトの閾値を指定します。この閾値については match_escalation_threshold を参照してください。-1はマッチ演算でエスカレーションしないという意味です。
デフォルトは0です。
以下はデフォルトではマッチエスカレーションをしないという例です:
% ./configure --with-match-escalation-threshold=-1
2.9.2.1.6. --with-zlib
¶
zlibを使ってカラム値を圧縮する機能を有効にします。
デフォルトでは無効です。
以下はzlibを使ってカラム値を圧縮する機能を有効にする例です:
% ./configure --with-zlib
2.9.2.1.7. --with-lz4
¶
LZ4を使ってカラム値を圧縮する機能を有効にします。
デフォルトでは無効です。
以下はLZ4を使ってカラム値を圧縮する機能を有効にする例です:
% ./configure --with-lz4
2.9.2.1.8. --with-message-pack=MESSAGE_PACK_INSTALL_PREFIX
¶
MessagePackがどこにインストールされているかを指定します。MessagePackを --prefix=/usr
という configure
オプションでインストールしていない場合は、MessagePackをビルドするときに指定したパスをこのオプションで指定してください。
もし、MessagePackを --prefix=$HOME/local
という configure
オプションでインストールした場合は、Groongaの configure
では --with-message-pack=$HOME/local
と指定してください。
デフォルトは /usr
です。
以下はMessagePackが --prefix=$HOME/local
という configure
オプションでインストールされている場合の例です:
% ./configure --with-message-pack=$HOME/local
2.9.2.1.9. --with-munin-plugins
¶
Groonga用のMuninプラグインをインストールします。プラグインは ${PREFIX}/share/groonga/munin/plugins/
以下にインストールされます。
デフォルトではプラグインはインストールされません。
以下はGroonga用のMuninプラグインをインストールする例です:
% ./configure --with-munin-plugins
2.9.2.1.10. --with-package-platform=PLATFORM
¶
initスクリプトなどプラットフォーム依存のシステム管理ファイルをインストールします。利用可能なプラットフォームは centos
、 centos5
、 centos6
、 centos7
、 fedora
です。 centos
から始まるプラットフォームはRed HatおよびCentOSなどのRed Hatクローンのディストリビューション用です。 centos
を指定した場合はディストリビューションのバージョンを推測します。 fedora
はFedora用です。
デフォルトではシステム管理ファイルはインストールされません。
以下はCentOS用のシステム管理ファイルをインストールする例です:
% ./configure --with-package-platform=centos
2.9.2.1.11. --help
¶
すべての configure
オプションを表示します。
2.9.2.2. make
¶
configure
が成功したら make
でGroongaをビルドします:
% make
マルチコアCPUを使っている場合は -j
オプションを使うとより速くmakeを実行できます。もし、4コアのCPUを使っている場合は、 -j4
オプションを使うともっと速くビルドできます:
% make -j4
make
で何かエラーが発生した場合は、そのエラーをレポートしてください: バグレポートの送り方
2.9.2.3. make install
¶
これでビルドしたGroongaをインストールできます!:
% sudo make install
${PREFIX}
への書き込み権限がある場合は sudo
を使う必要はありません。例えば、 --prefix=$HOME/local
と指定した場合です。この場合は make install
を使ってください:
% make install