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 (Robot: Cosmetic changes) |
||
| (4 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | __NOTOC__ | |
| + | {{Quicklinks}} | ||
{{content}} | {{content}} | ||
| − | |||
=== What is OpenSim_InterRegionCommunications? === | === 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 10: | 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 | * 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 | ||
[[Category:Support]] | [[Category:Support]] | ||
| − | [[Category:Tech Reference]] | + | [[Category:Tech Reference]] |
[[Category:Help]] | [[Category:Help]] | ||
[[Category:Configuration]] | [[Category:Configuration]] | ||
| − | [[Category: | + | [[Category:Getting Started]] |
[[Category:Development]] | [[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
