Introduction:
The Red Hat JBoss Fuse console's wrapper feature
generates a wrapper around the JBoss Fuse runtime that allows you to install a
message broker as a system service. The wrapper feature does not come
preinstalled in the console, so before you can generate the service wrapper you
must install the wrapper feature.
Once the feature is installed the console gains a
wrapper:install command. Running this command generates a generic
service wrapper in the JBoss Fuse installation.
Overview:
To
generate the service wrapper:
1.
Start JBoss Fuse in
console mode using the fuse command.
2.
Once the console is
started and the command prompt appears, enter
features:install
wrapper.
The features:install command will locate the required
libraries to provision the wrapper feature and deploy it into the run time.
3.
Generate the wrapper
by entering
wrapper:install -n serviceName -d displayName -D description.
The wrapper:install command has the options described in
below table.
Table: Wrapper Install Options
|
Option
|
Default
|
Description
|
|
-s
|
AUTO_START
|
(Windows only) Specifies the mode in
which the service is installed. Valid values are AUTO_START or DEMAND_START.
|
|
-n
|
karaf
|
Specifies the service name that will be used when
installing the service.
|
|
-d
|
Specifies the display name of the service.
|
|
|
-D
|
Specifies the description of the service.
|
Generated files
The following files are generated and
make up the service wrapper:
- bin\ServiceName-wrapper[.exe]—the
executable file for the wrapper.
- bin\ServiceName-service[.bat]—the
script used to install and remove the service.
- etc\ServiceName-wrapper.conf—the
wrapper's configuration file.
- Three library files required by the service
wrapper:
- lib\libwrapper.so
- lib\karaf-wrapper.jar
- lib\karaf-wrapper-main.jar
