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 1: Line 1:
'''OpenSim 0.9.0 on FreeBSD 11.1'''
'''OpenSim 0.9.0 on FreeBSD 11.1'''
Note: This page is under construction!


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.   
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.   
Line 14: 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.
Line 25: Line 23:
|
|
  <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>
|}
|}


Line 45: Line 43:
|
|
  <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>
|}
|}


Line 59: Line 57:
|
|
  <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>
|}
|}


Line 68: Line 66:
|
|
  <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 80: 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>
|}
|}


Line 90: Line 88:
|
|
  <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 109: Line 107:
|
|
  <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>
|}
|}


Line 119: Line 117:
|
|
  <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>
|}
|}


Line 129: Line 127:
|
|
  <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 140: Line 138:
|
|
  <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>
|}
|}


Line 159: Line 157:
|
|
  <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>
|}
|}


Line 176: Line 174:
|
|
  <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 191: Line 189:
|
|
  <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>
|}
|}


Line 214: Line 212:
|
|
  <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:36, 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