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

2. Install

This section describes how to install groonga on each environment.

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.

2.1. Debian GNU/Linux squeeze

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

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

Install:

% sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 1C837F31
% sudo aptitude update
% sudo aptitude -V -D -y install groonga

If you want to use MeCab as a tokenizer. please 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, please install groonga-munin-plugins package.

Install groonga-munin-plugins package:

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

2.2. Debian GNU/Linux wheezy

/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-key adv --recv-keys --keyserver keyserver.ubuntu.com 1C837F31
% sudo aptitude update
% sudo aptitude -V -D -y install groonga

If you want to use MeCab as a tokenizer. please 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, please install groonga-munin-plugins package.

Install groonga-munin-plugins package:

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

2.3. Debian GNU/Linux sid

/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 apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 1C837F31
% sudo aptitude update
% sudo aptitude -V -D -y install groonga

If you want to use MeCab as a tokenizer. please 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, please install groonga-munin-plugins package.

Install groonga-munin-plugins package:

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

2.4. Ubuntu 10.04 LTS Lucid Lynx

Note

You'll need to enable the universe repository of Ubuntu to install groonga. The following describes how to do it.

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

deb http://packages.groonga.org/ubuntu/ lucid universe
deb-src http://packages.groonga.org/ubuntu/ lucid universe

Install:

% sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 1C837F31
% sudo apt-get update
% sudo apt-get -y install groonga

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

Install groonga-tokenizer-mecab package:

% sudo apt-get -y install groonga-tokenizer-mecab

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

Install groonga-munin-plugins package:

% sudo apt-get -y install groonga-munin-plugins

2.5. Ubuntu 11.04 Natty Narwhal

Note

You'll need to enable the universe repository of Ubuntu to install groonga. The following describes how to do it.

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

deb http://packages.groonga.org/ubuntu/ natty universe
deb-src http://packages.groonga.org/ubuntu/ natty universe

Install:

% sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 1C837F31
% sudo apt-get update
% sudo apt-get -y install groonga

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

Install groonga-tokenizer-mecab package:

% sudo apt-get -y install groonga-tokenizer-mecab

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

Install groonga-munin-plugins package:

% sudo apt-get -y install groonga-munin-plugins

2.6. Ubuntu 11.10 Oneiric Ocelot

Note

You'll need to enable the universe repository of Ubuntu to install groonga. The following describes how to do it.

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

deb http://packages.groonga.org/ubuntu/ oneiric universe
deb-src http://packages.groonga.org/ubuntu/ oneiric universe

Install:

% sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 1C837F31
% sudo apt-get update
% sudo apt-get -y install groonga

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

Install groonga-tokenizer-mecab package:

% sudo apt-get -y install groonga-tokenizer-mecab

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

Install groonga-munin-plugins package:

% sudo apt-get -y install groonga-munin-plugins

2.7. CentOS 5

Install:

% sudo rpm -ivh http://packages.groonga.org/centos/groonga-repository-1.0.0-0.noarch.rpm
% sudo yum update
% sudo yum install -y groonga

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

Install groonga-tokenizer-mecab package:

% sudo yum install -y groonga-tokenizer-mecab

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

Note

Groonga-munin-plugins package requires munin-node package that isn't included in the official CentOS repository. You need to enable Repoforge (RPMforge) repository or EPEL repository to install it by yum.

Enable Repoforge (RPMforge) repository on i386 environment:

% sudo rpm -ivh http://pkgs.repoforge.org/rpmforge-release/rpmforge-release-0.5.2-2.el5.rf.i386.rpm

Enable Repoforge (RPMforge) repository on x86_64 environment:

% sudo rpm -ivh http://pkgs.repoforge.org/rpmforge-release/rpmforge-release-0.5.2-2.el5.rf.x86_64.rpm

Enable EPEL repository on any environment:

% sudo rpm -ivh http://download.fedoraproject.org/pub/epel/5/i386/epel-release-5-4.noarch.rpm

Install groonga-munin-plugins package:

% sudo yum update
% sudo yum install -y groonga-munin-plugins

2.8. CentOS 6

Install:

% sudo rpm -ivh http://packages.groonga.org/centos/groonga-repository-1.0.0-0.noarch.rpm
% sudo yum update
% sudo yum install -y groonga

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

Install groonga-tokenizer-mecab package:

% sudo yum install -y groonga-tokenizer-mecab

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

Note

Groonga-munin-plugins package requires munin-node package that isn't included in the official CentOS repository. You need to enable Repoforge (RPMforge) repository or EPEL repository to install it by yum.

Enable Repoforge (RPMforge) repository on i686 environment:

% sudo rpm -ivh http://pkgs.repoforge.org/rpmforge-release/rpmforge-release-0.5.2-2.el6.rf.i686.rpm

Enable Repoforge (RPMforge) repository on x86_64 environment:

% sudo rpm -ivh http://pkgs.repoforge.org/rpmforge-release/rpmforge-release-0.5.2-2.el6.rf.x86_64.rpm

Enable EPEL repository on any environment:

% sudo rpm -ivh http://download.fedoraproject.org/pub/epel/6/i386/epel-release-6-5.noarch.rpm

Install groonga-munin-plugins package:

% sudo yum update
% sudo yum install -y groonga-munin-plugins

2.9. Fedora 16

Install:

% sudo rpm -ivh http://packages.groonga.org/fedora/groonga-repository-1.0.0-0.noarch.rpm
% sudo yum update
% sudo yum install -y groonga

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

Install groonga-tokenizer-mecab package:

% sudo yum install -y groonga-tokenizer-mecab

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

Install groonga-munin-plugins package:

% sudo yum install -y groonga-munin-plugins

2.10. Mac OS X (MacPorts)

Install:

% sudo port install groonga

2.11. Mac OS X (Homebrew)

Install:

% brew install groonga

2.12. Windows (Installer)

You just download an installer (.exe file) from packages.groonga.org/windows/ and execute it.

2.13. Windows (zip)

You just download a zip file from packages.groonga.org/windows/ and extract it.

2.14. Others

If you want to use a morphological analyzer for tokenization in full-text indexing, please install MeCab before installing groonga.

Then, download a tar.gz file from packages.groonga.org/source/ and extract it. After that, please run the following command to install groonga.

Install:

./configure --prefix=/usr --localstatedir=/var && make && sudo make install

The --prefix option specifies the path to install groonga. If you don't specify the install path, "/usr/local" is used. Please specify "/usr" if you are not familiar with environment variables such as LD_LIBRARY_PATH.

There are some Munin plugins in groonga package. You need to specify --with-munin-plugins option if you want to install them.