.. -*- rst -*-

.. highlightlang:: none

Ubuntu
======

This section describes how to install groonga related deb packages on
Ubuntu. 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.

10.04 LTS Lucid Lynx
--------------------

.. note::

   Enable the universe repository to install groonga::

     % sudo cp /etc/apt/sources.list /etc/apt/sources.list.d/universe.list
     % sudo sed -i'' -e 's/main/universe/' /etc/apt/sources.list.d/universe.list

Add the groonga apt repository.

/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-get update
  % sudo apt-get -y --allow-unauthenticated install groonga-keyring
  % sudo apt-get -y install groonga

If you want to use `MeCab <http://mecab.sourceforge.net/>`_ as a
tokenizer, 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
<http://munin-monitoring.org/>`_ plugins. If you want to monitor
groonga status by Munin, install groonga-munin-plugins package.

Install groonga-munin-plugins package::

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

11.04 Natty Narwhal
-------------------

.. note::

   Enable the universe repository to install groonga::

     % sudo cp /etc/apt/sources.list /etc/apt/sources.list.d/universe.list
     % sudo sed -i'' -e 's/main/universe/' /etc/apt/sources.list.d/universe.list

Add the groonga apt repository.

/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-get update
  % sudo apt-get -y --allow-unauthenticated install groonga-keyring
  % sudo apt-get -y install groonga

If you want to use `MeCab <http://mecab.sourceforge.net/>`_ as a
tokenizer, 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
<http://munin-monitoring.org/>`_ plugins. If you want to monitor
groonga status by Munin, install groonga-munin-plugins package.

Install groonga-munin-plugins package::

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

11.10 Oneiric Ocelot
--------------------

.. note::

   Enable the universe repository to install groonga::

     % sudo cp /etc/apt/sources.list /etc/apt/sources.list.d/universe.list
     % sudo sed -i'' -e 's/main/universe/' /etc/apt/sources.list.d/universe.list

Add the groonga apt repository.

/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-get update
  % sudo apt-get -y --allow-unauthenticated install groonga-keyring
  % sudo apt-get -y install groonga

If you want to use `MeCab <http://mecab.sourceforge.net/>`_ as a
tokenizer, 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
<http://munin-monitoring.org/>`_ plugins. If you want to monitor
groonga status by Munin, install groonga-munin-plugins package.

Install groonga-munin-plugins package::

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

12.04 LTS Precise Pangolin
--------------------------

.. note::

   Enable the universe repository to install groonga::

     % sudo cp /etc/apt/sources.list /etc/apt/sources.list.d/universe.list
     % sudo sed -i'' -e 's/main/universe/' /etc/apt/sources.list.d/universe.list

Add the groonga apt repository.

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

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

Install::

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

If you want to use `MeCab <http://mecab.sourceforge.net/>`_ as a
tokenizer, 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
<http://munin-monitoring.org/>`_ plugins. If you want to monitor
groonga status by Munin, install groonga-munin-plugins package.

Install groonga-munin-plugins package::

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

Build from source
-----------------

Install required packages to build groonga::

  % sudo apt-get -V -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-2.0.3.tar.gz
  % tar xvzf groonga-2.0.3.tar.gz
  % cd groonga-2.0.3

Configure (see :ref:`source-configure` about ``configure`` options)::

  % ./configure

Build::

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

Install::

  % sudo make intall
