XmlBlaster Logo

REQUIREMENT

admin.start.asService

XmlBlaster Logo


Type NEW
Priority LOW
Status CLOSED
Topic Setting up xmlBlaster to start as a service
Des
cription

XmlBlaster can now be configured to startup as either an Windows NT/2000 service or a Linux/Unix service with the help of an optional packaged called the Java Service Wrapper. This requirement will instruct you how to configure xmlBlaster with the Wrapper library.

We provide a typical example configuration in xmlBlaster/config/wrapper.conf.template

Configure

Windows NT/2000 Setup

  1. Download the Java Service Wrapper library
    You can download the library from http://wrapper.sourceforge.net. Make sure you grap the Windows version of the library. It will contain the needed executables and Dlls needed to launch xmlBlaster as a service.
  2. Copy wrapper/lib to xmlBlaster/lib
    The contents of the lib directory from the wrapper distribution should be copied to the lib directory of the xmlBlaster distribution.
  3. Copy wrapper.exe from wrapper/bin to xmlBlaster/bin
    This is the java service monitor program.
  4. Modify the wrapper.conf file
    This file is in the config subdirectory. See the documentation in the file wrapper.conf.template for instructions on how to edit it.
  5. Install the Windows service
    This is done by executing the following command:

    wrapper -i xmlBlaster/config/wrapper.conf
    or
    ..\bin\wrapper -i C:\xmlBlasterServer\conf\wrapper.conf set.XMLBLASTER_HOME=C:\xmlBlasterServer
  6. From the control panel, start the xmlBlaster service

Linux Setup

  1. Download the Java Service Wrapper library
    You can download the library from http://wrapper.sourceforge.net. Make sure you grap the Linux version of the library. It will contain the needed executables and shared libraries needed to launch xmlBlaster as a service.
  2. Copy wrapper/lib to xmlBlaster/lib
    The contents of the lib directory from the wrapper distribution should be copied to the lib directory of the xmlBlaster distribution.
  3. Copy wrapper from wrapper/bin to xmlBlaster/bin
    This is the java service monitor program.
  4. Modify the wrapper.conf file
    This file is in the config subdirectory. See the documentation in this file for instructions on how to edit it.

NOTE

As a service may not read from System.in() you need to configure xmlBlaster to not check for keyboard input with

-useKeyboard false

NOTE: Configuration parameters are specified on command line (-someValue 17) or in the xmlBlaster.properties file (someValue=17). See requirement "util.property" for details.
Columns named Impl tells you if the feature is implemented.
Columns named Hot tells you if the configuration is changeable in hot operation.

See http://wrapper.sourceforge.net

This page is generated from the requirement XML file xmlBlaster/doc/requirements/admin.start.asService.xml

Back to overview