hank-test/quick-docs
1
0
Fork 0
mirror of https://pagure.io/fedora-docs/quick-docs.git synced 2024-11-24 21:35:17 +00:00
Code Issues 1 Projects Releases Packages Wiki Activity Actions

use systemctl edit to modify units

Browse source
This commit is contained in:
Christopher Engelhard 2020-08-05 18:44:28 +02:00 committed by lcts
parent 625e746763
commit 9ded02053a
1 changed files with 15 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

24
modules/ROOT/pages/_partials/proc_modifying-existing-systemd-services.adoc
View file

@ -1,7 +1,7 @@
[#modifying-existing-systemd-services]
= Modifying existing systemd services
This example shows how to modify an existing service. The files for service modification are stored in a directory within `/etc/systemd/system`. This directory is named after the service. For example, this procedure modifies the `httpd` service.
This example shows how to modify an existing service. Service modification are stored within `/etc/systemd/system`, in a single file or in a subdirectory named after the service. For example, this procedure modifies the `httpd` service.
[discrete]
== Prerequisites
@ -13,17 +13,13 @@ This example shows how to modify an existing service. The files for service modi
[discrete]
== Procedure
. Create a directory for the service modification in the following format: `[SERVICE NAME].service.d`. For example, the directory for the `httpd.service` modification is `httpd.service.d`:
. _Systemd_ services can be modified using the `systemctl edit` command.
+
----
# mkdir /etc/systemd/system/httpd.service.d/
# systemctl edit httpd.service
----
. Create a configuration file within this directory:
+
----
# vi /etc/systemd/system/httpd.service.d/custom.conf
----
This creates an override file `/etc/systemd/system/httpd.service.d/override.conf` and opens it in your text editor. Anything you put into this file will be *added* to the existing service file.
. Add your custom configuration. For example:
+
@ -32,8 +28,16 @@ This example shows how to modify an existing service. The files for service modi
Restart=always
RestartSec=30
----
+
To replace an option that can be set multiple times, it must cleared first, otherwise the override file will add the option a second time.
+
----
[Service]
ExecStart=
ExecStart=<new command>
----
. Save the file.
. Save the file. _Systemd_ automatically loads the new service configuration.
. Restart the `httpd` service:
+
@ -41,6 +45,8 @@ RestartSec=30
# systemctl restart httpd
----
To completely replace (instead of just add to/modify) an existing service file, use `systemctl edit --full`, e.g. `systemctl edit --full httpd.service`. This will create `/etc/systemctl/system/httpd.service`, which will be used instead of the existing service file.
[discrete]
== Related Information