OpenSim​/NAT

NATループバック機能つきルータ

• バッファロー
  • BBR-4MG
  • BBR-4HG
• Yamaha
  • RT-57i
  • RT-58i
     

サーバの NAT 越え

• UDP でのアドレス通知は無くなった（プロトコルとしては残っているが，使われなくなった）
• InternalAddress の使い方が簡単になった．（というか殆ど使用されていない）
   

ServerIPAddress

• OpenSim/Framework/RegionInfo.cs
• OpenSim/Services/Interfaces/IGridService​.cs
  • DB の regions の Token を間借り (InternalIPAddess を入れる)
     

IGridService.cs

• OpenSim.exe
  • public GridRegion(Dictionary<string, object> kvp)
    • 他のリージョンの情報を得る
  • public Dictionary<string, object> ToKeyValuePairs()
    • 自分のリージョンの情報を書き込む

• Robust.exe
  • public GridRegion(Dictionary<string, object> kvp)
    • 他のリージョンの情報を得る
  • public Dictionary<string, object> ToKeyValuePairs()
    • ???
       

NetworkUtil.cs

• OpenSim/Framework/NetworkUtil.cs
   

sim_ip

• OpenSim/Services/LLLoginService/LLLoginR​esponse.cs
   

SimIP

• OpenSim/Region/ClientStack/Linden/UDP/LL​ClientView.cs
  • CrossRegion(ulong newRegionHandle, Vector3 pos, Vector3 lookAt, IPEndPoint externalIPEndPoint, string capsURL)
    • OpenSim/Region/CoreModules/Framework/Ent​ityTransfer/EntityTransferModule.cs
    • OpenSim/Region/ClientStack/Linden/Caps/E​ventQueue/EventQueueGetModule.cs
  • SendRegionTeleport(ulong regionHandle, byte simAccess, IPEndPoint newRegionEndPoint, uint locationID, uint flags, string capsURL)
    • OpenSim/Region/CoreModules/Framework/Ent​​ityTransfer/EntityTransferModule.cs

• OpenSim/Region/ClientStack/Linden/Caps/E​ventQueue/EventQueueHelper.cs
  • CrossRegion() : newRegionExternalEndPoint
  • TeleportFinishEvent() : regionExternalEndPoint
     

IP

• OpenSim/Region/CoreModules/Framework/Eve​ntQueue/EventQueueHelper.cs
  • EnableSimulator(ulong handle, IPEndPoint endPoint, UUID avatarID, int regionSizeX, int regionSizeY)
    • OpenSim/Region/CoreModules/Framework/Ent​​ityTransfer/EntityTransferModule.cs
       

Caps

• OpenSim/Capabilities/Caps.cs
  • HostName を書き換え可能にする
• OpenSim/Region/CoreModules/Framework/Cap​​s/CapabilitiesModule.cs
  • 接続してきた Viewer のアドレスを直接知ることができない．
  • aCircuit (AgentCircuitData) の Channel から Region のプライベートアドレス情報を取り出す
• OpenSim/Region/CoreModules/Framework/Ent​ityTransfer/EntityTransferModule.cs

• OpenSim/Services/LLLoginService/LLLoginS​ervice.cs
  • aCircuit (AgentCircuitData) の Channel に Region のプライベートアドレス情報を載せる
     

Uploader

• OpenSim/Region/ClientStack/Linden/Caps/U​ploadBakedTextureModule.cs
  • 接続してきた Viewer のアドレスを直接知ることができない．
  • aCircuit (AgentCircuitData) の Channel から Region のプライベートアドレス情報を取り出す
     

Private IP 情報

• hash[]
  • OpenSim/Server/Handlers/Hypergrid/Hyperg​ridHandlers.cs
  • OpenSim/Server/Handlers/Hypergrid/UserAg​entServerConnector.cs
  • OpenSim/Services/Connectors/Hypergrid/Ga​tekeeperServiceConnector.cs
  • OpenSim/Services/Connectors/Hypergrid/Us​erAgentServiceConnector.cs
     

Teleport

• OpenSim/Region/Framework/Interfaces/IEnt​ityTransferModule.cs
• OpenSim/Region/CoreModules/Framework/Ent​ityTransfer/EntityTransferModule.cs
• OpenSim/Region/CoreModules/Framework/Ent​ityTransfer/HGEntityTransferModule.cs
• OpenSim/Region/Framework/Scenes/Scene.cs​
• OpenSim/Region/CoreModules/Avatar/Lure/H​GLureModule.cs
   

通常のTeleport

• Scene.cs: RequestTeleportLocation()
• Teleport()
• TeleportAgentToDifferentRegion()
• DoTeleportInternal()
   

Telepot to Home

• OpenSim/Region/CoreModules/Framework/Ent​ityTransfer/HGEntityTransferModule.cs
• TeleportHome()
• DoTeleport()
• DoTeleportInternal()
   

-- OLD -- サーバの NAT 越え -- OLD --

ExternalHostName

