Revision as of 15:18, 10 June 2011

 

Home

 

Download

 

News

 

Support

 

Admin

 

Dev

 

Screen Shots

 

Grid List

 

Bugs

Languages:

English    日本語

Legacy instructions for configuring the grid services in OpenSim 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 OpenSim 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 OpenSim 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

Windows

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

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 OpenSim 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

Include-Standalone    = "config-include/Standalone.ini"

and uncomment the line saying

Include-Grid         = "config-include/Grid.ini

2. save OpenSim.ini, and go into the config-include directory.
3. copy the following files

GridCommon.ini.example to GridCommon.ini
CenomeCache.ini.example to CenomeCache.ini
FlotsamCache.ini.example to FlotsamCache.ini

4. Open all these files (Grid.ini, GridCommon.ini, CenomeCache.ini and FlotsamCache.ini) and edit to suit your needs
5. 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:

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.

6. 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.
7. 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:

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"