--- /dev/null
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-enable-sip</title>
+<info>
+ <productname>Koha</productname> is the first free software library automation package.
+ <author>
+ <personname>
+ <firstname>Robin</firstname>
+ <surname>Sheat</surname>
+ </personname>
+ <affiliation>
+ <orgname>Catalyst IT</orgname>
+ <uri>http://www.catalyst.net.nz</uri>
+ </affiliation>
+ <contrib>Author</contrib>
+ </author>
+</info>
+
+<refentry xml:id="koha-enable-sip">
+
+ <refmeta>
+ <refentrytitle>koha-enable-sip</refentrytitle>
+ <manvolnum>8</manvolnum>
+ </refmeta>
+
+ <refnamediv>
+ <refname>koha-enable-sip</refname>
+ <refpurpose>Copies the SIP configuration file to allow SIP to be controlled by init scripts.</refpurpose>
+ <refclass>UNIX/Linux</refclass>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <cmdsynopsis>
+ <command>koha-enable-sip</command>
+ <arg choice="req" rep="repeat"><replaceable>instancename</replaceable></arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1><title>Description</title>
+ <para>This copies the default SIP configuration file /etc/koha/SIPconfig.xml to the
+ /etc/koha/sites/instancename directory. This allows it to be started by
+ <command>koha-start-sip(8)</command>, and <command>koha-stop-sip</command>. In turn,
+ this means that it will be started on boot and stopped on shutdown.</para>
+ <para>After running this, you will need to edit the newly created file to configure it
+ for your site.</para>
+ <para>To disable SIP again, delete or rename the configuration file.</para>
+ </refsect1>
+
+ <refsect1><title>See also</title>
+ <simplelist type="inline">
+ <member><command>koha-start-sip(8)</command></member>
+ <member><command>koha-stop-sip(8)</command></member>
+ </simplelist>
+ </refsect1>
+
+</refentry>
+
+</article>
--- /dev/null
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-start-sip</title>
+<info>
+ <productname>Koha</productname> is the first free software library automation package.
+ <author>
+ <personname>
+ <firstname>Robin</firstname>
+ <surname>Sheat</surname>
+ </personname>
+ <affiliation>
+ <orgname>Catalyst IT</orgname>
+ <uri>http://www.catalyst.net.nz</uri>
+ </affiliation>
+ <contrib>Author</contrib>
+ </author>
+</info>
+
+<refentry xml:id="koha-start-sip">
+
+ <refmeta>
+ <refentrytitle>koha-start-sip</refentrytitle>
+ <manvolnum>8</manvolnum>
+ </refmeta>
+
+ <refnamediv>
+ <refname>koha-start-sip</refname>
+ <refpurpose>Starts the SIP daemon for the specified Koha instances.</refpurpose>
+ <refclass>UNIX/Linux</refclass>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <cmdsynopsis>
+ <command>koha-start-sip</command>
+ <arg choice="req" rep="repeat"><replaceable>instancename</replaceable></arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1><title>Description</title>
+ <para>This will start the SIP daemon for the Koha instance specified by <arg>instancename</arg>.</para>
+ <para>If the SIP configuration is not present for the supplied instance, it will be silently skipped.</para>
+ <para>To enable SIP support for an instance, refer to <command>koha-enable-sip(8)</command>.</para>
+ </refsect1>
+
+ <refsect1><title>See also</title>
+ <simplelist type="inline">
+ <member><command>koha-stop-sip(8)</command></member>
+ <member><command>koha-enable-sip(8)</command></member>
+ </simplelist>
+ </refsect1>
+
+</refentry>
+
+</article>
--- /dev/null
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-stop-sip</title>
+<info>
+ <productname>Koha</productname> is the first free software library automation package.
+ <author>
+ <personname>
+ <firstname>Robin</firstname>
+ <surname>Sheat</surname>
+ </personname>
+ <affiliation>
+ <orgname>Catalyst IT</orgname>
+ <uri>http://www.catalyst.net.nz</uri>
+ </affiliation>
+ <contrib>Author</contrib>
+ </author>
+</info>
+
+<refentry xml:id="koha-stop-sip">
+
+ <refmeta>
+ <refentrytitle>koha-stop-sip</refentrytitle>
+ <manvolnum>8</manvolnum>
+ </refmeta>
+
+ <refnamediv>
+ <refname>koha-stop-sip</refname>
+ <refpurpose>Stops the SIP daemon for the specified Koha instances.</refpurpose>
+ <refclass>UNIX/Linux</refclass>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <cmdsynopsis>
+ <command>koha-stop-sip</command>
+ <arg choice="req" rep="repeat"><replaceable>instancename</replaceable></arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1><title>Description</title>
+ <para>This will stop the SIP daemon for the Koha instance specified by <arg>instancename</arg>.</para>
+ <para>If it's not running, an note will be displayed.</para>
+ </refsect1>
+
+ <refsect1><title>See also</title>
+ <simplelist type="inline">
+ <member><command>koha-start-sip(8)</command></member>
+ <member><command>koha-enable-sip(8)</command></member>
+ </simplelist>
+ </refsect1>
+
+</refentry>
+
+</article>
# We insure all required directories exist, including disabled ones.
koha-create-dirs $(koha-list)
koha-start-zebra $(koha-list --enabled)
+ koha-start-sip $(koha-list --enabled)
}
#
{
# We stop everything, including disabled ones.
koha-stop-zebra $(koha-list) || true
+ koha-stop-sip $(koha-list) || true
}
#
#
do_reload() {
koha-restart-zebra $(koha-list --enabled)
+ koha-stop-sip $(koha-list) || true
+ koha-start-sip $(koha-list --enabled)
}
case "$1" in
debian/scripts/koha-translate usr/sbin
debian/scripts/koha-upgrade-schema usr/sbin
debian/scripts/koha-upgrade-to-3.4 usr/sbin
+debian/scripts/koha-start-sip usr/sbin
+debian/scripts/koha-stop-sip usr/sbin
+debian/scripts/koha-enable-sip usr/sbin
debian/tmp_docbook/*.8 usr/share/man/man8
--- /dev/null
+#!/bin/sh
+#
+# koha-enable-sip -- Set up the config files to allow SIP to run
+# Copyright 2012 Catalyst IT, Ltd
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+set -e
+
+for name in "$@"
+do
+ if [ ! -e /etc/koha/sites/${name}/koha-conf.xml ] ;
+ then
+ echo "No such instance: ${name}" > /dev/stderr
+ continue;
+ fi
+ sipfile=/etc/koha/sites/${name}/SIPconfig.xml
+ if [ -e ${sipfile} ]
+ then
+ echo "SIP already enabled for $name"
+ else
+ echo "Enabling SIP for $name - edit ${sipfile} to configure"
+ cp -v /etc/koha/SIPconfig.xml ${sipfile}
+ chown ${name}-koha:${name}-koha ${sipfile}
+ chmod 600 ${sipfile}
+ fi
+done
--- /dev/null
+#!/bin/sh
+#
+# koha-start-sip -- Start SIP server for named Koha instance
+# Copyright 2012 Catalyst IT, Ltd
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+set -e
+
+for name in "$@"
+do
+ if [ ! -e /etc/koha/sites/${name}/koha-conf.xml ] ;
+ then
+ echo "No such instance: ${name}" > /dev/stderr
+ continue;
+ fi
+ [ -e /etc/koha/sites/${name}/SIPconfig.xml ] || continue
+ echo "Starting SIP server for $name"
+ mkdir -p /var/run/koha/${name}
+ chown "${name}-koha:${name}-koha" /var/run/koha/${name}
+ export KOHA_CONF PERL5LIB
+ KOHA_CONF=/etc/koha/sites/${name}/koha-conf.xml
+ PERL5LIB="/usr/share/koha/lib:/usr/share/koha/lib/C4/SIP"
+ daemon \
+ --name="$name-koha-sip" \
+ --errlog="/var/log/koha/$name/sip-error.log" \
+ --stdout="/var/log/koha/$name/sip.log" \
+ --output="/var/log/koha/$name/sip-output.log" \
+ --verbose=1 \
+ --respawn \
+ --delay=30 \
+ --pidfiles="/var/run/koha/${name}" \
+ --user="$name-koha.$name-koha" \
+ -- \
+ perl \
+ "/usr/share/koha/lib/C4/SIP/SIPServer.pm" \
+ "/etc/koha/sites/${name}/SIPconfig.xml"
+done
--- /dev/null
+#!/bin/sh
+#
+# koha-stop-sip -- Stop SIP server for named Koha instance
+# Copyright 2012 Catalyst IT, Ltd
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+set -e
+
+for name in "$@"
+do
+ if [ ! -e /etc/koha/sites/${name}/koha-conf.xml ] ;
+ then
+ echo "No such instance: ${name}" > /dev/stderr
+ continue;
+ fi
+ if [ ! -e /var/run/koha/${name}/${name}-koha-sip.pid ] ;
+ then
+ echo "SIP server for ${name} not running."
+ continue;
+ fi
+ echo "Stopping SIP server for $name"
+ KOHA_CONF=/etc/koha/sites/${name}/koha-conf.xml
+ PERL5LIB=/usr/share/koha/lib
+ export KOHA_CONF PERL5LIB
+ daemon \
+ --name="$name-koha-sip" \
+ --errlog="/var/log/koha/$name/sip-error.log" \
+ --stdout="/var/log/koha/$name/sip.log" \
+ --output="/var/log/koha/$name/sip-output.log" \
+ --verbose=1 \
+ --respawn \
+ --delay=30 \
+ --pidfiles="/var/run/koha/${name}" \
+ --user="$name-koha.$name-koha" \
+ --stop \
+ -- \
+ perl \
+ "/usr/share/koha/lib/C4/SIP/SIPServer.pm" \
+ "/etc/koha/sites/${name}/SIPconfig.xml"
+done
projects / koha.git / commitdiff