Startup script linux/de
From OpenSimulator
(Created page with "= SysVinit-Skripte für Linux = == Anweisungen == Getestet auf Debian 5. Ändert die Benutzer-ID auf den Benutzer „opensim“. Unterstützt: start, stop, restart, status. ...") |
|||
(6 intermediate revisions by one user not shown) | |||
Line 1: | Line 1: | ||
+ | {{Quicklinks|Startup_script_linux}} | ||
+ | |||
= SysVinit-Skripte für Linux = | = SysVinit-Skripte für Linux = | ||
Line 706: | Line 708: | ||
</source> | </source> | ||
− | ''' | + | '''Anmerkungen''' |
− | * | + | * Sollte auf CentOS 7.x, CentOS 8.x, RHEL 7.x, RHEL 8.x funktionieren. Möglicherweise funktioniert es auch auf anderen Redhat-basierten Distributionen. |
− | * | + | * Die Option "--server" legt die Standard-Garbage-Collection in Mono fest, was möglicherweise für den Produktionseinsatz etwas schneller ist. Die Verwendung von "--desktop" sollte ebenfalls funktionieren und stellt das Garbage-Collection-System so ein, dass das Heap-Wachstum so weit wie möglich vermieden wird, was jedoch die Garbage-Collection geringfügig verlangsamt. |
− | * | + | * Es gibt ein Standard-Timeout von maximal 60 Sekunden für das Herunterfahren. Passe dies bei Bedarf an, falls dies auf deinem Server nicht ausreicht. |
− | * | + | * In diesem Beispiel wird kein Screen verwendet, daher ist die OpenSim-Konsole nicht direkt verfügbar. |
'''Setup''' | '''Setup''' | ||
− | * | + | * Erstelle einen Benutzer „opensim“ (achte darauf, die Shell auf /sbin/nologin zu setzen). |
− | * | + | * Installiere OpenSim in /opt/opensim. |
− | * | + | * Speichere die obige Datei als /etc/systemd/system/opensim.service. |
− | ''' | + | |
+ | '''Verwendung''' | ||
* systemctl enable opensim | * systemctl enable opensim | ||
* systemctl disable opensim | * systemctl disable opensim | ||
Line 725: | Line 728: | ||
* journalctl -u opensim | * journalctl -u opensim | ||
+ | = Andere OpenSimulator-Skripte für Linux = | ||
− | + | * [[Tmux]] – Verwendung von tmux, einem Terminal-Multiplexer, um OpenSimulator auf einem Server auszuführen und gleichzeitig Zugriff auf das Terminal zu behalten. | |
+ | * [[Ogltree_Install_Instructions|Ogltree-Installationsanleitung]] – Adam Frisbys Linux-Skripte für Ogltree. | ||
+ | * [https://github.com/ManfredAabye/opensimMULTITOOLS opensimMULTITOOL] - Manfred Aabeys 25000 Zeilen Bash Skript, mit ca´ 644 Funktionen, für Ubuntu 18.04-24.04 64Bit, DOTNET, mySQL, MariaDB, mit Screen Funktionen ähnlich Tmux. | ||
− | + | [[Category:German Translations]] | |
− | + |
Latest revision as of 02:27, 25 October 2024
Languages: |
English Deutsch |
Contents |
[edit] SysVinit-Skripte für Linux
[edit] Anweisungen
Getestet auf Debian 5. Ändert die Benutzer-ID auf den Benutzer „opensim“. Unterstützt: start, stop, restart, status.
Zum Implementieren: Tippe: `cat > /etc/init.d/opensim` Füge das Skript von dieser Seite ein Drücke: `CTRL+D` Tippe: `chmod +x /etc/init.d/opensim` Das Skript sollte nun auf dem Server vorhanden und ausführbar sein.
Ändere den Header im Skript, um ihn an deinen Installationsordner und Benutzer anzupassen.
[edit] Aktualisiertes Skript
Im Gegensatz zu Tedds Originalskript unten verlässt sich dieses Skript auf die eigene PID-Funktion von OpenSimulator, daher musst du die PIDFile-Einträge im Abschnitt [Startup] von OpenSim.ini/Robust.ini auskommentieren und auf `/tmp/OpenSim.exe.pid` und `/tmp/Robust.exe.pid` setzen, je nach Bedarf.
Dies ermöglicht es uns, das Skript zu vereinfachen und eine bessere Fehlerberichterstattung zu erhalten. Ein sauberes Herunterfahren von OpenSimulator wurde ebenfalls implementiert.
Die Verzögerung zwischen dem Versuch, OpenSimulator sauber herunterzufahren und einem erzwungenen Herunterfahren wurde auf 20 Sekunden verdoppelt. In einigen Fällen könnte dies jedoch immer noch nicht ausreichen. In Zukunft wäre es besser, den Status abzufragen.
Dieses Skript wird unter https://github.com/justincc/opensimulator-tools/blob/master/infrastructure/control/init.d/src/opensim gepflegt. Pull Requests sind willkommen!
#! /bin/sh ### BEGIN INIT INFO # Provides: OpenSimulator # Required-Start: $local_fs $network # Required-Stop: $local_fs # Default-Start: 2 3 4 5 # Default-Stop: 0 1 6 # Short-Description: Tedds OpenSimulator init.d-script, with further changes by Justin Clark-Casey (http://justincc.org) ### END INIT INFO # Version 0.2.1 # Put script in /etc/init.d/ # Then execute /etc/init.d/opensim <start>|<stop>|<restart>|<status> # # You must configure Robust and OpenSim to create Robust.exe.pid and OpenSim.exe.pid PID files # by configuring PIDFile in the [Startup] section of OpenSim.ini and Robust.ini set -e # Location of OpenSimulator binaries DIR=/opt/opensim/bin # The directory where OpenSimulator and Robust are placing their pid files. These must be of the form <service-name>.pid # e.g. OpenSim.exe.pid PIDDIR=/tmp/ # The user name which will execute the services USER=opensim SERVICES="Robust.exe OpenSim.exe" #SERVICES="Robust.exe" #SERVICES="OpenSim.exe" # # Kill values (in seconds) # # How long between each service being started DELAY_STARTUP=10 # How long between each service is sent shutdown command DELAY_KILL=20 # After shutdown has been sent to all we do another loop with "kill", then "kill -9". How long between "kill" and "kill -9". DELAY_FORCEKILL=10 # # Info on service handled by this script # Name of service NAME=opensim # Description of service DESC="OpenSimulator Server" # Binaries SCREEN=/usr/bin/screen MONO=/usr/bin/mono ########################### ##### START OF SCRIPT ##### ########################### export PATH="${PATH:+$PATH:}/usr/sbin:/sbin" # Load LSB log functions _lsbFile="" if [ -e /etc/debian_version ]; then _lsbFile="/lib/lsb/init-functions" if [ -f $_lsbFile ]; then . $_lsbFile else echo "This script requires LSB init-functions file which does not exist: $_lsbFile" exit 1 fi else # [ -e /etc/init.d/functions ] ; then _lsbFile="/etc/init.d/functions" if [ -e $_lsbFile ]; then . $_lsbFile else echo "This script requires LSB init-functions file which does not exist: $_lsbFile" exit 1 fi fi # Lets use fancy output log_use_fancy_output # Check that target directory exists if test ! -d "$DIR"; then log_failure_msg "$NAME" "Target directory \"$DIR\" does not exist. Can not continue." exit 1 fi # Create a reverse order for shutdown SERVICES_REVERSE="" reverse() { SERVICES_REVERSE="$9 $8 $7 $6 $5 $4 $3 $2 $1"; } reverse $SERVICES # Check if a service is running isrunning() { ISRUNNING="0" # Do we have PID-file? if [ -f "$PIDDIR/$1.pid" ]; then # Check if proc is running pid=`cat "$PIDDIR/$1.pid" 2> /dev/null` if [ "$pid" != "" ]; then if [ -d /proc/$pid ]; then # Process is running ISRUNNING="1" fi fi fi #ISRUNNING="0" } # # Process commands # case "$1" in start) # Start all services one by one for server in $SERVICES; do log_daemon_msg "Starting $NAME" "$server" isrunning $server case "$ISRUNNING" in 1) log_daemon_msg "Process already started. Please stop first"; log_end_msg 1 ;; 0) # Process is not running # Start process and sleep... exefile="/tmp/exe.OpenSim.$server.sh" # Need to make external file, had big problems with screen params echo \#\!/bin/bash > $exefile echo cd $DIR >> $exefile echo $MONO --debug $server >> $exefile chmod +x $exefile cmd_screen="-S $server -d -m $exefile" start-stop-daemon --start --pidfile $PIDDIR/$server.pid -u $USER --chdir $DIR --chuid $USER -x /usr/bin/screen -- $cmd_screen # Delay between services that are started sleep $DELAY_STARTUP rm $exefile 2> /dev/null isrunning $server case "$ISRUNNING" in 1) # Process started ok #log_daemon_msg "Success"; log_end_msg 0 ;; 0) #log_daemon_msg "Failure"; log_end_msg 1 ;; esac ;; esac done ;; stop) _killCount=0 for server in $SERVICES_REVERSE; do log_daemon_msg "Stopping $NAME" "$server" isrunning $server case "$ISRUNNING" in 1) _killCount=`expr $_killCount + 1` log_daemon_msg "Sending shutdown command:"; cmd_screen="$SCREEN -S $server -p 0 -X stuff quit$(printf \\r)" # We can't use start-stop-daemon here currently because it will only send a signal to OpenSim # --stop doesn't execute a command # start-stop-daemon --stop --pidfile $PIDDIR/$server.pid -u $USER --chuid $USER -- $cmd_screen su $USER -c "$cmd_screen" # Wait for it to shut down... sleep $DELAY_KILL isrunning $server case "$ISRUNNING" in 1) log_daemon_msg "$server is still running."; log_end_msg 0 ;; 0) log_daemon_msg "$server has been shutdown"; log_end_msg 0 ;; esac ;; 0) log_daemon_msg "$server is not running"; log_end_msg 0 ;; esac done # Check if any procs are still running for server in $SERVICES; do isrunning $server case "$ISRUNNING" in 1) log_warning_msg "Stopping $NAME" "$server is still running: Forcing kill" echo `kill $pid 2> /dev/null`; sleep $DELAY_FORCEKILL echo `kill -9 $pid 2> /dev/null`; sleep 1 # Now check again if it is still running... isrunning $server case "$ISRUNNING" in 0) log_daemon_msg "Success"; log_end_msg 0 ;; 1) log_daemon_msg "Process is still running... Even after \"kill -9 $pid\". WOW..."; log_end_msg 0 ;; esac ;; 0) #log_daemon_msg ""; ;; esac done log_daemon_msg "$NAME: All done (stopped $_killCount processes)"; log_end_msg 0 ;; status) # Count how many processes we need PROCCOUNT=0 for i in $SERVICES; do PROCCOUNT=`expr $PROCCOUNT + 1` done # Go through server PID files and count how many are running log_daemon_msg "$NAME: Running processes:" _pidCount=0 for server in $SERVICES; do isrunning $server case "$ISRUNNING" in 1) # This server is running _pidCount=`expr $_pidCount + 1` log_daemon_msg "$server" ;; 0) ;; esac done log_daemon_msg " ($_pidCount of $PROCCOUNT processes are running)" # Check if running proc count matches requires proc count if [ $_pidCount -eq $PROCCOUNT ]; then log_daemon_msg "$NAME is running" exit 0 else log_daemon_msg "$NAME is NOT running" exit 1 fi ;; restart) $0 stop $0 start ;; *) echo "Usage: /etc/init.d/$NAME {start|stop|restart|status}" >&2 exit 1 ;; esac exit 0
[edit] Tedd's Original Script plus clean shutdown tweak
#! /bin/sh ### BEGIN INIT INFO # Provides: OpenSimulator # Required-Start: $local_fs $network # Required-Stop: $local_fs # Default-Start: 2 3 4 5 # Default-Stop: 0 1 6 # Short-Description: Tedds OpenSimulator init.d-script ### END INIT INFO # Put script in /etc/init.d/ # then execute: update-rc.d opensim defaults set -e # # Directories # # Location of OpenSimulator installation DIR=/home/opensim/OpenSim/bin/ # Different PID dir? PIDDIR=$DIR USER=opensim SERVICES="Robust.exe OpenSim.exe" # # Kill values (in seconds) # # How long between each service being started DELAY_STARTUP=10 # How long between each service is sent shutdown command DELAY_KILL=10 # After shutdown has been sent to all we do another loop with "kill", then "kill -9". How long between "kill" and "kill -9". DELAY_FORCEKILL=10 # # Info on service handled by this script # Name of service NAME=opensim # Description of service DESC="OpenSimulator Server" # Binaries SCREEN=/usr/bin/screen MONO=/usr/bin/mono ########################### ##### START OF SCRIPT ##### ########################### export PATH="${PATH:+$PATH:}/usr/sbin:/sbin" # Load LSB log functions _lsbFile="" if [ -e /etc/debian_version ]; then _lsbFile="/lib/lsb/init-functions" if [ -f $_lsbFile ]; then . $_lsbFile else echo "This script requires LSB init-functions file which does not exist: $_lsbFile" exit 1 fi else # [ -e /etc/init.d/functions ] ; then _lsbFile="/etc/init.d/functions" if [ -e $_lsbFile ]; then . $_lsbFile else echo "This script requires LSB init-functions file which does not exist: $_lsbFile" exit 1 fi fi # Lets use fancy output log_use_fancy_output # Check that target directory exists if test ! -d "$DIR"; then log_failure_msg "$NAME" "Target directory \"$DIR\" does not exist. Can not continue." exit 1 fi # Create a reverse order for shutdown SERVICES_REVERSE="" reverse() { SERVICES_REVERSE="$9 $8 $7 $6 $5 $4 $3 $2 $1"; } reverse $SERVICES # Check if a service is running isrunning() { ISRUNNING="0" # Do we have PID-file? if [ -f "$PIDDIR/$1.pid" ]; then # Check if proc is running pid=`cat "$PIDDIR/$1.pid" 2> /dev/null` if [ "$pid" != "" ]; then if [ -d /proc/$pid ]; then # Process is running ISRUNNING="1" fi fi fi #ISRUNNING="0" } # # Process commands # case "$1" in start) # Start all services one by one for server in $SERVICES; do log_daemon_msg "Starting $NAME" "$server" isrunning $server case "$ISRUNNING" in 1) log_progress_msg "Process already started. Please stop first"; log_end_msg 1 ;; 0) # Process is not running # Start process and sleep... exefile="/tmp/exe.OpenSim.$server.sh" # Need to make external file, had big problems with screen params echo \#\!/bin/bash > $exefile echo cd $DIR >> $exefile echo $MONO $server >> $exefile chmod +x $exefile cmd_screen="screen -S $server -d -m $exefile" start-stop-daemon --start -b -x /bin/su -m --pidfile=/tmp/su.$server.pid --chdir "$DIR" -- - $USER "-c $cmd_screen" # Delay between services that are started sleep $DELAY_STARTUP rm $exefile 2> /dev/null # Make PID-file ps afxu | grep "mono $server" | grep -iEv "grep|screen" | awk {'print $2'} > "$PIDDIR/$server.pid" isrunning $server case "$ISRUNNING" in 1) # Process started ok #log_progress_msg "Success"; log_end_msg 0 ;; 0) # Process did not start... remove pid-file rm "$PIDDIR/$server.pid" 2> /dev/null #log_progress_msg "Failure"; log_end_msg 1 ;; esac ;; esac done ;; stop) _killCount=0 for server in $SERVICES_REVERSE; do log_daemon_msg "Stopping $NAME" "$server" isrunning $server case "$ISRUNNING" in 1) _killCount=`expr $_killCount + 1` log_progress_msg "Sending shutdown command:"; cmd_screen="screen -S $server -p 0 -X stuff quit$(printf \\r)" su $USER -c "$cmd_screen" # Wait for it to shut down... sleep $DELAY_KILL isrunning $server case "$ISRUNNING" in 1) log_progress_msg "is still running."; log_end_msg 0 ;; 0) log_progress_msg "has been shutdown"; log_end_msg 0 ;; esac ;; 0) log_progress_msg "is not running"; log_end_msg 0 ;; esac done # Check if any procs are still running for server in $SERVICES; do isrunning $server case "$ISRUNNING" in 1) log_warning_msg "Stopping $NAME" "$server is still running: Forcing kill" echo `kill $pid 2> /dev/null`; sleep $DELAY_FORCEKILL echo `kill -9 $pid 2> /dev/null`; sleep 1 # Now check again if it is still running... isrunning $server case "$ISRUNNING" in 0) log_progress_msg "Success"; log_end_msg 0 ;; 1) log_progress_msg "Process is still running... Even after \"kill -9 $pid\". WOW..."; log_end_msg 0 ;; esac ;; 0) #log_progress_msg ""; ;; esac done log_begin_msg "$NAME: All done (killed $_killCount procs)"; log_end_msg 0 ;; status) # Count how many processes we need PROCCOUNT=0 for i in $SERVICES; do PROCCOUNT=`expr $PROCCOUNT + 1` done # Go through server PID files and count how many are running log_begin_msg "$NAME: Running processed:" _pidCount=0 for server in $SERVICES; do isrunning $server case "$ISRUNNING" in 1) # This server is running _pidCount=`expr $_pidCount + 1` log_progress_msg "$server" ;; 0) ;; esac done log_begin_msg " ($_pidCount of $PROCCOUNT processes are running)"; log_end_msg 0 # Check if running proc count matches requires proc count log_begin_msg "$NAME is" if [ $_pidCount -eq $PROCCOUNT ]; then log_progress_msg "running"; log_end_msg 0 exit 0 else log_progress_msg "NOT running"; log_end_msg 0 exit 1 fi ;; restart) $0 stop $0 start ;; *) echo "Usage: /etc/init.d/$NAME {start|stop|restart|status}" >&2 exit 1 ;; esac exit 0
[edit] CentOS/RHEL 6 and older script
#!/bin/bash # # OpenSim OpenSim # author neowdj # date 20131222 # version 0.1 # chkconfig: 2345 80 30 # description: OpenSim Server # processname: mono . /etc/rc.d/init.d/functions #BIN dir dir="/opt/opensim/bin/" # Robust or OpenSim prog="Robust" #Launch program with the user opensim user="opensim" CMD="su $user -c 'screen -dmS $prog mono --server $prog.exe'" RUNNING=`ps -e | grep mono | wc -l` SUBSYS="/var/lock/subsys/mono" PIDFILE="/var/run/OpenSim/$prog.pid" OPENSIM_TIMEOUT="100" start() { if [ "$RUNNING" -eq 1 ]; then echo -n $"Starting $prog: " RETVAL=$? echo else cd $dir echo -n $"Starting $prog: " daemon $CMD RETVAL=$? echo [ $RETVAL -eq 0 ] && touch $SUBSYS || \ RETVAL=1 return $RETVAL fi } stop() { echo -n $"Stopping $prog: " su $user -c "screen -S $prog -p 0 -X stuff quit$(printf \\r)" 2>&1 RETVAL=$? if [ $RETVAL -eq 0 ] ; then rm -f $SUBSYS timeout=0 while : ; do [ -f $PIDFILE ] || break if [ $timeout -ge $OPENSIM_TIMEOUT ]; then echo return 1 fi sleep 2 && echo -n "." timeout=$((timeout+2)) done echo_success echo else echo_failure echo fi return $RETVAL } statusos() { status -p $PIDFILE $prog exit 1 } case "$1" in start) start ;; stop) stop ;; restart) stop start ;; status) statusos ;; *) echo "Usage: $0 {start|stop|restart|status}" esac exit $?
[edit] Systemd Service Units for Linux
[edit] CentOS/RHEL 7 and 8 Systemd Service Unit
# Systemd Service Unit for OpenSimulator # Author: steevithak # [Unit] Description=OpenSimulator service After=network.target [Service] User=opensim Group=opensim Type=simple LimitSTACK=1048576 TimeoutStopSec=60 WorkingDirectory=/opt/opensim/bin ExecStart=/usr/bin/mono --server /opt/opensim/bin/OpenSim.exe [Install] WantedBy=multi-user.target
Anmerkungen
- Sollte auf CentOS 7.x, CentOS 8.x, RHEL 7.x, RHEL 8.x funktionieren. Möglicherweise funktioniert es auch auf anderen Redhat-basierten Distributionen.
- Die Option "--server" legt die Standard-Garbage-Collection in Mono fest, was möglicherweise für den Produktionseinsatz etwas schneller ist. Die Verwendung von "--desktop" sollte ebenfalls funktionieren und stellt das Garbage-Collection-System so ein, dass das Heap-Wachstum so weit wie möglich vermieden wird, was jedoch die Garbage-Collection geringfügig verlangsamt.
- Es gibt ein Standard-Timeout von maximal 60 Sekunden für das Herunterfahren. Passe dies bei Bedarf an, falls dies auf deinem Server nicht ausreicht.
- In diesem Beispiel wird kein Screen verwendet, daher ist die OpenSim-Konsole nicht direkt verfügbar.
Setup
- Erstelle einen Benutzer „opensim“ (achte darauf, die Shell auf /sbin/nologin zu setzen).
- Installiere OpenSim in /opt/opensim.
- Speichere die obige Datei als /etc/systemd/system/opensim.service.
Verwendung
- systemctl enable opensim
- systemctl disable opensim
- systemctl status opensim
- systemctl start opensim
- systemctl stop opensim
- systemctl restart opensim
- journalctl -u opensim
[edit] Andere OpenSimulator-Skripte für Linux
- Tmux – Verwendung von tmux, einem Terminal-Multiplexer, um OpenSimulator auf einem Server auszuführen und gleichzeitig Zugriff auf das Terminal zu behalten.
- Ogltree-Installationsanleitung – Adam Frisbys Linux-Skripte für Ogltree.
- opensimMULTITOOL - Manfred Aabeys 25000 Zeilen Bash Skript, mit ca´ 644 Funktionen, für Ubuntu 18.04-24.04 64Bit, DOTNET, mySQL, MariaDB, mit Screen Funktionen ähnlich Tmux.