# 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.
```