geronimo-scm mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jdil...@apache.org
Subject svn commit: r507826 [20/26] - in /geronimo/sandbox/build-support/libraries/jsw: ./ 3.2.3/ 3.2.3/bin/ 3.2.3/conf/ 3.2.3/doc/ 3.2.3/doc/english/ 3.2.3/doc/english/images/ 3.2.3/doc/english/style/ 3.2.3/jdoc/ 3.2.3/lib/ 3.2.3/logs/ 3.2.3/src/ 3.2.3/src/bi...
Date Thu, 15 Feb 2007 05:48:58 GMT
Added: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-use-system-time.html
URL: http://svn.apache.org/viewvc/geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-use-system-time.html?view=auto&rev=507826
==============================================================================
--- geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-use-system-time.html (added)
+++ geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-use-system-time.html Wed Feb 14 21:48:50 2007
@@ -0,0 +1,709 @@
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Java Service Wrapper - wrapper.use_system_time Property</title>
+<style media="all" type="text/css">
+            @import url("./style/wrapper.css");
+        </style>
+</head>
+<body bgcolor="#eeeeff" marginheight="0" marginwidth="0" leftmargin="0" topmargin="0" alink="#023264" vlink="#023264" link="#525D76" text="#000000">
+<map name="wrapperLogo">
+<area href="http://wrapper.tanukisoftware.org" coords="90,90,88" shape="circle">
+</map>
+<map name="wrapperTitle">
+<area href="http://www.tanukisoftware.com" coords="28,32,176,48" shape="rect">
+</map>
+<table cellpadding="0" cellspacing="0" width="100%" border="0">
+<tr>
+<td valign="top" width="180">
+<table cellpadding="0" cellspacing="0" width="100%" border="0">
+<tr>
+<td width="180"><img usemap="#wrapperLogo" border="0" height="180" width="180" src="images/WrapperLogo.png"></td>
+</tr>
+<tr>
+<td>
+<table cellpadding="4" cellspacing="0" width="100%" border="0">
+<tr>
+<td nowrap="true">
+<div id="menu">
+<script language="JavaScript">//@@MENU_TOP@@</script>
+<div>
+<b>Essentials</b>
+<div>
+<a href="introduction.html">Introduction</a>
+</div>
+<div>
+<a href="integrate.html">Integration Methods</a>
+</div>
+<div>
+<a href="properties.html">Configuration Properties</a>
+</div>
+<div>
+<a href="launch.html">Launching Your Application</a>
+</div>
+<div>
+<b>
+                        &gt;&gt;
+                        <a href="donate.html">Show Your Support</a>
+                        &lt;&lt;
+                    </b>
+</div>
+<div>
+<a href="sponsors.html">Sponsors</a>
+</div>
+</div>
+<div>
+<b>Documentation</b>
+<div>
+<a href="jmx.html">JMX Control</a>
+</div>
+<div>
+<a href="security-model.html">Security Model</a>
+</div>
+<div>
+<a href="example.html">Feature Examples</a>
+</div>
+<div>
+<a href="debugging.html">Debugging Your Application</a>
+</div>
+<div>
+<a href="troubleshooting.html">Troubleshooting</a>
+</div>
+<div>
+<a href="faq.html">FAQ</a>
+</div>
+<div>
+<a href="release-notes.html">Release Notes</a>
+</div>
+<div>
+<a href="history.html">Project History</a>
+</div>
+<div>
+<a href="javadocs.html">Javadocs API</a>
+</div>
+<div>
+<a href="buttons.html">Buttons</a>
+</div>
+<div>
+<a href="authors.html">Authors</a>
+</div>
+<div>
+<a href="license.html">License</a>
+</div>
+</div>
+<div>
+<b>Download</b>
+<div>
+<a href="http://sourceforge.net/project/showfiles.php?group_id=39428&package_id=31591">Binaries</a>
+</div>
+<div>
+<a href="http://sourceforge.net/project/showfiles.php?group_id=39428&package_id=33658">Source Code</a>
+</div>
+</div>
+<div>
+<b>Get Involved</b>
+<div>
+<a href="http://sourceforge.net/projects/wrapper/">Source Forge</a>
+</div>
+<div>
+<a href="http://svn.sourceforge.net/viewvc/wrapper/">Subversion Repository</a>
+</div>
+<div>
+<a href="http://sourceforge.net/tracker/?group_id=39428">Issue Tracking</a>
+</div>
+<div>
+<a href="http://sourceforge.net/mail/?group_id=39428">Mailing Lists and Archives</a>
+</div>
+<div>
+<a href="http://sourceforge.net/forum/?group_id=39428">Forums (Old)</a>
+</div>
+</div>
+</div>
+<script language="JavaScript">//@@MENU_BOTTOM@@</script>
+<p>
+<b>Hosted by:</b>
+<br>
+<a href="http://sourceforge.net/projects/wrapper/"><img alt="SourceForge" border="0" height="31" width="88" src="http://sourceforge.net/sflogo.php?group_id=39428"></a>
+<br>
+</p>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+</td><td valign="top" width="*">
+<table cellpadding="0" cellspacing="0" width="100%" border="0">
+<tr>
+<td colspan="3"><img height="4" src="images/spacer.gif"></td>
+</tr>
+<tr>
+<td align="center" height="90" colspan="2"><a href="http://wrapper.tanukisoftware.org"><img border="0" height="90" width="728" src="images/OfflineAd728x90.png"></a></td><td rowspan="5"><img width="4" src="images/spacer.gif"></td>
+</tr>
+<tr>
+<td height="49" width="435"><img usemap="#wrapperTitle" border="0" height="49" width="435" src="images/WrapperTitle.png"></td><td valign="bottom" align="right" width="*"><a href="donate.html"><img border="0" height="16" width="300" src="images/DonationRequest.png"></a></td>
+</tr>
+<tr>
+<td height="4" colspan="2"><img height="4" width="500" src="images/BorderTop.png"></td>
+</tr>
+<tr>
+<td colspan="2">
+<table cellspacing="0" cellpadding="0" width="100%" border="0">
+<tr>
+<td valign="top" width="4"><img height="496" width="4" src="images/BorderLeft.png"></td><td bgcolor="#ffffff" valign="top" width="*" colspan="2">
+<table cellpadding="4" cellspacing="0" width="100%" border="0">
+<tr>
+<td nowrap="true" align="center"><font zcolor="#115b77" color="#8888aa" size="5"><b>wrapper.use_system_time Property</b></font></td>
+</tr>
+<tr>
+<td>
+<title>wrapper.use_system_time Property</title>
+    
+    
+<a name="N10009"></a>
+<table cellpadding="2" cellspacing="0" width="100%" border="0">
+<tr>
+<td bgcolor="#8888aa" class="sectionheader1" width="*"><font color="#eeeeee" size="4"><b>Configuration Property Overview</b></font></td>
+</tr>
+<tr>
+<td><img height="4" width="1" src="./images/spacer.gif"></td>
+</tr>
+<tr>
+<td>
+        
+        
+<ul>
+            
+<li>
+                
+<a href="properties.html">Configuration Property Overview</a>
+            
+</li>
+            
+<li>
+                
+<a href="props-advanced.html">Advanced Properties</a>
+            
+</li>
+            
+<li>
+                
+<a href="properties.html#name">Property List by Name</a>
+            
+</li>
+        
+</ul>
+    
+</td>
+</tr>
+</table>
+    
+<a name="N10027"></a>
+<table cellpadding="2" cellspacing="0" width="100%" border="0">
+<tr>
+<td bgcolor="#8888aa" class="sectionheader1" width="*"><font color="#eeeeee" size="4"><b>wrapper.use_system_time</b></font></td>
+</tr>
+<tr>
+<td><img height="4" width="1" src="./images/spacer.gif"></td>
+</tr>
+<tr>
+<td>
+        
+        
+<p>
+            Controls how the Wrapper internally manages the passage of time
+            and scheduling of events.  If <a href="#use-true">true</a>
+            then the Wrapper will make use of the system time for all internal
+            timekeeping functions.  Setting it to <a href="#use-false">false</a>
+            will cause the Wrapper to make use of a background timer thread
+            which keeps time by incrementing a "tick" counter.  Defaults to false.
+        </p>
+        
+<table cellspacing="0" cellpadding="0" width="100%" border="0" class="listing">
+<tr>
+<td class="listingcaption"><i>Example:</i></td>
+</tr>
+<tr>
+<td bgcolor="#eeeeee" class="listingcell"><font color="#444444">
+<pre class="listingpre">wrapper.use_system_time=FALSE</pre>
+</font></td>
+</tr>
+</table>
+        
+<p>
+            Each value of this property has advantages in certain situations.
+        </p>
+        
+<div class="note">
+<table cellspacing="0" cellpadding="2" width="100%" border="0">
+<tr>
+<td nowrap="nowrap" valign="top">
+<p class="notelabel">
+<font color="#0000a0"><b>NOTE MEG</b></font>
+</p>
+</td><td><img width="10" src="images/spacer.gif"></td><td bgcolor="#bbbbdd" class="notebody"><font color="#222260">
+            
+<p>
+                
+<a href="prop-restart-reload-configuration.html">Reloading</a>
+                the Wrapper configuration will have no effect on the value of this property.
+                Changes will not take effect until the Wrapper has been restarted.  The threshold
+                properties described below can be updated.
+            </p>
+        
+</font></td>
+</tr>
+</table>
+</div>
+        
+<a name="use-true"></a>
+<table cellpadding="2" cellspacing="0" width="100%" border="0">
+<tr>
+<td rowspan="3" width="10"><img height="1" width="10" src="./images/spacer.gif"></td><td bgcolor="#9999bb" class="sectionheader2" width="*"><font color="#eeeeee" size="3"><b>wrapper.use_system_time=true (System time)</b></font></td>
+</tr>
+<tr>
+<td><img height="4" width="1" src="./images/spacer.gif"></td>
+</tr>
+<tr>
+<td>
+            
+            
+<p>
+                Historically, the Wrapper has always used the system time for internal
+                timekeeping.  In the majority of cases this works perfectly.  However
+                there are a few cases where this will fail or the Wrapper does not do
+                what may be expected:
+            </p>
+            
+<ul>
+                
+<li>
+                    
+<p>
+                        If the Wrapper is in a situation where it is competing for CPU with
+                        other processes that are operating at a higher priority, it is
+                        possible that the Wrapper and/or its JVM will not get any CPU cycles
+                        for long periods of time.  The Wrapper has always handled these
+                        cases by using logic that detects such situations and extends
+                        any affected timeouts appropriately.  In rare cases however, the
+                        Wrapper will falsely think that the JVM has become frozen and
+                        restart it.
+                    </p>
+                
+</li>
+                
+<li>
+                    
+<p>
+                        System time changes.  If the system time is set forward or backward
+                        by more than a few seconds while the Wrapper is running, one or more
+                        of its timeouts could be triggered, resulting in an unintended JVM
+                        restart.  In most cases, the Wrapper will handle time changes as
+                        if the process had been starved of CPU.  But there are cases were
+                        this will fail.
+                    </p>
+                    
+<p>
+                        In general, setting the clock forward works correctly.  A message will
+                        be displayed in the console notifying the user that the Wrapper did
+                        not receive any CPU for x seconds.  But the Wrapper will continue to
+                        function correctly.
+                    </p>
+                    
+<p>
+                        Setting the system time backwards however can cause a number of
+                        problems depending on exactly what state the Wrapper is in when
+                        it happens.  Internally, the Wrapper schedules events at specific
+                        future points in time when operations like pinging, or launching
+                        a new JVM should take place.   If the time is set back by an hour
+                        then an operation that was scheduled to take place after 5 seconds
+                        will not happen for an hour and 5 seconds.  If the timing of this
+                        is perfect then the Wrapper may stop pinging the JVM and the JVM
+                        will respond to a lack of pings by initiating a JVM restart.
+                    </p>
+                    
+<div class="note">
+<table cellspacing="0" cellpadding="2" width="100%" border="0">
+<tr>
+<td nowrap="nowrap" valign="top">
+<p class="notelabel">
+<font color="#0000a0"><b>NOTE MEG</b></font>
+</p>
+</td><td><img width="10" src="images/spacer.gif"></td><td bgcolor="#bbbbdd" class="notebody"><font color="#222260">
+                        
+<p>Day light savings time</p>
+                        
+<p>
+                            The Wrapper will not work correctly during day light savings
+                            time.  If you live in a country which likes to change the time
+                            every spring and fall then it is recommended that you use the
+                            tick timer to avoid timeouts.
+                        </p>
+                        
+<p>
+                            As described above, you may get a single JVM restart either in
+                            the spring or fall as the system time is adjusted.  Once the
+                            JVM has been restarted however your application should continue
+                            to function correctly.
+                        </p>
+                    
+</font></td>
+</tr>
+</table>
+</div>
+                
+</li>
+                
+<li>
+                    
+<p>
+                        System suspend and resume.  If the Wrapper is being used on a system
+                        that can be suspended to disk or ram for long periods of time, the
+                        system time will appear to have jumped forward when the machine is
+                        resumed.  Other than a console message, this works correctly.
+                    </p>
+                
+</li>
+            
+</ul>
+        
+</td>
+</tr>
+</table>
+        
+<a name="use-false"></a>
+<table cellpadding="2" cellspacing="0" width="100%" border="0">
+<tr>
+<td rowspan="3" width="10"><img height="1" width="10" src="./images/spacer.gif"></td><td bgcolor="#9999bb" class="sectionheader2" width="*"><font color="#eeeeee" size="3"><b>wrapper.use_system_time=false (Timer thread)</b></font></td>
+</tr>
+<tr>
+<td><img height="4" width="1" src="./images/spacer.gif"></td>
+</tr>
+<tr>
+<td>
+            
+            
+<p>
+                As of version 3.1.0, a new timer mechanism was added to the Wrapper.
+                This new timer was made the default in version 3.2.0.
+                Rather than keeping time by querying the system clock, the Wrapper
+                creates a background thread which enters a light weight loop and
+                increments an internal "tick" counter.  Internally all timekeeping
+                has been modified to be based on these "ticks".  (If the system time
+                is being used then the tick count at any particular moment is
+                calculated from the system time rather than from the counter.)
+            </p>
+            
+<p>
+                This has turned out to have a number of advantages:
+            </p>
+            
+<ul>
+                
+<li>
+                    
+<p>
+                        The Wrapper is no longer affected by changes to the system
+                        time, either forward or backwards.  This guarantees that the
+                        Wrapper will behave correctly when the time is adjusted for
+                        day light savings time or other adjustments.
+                    </p>
+                
+</li>
+                
+<li>
+                    
+<p>
+                        When a suspended system is resumed, the Wrapper continues
+                        on where it left off without any problems.
+                    </p>
+                
+</li>
+                
+<li>
+                    
+<p>
+                        The Wrapper handles cases where it is running in a CPU
+                        starved state reliably because the tick count is incremented
+                        at a rate that reflects the amount of CPU being received,
+                        rather than being absolute.  This means that timeouts due
+                        to high loads are very unlikely.
+                    </p>
+                    
+<p>
+                        In extreme cases, if the Wrapper receives some CPU but the
+                        JVM is completely starved, or vica versa, timeouts will
+                        still be possible.  The two processes always operate at
+                        the exact same priority, however, so this is very unlikely.
+                    </p>
+                
+</li>
+            
+</ul>
+            
+<p>
+                There are, however, some disadvantages to using a "tick" counter for
+                timekeeping:
+            </p>
+            
+<ul>
+                
+<li>
+                    
+<p>
+                        The tick timer requires that an additional thread be allocated
+                        within the native Wrapper.  This results in a slight increase
+                        in the resources needed to run the Wrapper.
+                    </p>
+                    
+<p>
+                        The Java side of the Wrapper makes use of a thread that was
+                        already being used to check for system signals so there is
+                        no increase in resources on the Java side.
+                    </p>
+                
+</li>
+                
+<li>
+                    
+<p>
+                        At anything less than 100% CPU load, the timer threads will
+                        always get just enough CPU to increment their counts and be
+                        temporally accurate.  But when the system is running at 100%
+                        CPU, the thread will not be able to loop at full speed
+                        resulting in the count being incremented more slowly.  In
+                        most cases, this is actually a good thing.  However it will
+                        cause operations like the ping interval to be inconsistent
+                        at times, so must be kept in mind.
+                    </p>
+                
+</li>
+            
+</ul>
+        
+</td>
+</tr>
+</table>
+        
+<a name="N100BA"></a>
+<table cellpadding="2" cellspacing="0" width="100%" border="0">
+<tr>
+<td rowspan="3" width="10"><img height="1" width="10" src="./images/spacer.gif"></td><td bgcolor="#9999bb" class="sectionheader2" width="*"><font color="#eeeeee" size="3"><b>Timer Debug properties</b></font></td>
+</tr>
+<tr>
+<td><img height="4" width="1" src="./images/spacer.gif"></td>
+</tr>
+<tr>
+<td>
+            
+            
+<p>
+                The wrapper also implements a pair of properties that are useful
+                for monitoring when either the JVM or Wrapper timer threads gain
+                or lose time relative to the system clock.  They were mainly
+                implemented for debugging purposes, but can provide very useful
+                information about the state of the system.  They are described
+                here rather than on their own page as they have no meaning outside
+                this context.
+            </p>
+            
+<a name="prop-timer-slow-threshold"></a>
+<table cellpadding="2" cellspacing="0" width="100%" border="0">
+<tr>
+<td rowspan="3" width="10"><img height="1" width="10" src="./images/spacer.gif"></td><td bgcolor="#aaaacc" class="sectionheader3" width="*"><font color="#eeeeee" size="2"><b>wrapper.timer_slow_threshold</b></font></td>
+</tr>
+<tr>
+<td><img height="4" width="1" src="./images/spacer.gif"></td>
+</tr>
+<tr>
+<td>
+                
+                
+<p>
+                    The wrapper.timer_slow_threshold
+                    property will display a message to the log whenever the "tick"
+                    timer falls behind the system time by more than a threshold
+                    number of seconds, within a single loop of the timer thread.
+                    The default value of this property is very high to effectively
+                    disable it.
+                </p>
+                
+<table cellspacing="0" cellpadding="0" width="100%" border="0" class="listing">
+<tr>
+<td class="listingcaption"><i>Example:</i></td>
+</tr>
+<tr>
+<td bgcolor="#eeeeee" class="listingcell"><font color="#444444">
+<pre class="listingpre">wrapper.timer_slow_threshold=10</pre>
+</font></td>
+</tr>
+</table>
+                
+<p>
+                    Setting the slow threshold to a low value like 1 second will
+                    provide useful information about when during the day the system
+                    is under load.
+                </p>
+                
+<p>
+                    A value of 0 will show every single slip in time and is in
+                    general not very useful.  Even under very light load, the
+                    timer will fall slightly behind the system clock simply
+                    because the loop itself takes a finite amount of time to
+                    complete.
+                </p>
+                
+<p>
+                    Slightly higher values like 10 seconds can actually be quite
+                    useful as they will point out any major periods of high load
+                    on the system, while not bothering to log every single CPU
+                    hiccup.
+                </p>
+                
+<p>
+                    Any forward adjustments in the system clock will be
+                    interpreted as a period of high CPU load that lasted the
+                    duration that the clock was advanced.
+                </p>
+                
+<p>
+                    If for example you have set this property to a low value and the
+                    system clock is either set ahead by one minute, or is under extremely
+                    heavy load for a minute, you will see output in your logs like the
+                    following:
+                </p>
+                
+<table cellspacing="0" cellpadding="0" width="100%" border="0" class="listing">
+<tr>
+<td class="listingcaption"><i>Example:</i></td>
+</tr>
+<tr>
+<td bgcolor="#eeeeee" class="listingcell"><font color="#444444">
+<pre class="listingpre">INFO   | wrapper  | 2004/07/21 08:52:01 | The timer fell behind the system clock by 60000ms.
+INFO   | jvm 1    | 2004/07/21 08:52:15 | The timer fell behind the system clock by 60000ms.</pre>
+</font></td>
+</tr>
+</table>
+                
+<p>
+                    The pair of messages indicates that both the wrapper and JVM
+                    processes noticed the change in system time.  It is quite common
+                    for the numbers reported by the two processes to differ slightly
+                    when the just is caused by heavy load.
+                </p>
+            
+</td>
+</tr>
+</table>
+            
+<a name="prop-timer-fast-threshold"></a>
+<table cellpadding="2" cellspacing="0" width="100%" border="0">
+<tr>
+<td rowspan="3" width="10"><img height="1" width="10" src="./images/spacer.gif"></td><td bgcolor="#aaaacc" class="sectionheader3" width="*"><font color="#eeeeee" size="2"><b>wrapper.timer_fast_threshold</b></font></td>
+</tr>
+<tr>
+<td><img height="4" width="1" src="./images/spacer.gif"></td>
+</tr>
+<tr>
+<td>
+                
+                
+<p>
+                    The wrapper.timer_fast_threshold
+                    property will display a message to the log whenever the system
+                    time falls behind the "tick" timer by more than a threshold
+                    number of seconds within, a single loop of the timer thread.
+                    The default value of this property is very high to effectively
+                    disable it.
+                </p>
+                
+<table cellspacing="0" cellpadding="0" width="100%" border="0" class="listing">
+<tr>
+<td class="listingcaption"><i>Example:</i></td>
+</tr>
+<tr>
+<td bgcolor="#eeeeee" class="listingcell"><font color="#444444">
+<pre class="listingpre">wrapper.timer_fast_threshold=0</pre>
+</font></td>
+</tr>
+</table>
+                
+<p>
+                    Setting the fast threshold to a low value is not generally as
+                    useful as the slow threshold property above.  Under normal
+                    operation, the "tick" timer will never advance beyond the
+                    system time.  The only exception is in the case where the
+                    system clock has been set back.  Setting the property to
+                    0 will detect any such backward adjustments of the system
+                    clock.
+                </p>
+                
+<p>
+                    If for example you have set this property to a low value and the
+                    system clock is set back by one minute, you will see output in
+                    your logs like the following:
+                </p>
+                
+<table cellspacing="0" cellpadding="0" width="100%" border="0" class="listing">
+<tr>
+<td class="listingcaption"><i>Example:</i></td>
+</tr>
+<tr>
+<td bgcolor="#eeeeee" class="listingcell"><font color="#444444">
+<pre class="listingpre">INFO   | wrapper  | 2004/07/21 08:52:01 | The system clock fell behind the timer by 60000ms.
+INFO   | jvm 1    | 2004/07/21 08:52:15 | The system clock fell behind the timer by 60000ms.</pre>
+</font></td>
+</tr>
+</table>
+                
+<p>
+                    The pair of messages indicates that both the wrapper and JVM
+                    processes noticed the change in system time.
+                </p>
+            
+</td>
+</tr>
+</table>
+        
+</td>
+</tr>
+</table>
+    
+</td>
+</tr>
+</table>
+
+</td>
+</tr>
+<tr>
+<td align="right" id="author">
+<p>
+<i>by Leif Mortenson</i>
+</p>
+</td>
+</tr>
+</table>
+<script language="JavaScript">//@@BODY_SECTION@@</script></td><td valign="bottom" width="4"><img height="496" width="4" src="images/BorderRight.png"></td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td align="right" height="4" colspan="2"><img height="4" width="500" src="images/BorderBottom.png"></td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+<table cellpadding="2" cellspacing="0" border="0" width="100%">
+<tr>
+<td id="copyright" align="left"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i>
+                            Copyright &copy;1999-2004 by <a href="http://www.tanukisoftware.com">Tanuki Software</a>.
+                            All Rights Reserved.
+                        </i></font></td><td align="right"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i>
+                            last modified:
+                            <script language="JavaScript"> document.write(document.lastModified); </script></i></font></td>
+</tr>
+</table>
+</body>
+</html>

Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-use-system-time.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-use-system-time.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-use-system-time.html
------------------------------------------------------------------------------
    svn:mime-type = text/html

