As with any application, reading through the documentation is the best
way to get started. But realizing the desire to get your feet wet
quickly, you should glance over this page to get a feel for what the
Wrapper can do.
Then to get up and running, at a minimum you will need to read over
the Summary of Integration Methods section.
There you will be presented with 4 Integration Methods. From the
overviews, choose the one that best meets your needs and then proceed
to read over the section dedicated to that Integration Method.
[For powerful features of Wrapper] :
The Wrapper provides a very large feature set.
At some point, it is suggested that you look over the
full Configuration Properties
to get a feel for the full power of the Java Service Wrapper.
[You Need Help?] :
If you run into problems or have any questions,
the preferred method for getting help is posting a message to the
Wrapper-User Mailing List.
Run a Java application as a Windows Service or UNIX Daemon
The Java Service Wrapper makes it possible to install a Java Application
as a Windows Service.
Likewise, the scripts shipped with the Wrapper also make it
very easy to install a Java Application as a Daemon process on UNIX systems.
The Wrapper correctly handles "user's log outs" under Windows,
service dependencies, and the ability to run services which interact with the desktop.
Java Application Reliability
As the use of Java expands, your applications have
been written to provide a variety of mission and critical services.
These services must be able to provide a high level of reliability.
In an ideal world, only software which is 100% bug free will ever be released and installed.
However, history has shown this not to be the case.
Almost every application suffers from quality issues at one point or
another during their life-cycle. Applications hang, crash, run out of
memory or suffer from any number of problems. Where possible, problems
are fixed quickly without significant service outages. There are times,
however, when fixing a problem can be prohibitively expensive or
impossible to solve in a short time period.
While these advanced features of Java Service Wrapper will not make every problem go away,
they will help you to sleep easier knowing that
if there is a problem, the Wrapper will be there
to keep things up and running until you can get into the office to check the logs.
Say goodbye to that emergency phone calls!!
Standard, Out of the Box Scripting
Write once run everywhere configuration. Java has been marketed as a
"Write Once, Run Everywhere" programming language. While this is true
for many aspects of an application, the developer is often plagued with
having to write complicated, platform specific scripts which are tasked
with building up class paths and collecting other system information
necessary to launch an application.
The Java Service Wrapper helps to relieve the developer of the troublesome task
by providing a set of scripts for a wide range of platforms that can be
used as is to launch and run almost any Java Application controlled by the Wrapper.
The Java Service Wrapper provides a way for a Java Application to request that
its own JVM (Java Virtual Machine) be restarted. This can be useful in a number of cases.
Applications may wish to restart after having had their configuration
files modified. Or the application may simply need to be restarted
to avoid problems with a memory or resource leak of some kind.
There are also more passive ways to trigger restarts. The Wrapper has
the ability to monitor console output
and trigger shutdowns or restarts whenever certain text is detected.
The Wrapper can also be configured to either restart another JVM instance or
shutdown normally depending on the exit code returned by a JVM.
The Java Service Wrapper provides a wide range of configuration properties which can
be used to configure the JVM (Java Virtual Machine) in any way possible
from the command line.
The Wrapper configuration file
also provides a number of properties to allow you configure things
like logging and how the Wrapper is installed as a service.
By using the Wrapper's standard scripts,
and relative paths in the configuration file
it is usually possible to create an application
which requires no further complicated installation
than simply expanding an archive file into a directory of the user's choice.
Logging the output to the JVM console
can be critical to tracking down problems with an application.
Without the Wrapper, when a JVM is being run as a Service under Windows,
or as a Daemon under UNIX, the console output would normally be lost.
The Wrapper makes sure that all console output is logged.
Java-based Logging Tools are only capable of logging output generated from within the JVM.
If the JVM crashes or prints out low level messages such as thread dumps,
there is normally no way to log it.
The Wrapper logs all console output from the JVM process
regardless of its source meaning that a record of any crash
will survive even after the Wrapper has restarted the JVM.
The Wrapper is known to work with the Sun, IBM, Blackdown and BEA WebLogic
JRockit JVMs without any problems. If you get a chance to test any other
JVMs, please be sure and let us know the results.
Java Service Wrapper version 3.4.0 or later require JVM version 1.4.x and above.
(Wrapper versions prior to 3.4.0 supported JVM versions back to 1.2.x.)
The Wrapper can be used with Java 1.2.x versions however some functions are disabled
due to this version of Java's lack of support for
Shutdown Hooks were implemented with the 1.3.0 release of Java.
Only OS versions which are known to work have been listed.
If you have had successful or unsuccessful results running on other OS versions,
please post a comment below and it will be added to the list.
It should be fairly easy to build the Wrapper from source on additional UNIX platforms.
Please let us know and we will update the list.
By Wrapper Version:
This section will keep track of the platform dependencies for the Wrapper.
After each release of a new version, we will add a new site listing the supported platforms for the Wrapper.
linux - Linux kernels; 2.2.x 2.4.x, 2.6.x.
Known to work with Debian, Ubuntu, and Red Hat, but should work with any distribution.
Currently supported on both 32-bit and 64-bit x86, Itanium, and PPC systems.
macosx - Macintosh OS X.
osf1 - DEC OSF1.
solaris - Sun OS, Solaris 9 and 10.
Currently supported on both 32-bit and 64-bit sparc, and x86 systems.
Windows - Windows 2000, XP, 2003, Vista, 2008, 2008 R2, 2012, Windows 7 and 8.
Currently supported on both 32-bit and 64-bit x86 and Itanium systems.
Also known to run on Windows 98 and ME, however due the lack of support for
services in the OS, the Wrapper can only be run in console mode.