# groonga - オープンソースのカラムストア機能付き全文検索エンジン

- English

# 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. ライブラリ

どのライブラリも必須ではありません。以下はオプションとして使えるライブラリです:

> - MeCab （全文検索対象のドキュメントを形態素解析でトークナイズするため）
> - KyTea （全文検索対象のドキュメントを形態素解析でトークナイズするため）
> - ZeroMQ （ サジェスト 用）
> - libevent （ サジェスト 用）
> - MessagePack （MessagePack出力サポート用および サジェスト 用）
> - libedit （ groonga 実行ファイル のコマンドライン編集用）
> - zlib （カラム値の圧縮用）
> - LZ4 （カラム値の圧縮用）
> - Zstandard （カラム値の圧縮用）

これらのライブラリを使いたい場合は、Groongaをインストールする前にライブラリをインストールしてください。

## 2.9.2. ソースからビルド

GroongaはGNUビルドシステムを使っています。以下は一番簡単なビルド手順です:

    % wget https://packages.groonga.org/source/groonga/groonga-8.0.2.tar.gz
    % tar xvzf groonga-8.0.2.tar.gz
    % cd groonga-8.0.2
    % ./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