OpenSim/Patch for OpenSim in NAT のバックアップ(No.1)

• バックアップ一覧
• 差分 を表示
• 現在との差分 を表示
• ソース を表示
• OpenSim/Patch for OpenSim in NAT へ行く。
  • 1 (2023-12-30 (土) 22:08:29)
  • 2 (2023-12-30 (土) 22:08:41)
  • 3 (2023-12-30 (土) 22:09:18)
  • 4 (2023-12-30 (土) 22:10:06)

---

Patch for OpenSim in NAT(NAPT) †[edit]

• &font(Blue){English is Here};

概要 †[edit]

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

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

機能制限 †[edit]

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

注意 †[edit]

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

ダウンロード †[edit]

for OpenSim 0.8.2 †[edit]

• opensim_nat_0.8.2.patch

for OpenSim 0.8.1 †[edit]

• 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)

設定方法 †[edit]

Regions.ini †[edit]

• 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 ファイル †[edit]

• 基本的には hosts ファイルを記述しなくても良いはずであるが，もし動作がおかしいサービスがあった場合はViewerが動作するPCの hosts ファイルを記述してみる．
• &font(Red){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 †[edit]

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

JOGrid で使用する方法 †[edit]

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

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

OSGrid で使用する方法 †[edit]

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

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

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

バグ †[edit]

Go Home バグ （in the OSGrid） †[edit]

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

&ref(): File not found: "abnormal_return.png" at page "OpenSim/Patch for OpenSim in NAT (E)";

その他 †[edit]

原理・仕組み †[edit]

devel †[edit]