Install
This document describes how to install Rroonga.
You can install Rroonga by RubyGems. It is the standard way for Ruby libraries.
Rroonga is depends on Groonga. So you need to install both Groonga and Rroonga. You can't install Groonga by RubyGems because it isn't Ruby library. But don't worry. Rroonga provides the following options for easy to install:
- Rroonga downloads, builds and installs Groonga automatically. You don't need to do them explicitly.
- Rroonga uses Groonga installed by your packaging system.
The following sections describe the above in detail.
Install with auto Groonga build
Rroonga searches Groonga on install. If Rroonga can't find Groonga, Rroonga downloads, builds and installs Groonga automatically.
Type the following command to install Rroonga and Groonga. You don't need to install Groonga explicitly:
% gem install rroonga
Install with Groonga package
You can use Groonga package on you packaging system instead of building Groonga by yourself. There are the following advantages for this option:
- It reduces installation time.
- It doesn't fail on building Groonga.
Windows
Rroonga gem for Windows includes both pre-compiled Rroonga and Groonga in the gem. So what you need to do is you just install rroonga gem.
Type the following command on Ruby console:
> gem install rroonga
This document assumes that you're using RubyInstaller for Windows .
OS X
There are Groonga packages for OS X environment.
MacPorts
If you're using MacPorts , type the following commands on your terminal:
% sudo port install groonga
% sudo gem install rroonga
Homebrew
If you're using Homebrew , type the following commands on your terminal:
% brew install groonga
% gem install rroonga
Debian GNU/Linux
You can install the Groonga package by apt. See Groonga documentation how to set apt-line up.
Type the following commands on your terminal after you finish to set apt-line up.
% sudo apt-get install -y libgroonga-dev
% sudo gem install rroonga
Ubuntu
You can install the Groonga package by apt. See Groonga documentation how to set apt-line up.
Type the following commands on your terminal after you finish to set apt-line up.
% sudo apt-get install -y libgroonga-dev
% sudo gem install rroonga
CentOS
You can install the Groonga package by yum. See Groonga documentation how to set yum repository up.
But you need to install Ruby 1.9.3 or later by yourself. Both CentOS 5 and 6 ship Ruby 1.8. Rroonga doesn't support Ruby 1.8.
Type the following commands on your terminal after you finish to set yum repository up and installing Ruby 1.9.3 or later.
% sudo yum install groonga-devel -y
% gem install rroonga
Fedora
You can install the Groonga package by yum. The Groonga package is included in the official Fedora repository.
% sudo yum install groonga-devel -y
% sudo gem install rroonga