OpenSim 0.6.9 Grid Mode Configuration

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
m
m (Robot: Cosmetic changes)
Line 12: Line 12:
 
|}
 
|}
  
<br>
+
<br />
 
...
 
...
  
Line 18: Line 18:
 
while others are still run as separate legacy servers.
 
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.
+
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.
  
 
<ol>
 
<ol>
Line 24: Line 24:
 
<ul>
 
<ul>
 
<li>Start OpenSim.Grid.UserServer.exe</li>
 
<li>Start OpenSim.Grid.UserServer.exe</li>
<li>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.</li>
+
<li>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.</li>
 
<li>The user server will then load and display its prompt:</li>
 
<li>The user server will then load and display its prompt:</li>
 
  User#
 
  User#
Line 31: Line 31:
 
<li>'''Configure R.O.B.U.S.T.'''</li>
 
<li>'''Configure R.O.B.U.S.T.'''</li>
 
<ul>
 
<ul>
<li>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)
+
<li>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)
 
</li>
 
</li>
 
Linux
 
Linux
Line 46: Line 46:
 
<ul>
 
<ul>
 
<li>Start OpenSim.Grid.MessagingServer.exe</li>
 
<li>Start OpenSim.Grid.MessagingServer.exe</li>
<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>
+
<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>
 
<li>The server will start and present you with its prompt:</li>
 
<li>The server will start and present you with its prompt:</li>
 
  Messaging#
 
  Messaging#
Line 69: Line 69:
 
  mono OpenSim.Grid.MessagingServer.exe
 
  mono OpenSim.Grid.MessagingServer.exe
  
==Configuring regions==
+
== 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]]
+
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==
+
== Configuring and Starting the region simulator ==
 
<ol>
 
<ol>
 
<li>Find the [Architecture] section, comment out the line that says</li>
 
<li>Find the [Architecture] section, comment out the line that says</li>
Line 88: Line 88:
 
<li>Open all these files (Grid.ini, GridCommon.ini, CenomeCache.ini and FlotsamCache.ini) and edit to suit your needs</li>
 
<li>Open all these files (Grid.ini, GridCommon.ini, CenomeCache.ini and FlotsamCache.ini) and edit to suit your needs</li>
  
<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>
+
<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
 
  OpenSim.exe -gridmode=true
 
or if using the ODE physics plugin under 64 bit Windows
 
or if using the ODE physics plugin under 64 bit Windows
Line 94: Line 94:
 
or:
 
or:
 
  mono OpenSim.exe -gridmode=true
 
  mono OpenSim.exe -gridmode=true
if you're using Mono under Linux or Mac OSX.
+
if you're using Mono under Linux or Mac OSX.  
  
 
With any luck, everything will come up without fatal errors.
 
With any luck, everything will come up without fatal errors.
Line 102: Line 102:
 
<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>
 
<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/
 
  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!<br>
+
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!<br />
 
''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"''
 
''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>
 
</ol>

Revision as of 19:44, 3 March 2012

Contents

Legacy instructions for configuring the grid services in OpenSim 0.6.9

Exclamation.png

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

    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.

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

Personal tools
General
About This Wiki