Differences

This shows you the differences between two versions of the page.

Link to this comparison view

rpm_system_restart [2018/05/10 15:10] (current)
Stephane de Labrusse created
Line 1: Line 1:
 +==== RPM Systemd Control ====
 +official documentation at https://​fedoraproject.org/​wiki/​Packaging:​Scriptlets
  
 +Packages containing systemd unit files need to use scriptlets to ensure proper handling of those services. Services can either be enabled or disabled by default. To determine which case your specific service falls into, please refer to FESCo'​s policy here: Packaging:​DefaultServices. On upgrade, a package may only restart a service if it is running; it may not start it if it is off. Also, the service may not enable itself if it is currently disabled.
 +Scriptlets
 +
 +The systemd package provides a set of helper macros to handle systemd scriptlet operations. These macros support systemd "​presets",​ as documented in Features/​PackagePresets. The %systemd_requires macro is a shortcut for listing the per-scriptlet dependencies on systemd.
 +
 +<​file>​
 +%{?​systemd_requires}
 +BuildRequires:​ systemd
 +</​file>​
 +
 +<​file>​
 +[...]
 +%post
 +%systemd_post apache-httpd.service
 +
 +%preun
 +%systemd_preun apache-httpd.service
 +
 +%postun
 +%systemd_postun_with_restart apache-httpd.service
 +</​file>​
 +
 +Some services do not support being restarted (e.g. D-Bus and various storage daemons). If your service should not be restarted upon upgrade, then use the following `%postun scriptlet` instead of the one shown above:
 +
 +<​file>​
 +%postun
 +%systemd_postun apache-httpd.service
 +</​file>​
 +
 +If your package includes one or more systemd units that need to be enabled by default on package installation,​ they MUST be covered by the Fedora preset policy.
 +
 +If a package is suitable for installation without systemd (in a container image, for example) and does not require any of the systemd mechanisms such as tmpfiles.d, then the `%systemd_ordering` macro MAY be used instead of the `%systemd_requires` macro.
 +User units
 +
 +There are additional macros for user units (those installed under `%_userunitdir`) that should be used similarly to those for system units. These enable and disable user units according to presets, and are `%systemd_user_post` (to be used in `%post`) and `%systemd_user_preun` (to be used in `%preun`).
 +
 +<​file>​
 +%{?​systemd_requires}
 +BuildRequires:​ systemd
 +
 +[...]
 +%post
 +%systemd_user_post %{name}.service
 +
 +%preun
 +%systemd_user_preun %{name}.service
 +</​file>​
 +
 +Macro details
 +
 +For details on what these macros evaluate to, refer to the following sources:
 +https://​github.com/​systemd/​systemd/​blob/​master/​src/​core/​macros.systemd.in,​
 +https://​github.com/​systemd/​systemd/​blob/​master/​src/​core/​triggers.systemd.in and
 +http://​www.freedesktop.org/​software/​systemd/​man/​daemon.html. ​