OpenSim 0.9.0 on FreeBSD 11.1

From The Datapanic Wiki
Revision as of 15:16, 1 June 2018 by Datapanic (talk | contribs)
Jump to navigation Jump to search

OpenSim 0.9.0 on FreeBSD 11.1

Documentation for running OpenSim on FreeBSD has been very outdated with the most recent information referring to FreeBSD version 6.2 and outdated instructions for trying to make it work. After a little trial and error, I've come up with the following to get OpenSim 0.9.0.0 (release) and FreeBSD 11.1-RELEASE to run in Standalone as well as Grid mode with all the latest ports and/or packages required off the FreeBSD Ports Tree or Package Repository to make it work.

In the past, I ran into issues with lang/mono and core dumps, memory leaks and so on, but now it seems that there have been some improvements with mono and also with the OpenSim developers to deliver a reliable platform that even works reliably on FreeBSD.

To get started, setup a FreeBSD system running version 11.1 amd64. I use vmWare to create a virtual machine for this configured with 1536MB Ram, 2 CPU cores and 32GB of disk space. Use GPT for the partitions and accept the default sizes for boot, swap and root. I also use a separate server running MySQL Database server (percona56-server). Instructions for Standalone and Grid/Robust are included.

After the initial base install of FreeBSD 11.1, run the updates:

     [root@opensim01 ~]# freebsd-update fetch
     [root@opensim01 ~]# freebsd-update install
     

Reboot after the updates have been installed.

Install the following packages using pkg install <package name>:

     pkg install git
     pkg install wget
     pkg install mysql56-client
     pkg install screen
     pkg install mono
     pkg install libgdiplus
     pkg install openjpeg
     pkg install cmake
     pkg install automake
     pkg install libtool
     pkg install gmake
     pkg install gcc
     

If you are running a Grid, also install the following on the Robust server:

     pkg install apache24
     pkg install php56
     pkg install mod_php56
     pkg install php56-xmlrpc
     pkg install php56-curl
     pkg install php56-mysqli
     

Copy php.ini-production to php.ini:

     cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini
     

Login to the MySQL Server and create the databases:

     create database opensim01;
     grant all on opensim01.* to opensim01@'opensim01.yourdomain.com' identified by 'Passw0rd';
     create database robust01;
     grant all on robust01.* to robust01@'robust01.yourdomain.com' identified by 'Passw0rd';
     

Download the opensim-0.9.0.0 binaries and source:

     wget http://opensimulator.org/dist/opensim-0.9.0.0.tar.gz
     wget http://opensimulator.org/dist/opensim-0.9.0.0-source.tar.gz
     

Extract the opensim-0.9.0.0.tar.gz and opensim-0.9.0.0-source.tar.gz files to / then create a link for opensim:

     cp opensim-0.9.0.0.tar.gz /
     cp opensim-0.9.0.0-source.tar.gz /
     cd /
     gunzip opensim-0.9.0.0.tar.gz
     gunzip opensim-0.9.0.0-source.tar.gz
     tar -xvf opensim-0.9.0.0.tar
     tar -xvf opensim-0.9.0.0-source.tar
     rm opensim-0.9.0.0.tar opensim-0.9.0.0-source.tar
     ln -s /opensim-0.9.0.0 /opensim
     

Next we need to get the various ini files installed. It is beyond the scope of this HowTo to explain how to configure OpenSim, please visit the OpenSim Website.

Standalone:

     cp /opensim/bin/OpenSim.ini.example /opensim/bin/OpenSim.ini
     cp /opensim/bin/config-include/StandaloneCommon.ini.example /opensim/bin/config-include/StandaloneCommon.ini
     

Grid OpenSim server:

     cp /opensim/bin/OpenSim.ini.example /opensim/bin/OpenSim.ini
     cp /opensim/bin/config-include/GridCommon.ini.example /opensim/bin/config-include/GridCommon.ini
     

Grid Robust server:

     cp /opensim/bin/Robust.ini.example /opensim/bin/Robust.ini
     

Edit OpenSim.ini and set physics to ubODE

Build libode-x86-64.so:

     cd /opensim-0.8.1.2-source
     cd /opensim-0.9.0.0-source
     git clone git://opensimulator.org/git/opensim-libs
     cd opensim-libs/trunk/unmanaged/OpenDynamicsEngine-r1755
     ./autogen.sh
     ./configure --enable-shared --enable-release --disable-demos --without-x --enable-old-trimesh
     gmake
     cp ./ode/src/.libs/libode.so /opensim-0.8.1.2/bin/lib64/libode-x86_64.so
     cp ./ode/src/.libs/libode.so /opensim/bin/lib64/libode-x86_64.so
     chmod 744 /opensim-0.8.1.2/bin/lib64/libode-x86_64.so
     chmod 744 /opensim/bin/lib64/libode-x86_64.so
     

Build libopenjpeg-dotnet-2-1.5.0-dotnet-1-x86_64.so:

     cd /opensim-0.8.1.2-source
     cd /opensim-0.9.0.0-source
     git clone git://github.com/openmetaversefoundation/libopenmetaverse.git libopenmetaverse
     cd libopenmetaverse/openjpeg-dotnet/
     gmake
     cp libopenjpeg-dotnet-2-1.5.0-dotnet-1.so /opensim-0.8.1.2/bin/libopenjpeg-dotnet-2-1.5.0-dotnet-1-x86_64.so
     cp libopenjpeg-dotnet-2-1.5.0-dotnet-1.so /opensim/bin/libopenjpeg-dotnet-2-1.5.0-dotnet-1-x86_64.so
     chmod 744 /opensim-0.8.1.2/bin/libopenjpeg-dotnet-2-1.5.0-dotnet-1-x86_64.so
     chmod 744 /opensim/bin/libopenjpeg-dotnet-2-1.5.0-dotnet-1-x86_64.so
     

Run Robust.exe and OpenSim.exe as needed to test:

     cd /opensim/bin
     mono Robust.exe
     
     cd /opensim/bin
     mono OpenSim.exe
     

Create /usr/local/sbin/opensim and /usr/local/sbin/robust startup scripts. These scripts will run in a screen session:

opensim:

     #!/bin/sh
     SCREEN=`screen -list|grep OpenSimulator|cut -f 2`
     if [ $SCREEN ]
     then
        screen -x $SCREEN
     else
        cd /opensim/bin
        if [ -f OpenSim.log ]
        then
           rm OpenSim.log
        fi
        screen -S OpenSimulator -d -m mono --desktop OpenSim.exe
        SCREEN=`screen -list|grep OpenSimulator|cut -f 2`
        screen -r $SCREEN
     fi
     

robust:

     #!/bin/sh
     SCREEN=`screen -list|grep Robust|cut -f 2`
     if [ $SCREEN ]
     then
        screen -x $SCREEN
     else
        cd /opensim/bin
        if [ -f Robust.log ]
        then
           rm Robust.log
        fi
        screen -S Robust -d -m mono Robust.exe
        SCREEN=`screen -list|grep Robust|cut -f 2`
        screen -r $SCREEN
     fi