Installing the wrapper

First, to install the wrapper, simply:

1. Browse to the bin folder of the Talend Runtime Container directory, then launch:

   • trun.bat in Administrator mode on Windows

   • trun as root user on Linux

2. To install the wrapper feature, simply type:

   • karaf@trun> feature:install wrapper on Windows.

   • trun@root> feature:install wrapper on Linux.

   Once installed, wrapper feature will provide wrapper:install new command in the trun:

   trun@root> wrapper:install --help
   
   DESCRIPTION
      wrapper:install
   
      Install the container as a system service in the OS.
   
   SYNTAX
      wrapper:install [options]
   
   OPTIONS
      -d, --display
         The display name of the service.
      --help
         Display this help message
   
      -s, --start-type
         Mode in which the service is installed. AUTO_START or 
         DEMAND_START (Default: AUTO_START)
         (defaults to AUTO_START)
   
      -n, --name
         The service name that will be used when installing the 
         service. (Default: Karaf)
         (defaults to karaf)
   
      -D, --description
         The description of the service.
         (defaults to null)
   

3. To set up the installation of the service, type in the following command:

   • karaf@trun> wrapper:install on Windows.

   • trun@root> wrapper:install on Linux.

   Information noteWarning:

   In Windows you may get the following message when attempting to install the service:

   wrapper  | OpenSCManager failed - Access is denied. (0x5)

   In this case launch the Command Prompt in Administrator mode. Right-click Command Prompt in the Start menu and select Run as administrator.

For instance, to register Talend Runtime Container as a service (depending on the running OS), in automatic start mode, simply type:

• For Windows:

  karaf@trun> wrapper:install -s AUTO_START -n TALEND-ESB-CONTAINER  -d Talend-ESB-Container -D "Talend ESB Container Service"

• For Linux:

  trun@root> wrapper:install -s AUTO_START -n TALEND-ESB-CONTAINER  -d Talend-ESB-Container -D "Talend ESB Container Service"

Here is an example of wrapper:install command executing on Windows (Note: this also contains instructions on how to remove the service):

karaf@trun> wrapper:install -s AUTO_START -n TALEND-ESB-CONTAINER 
-d Talend-ESB-Container  -D "Talend ESB Container Service"

Creating file: C:\work\-release\Talend-ESB-V\container\bin\
TALEND-ESB-CONTAINER-wrapper.exe
Creating file: C:\work\-release\Talend-ESB-V\container\etc\
TALEND-ESB-CONTAINER-wrapper.conf
Creating file: C:\work\-release\Talend-ESB-V\container\bin\
TALEND-ESB-CONTAINER-service.bat
Creating file: C:\work\-release\Talend-ESB-V\container\lib\
wrapper.dll
Creating file: C:\work\-release\Talend-ESB-V\container\lib\
karaf-wrapper.jar
Creating file: C:\work\-release\Talend-ESB-V\container\lib\
karaf-wrapper-main.jar

Setup complete.  You may wish to tweak the JVM properties in the 
wrapper configuration file:
        C:\work\-release\Talend-ESB-V\container\etc\TALEND-
ESB-CONTAINER-wrapper.conf
before installing and starting the service.

To install the service, run:
  C:> C:\work\-release\Talend-ESB-V\container\bin\
TALEND-ESB-CONTAINER-service.bat install

Once installed, to start the service run:
  C:> net start "TALEND-ESB-CONTAINER"

Once running, to stop the service run:
  C:> net stop "TALEND-ESB-CONTAINER"

Once stopped, to remove the installed the service run:
  C:> C:\work\-release\Talend-ESB-V\container\bin\
TALEND-ESB-CONTAINER-service.bat remove

Here is an example of wrapper:install command executing on Linux:

trun@root> wrapper:install -s AUTO_START -n TALEND-ESB-CONTAINER  \
        -d Talend-ESB-Container -D "Talend ESB Container Service"
Creating file: /home/onofreje/-release/Talend-ESB-V/container/
bin/KARAF-wrapper
Creating file: /home/onofreje/-release/Talend-ESB-V/container/
bin/KARAF-service
Creating file: /home/onofreje/-release/Talend-ESB-V/container/
etc/KARAF-wrapper.conf
Creating file: /home/onofreje/-release/Talend-ESB-V/container/
lib/libwrapper.so
Creating file: /home/onofreje/-release/Talend-ESB-V/container/
lib/karaf-wrapper.jar
Creating file: /home/onofreje/-release/Talend-ESB-V/container/
lib/karaf-wrapper-main.jar

Setup complete.  You may want to tweak the JVM properties in the wrapper 
configuration file:
        /home/onofreje/apache-karaf-2.1.3/etc/KARAF-wrapper.conf
before installing and starting the service.