Skip to content

Commit

Permalink
Add steps to install libgroonga-dev
Browse files Browse the repository at this point in the history
  • Loading branch information
piroor committed Sep 28, 2014
1 parent 5313a8d commit 34c174a
Show file tree
Hide file tree
Showing 3 changed files with 118 additions and 33 deletions.
79 changes: 60 additions & 19 deletions _po/ja/tutorial/1.0.6/virtual-machines-for-experiments/index.po
@@ -1,7 +1,7 @@
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"PO-Revision-Date: 2014-09-26 18:15+0900\n"
"PO-Revision-Date: 2014-09-26 18:21+0900\n"
"Language: ja\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
Expand Down Expand Up @@ -79,15 +79,11 @@ msgstr ""
"仮想マシンは多くのRAMを要求するため、ホストマシンにはできれば8GB以上のメモリがあることが望ましいです。"

msgid ""
"(However, 3GB RAM may be enough to do experiments.\n"
"When you install components of the Droonga system, the machine must have 2GB R"
"AM at minimum, to build native extensions of [Rroonga][].\n"
"After that, Droonga nodes can work with less RAM, for example 512MB.)"
"(However, there are some loopholes. See the [appendix of this tutorial](#less-"
"size-memory).)"
msgstr ""
"(ただ、単なる実験のためであれば、3GB程度のメモリがあればどうにかなります。\n"
"Droongaシステムを構成するコンポーネントをインストールする時には、[Rroonga][]のネイティブ拡張をビルドするために最低でも2GB程度のメモリが"
"必要になります。\n"
"しかし一度ビルドが終わってしまえば、その後は各Droongaノードには512MBかその程度のメモリがあれば十分に動作します。)"
"(メモリ搭載量がそこまで多くない場合でも、いくつかの抜け道があります。詳しくは[このチュートリアルの付録](#less-size-memory)を参照して下"
"さい。)"

msgid "## Steps to prepare VMs"
msgstr "## 仮想マシンを用意する手順"
Expand Down Expand Up @@ -315,20 +311,64 @@ msgstr ""
msgid "Then Vagrant shuts down all VMs completely."
msgstr "これで、Vagrantがすべての仮想マシンを完全に終了させてくれます。"

msgid "### Appendix: if your host machine has less size RAM..."
msgstr "### 付録: ホストマシンのRAMがそれほど多くない場合"
msgid "### Appendix: if your host machine has less size RAM... {#less-size-memory}"
msgstr "### 付録: ホストマシンのRAMがそれほど多くない場合 {#less-size-memory}"

msgid "Even if your computer has less size RAM, you don't have to give up."
msgstr "手持ちのコンピュータが十分なサイズのメモリを搭載していないとしても、諦める必要はありません。"

msgid ""
"2GB RAM for each virtual machine is required just for building native extensio"
"ns of [Rroonga][].\n"
"In other words, Droonga nodes can work with less RAM, if there are existing (a"
"lready built) binary libraries."
msgstr ""
"各仮想マシンに2GBのメモリが必要になるのは、[Rroonga][]のネイティブ拡張をビルドする必要があるからです。\n"
"言い換えると、既にビルド済みのバイナリがあるのであれば、Droongaノードはそこまでのメモリがなくても動作します。"

msgid "So there are two options for you:"
msgstr "この場合、以下の2つの選択肢があります:"

msgid ""
"If your host machine has less RAM (for example smaller than 3GB), you cannot r"
"un all VMs with 2GB RAM.\n"
"However, if you configure VMs with small size RAM (ex. 512MB), you cannot inst"
"all Droonga services."
" A. Install pre-built binary library from the [Groonga][]'s repository.\n"
" B. Install Droonga services for each VM step by step."
msgstr ""
"ホストマシンのメモリが小さい(例えば3GB未満)と、2GBのメモリを持った状態の仮想マシンは複数起動できません。\n"
"しかしながら、仮想マシンのメモリを小さく設定すると(例えば512MB)、Droongaのサービスをインストールできません。"
" A. [Groonga][]のリポジトリからビルド済みのバイナリをインストールしておく。\n"
" B. 各仮想マシンに順番にDroongaのサービスをインストールしていく。"

