[Debian-ha-maintainers] Bug#1073716: drbd-utils: move aliased files from / to /usr (DEP17)

[Helmut Grohne]

Package: drbd-utils
Version: 9.22.0-1
Severity: important
Tags: patch trixie sid
User: helmutg at debian.org
Usertags: dep17m2 dep17dhmovetousr

This package is part of the /usr-move (DEP17) transition, because it
contains files in aliased locations and should have those files moved to
the corresponding /usr location. The goal of this move is eliminating
bugs arising from aliasing, such as file loss during package upgrades.

The following files in the following binary packages are affected.

drbd-utils contains:
 * lib
 * lib/drbd
 * lib/drbd/drbdadm-83
 * lib/drbd/drbdadm-84
 * lib/drbd/drbdsetup-83
 * lib/drbd/drbdsetup-84
 * lib/drbd/scripts
 * lib/drbd/scripts/drbd
 * lib/drbd/scripts/drbd-service-shim.sh
 * lib/drbd/scripts/drbd-wait-promotable.sh
 * lib/drbd/scripts/ocf.ra.wrapper.sh
 * lib/modules-load.d
 * lib/modules-load.d/drbd.conf
 * lib/systemd
 * lib/systemd/system
 * lib/systemd/system/drbd-demote-or-escalate at .service
 * lib/systemd/system/drbd-lvchange at .service
 * lib/systemd/system/drbd-promote at .service
 * lib/systemd/system/drbd-reconfigure-suspend-or-error at .service
 * lib/systemd/system/drbd-services at .target
 * lib/systemd/system/drbd-wait-promotable at .service
 * lib/systemd/system/drbd.service
 * lib/systemd/system/drbd at .service
 * lib/systemd/system/drbd at .target
 * lib/systemd/system/ocf.ra at .service
 * lib/udev
 * lib/udev/rules.d
 * lib/udev/rules.d/65-drbd.rules
 * sbin
 * sbin/drbdadm
 * sbin/drbdmeta
 * sbin/drbdmon
 * sbin/drbdsetup

You may add dh-sequence-movetousr to Build-Depends to perform the move.
This is an easy and readily applicable measure that has been verified
for this package using a test build. The main advantage of this method
is the low effort and it just works when backporting to bookworm.
However, it is more of a stop-gap measure as eventually the installation
procedure should refer to the files that are actually used for
installation. This often means updating debian/*.install files but also
changing flags passed to a configure script or similar measures. In case
you do not anticipate your package being uploaded to bookworm-backports,
please prefer a manual move, but generally prefer moving over delaying
any further.

After having done this move, please keep in mind that the relevant
changes need to be reverted for bookworm-backports, with these
exceptions:
 * dh-sequence-movetousr and dh_movetousr cancel themselves.
 * dh_installsystemd and dh_installudev revert to the aliased location.
 * The pkg-config variables systemdsystemunitdir in systemd.pc and
   udevdir in udev.pc reverts to aliased.

Please keep in mind that restructuring changes may introduce problems
after moving. A change is considered restructuring if formerly aliased
files formerly owned by one package are later to be owned by a package
with a different name. Such uploads should be done to experimental and
quarantine for three days before moving to unstable. This way, automatic
analysis (https://salsa.debian.org/helmutg/dumat) can detect problems
and file bugs. Such bugs shall include support for resolving the
problems.

The severity of this bug shall be raised to RC on August 6th.

For additional information about refer to
https://wiki.debian.org/UsrMerge and
https://subdivi.de/~helmut/dep17.html.