scripts/opensim/opensim_utils.sh

   1 #!/bin/bash
   2 # this is a collection of scripts that assist in managing an opensim server.
   3 # it uses the "screen" utility to manage opensimulator instances.
   4
   5 source "$FEISTY_MEOW_SCRIPTS/core/functions.sh"
   6
   7 # set up some parameters that we believe (or have been told) are beneficial.
   8 export MONO_THREADS_PER_CPU=808
   9
  10 # we run the processes with a little cpu de-prioritization.  we do not want
  11 # them taking over completely if there's a runaway mono tornado.
  12 export NICENESS_LEVEL=6
  13
  14 # a tip that supposedly helps on linux so that there won't be bizarre
  15 # problems compiling scripts.
  16 export LANG=C
  17
  18 # this is used as a process startup snooze, to avoid running a dependent
  19 # process before the dependency has really started.
  20 export SNOOZE_TIME=6
  21
  22 # lock the limit in for threads, so we don't have any getting out of control.
  23 # also make sure we've provided enough space for each thread.
  24 ulimit -s 262144
  25
  26 # use more recent versions of mono for opensim if they're available.
  27 if [ -d /opt/mono-2.10/bin ]; then
  28   export PATH=/opt/mono-2.10/bin:$PATH
  29 elif [ -d /opt/mono-2.8/bin ]; then
  30   # use version 2.8 mono for opensim if it's available.
  31   export PATH=/opt/mono-2.8/bin:$PATH
  32 fi
  33
  34 function launch_screen()
  35 {
  36   screen_name="$1"; shift
  37   app_name="$1"; shift
  38   echo "$(date_stringer ' '): starting $screen_name now..."
  39   screen -L -S "$screen_name" -d -m nice -n $NICENESS_LEVEL mono "$app_name"
  40 ##why? --debug
  41 #-console=basic
  42   echo "$(date_stringer ' '): $screen_name started."
  43   # only sleep if we are not at the last process that gets started.
  44   if [ "$app_name" != "OpenSim.exe" ]; then
  45     sleep $SNOOZE_TIME
  46   fi
  47 }
  48
  49 # finds the opensim process specified or returns a blank string in the
  50 # OS_PROC_ID variable.
  51 export OS_PROC_ID=
  52 function find_opensim_process()
  53 {
  54   OS_PROC_ID=
  55   process_name="$1"; shift
  56   if [ -z "$process_name" ]; then
  57     return 1  # failure in call.
  58   fi
  59   OS_PROC_ID=$(ps wuax | grep "[0-9] mono $process_name" | grep -vi screen | sed -e "s/$USER  *\([0-9][0-9]*\).*/\1/" | head -n 1)
  60 }
  61
  62 # takes a screen name for the detached screen session and a process name that
  63 # we should be able to find running.  we make sure that both are shut down.
  64 function close_application()
  65 {
  66   screen_name="$1"; shift
  67   process_name="$1"; shift
  68   echo "$(date_stringer ' '): stopping $screen_name now..."
  69   screen -r -s "$screen_name" -X quit
  70
  71   # we don't want to shut any other servers down until this process is really gone.
  72   find_opensim_process $process_name
  73   if [ ! -z "$OS_PROC_ID" ]; then
  74     echo "$(date_stringer ' '): waiting for $screen_name to really shut down..."
  75     sleep $SNOOZE_TIME
  76     # check again after the snooze.
  77     find_opensim_process $process_name
  78     while [ ! -z "$OS_PROC_ID" ]; do
  79       find_opensim_process $process_name
  80 #break out on timed basis.
  81     done
  82     echo "$(date_stringer ' '): $screen_name really is shut down now."
  83
  84 #do this as last ditch, above in timeout
  85     find_opensim_process $process_name
  86     if [ ! -z "$OS_PROC_ID" ]; then
  87       echo "process for $screen_name still exists, killing $process_name (id $OS_PROC_ID) now."
  88       kill -9 $OS_PROC_ID
  89       sleep 2
  90     fi
  91
  92   fi
  93
  94   echo "$(date_stringer ' '): $screen_name stopped."
  95 }
  96