Note: You are currently viewing documentation for Moodle 3.8. 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
(Add clarification how to make unoconv listening on specific network interface.)
Line 5: Line 5:
<pre>
<pre>
sudo update-rc.d unoconvd defaults
sudo update-rc.d unoconvd defaults
</pre>
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 <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>
</pre>



Revision as of 16:01, 3 August 2016

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