Talend Runtime

Talend Open Studio for ESB Installation and Upgrade Guide

EnrichVersion
6.1
EnrichProdName
Talend Open Studio for ESB
task
Installation and Upgrade

The Talend Runtime container is based on Apache Karaf. Karaf Wrapper (for service wrapper) makes it possible to install the Talend Runtime container as a Windows Service.

To install Talend Runtime as a service, you first have to install the wrapper, which is an optional feature:

Installing the wrapper

  1. Browse to the container/bin folder of the Talend Runtime installation directory, then launch the container by executing the trun file as a root user.

  2. To install the wrapper feature, simply type:

    trun@root> 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:

    trun@root> wrapper:install

    The main commands used to manage your service are displayed in the console.

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

    trun@root> 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 wrapper:install command executing on Linux:

    trun@root> 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>/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.

The wrapper files are installed, you now have to install the Talend Runtime service.

Note

In the following procedure, TALEND-CONTAINER is the name of the service and is only given as an example. Note also that <TalendRuntimePath> is the Talend Runtime installation directory.

Subsequently, the way the service is installed depends upon your flavor of Linux:

Installing the service on Redhat/Fedora/CentOS Systems

  • To install the service:

    $ ln -s /<TalendRuntimePath>/bin/TALEND-CONTAINER-service /etc/init.d/

    $ chkconfig TALEND-CONTAINER-service --add

  • To start the service when the machine is rebooted:

    $ chkconfig TALEND-CONTAINER-service on

  • To disable starting the service when the machine is rebooted:

    $ chkconfig TALEND-CONTAINER-service off

  • To start the service:

    $ service TALEND-CONTAINER-service start

  • To stop the service:

    $ service TALEND-CONTAINER-service stop

  • To uninstall the service:

    $ chkconfig TALEND-ESB-CONTAINER-service --del

    $ rm /etc/init.d/TALEND-CONTAINER-service

Installing the service on Linux Ubuntu distributions

  • To install the service:

    $ ln -s /<TalendRuntimePath>/bin/ TALEND-CONTAINER-service /etc/init.d/

  • To start the service when the machine is rebooted:

    $ update-rc.d TALEND-CONTAINER-service defaults

  • To disable starting the service when the machine is rebooted:

    $ update-rc.d -f TALEND-CONTAINER-service remove

  • To start the service:

    $ /etc/init.d/TALEND-CONTAINER-service start

  • To stop the service:

    $ /etc/init.d/TALEND-CONTAINER-service stop

  • To uninstall the service:

    $ rm /etc/init.d/TALEND-CONTAINER-service