3.4. Managing Services in Software Collections

Procedure 3.2. Configuring an environment for services on Red Hat Enterprise Linux 6

1. Create a configuration file in /opt/provider/software_collection/service-environment with the following content:

   [SCLNAME]_SCLS_ENABLED="software_collection"

   Copy to Clipboard Toggle word wrap
   Replace SCLNAME with a unique identifier for your Software Collection, for instance, your Software Collection's name written in capital letters.
   Replace software_collection with the name of your Software Collection as defined by the %scl_name macro.
2. Add the following line at the beginning of the SysV init script:

   source /opt/provider/software_collection/service-environment

   Copy to Clipboard Toggle word wrap
3. In the SysV init script, determine commands that run binaries located in the /opt/provider/ file system hierarchy. Prefix these commands with scl enable $[SCLNAME]_SCLS_ENABLED, similarly to when you run a command in the Software Collection environment.
   For example, replace the following line:

   /usr/bin/daemon_binary --argument-1 --argument-2

   Copy to Clipboard Toggle word wrap
   with:

   scl enable $[SCLNAME]_SCLS_ENABLED -- /usr/bin/daemon_binary --argument-1 --argument-2

   Copy to Clipboard Toggle word wrap
4. Some commands, like su or runuser, also clear environment variables. Thus, if these commands are used in the SysV init script, enable your Software Collection again after running these commands.
   For instance, replace the following line:

   su - user_name -c '/usr/bin/daemon_binary --argument-1 --argument-2'

   Copy to Clipboard Toggle word wrap
   with:

   su - user_name -c '\
     source /opt/provider/software_collection/service-environment \
     scl enable $SCLNAME_SCLS_ENABLED -- /usr/bin/daemon_binary --argument-1 --argument-2'

   Copy to Clipboard Toggle word wrap

Procedure 3.3. Configuring an environment for services on Red Hat Enterprise Linux 7

1. Create a configuration file in /opt/provider/software_collection/service-environment with the following content:

   [SCLNAME]_SCLS_ENABLED="software_collection"

   Copy to Clipboard Toggle word wrap
   Replace SCLNAME with a unique identifier for your Software Collection, for instance, your Software Collection's name written in capital letters.
   Replace software_collection with the name of your Software Collection as defined by the %scl_name macro.
2. Add the following line in the systemd service file to load the configuration file:

   EnvironmentFile=/opt/provider/software_collection/service-environment

   Copy to Clipboard Toggle word wrap
3. In the systemd service file, prefix all commands specified in ExecStartPre, ExecStart, and similar directives with scl enable $[SCLNAME]_SCLS_ENABLED, similarly to when you run a command in the Software Collection environment:

   ExecStartPre=/usr/bin/scl enable $[SCLNAME]_SCLS_ENABLED -- /opt/provider/software_collection/root/usr/bin/daemon_helper_binary --argument-1 --argument-2
   ExecStart=/usr/bin/scl enable $[SCLNAME]_SCLS_ENABLED -- /opt/provider/software_collection/root/usr/bin/daemon_binary --argument-1 --argument-2

   Copy to Clipboard Toggle word wrap