Install on CentOS

This document describes how to install PGroonga on CentOS.

Supported versions

Here are supported CentOS versions:

How to install on CentOS 6

You can use the following instruction to install PGroonga on CentOS 6.

Install postgresql-pgroonga package:

$ sudo -H yum install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-$(rpm -qf --queryformat="%{VERSION}" /etc/redhat-release)-$(rpm -qf --queryformat="%{ARCH}" /etc/redhat-release)/pgdg-redhat-repo-latest.noarch.rpm
$ sudo -H yum install -y https://packages.groonga.org/centos/groonga-release-latest.noarch.rpm
$ sudo -H yum install -y postgresql12-pgroonga

If you want to use MeCab based tokenizer, you also need to install groonga-tokenizer-mecab package:

$ sudo -H yum install -y groonga-tokenizer-mecab

Run PostgreSQL:

$ sudo -H /sbin/service postgresql-12 initdb
$ sudo -H /sbin/chkconfig postgresql-12 on
$ sudo -H /sbin/service postgresql-12 start

Create a database:

$ sudo -u postgres -H psql --command 'CREATE DATABASE pgroonga_test'

(Normally, you should create a user for pgroonga_test database and use the user. See GRANT USAGE ON SCHEMA pgroonga for details.)

Connect to the created database and execute CREATE EXTENSION pgroonga:

$ sudo -u postgres -H psql -d pgroonga_test --command 'CREATE EXTENSION pgroonga'

That's all!

Try tutorial. You can understand more about PGroonga.

How to install on CentOS 7

You can use the following instruction to install PGroonga on CentOS 7.

Install postgresql-pgroonga package:

$ sudo -H yum install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-$(rpm -qf --queryformat="%{VERSION}" /etc/redhat-release)-$(rpm -qf --queryformat="%{ARCH}" /etc/redhat-release)/pgdg-redhat-repo-latest.noarch.rpm
$ sudo -H yum install -y https://packages.groonga.org/centos/groonga-release-latest.noarch.rpm
$ sudo -H yum install -y postgresql12-pgroonga

If you want to use MeCab based tokenizer, you also need to install groonga-tokenizer-mecab package:

$ sudo -H yum install -y groonga-tokenizer-mecab

Run PostgreSQL:

$ sudo -H /usr/pgsql-12/bin/postgresql-12-setup initdb
$ sudo -H systemctl enable postgresql-12
$ sudo -H systemctl start postgresql-12

Create a database:

$ sudo -u postgres -H psql --command 'CREATE DATABASE pgroonga_test'

(Normally, you should create a user for pgroonga_test database and use the user. See GRANT USAGE ON SCHEMA pgroonga for details.)

Connect to the created database and execute CREATE EXTENSION pgroonga:

$ sudo -u postgres -H psql -d pgroonga_test --command 'CREATE EXTENSION pgroonga'

That's all!

Try tutorial. You can understand more about PGroonga.

How to install on CentOS 8

You can use the following instruction to install PGroonga on CentOS 8.

Note that WAL support is disabled for now.

Install postgresql-pgroonga package:

$ sudo -H dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-$(cut -d: -f5 /etc/system-release-cpe)-$(rpm -qf --queryformat="%{ARCH}" /etc/redhat-release)/pgdg-redhat-repo-latest.noarch.rpm
$ sudo -H dnf install -y https://packages.groonga.org/centos/groonga-release-latest.noarch.rpm
$ sudo -H dnf module -y disable postgresql
$ sudo -H dnf install -y postgresql12-pgroonga

If you want to use MeCab based tokenizer, you also need to install groonga-tokenizer-mecab package:

$ sudo -H dnf install -y groonga-tokenizer-mecab

Run PostgreSQL:

$ sudo -H /usr/pgsql-12/bin/postgresql-12-setup initdb
$ sudo -H systemctl enable postgresql-12
$ sudo -H systemctl start postgresql-12

Create a database:

$ sudo -u postgres -H psql --command 'CREATE DATABASE pgroonga_test'

(Normally, you should create a user for pgroonga_test database and use the user. See GRANT USAGE ON SCHEMA pgroonga for details.)

Connect to the created database and execute CREATE EXTENSION pgroonga:

$ sudo -u postgres -H psql -d pgroonga_test --command 'CREATE EXTENSION pgroonga'

That's all!

Try tutorial. You can understand more about PGroonga.