Network System Laboratory - OpenSim/Patch for OpenSim in NAT [Patch for OpenSim in NAT(NAPT)]

[ Freeze | Diff | Backup | Reload ]

概要

これは，OpenSim を NATループバック（ヘアピンNAT）機能なしのNAT内で動かすためのパッチです．
OpenSim-0.8.1/0.8.2 対応．
HyperGrid/Standalone Hypergrid モードのみ対応 (他のモードでも動くかもしれませんが，全て検証する時間がありません)．
OpenSimの全ての機能をサポートしているわけではありません．
パッチの効果を最大限に引き出すには，グリッド内の全てのサーバにパッチを適用する必要があります．
このパッチは，OpenSim のコアな部分も書き換えています．このパッチを適用したことにより，OpenSimの誤作動やインベントリの消失などが発生しても，当方は一切関知しません．全て自己責任で使用してください．

Capability の書き換えは複雑すぎて，副作用が発生する可能性があるので止める -> hosts ファイルで対応　(3/19)

機能制限

同じNAT内の自分のリージョンに直接ログインするためには，Robust サーバにパッチが適用されていなければなりません（HyperGridの場合）．
同じNAT内の自分のリージョンへNAT外の他のリージョンからTPする場合は，TP元の Region サーバにパッチが適用されていなければなりません．
つまり，同じNAT内の自分の OpenSim（Region サーバ）にしかパッチが適用されていない場合は，使い物になりません
JOGではメインのサーバには全てパッチが適用されています．

注意

DB の regions テーブルの Token カラムを，NAT内PCのプライベートアドレスを保管する場所として流用しています．
- ソースコードを見る限りでは，TokenカラムデータはHyperGridでは使用されていないように見えます（確証はありません）．
~~サーキットデータクラスの Channel メンバ変数を書き換えています．~~
- ~~送信先サーバがNAT内の場合，最後に " [Internal]" を追加．~~

ダウンロード

for OpenSim 0.8.2

opensim_nat_0.8.2.patch

for OpenSim 0.8.1

0.92 は StandAlone Grid をサポートします．（制限あり）
opensim_nat_0.8.1-0.92.patch (2015 3/27)
for JOG: opensim-0.8.1-nat-0.92-JOG.zip (2015 3/27)
for OSG: opensim-0.8.1-nat-0.92-OSG.zip (2015 3/27)

設定方法

Regions.ini

InternalAddress にはサーバ（PC）のプライベートIPアドレスを記述する．0.0.0.0 と記述してはいけない．
- Windows の場合は，コンソールウィンドウから ipconfig コマンドを入力すればプライベートIPアドレスが表示される．
ExternalHostName にはサーバ（PC）のドメイン名（FQDN）を記述する．SYSTEMIP またはグローバルなIPアドレスを記述してはいけない．
- ドメイン名（FQDN）を外部のDNSに登録する（ほとんどの場合はDynamicDNSとなるはず）．

サンプル

[Remote Test]
RegionUUID = ccfaa21e-ed4a-4e2e-bcee-d8a3272a5fdc
Location = 7992,8006
InternalAddress = 192.168.27.7
InternalPort = 9000
AllowAlternatePorts = False
ExternalHostName = sirius.star-dust.jp

hosts ファイル

基本的には hosts ファイルを記述しなくても良いはずであるが，もし動作がおかしいサービスがあった場合はViewerが動作するPCの hosts ファイルを記述してみる．
Viewerを起動するPC上の hosts ファイルの内容を必ず記述してください．
上の例では下記のように記述する
```
192.168.27.7  sirius.star-dust.jp
```

hosts ファイルの場所
- Linux/Unix: /etc/hosts
- Windows: C:\Windows\System32\drivers\etc\hosts
- OSX: /private/etc/hosts

Standalone Grid

OpenSimサーバをビューアと同じPCで起動している場合でも，サーバのIPアドレスとして 127.0.0.1　(localhost) は使用しないでください.

JOGrid で使用する方法

JOGrid 内のメインサーバには全てパッチが適用されています．

Regions.ini を記述する
Viewerを起動するPC上の hosts ファイルの内容を記述

OSGrid で使用する方法

OSG では Robust (Login) サーバにパッチを適用できませんので，同じNAT内の自分のリージョンに直接ログインすることはできません．
他のパッチが適用されていないリージョンから直接，移動，TPはできません．
JOG Gate (9999,9886) にはパッチが適用されていますので，JOG Gate を経由して自分のリージョンにTPしてください．

自分の管理するグリッドで使用する場合．

グリッドで管理する全てのOpenSim のソースコードにパッチを適用して，コンパイルする．(Robust　サーバを含む)
HyperGrid 接続するユーザにパッチ適用済みのバイナリを使用するように指示する．

バグ

Go Home バグ（in the OSGrid）

OSGrid で JOG Gate から，"Go Home" ボタンまたは Ctrl+Shift+H でホームに帰還した際に表示が異常になる場合があります（Robustサーバにパッチが適用されていないせいかもしれない: 正確にはOSGはRobustサーバではありませんが）．
ホームに帰還する場合は，JOG Gate でホームを検索してからテレポートで帰還してください．
それでもダメな時は JOGRID.NET:8002 を経由してテレポートで帰還してください．