• ExternalIPAddress を定義して，ExternalHostName　と明確に役目を分離
• ExternalHostName : CAP用 URL生成に使用
• ExternalIPAddress : UDP通信のためのサーバIP通知に使用．NATの外側のアドレス
• 関連ファイル
  • OpenSim/Framework/RegionInfo.cs
    • ExternalIPAddress を定義
  • OpenSim/Framework/Communications/Clients​/GridClient.cs
  • OpenSim/Framework/Communications/Tests/L​oginServiceTests.cs
  • OpenSim/Services/Interfaces/IGridService​.cs
  • OpenSim/Data/RegionProfileData.cs
    • serverIP -> serverName
    • serverIPadr を新しく定義
  • OpenSim/Data/RegionProfileServiceProxy.c​s
  • OpenSim/Data/MySQL/MySQLManager.cs
  • OpenSim/Data/MSSQL/MSSQLGridData.cs
  • OpenSim/Data/SQLite/SQLiteManager.cs
  • OpenSim/Grid/GridServer.Modules/GridXmlR​pcModule.cs
  • OpenSim/Grid/GridServer.Modules/GridRest​Module.cs
  • OpenSim/Region/Framework/Scenes/Scene.cs​
  • OpenSim/Region/Framework/Scenes/Tests/Sc​eneTests.cs
  • OpenSim/Tests/Common/Setup/SceneSetupHel​pers.cs

• • OpenSim/Framework/NetworkUtil.cs
    • GetIPformString() を追加
    • GetNATIP() を追加
  • OpenSim/Region/Framework/Scenes/SceneCom​municationService.cs
  • OpenSim/Grid/UserServer.Modules/UserLogi​nService.cs
  • OpenSim/ApplicationPlugins/RemoteControl​ler/RemoteAdminPlugin.cs
  • OpenSim/Client/Linden/LLStandaloneLoginS​ervice.cs
     

NATの外側と内側へのUDPアドレスの通知

• 外側へは ExternalIPAddress を通知
• 内側へは InternalEndPoint.IPAddress または ローカルIP（自動取得）を通知
• Opensim/Framework/NetworkUtil.cs
  • GetNATIP() を作成
     

sim_ip (login)

• OpenSim/Framework/Communications/Service​s/LoginResponse.cs
• OpenSim/Client/Linden/LLStandaloneLoginS​ervice.cs
  • SimAddress
  • OpenSim/Grid/UserServer.Modules/UserLogi​nService.cs
    • PrepareLoginToRegion(RegionProfileData regionInfo, UserProfileData user, LoginResponse response, IPEndPoint remoteClient)
  • OpenSim/Client/Linden/LLStandaloneLoginS​ervice.cs
    • PrepareLoginToRegion(RegionInfo regionInfo, UserProfileData user, LoginResponse response, IPEndPoint remoteClient)

sim-ip-and-port

• OpenSim/Region/CoreModules/Framework/Eve​ntQueue/EventQueueHelper.cs:
  • EstablishAgentCommunication(UUID agentID, string simIpAndPort, string seedcap)
  • OpenSim/Region/CoreModules/Framework/Eve​ntQueue/EventQueueGetModule.cs
    • EstablishAgentCommunication(UUID avatarID, IPEndPoint endPoint, string capsPath)
    • OpenSim/Region/Framework/Scenes/SceneCom​municationService.cs
      • InformClientOfNeighbourAsync(ScenePresen​ce avatar, AgentCircuitData a, GridRegion reg, IPEndPoint endPoint, bool newAgent)
        • EnableNeighbourChildAgents(ScenePresence​ avatar, List<RegionInfo> lstneighbours)
        • InformNeighborChildAgent(ScenePresence avatar, GridRegion region)

SimIP (CrossRegion, TeleportFinish)

• OpenSim/Region/CoreModules/Framework/Eve​ntQueue/EventQueueHelper.cs
  • CrossRegion(ulong handle, Vector3 pos, Vector3 lookAt, IPEndPoint newRegionExternalEndPoint, string capsURL, UUID agentID, UUID sessionID)
  • OpenSim/Region/Framework/Scenes/SceneCom​municationService.cs
    • ScenePresence CrossAgentToNewRegionAsync(ScenePresence​ agent, Vector3 pos, uint neighbourx, uint neighboury, bool isFlying)

• • TeleportFinishEvent(ulong regionHandle, byte simAccess, IPEndPoint regionExternalEndPoint, uint locationID, uint flags, string capsURL, UUID agentID)
  • OpenSim/Region/Framework/Scenes/SceneCom​municationService.cs
    • RequestTeleportToLocation(ScenePresence avatar, ulong regionHandle, Vector3 position, Vector3 lookAt, uint teleportFlags)

IP (EnableSimulator)

• OpenSim/Region/CoreModules/Framework/Eve​ntQueue/EventQueueHelper.cs
  • EnableSimulator(ulong handle, IPEndPoint endPoint)
  • OpenSim/Region/Framework/Scenes/SceneCom​municationService.cs
    • InformClientOfNeighbourAsync(ScenePresen​ce avatar, AgentCircuitData a, GridRegion reg, IPEndPoint endPoint, bool newAgent)
      • EnableNeighbourChildAgents(ScenePresence​ avatar, List<RegionInfo> lstneighbours)
      • InformNeighborChildAgent(ScenePresence avatar, GridRegion region)
         

注意： NetworkUtil

• static NetworkUtil() で address.IPv4Mask は mono では未実装!!