OpenSim 0.9.0 on FreeBSD 11.1: Difference between revisions

From The Datapanic Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 12: Line 12:
|
|
  <nowiki>
  <nowiki>
  [root@opensim01 ~]# freebsd-update fetch
  [root@opensim01 ~]# freebsd-update fetch
  [root@opensim01 ~]# freebsd-update install
  [root@opensim01 ~]# freebsd-update install
  </nowiki>
  </nowiki>
|}
|}
Reboot after the updates have been installed.
Reboot after the updates have been installed.


Install the following packages using pkg install <package name>:
Install the following packages using pkg install <package name>:
{|
{| class="wikitable"
|-
|-
|
|
  <nowiki>
  <nowiki>
  pkg install git
  pkg install git
  pkg install wget
  pkg install wget
  pkg install mysql56-client
  pkg install mysql56-client
  pkg install screen
  pkg install screen
  pkg install mono
  pkg install mono
  pkg install libgdiplus
  pkg install libgdiplus
  pkg install openjpeg
  pkg install openjpeg
  pkg install cmake
  pkg install cmake
  pkg install automake
  pkg install automake
  pkg install libtool
  pkg install libtool
  pkg install gmake
  pkg install gmake
  pkg install gcc
  pkg install gcc
  </nowiki>
  </nowiki>
|}
|}


If you are running a Grid, also install the following on the Robust server:
If you are running a Grid, also install the following on the Robust server:
{|
{| class="wikitable"
|-
|-
|
|
  <nowiki>
  <nowiki>
  pkg install apache24
  pkg install apache24
  pkg install php56
  pkg install php56
  pkg install mod_php56
  pkg install mod_php56
  pkg install php56-xmlrpc
  pkg install php56-xmlrpc
  pkg install php56-curl
  pkg install php56-curl
  pkg install php56-mysqli
  pkg install php56-mysqli
  </nowiki>
  </nowiki>
|}
|}


Copy php.ini-production to php.ini:
Copy php.ini-production to php.ini:
{|
{| class="wikitable"
|-
|-
|
|
  <nowiki>
  <nowiki>
  cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini
  cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini
  </nowiki>
  </nowiki>
|}
|}


Login to the MySQL Server and create the databases:
Login to the MySQL Server and create the databases:
{|
{| class="wikitable"
|-
|-
|
|
  <nowiki>
  <nowiki>
  create database opensim01;
  create database opensim01;
  grant all on opensim01.* to opensim01@'opensim01.yourdomain.com' identified by 'Passw0rd';
  grant all on opensim01.* to opensim01@'opensim01.yourdomain.com' identified by 'Passw0rd';
  create database robust01;
  create database robust01;
  grant all on robust01.* to robust01@'robust01.yourdomain.com' identified by 'Passw0rd';
  grant all on robust01.* to robust01@'robust01.yourdomain.com' identified by 'Passw0rd';
  </nowiki>
  </nowiki>
|}
|}


Line 78: Line 78:
|
|
  <nowiki>
  <nowiki>
  wget http://opensimulator.org/dist/opensim-0.9.0.0.tar.gz
  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
  wget http://opensimulator.org/dist/opensim-0.9.0.0-source.tar.gz
  </nowiki>
  </nowiki>
|}
|}


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:
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:
{|
{| class="wikitable"
|-
|-
|
|
  <nowiki>
  <nowiki>
  cp opensim-0.9.0.0.tar.gz /
  cp opensim-0.9.0.0.tar.gz /
  cp opensim-0.9.0.0-source.tar.gz /
  cp opensim-0.9.0.0-source.tar.gz /
  cd /
  cd /
  gunzip opensim-0.9.0.0.tar.gz
  gunzip opensim-0.9.0.0.tar.gz
  gunzip opensim-0.9.0.0-source.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.tar
  tar -xvf opensim-0.9.0.0-source.tar
  tar -xvf opensim-0.9.0.0-source.tar
  rm opensim-0.9.0.0.tar 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
  ln -s /opensim-0.9.0.0 /opensim
  </nowiki>
  </nowiki>
|}
|}


Line 103: Line 103:


Standalone:
Standalone:
{|
{| class="wikitable"
|-
|-
|
|
  <nowiki>
  <nowiki>
  cp /opensim/bin/OpenSim.ini.example /opensim/bin/OpenSim.ini
  cp /opensim/bin/OpenSim.ini.example /opensim/bin/OpenSim.ini
  cp /opensim/bin/config-include/StandaloneCommon.ini.example /opensim/bin/config-include/StandaloneCommon.ini
  cp /opensim/bin/config-include/StandaloneCommon.ini.example /opensim/bin/config-include/StandaloneCommon.ini
  </nowiki>
  </nowiki>
|}
|}


