# Installing Talend Runtime as a service on systemd-based Linux systems

Available in...

* Data Fabric
* Data Services Platform
* ESB
* Qlik Talend Cloud Enterprise Edition
* Qlik Talend Cloud Premium Edition
* Real-Time Big Data Platform

## About this task

The Talend Runtime Container is based on Apache Karaf. Karaf Service Wrapper makes it possible to install the Talend Runtime Container as a service.

## Installing the wrapper

Available in...

* Data Fabric
* Data Services Platform
* ESB
* Qlik Talend Cloud Enterprise Edition
* Qlik Talend Cloud Premium Edition
* Real-Time Big Data Platform

Install the Apache Karaf Service Wrapper to generate the Talend Runtime service files.

### Procedure

1. Browse to the bin folder of the Talend Runtime installation directory, then launch the container by executing the trun file as root.
2. To install the wrapper feature, type:

   karaf@trun> feature:install wrapper

   Once installed, wrapper feature will provide wrapper:install new command in the trun, which allows you to install Talend Runtime as a service.
3. To install the service, type in the following command:

   karaf@trun> wrapper:install

   Alternatively, to register the container as a service in automatic start mode, simply type:

   karaf@trun> wrapper:install -s AUTO\_START -n TALEND-CONTAINER -d Talend-Container -D "Talend Container Service"

   where TALEND-CONTAINER is the name of the service, Talend-Container is the display name of the service and "Talend Container Service" is the description of the service.

   Here is an example of the wrapper:install command executed on Linux:
   ```
   karaf@trun()> feature:install wrapper
   karaf@trun()> wrapper:install -s AUTO_START -n TALEND-CONTAINER \
   -d Talend-Container -D "Talend Container Service"
   Creating file: <TalendRuntimePath>/bin/TALEND-CONTAINER-wrapper
   Creating file: <TalendRuntimePath>/bin/TALEND-CONTAINER-service
   Creating file: <TalendRuntimePath>/bin/TALEND-CONTAINER.service
   Creating file: <TalendRuntimePath>/etc/TALEND-CONTAINER-wrapper.conf
   Creating file: <TalendRuntimePath>/lib/libwrapper.so
   Creating file: <TalendRuntimePath>/lib/karaf-wrapper.jar
   Creating file: <TalendRuntimePath>/lib/karaf-wrapper-main.jar
   Setup complete. You may want to tweak the JVM properties in the wrapper
   configuration file:
   <TalendRuntimePath>/etc/TALEND-CONTAINER-wrapper.conf
   before installing and starting the service.
   ```

### Results

The Talend Runtime service files are generated. You can now install the Talend Runtime service.

## Installing the Talend Runtime service

Available in...

* Data Fabric
* Data Services Platform
* ESB
* Qlik Talend Cloud Enterprise Edition
* Qlik Talend Cloud Premium Edition
* Real-Time Big Data Platform

### Before you begin

In the following procedure:

* TALEND-CONTAINER is the name that was used for the -n &lt;Service Name&gt; option in the wrapper:install command.
* &lt;TalendRuntimePath&gt; is the Talend Runtime installation directory.

All the following commands must be executed with super-user privileges.

### Procedure

1. Install the service and enable it at system boot:

   systemctl enable &lt;TalendRuntimePath&gt;/bin/TALEND-CONTAINER.service
2. Start the service:

   systemctl start TALEND-CONTAINER

### Results

The service is installed and started.

You can use the following commands to manage the service:

* To stop the service: systemctl stop TALEND-CONTAINER
* To check the current service status: systemctl status TALEND-CONTAINER
* To see service activity journal: journalctl -u TALEND-CONTAINER
* To uninstall the service and disable it at system boot: systemctl disable TALEND-CONTAINER