msgid ""
"The first option is available only for some platforms.\n"
"[Groonga][] provides its own repository of packages.\n"
"See the [installation guide](http://groonga.org/docs/install.html), and regist"
"er Groonga's repository for your platform, as described.\n"
"Then you can install pre-built binary library as the package `libgroonga-dev`."
msgstr ""
"1つ目の選択肢は、いくつかのプラットフォームでのみ利用できます。\n"
"[Groonga][]は独自のパッケージのためのリポジトリを提供しています。\n"
"[Groongaのインストール手順](http://groonga.org/ja/docs/install.html)を参照し、説明に従ってその環境用のGr"
"oongaのリポジトリを登録して下さい。\n"
"そうすると、パッケージ`libgroonga-dev`としてビルド済みのバイナリをインストールすることができます。"

msgid "For example, if your VM is running with Ubuntu:"
msgstr "例えば、仮想マシンがUbuntuで動作しているのであれば手順は以下の通りです:"

msgid "Then you can install Droonga services for each VM step by step, like:"
msgstr "このような場合、以下の手順でDroongaのサービスを各仮想マシンに1台ずつインストールできます:"
msgid ""
"~~~\n"
"$ sudo add-apt-repository -y ppa:groonga/ppa\n"
"$ sudo apt-get update\n"
"$ sudo apt-get install -y libgroonga-dev\n"
"~~~"
msgstr ""

msgid "After that, installation of `droonga-engine` will finish quickly."
msgstr "これで、`droonga-engine`のインストールがすぐに終わるようになります。"

msgid ""
"The second option is simple.\n"
"You can install Droonga services for each VM step by step, like:"
msgstr ""
"第2の選択肢は単純です。\n"
"以下のようにすると、各仮想マシンに順番にDroongaのサービスをインストールしていくことができます:"

msgid ""
" 1. Shutdown all VMs by `vagrant halt`.\n"
Expand Down Expand Up @@ -365,6 +405,7 @@ msgid ""
" [Vagrant]: https://www.vagrantup.com/\n"
" [Vagrant Cloud]: https://vagrantcloud.com/\n"
" [VirtualBox]: https://www.virtualbox.org/\n"
" [Groonga]: http://groonga.org/\n"
" [Rroonga]: https://github.com/ranguba/rroonga\n"
" [Ubuntu]: http://www.ubuntu.com/\n"
" [Droonga]: https://droonga.org/\n"
Expand Down
36 changes: 29 additions & 7 deletions ja/tutorial/1.0.6/virtual-machines-for-experiments/index.md
Expand Up @@ -38,9 +38,7 @@ Droongaは分散型のデータ処理システムなので、クラスタを構
まず最初に、仮想マシンのホストとなるPCを用意する必要があります。
仮想マシンは多くのRAMを要求するため、ホストマシンにはできれば8GB以上のメモリがあることが望ましいです。

