Koha-clms/debian
Martin Renvoize 0aa04d9ddc
Bug 40901: (QA follow-up) Document the two init packages, the new options and the logging change
- koha-systemd.README.Debian was written for the first prototype: it
  named koha-worker-long@.service (now koha-worker-long_tasks@), said
  SIP needs the sip.enabled flag file (no longer read on systemd hosts),
  described coexisting with koha-common and a manual migration that the
  postinst now performs. Rewrite it to describe the actual units, how
  the koha-* helpers map onto them, where each configuration value is
  read from, how to relax the sandboxing with a drop-in, and the
  migration.
- Logging is the one visible behavioural change and was undocumented:
  with koha-sysv the daemon(1) wrapper captured stdout/stderr to
  /var/log/koha/INSTANCE/NAME-output.log and NAME-error.log; with
  koha-systemd that output is in the journal, so zebra-*, indexer-*,
  es-indexer-*, worker-* and sip-error.log are no longer written, while
  everything Koha writes itself (Starman's plack.log/plack-error.log,
  the log4perl files, z3950.log, the Apache vhost logs) is unchanged.
  Spell that out in README.Debian, in a new koha-systemd NEWS.Debian
  entry shown by apt-listchanges on upgrade, and in a "Service
  management" section of the koha-common(8) man page.
- Add --enable/--disable to the koha-zebra, koha-worker, koha-indexer
  and koha-es-indexer man pages.
- z3950_responder.pl's synopsis listed --config-dir twice and had lost
  -c, which is still a YAZ pass-through option; put -c back.
- t/00-valid-systemd-units.t: give it the usual shebang, and ignore
  every "Command ... is not executable" line from systemd-analyze rather
  than only the ones for scripts in this repository. Whether starman or
  /usr/share/koha/bin/... is installed on the host running the test says
  nothing about the unit files, and the old filter made the test fail on
  any development machine without the Koha packages.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Signed-off-by: Martin Renvoize <martin.renvoize@openfifth.co.uk>
