mod/assign/feedback/editpdf/testunoconv/initd: Difference between revisions
Damyon Wiese (talk | contribs) |
(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
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 :