OpenSim 0.6.9 Grid Mode Configuration

From OpenSimulator

Revision as of 23:49, 3 March 2012 by MakoBot (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search


Legacy instructions for configuring the grid services in OpenSimulator 0.6.9


NOTE: As of July 2009, the grid servers are in the process of being redesigned. Some services are now run in a common 'ROBUST' (Basic Universal Server Technology) server shell while others are still run as separate legacy servers.

More Details on ROBUST are Here -->ROBUST <--  including Conversion From UGAIM To UGRM (0.6.6 -> 0.6.7) and UGRM to URM (0.6.7 -> 0.6.8)


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.

  1. 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#
  2. 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


      C:\OpenSim\bin> copy OpenSim.Server.ini.example OpenSim.Server.ini
    • Start OpenSim.Server.exe
    • The server will start up it's asset, inventory and grid components and display the R.O.B.U.S.T prompt:
    • 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.
  3. Configure the messaging server
    • Start OpenSim.Grid.MessagingServer.exe
    • 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.
    • The server will start and present you with its prompt:
    • Messaging#

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


cd bin

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

  1. Find the [Architecture] section, comment out the line that says
  2. Include-Standalone    = "config-include/Standalone.ini"

    and uncomment the line saying

    Include-Grid         = "config-include/Grid.ini
  3. save OpenSim.ini, and go into the config-include directory.
  4. copy the following files
  5. GridCommon.ini.example to GridCommon.ini
    CenomeCache.ini.example to CenomeCache.ini
    FlotsamCache.ini.example to FlotsamCache.ini
  6. Open all these files (Grid.ini, GridCommon.ini, CenomeCache.ini and FlotsamCache.ini) and edit to suit your needs
  7. 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:
  8. OpenSim.exe -gridmode=true

    or if using the ODE physics plugin under 64 bit Windows



    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.

  9. 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.
  10. 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:
  11. secondlife -loginuri

    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"

Personal tools
About This Wiki