OpenSim InterRegionCommunications
From OpenSimulator
m (Added "turtle track" navigation to the top of the page, also added proper category tags to the bottom of the page. This page is still a work in progress and it needs to be updated and finished!) |
m (→What is OpenSim_InterRegionCommunications?: Fixed the word "Neighbor" misspellings throughout this document page.) |
||
| Line 21: | Line 21: | ||
* Standalone | * Standalone | ||
| − | Login--->ExpectUser--->Client Connect---> | + | Login--->ExpectUser--->Client Connect--->InformNeighborsOfChildAgent--->NeighborExpectUser--->ClientConnectNeighbor |
* Grid | * Grid | ||
| Line 30: | Line 30: | ||
* InterRegion | * InterRegion | ||
| − | LoginGrid--->GridNotifyRegion--->ExpectUser--->LocalBackEndExpectUser--->ClientConnect----> | + | LoginGrid--->GridNotifyRegion--->ExpectUser--->LocalBackEndExpectUser--->ClientConnect---->SSInformNeighborsOfChildAgent---> |
OGS1InformNeighborsOfChildAgent--->OGS1NeighborExpectUser---->LocalBackEndServiceExpectUser---->SceneExpectUser--->ClientConnect | OGS1InformNeighborsOfChildAgent--->OGS1NeighborExpectUser---->LocalBackEndServiceExpectUser---->SceneExpectUser--->ClientConnect | ||
Revision as of 23:52, 20 May 2009
Technical Reference -> Terms -> OpenSim_InterRegionCommunications
|
|
This article or section contains incomplete information. Please help us by completing the content on this page. |
Technical Reference
What is OpenSim_InterRegionCommunications?
I've been taking a look at the region to region communications and I'm reporting my findings here to make working on it simpler.
Region to region communications are handled by .Net remoting right now.
There are two Communications 'plugins' that are used. Communications.Local which handles inter instance region to region communication and Communications.OGS1 which handles region to region remoting, and grid to region XMLRPC requests.
When starting up, the region gets an instance to a SceneCommunicationService and calls it's RegisterRegion method. This calls the RegisterRegion method on whatever communication provider that you're using, be it Communications.Local or Communications.OGS1. If it gets back a non null response.. (which means it got back a RegionListener object), then it registers for events from that RegionListener.
During remoting events will be received by the RegionListeners for the various neighbor regions.
If the regions are in the same process instance, then there's no reason to remote to the same process, so it triggers the receiving listener's event without remoting.
During this process it uses boolean values to check if the message was handled. If the message was not handled (false), then it goes to the next way of communication. If, at the end, the message wasn't handled by any means of communication, the message is ignored.
LocalBackEndServices' events get triggered by the OGS1's events. The sim's scene receives the event from It's instantiation of LocalBackEndServices, whether or not it's part of a grid.
- Standalone
Login--->ExpectUser--->Client Connect--->InformNeighborsOfChildAgent--->NeighborExpectUser--->ClientConnectNeighbor
- Grid
RegionRegistersSS----> SSRegistersGrid---> GridSendsBackNeighbors---> RegionUP
- Same Instance
LoginGrid--->GridNofityRegion--->ExpectUser--->Client Connect---->InformNeighborsofChildAgent--->NeighborExpectUser--->ClientConnectNeighbor
- InterRegion
LoginGrid--->GridNotifyRegion--->ExpectUser--->LocalBackEndExpectUser--->ClientConnect---->SSInformNeighborsOfChildAgent---> OGS1InformNeighborsOfChildAgent--->OGS1NeighborExpectUser---->LocalBackEndServiceExpectUser---->SceneExpectUser--->ClientConnect
