OpenSim 0.9.0 on FreeBSD 11.1

From The Datapanic Wiki
Revision as of 15:24, 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