Java Service Wrapper - wrapper.statusfile Property

Return-Path: Delivered-To: apmail-geronimo-scm-archive@www.apache.org Received: (qmail 24495 invoked from network); 15 Feb 2007 05:50:34 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 15 Feb 2007 05:50:34 -0000 Received: (qmail 38511 invoked by uid 500); 15 Feb 2007 05:50:36 -0000 Delivered-To: apmail-geronimo-scm-archive@geronimo.apache.org Received: (qmail 38492 invoked by uid 500); 15 Feb 2007 05:50:36 -0000 Mailing-List: contact scm-help@geronimo.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: Reply-To: dev@geronimo.apache.org List-Id: Delivered-To: mailing list scm@geronimo.apache.org Received: (qmail 38316 invoked by uid 99); 15 Feb 2007 05:50:34 -0000 Received: from herse.apache.org (HELO herse.apache.org) (140.211.11.133) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 14 Feb 2007 21:50:34 -0800 X-ASF-Spam-Status: No, hits=-9.4 required=10.0 tests=ALL_TRUSTED,NO_REAL_NAME X-Spam-Check-By: apache.org Received: from [140.211.11.3] (HELO eris.apache.org) (140.211.11.3) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 14 Feb 2007 21:50:17 -0800 Received: by eris.apache.org (Postfix, from userid 65534) id CB5A91A987E; Wed, 14 Feb 2007 21:49:06 -0800 (PST) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r507826 [19/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 -0000 To: scm@geronimo.apache.org From: jdillon@apache.org X-Mailer: svnmailer-1.1.0 Message-Id: <20070215054906.CB5A91A987E@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Added: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-statusfile.html URL: http://svn.apache.org/viewvc/geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-statusfile.html?view=auto&rev=507826 ============================================================================== --- geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-statusfile.html (added) +++ geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-statusfile.html Wed Feb 14 21:48:50 2007 @@ -0,0 +1,352 @@ + + + +Java Service Wrapper - wrapper.statusfile Property + + + + + + + + + + + + + +

+ + + + + + + +

+ + + + +

+ + +

+Hosted by: +
+ +
+

+ + + + + + + + + + + + + + + + + + + +

+ + + + +

+ + + + + + + + + + +

wrapper.statusfile Property

+wrapper.statusfile Property + + + + + + + + + + + + + +

Configuration Property Overview

+ + +

+ +

+ + + + + + + + + + + + +

wrapper.statusfile

+ + +

+ File to write the current Wrapper status to. If set, a file containing the + latest status of the Wrapper process will be written to the specified location + when the process is launched and then whenever the internal status changes. + The file will be deleted when the Wrapper process has terminated. This + property is not set by default. +

+ +

+ This property has no use for most applications. It can be useful to + external applications which need to monitor the Wrapper's state however. +

+ +

+ + + + +

+NOTE MEG +

+ +

+ The Wrapper needs to be able to open and then write to this file + whenever its status is changed. The Wrapper does include code + which allows for the file being briefly locked by an external + process. However, the Wrapper will fail with a warning in the + log if the file remains locked for more that 1 second. This will + not affect the operation of the Wrapper. +

+ +

+ + + + + + + + +

Example:
+ wrapper.statusfile=./myapp.status +

+ +

+ The file is formatted as a one line text file with a single token + indicating the current Wrapper status. Possible values include: +

+ +

+ +STARTING - The Wrapper is still starting. + It will remain in this state until the first Java process has completed its + startup, or the Wrapper begins to shut down. +
+ +STARTED - The Wrapper is started. + It will remain in this state until the Wrapper begins to shut down. +
+ +STOPPING - The Wrapper has begin to shutdown. + It will remain in this state until the Java process is completely shut down. +
+ +STOPPED - The Wrapper is ready to exit. + This state only exists immediately before the Wrapper process terminates. +

+ +

+ + + + +

+NOTE MEG +

+ +

+ +Reloading + the Wrapper configuration will have no effect on the value of this property. + Changes will not take effect until the Wrapper has been restarted. +

+ +

+by Leif Mortenson +

+ + + + +

+ last modified: +

+ + Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-statusfile.html ------------------------------------------------------------------------------ svn:eol-style = native Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-statusfile.html ------------------------------------------------------------------------------ svn:keywords = Date Author Id Revision HeadURL Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-statusfile.html ------------------------------------------------------------------------------ svn:mime-type = text/html Added: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-successful-invocation-time.html URL: http://svn.apache.org/viewvc/geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-successful-invocation-time.html?view=auto&rev=507826 ============================================================================== --- geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-successful-invocation-time.html (added) +++ geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-successful-invocation-time.html Wed Feb 14 21:48:50 2007 @@ -0,0 +1,289 @@ + + + +Java Service Wrapper - wrapper.successful_invocation_time Property + + + + + + + + + + + + + +

+ + + + + + + +

+ + + + +

+ + +

+Hosted by: +
+ +
+

+ + + + + + + + + + + + + + + + + + + +

+ + + + +

+ + + + + + + + + + +

wrapper.successful_invocation_time Property

+wrapper.successful_invocation_time Property + + + + + + + + + + + + + +

Configuration Property Overview

+ + +

+ +

+ + + + + + + + + + + + +

wrapper.successful_invocation_time

+ + +

+ Specifies the amount of time that an application must remain + running before it will be considered to have been a successful + invocation. This property's use is described in the description of + the wrapper.max_failed_invocations + property. Defaults to 300 seconds. +

+ + + + + + + + +

Example:
+ wrapper.successful_invocation_time=300 +

+ +

+ + + + +

+WARNING +

+ +

+ If the specified time is too short then all + invocations may be viewed as having been successful. This + can lead to a case where the JVM is restarted infinitely. +

+ +

+by Leif Mortenson +

+ + + + +

+ last modified: +

+ + Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-successful-invocation-time.html ------------------------------------------------------------------------------ svn:eol-style = native Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-successful-invocation-time.html ------------------------------------------------------------------------------ svn:keywords = Date Author Id Revision HeadURL Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-successful-invocation-time.html ------------------------------------------------------------------------------ svn:mime-type = text/html Added: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-syslog-facility.html URL: http://svn.apache.org/viewvc/geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-syslog-facility.html?view=auto&rev=507826 ============================================================================== --- geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-syslog-facility.html (added) +++ geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-syslog-facility.html Wed Feb 14 21:48:50 2007 @@ -0,0 +1,280 @@ + + + +Java Service Wrapper - wrapper.syslog.facility Property + + + + + + + + + + + + + +

+ + + + + + + +

+ + + + +

+ + +

+Hosted by: +
+ +
+

+ + + + + + + + + + + + + + + + + + + +

+ + + + +

+ + + + + + + + + + +

wrapper.syslog.facility Property

+wrapper.syslog.facility Property + + + + + + + + + + + + + +

Configuration Property Overview

+ + +

+ +

+ + + + + + + + + + + + +

wrapper.syslog.facility

+ + +

+ Facility to use when logging to the syslog on UNIX systems. Valid + facility values include USER, + LOCAL0, + LOCAL1, + LOCAL2, + LOCAL3, + LOCAL4, + LOCAL5, + LOCAL6, and + LOCAL7. The default value is + USER. +

+ + + + + + + + +

Example:
+ wrapper.syslog.facility=USER +

+ +

+ Custom facility values are used to set up things like remote + logging, etc. +

+ +

+by Leif Mortenson +

+ + + + +

+ last modified: +

+ + Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-syslog-facility.html ------------------------------------------------------------------------------ svn:eol-style = native Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-syslog-facility.html ------------------------------------------------------------------------------ svn:keywords = Date Author Id Revision HeadURL Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-syslog-facility.html ------------------------------------------------------------------------------ svn:mime-type = text/html Added: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-syslog-ident.html URL: http://svn.apache.org/viewvc/geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-syslog-ident.html?view=auto&rev=507826 ============================================================================== --- geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-syslog-ident.html (added) +++ geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-syslog-ident.html Wed Feb 14 21:48:50 2007 @@ -0,0 +1,272 @@ + + + +Java Service Wrapper - wrapper.syslog.ident Property + + + + + + + + + + + + + +

+ + + + + + + +

+ + + + +

+ + +

+Hosted by: +
+ +
+

+ + + + + + + + + + + + + + + + + + + +

+ + + + +

+ + + + + + + + + + +

wrapper.syslog.ident Property

+wrapper.syslog.ident Property + + + + + + + + + + + + + +

Configuration Property Overview

+ + +

+ +

+ + + + + + + + + + + + +

wrapper.syslog.ident

+ + +

+ Used to specifiy the identity field used in syslog entries. Defaults + to the value of the wrapper.ntservice.name + property to provide backwards compatibility. +

+ + + + + + + + +

Example:
+ wrapper.syslog.ident=myapp +

+ +

+ In most cases, users do not need to set this property themselves as + it is set in the shell script which is distributed with the Wrapper. +

+ +

+by Leif Mortenson +

+ + + + +

+ last modified: +

+ + Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-syslog-ident.html ------------------------------------------------------------------------------ svn:eol-style = native Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-syslog-ident.html ------------------------------------------------------------------------------ svn:keywords = Date Author Id Revision HeadURL Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-syslog-ident.html ------------------------------------------------------------------------------ svn:mime-type = text/html Added: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-syslog-loglevel.html URL: http://svn.apache.org/viewvc/geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-syslog-loglevel.html?view=auto&rev=507826 ============================================================================== --- geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-syslog-loglevel.html (added) +++ geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-syslog-loglevel.html Wed Feb 14 21:48:50 2007 @@ -0,0 +1,277 @@ + + + +Java Service Wrapper - wrapper.syslog.loglevel Property + + + + + + + + + + + + + +

+ + + + + + + +

+ + + + +

+ + +

+Hosted by: +
+ +
+

+ + + + + + + + + + + + + + + + + + + +

+ + + + +

+ + + + + + + + + + +

wrapper.syslog.loglevel Property

+wrapper.syslog.loglevel Property + + + + + + + + + + + + + +

Configuration Property Overview

+ + +

+ +

+ + + + + + + + + + + + +

wrapper.syslog.loglevel

+ + +

+ Log level to use for logging to the Event Log on Windows systems, + or the syslog on unix systems. Valid log levels include: + NONE for no log output, + FATAL to only log fatal error + messages, ERROR to log all + error messages, STATUS to log + all state changes, INFO logs + all JVM output and informative messages, and + DEBUG logs detailed debug + information. The default value is + NONE. Be careful setting log + which are too low. DEBUG for + example will very quickly fill up your syslog or event log. +

+ + + + + + + + +

Example:
+ wrapper.syslog.loglevel=NONE +

+ +

+by Leif Mortenson +

+ + + + +

+ last modified: +

+ + Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-syslog-loglevel.html ------------------------------------------------------------------------------ svn:eol-style = native Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-syslog-loglevel.html ------------------------------------------------------------------------------ svn:keywords = Date Author Id Revision HeadURL Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-syslog-loglevel.html ------------------------------------------------------------------------------ svn:mime-type = text/html Added: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-thread-count-delay.html URL: http://svn.apache.org/viewvc/geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-thread-count-delay.html?view=auto&rev=507826 ============================================================================== --- geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-thread-count-delay.html (added) +++ geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-thread-count-delay.html Wed Feb 14 21:48:50 2007 @@ -0,0 +1,255 @@ + + + +Java Service Wrapper - wrapper.thread_count_delay Property + + + + + + + + + + + + + +

+ + + + + + + +

+ + + + +

+ + +

+Hosted by: +
+ +
+

+ + + + + + + + + + + + + + + + + + + +

+ + + + +

+ + + + + + + + + + +

wrapper.thread_count_delay Property

+wrapper.thread_count_delay Property + + + + + + + + + + + + + +

Configuration Property Overview

+ + +

+ +

+ + + + + + + + + + + + +

wrapper.thread_count_delay

+ + +

+ As of version 3.2.1, this property has been deprecated and is now + ignored by the Wrapper. +

+ +

+by Leif Mortenson +

+ + + + +

+ last modified: +

+ + Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-thread-count-delay.html ------------------------------------------------------------------------------ svn:eol-style = native Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-thread-count-delay.html ------------------------------------------------------------------------------ svn:keywords = Date Author Id Revision HeadURL Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-thread-count-delay.html ------------------------------------------------------------------------------ svn:mime-type = text/html Added: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-umask.html URL: http://svn.apache.org/viewvc/geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-umask.html?view=auto&rev=507826 ============================================================================== --- geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-umask.html (added) +++ geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-umask.html Wed Feb 14 21:48:50 2007 @@ -0,0 +1,392 @@ + + + +Java Service Wrapper - wrapper.umask Property + + + + + + + + + + + + + +

+ + + + + + + +

+ + + + +

+ + +

+Hosted by: +
+ +
+

+ + + + + + + + + + + + + + + + + + + +

+ + + + +

+ + + + + + + + + + +

wrapper.umask Property

+wrapper.umask Property + + + + + + + + + + + + + +

Configuration Property Overview

+ + +

+ +

+ + + + + + + + + + + + +

wrapper.umask

+ + +

+ Sets the umask used when creating files. The umask is used to disable + certain permission bits for files. Values can be entered in decimal + or hexadecimal or octal formats. Defaults to 0022 which is an octal + number. +

+ +

+ Values beginning with '0x' will be treated as hexadecimal (base 16). + The leading '0' causes the number to be parsed as octal (base 8) + otherwise it is treated as a decimal (base 10) number, +

+ +

+ In octal format the umask is defined as a 3 digit number starting with + a 0. The first, left-most, digit specifies the blocked permissions for + the user creating the file. The second digit specifies the blocked + permissions for other users who are members of the file's group. + The third, right-most, digit specifies the blocked permissions for + any other user. +

+ +

+ Each digit is specified by adding up the following values: 4 to restrict + read access, 2 to restrict write access, 1 to restrict executable access. + A value of 7 thus restricts read, write and execute access. +

+ +

+ The default umask of 0022 will thus restrict all users except the + creator from writing or modifying files. To prevent other users + from being able to execute or even see the files a value of 0077 + should be used. +

+ + + + + + + + +

Example:
+ wrapper.umask=0022 +

+ +

+ + + + + + + + + + + + +

wrapper.*.umask

+ + +

+ The Wrapper also makes it possible to specify the umask for particular + files created by the Wrapper by using the following properties. Each + defaults to the value of the + wrapper.umask property. +

+ +

+ +wrapper.umask Specifies the default + umask and umask of the Wrapper process. +
+ +wrapper.java.umask Specifies the + default umask of the Java process and thus of any files created by + the Java application. +
+ +wrapper.pidfile.umask Specifies the + umask to use when creating the pid file. See the + wrapper.pidfile property. +
+ +wrapper.lockfile.umask Specifies the + umask to use when creating the lock file. See the + wrapper.lockfile property. +
+ +wrapper.java.pidfile.umask Specifies the + umask to use when creating the Java pid file. See the + wrapper.java.pidfile property. +
+ +wrapper.java.idfile.umask Specifies the + umask to use when creating the Java id file. See the + wrapper.java.idfile property. +
+ +wrapper.statusfile.umask Specifies the + umask to use when creating the status file. See the + wrapper.statusfile property. +
+ +wrapper.java.statusfile.umask Specifies the + umask to use when creating the Java status file. See the + wrapper.java.statusfile property. +
+ +wrapper.anchorfile.umask Specifies the + umask to use when creating the anchor file. See the + wrapper.anchorfile property. +
+ +wrapper.logfile.umask Specifies the + umask to use when creating the log file. See the + wrapper.logfile property. +

+ +

+by Leif Mortenson +

+ + + + +

+ last modified: +

+ + Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-umask.html ------------------------------------------------------------------------------ svn:eol-style = native Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-umask.html ------------------------------------------------------------------------------ svn:keywords = Date Author Id Revision HeadURL Propchange: geronimo/sandbox/build-support/libraries/jsw/3.2.3/doc/english/prop-umask.html ------------------------------------------------------------------------------ svn:mime-type = text/html