Grid OpenSim server:
Grid OpenSim server:
{|
{| class="wikitable"
|-
|-
|
|
  <nowiki>
  <nowiki>
  cp /opensim/bin/OpenSim.ini.example /opensim/bin/OpenSim.ini
  cp /opensim/bin/OpenSim.ini.example /opensim/bin/OpenSim.ini
  cp /opensim/bin/config-include/GridCommon.ini.example /opensim/bin/config-include/GridCommon.ini
  cp /opensim/bin/config-include/GridCommon.ini.example /opensim/bin/config-include/GridCommon.ini
  </nowiki>
  </nowiki>
|}
|}


Grid Robust server:
Grid Robust server:
{|
{| class="wikitable"
|-
|-
|
|
  <nowiki>
  <nowiki>
  cp /opensim/bin/Robust.ini.example /opensim/bin/Robust.ini
  cp /opensim/bin/Robust.ini.example /opensim/bin/Robust.ini
  </nowiki>
  </nowiki>
|}
|}


Line 134: Line 134:


Build libode-x86-64.so:
Build libode-x86-64.so:
{|
{| class="wikitable"
|-
|-
|
|
  <nowiki>
  <nowiki>
  cd /opensim-0.8.1.2-source
  cd /opensim-0.8.1.2-source
  cd /opensim-0.9.0.0-source
  cd /opensim-0.9.0.0-source
  git clone git://opensimulator.org/git/opensim-libs
  git clone git://opensimulator.org/git/opensim-libs
  cd opensim-libs/trunk/unmanaged/OpenDynamicsEngine-r1755
  cd opensim-libs/trunk/unmanaged/OpenDynamicsEngine-r1755
  ./autogen.sh
  ./autogen.sh
  ./configure --enable-shared --enable-release --disable-demos --without-x --enable-old-trimesh
  ./configure --enable-shared --enable-release --disable-demos --without-x --enable-old-trimesh
  gmake
  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-0.8.1.2/bin/lib64/libode-x86_64.so
  cp ./ode/src/.libs/libode.so /opensim/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-0.8.1.2/bin/lib64/libode-x86_64.so
  chmod 744 /opensim/bin/lib64/libode-x86_64.so
  chmod 744 /opensim/bin/lib64/libode-x86_64.so
  </nowiki>
  </nowiki>
|}
|}


Build libopenjpeg-dotnet-2-1.5.0-dotnet-1-x86_64.so:
Build libopenjpeg-dotnet-2-1.5.0-dotnet-1-x86_64.so:
{|
{| class="wikitable"
|-
|-
|
|
  <nowiki>
  <nowiki>
  cd /opensim-0.8.1.2-source
  cd /opensim-0.8.1.2-source
  cd /opensim-0.9.0.0-source
  cd /opensim-0.9.0.0-source
  git clone git://github.com/openmetaversefoundation/libopenmetaverse.git libopenmetaverse
  git clone git://github.com/openmetaversefoundation/libopenmetaverse.git libopenmetaverse
  cd libopenmetaverse/openjpeg-dotnet/
  cd libopenmetaverse/openjpeg-dotnet/
  gmake
  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-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
  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-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
  chmod 744 /opensim/bin/libopenjpeg-dotnet-2-1.5.0-dotnet-1-x86_64.so
  </nowiki>
  </nowiki>
|}
|}


Run Robust.exe and OpenSim.exe as needed to test:
Run Robust.exe and OpenSim.exe as needed to test:
{|
{| class="wikitable"
|-
|-
|
|
  <nowiki>
  <nowiki>
  cd /opensim/bin
  cd /opensim/bin
  mono Robust.exe
  mono Robust.exe
 
 
  cd /opensim/bin
  cd /opensim/bin
  mono OpenSim.exe
  mono OpenSim.exe
  </nowiki>
  </nowiki>
|}
|}


Line 185: Line 185:


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


robust:
robust:
{|
{| class="wikitable"
|-
|-
|
|
  <nowiki>
  <nowiki>
  #!/bin/sh
  #!/bin/sh
  SCREEN=`screen -list|grep Robust|cut -f 2`
  SCREEN=`screen -list|grep Robust|cut -f 2`
  if [ $SCREEN ]
  if [ $SCREEN ]
  then
  then
    screen -x $SCREEN
      screen -x $SCREEN
  else
  else
    cd /opensim/bin
      cd /opensim/bin
    if [ -f Robust.log ]
      if [ -f Robust.log ]
    then
      then
        rm Robust.log
        rm Robust.log
    fi
      fi
    screen -S Robust -d -m mono Robust.exe
      screen -S Robust -d -m mono Robust.exe
    SCREEN=`screen -list|grep Robust|cut -f 2`
      SCREEN=`screen -list|grep Robust|cut -f 2`
    screen -r $SCREEN
      screen -r $SCREEN
  fi
  fi
  </nowiki>
  </nowiki>
|}
|}

Revision as of 14:53, 1 June 2018

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