# groonga - An open-source fulltext search engine and column store.

- 日本語版はこちら

### Navigation

- index
- next |
- previous |
- Groonga v3.0.9 documentation »
- 7. Server »

# 7.1. Server packages

The package `groonga` is the mininum set of fulltext search engine. If you want to use groonga for server use, you can install additional preconfigured packages.

There are three packages for server use.

- `groonga-httpd` (nginx and HTTP protocol based server package)
- `groonga-server-http` (simple HTTP protocol based server package)
- `groonga-server-gqtp` (GQTP protocol based server package)

There is the reason why groonga supports not only GQTP but also two HTTP server packages. GQTP - Groonga Query Transfer Protocol is desined to reduce overheads and improve performance. But, GQTP is less support of client library than HTTP protocol does. As HTTP is matured protocol, you can take advantage of existing tool and there are many client library (See related projects for details). If you use `groonga-httpd` package, you can also take benefits of nginx functionality.

We recommend to use `groonga-server-http` at first, then if you want to use more fullfilling functionality, use `groonga-httpd` package. If you have performance issues which is derived from protocol overheads, consider to use `groonga-server-gqtp`.

> Note

> There is a conflict between `groonga-httpd` and `groonga-server-http` package because of port number. See Comparison if you want to know which package meets your demands.

## 7.1.1. groonga-httpd

`groonga-httpd` is a nginx and HTTP protocol based server package.

Preconfigured setting:

Item | Default value
--- | ---
Port number | 10041
Access log path | /var/log/groonga/httpd/acccess.log
Error log path | /var/log/groonga/http-query.log
Database | /var/lib/groonga/db/*
Configuration file | /etc/groonga/httpd/groonga-httpd.conf

### 7.1.1.1. Start HTTP server

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

    % sudo service groonga-httpd start

Starting groonga HTTP server(Fedora):

    % sudo systemctl start groonga-httpd

### 7.1.1.2. Stop HTTP server

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

    % sudo service groonga-httpd stop

Starting groonga HTTP server(Fedora):

    % sudo systemctl stop groonga-httpd

### 7.1.1.3. Restart HTTP server

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

    % sudo service groonga-httpd restart

Restarting groonga HTTP server(Fedora):

    % sudo systemctl restart groonga-httpd

## 7.1.2. groonga-server-http

`groonga-server-http` is a simple HTTP protocol based server package.

Preconfigured setting:

Item | Default value
--- | ---
Port number | 10041
Process log | /var/log/groonga/groonga-http.log
Query log | /var/log/groonga/http-query.log
Database | /var/lib/groonga/db/*

Configuration file for server setting (Debian/Ubuntu):

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

Configuration file for server setting (CentOS):

    /etc/sysconfig/groonga-server-http

### 7.1.2.1. Start HTTP server

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

    % sudo service groonga-server-http start

Starting groonga HTTP server(Fedora):

    % sudo systemctl start groonga-server-http

### 7.1.2.2. Stop HTTP server

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

    % sudo service groonga-server-http stop

Stopping groonga HTTP server(Fedora):

    % sudo systemctl stop groonga-server-http

### 7.1.2.3. Restart HTTP server

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

    % sudo service groonga-server-http restart

Restarting groonga HTTP server(Fedora):

    % sudo systemctl restart groonga-server-http

## 7.1.3. groonga-server-gqtp

`groonga-server-gqtp` is a GQTP protocol based server package.

Item | Default value
--- | ---
Port number | 10043
Process log | /var/log/groonga/groonga-gqtp.log
Query log | /var/log/groonga/gqtp-query.log
Database | /var/lib/groonga/db/*

Configuration file for server setting (Debian/Ubuntu):

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

Configuration file for server setting (CentOS):

    /etc/sysconfig/groonga-server-gqtp

### 7.1.3.1. Start GQTP server

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

    % sudo service groonga-server-gqtp start

Starting groonga GQTP server(Fedora):

    % sudo systemctl start groonga-server-gqtp

### 7.1.3.2. Stop GQTP server

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

    % sudo service groonga-server-http stop

Stopping groonga GQTP server(Fedora):

    % sudo systemctl stop groonga-server-gqtp

### 7.1.3.3. Restart GQTP server

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

    % sudo service groonga-server-gqtp restart

Restarting groonga HTTP server(Fedora):

    % sudo systemctl restart groonga-server-gqtp

### Navigation

- index
- next |
- previous |
- Groonga v3.0.9 documentation »
- 7. Server »