YUKI Hiroshi
null+****@clear*****
Thu Apr 24 19:34:24 JST 2014
YUKI Hiroshi 2014-04-24 19:34:24 +0900 (Thu, 24 Apr 2014) New Revision: 840114b25baac859d690df703403a078e3214af5 https://github.com/droonga/droonga.org/commit/840114b25baac859d690df703403a078e3214af5 Message: Write stesp to set up a Droonga cluster Modified files: tutorial/groonga/index.md Modified: tutorial/groonga/index.md (+68 -10) =================================================================== --- tutorial/groonga/index.md 2014-04-24 18:04:29 +0900 (66dce32) +++ tutorial/groonga/index.md 2014-04-24 19:34:24 +0900 (d64dfce) @@ -8,11 +8,11 @@ layout: en ## The goal of this tutorial -Learning steps to run a Droonga server by your hand, and use it as a [Groonga][groonga] compatible server. +Learning steps to run a Droonga cluster by your hand, and use it as a [Groonga][groonga] compatible server. ## Precondition -* You must have basic knowledge and experiences to setup and operate an [Ubuntu][] Server. +* You must have basic knowledge and experiences to set up and operate an [Ubuntu][] Server. * You must have basic knowledge and experiences to use the [Groonga][groonga] via HTTP. ## Abstract @@ -28,19 +28,77 @@ For example, let's try to build a database system to find [Starbucks stores in N ## Prepare an environment for experiments Prepare a computer at first. -This tutorial describes steps to setup a Droonga server on an existing computer. +This tutorial describes steps to set up a Droonga cluster based on existing computers. Following instructions are basically written for a successfully prepared virtual machine of the `Ubuntu 13.10 x64` on the service [DigitalOcean](https://www.digitalocean.com/), with an available console. NOTE: Make sure to use instances with >= 2GB memory equipped, at least during installation of required packages for Droonga. Otherwise, you may experience a strange build error. -## How to install a Droonga server? +You need to prepare two or more computers for effective replication. + +## Set up a Droonga cluster + +Groonga provides binary packages and you can install Groonga easily, for some environments. +(See: [how to install Groonga](http://groonga.org/docs/install.html)) + +However, currently there is no such an easy way to set up a database system based on Droonga. +We are planning to provide a better way (like a chef cookbook), but for now, you have to set up it by your hand. + +A database system based on the Droonga is called *Droonga cluster*. +A Droonga cluster is constructed with multiple computers, called *Droonga node*. +So you have to set up multiple Droonga nodes for your Droonga cluster. + +Assume that you have two computers: `192.168.0.10` and `192.168.0.11`. + + 1. Install required platform packages, *on each computer*. + + # apt-get update + # apt-get -y upgrade + # apt-get install -y ruby ruby-dev build-essential nodejs npm + + 2. Install a gem package `droonga-engine`, *on each computer*. + It is the core component. + + # gem install droonga-engine + + 3. Install an npm package `droonga-http-server`, *on each computer*. + It is the frontend component. + + # npm install -g droonga-http-server + + 4. Prepare a configuration directory for a Droonga node, *on each computer*. + All physical databases are placed under this directory. + + # mkdir ~/droonga + # cd ~/droonga + + 5. Create a `catalog.json`, *on one of Droonga nodes*. + The file defines the structure of your Droonga cluster. + You'll specify the list of your Droonga node's IP addresses as the `--nodes` option, like: + + # droonga-catalog-generate --dataset=Dataset \ + --nodes=192.168.0.10,192.168.0.11 \ + --output=./catalog.json + + If you have only one computer and trying to set up it just for testing, then you'll do: + + # droonga-catalog-generate --dataset=Dataset \ + --nodes=127.0.0.1 \ + --output=./catalog.json + + 6. Share the generated `catalog.json` *to your all Droonga nodes*. + + # scp ~/droonga/catalog.json 192.169.0.2:~/droonga/ + +All Droonga nodes for your Droonga cluster are prepared by steps described above. +Let's continue to the next step. + +## Start and stop services + +For Groonga, you simply have to install the Groonga and run it with the option `-d`, like: + + # groonga -p 10080 -d --protocol http /tmp/databases/db -TBD - -## How to start and stop the Droonga server? - -TBD ## Create a table @@ -56,7 +114,7 @@ TBD ## Conclusion -In this tutorial, you did setup a [Droonga][] server on a [Ubuntu Linux][Ubuntu]. +In this tutorial, you did set up a [Droonga][] cluster on [Ubuntu Linux][Ubuntu] computers. Moreover, you load data to it and and select data from it successfully, as a [Groonga][] compatible server. [Ubuntu]: http://www.ubuntu.com/ -------------- next part -------------- HTML����������������������������...Download