In this document we will describe the necessary steps to add OMEconomy Services,
i.e. OMCurrency or OMFacebook, to your grid.

In order to start we have to meet the following software requirements:
  * OpenSimulator Version 0.6.9, 0.7.0, or 0.7.1
  * NAnt Version > 0.85
      This is needed to compile the sources.

To compile the sources, extract the OMEconomy files from the zip archive. 
For the remainder of this document the directory that contains the file 
"default.build" is referred to as OMEconomyRoot/.
  * Pre-built OpenSimulator
      If you use a pre-compiled OpenSimulator with version 0.6.9, 0.7.0, 
      or 0.7.1 from [1] you can compile the sources with a parameter 
      "openSimlatorVersion" with value {SIX_NINE, SEVEN_ZERO, SEVEN_ONE}.
      For simulator version 0.7.0 this would yield in
        user@OSServer:~/OMEconomyRoot$ nant -D:openSimulatorVersion=SEVEN_ZERO

  * Custom OpensSimulator
      If you have compiles your OpenSimulator from the sources, you need to 
      specify the root directory of your simulator, further referred to as 
      OpenSimulatorRoot/ with the parameter "libDir".  
      For a self-compiled simulator version 0.7.1 this yields in  
       user@OSServer:~/OMEconomyRoot$ nant -D:openSimulatorVersion=SEVEN_ONE 
          -D:libDir=/home/msteurer/opensim-0.7.1-bin/bin/
      Note: Please use the absolute path instead of relativ paths to specify the 
            location of the libaries.

The above commands create a new directory bin/ in OMCurrencyRoot/ that contains 
the generated dll files to be put into OpenSimulatorRoot/.

Modify your OpenSim.ini configuration file and add the following lines:

[OpenMetaverseEconomy]
  OMEconomyInitialize =   "https://www.virwox.com:419/OSMoneyGateway/init.php"
  OMBaseEnvironment =     "TEST"
  OMCurrencyEnvironment = "TEST"

For identification purposes we employ the parameter "GridServerURI" from the 
file "OpenSimulatorRoot/config-include/GridCommon.ini". Ensure that the parameter 
is unique but common for all Simulators (all participating OpenSimulators should 
have the same configuration) in your Grid. Do not use "localhost:8001" or
"127.0.0.1:8001" for this parameter but your real IP address or URL, 
for example http://osgrid.org:8001

Restart your OpenSimulator and check for success in the logfile OpenSim.log. To 
verify that your region is OMC-enabled please check your logs (OpenSim.log) and 
search for the entries
  [OMCURRENCY]: GatewayURL: http://129.27.200.58/...
  [OMBASE]:     GatewayURL: http://129.27.200.58/...

If the currency service is NOT available or you did not find *any* [OMBASE], 
[OMCURRENCY] entries or your simulator does not even start please read this 
tutorial again and follow the steps carefully. 

To get the registration terminal please visit [2] and provide the requested data
    gridID       - use the value of parameter GridServerURI from the file
                   "OpenSimulatorRoot/config-include/GridCommon.ini"
    gridName     - enter a name that describes your grid, for example Open 
                   Simulator Grid or Third Life Grid.
    gridNickname - enter a name limited to eight characters that identifies 
                   your grid, for example OSGrid or TLG. 

According to these parameters we will identify the avatars of your grid 
"avatarFirstname.avatarLastname@Grid-Nickname (Grid-Name)", for example 
"sophie.sunshine@OSGrid (Open Simulator Grid)". As this names and identifiers are 
visible on VirWoX's webpage and in-world, we encourage you to carefully choose 
these parameters. ;-) 

If you have provided all parameters correctly you will be provided with an LSL 
script. Copy this script and paste it in-world as a script into a simple 
box-primitive. After the script has successfully started the box should change 
its shape to a green V. 

After reading this tutorial your simulator is ready for the OMC test system and 
you can continue with registering avatars. Find the instructions to do so here [3].


[1] http://dist.opensimulator.org/
[2] http://129.27.200.58/Terminal/
[3] http://129.27.200.58/HowTo/