Linux Gridserver

Revision as of 16:01, 27 May 2008

This tutorial is meant to setup a production environment on your Linux-server.

Recommended Software and Versions

• Archlinux - Fast and lightweight linux-distro
• Mono 1.9.1 - .NET framework
• OpenSSH - Remote terminal connection
• Nant - Building tool
• Ratbox Ircd - IRC chat
• Asterisk - Voice
• SVN - Backup
• Screen - Multiple terminal-sessions

Setup a Grid

Step 1: Create a suitable production direction structure

cd /opt
mkdir opensim opensim/production opensim/builds opensim/scripts opensim/library/ opensim/source opensim/backup

Step 2: Get the software

We are going to install the latest and greatest opensim svn-server from the svn-trunk.

cd /opt/opensim/builds
svn info http://opensimulator.org/svn/opensim/trunk

Now get the revision-number(4523 at the moment), and make a directory for it...

mkdir 4523
cd 4523
svn co http://opensimulator.org/svn/opensim/trunk .

Step 3: Setup a first run

• We first build the binaries now

sh ./runprebuild.sh
nant

• I hope for you that the build will be succesful. If not, check out your mono-version and check out if all dependencies are available. Now we copy the build to the production directory

cd bin
cp -R * /opt/opensim/production

• Prepare the configuration-files

cd /opt/opensim/production
cp OpenSim.ini.example OpenSim.ini
cp mysql_connection.ini.example mysql_connection.ini

• Setup mysql-storage in OpenSim.ini and mysql_connection.ini (don't setup Grid-mode yet)
• Run /opt/opensim/scripts/iptables.sh, to fix the router-loopback issue
• Edit /etc/hosts.allow, and make sure it allows the service you are running (OpenSim thinks localhost is your LAN-IP, not the loopback-device). The 192.68.1. part is your local-ip range. We are setting up local allowance for the mysql-daemon, and global allowance of the SSH-daemon:

mysqld: 192.168.1. 127.0.0.1 localhost
sshd: ALL

• Now run OpenSimulator

cd /opt/opensim/production
mono OpenSim.exe

• If the settings are correct, OpenSim will ask you to setup initial settings. Enter your administrator avatar info, the LAN-IP for internal IP, and the WAN-IP for external ip. After everything is entered, the region-server will run in standalone mode. We now setup Grid mode.

Step 4: Setup a Grid server

In our configuration, we will have the mysql-server, the UGAI-services and one Region-Service on our box. It's easy to extend it later with more Region-Services and/or other boxes.

• Copy the ugair script to /opt/opensim/scripts
• Run the script

cd /opt/opensim/scripts
sh ugair.sh

• Start the UGAIR-services
• Switch to each Screen session, and go through the initial service setup of each service
• Make sure you have the Region Server running in grid-mode (check OpenSim.ini)

Step 4:Adding custom textures

Check out Inworld Data

See also Ogltree_Install_Instructions