Added: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-working-dir.html
URL: http://svn.apache.org/viewvc/geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-working-dir.html?view=auto&rev=507826
==============================================================================
--- geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-working-dir.html (added)
+++ geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-working-dir.html Wed Feb 14 21:48:50 2007
@@ -0,0 +1,572 @@
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Java Service Wrapper - wrapper.working.dir Property</title>
+<style media="all" type="text/css">
+            @import url("./style/wrapper.css");
+        </style>
+</head>
+<body bgcolor="#eeeeff" marginheight="0" marginwidth="0" leftmargin="0" topmargin="0" alink="#023264" vlink="#023264" link="#525D76" text="#000000">
+<map name="wrapperLogo">
+<area href="http://wrapper.tanukisoftware.org" coords="90,90,88" shape="circle">
+</map>
+<map name="wrapperTitle">
+<area href="http://www.tanukisoftware.com" coords="28,32,176,48" shape="rect">
+</map>
+<table cellpadding="0" cellspacing="0" width="100%" border="0">
+<tr>
+<td valign="top" width="180">
+<table cellpadding="0" cellspacing="0" width="100%" border="0">
+<tr>
+<td width="180"><img usemap="#wrapperLogo" border="0" height="180" width="180" src="images/WrapperLogo.png"></td>
+</tr>
+<tr>
+<td>
+<table cellpadding="4" cellspacing="0" width="100%" border="0">
+<tr>
+<td nowrap="true">
+<div id="menu">
+<script language="JavaScript">//@@MENU_TOP@@</script>
+<div>
+<b>Essentials</b>
+<div>
+<a href="introduction.html">Introduction</a>
+</div>
+<div>
+<a href="integrate.html">Integration Methods</a>
+</div>
+<div>
+<a href="properties.html">Configuration Properties</a>
+</div>
+<div>
+<a href="launch.html">Launching Your Application</a>
+</div>
+<div>
+<b>
+                        &gt;&gt;
+                        <a href="donate.html">Show Your Support</a>
+                        &lt;&lt;
+                    </b>
+</div>
+<div>
+<a href="sponsors.html">Sponsors</a>
+</div>
+</div>
+<div>
+<b>Documentation</b>
+<div>
+<a href="jmx.html">JMX Control</a>
+</div>
+<div>
+<a href="security-model.html">Security Model</a>
+</div>
+<div>
+<a href="example.html">Feature Examples</a>
+</div>
+<div>
+<a href="debugging.html">Debugging Your Application</a>
+</div>
+<div>
+<a href="troubleshooting.html">Troubleshooting</a>
+</div>
+<div>
+<a href="faq.html">FAQ</a>
+</div>
+<div>
+<a href="release-notes.html">Release Notes</a>
+</div>
+<div>
+<a href="history.html">Project History</a>
+</div>
+<div>
+<a href="javadocs.html">Javadocs API</a>
+</div>
+<div>
+<a href="buttons.html">Buttons</a>
+</div>
+<div>
+<a href="authors.html">Authors</a>
+</div>
+<div>
+<a href="license.html">License</a>
+</div>
+</div>
+<div>
+<b>Download</b>
+<div>
+<a href="http://sourceforge.net/project/showfiles.php?group_id=39428&package_id=31591">Binaries</a>
+</div>
+<div>
+<a href="http://sourceforge.net/project/showfiles.php?group_id=39428&package_id=33658">Source Code</a>
+</div>
+</div>
+<div>
+<b>Get Involved</b>
+<div>
+<a href="http://sourceforge.net/projects/wrapper/">Source Forge</a>
+</div>
+<div>
+<a href="http://svn.sourceforge.net/viewvc/wrapper/">Subversion Repository</a>
+</div>
+<div>
+<a href="http://sourceforge.net/tracker/?group_id=39428">Issue Tracking</a>
+</div>
+<div>
+<a href="http://sourceforge.net/mail/?group_id=39428">Mailing Lists and Archives</a>
+</div>
+<div>
+<a href="http://sourceforge.net/forum/?group_id=39428">Forums (Old)</a>
+</div>
+</div>
+</div>
+<script language="JavaScript">//@@MENU_BOTTOM@@</script>
+<p>
+<b>Hosted by:</b>
+<br>
+<a href="http://sourceforge.net/projects/wrapper/"><img alt="SourceForge" border="0" height="31" width="88" src="http://sourceforge.net/sflogo.php?group_id=39428"></a>
+<br>
+</p>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+</td><td valign="top" width="*">
+<table cellpadding="0" cellspacing="0" width="100%" border="0">
+<tr>
+<td colspan="3"><img height="4" src="images/spacer.gif"></td>
+</tr>
+<tr>
+<td align="center" height="90" colspan="2"><a href="http://wrapper.tanukisoftware.org"><img border="0" height="90" width="728" src="images/OfflineAd728x90.png"></a></td><td rowspan="5"><img width="4" src="images/spacer.gif"></td>
+</tr>
+<tr>
+<td height="49" width="435"><img usemap="#wrapperTitle" border="0" height="49" width="435" src="images/WrapperTitle.png"></td><td valign="bottom" align="right" width="*"><a href="donate.html"><img border="0" height="16" width="300" src="images/DonationRequest.png"></a></td>
+</tr>
+<tr>
+<td height="4" colspan="2"><img height="4" width="500" src="images/BorderTop.png"></td>
+</tr>
+<tr>
+<td colspan="2">
+<table cellspacing="0" cellpadding="0" width="100%" border="0">
+<tr>
+<td valign="top" width="4"><img height="496" width="4" src="images/BorderLeft.png"></td><td bgcolor="#ffffff" valign="top" width="*" colspan="2">
+<table cellpadding="4" cellspacing="0" width="100%" border="0">
+<tr>
+<td nowrap="true" align="center"><font zcolor="#115b77" color="#8888aa" size="5"><b>wrapper.working.dir Property</b></font></td>
+</tr>
+<tr>
+<td>
+<title>wrapper.working.dir Property</title>
+    
+    
+<a name="N10009"></a>
+<table cellpadding="2" cellspacing="0" width="100%" border="0">
+<tr>
+<td bgcolor="#8888aa" class="sectionheader1" width="*"><font color="#eeeeee" size="4"><b>Configuration Property Overview</b></font></td>
+</tr>
+<tr>
+<td><img height="4" width="1" src="./images/spacer.gif"></td>
+</tr>
+<tr>
+<td>
+        
+        
+<ul>
+            
+<li>
+                
+<a href="properties.html">Configuration Property Overview</a>
+            
+</li>
+            
+<li>
+                
+<a href="props-advanced.html">Advanced Properties</a>
+            
+</li>
+            
+<li>
+                
+<a href="properties.html#name">Property List by Name</a>
+            
+</li>
+        
+</ul>
+    
+</td>
+</tr>
+</table>
+    
+<a name="N10027"></a>
+<table cellpadding="2" cellspacing="0" width="100%" border="0">
+<tr>
+<td bgcolor="#8888aa" class="sectionheader1" width="*"><font color="#eeeeee" size="4"><b>wrapper.working.dir</b></font></td>
+</tr>
+<tr>
+<td><img height="4" width="1" src="./images/spacer.gif"></td>
+</tr>
+<tr>
+<td>
+        
+        
+<div class="warning">
+<table cellspacing="0" cellpadding="0" width="100%" border="0">
+<tr>
+<td nowrap="nowrap" valign="top">
+<p class="warninglabel">
+<font color="#a00000"><b>WARNING</b></font>
+</p>
+</td><td><img width="10" src="images/spacer.gif"></td><td bgcolor="#dd8080" class="warningbody"><font color="#602222">
+            
+<p>
+                You will save yourself a lot of time by reading this page BEFORE
+                playing with this property.
+            </p>
+        
+</font></td>
+</tr>
+</table>
+</div>
+        
+<a name="N10032"></a>
+<table cellpadding="2" cellspacing="0" width="100%" border="0">
+<tr>
+<td rowspan="3" width="10"><img height="1" width="10" src="./images/spacer.gif"></td><td bgcolor="#9999bb" class="sectionheader2" width="*"><font color="#eeeeee" size="3"><b>Overview of How The Working Dir Works</b></font></td>
+</tr>
+<tr>
+<td><img height="4" width="1" src="./images/spacer.gif"></td>
+</tr>
+<tr>
+<td>
+            
+            
+<p>
+                When the Wrapper is launched it is very careful about making sure that the
+                working directory is in a known and constant state.  This helps to
+                guarantee that there will be no path related problems caused
+                by a user launching the Wrapper from an unexpected location.
+            </p>
+            
+<p>
+                On Windows platforms, the <tt>Wrapper.exe</tt>
+                sets its own working directory immediately on startup to the directory
+                where it is located.  This is especially critical on Windows platforms.
+                When running in a console the working directory is normally set to the
+                current directory when an application is launched.  This means that it
+                would be different if the Wrapper was launched as
+                <tt>bin\Wrapper.exe</tt> versus
+                <tt>.\Wrapper.exe</tt> versus
+                <tt>..\bin\Wrapper.exe</tt>.   In addition,
+                when running as an NT service, the working directory is normally set
+                to the Windows <tt>system32</tt> directory.
+                By always forcing the working directory to the location of the
+                <tt>Wrapper.exe</tt>, integrators can reliably
+                make use of relative path references.
+            </p>
+            
+<p>
+                Things work a little differently on UNIX platforms.  There, the wrapper
+                binary does not set its own working directory by default.  This is left
+                up to the script used to launch the Wrapper.  While this has traditionally
+                given more flexibility to UNIX users, the same issues as exist on the
+                Windows platform also exist on UNIX.  By using the scripts shipped with
+                the Wrapper distribution all path issue should be taken care of.
+            </p>
+            
+<p>
+                There are times however where having the working directory set to the
+                location of the Wrapper binary makes it impossible to run some
+                applications cleanly.   An example is an application which expects the
+                working directory to be at the root of the file system.   The only way
+                to run such an application under the Wrapper would be to place the
+                Wrapper binary and scripts in the root directory.  Not something that
+                most system administrators would want to do.
+            </p>
+            
+<p>
+                To allow such cases, the <tt>wrapper.working.dir</tt>
+                property was added.  It is very important to understand exactly how
+                this property works to avoid problems.
+            </p>
+            
+<p>
+                The <tt>wrapper.working.dir</tt> property
+                can be specified either in the <tt>wrapper.conf</tt>
+                or as a parameter to the Wrapper binary.  However, the property does not take
+                effect until AFTER all of the Wrapper's properties have been completely
+                parsed.   This means that the location of the
+                <tt>wrapper.conf</tt> file and any include
+                files referenced therein must still be referenced using locations
+                relative to the Wrapper binary.   This is necessary to make sure
+                that the configuration file can be loaded reliably.
+            </p>
+            
+<p>
+                Any and all paths defined in OTHER properties specified either from the
+                command line or within the <tt>wrapper.conf</tt>
+                file will then be relative to the location specified by the
+                <tt>wrapper.working.dir</tt> property.
+            </p>
+            
+<p>
+                Confused yet?  An example or two is in order.
+            </p>
+        
+</td>
+</tr>
+</table>
+        
+<a name="N10080"></a>
+<table cellpadding="2" cellspacing="0" width="100%" border="0">
+<tr>
+<td rowspan="3" width="10"><img height="1" width="10" src="./images/spacer.gif"></td><td bgcolor="#9999bb" class="sectionheader2" width="*"><font color="#eeeeee" size="3"><b>Example Without Setting wrapper.working.dir</b></font></td>
+</tr>
+<tr>
+<td><img height="4" width="1" src="./images/spacer.gif"></td>
+</tr>
+<tr>
+<td>
+            
+            
+<p>
+                Windows will be used as an example, but the issues are all the same
+                for UNIX platforms.
+            </p>
+            
+<table cellspacing="0" cellpadding="0" width="100%" border="0" class="listing">
+<tr>
+<td class="listingcaption"><i>Sample Directory Structure:</i></td>
+</tr>
+<tr>
+<td bgcolor="#eeeeee" class="listingcell"><font color="#444444">
+<pre class="listingpre">C:\myapp\
+    bin\
+        Wrapper.exe
+    conf\
+        wrapper.conf
+        include.conf
+    lib\
+        Wrapper.dll
+        wrapper.jar
+        myapp.jar
+    logs\
+        wrapper.log</pre>
+</font></td>
+</tr>
+</table>
+            
+<p>
+                Without using the <tt>wrapper.working.dir</tt>
+                property, the working directory will be located in the
+                <tt>C:\myapp\bin</tt> directory.
+                The Wrapper would be launched using the following command.
+            </p>
+            
+<table cellspacing="0" cellpadding="0" width="100%" border="0" class="listing">
+<tr>
+<td bgcolor="#eeeeee" class="listingcell"><font color="#444444">
+<pre class="listingpre">Wrapper.exe -c ../conf/wrapper.conf</pre>
+</font></td>
+</tr>
+</table>
+            
+<p>
+                Paths in the <tt>wrapper.conf</tt> file
+                would be configured as follows. (Note this is not a complete
+                configuration file.):
+            </p>
+            
+<table cellspacing="0" cellpadding="0" width="100%" border="0" class="listing">
+<tr>
+<td bgcolor="#eeeeee" class="listingcell"><font color="#444444">
+<pre class="listingpre">#include ../conf/include.conf
+wrapper.java.classpath.1=../lib/wrapper.jar
+wrapper.java.classpath.2=../lib/myapp.jar
+wrapper.java.library.path.1=../lib
+wrapper.pidfile=./wrapper.pid
+wrapper.java.pidfile=./java.pid
+wrapper.logfile=../logs/wrapper.log</pre>
+</font></td>
+</tr>
+</table>
+            
+<p>
+                Note that all paths are relative to the location of the
+                <tt>Wrapper.exe</tt> file.
+            </p>
+        
+</td>
+</tr>
+</table>
+        
+<a name="N100BB"></a>
+<table cellpadding="2" cellspacing="0" width="100%" border="0">
+<tr>
+<td rowspan="3" width="10"><img height="1" width="10" src="./images/spacer.gif"></td><td bgcolor="#9999bb" class="sectionheader2" width="*"><font color="#eeeeee" size="3"><b>Example Setting wrapper.working.dir</b></font></td>
+</tr>
+<tr>
+<td><img height="4" width="1" src="./images/spacer.gif"></td>
+</tr>
+<tr>
+<td>
+            
+            
+<p>
+                The same directory structure used in the previous example will
+                be reused.
+            </p>
+            
+<p>
+                This time the <tt>wrapper.working.dir</tt>
+                property will be set the parent of the
+                <tt>bin</tt> directory in which
+                the <tt>Wrapper.exe</tt> file is
+                located.  This is a location that is commonly referred to as the
+                application HOME.  <tt>C:\myapp</tt>
+                in this case.
+            </p>
+            
+<p>
+                The <tt>wrapper.working.dir</tt>
+                property can be specified either on the command line
+                used to launch the Wrapper, or within the wrapper.conf file.
+                In either case, the specified directory can be absolute or
+                relative.  In the case of a relative directory, the directory
+                will be relative to the location of the Wrapper binary.
+            </p>
+            
+<p>
+                This example will specify the new working directory within
+                the <tt>wrapper.conf</tt> file.
+                So in this case, the command used to launch the Wrapper is
+                unchanged, meaning that the batch files and scripts that
+                ship with the Wrapper can be used without any modification.
+            </p>
+            
+<table cellspacing="0" cellpadding="0" width="100%" border="0" class="listing">
+<tr>
+<td bgcolor="#eeeeee" class="listingcell"><font color="#444444">
+<pre class="listingpre">Wrapper.exe -c ../conf/wrapper.conf</pre>
+</font></td>
+</tr>
+</table>
+            
+<p>
+                When the Wrapper is launched, it immediately sets its working
+                directory to the location of the Wrapper binary.  Then loads
+                the <tt>wrapper.conf</tt> file and
+                any include files using that working directory.   Once the
+                configuration is loaded, the working directory will be changed
+                to the new location specified by the
+                <tt>wrapper.working.dir</tt> property.
+                All future paths including the launching of the JVM will be
+                done using this new working directory.
+            </p>
+            
+<p>
+                For this example the <tt>wrapper.conf</tt>
+                fragment used above will be modified as follows:
+            </p>
+            
+<table cellspacing="0" cellpadding="0" width="100%" border="0" class="listing">
+<tr>
+<td bgcolor="#eeeeee" class="listingcell"><font color="#444444">
+<pre class="listingpre">wrapper.working.dir=../
+#include ../conf/include.conf
+wrapper.java.classpath.1=lib/wrapper.jar
+wrapper.java.classpath.2=lib/myapp.jar
+wrapper.java.library.path.1=lib
+wrapper.pidfile=bin/wrapper.pid
+wrapper.java.pidfile=bin/java.pid
+wrapper.logfile=logs/wrapper.log</pre>
+</font></td>
+</tr>
+</table>
+            
+<p>
+                Notice that the location of the include file and
+                <tt>wrapper.working.dir</tt> property
+                are both relative to the Wrapper binary location, but all other
+                paths are now relative to the new working directory.
+            </p>
+            
+<p>
+                The location of the <tt>wrapper.working.dir</tt>
+                property in the <tt>wrapper.conf</tt> file
+                is not important as it is not applied until after the entire
+                configuration file has been parsed.
+            </p>
+            
+<p>
+                As with any problems configuring the Wrapper.  The first thing that
+                should be done when problems are encountered is to enable the
+                <a href="prop-debug.html">wrapper.debug</a> property and
+                rerun the application.  Make sure that the application can be run
+                as a console application before attempting to run it as a service
+                or daemon process.
+            </p>
+        
+</td>
+</tr>
+</table>
+        
+<div class="note">
+<table cellspacing="0" cellpadding="2" width="100%" border="0">
+<tr>
+<td nowrap="nowrap" valign="top">
+<p class="notelabel">
+<font color="#0000a0"><b>NOTE MEG</b></font>
+</p>
+</td><td><img width="10" src="images/spacer.gif"></td><td bgcolor="#bbbbdd" class="notebody"><font color="#222260">
+            
+<p>
+                
+<a href="prop-restart-reload-configuration.html">Reloading</a>
+                the Wrapper configuration will have no effect on the value of this property.
+                Changes will not take effect until the Wrapper has been restarted.
+            </p>
+        
+</font></td>
+</tr>
+</table>
+</div>
+    
+</td>
+</tr>
+</table>
+
+</td>
+</tr>
+<tr>
+<td align="right" id="author">
+<p>
+<i>by Leif Mortenson</i>
+</p>
+</td>
+</tr>
+</table>
+<script language="JavaScript">//@@BODY_SECTION@@</script></td><td valign="bottom" width="4"><img height="496" width="4" src="images/BorderRight.png"></td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td align="right" height="4" colspan="2"><img height="4" width="500" src="images/BorderBottom.png"></td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+<table cellpadding="2" cellspacing="0" border="0" width="100%">
+<tr>
+<td id="copyright" align="left"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i>
+                            Copyright &copy;1999-2004 by <a href="http://www.tanukisoftware.com">Tanuki Software</a>.
+                            All Rights Reserved.
+                        </i></font></td><td align="right"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i>
+                            last modified:
+                            <script language="JavaScript"> document.write(document.lastModified); </script></i></font></td>
+</tr>
+</table>
+</body>
+</html>

Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-working-dir.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-working-dir.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-working-dir.html
------------------------------------------------------------------------------
    svn:mime-type = text/html

