OpenSim InterRegionCommunications
From OpenSimulator
m (Robot: Cosmetic changes) |
|||
| (6 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
| + | __NOTOC__ | ||
| + | {{Quicklinks}} | ||
| + | {{content}} | ||
| + | === 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. | 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. | ||
| Line 6: | Line 10: | ||
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. | 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. | + | 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. | 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. | + | 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. | + | 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. | + | 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---> | + | Login--->ExpectUser--->Client Connect--->InformNeighborsOfChildAgent--->NeighborExpectUser--->ClientConnectNeighbor |
| − | + | * Grid | |
RegionRegistersSS----> SSRegistersGrid---> GridSendsBackNeighbors---> RegionUP | RegionRegistersSS----> SSRegistersGrid---> GridSendsBackNeighbors---> RegionUP | ||
| − | + | * Same Instance | |
LoginGrid--->GridNofityRegion--->ExpectUser--->Client Connect---->InformNeighborsofChildAgent--->NeighborExpectUser--->ClientConnectNeighbor | LoginGrid--->GridNofityRegion--->ExpectUser--->Client Connect---->InformNeighborsofChildAgent--->NeighborExpectUser--->ClientConnectNeighbor | ||
| − | + | * InterRegion | |
| − | LoginGrid--->GridNotifyRegion--->ExpectUser--->LocalBackEndExpectUser--->ClientConnect----> | + | LoginGrid--->GridNotifyRegion--->ExpectUser--->LocalBackEndExpectUser--->ClientConnect---->SSInformNeighborsOfChildAgent---> |
OGS1InformNeighborsOfChildAgent--->OGS1NeighborExpectUser---->LocalBackEndServiceExpectUser---->SceneExpectUser--->ClientConnect | OGS1InformNeighborsOfChildAgent--->OGS1NeighborExpectUser---->LocalBackEndServiceExpectUser---->SceneExpectUser--->ClientConnect | ||
| + | |||
| + | [[Category:Support]] | ||
| + | [[Category:Tech Reference]] | ||
| + | [[Category:Help]] | ||
| + | [[Category:Configuration]] | ||
| + | [[Category:Getting Started]] | ||
| + | [[Category:Development]] | ||
Latest revision as of 19:46, 3 March 2012
 |
Languages: |
|
|
|
This article or section contains incomplete information. Please help us by completing the content on this page. |
[edit] 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
