Open topic with navigation

# Install an IDOL Component as a Service on Linux

On Linux operating systems, you can configure a component as a service to allow you to easily start and stop it. You can also configure the service to run when the machine boots. The following procedures describe how to install Distributed Index Handler as a service on Linux.

NOTE:

To use these procedures, you must have `root` permissions.

NOTE:

When you install Distributed Index Handler on Linux, the installer prompts you to supply a user name to use to run the server. The installer populates the init scripts, but it does not create the user in your system (the user must already exist).

The procedure that you must use depends on the operating system and boot system type.

- For Linux operating system versions that use systemd (including CentOS 7, and Ubuntu version 15.04 and later), see Install a Component as a Service for a systemd Boot System.
- For Linux operating system versions that use System V, see Install a Component as a Service for a System V Boot System.

## Install a Component as a Service for a systemd Boot System

NOTE:

If your setup has an externally mounted drive that Distributed Index Handler uses, you might need to modify the init script. The installed init script contains examples for an NFS mount requirement.

To install an IDOL component as a service

1. Run the appropriate command for your Linux operating system environment to copy the init scripts to your `init.d` directory.

   - Red Hat Enterprise Linux (and CentOS)

         cp IDOLInstallDir/scripts/init/systemd/componentname /etc/systemd/system/componentname.service

   - Debian (including Ubuntu):

         cp IDOLInstallDir/scripts/init/systemd/componentname /lib/systemd/system/componentname.service

   where `componentname` is the name of the init script that you want to use, which is the name of the component executable (without the file extension).

   For other Linux environments, refer to the operating system documentation.

2. Run the following commands to set the appropriate access, owner, and group permissions for the component:

   - Red Hat Enterprise Linux (and CentOS)

         chmod 755 /etc/systemd/system/componentname
         chown root /etc/systemd/system/componentname
         chgrp root /etc/systemd/system/componentname

   - Debian (including Ubuntu):

         chmod 755 /lib/systemd/system/componentname
         chown root /lib/systemd/system/componentname
         chgrp root /lib/systemd/system/componentname

   where `componentname` is the name of the component executable that you want to run (without the file extension).

   For other Linux environments, refer to the operating system documentation.

3. (Optional) If you want to start the component when the machine boots, run the following command:

       systemctl enable componentname

## Install a Component as a Service for a System V Boot System

To install an IDOL component as a service

1. Run the following command to copy the init scripts to your `init.d` directory.

       cp IDOLInstallDir/scripts/init/systemv/componentname /etc/init.d/

   where `componentname` is the name of the init script that you want to use, which is the name of the component executable (without the file extension).

2. Run the following commands to set the appropriate access, owner, and group permissions for the component:

       chmod 755 /etc/init.d/componentname
       chown root /etc/init.d/componentname
       chgrp root /etc/init.d/componentname

3. (Optional) If you want to start the component when the machine boots, run the appropriate command for your Linux operating system environment:

   - Red Hat Enterprise Linux (and CentOS):

         chkconfig --add componentname
         chkconfig componentname on

   - Debian (including Ubuntu):

         update-rc.d componentname defaults

   For other Linux environments, refer to the operating system documentation.

© 2018 EntIT Software LLC, a Micro Focus company | Send documentation feedback to Micro Focus Close Send documentation feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a web mail client, and send this email to swpdl.idoldocsfeedback@microfocus.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_FT_HTML5_bannerTitle.htm