OpenSim InterRegionCommunications - Revision history

MakoBot: Robot: Cosmetic changes

2012-03-04T03:46:10Z

Robot: Cosmetic changes

Makopoppo at 09:22, 4 June 2011

2011-06-04T09:22:07Z

Makopoppo at 08:47, 4 June 2011

2011-06-04T08:47:40Z

Ideia Boa at 23:22, 21 May 2009

2009-05-21T23:22:15Z

Mark.malewski: /* What is OpenSim_InterRegionCommunications? */ Fixed the word "Neighbor" misspellings throughout this document page.

2009-05-21T07:52:02Z

‎What is OpenSim_InterRegionCommunications?: Fixed the word "Neighbor" misspellings throughout this document page.

Mark.malewski: 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!

2009-05-21T07:49:41Z

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!

Simsim at 01:14, 5 October 2008

2008-10-05T01:14:25Z

Simsim at 01:08, 5 October 2008

2008-10-05T01:08:19Z

Teravus: New page: 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 remoti...

2007-11-27T02:29:23Z

New page: 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 remoti...

New page

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--->InformNeihborsOfChildAgent--->NeighborExpectUser--->ClientConnectNeighbor

Grid
RegionRegistersSS----> SSRegistersGrid---> GridSendsBackNeighbors---> RegionUP

Same Instance
LoginGrid--->GridNofityRegion--->ExpectUser--->Client Connect---->InformNeighborsofChildAgent--->NeighborExpectUser--->ClientConnectNeighbor

InterRegion
LoginGrid--->GridNotifyRegion--->ExpectUser--->LocalBackEndExpectUser--->ClientConnect---->SSInformNeibghborsOfChildAgent--->OGS1InformNeighborsOfChildAgent--->OGS1NeighborExpectUser---->LocalBackEndServiceExpectUser---->SceneExpectUser--->ClientConnect

@@ 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.
-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.
+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.
+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.
+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
@@ Line 34: / Line 34: @@
 [[Category:Support]]
 [[Category:Tech Reference]]
 [[Category:Help]]
 [[Category:Configuration]]
-[[Category:Getting_Started]]
+[[Category:Getting Started]]
 [[Category:Development]]

@@ Line 1: / Line 1: @@
 __NOTOC__
-{{Template:Quicklinks}}
+{{Quicklinks}}
-<br />
 {{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.

@@ Line 2: / Line 2: @@
 {{Template:Quicklinks}}
 <br />
 {{content}}
 == [[Technical Reference | Technical Reference]] ==

← Older revision		Revision as of 23:22, 21 May 2009
Line 1:		Line 1:
		+	__NOTOC__
		+	{{Template:Quicklinks}}
		+	<br />
		+
	[[Technical Reference \| Technical Reference]] -> [[Technical Reference/terms \| Terms]] -> [[OpenSim_InterRegionCommunications \| OpenSim_InterRegionCommunications]]		[[Technical Reference \| Technical Reference]] -> [[Technical Reference/terms \| Terms]] -> [[OpenSim_InterRegionCommunications \| OpenSim_InterRegionCommunications]]
	{{content}}		{{content}}

@@ Line 21: / Line 21: @@
 * Standalone
-Login--->ExpectUser--->Client Connect--->InformNeihborsOfChildAgent--->NeighborExpectUser--->ClientConnectNeighbor
+Login--->ExpectUser--->Client Connect--->InformNeighborsOfChildAgent--->NeighborExpectUser--->ClientConnectNeighbor
 * Grid
@@ Line 30: / Line 30: @@
 * InterRegion
-LoginGrid--->GridNotifyRegion--->ExpectUser--->LocalBackEndExpectUser--->ClientConnect---->SSInformNeibghborsOfChildAgent--->
+LoginGrid--->GridNotifyRegion--->ExpectUser--->LocalBackEndExpectUser--->ClientConnect---->SSInformNeighborsOfChildAgent--->
 OGS1InformNeighborsOfChildAgent--->OGS1NeighborExpectUser---->LocalBackEndServiceExpectUser---->SceneExpectUser--->ClientConnect

@@ Line 16: / Line 16: @@
 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.
-(1)Standalone
+* Standalone
 Login--->ExpectUser--->Client Connect--->InformNeihborsOfChildAgent--->NeighborExpectUser--->ClientConnectNeighbor
-(2)Grid
+* Grid
 RegionRegistersSS----> SSRegistersGrid---> GridSendsBackNeighbors---> RegionUP
-(3)Same Instance
+* Same Instance
 LoginGrid--->GridNofityRegion--->ExpectUser--->Client Connect---->InformNeighborsofChildAgent--->NeighborExpectUser--->ClientConnectNeighbor
-(4)InterRegion
+* InterRegion
 LoginGrid--->GridNotifyRegion--->ExpectUser--->LocalBackEndExpectUser--->ClientConnect---->SSInformNeibghborsOfChildAgent--->
 OGS1InformNeighborsOfChildAgent--->OGS1NeighborExpectUser---->LocalBackEndServiceExpectUser---->SceneExpectUser--->ClientConnect