Skip to main content Skip to complementary content

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

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

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

Before you begin

In the following procedure:
  • TALEND-CONTAINER is the name that was used for the -n <Service Name> option in the wrapper:install command.
  • <TalendRuntimePath> 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 <TalendRuntimePath>/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

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!