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

- English page

# 7.1. サーバーパッケージ

`groonga` パッケージは全文検索を行うための最小構成のパッケージです。サーバー用途で使うために、設定済みのパッケージを追加でインストールすることができます。

サーバー用途の3つのパッケージがあります。

- `groonga-httpd` (nginxをベースにしたHTTPサーバー)

- `groonga-server-http` (簡易HTTPサーバー)

- `groonga-server-gqtp` (GQTP サーバー)

groongaがGQTPだけでなく、2つのHTTPサーバーパッケージをサポートしているのには理由があります。 GQTP - Groonga Query Transfer Protocol はオーバーヘッドを低減し、パフォーマンスを向上させるように設計されていますが、HTTPプロトコルほどクライアントライブラリのサポートがありません。HTTPは枯れたプロトコルなので既存のツールを活用できたり、多くのクライアントライブラリが存在します。(詳細は 関連プロジェクト を参照) `groonga-httpd` パッケージを使うと nginxの機能の恩恵を受けることができます。

最初は `groonga-server-http` パッケージを使うことをおすすめします。それでもっと高機能なものを使いたくなったら、`groonga-httpd` パッケージを使ってください。プロトコルのオーバーヘッドがパフォーマンス上問題となったら `groonga-server-gqtp` を検討してください。

> ノート

> `groonga-httpd` と `groonga-server-http` パッケージは使用ポートが一緒なので衝突します。どちらのパッケージを使うのがいいのかは 比較 を参照してください。

## 7.1.1. groonga-httpd

`groonga-httpd` はnginxをベースにしたHTTPサーバーパッケージです。

設定済みの内容:

項目 | 既定値
--- | ---
ポート番号 | 10041
アクセスログ | /var/log/groonga/httpd/acccess.log
エラーログ | /var/log/groonga/http-query.log
データベース | /var/lib/groonga/db/*
設定ファイル | /etc/groonga/httpd/groonga-httpd.conf

### 7.1.1.1. HTTPサーバーを起動

groonga HTTPサーバーを起動(Debian/Ubuntu/CentOS):

    % sudo service groonga-httpd start

groonga HTTPサーバーを起動(Fedora):

    % sudo systemctl start groonga-httpd

### 7.1.1.2. HTTPサーバーを終了

groonga HTTPサーバーを終了(Debian/Ubuntu/CentOS):

    % sudo service groonga-httpd stop

groonga HTTPサーバーを起動(Fedora):

    % sudo systemctl stop groonga-httpd

### 7.1.1.3. HTTPサーバーを再起動

groonga HTTPサーバーを再起動(Debian/Ubuntu/CentOS):

    % sudo service groonga-httpd restart

groonga HTTPサーバーを再起動(Fedora):

    % sudo systemctl restart groonga-httpd

## 7.1.2. groonga-server-http

`groonga-server-http` は簡易HTTPサーバーパッケージです。

設定済みの内容:

項目 | 既定値
--- | ---
ポート番号 | 10041
Process log | /var/log/groonga/groonga-http.log
Query log | /var/log/groonga/http-query.log
データベース | /var/lib/groonga/db/*

サーバー設定ファイル (Debian/Ubuntu):

    /etc/default/groonga/groonga-server-http

サーバー設定ファイル(CentOS):

    /etc/sysconfig/groonga-server-http

### 7.1.2.1. HTTPサーバーを起動

groonga HTTPサーバーを起動(Debian/Ubuntu/CentOS):

    % sudo service groonga-server-http start

groonga HTTPサーバーを起動(Fedora):

    % sudo systemctl start groonga-server-http

### 7.1.2.2. HTTPサーバーを終了

groonga HTTPサーバーを終了(Debian/Ubuntu/CentOS):

    % sudo service groonga-server-http stop

groonga HTTPサーバーを終了(Fedora):

    % sudo systemctl stop groonga-server-http

### 7.1.2.3. HTTPサーバーを再起動

groonga HTTPサーバーを再起動(Debian/Ubuntu/CentOS):

    % sudo service groonga-server-http restart

groonga HTTPサーバーを再起動(Fedora):

    % sudo systemctl restart groonga-server-http

## 7.1.3. groonga-server-gqtp

`groonga-server-gqtp` は GQTP サーバーパッケージです。

項目 | 既定値
--- | ---
ポート番号 | 10043
Process log | /var/log/groonga/groonga-gqtp.log
Query log | /var/log/groonga/gqtp-query.log
データベース | /var/lib/groonga/db/*

サーバー設定ファイル (Debian/Ubuntu):

    /etc/default/groonga/groonga-server-gqtp

サーバー設定ファイル(CentOS):

    /etc/sysconfig/groonga-server-gqtp

### 7.1.3.1. GQTPサーバーを起動

groonga GQTPサーバーを起動(Debian/Ubuntu/CentOS):

    % sudo service groonga-server-gqtp start

groonga GQTPサーバーを起動(Fedora):

    % sudo systemctl start groonga-server-gqtp

### 7.1.3.2. GQTPサーバーを終了

groonga GQTPサーバーを終了(Debian/Ubuntu/CentOS):

    % sudo service groonga-server-http stop

groonga GQTPサーバーを終了(Fedora):

    % sudo systemctl stop groonga-server-gqtp

### 7.1.3.3. GQTPサーバーを再起動

groonga HTTPサーバーを再起動(Debian/Ubuntu/CentOS):

    % sudo service groonga-server-gqtp restart

groonga HTTPサーバーを再起動(Fedora):

    % sudo systemctl restart groonga-server-gqtp