Differences

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

--- linux_wiki:systemd_service_script [2016/11/27 00:26]
billdozor [The Service Unit File]
+++ linux_wiki:systemd_service_script [2019/05/25 23:50] (current)
@@ Line 35: / Line 35: @@
 [Service]
+Type=simple
 EnvironmentFile=/etc/myprog.d/config
 ExecStart=/usr/local/bin/myprog.sh
@@ Line 42: / Line 43: @@
 WantedBy=multi-user.target
 </code>
-  * Description => Displays near the top of output on "systemctl status myprog.service"
+  * Section: Unit
-  * After => can be any valid ".target" unit
+    * Description => Displays near the top of output on "systemctl status myprog.service"
-    * Another common use target is: After=network.target
+    * After => can be any valid systemd unit (.target, .service, etc)
-    * See all: systemctl -t target --all
+      * **Multiple units are space separated**
-  * EnvironmentFile => Configuration file to load
+      * Another common use target is: After=network.target
-  * ExecStart => Executable to start
+      * See all: systemctl -t target --all
-  * Restart => Auto restarts the program if an un-handled exit error occurs
+  * Section: Service
-  * WantedBy => If enabled, start under which target
+    * Type => The process and daemon behavior
+      * simple -> default if Type is not set, but ExecStart is. Main process specified in ExecStart line.
+      * forking -> service forks a child process and the parent process exits
+      * oneshot -> default if Type and ExecStart are not set. Process is short lived, systemd will wait for the process to exit before continuting with other units.
+      * notify -> service will issue a notification when it has finished starting. Systemd will wait before processing other units
+    * EnvironmentFile => Configuration file to load
+    * ExecStart => Executable to start
+    * Restart => Auto restarts the program if an un-handled exit error occurs
+  * Section: Install
+    * WantedBy => If enabled, start under which target
 ----
@@ Line 108: / Line 118: @@
 Jan 24 10:31:08 server1.local logger[17693]: /usr/local/bin/myprog.sh is still running...
 </code>
+----
+===== Example: Docker Compose =====
+Putting docker-compose commands into a service.
+/etc/systemd/system/docker-compose.service
+<code bash>
+[Unit]
+Description=Docker Compose Containers
+Requires=docker.service
+After=docker.service
+[Service]
+Type=oneshot
+RemainAfterExit=yes
+ExecStart=/usr/local/bin/docker-compose -f /data/docker/docker-compose.yml up -d
+ExecStop=/usr/local/bin/docker-compose -f /data/docker/docker-compose.yml down
+[Install]
+WantedBy=multi-user.target
+</code>
+----
+===== Example: Apache HTTPD Compiled =====
+Creating a service unit file for a locally compiled and installed Apache web server.
+\\
+/etc/systemd/system/httpd-local.service
+<code bash>
+[Unit]
+Description=Apache Web Server
+After=network.target remote-fs.target nss-lookup.target
+[Service]
+Type=forking
+PIDFile=/usr/local/apache2/logs/httpd.pid
+ExecStart=/usr/local/apache2/bin/apachectl start
+ExecStop=/usr/local/apache2/bin/apachectl graceful-stop
+ExecReload=/usr/local/apache2/bin/apachectl graceful
+PrivateTmp=true
+LimitNOFILE=infinity
+[Install]
+WantedBy=multi-user.target
+</code>
+\\
+Reload systemd<code bash>systemctl daemon-reload</code>
+\\
+Enable/start service<code bash>systemctl enable httpd-local
+systemctl start httpd-local</code>
+----
+====== Override File ======
+Override files are used when you want to modify part or all of a RPM/system provided systemd unit file. Use over rides instead of directly modifying system unit files, as they could be reverted upon next related package update.
+System Provided unit files: /usr/lib/systemd/system/
+===== Override Example: docker service =====
+System provided file to over ride: /usr/lib/systemd/system/docker.service
+  * Create a directory to contain the over ride file (named after the original unit file name)<code bash>mkdir /etc/systemd/system/docker.service.d/</code>
+  * Create the over ride file<code bash>/etc/systemd/system/docker.service.d/docker.conf
+[Service]
+EnvironmentFile=
+EnvironmentFile=-/etc/sysconfig/docker
+ExecStart=
+ExecStart=/usr/bin/dockerd $OPTIONS</code>
+    * Each variable with a blank assignment ('EnvironmentFile=') clears that variable. If you did not put the assignment to nothing line, the variables would be appended to the built in values.
+  * Reload the systemd daemon for the override file to be picked up<code bash>systemctl daemon-reload</code>
+  * Restart the service
+===== Override Example: rpcbind service =====
+System provided file to over ride: /usr/lib/systemd/system/rpcbind.service
+  * Create a directory to contain the over ride file (named after the original unit file name, but add a ".d" for directory)<code bash>mkdir /etc/systemd/system/rpcbind.service.d/</code>
+  * Create the over ride file (NAME.conf)<code bash>/etc/systemd/system/rpcbind.service.d/rpcbind.conf
+[Service]
+ExecStart=
+ExecStart=/sbin/rpcbind $RPCBIND_ARGS</code>
+    * Each variable with a blank assignment ('EnvironmentFile=') clears that variable. If you did not put the assignment to nothing line, the variables would be appended to the built in values.
+  * Reload the systemd daemon for the override file to be picked up<code bash>systemctl daemon-reload</code>
+  * Restart the service
 ----