taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

commit 3e64e64098320fe121f503169432ada033d83fe3
parent 2afc27c9caee1712f120a76a88c41b19e76eb859
Author: Florian Dold <dold@taler.net>
Date:   Tue,  8 Sep 2026 21:44:08 +0200

manpages: document service startup checks for finalization

Explain that service connections reject unfinished finalization for their
component, while administrative connections remain available for repair.
Clarify that startup checks do not replace stopping services for upgrades.

Diffstat:
Mmanpages/taler-auditor-dbinit.1.rst | 5+++++
Mmanpages/taler-exchange-dbinit.1.rst | 5+++++
Mmanpages/taler-merchant-dbinit.1.rst | 5+++++
3 files changed, 15 insertions(+), 0 deletions(-)

diff --git a/manpages/taler-auditor-dbinit.1.rst b/manpages/taler-auditor-dbinit.1.rst @@ -44,6 +44,11 @@ its writes. Pending finalization is recorded in ``_v.pending_finalizations`` before applying migrations and cleared only when finalization commits. Failed finalization remains visible to ``--dry``, even without procedure files. +Normal service connections reject pending finalization for their own component +and failures to inspect that status. Administrative connections remain available +so dbinit can finish the migration. These are startup checks; stop the services +before running migrations. + Its options are as follows: **--dry** diff --git a/manpages/taler-exchange-dbinit.1.rst b/manpages/taler-exchange-dbinit.1.rst @@ -47,6 +47,11 @@ its writes. Pending finalization is recorded in ``_v.pending_finalizations`` before applying migrations and cleared only when finalization commits. Failed finalization remains visible to ``--dry``, even without procedure files. +Normal service connections reject pending finalization for their own component +and failures to inspect that status. Administrative connections remain available +so dbinit can finish the migration. These are startup checks; stop the services +before running migrations. + Its options are as follows: **--dry** diff --git a/manpages/taler-merchant-dbinit.1.rst b/manpages/taler-merchant-dbinit.1.rst @@ -45,6 +45,11 @@ its writes. Pending finalization is recorded in ``_v.pending_finalizations`` before applying migrations and cleared only when finalization commits. Failed finalization remains visible to ``--dry``, even without procedure files. +Normal service connections reject pending finalization for their own component +and failures to inspect that status. Administrative connections remain available +so dbinit can finish the migration. These are startup checks; stop the services +before running migrations. + Its options are as follows: **--dry**