Note: You are currently viewing documentation for Moodle 3.9. Up-to-date documentation for the latest stable version of Moodle may be available here: mod/assign/feedback/editpdf/testunoconv/initd.

mod/assign/feedback/editpdf/testunoconv/initd: Difference between revisions

From MoodleDocs
m (Added link to spanish translation of page)
m (Fix an error, The ":" character required in the end)
 
(12 intermediate revisions by 4 users not shown)
Line 1: Line 1:
= Init script example for unoconv on debian =
= Init script example for unoconv on debian =
[[ mod/assign/feedback/editpdf/testunoconv | Back to unoconv installation ]]
This script can be installed to /etc/init.d/unoconvd and then linked to system startup with the command:
<pre>
sudo update-rc.d unoconvd defaults
</pre>
If you are planning to unoconv service for remote access as described [[ mod/assign/feedback/editpdf/testunoconv#Offload_processing_to_a_different_server | here ]], notice that it will be listening on localhost interface by default. To make it listen on the different network interface, you need to create <tt>/etc/default/unoconv</tt> with a content below to override DAEMON_ARGS variable (use specific IP if you have more than one network interface, or 0.0.0.0 to listen on all of them):
<pre>
# Override arguments to make unoconv listening on network interface.
DAEMON_ARGS="--listener -s 0.0.0.0"
</pre>
It is also recommended to add this to the root crontab as it is safe to run "sudo service unoconvd start" over and over (it will check if the process is running and start it if required).
Crontab entry to check and start the process every 5 minutes. This version will print a message when unoconv is restarted so that an email will be sent by cron.
<pre>
*/5 * * * * /usr/bin/service unoconvd status > /dev/null || (/usr/bin/service unoconvd start && echo "Restarted crashed unoconv listener")
</pre>
Here is the script.
<pre>
<pre>
#! /bin/sh
#! /bin/sh
Line 8: Line 29:
# Default-Start:    2 3 4 5
# Default-Start:    2 3 4 5
# Default-Stop:      0 1 6
# Default-Stop:      0 1 6
# Short-Description: Example initscript
# Short-Description: Startup script for unoconvd listener
# Description:      This file should be used to construct scripts to be
# Description:      Startup script for unoconvd listener. Allows starting/stopping/restarting and checking status of unoconvd listener.
#                    placed in /etc/init.d.
### END INIT INFO
### END INIT INFO


# Author: Damyon Wiese <damyon@moodle.com>
# Author: Damyon Wiese <damyon@moodle.com>
#
# Please remove the "Author" lines above and replace them
# with your own name if you copy and modify this script.


# Do NOT "set -e"
# Do NOT "set -e"
Line 55: Line 72:
start-stop-daemon --start --quiet --make-pidfile --background --pidfile $PIDFILE --exec $DAEMON --chuid $APACHEUSER --test > /dev/null \
start-stop-daemon --start --quiet --make-pidfile --background --pidfile $PIDFILE --exec $DAEMON --chuid $APACHEUSER --test > /dev/null \
|| return 1
|| return 1
start-stop-daemon --start --quiet --make-pidfile --background --pidfile $PIDFILE --exec $DAEMON --chuid $APACHEUSER -- \
status_of_proc "$DAEMON" "$NAME" > /dev/null
RETVAL="$?"
[ "$RETVAL" = 3 ] && start-stop-daemon --start --quiet --make-pidfile --background --pidfile $PIDFILE --exec $DAEMON --chuid $APACHEUSER -- \
$DAEMON_ARGS \
$DAEMON_ARGS \
|| return 2
|| return 2
Line 87: Line 106:
rm -f $PIDFILE
rm -f $PIDFILE


    /usr/bin/killall /usr/lib/libreoffice/program/soffice.bin
/usr/bin/killall /usr/lib/libreoffice/program/soffice.bin
      
      
return "$RETVAL"
return "$RETVAL"
Line 164: Line 183:


:
:
</pre>
</pre>


 
[[ mod/assign/feedback/editpdf/testunoconv | Back to unoconv installation ]]


[[es:mod/assign/feedback/editpdf/testunoconv/initd]]
[[es:mod/assign/feedback/editpdf/testunoconv/initd]]
[[de:Init Skript für Debian]]

Latest revision as of 23:13, 11 September 2018

Init script example for unoconv on debian

Back to unoconv installation

This script can be installed to /etc/init.d/unoconvd and then linked to system startup with the command:

sudo update-rc.d unoconvd defaults

If you are planning to unoconv service for remote access as described here , notice that it will be listening on localhost interface by default. To make it listen on the different network interface, you need to create /etc/default/unoconv with a content below to override DAEMON_ARGS variable (use specific IP if you have more than one network interface, or 0.0.0.0 to listen on all of them):

# Override arguments to make unoconv listening on network interface.
DAEMON_ARGS="--listener -s 0.0.0.0"

It is also recommended to add this to the root crontab as it is safe to run "sudo service unoconvd start" over and over (it will check if the process is running and start it if required).

Crontab entry to check and start the process every 5 minutes. This version will print a message when unoconv is restarted so that an email will be sent by cron.

*/5 * * * * /usr/bin/service unoconvd status > /dev/null || (/usr/bin/service unoconvd start && echo "Restarted crashed unoconv listener")

Here is the script.

#! /bin/sh
### BEGIN INIT INFO
# Provides:          unoconvd
# Required-Start:    $remote_fs $syslog
# Required-Stop:     $remote_fs $syslog
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: Startup script for unoconvd listener
# Description:       Startup script for unoconvd listener. Allows starting/stopping/restarting and checking status of unoconvd listener.
### END INIT INFO

# Author: Damyon Wiese <damyon@moodle.com>

# Do NOT "set -e"

# PATH should only include /usr/* if it runs after the mountnfs.sh script
PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Unoconv listener for document conversions"
NAME=unoconv
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="--listener"
PIDFILE=/var/run/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
APACHEUSER=www-data

# Exit if the package is not installed
[ -x "$DAEMON" ] || exit 0

# Read configuration variable file if it is present
[ -r /etc/default/$NAME ] && . /etc/default/$NAME

# Load the VERBOSE setting and other rcS variables
. /lib/init/vars.sh

# Define LSB log_* functions.
# Depend on lsb-base (>= 3.2-14) to ensure that this file is present
# and status_of_proc is working.
. /lib/lsb/init-functions

#
# Function that starts the daemon/service
#
do_start()
{
	# Return
	#   0 if daemon has been started
	#   1 if daemon was already running
	#   2 if daemon could not be started
	start-stop-daemon --start --quiet --make-pidfile --background --pidfile $PIDFILE --exec $DAEMON --chuid $APACHEUSER --test > /dev/null \
		|| return 1
	status_of_proc "$DAEMON" "$NAME" > /dev/null
	RETVAL="$?"
	[ "$RETVAL" = 3 ] && start-stop-daemon --start --quiet --make-pidfile --background --pidfile $PIDFILE --exec $DAEMON --chuid $APACHEUSER -- \
		$DAEMON_ARGS \
		|| return 2
	# Add code here, if necessary, that waits for the process to be ready
	# to handle requests from services started subsequently which depend
	# on this one.  As a last resort, sleep for some time.
}

#
# Function that stops the daemon/service
#
do_stop()
{
	# Return
	#   0 if daemon has been stopped
	#   1 if daemon was already stopped
	#   2 if daemon could not be stopped
	#   other if a failure occurred
	start-stop-daemon --stop --quiet --retry=TERM/30/KILL/5 --pidfile $PIDFILE --name $NAME
	RETVAL="$?"
	[ "$RETVAL" = 2 ] && return 2
	# Wait for children to finish too if this is a daemon that forks
	# and if the daemon is only ever run from this initscript.
	# If the above conditions are not satisfied then add some other code
	# that waits for the process to drop all resources that could be
	# needed by services started subsequently.  A last resort is to
	# sleep for some time.
	start-stop-daemon --stop --quiet --oknodo --retry=0/30/KILL/5 --exec $DAEMON
	[ "$?" = 2 ] && return 2
	# Many daemons don't delete their pidfiles when they exit.
	rm -f $PIDFILE

	/usr/bin/killall /usr/lib/libreoffice/program/soffice.bin
    
	return "$RETVAL"
}

#
# Function that sends a SIGHUP to the daemon/service
#
do_reload() {
	#
	# If the daemon can reload its configuration without
	# restarting (for example, when it is sent a SIGHUP),
	# then implement that here.
	#
	start-stop-daemon --stop --signal 1 --quiet --pidfile $PIDFILE --name $NAME
	return 0
}

case "$1" in
  start)
	[ "$VERBOSE" != no ] && log_daemon_msg "Starting $DESC" "$NAME"
	do_start
	case "$?" in
		0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
		2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
	esac
	;;
  stop)
	[ "$VERBOSE" != no ] && log_daemon_msg "Stopping $DESC" "$NAME"
	do_stop
	case "$?" in
		0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
		2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
	esac
	;;
  status)
	status_of_proc "$DAEMON" "$NAME" && exit 0 || exit $?
	;;
  #reload|force-reload)
	#
	# If do_reload() is not implemented then leave this commented out
	# and leave 'force-reload' as an alias for 'restart'.
	#
	#log_daemon_msg "Reloading $DESC" "$NAME"
	#do_reload
	#log_end_msg $?
	#;;
  restart|force-reload)
	#
	# If the "reload" option is implemented then remove the
	# 'force-reload' alias
	#
	log_daemon_msg "Restarting $DESC" "$NAME"
	do_stop
	case "$?" in
	  0|1)
		do_start
		case "$?" in
			0) log_end_msg 0 ;;
			1) log_end_msg 1 ;; # Old process is still running
			*) log_end_msg 1 ;; # Failed to start
		esac
		;;
	  *)
		# Failed to stop
		log_end_msg 1
		;;
	esac
	;;
  *)
	#echo "Usage: $SCRIPTNAME {start|stop|restart|reload|force-reload}" >&2
	echo "Usage: $SCRIPTNAME {start|stop|status|restart|force-reload}" >&2
	exit 3
	;;
esac

:

Back to unoconv installation