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/acccess.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