{"id":11564,"date":"2025-08-18T01:02:00","date_gmt":"2025-08-18T05:02:00","guid":{"rendered":"https:\/\/www.both.org\/?p=11564"},"modified":"2025-08-17T11:32:44","modified_gmt":"2025-08-17T15:32:44","slug":"manage-multiple-service-instances-with-systemctl","status":"publish","type":"post","link":"https:\/\/www.both.org\/?p=11564","title":{"rendered":"Manage multiple service instances with systemctl"},"content":{"rendered":"
\r\n
\r\n \r\n <\/i>\r\n <\/a>\r\n 2 <\/span>\r\n<\/div><\/div>\n

Services, services, services. A service is a huge part of computing. You’re reading this article on a service. Your computer is running services. The internet is filled with them.<\/p>\n\n\n\n

About systemctl<\/h2>\n\n\n\n

On Linux, the standard way of running and managing services is through the systemd utility and the command systemctl. Its usage is fairly simple: you just need to know the name of the service you want to manage, then you can use this command to start or stop the service, check its status, or do other functions:<\/p>\n\n\n\n

# systemctl start httpd

# systemctl stop httpd

# systemctl status httpd
<\/pre>\n\n\n\n
Unit files<\/h2>\n\n\n\n
A service is defined in a file called a unit file. They are generally located in the directory \/usr\/lib\/systemd\/system. Here’s a sample list:<\/p>\n\n\n\n
# ls \/usr\/lib\/systemd\/system
 auditd.service                multi-user.target                    sys-kernel-debug.mount
 autovt@.service               multi-user.target.wants              sys-kernel-tracing.mount
 basic.target                  NetworkManager-dispatcher.service    syslog.socket
 basic.target.wants            NetworkManager.service               syslog.target.wants
 blk-availability.service      NetworkManager-wait-online.service<\/pre>\n\n\n\n
Sometimes you need to run more than one instance of a service on a single host. For example, if you are maintaining websites for several clients, security regulations demand that each client has its own individual instance. This means you need to run a new Apache HTTP service for each, but having a lot of services can be tough to manage. If you have 10 different customers, you would have to create 10 separate unit files to manage them. Fortunately, there is a better way to handle multiple instances of a service.<\/p>\n\n\n\n
The @ symbol<\/h2>\n\n\n\n
Notice that some of the unit files have an @<\/strong> symbol in their name. This symbol has an interesting significance. As a matter of fact, after installing Apache HTTP Server, you may notice several service unit files, including one that has the @<\/strong> symbol in its name\u2014httpd@.service.<\/p>\n\n\n\n
I will show you how this can make a system administrator’s life a little easier, using the Apache HTTP Server for this example:<\/p>\n\n\n\n
# dnf -y install httpd

# cd \/usr\/lib\/systemd\/system
# ls -d http*
httpd.service  httpd@.service  httpd.service.d  httpd.socket  httpd.socket.d<\/pre>\n\n\n\n
The @<\/strong> symbol indicates that a substitution will be made. systemd will take whatever you type after it and replace the variable %i<\/strong> inside the service unit file. The variable can be seen in this excerpt of the httpd@.service file:<\/p>\n\n\n\n
[Unit]
Description=The Apache HTTP Server
After=network.target remote-fs.target nss-lookup.target
Documentation=man:httpd@.service(8)

[Service]
Type=notify
Environment=LANG=C
Environment=HTTPD_INSTANCE=%i
ExecStartPre=\/bin\/mkdir -m 710 -p \/run\/httpd\/instance-%i
ExecStartPre=\/bin\/chown root.apache \/run\/httpd\/instance-%i
ExecStartPre=\/bin\/mkdir -m 700 -p \/var\/lib\/httpd\/instance-%i
ExecStartPre=\/bin\/chown apache.apache \/var\/lib\/httpd\/instance-%i
ExecStart=\/usr\/sbin\/httpd $OPTIONS -DFOREGROUND -f conf\/%i.conf
ExecReload=\/usr\/sbin\/httpd $OPTIONS -k graceful -f conf\/%i.conf<\/pre>\n\n\n\n
Note that the default httpd unit file, httpd.service, does not have the @ symbol in its name and looks different. It is used for a single basic default instance of the Apache HTTP server.<\/p>\n\n\n\n
Run multiple instances<\/h2>\n\n\n\n
To run multiple instances using this special unit file, each one needs a unique name. Suppose you have two clients, The Little Bank and The Big Bank. Name the instances littlebank<\/em> and bigbank<\/em>. To manage one, just append its name after the @<\/strong> symbol. Start each instance with the appropriate command:<\/p>\n\n\n\n
    \n
  • littlebank<\/strong>: systemctl start httpd@littlebank<\/li>\n\n\n\n
  • bigbank<\/strong>: systemctl start httpd@bigbank<\/li>\n<\/ul>\n\n\n\n
    Keep in mind that most services need certain configurations to avoid conflicts between different instances. I will not cover all of them here, but Apache needs several things, including unique listen port numbers, PID files, and document roots.<\/p>\n\n\n\n
    I’ll demonstrate by trying to start the littlebank instance. I expect it to fail, but it will provide a useful status message:<\/p>\n\n\n\n
    # systemctl start httpd@littlebank

    # systemctl status httpd@littlebank
    \u25cf httpd@littlebank.service - The Apache HTTP Server
         Loaded: loaded (\/usr\/lib\/systemd\/system\/httpd@.service; disabled; vendor preset: disabled)
         Active: failed (Result: exit-code) since Tue 2020-11-10 11:41:20 EST; 1min 58s ago
           Docs: man:httpd@.service(8)
        Process: 2205 ExecStartPre=\/bin\/mkdir -m 710 -p \/run\/httpd\/instance-littlebank (code=exited, status=0\/SUCCESS)
        Process: 2207 ExecStartPre=\/bin\/chown root.apache \/run\/httpd\/instance-littlebank (code=exited, status=0\/SUCCESS)
        Process: 2208 ExecStartPre=\/bin\/mkdir -m 700 -p \/var\/lib\/httpd\/instance-littlebank (code=exited, status=0\/SUCCESS)
        Process: 2209 ExecStartPre=\/bin\/chown apache.apache \/var\/lib\/httpd\/instance-littlebank (code=exited, status=0\/SUCCESS)
        Process: 2210 ExecStart=\/usr\/sbin\/httpd $OPTIONS -DFOREGROUND -f conf\/littlebank.conf (code=exited, status=1\/FAILURE)
       Main PID: 2210 (code=exited, status=1\/FAILURE)
            CPU: 26ms

    Nov 10 11:41:20 localhost.localdomain systemd[1]: Starting The Apache HTTP Server...
    Nov 10 11:41:20 localhost.localdomain httpd[2210]: httpd: Could not open configuration file \/etc\/httpd\/conf\/littlebank.conf>
    Nov 10 11:41:20 localhost.localdomain systemd[1]: httpd@littlebank.service: Main process exited, code=exited, status=1\/FAIL>
    Nov 10 11:41:20 localhost.localdomain systemd[1]: httpd@littlebank.service: Failed with result 'exit-code'.
    Nov 10 11:41:20 localhost.localdomain systemd[1]: Failed to start The Apache HTTP Server.<\/pre>\n\n\n\n
    You can see that systemd correctly substitutes the instance name in place of the %i<\/strong> variable in the unit file. However, Apache fails to start because it could not open a configuration file. So, now I’ll set up the instances to include creating the necessary configuration files (littlebank.conf<\/em> and bigbank.conf<\/em>) in \/etc\/httpd\/conf\/:<\/p>\n\n\n\n
    # ls \/etc\/httpd\/conf
    bigbank.conf  httpd.conf  littlebank.conf<\/pre>\n\n\n\n
    Now you can manage each instance with systemctl<\/strong>. Issue start<\/strong> and status<\/strong> commands to each. I’ve shortened the output to the most relevant details:<\/p>\n\n\n\n
    # systemctl start httpd@bigbank
    # systemctl start httpd@littlebank

    # systemctl status httpd@bigbank
    \u25cf httpd@bigbank.service - The Apache HTTP Server
         Loaded: loaded (\/usr\/lib\/systemd\/system\/httpd@.service; disabled; vendor preset: disabled)
         Active: active (running) since Tue 2020-11-10 12:26:06 EST; 56min ago
         
    # systemctl status httpd@littlebank
    \u25cf httpd@littlebank.service - The Apache HTTP Server
         Loaded: loaded (\/usr\/lib\/systemd\/system\/httpd@.service; disabled; vendor preset: disabled)
         Active: active (running) since Tue 2020-11-10 12:25:58 EST; 55min ago<\/pre>\n\n\n\n
    Here is the process view of these instances. There is more than one because Apache is forking server processes, which it normally does:<\/p>\n\n\n\n
    # pgrep -a httpd
    2834 \/usr\/sbin\/httpd -DFOREGROUND -f conf\/littlebank.conf
    2835 \/usr\/sbin\/httpd -DFOREGROUND -f conf\/littlebank.conf
    2836 \/usr\/sbin\/httpd -DFOREGROUND -f conf\/littlebank.conf
    3061 \/usr\/sbin\/httpd -DFOREGROUND -f conf\/bigbank.conf
    3062 \/usr\/sbin\/httpd -DFOREGROUND -f conf\/bigbank.conf
    3064 \/usr\/sbin\/httpd -DFOREGROUND -f conf\/bigbank.conf<\/pre>\n\n\n\n
    Put it to use<\/h2>\n\n\n\n
    This small systemd feature is very useful when you need many instances of a service. I hope you will be able to put it to good use in your work.<\/p>\n\n\n\n
    <\/p>\n","protected":false},"excerpt":{"rendered":"
    2 Services, services, services. A service is a huge part of computing. You’re reading this article on a<\/p>\n","protected":false},"author":429,"featured_media":11572,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_lmt_disableupdate":"no","_lmt_disable":"","footnotes":""},"categories":[482,100,5,89,160],"tags":[259,269,242],"class_list":["post-11564","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-advanced","category-command-line","category-linux","category-system-administration","category-systemd","tag-httpd","tag-service-unit","tag-systemctl"],"modified_by":"David Both","_links":{"self":[{"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/posts\/11564","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/users\/429"}],"replies":[{"embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=11564"}],"version-history":[{"count":4,"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/posts\/11564\/revisions"}],"predecessor-version":[{"id":11576,"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/posts\/11564\/revisions\/11576"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=\/wp\/v2\/media\/11572"}],"wp:attachment":[{"href":"https:\/\/www.both.org\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=11564"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=11564"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.both.org\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=11564"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}