Restコンソール - Revision history

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

2012-03-04T06:57:30Z

Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

MakoBot: Robot: Cosmetic changes

2012-03-04T04:08:50Z

Robot: Cosmetic changes

MakoBot: Categorized into :Category:Japanese Translations

2011-06-11T09:08:00Z

Categorized into Category:Japanese Translations

MakoBot: added sort key

2011-06-11T08:48:51Z

added sort key

MakoBot: Added all of Japanese translation page into :Category:Japanese Translations and removed them from any other categories

2011-06-11T05:40:46Z

Added all of Japanese translation page into Category:Japanese Translations and removed them from any other categories

Makopoppo: RestConsole/ja moved to Restコンソール

2011-02-27T10:43:48Z

RestConsole/ja moved to Restコンソール

Makopoppo: New page: {{Quicklinks/ja|RestConsole}} ==REST コンソールについて== REST コンソールを使うと、OpenSim サービスのさまざまな管理をリモートで実行できるよう...

2011-02-27T10:43:20Z

New page: {{Quicklinks/ja|RestConsole}} ==REST コンソールについて== REST コンソールを使うと、OpenSim サービスのさまざまな管理をリモートで実行できるよう...

New page

{{Quicklinks/ja|RestConsole}}

==REST コンソールについて==
REST コンソールを使うと、OpenSim サービスのさまざまな管理をリモートで実行できるようになります。

このインターフェースを使うと、コマンドをサーバに送信し、結果を取得できるようになります。データの送受信は RESTful な HTTP で行われます。

送信は非常に単純ですが、受信はそうもいきません。CAPS URI に Long Poll を仕掛けて接続を維持しながら、 Reverse HTTP で受信します。

プロトコルの効率を上げるため、ヘルプ機能がクライアントに送信されます。キー入力の内容をいちいちサーバに送信するのではなく、入力チェックを通過したコマンドラインだけが送信されるようになっています。これを可能にするために、サーバは burst-on-connect でデータを送信します。データの内容は、発行できるコマンドの一覧と、ヘルプ情報となっています。この情報を使って、クライアントは "help" コマンドで表示される内容をローカルでも生成することができるようになっています。もちろん、インタラクティブにコマンドラインのヘルプを送信することもできます。

サンプルのコンソールクライアント、OpenSim.ConsoleClient.exe を見てみると、仕組みがわかると思います。

==使い方==
リモートコンソールを使うには、OpenSimulator 系のサービスを <tt>-console rest</tt> を引数に指定して起動します。

例：グリッドモードの Robust サーバの場合
mono Robust.exe -console rest

例：シミュレータの場合 (グリッド・スタンドアロン共通)
mono OpenSim.exe -console rest

==構文==
ここでは、OpenSimulator 系のサービスのアドレスが <nowiki>http://foo.bar:8002</nowiki> になっていると仮定して説明します。

まず、HTTP POST リクエストを送信して新しいセションを開始します。ユーザ名とパスワードは、OpenSim.ini の <tt>[Network]</tt> セクションの <tt>ConsoleUser</tt> と <tt>ConsolePass</tt> と一致させる必要があります。 
パラメタ: USER, PASS
<nowiki>http://foo.bar:8002/StartSession/</nowiki>
返答: (XML) <ConsoleSession><SessionID></SessionID><Prompt></Prompt></ConsoleSession>

これでセション ID が取得できました。これを使って、コマンドを送信して、結果を受信します。まず、コンソールのスクロールバック・バッファを取得しましょう。 
パラメタ: なし
<nowiki>http://foo.bar:8002/ReadResponses/<SessionID>/</nowiki>
返答: (XML) <ConsoleSession><Line Number=x></Line></ConsoleSession> 
レスポンスには、現在はバッファにある全ての行が含まれています。もう一度取得すると、新しい行だけが取得されます。データがない場合、30 秒間待機した後で、エラーを返します。クライアントは再試行 (ポーリング) する必要があります。

セション ID を ID パラメタの値に指定して、再度 POST リクエストを送信しましょう。 
パラメタ: ID, COMMAND
<nowiki>http://foo.bar:8002/SessionCommand/</nowiki>
返答: (XML) <ConsoleSession><Result></Result></ConsoleSession> 
全てがうまくいくと、コマンドが実行されるはずです。他のコマンドも試してみましょう。

コネクションを切断する際には、さらに POST リクエストを送信します。 
パラメタ: ID
<nowiki>http://foo.bar:8002/CloseSession/</nowiki>
返答: (XML) <ConsoleSession><Result></Result></ConsoleSession> 
セションが終了します。またコマンドを送信する場合は、再度ログインしなければならなくなります。