(ただ、単なる実験のためであれば、3GB程度のメモリがあればどうにかなります。
Droongaシステムを構成するコンポーネントをインストールする時には、[Rroonga][]のネイティブ拡張をビルドするために最低でも2GB程度のメモリが必要になります。
しかし一度ビルドが終わってしまえば、その後は各Droongaノードには512MBかその程度のメモリがあれば十分に動作します。)
(メモリ搭載量がそこまで多くない場合でも、いくつかの抜け道があります。詳しくは[このチュートリアルの付録](#less-size-memory)を参照して下さい。)

## 仮想マシンを用意する手順

Expand Down Expand Up @@ -178,12 +176,35 @@ $ vagrant halt

これで、Vagrantがすべての仮想マシンを完全に終了させてくれます。

### 付録: ホストマシンのRAMがそれほど多くない場合
### 付録: ホストマシンのRAMがそれほど多くない場合 {#less-size-memory}

ホストマシンのメモリが小さい(例えば3GB未満)と、2GBのメモリを持った状態の仮想マシンは複数起動できません。
しかしながら、仮想マシンのメモリを小さく設定すると(例えば512MB)、Droongaのサービスをインストールできません。
手持ちのコンピュータが十分なサイズのメモリを搭載していないとしても、諦める必要はありません。

このような場合、以下の手順でDroongaのサービスを各仮想マシンに1台ずつインストールできます:
各仮想マシンに2GBのメモリが必要になるのは、[Rroonga][]のネイティブ拡張をビルドする必要があるからです。
言い換えると、既にビルド済みのバイナリがあるのであれば、Droongaノードはそこまでのメモリがなくても動作します。

この場合、以下の2つの選択肢があります:

A. [Groonga][]のリポジトリからビルド済みのバイナリをインストールしておく。
B. 各仮想マシンに順番にDroongaのサービスをインストールしていく。

1つ目の選択肢は、いくつかのプラットフォームでのみ利用できます。
[Groonga][]は独自のパッケージのためのリポジトリを提供しています。
[Groongaのインストール手順](http://groonga.org/ja/docs/install.html)を参照し、説明に従ってその環境用のGroongaのリポジトリを登録して下さい。
そうすると、パッケージ`libgroonga-dev`としてビルド済みのバイナリをインストールすることができます。

例えば、仮想マシンがUbuntuで動作しているのであれば手順は以下の通りです:

~~~
$ sudo add-apt-repository -y ppa:groonga/ppa
$ sudo apt-get update
$ sudo apt-get install -y libgroonga-dev
~~~

これで、`droonga-engine`のインストールがすぐに終わるようになります。

第2の選択肢は単純です。
以下のようにすると、各仮想マシンに順番にDroongaのサービスをインストールしていくことができます:

1. `vagrant halt`ですべての仮想マシンを終了する。
2. `virtualbox`でVirtualBoxのコンソールを開く。
Expand All @@ -203,6 +224,7 @@ $ vagrant halt
[Vagrant]: https://www.vagrantup.com/
[Vagrant Cloud]: https://vagrantcloud.com/
[VirtualBox]: https://www.virtualbox.org/
[Groonga]: http://groonga.org/
[Rroonga]: https://github.com/ranguba/rroonga
[Ubuntu]: http://www.ubuntu.com/
[Droonga]: https://droonga.org/
Expand Down
36 changes: 29 additions & 7 deletions tutorial/1.0.6/virtual-machines-for-experiments/index.md 100644 → 100755
Expand Up @@ -29,9 +29,7 @@ This tutorial describes *how to prepare three virtual machines* by Vagrant.
First, you have to prepare a PC as the host of VMs.
Because each VM requires much RAM, the host machine should have much more RAM - hopefully, 8GB or larger.

(However, 3GB RAM may be enough to do experiments.
When you install components of the Droonga system, the machine must have 2GB RAM at minimum, to build native extensions of [Rroonga][].
After that, Droonga nodes can work with less RAM, for example 512MB.)
(However, there are some loopholes. See the [appendix of this tutorial](#less-size-memory).)

## Steps to prepare VMs

Expand Down Expand Up @@ -169,12 +167,35 @@ $ vagrant halt

Then Vagrant shuts down all VMs completely.

### Appendix: if your host machine has less size RAM...
### Appendix: if your host machine has less size RAM... {#less-size-memory}

If your host machine has less RAM (for example smaller than 3GB), you cannot run all VMs with 2GB RAM.
However, if you configure VMs with small size RAM (ex. 512MB), you cannot install Droonga services.
Even if your computer has less size RAM, you don't have to give up.

Then you can install Droonga services for each VM step by step, like:
2GB RAM for each virtual machine is required just for building native extensions of [Rroonga][].
In other words, Droonga nodes can work with less RAM, if there are existing (already built) binary libraries.

So there are two options for you:

A. Install pre-built binary library from the [Groonga][]'s repository.
B. Install Droonga services for each VM step by step.

The first option is available only for some platforms.
[Groonga][] provides its own repository of packages.
See the [installation guide](http://groonga.org/docs/install.html), and register Groonga's repository for your platform, as described.
Then you can install pre-built binary library as the package `libgroonga-dev`.

For example, if your VM is running with Ubuntu:

~~~
$ sudo add-apt-repository -y ppa:groonga/ppa
$ sudo apt-get update
$ sudo apt-get install -y libgroonga-dev
~~~

After that, installation of `droonga-engine` will finish quickly.

The second option is simple.
You can install Droonga services for each VM step by step, like:

1. Shutdown all VMs by `vagrant halt`.
2. Open the VirtualBox console by `virtualbox`.
Expand All @@ -194,6 +215,7 @@ You can try [the "getting started" tutorial](../groonga/) and others with multip
[Vagrant]: https://www.vagrantup.com/
[Vagrant Cloud]: https://vagrantcloud.com/
[VirtualBox]: https://www.virtualbox.org/
[Groonga]: http://groonga.org/
[Rroonga]: https://github.com/ranguba/rroonga
[Ubuntu]: http://www.ubuntu.com/
[Droonga]: https://droonga.org/
Expand Down

0 comments on commit 34c174a

Please sign in to comment.