2.3. Debian GNU/Linux

This section describes how to install Groonga related deb packages on Debian GNU/Linux. You can install them by apt.

We distribute both 32-bit and 64-bit packages but we strongly recommend a 64-bit package for server. You should use a 32-bit package just only for tests or development. You will encounter an out of memory error with a 32-bit package even if you just process medium size data.

Note

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-server-http (simple HTTP protocol based server package)
• groonga-httpd (nginx and HTTP protocol based server package)
• groonga-server-gqtp (GQTP protocol based server package)

See Server section about details.

2.3.1. wheezy

Add the Groonga apt repository.

/etc/apt/sources.list.d/groonga.list:

deb http://packages.groonga.org/debian/ wheezy main
deb-src http://packages.groonga.org/debian/ wheezy main

Install:

% sudo apt-get update
% sudo apt-get -y --allow-unauthenticated install groonga-keyring
% sudo apt-get update
% sudo apt-get -y install groonga

If you want to use MeCab as a tokenizer, install groonga-tokenizer-mecab package.

Install groonga-tokenizer-mecab package:

% sudo aptitude -V -D -y install groonga-tokenizer-mecab

There is a package that provides Munin plugins. If you want to monitor groonga status by Munin, install groonga-munin-plugins package.

Install groonga-munin-plugins package:

% sudo aptitude -V -D -y install groonga-munin-plugins

There is a package that provides MySQL compatible normalizer as groonga plugins. If you want to use that one, install groonga-normalizer-mysql package.

Install groonga-normalizer-mysql package:

% sudo aptitude -V -D -y install groonga-normalizer-mysql

2.3.2. jessie

Add the groonga apt repository.

/etc/apt/sources.list.d/groonga.list:

deb http://packages.groonga.org/debian/ jessie main
deb-src http://packages.groonga.org/debian/ jessie main

Install:

% sudo apt-get update
% sudo apt-get -y --allow-unauthenticated install groonga-keyring
% sudo apt-get update
% sudo apt-get -y install groonga

If you want to use MeCab as a tokenizer, install groonga-tokenizer-mecab package.

Install groonga-tokenizer-mecab package:

% sudo aptitude -V -D -y install groonga-tokenizer-mecab

There is a package that provides Munin plugins. If you want to monitor groonga status by Munin, install groonga-munin-plugins package.

Install groonga-munin-plugins package:

% sudo aptitude -V -D -y install groonga-munin-plugins

There is a package that provides MySQL compatible normalizer as Groonga plugins. If you want to use that one, install groonga-normalizer-mysql package.

Install groonga-normalizer-mysql package:

% sudo aptitude -V -D -y install groonga-normalizer-mysql

2.3.3. sid

Add the groonga apt repository.

/etc/apt/sources.list.d/groonga.list:

deb http://packages.groonga.org/debian/ unstable main
deb-src http://packages.groonga.org/debian/ unstable main

Install:

% sudo aptitude update
% sudo aptitude -V -D -y --allow-untrusted install groonga-keyring
% sudo aptitude update
% sudo aptitude -V -D -y install groonga

If you want to use MeCab as a tokenizer, install groonga-tokenizer-mecab package.

Install groonga-tokenizer-mecab package:

% sudo aptitude -V -D -y install groonga-tokenizer-mecab

There is a package that provides Munin plugins. If you want to monitor groonga status by Munin, install groonga-munin-plugins package.

Install groonga-munin-plugins package:

% sudo aptitude -V -D -y install groonga-munin-plugins

There is a package that provides MySQL compatible normalizer as groonga plugins. If you want to use that one, install groonga-normalizer-mysql package.

Install groonga-normalizer-mysql package:

% sudo aptitude -V -D -y install groonga-normalizer-mysql

2.3.4. Build from source

Install required packages to build groonga:

% sudo aptitude -V -D -y install wget tar build-essential zlib1g-dev liblzo2-dev libmsgpack-dev libzmq-dev libevent-dev libmecab-dev

Download source:

% wget http://packages.groonga.org/source/groonga/groonga-4.0.1.tar.gz
% tar xvzf groonga-4.0.1.tar.gz
% cd groonga-4.0.1

Configure (see configure about configure options):

% ./configure

Build:

% make -j$(grep '^processor' /proc/cpuinfo | wc -l)

Install:

% sudo make install