OpenSim 0.6.9 Grid Mode Configuration

= Legacy instructions for configuring the grid services in OpenSimulator 0.6.9 =

...

Some services are now run in a common 'ROBUST' (Basic Universal Server Technology) server shell while others are still run as separate legacy servers.

As of OpenSimulator 0.6.8, R.O.B.U.S.T. has connectors for the asset (A), grid (G) and inventory (I) functionality. The legacy servers are still required for user (U) and messaging (M) functionality. The steps below will get you up and running. We'll assume that your current directory is bin/ within the OpenSimulator distribution.

 Configure the user server  Start OpenSim.Grid.UserServer.exe You will be asked a number of configuration questions. If the grid servers are all on one machine, most defaults are safe to use. The configuration is stored in the UserServer_Config.xml file which can be changed afterwards if necessary. The user server will then load and display its prompt: User# 

Configure R.O.B.U.S.T.  Copy OpenSim.Server.ini.example to OpenSim.Server.ini. Don't forget to change ConnectionString for your database settings. (on version 0.6.6 copy OpenSim.Services.ini.example to OpenSim.Services.ini - then use OpenSim.Services instead OpenSim.Server)  Linux bin$ cp OpenSim.Server.ini.example OpenSim.Server.ini Windows C:\OpenSim\bin> copy OpenSim.Server.ini.example OpenSim.Server.ini Start OpenSim.Server.exe</li> The server will start up it's asset, inventory and grid components and display the R.O.B.U.S.T prompt:</li> R.O.B.U.S.T.# For more information on the R.O.B.U.S.T. configuration file and more information if you are migrating from an earlier release of OpenSim, refer to R.O.B.U.S.T.</li> </ul>

Configure the messaging server</li>  Start OpenSim.Grid.MessagingServer.exe</li> Answer the configuration questions. Again, if all servers are run on the same machine, it's safe to press enter for all questions. The configuration is stored in MessagingServer_Config.xml.</li> The server will start and present you with its prompt:</li> Messaging# </ul>

</ol>

For information on running the legacy servers, particularly if you're using an older version of before 0.6.7 that doesn't contain the ROBUST framework, see LegacyServers

Summary of commands for running grid service executables
 Windows  cd bin OpenSim.Grid.UserServer.exe OpenSim.Server.exe OpenSim.Grid.MessagingServer.exe

 Linux / Mac OS X  cd bin mono OpenSim.Grid.UserServer.exe mono OpenSim.Server.exe mono OpenSim.Grid.MessagingServer.exe

Configuring regions
When first run, a new OpenSimulator installation will ask you a series of questions to set up one region. If you want to change these settings or set up multiple regions, please see Configuring Regions

Configuring and Starting the region simulator
<ol> Find the [Architecture] section, comment out the line that says</li> Include-Standalone   = "config-include/Standalone.ini" and uncomment the line saying Include-Grid        = "config-include/Grid.ini

save OpenSim.ini, and go into the config-include directory.</li> copy the following files</li> GridCommon.ini.example to GridCommon.ini CenomeCache.ini.example to CenomeCache.ini FlotsamCache.ini.example to FlotsamCache.ini

Open all these files (Grid.ini, GridCommon.ini, CenomeCache.ini and FlotsamCache.ini) and edit to suit your needs</li>

You should now be ready to start up your sim. The mode that OpenSim.exe starts in is normally controlled by a setting in your OpenSim.ini. It defaults to standalone mode if that setting is not specified or the file is not found. If you wish, you can force opensim to start in gridmode on the command line as follows:</li> OpenSim.exe -gridmode=true or if using the ODE physics plugin under 64 bit Windows OpenSim.32BitLaunch.exe or: mono OpenSim.exe -gridmode=true if you're using Mono under Linux or Mac OSX.

With any luck, everything will come up without fatal errors.

Go to the UserServer console, and type 'create user' to create a new avatar. It will prompt you for the name and password, and the X and Y of the sim that should be his home location. Use 1000 and 1000, or wherever you told your sim to live when you brought it up in standalone mode. At the console of any of these servers, you should be able to type 'help' to get a list of commands.</li>

You should now be able to connect to your new grid with your secondlife client. You need to tell your client to point at the UserServer rather than directly at the sim, though:</li> secondlife -loginuri http://127.0.0.1:8002/ 8002 is the default port for the UserServer, and that IP address should be changed to the server you are running the UserServer on, if they are not all on the same box. Happy OpenSimming!

''Note: if you are using Windows Vista, remember to start servers as Admin. If not it will prompt you an error in console like "Error - Access denied"'' </ol>