Run DSG - intelvwi/DSG GitHub Wiki

HOME > RUN DSG

Once you have all of the DSG simulators installed and configured on the right set of servers (make sure you have the correct IP addresses and port numbers for each simulator), you can start the DSG system. Following the sample configuration discussed in Configure DSG, where a star topology is used, below are steps to start the DSG system:

1. Start the persistence actor, as this is the actor that persists the scene while the DSG system is running and stores the scene and reloads it when the system is shutdown and restarted.

   a. On the server that the persistence actor is mapped to, start the simulator by running OpenSim (that is, go to the binary directory that contains OpenSim.exe and run it, usually it’s under opensim-root-dir/OpenSim/bin/). It shall then load all the region modules configured to run and start the DSG sync listener for accepting connections from other simulators. <TO add: sign of life – the messages on the console>

   b. If it is the very first time that the DSG system is up and running, load the scene to this simulator. Usually, such a scene is created beforehand and stored in an oar file. See OpenSim on how to load an oar file.

2. Next, start the other simulators on the servers they are mapped to. There is no specific order to start these simulators. When each of these simulators starts, it is initialized as follows:

   a. It loads all the region modules that are configured to run in the simulator.

   b. It opens a DSG connection (a tcp connection) with the hub simulator, the one started in step 1 above, and starts the DSG synchronization service. The DSG synchronization service will then download a copy of the scene to the local simulator. That is, for all the terrain data, objects, and avatars if any, copies of them will be downloaded from the hub simulator to the local simulator to create the replicated scene. <TO add: sign of life – the messages on the console>

3. When all the simulators are started, the DSG system is ready. Users can login to any of the client managers to start exploring the virtual world.