groonga-httpd is a program to communicate with a groonga server using the HTTP protocol. It functions as same as groonga HTTPサーバー. Although groonga HTTPサーバー has limited support for HTTP with a minimal built-in HTTP server, groonga-httpd has full support for HTTP with an embedded nginx. All standards-compliance and features provided by nginx is also available in groonga-httpd. For details about nginx, see http://www.nginx.org/
groonga-httpd has an Web-based administration tool implemented with HTML and JavaScript. You can access to it from http://hostname:port/.
groonga-httpd [nginx options]
First, you'll need to edit the groonga-httpd configuration file to specify a database. Edit /etc/groonga/httpd/groonga-httpd.conf to enable the groonga_database directive like this:
# Match this to the file owner of groonga database files if groonga-httpd is
# run as root.
#user groonga;
...
http {
...
# Don't change the location; currently only /d/ is supported.
location /d/ {
groonga; # <= This means to turn on groonga-httpd.
# Specify an actual database and enable this.
groonga_database /var/lib/groonga/db/db;
}
...
}
Then, run groonga-httpd. Note that the control immediately returns back to the console because groonga-httpd runs as a daemon process by default.:
% groonga-httpd
To check, request a simple query (status).
Execution example:
% curl http://localhost:10041/d/status
[
[
0,
1337566253.89858,
0.000355720520019531
],
{
"uptime": 0,
"max_command_version": 2,
"n_queries": 0,
"cache_hit_rate": 0.0,
"version": "2.0.3-278-g6071d65",
"alloc_count": 145,
"command_version": 1,
"starttime": 1340769698,
"default_command_version": 1
}
]
Also, you can browse Web-based administration tool at http://localhost:10041/.
Finally, to terminate the running groonga-httpd daemon, run this:
% groonga-httpd -s stop
There are two kinds of configuration directives. One is provided by nginx, the other is by groonga-httpd.
The following directives can be used in the groonga-httpd configuration file. By default, it's located at /etc/groonga/httpd/groonga-httpd.conf.
All standard HTTP modules except HttpRewriteModule is available. HttpRewriteModule is disabled to avoid to depend on PCRE (Perl Compatible Regular Expressions). For the list of other standard HTTP modules, see http://wiki.nginx.org/Modules.