Signed-off-by: Pedro Amorim <pedro.amorim@openfifth.co.uk>
2026-09-29 09:02:38 +00:00
..
docs Bug 40901: (QA follow-up) Document the two init packages, the new options and the logging change 2026-09-29 09:02:38 +00:00
scripts Bug 40901: (QA follow-up) Make koha-disable/koha-enable symmetric and fix koha-remove/koha-create 2026-09-29 09:02:36 +00:00
source Bug 32994: Remove compiled files from src (2) 2023-02-22 10:03:25 -03:00
systemd Bug 40901: (QA follow-up) Harden the service abstraction in koha-functions.sh 2026-09-29 09:02:35 +00:00
templates Bug 40901: (QA follow-up) Remove redundant unit files ( koha-sysv.service, koha-worker@.service ) 2026-09-29 09:02:13 +00:00
README.build
…
bd-to-depends
…
build-git-snapshot Bug 40163: (follow-up) Fix wrong GNU links and update test 2025-09-24 09:25:04 -06:00
changelog Update debian/changelog file: 22.12.00-3 2023-02-20 09:44:12 -03:00
clean Bug 32994: Remove compiled files from src (2) 2023-02-22 10:03:25 -03:00
compat
…
control Bug 40901: (QA follow-up) Install units to /lib/systemd/system and tidy control 2026-09-29 09:02:28 +00:00
control.in Bug 40901: (QA follow-up) Install units to /lib/systemd/system and tidy control 2026-09-29 09:02:28 +00:00
copyright Bug 40163: (follow-up) Fix wrong GNU links and update test 2025-09-24 09:25:04 -06:00
koha-common.README.Debian
…
koha-common.docs Bug 35713: Remove outdated debian/docs/LEEME.Debian file 2024-01-11 12:10:45 +01:00
koha-common.maintscript Bug 40901: (QA follow-up) Keep /etc conffiles under their koha-common names 2026-09-29 09:02:24 +00:00
koha-common.postinst Bug 40901: (QA follow-up) Restore the RabbitMQ and memcached steps in koha-common.postinst 2026-09-29 09:02:25 +00:00
koha-common.preinst Bug 40901: (testing follow-up) Remove / rename koha-common to koha-core 2026-09-29 09:01:25 +00:00
koha-core.bash-completion Bug 40901: (testing follow-up) Remove / rename koha-common to koha-core 2026-09-29 09:01:25 +00:00
koha-core.config Bug 40901: (QA follow-up) Migrate debconf answers from koha-common to koha-core 2026-09-29 09:02:26 +00:00
koha-core.dirs
…
koha-core.docs Bug 35713: Remove outdated debian/docs/LEEME.Debian file 2024-01-11 12:10:45 +01:00
koha-core.install Bug 33108: koha-es-indexer added 2023-03-20 09:39:45 -03:00
koha-core.koha-common.cron.d Bug 40901: (QA follow-up) Keep /etc conffiles under their koha-common names 2026-09-29 09:02:24 +00:00
koha-core.koha-common.cron.daily Bug 40901: (QA follow-up) Keep /etc conffiles under their koha-common names 2026-09-29 09:02:24 +00:00
koha-core.koha-common.cron.hourly Bug 40901: (QA follow-up) Keep /etc conffiles under their koha-common names 2026-09-29 09:02:24 +00:00
koha-core.koha-common.cron.monthly Bug 40901: (QA follow-up) Keep /etc conffiles under their koha-common names 2026-09-29 09:02:24 +00:00
koha-core.koha-common.default Bug 40901: (QA follow-up) Keep /etc conffiles under their koha-common names 2026-09-29 09:02:24 +00:00
koha-core.koha-common.logrotate Bug 40901: (QA follow-up) Keep /etc conffiles under their koha-common names 2026-09-29 09:02:24 +00:00
koha-core.links Bug 40901: (QA follow-up) Keep /etc conffiles under their koha-common names 2026-09-29 09:02:24 +00:00
koha-core.maintscript Bug 40901: (QA follow-up) Keep /etc conffiles under their koha-common names 2026-09-29 09:02:24 +00:00
koha-core.postinst Bug 40901: (QA follow-up) Keep /etc conffiles under their koha-common names 2026-09-29 09:02:24 +00:00
koha-core.preinst Bug 40901: (QA follow-up) Keep /etc conffiles under their koha-common names 2026-09-29 09:02:24 +00:00
koha-core.templates
…
koha-full.postinst Bug 40901: (QA follow-up) Restore the RabbitMQ and memcached steps in koha-common.postinst 2026-09-29 09:02:25 +00:00
koha-post-install-setup Bug 40163: (follow-up) Fix wrong GNU links and update test 2025-09-24 09:25:04 -06:00
koha-systemd.NEWS Bug 40901: (QA follow-up) Document the two init packages, the new options and the logging change 2026-09-29 09:02:38 +00:00
koha-systemd.README.Debian Bug 40901: (QA follow-up) Document the two init packages, the new options and the logging change 2026-09-29 09:02:38 +00:00
koha-systemd.dirs Bug 40901: (QA follow-up) Install units to /lib/systemd/system and tidy control 2026-09-29 09:02:28 +00:00
koha-systemd.install Bug 40901: (QA follow-up) Install units to /lib/systemd/system and tidy control 2026-09-29 09:02:28 +00:00
koha-systemd.postinst Bug 40901: (QA follow-up) Fix the koha-systemd migration, upgrade and removal paths 2026-09-29 09:02:34 +00:00
koha-systemd.postrm Bug 40901: (QA follow-up) Fix the koha-systemd migration, upgrade and removal paths 2026-09-29 09:02:34 +00:00
koha-systemd.prerm Bug 40901: (QA follow-up) Fix the koha-systemd migration, upgrade and removal paths 2026-09-29 09:02:34 +00:00
koha-sysv.koha-common.init Bug 40901: (QA follow-up) Install the SysV init script through dh_installinit 2026-09-29 09:02:22 +00:00
koha-sysv.postinst Bug 40901: (QA follow-up) Install the SysV init script through dh_installinit 2026-09-29 09:02:22 +00:00
koha.README.Debian
…
koha.apache-ports
…
koha.config
…
koha.dirs
…
koha.install
…
koha.postinst Bug 25691: Replace link to non-existing README with wiki link 2024-01-16 12:06:08 +01:00
koha.postrm
…
koha.prerm
…
list-deps Bug 40163: (follow-up) Fix wrong GNU links and update test 2025-09-24 09:25:04 -06:00
rules Bug 40901: (QA follow-up) Install units to /lib/systemd/system and tidy control 2026-09-29 09:02:28 +00:00
unavailable.html
…
update-control
…

README.build

In order to build .deb packages, following debian packages need to be present
(installed): 
devscripts
pbuilder
dh-make
fakeroot

As root (or sudo) execute:
pbuilder create

Executing build-git-snapshot without any arguments will leave package and the
rest in some pbuilder dir, eg. /var/cache/pbuilder/result It is highly
recommended that --buildresult option is used.