Home

Welcome to the mobdat wiki!

Quick Start

Mobdat comes with example configuration files that are ready to be executed. To run the demo, follow the next steps.

Install libraries

We are assuming Ubuntu, but other Linux-based OS will behave similarly. Just one library for now, but leaving this step here for future requirements.

1. sudo apt-get install python-pymongo

Set up OpenSimulator

1. Download OpenSimulator source, mobdat, and scisim-addons, and unpack them.
2. Copy the content of scisim-addons to the folder addon-modules in the OpenSimulator source folder.
3. Compile OpenSimulator by running ./prebuild.sh (or .bat if Windows), and xbuild (or compile.bat, in Windows)
4. In OpenSim source folder, move to the bin directory, and copy OpenSim.ini.example to OpenSim.ini.
5. Place three files in bin/config
   5.1 Dispatcher.ini, located in scisim-addons/dispatcher/Dispatcher/Dispatcher.ini.example
   5.2 JsonStore.ini, located after these instructions
   5.3 XEngineOverride.ini, located after these instructions
6. Create a file in the folder bin/Regions called Region.ini. The content of Region.ini is written after these instructions.
7. Default database is SQLite. If you experience crashes with OpenSim and SQLite, configure another DB in bin/config-include/StandAloneCommon.ini
8. Copy mobdat/networks/fullnet/assets.iar and mobdat/networks/fullnet/fullnet.oar to the bin folder
9. In bin, run mono OpenSim.exe
10. In the OpenSim console, type "create user <first_name> <last_name>", replace first and last name with whatever name you wish. Follow instructions to complete user creation
11. Type in opensim console: load oar fullnet.oar
12. Type in opensim console: load iar -m <first_name> <last_name> Objects assets.iar
13. Download a viewer (Firestorm and Singularity are favorites) and login with the first/last name and password. Pay attention to the grid option when typing login information. You want to login to localhost. Most viewers have localhost grid option available, if not, you need to go to preferences and add the grid: 127.0.0.1:9000

XEngineOverride.ini

[XEngine]
AllowLightShareFunctions = True
AllowMODFunctions = True
AllowOSFunctions = True
AllowedCompilers = "lsl,cs"
AppDomainLoading = False
CompileWithDebugInformation = False
DisableUndergroundMovement = False
Enabled = True
MaxScriptEventQueue = 300
OSFunctionThreatLevel = "Severe"
ScriptDelayFactor = 0.0
ScriptDistanceLimitFactor = 50.0
ScriptStopStrategy = "co-op"
SensorMaxRange = 256.0
SensorMaxResults = 24

JsonStore.ini

[JsonStore]
EnableObjectStore = True
Enabled = True
MaxStringSpace = 0

Region.ini

[Fullnet]
RegionUUID = d68ae2a1-441b-433d-83ad-df60d7624562
Location = 1000,1000
InternalAddress = 0.0.0.0
InternalPort = 9000
AllowAlternatePorts = False
ExternalHostName = 127.0.0.1
NonphysicalPrimMax = 256
PhysicalPrimMax = 10
ClampPrimSize = False
MaxPrims = 150000
MaxAgents = 500
SizeX = 1536
SizeY = 1536

Configure mobdat

From the previous steps, OpenSimulator should now be running. To configure mobdat, follow the next steps:

1. Go to scisim-addons/script/python and run sudo python setup.py install. That install the RemoteControl tools for OpenSimulator on your python path.
2. The script simauth.py should have been installed in your path, and can invoked anywhere. Invoke simauth: simauth.py --av_name "<first_name> <last_name>" --endpoint http://127.0.0.1:9000/Dispatcher/, replacing first and last name from one chosen in the previous section.
3. Copy and paste the 3 export commands generated from last step to the terminal. Those variables are the capability keys that give access to the simulator.
4. CD into mobdat and run ./scripts/builder --config networks/fullnet/settings.js networks/fullnet/cardata.js
5. Still in mobdat, run netconvert networks/fullnet/fullnet.netccfg
6. Now run ./scripts/mobdat --config networks/fullnet/settings.js networks/fullnet/cardata.js
7. The initialization takes about 10 minutes. After its over, a mobdat console will appear. Type start to start execution.