null+****@clear*****
null+****@clear*****
2011年 10月 21日 (金) 13:42:40 JST
yoshihara haruka 2011-10-21 04:42:40 +0000 (Fri, 21 Oct 2011)
New Revision: 498cdf16eb59bdad9eceb5c15adcbd41137a04c4
Log:
translate from Japanese to English.
Modified files:
doc/source/tutorial/network.txt
Modified: doc/source/tutorial/network.txt (+47 -44)
===================================================================
--- doc/source/tutorial/network.txt 2011-10-21 04:35:33 +0000 (bd2917a)
+++ doc/source/tutorial/network.txt 2011-10-21 04:42:40 +0000 (bdc05f9)
@@ -4,45 +4,46 @@
.. groonga-include : introduction.txt
-ネットワークを通じた利用
-========================
+How to use groonga with network
+===============================
-groongaはネットワークを通じて利用することができます。groonga独自プロトコルもしくはHTTPのどちらかを選択してgroongaを起動することにより、groongaはネットワーク接続を待ち受けます。
+You can use groonga with network. When you run groonga by using the groonga's own protocol or HTTP, groonga accepts connection for network.
-groonga専用プロトコルによる通信
--------------------------------
+Connection by groonga's own protocol
+---------------------------------------
-groongaデーモンの起動
-^^^^^^^^^^^^^^^^^^^^^
+Run groonga daemon
+^^^^^^^^^^^^^^^^^^
-書式 ::
+form ::
- groonga [-p ポート番号] -d DBパス名
+ groonga [-p port_number] -d DB_pathname
-既存のデータベースのフルパス名をDBパス名に指定します。
-groongaがデーモンモードで起動し、指定したポート番号でgroongaの専用プロトコルを用いた通信をすることができます。
-(ポート番号を省略した場合は10041が使用されます)
+The DB_pathname is set the full-path of existed-database.
+With this form, you can run groonga as daemon and connect by groonga's own protocol with port_number.
+(The port_number is 10041 when you don't specify port_number.)
-実行例::
+execution example::
% groonga -d /tmp/groonga-databases/introduction.db
12345
%
-デーモンモードで起動後、プロセス番号が表示されます。
+After groonga is run as daemon, show its pid.
-groongaサーバへの接続
-^^^^^^^^^^^^^^^^^^^^^
+Connection with groonga server
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-書式 ::
+form ::
- groonga [-p ポート番号] -c [対象ホスト名またはIPアドレス]
+ groonga [-p port_number] -c [host_name or IP_address]
-対象ホストで動作しているgroongaサーバに接続します。
+This command connect groonga server running at specified host_name or IP_address.
-対象ホスト名を省略した場合はlocalhostに対して接続し、対象ポート番号を省略した場合は10041ポートに対して接続します。
+When you don't specify host_name, this command connect at localhost. When you don't specify post_number, it is 10041.
-接続に成功すると対話モードに入り、標準入力からコマンドを読み込んで順次実行します。
+You can use interactive-mode after connection is succeeded.
+Groonga in interactive-mode runs commands input in standard-input.
.. groonga-command
.. include:: ../example/tutorial/network-1.log
@@ -51,10 +52,10 @@ groongaサーバへの接続
.. .. > ctrl-d
.. .. %
-groongaデーモンの終了
-^^^^^^^^^^^^^^^^^^^^^
+Terminate groonga daemon
+^^^^^^^^^^^^^^^^^^^^^^^^
-groongaデーモンにshutdownコマンドを発行することにより、終了させることができます。
+You can terminate groonga daemon with shutdown command.
.. groonga-command
.. include:: ../example/tutorial/network-2.log
@@ -62,41 +63,43 @@ groongaデーモンにshutdownコマンドを発行することにより、終
.. .. > shutdown
.. .. %
-HTTPによる通信
---------------
+Connection by HTTP
+------------------
-groongaをHTTP経由で利用したい場合には、HTTPプロトコルモードで起動します。
+If you use groonga by HTTP connection, you run groonga as HTTP-protocol-mode with this command.
-書式 ::
+form ::
- groonga [-p ポート番号] -d --protocol http DBパス名
+ groonga [-p port_number] -d --protocol http DB_pathname
-protocolオプションで、groongaが受け付けるプロトコルを指定できます。httpを指定すると、groongaはHTTPプロトコルでの通信を受け付けます。
+With option of "--protocol" you can specify protocol accepted by groonga.
+If you specify http for this option, groonga accept connection with HTTP-protocol.
-HTML管理ツール
-^^^^^^^^^^^^^^
+HTML management
+^^^^^^^^^^^^^^^
-コマンド実行後、http://[IPアドレスまたはホスト名]:[ポート番号]/ というURLにブラウザからアクセスすると、HTML管理ツールが表示されます。ブラウザは、JavaScriptの実行が有効になっている必要があります。
+After the above command is run, you can look at HTML-management tool when you access "http://[host_name or IP_address]:[port_number]/" in your favorite browser.
+You need to accept JavaScript running in your browser.
-HTTPでのコマンド実行
-^^^^^^^^^^^^^^^^^^^^
+Run command with HTTP
+^^^^^^^^^^^^^^^^^^^^^
-groongaがHTTPプロトコルモードで起動されているとき、「/d/コマンド名」というURLにアクセスすると、コマンドを実行することが出来ます。
+When groonga is run by HTTP protocol mode, you can run command by access of the url of "/d/command-name".
-コマンドのオプションは、HTTPのGETパラメータで渡します。つまり、「?オプション=値&オプション=値 …」という書式になります。
+You specify option of command as GET parametor of HTTP, in a word a form of any command with option is "?option=value&option=value ...".
.. groonga-command
.. include:: ../example/tutorial/network-3.log
-.. .. http://[IPまたはホスト名]:[ポート番号]/d/status
-.. .. 実行される処理：
+.. .. http://[host_name or IP_address]:[port_nuber]/d/status
+.. .. execute routine：
.. status
.. ..
-.. .. http://[IPまたはホスト名]:[ポート番号]/d/select?table=Site&query=title:@this
-.. .. 実行される処理：
+.. .. http://[host_name or IP_address]:[port_nuber]/d/select?table=Site&query=title:@this
+.. .. executed routine：
.. select --table Site --query title:@this
-セキュリティ
-------------
+Security
+--------
-groongaのネットワークサービスにはは認証機能がありません。誰でもデータベースの内容を閲覧・修正することができます。iptablesなどを用いて、アクセス元IPアドレスを制限することを薦めます。
+Network service of groonga doesn't have cirtification. Everyone can view and modify the databace. So we reccomend restriction for access from the IP-address with iptables.