==サンプル==
[[RestConsole#Examples]] を見てください。

@@ Line 2: / Line 2: @@
 == REST コンソールについて ==
-REST コンソールを使うと、OpenSim サービスのさまざまな管理をリモートで実行できるようになります。
+REST コンソールを使うと、OpenSimulator サービスのさまざまな管理をリモートで実行できるようになります。
 このインターフェースを使うと、コマンドをサーバに送信し、結果を取得できるようになります。データの送受信は RESTful な HTTP で行われます。

← Older revision		Revision as of 08:48, 11 June 2011
Line 50:		Line 50:
	[[RestConsole#Examples]] を見てください。		[[RestConsole#Examples]] を見てください。
	[[Category:Japanese Translations]]		[[Category:Japanese Translations]]
		+	{{DEFAULTSORT:れすと}}

← Older revision		Revision as of 05:40, 11 June 2011
Line 49:		Line 49:
	==サンプル==		==サンプル==
	[[RestConsole#Examples]] を見てください。		[[RestConsole#Examples]] を見てください。
		+	[[Category:Japanese Translations]]

@@ Line 1: / Line 1: @@
 {{Quicklinks/ja|RestConsole}}
-==REST コンソールについて==
+== REST コンソールについて ==
 REST コンソールを使うと、OpenSim サービスのさまざまな管理をリモートで実行できるようになります。
@@ Line 12: / Line 12: @@
 サンプルのコンソールクライアント、OpenSim.ConsoleClient.exe を見てみると、仕組みがわかると思います。
-==使い方==
+== 使い方 ==
 リモートコンソールを使うには、OpenSimulator 系のサービスを <tt>-console rest</tt> を引数に指定して起動します。
@@ Line 21: / Line 21: @@
   mono OpenSim.exe -console rest
-==構文==
+== 構文 ==
 ここでは、OpenSimulator 系のサービスのアドレスが <nowiki>http://foo.bar:8002</nowiki> になっていると仮定して説明します。
-まず、HTTP POST リクエストを送信して新しいセションを開始します。ユーザ名とパスワードは、OpenSim.ini の <tt>[Network]</tt> セクションの <tt>ConsoleUser</tt> と <tt>ConsolePass</tt> と一致させる必要があります。<br>
+まず、HTTP POST リクエストを送信して新しいセションを開始します。ユーザ名とパスワードは、OpenSim.ini の <tt>[Network]</tt> セクションの <tt>ConsoleUser</tt> と <tt>ConsolePass</tt> と一致させる必要があります。<br />
 パラメタ: USER, PASS
   <nowiki>http://foo.bar:8002/StartSession/</nowiki>
 返答: (XML) <ConsoleSession><SessionID></SessionID><Prompt></Prompt></ConsoleSession>
-これでセション ID が取得できました。これを使って、コマンドを送信して、結果を受信します。まず、コンソールのスクロールバック・バッファを取得しましょう。<br>
+これでセション ID が取得できました。これを使って、コマンドを送信して、結果を受信します。まず、コンソールのスクロールバック・バッファを取得しましょう。<br />
 パラメタ: なし
   <nowiki>http://foo.bar:8002/ReadResponses/<SessionID>/</nowiki>
-返答: (XML) <ConsoleSession><Line Number=x></Line></ConsoleSession><br>
+返答: (XML) <ConsoleSession><Line Number=x></Line></ConsoleSession><br />
 レスポンスには、現在はバッファにある全ての行が含まれています。もう一度取得すると、新しい行だけが取得されます。データがない場合、30 秒間待機した後で、エラーを返します。クライアントは再試行 (ポーリング) する必要があります。
-セション ID を ID パラメタの値に指定して、再度 POST リクエストを送信しましょう。<br>
+セション ID を ID パラメタの値に指定して、再度 POST リクエストを送信しましょう。<br />
 パラメタ: ID, COMMAND
   <nowiki>http://foo.bar:8002/SessionCommand/</nowiki>
-返答: (XML) <ConsoleSession><Result></Result></ConsoleSession><br>
+返答: (XML) <ConsoleSession><Result></Result></ConsoleSession><br />
 全てがうまくいくと、コマンドが実行されるはずです。他のコマンドも試してみましょう。
-コネクションを切断する際には、さらに POST リクエストを送信します。<br>
+コネクションを切断する際には、さらに POST リクエストを送信します。<br />
 パラメタ: ID
   <nowiki>http://foo.bar:8002/CloseSession/</nowiki>
-返答: (XML) <ConsoleSession><Result></Result></ConsoleSession><br>
+返答: (XML) <ConsoleSession><Result></Result></ConsoleSession><br />
 セションが終了します。またコマンドを送信する場合は、再度ログインしなければならなくなります。
-==サンプル==
+== サンプル ==
 [[RestConsole#Examples]] を見てください。
 {{DEFAULTSORT:れすと}}
 [[Category:Japanese Translations]]