Installing Talend Runtime as a service

Talend ESB Installation Guide for Solaris

EnrichVersion
6.3
EnrichProdName
Talend 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 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 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 wrapper:install command executing on Solaris:

    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>/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.

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.

Installing the service

  1. Open a terminal with root privileges.

  2. Create a Solaris manifest using the following command:

    vi /var/svc/manifest/application/talend-container.xml

  3. Add the following content to the talend-container manifest:

    <?xml version="1.0"?>
    <!DOCTYPE service_bundle SYSTEM "/usr/share/lib/xml/dtd/service_bundle.dtd.1">
    <service_bundle type='manifest' name='talendcontainer'>
    <service
    name='application/talend-container'
    type='service'
    version='1'>
    <create_default_instance enabled='true' />
    <single_instance/>
    <exec_method
    type='method'
    name='start'
    exec='su - talend <TalendRuntimePath>/bin/TALEND-CONTAINER-service start'
    timeout_seconds='150'
    />
    <exec_method
    type='method'
    name='stop'
    exec='su - talend <TalendRuntimePath>/bin/TALEND-CONTAINER-service stop'
    timeout_seconds='150' />
    <template>
    <common_name>
    <loctext xml:lang='C'>
    Talend Runtime
    </loctext>
    </common_name>
    <documentation>
    <manpage title='Talend Runtime section='5'
    />
    <doc_link name='talend.com'
    uri='http://talend.com'/>
    </documentation>
    </template>
    </service>
    </service_bundle>

  4. Import the manifest configuration using the following command:

    svccfg import /var/svc/manifest/application/talend-container.xml

  5. Check the configuration using the following command:

    svcs | grep container

    If the service is successfully installed, the result should be similar to the following:

    online 7:09:16 svc:/application/talend-container:default