Added: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/properties.html
URL: http://svn.apache.org/viewvc/geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/properties.html?view=auto&rev=507826
==============================================================================
--- geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/properties.html (added)
+++ geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/properties.html Wed Feb 14 21:48:50 2007
@@ -0,0 +1,919 @@
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Java Service Wrapper - Configuration Property Overview</title>
+<style media="all" type="text/css">
+            @import url("./style/wrapper.css");
+        </style>
+</head>
+<body bgcolor="#eeeeff" marginheight="0" marginwidth="0" leftmargin="0" topmargin="0" alink="#023264" vlink="#023264" link="#525D76" text="#000000">
+<map name="wrapperLogo">
+<area href="http://wrapper.tanukisoftware.org" coords="90,90,88" shape="circle">
+</map>
+<map name="wrapperTitle">
+<area href="http://www.tanukisoftware.com" coords="28,32,176,48" shape="rect">
+</map>
+<table cellpadding="0" cellspacing="0" width="100%" border="0">
+<tr>
+<td valign="top" width="180">
+<table cellpadding="0" cellspacing="0" width="100%" border="0">
+<tr>
+<td width="180"><img usemap="#wrapperLogo" border="0" height="180" width="180" src="images/WrapperLogo.png"></td>
+</tr>
+<tr>
+<td>
+<table cellpadding="4" cellspacing="0" width="100%" border="0">
+<tr>
+<td nowrap="true">
+<div id="menu">
+<script language="JavaScript">//@@MENU_TOP@@</script>
+<div>
+<b>Essentials</b>
+<div>
+<a href="introduction.html">Introduction</a>
+</div>
+<div>
+<a href="integrate.html">Integration Methods</a>
+</div>
+<div>
+<a href="properties.html">Configuration Properties</a>
+</div>
+<div>
+<a href="launch.html">Launching Your Application</a>
+</div>
+<div>
+<b>
+                        &gt;&gt;
+                        <a href="donate.html">Show Your Support</a>
+                        &lt;&lt;
+                    </b>
+</div>
+<div>
+<a href="sponsors.html">Sponsors</a>
+</div>
+</div>
+<div>
+<b>Documentation</b>
+<div>
+<a href="jmx.html">JMX Control</a>
+</div>
+<div>
+<a href="security-model.html">Security Model</a>
+</div>
+<div>
+<a href="example.html">Feature Examples</a>
+</div>
+<div>
+<a href="debugging.html">Debugging Your Application</a>
+</div>
+<div>
+<a href="troubleshooting.html">Troubleshooting</a>
+</div>
+<div>
+<a href="faq.html">FAQ</a>
+</div>
+<div>
+<a href="release-notes.html">Release Notes</a>
+</div>
+<div>
+<a href="history.html">Project History</a>
+</div>
+<div>
+<a href="javadocs.html">Javadocs API</a>
+</div>
+<div>
+<a href="buttons.html">Buttons</a>
+</div>
+<div>
+<a href="authors.html">Authors</a>
+</div>
+<div>
+<a href="license.html">License</a>
+</div>
+</div>
+<div>
+<b>Download</b>
+<div>
+<a href="http://sourceforge.net/project/showfiles.php?group_id=39428&package_id=31591">Binaries</a>
+</div>
+<div>
+<a href="http://sourceforge.net/project/showfiles.php?group_id=39428&package_id=33658">Source Code</a>
+</div>
+</div>
+<div>
+<b>Get Involved</b>
+<div>
+<a href="http://sourceforge.net/projects/wrapper/">Source Forge</a>
+</div>
+<div>
+<a href="http://svn.sourceforge.net/viewvc/wrapper/">Subversion Repository</a>
+</div>
+<div>
+<a href="http://sourceforge.net/tracker/?group_id=39428">Issue Tracking</a>
+</div>
+<div>
+<a href="http://sourceforge.net/mail/?group_id=39428">Mailing Lists and Archives</a>
+</div>
+<div>
+<a href="http://sourceforge.net/forum/?group_id=39428">Forums (Old)</a>
+</div>
+</div>
+</div>
+<script language="JavaScript">//@@MENU_BOTTOM@@</script>
+<p>
+<b>Hosted by:</b>
+<br>
+<a href="http://sourceforge.net/projects/wrapper/"><img alt="SourceForge" border="0" height="31" width="88" src="http://sourceforge.net/sflogo.php?group_id=39428"></a>
+<br>
+</p>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+</td><td valign="top" width="*">
+<table cellpadding="0" cellspacing="0" width="100%" border="0">
+<tr>
+<td colspan="3"><img height="4" src="images/spacer.gif"></td>
+</tr>
+<tr>
+<td align="center" height="90" colspan="2"><a href="http://wrapper.tanukisoftware.org"><img border="0" height="90" width="728" src="images/OfflineAd728x90.png"></a></td><td rowspan="5"><img width="4" src="images/spacer.gif"></td>
+</tr>
+<tr>
+<td height="49" width="435"><img usemap="#wrapperTitle" border="0" height="49" width="435" src="images/WrapperTitle.png"></td><td valign="bottom" align="right" width="*"><a href="donate.html"><img border="0" height="16" width="300" src="images/DonationRequest.png"></a></td>
+</tr>
+<tr>
+<td height="4" colspan="2"><img height="4" width="500" src="images/BorderTop.png"></td>
+</tr>
+<tr>
+<td colspan="2">
+<table cellspacing="0" cellpadding="0" width="100%" border="0">
+<tr>
+<td valign="top" width="4"><img height="496" width="4" src="images/BorderLeft.png"></td><td bgcolor="#ffffff" valign="top" width="*" colspan="2">
+<table cellpadding="4" cellspacing="0" width="100%" border="0">
+<tr>
+<td nowrap="true" align="center"><font zcolor="#115b77" color="#8888aa" size="5"><b>Configuration Property Overview</b></font></td>
+</tr>
+<tr>
+<td>
+<title>Configuration Property Overview</title>
+    
+    
+<a name="N10009"></a>
+<table cellpadding="2" cellspacing="0" width="100%" border="0">
+<tr>
+<td bgcolor="#8888aa" class="sectionheader1" width="*"><font color="#eeeeee" size="4"><b>Configuration Property Overview</b></font></td>
+</tr>
+<tr>
+<td><img height="4" width="1" src="./images/spacer.gif"></td>
+</tr>
+<tr>
+<td>
+        
+        
+<p>
+            The Java Service Wrapper uses a configuration file to control
+            the various Wrapper settings.  The file also contains all of
+            the information necessary to launch a JVM instance with the
+            correct command line required by a given application.
+        </p>
+        
+<p>
+            This section includes an example configuration file as well
+            as covers some general features which apply to all properties.
+        </p>
+        
+<p>
+            The individual properties are individually explained below.
+            They can be accessed by category or name.  Many of the
+            properties which will most likely be required are also
+            explained elsewhere in this document.
+        </p>
+        
+<p>
+            The Wrapper configuration file is very similar, but not exactly
+            the same, as a Java Properties file.  The '\' character is not
+            interpreted as an escape character for example.  The '#'
+            character is interpreted as a comment character.  To include a
+            '#' character in a property value, the value must either be
+            quoted, or escaped by a second '#' character.
+        </p>
+        
+<ul>
+            
+<li>
+                
+<a href="props-example-config.html">Example Configuration File</a>
+            
+</li>
+            
+<li>
+                
+<a href="props-command-line.html">Command Line Configuration</a>
+            
+</li>
+            
+<li>
+                
+<a href="props-paths.html">Paths in Configuration Properties</a>
+            
+</li>
+            
+<li>
+                
+<a href="props-envvars.html">Environment Variables</a>
+            
+</li>
+            
+<li>
+                
+<a href="props-cascading.html">Cascading Configuration Files</a>
+            
+</li>
+        
+</ul>
+        
+<a name="category"></a>
+<table cellpadding="2" cellspacing="0" width="100%" border="0">
+<tr>
+<td rowspan="3" width="10"><img height="1" width="10" src="./images/spacer.gif"></td><td bgcolor="#9999bb" class="sectionheader2" width="*"><font color="#eeeeee" size="3"><b>Properties by Category</b></font></td>
+</tr>
+<tr>
+<td><img height="4" width="1" src="./images/spacer.gif"></td>
+</tr>
+<tr>
+<td>
+            
+            
+<ul>
+                
+<li>
+                    
+<a href="props-jvm.html">JVM Configuration Properties</a>
+                
+</li>
+                
+<li>
+                    
+<a href="props-logging.html">Logging Configuration Properties</a>
+                
+</li>
+                
+<li>
+                    
+<a href="props-unix.html">Linux/Unix Configuration Properties</a>
+                
+</li>
+                
+<li>
+                    
+<a href="props-nt.html">Windows NT/2000/XP Configuration Properties</a>
+                
+</li>
+                
+<li>
+                    
+<a href="props-advanced.html">Advanced Properties</a>
+                
+</li>
+            
+</ul>
+        
+</td>
+</tr>
+</table>
+        
+<a name="name"></a>
+<table cellpadding="2" cellspacing="0" width="100%" border="0">
+<tr>
+<td rowspan="3" width="10"><img height="1" width="10" src="./images/spacer.gif"></td><td bgcolor="#9999bb" class="sectionheader2" width="*"><font color="#eeeeee" size="3"><b>Properties by Name</b></font></td>
+</tr>
+<tr>
+<td><img height="4" width="1" src="./images/spacer.gif"></td>
+</tr>
+<tr>
+<td>
+            
+            
+<p>
+                Properties added after the initial release are followed by the version in which
+                they were implemented.
+            </p>
+            
+<ul>
+                
+<li>
+                    
+<a href="prop-adviser.html">wrapper.adviser</a>
+                <font color="#808080"><i>(3.1.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-anchorfile.html">wrapper.anchorfile</a>
+                <font color="#808080"><i>(3.1.1)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-umask.html">wrapper.anchorfile.umask</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-app-parameter-n.html">wrapper.app.parameter.&lt;n&gt;</a>
+                
+</li>
+                
+<li>
+                    
+<a href="prop-commandfile.html">wrapper.commandfile</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-console-flush.html">wrapper.console.flush</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-console-format.html">wrapper.console.format</a>
+                
+</li>
+                
+<li>
+                    
+<a href="prop-console-loglevel.html">wrapper.console.loglevel</a>
+                
+</li>
+                
+<li>
+                    
+<a href="prop-console-title.html">wrapper.console.title</a>
+                <font color="#808080"><i>(3.1.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-cpu-timeout.html">wrapper.cpu.timeout</a>
+                <font color="#808080"><i>(2.2.8)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-daemonize.html">wrapper.daemonize</a>
+                <font color="#808080"><i>(3.0.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-debug.html">wrapper.debug</a>
+                
+</li>
+                
+<li>
+                    
+<a href="prop-disable-restarts.html">wrapper.disable_restarts</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-disable-shutdown-hook.html">wrapper.disable_shutdown_hook</a>
+                
+</li>
+                
+<li>
+                    
+<a href="prop-filter-x-n.html">wrapper.filter.action.&lt;n&gt;</a>
+                <font color="#808080"><i>(3.0.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-filter-x-n.html">wrapper.filter.trigger.&lt;n&gt;</a>
+                <font color="#808080"><i>(3.0.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-ignore-signals.html">wrapper.ignore_signals</a>
+                <font color="#808080"><i>(3.0.5)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-java-additional-n.html">wrapper.java.additional.&lt;n&gt;</a>
+                
+</li>
+                
+<li>
+                    
+<a href="prop-java-classpath-n.html">wrapper.java.classpath.&lt;n&gt;</a>
+                
+</li>
+                
+<li>
+                    
+<a href="prop-java-command.html">wrapper.java.command</a>
+                
+</li>
+                
+<li>
+                    
+<a href="prop-java-command-loglevel.html">wrapper.java.command.loglevel</a>
+                <font color="#808080"><i>(3.1.2)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-java-idfile.html">wrapper.java.idfile</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-java-initmemory.html">wrapper.java.initmemory</a>
+                
+</li>
+                
+<li>
+                    
+<a href="prop-java-library-path-n.html">wrapper.java.library.path.&lt;n&gt;</a>
+                <font color="#808080"><i>(2.2.9)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-java-library-path-append-system-path.html">wrapper.java.library.path.append_system_path</a>
+                <font color="#808080"><i>(3.1.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-java-mainclass.html">wrapper.java.mainclass</a>
+                
+</li>
+                
+<li>
+                    
+<a href="prop-java-maxmemory.html">wrapper.java.maxmemory</a>
+                
+</li>
+                
+<li>
+                    
+<a href="prop-java-idfile.html">wrapper.java.idfile</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-umask.html">wrapper.java.idfile.umask</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-java-pidfile.html">wrapper.java.pidfile</a>
+                <font color="#808080"><i>(3.0.5)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-umask.html">wrapper.java.pidfile.umask</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-java-statusfile.html">wrapper.java.statusfile</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-umask.html">wrapper.java.statusfile.umask</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-umask.html">wrapper.java.umask</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-jvm-exit-timeout.html">wrapper.jvm_exit.timeout</a>
+                <font color="#808080"><i>(2.2.8)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-jvm-port.html">wrapper.jvm.port</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-jvm-port.html">wrapper.jvm.port.max</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-jvm-port.html">wrapper.jvm.port.min</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-lockfile.html">wrapper.lockfile</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-umask.html">wrapper.lockfile.umask</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-logfile.html">wrapper.logfile</a>
+                
+</li>
+                
+<li>
+                    
+<a href="prop-logfile-format.html">wrapper.logfile.format</a>
+                <font color="#808080"><i>(2.2.5)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-logfile-inactivity-timeout.html">wrapper.logfile.inactivity.timeout</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-logfile-loglevel.html">wrapper.logfile.loglevel</a>
+                <font color="#808080"><i>(2.2.5)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-logfile-maxfiles.html">wrapper.logfile.maxfiles</a>
+                <font color="#808080"><i>(2.2.5)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-logfile-maxsize.html">wrapper.logfile.maxsize</a>
+                <font color="#808080"><i>(2.2.5)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-logfile-rollmode.html">wrapper.logfile.rollmode</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-umask.html">wrapper.logfile.umask</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-max-failed-invocations.html">wrapper.max_failed_invocations</a>
+                <font color="#808080"><i>(2.2.8)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-monitor-thread-count.html">wrapper.monitor_thread_count</a>
+                <font color="#808080"><i>(3.2.0 (Deprecated as of 3.2.1))</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-native-library.html">wrapper.native_library</a>
+                <font color="#808080"><i>(3.1.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-ntservice-account.html">wrapper.ntservice.account</a>
+                <font color="#808080"><i>(3.0.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-ntservice-console.html">wrapper.ntservice.console</a>
+                <font color="#808080"><i>(3.1.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-ntservice-dependency-n.html">wrapper.ntservice.dependency.&lt;n&gt;</a>
+                
+</li>
+                
+<li>
+                    
+<a href="prop-ntservice-description.html">wrapper.ntservice.description</a>
+                <font color="#808080"><i>(2.2.5)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-ntservice-displayname.html">wrapper.ntservice.displayname</a>
+                
+</li>
+                
+<li>
+                    
+<a href="prop-ntservice-hide-console.html">wrapper.ntservice.hide_console</a>
+                <font color="#808080"><i>(3.0.4)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-ntservice-interactive.html">wrapper.ntservice.interactive</a>
+                <font color="#808080"><i>(3.0.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-ntservice-load-order-group.html">wrapper.ntservice.load_order_group</a>
+                <font color="#808080"><i>(3.0.4)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-ntservice-name.html">wrapper.ntservice.name</a>
+                
+</li>
+                
+<li>
+                    
+<a href="prop-ntservice-password.html">wrapper.ntservice.password</a>
+                <font color="#808080"><i>(3.0.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-ntservice-password.html#prompt">wrapper.ntservice.password.prompt</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-ntservice-password.html#mask">wrapper.ntservice.password.prompt.mask</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-ntservice-pausable.html">wrapper.ntservice.pausable</a>
+                <font color="#808080"><i>(3.2.1)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-ntservice-pausable-stop-jvm.html">wrapper.ntservice.pausable.stop_jvm</a>
+                <font color="#808080"><i>(3.2.1)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-ntservice-process-priority.html">wrapper.ntservice.process_priority</a>
+                <font color="#808080"><i>(2.2.7)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-ntservice-starttype.html">wrapper.ntservice.starttype</a>
+                
+</li>
+                
+<li>
+                    
+<a href="prop-on-exit-n.html">wrapper.on_exit.&lt;n&gt;</a>
+                <font color="#808080"><i>(3.1.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-pidfile.html">wrapper.pidfile</a>
+                <font color="#808080"><i>(Usage changed in 3.0.5)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-umask.html">wrapper.pidfile.umask</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-ping-interval.html">wrapper.ping.interval</a>
+                <font color="#808080"><i>(3.0.5)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-ping-timeout.html">wrapper.ping.timeout</a>
+                
+</li>
+                
+<li>
+                    
+<a href="prop-port.html">wrapper.port</a>
+                
+</li>
+                
+<li>
+                    
+<a href="prop-port.html">wrapper.port.max</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-port.html">wrapper.port.min</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-request-thread-dump-on-failed-jvm-exit.html">wrapper.request_thread_dump_on_failed_jvm_exit</a>
+                <font color="#808080"><i>(2.2.7)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-restart-delay.html">wrapper.restart.delay</a>
+                <font color="#808080"><i>(2.2.9)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-restart-reload-configuration.html">wrapper.restart.reload_configuration</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-shutdown-timeout.html">wrapper.shutdown.timeout</a>
+                <font color="#808080"><i>(2.2.7)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-signal-mode-hup.html">wrapper.signal.mode.hup</a>
+                <font color="#808080"><i>(3.2.2)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-single-invocation.html">wrapper.single_invocation</a>
+                <font color="#808080"><i>(3.1.2)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-startup-delay.html">wrapper.startup.delay</a>
+                <font color="#808080"><i>(3.1.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-startup-timeout.html">wrapper.startup.timeout</a>
+                
+</li>
+                
+<li>
+                    
+<a href="prop-statusfile.html">wrapper.statusfile</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-umask.html">wrapper.statusfile.umask</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-successful-invocation-time.html">wrapper.successful_invocation_time</a>
+                <font color="#808080"><i>(2.2.8)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-syslog-facility.html">wrapper.syslog.facility</a>
+                <font color="#808080"><i>(3.2.1)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-syslog-ident.html">wrapper.syslog.ident</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-syslog-loglevel.html">wrapper.syslog.loglevel</a>
+                <font color="#808080"><i>(2.2.5)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-thread-count-delay.html">wrapper.thread_count_delay</a>
+                <font color="#808080"><i>(3.2.0 (Deprecated as of 3.2.1))</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-use-system-time.html#prop-timer-fast-threshold">wrapper.timer_fast_threshold</a>
+                <font color="#808080"><i>(3.1.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-use-system-time.html#prop-timer-slow-threshold">wrapper.timer_slow_threshold</a>
+                <font color="#808080"><i>(3.1.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-umask.html">wrapper.umask</a>
+                <font color="#808080"><i>(3.2.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-use-system-time.html">wrapper.use_system_time</a>
+                <font color="#808080"><i>(3.1.0)</i></font>
+</li>
+                
+<li>
+                    
+<a href="prop-working-dir.html">wrapper.working.dir</a>
+                <font color="#808080"><i>(3.1.0)</i></font>
+</li>
+            
+</ul>
+        
+</td>
+</tr>
+</table>
+    
+</td>
+</tr>
+</table>
+
+</td>
+</tr>
+<tr>
+<td align="right" id="author">
+<p>
+<i>by Leif Mortenson</i>
+</p>
+</td>
+</tr>
+</table>
+<script language="JavaScript">//@@BODY_SECTION@@</script></td><td valign="bottom" width="4"><img height="496" width="4" src="images/BorderRight.png"></td>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td align="right" height="4" colspan="2"><img height="4" width="500" src="images/BorderBottom.png"></td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+<table cellpadding="2" cellspacing="0" border="0" width="100%">
+<tr>
+<td id="copyright" align="left"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i>
+                            Copyright &copy;1999-2004 by <a href="http://www.tanukisoftware.com">Tanuki Software</a>.
+                            All Rights Reserved.
+                        </i></font></td><td align="right"><font color="#525D76" size="-1" face="arial,helvetica,sanserif"><i>
+                            last modified:
+                            <script language="JavaScript"> document.write(document.lastModified); </script></i></font></td>
+</tr>
+</table>
+</body>
+</html>

Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/properties.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/properties.html
------------------------------------------------------------------------------
    svn:keywords = Date Author Id Revision HeadURL

Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/properties.html
------------------------------------------------------------------------------
    svn:mime-type = text/html



Mime
View raw message