debian/scripts/koha-sip

   1 #!/bin/bash
   2
   3 # koha-sip - Manage SIP server for Koha instances
   4 #              Copyright 2019 Theke Solutions
   5 #              Copyright 2012 Catalyst IT, Ltd
   6 #
   7 # This program is free software: you can redistribute it and/or modify
   8 # it under the terms of the GNU General Public License as published by
   9 # the Free Software Foundation, either version 3 of the License, or
  10 # (at your option) any later version.
  11 #
  12 # This program is distributed in the hope that it will be useful,
  13 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 # GNU General Public License for more details.
  16 #
  17 # You should have received a copy of the GNU General Public License
  18 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
  19
  20 set -e
  21
  22 . /lib/lsb/init-functions
  23
  24 # Read configuration variable file if it is present
  25 [ -r /etc/default/koha-common ] && . /etc/default/koha-common
  26
  27 # include helper functions
  28 if [ -f "/usr/share/koha/bin/koha-functions.sh" ]; then
  29     . "/usr/share/koha/bin/koha-functions.sh"
  30 else
  31     echo "Error: /usr/share/koha/bin/koha-functions.sh not present." 1>&2
  32     exit 1
  33 fi
  34
  35 usage()
  36 {
  37     local scriptname=$(basename $0)
  38
  39     cat <<EOF
  40 $scriptname
  41
  42 This script lets you manage the SIP server for your Koha instances.
  43
  44 Usage:
  45 $scriptname [--start|--stop|--restart] instancename1 [instancename2...]
  46 $scriptname -h|--help
  47
  48     --enable              Enable the Koha SIP server.
  49     --disable             Disable and stop the Koha SIP server.
  50     --start               Start the SIP server for the specified instance(s)
  51     --stop                Stop the SIP server for the specified instance(s)
  52     --restart             Restart the SIP server for the specified instance(s)
  53     --status              Show the status of the SIP server for the specified instance(s)
  54     --verbose|-v          Display progress and actions messages
  55     --help|-h             Display this help message
  56
  57 EOF
  58 }
  59
  60 start_sip()
  61 {
  62     local name=$1
  63
  64     _check_and_fix_perms $name
  65
  66     if ! is_sip_running $name; then
  67         if [ ! -f "/etc/koha/sites/${name}/SIPconfig.xml" ] || [ ! -f "/var/lib/koha/${name}/sip.enabled" ] ; then
  68             echo "SIP is disabled, or you do not have a SIPconfig.xml file."
  69         else
  70             adjust_paths_dev_install $name
  71             export KOHA_HOME PERL5LIB
  72
  73             if [ "$DEV_INSTALL" = "" ]; then
  74                 LIBDIR=$KOHA_HOME/lib
  75             else
  76                 LIBDIR=$KOHA_HOME
  77             fi
  78
  79             DAEMONOPTS="--name=${name}-koha-sip \
  80                     --errlog=/var/log/koha/${name}/sip-error.log \
  81                     --stdout=/var/log/koha/${name}/sip.log \
  82                     --output=/var/log/koha/${name}/sip-output.log \
  83                     --verbose=1 \
  84                     --respawn \
  85                     --delay=30 \
  86                     --pidfiles=/var/run/koha/${name} \
  87                     --user=${name}-koha.${name}-koha"
  88
  89             SIP_PARAMS="$LIBDIR/C4/SIP/SIPServer.pm \
  90                     /etc/koha/sites/${name}/SIPconfig.xml"
  91
  92             [ "$verbose" != "no" ] && \
  93                 log_daemon_msg "Starting SIP server for ${name}"
  94
  95             if daemon $DAEMONOPTS -- perl $SIP_PARAMS; then
  96                 ([ "$verbose" != "no" ] && \
  97                     log_end_msg 0) || return 0
  98             else
  99                 ([ "$verbose" != "no" ] && \
 100                     log_end_msg 1) || return 1
 101             fi
 102         fi
 103     else
 104         if [ "$verbose" != "no" ]; then
 105             log_daemon_msg "Warning: SIP server already running for ${name}"
 106             log_end_msg 0
 107         else
 108             return 0
 109         fi
 110     fi
 111 }
 112
 113 stop_sip()
 114 {
 115     local name=$1
 116
 117     if is_sip_running $name; then
 118
 119         DAEMONOPTS="--name=${name}-koha-sip \
 120                     --errlog=/var/log/koha/${name}/sip-error.log \
 121                     --stdout=/var/log/koha/${name}/sip.log \
 122                     --output=/var/log/koha/${name}/sip-output.log \
 123                     --verbose=1 \
 124                     --respawn \
 125                     --delay=30 \
 126                     --pidfiles=/var/run/koha/${name} \
 127                     --user=${name}-koha.${name}-koha"
 128
 129         [ "$verbose" != "no" ] && \
 130             log_daemon_msg "Stopping SIP server for ${name}"
 131
 132         if daemon $DAEMONOPTS --stop; then
 133             ([ "$verbose" != "no" ] && \
 134                 log_end_msg 0) || return 0
 135         else
 136             ([ "$verbose" != "no" ] && \
 137                 log_end_msg 1) || return 1
 138         fi
 139     else
 140         if [ "$verbose" != "no" ]; then
 141             log_daemon_msg "Warning: SIP server not running for ${name}"
 142             log_end_msg 0
 143         else
 144             return 0
 145         fi
 146     fi
 147 }
 148
 149 restart_sip()
 150 {
 151     local name=$1
 152
 153     if is_sip_running ${name}; then
 154         local noLF="-n"
 155         [ "$verbose" != "no" ] && noLF=""
 156         echo $noLF `stop_sip ${name}`
 157         echo $noLF `start_sip ${name}`
 158     else
 159         if [ "$verbose" != "no" ]; then
 160             log_daemon_msg "Warning: SIP server not running for ${name}"
 161             log_end_msg 0
 162         else
 163             return 0
 164         fi
 165     fi
 166 }
 167
 168 sip_status()
 169 {
 170     local name=$1
 171
 172     if is_sip_running ${name}; then
 173         log_daemon_msg "SIP server running for ${name}"
 174         log_end_msg 0
 175     else
 176         log_daemon_msg "SIP server not running for ${name}"
 177         log_end_msg 3
 178     fi
 179 }
 180
 181 enable_sip()
 182 {
 183     local name=$1
 184     local libdir=/var/lib/koha/${name}
 185
 186     sipfile=/etc/koha/sites/${name}/SIPconfig.xml
 187
 188     if is_sip_enabled ${name}; then
 189         echo "Warning: SIP server already enabled for ${name}"
 190     else
 191         echo "Enabling SIP server for ${name} - edit ${sipfile} to configure"
 192         touch $libdir/sip.enabled
 193         if [[ ! -f "/etc/koha/sites/${name}/SIPconfig.xml" ]]; then
 194             cp -v /etc/koha/SIPconfig.xml ${sipfile}
 195             chown ${name}-koha:${name}-koha ${sipfile}
 196             chmod 600 ${sipfile}
 197             echo "This is the first time SIP has been enabled. Please check the configurations in /etc/koha/sites/${name}/SIPconfig.xml"
 198         fi
 199     fi
 200 }
 201
 202 disable_sip()
 203 {
 204     local name=$1
 205     local libdir=/var/lib/koha/${name}
 206
 207     if is_sip_enabled ${name}; then
 208         # SIP is enabled, we should disable it
 209         echo "Stopping running SIP"
 210         stop_sip ${name}
 211         rm ${libdir}/sip.enabled
 212         echo "Information: SIP server disabled for ${name}"
 213     else
 214         echo " SIP server for ${name} not enabled - use koha-sip --enable <instance> to enable."
 215     fi
 216 }
 217
 218
 219 _check_and_fix_perms()
 220 {
 221     local name=$1
 222
 223     local files="/var/log/koha/${name}/sip-error.log \
 224                  /var/log/koha/${name}/sip.log \
 225                  /var/log/koha/$name/sip-output.log"
 226
 227     for file in ${files}
 228     do
 229         if [ ! -e "${file}" ]; then
 230             touch ${file}
 231         fi
 232         chown "${name}-koha":"${name}-koha" ${file}
 233     done
 234 }
 235
 236 set_action()
 237 {
 238     if [ "$op" = "" ]; then
 239         op=$1
 240     else
 241         die "Error: only one action can be specified."
 242     fi
 243 }
 244
 245 op=""
 246 verbose="no"
 247
 248 # Backwards compatible with old koha-*-sip scripts
 249 # TODO: Remove once there's consensus to remove the legacy scripts
 250 used_script_name=$(basename $0)
 251
 252 if [ "$used_script_name" != "koha-sip" ]; then
 253     warn "Deprecated script used (${used_script_name})"
 254
 255     case "$used_script_name" in
 256         koha-start-sip)
 257             set_action "start" ;;
 258         koha-stop-sip)
 259             set_action "stop" ;;
 260         koha-enable-sip)
 261             set_action "enable" ;;
 262         *)
 263             break ;;
 264     esac
 265 fi
 266 # / Backwards compatible handling code
 267
 268 # Read command line parameters
 269 while [ $# -gt 0 ]; do
 270
 271     case "$1" in
 272         -h|--help)
 273             usage ; exit 0 ;;
 274         -v|--verbose)
 275             verbose="yes"
 276             shift ;;
 277         --start)
 278             set_action "start"
 279             shift ;;
 280         --stop)
 281             set_action "stop"
 282             shift ;;
 283         --restart)
 284             set_action "restart"
 285             shift ;;
 286         --status)
 287             set_action "status"
 288             shift ;;
 289         --enable)
 290             set_action "enable"
 291             shift ;;
 292         --disable)
 293             set_action "disable"
 294             shift ;;
 295         -*)
 296             die "Error: invalid option switch ($1)" ;;
 297         *)
 298             # We expect the remaining stuff are the instance names
 299             break ;;
 300     esac
 301
 302 done
 303
 304 if [ $# -gt 0 ]; then
 305     # We have at least one instance name
 306     for name in "$@"; do
 307
 308         if is_instance $name; then
 309
 310             export KOHA_CONF="/etc/koha/sites/$name/koha-conf.xml"
 311
 312             case $op in
 313                 "start")
 314                     start_sip $name
 315                     ;;
 316                 "stop")
 317                     stop_sip $name
 318                     ;;
 319                 "restart")
 320                     restart_sip $name
 321                     ;;
 322                 "status")
 323                     sip_status $name
 324                     ;;
 325                 "enable")
 326                     enable_sip $name
 327                     ;;
 328                 "disable")
 329                     disable_sip $name
 330             esac
 331
 332         else
 333             if [ "$verbose" != "no" ]; then
 334                 log_daemon_msg "Error: Invalid instance name $name"
 335                 log_end_msg 1
 336             fi
 337         fi
 338
 339     done
 340 else
 341     if [ "$verbose" != "no" ]; then
 342         warn "Error: you must provide at least one instance name"
 343     fi
 344 fi
 345
 346 exit 0