5.1. サーバーパッケージ — Groonga v16.0.2ドキュメント

本文へスキップ
`Ctrl`+`K`

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

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

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

- groonga-httpd （nginxとHTTPベースのサーバーパッケージ）

- Groonga HTTPサーバー （HTTPベースのサーバーパッケージ）

- `groonga-server-gqtp` （ GQTP ベースのサーバーパッケージ）

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

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

## 5.1.1. groonga-httpd

警告

Groonga 13.0.3からgroonga-httpdは groonga-nginx に切り出されました。

`groonga-httpd` はnginxとHTTPベースのサーバーパッケージです。

設定済みの内容:

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

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

Starting groonga HTTP server(Debian/Ubuntu/AlmaLinux):

    % sudo service groonga-httpd start

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

    % sudo systemctl start groonga-httpd

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

Stopping groonga HTTP server(Debian/Ubuntu/AlmaLinux):

    % sudo service groonga-httpd stop

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

    % sudo systemctl stop groonga-httpd

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

Restarting groonga HTTP server(Debian/Ubuntu/AlmaLinux):

    % sudo service groonga-httpd restart

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

    % sudo systemctl restart groonga-httpd

## 5.1.2. groonga-server-gqtp

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

項目 | 既定値
--- | ---
ポート番号 | 10043
プロセスログ | /var/log/groonga/groonga-gqtp.log
クエリーログ | /var/log/groonga/gqtp-query.log
データベース | /var/lib/groonga/db/*

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

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

Configuration file for server setting (AlmaLinux):

    /etc/sysconfig/groonga-server-gqtp

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

Starting groonga GQTP server(Debian/Ubuntu/AlmaLinux):

    % sudo service groonga-server-gqtp start

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

    % sudo systemctl start groonga-server-gqtp

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

Stopping groonga GQTP server(Debian/Ubuntu/AlmaLinux):

    % sudo service groonga-server-http stop

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

    % sudo systemctl stop groonga-server-gqtp

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

Restarting groonga HTTP server(Debian/Ubuntu/AlmaLinux):

    % sudo service groonga-server-gqtp restart

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

    % sudo systemctl restart groonga-server-gqtp

## 5.1.3. groonga-server-http

`groonga-server-http` はシンプルなHTTPベースのサーバーパッケージです。

設定済みの内容:

項目 | 既定値
--- | ---
ポート番号 | 10041
プロセスログ | /var/log/groonga/groonga-http.log
クエリーログ | /var/log/groonga/http-query.log
データベース | /var/lib/groonga/db/*

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

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

Configuration file for server setting (AlmaLinux):

    /etc/sysconfig/groonga-server-http

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

Starting groonga HTTP server(Debian/Ubuntu/AlmaLinux):

    % sudo service groonga-server-http start

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

    % sudo systemctl start groonga-server-http

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

Stopping groonga HTTP server(Debian/Ubuntu/AlmaLinux):

    % sudo service groonga-server-http stop

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

    % sudo systemctl stop groonga-server-http

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

Restarting groonga HTTP server(Debian/Ubuntu/AlmaLinux):

    % sudo service groonga-server-http restart

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

    % sudo systemctl restart groonga-server-http