diff options
Diffstat (limited to 'rubbos/app/tomcat-connectors-1.2.32-src/xdocs/miscellaneous')
6 files changed, 3208 insertions, 0 deletions
diff --git a/rubbos/app/tomcat-connectors-1.2.32-src/xdocs/miscellaneous/changelog.xml b/rubbos/app/tomcat-connectors-1.2.32-src/xdocs/miscellaneous/changelog.xml new file mode 100644 index 00000000..f9db9868 --- /dev/null +++ b/rubbos/app/tomcat-connectors-1.2.32-src/xdocs/miscellaneous/changelog.xml @@ -0,0 +1,2157 @@ +<?xml version="1.0"?> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<!DOCTYPE document [ + <!ENTITY project SYSTEM "project.xml"> +]> +<document url="changelog.html"> + + &project; + + <properties> + <author email="mturk@apache.org">Mladen Turk</author> + <author email="rjung@apache.org">Rainer Jung</author> + <author email="hgomez@apache.org">Henri Gomez</author> + <author email="timw@apache.org">Tim Whittington</author> + <title>Changelog</title> + </properties> + +<body> + +<section name="Preface"> + <p> + This is the Changelog for Tomcat Connectors. This changelog + does not contain all updates and fixes to the Tomcat connectors (yet). + It should contain fixes made only after November 10th 2004, when the + new documentation project for JK was started. + </p> +</section> +<section name="Changes between 1.2.31 and 1.2.32"> + <br /> + <subsection name="Native"> + <changelog> + <fix> + <bug>51417</bug>: Fix worker busy detection by querying the + worker endpoint. Abandoned connections can leave a worker + in busy state without decrementing busy counter. (mturk) + </fix> + <fix> + <bug>50339</bug>: Fix whitespace trimming when parsing attribute + lists. (rjung) + </fix> + <fix> + <bug>41263</bug>: Support Servlet API getRemotePort(). + Works for Tomcat 5.5.28, 6.0.20 and 7.0.0 and Apache and ISAPI + plugins. (rjung) + </fix> + <fix> + <bug>41923</bug>: AJP: Close AJP connection to Tomcat on client write + error when recovery_options 4 is specified, aborting the response + write on the Tomcat side. (timw) + </fix> + <update> + AJP: Cap the lingering bytes that will be read + when shutting down an AJP socket at 32k to prevent CPU spikes + in the web server when a client aborts on a large response body. + Also reduce total linger time to 2s. (timw) + </update> + <fix> + <bug>50839</bug>: AJP: Fix 30sec CPU spike due to incorrect counting + of lingering bytes causing a busy loop when a client aborts + connection during a response write. + Fixes regression in 1.2.31. (timw) + </fix> + <add> + LB: Forward worker activation state as request attribute + "JK_LB_ACTIVATION". Possible values are "ACT" (active), + "DIS" (disabled) and "STP" (stopped). (rjung) + </add> + <fix> + HTTPD: Forward WWW-Authenticate from backend when status is 401 + and server generated error pages are used. (rjung) + </fix> + <fix> + <bug>50363</bug>: IIS: Prevent chunk encoding of empty message + bodies for 204, 205 and 304 responses. (timw) + </fix> + <fix> + <bug>50975</bug>: IIS: Fix hanging of Transfer-Encoding: chunked + requests when Content-Length header is present in request as well. + Also addresses situation where IIS appears to create a Content-Length + header for a small chunk encoded request when none was present in the + original request. (timw) + </fix> + <fix> + <bug>47679</bug>: IIS: stop truncation of request headers when + ISAPI redirector used as an extension without the corresponding + filter installed. (timw) + </fix> + <fix> + NSAPI: Use lower case header names for responses. + Otherwise the web server might add chunked transfer encoding header + in addition to our content length header. + </fix> + <update> + Docs: Improve load balancer documentation. (rjung) + </update> + </changelog> + </subsection> +</section> +<section name="Changes between 1.2.30 and 1.2.31"> + <br /> + <subsection name="Native"> + <changelog> + <fix> + <bug>49413</bug>: AJP13: Drop flush packets send by the backend + after the response has been finished. (rjung) + </fix> + <update> + AJP: Log the local and remote socket address. (mturk) + </update> + <update> + Watchdog: Move the maintain workers outside the critical + section allowing other threads to use the connection + pool during maintenance. (mturk) + </update> + <update> + Common: Add svn revision to init log message. (rjung) + </update> + <fix> + Common: Don't destroy errno during trace logging. (rjung) + </fix> + <update> + Apache: Add support for Apache 2.3/2.4. (rjung) + </update> + <update> + Apache: Added version number resource for mod_jk.so on Windows. (timw) + </update> + <update> + <bug>48501</bug>: IIS: Added rotatelogs style log rotation to ISAPI + Redirector. (timw) + </update> + <fix> + <bug>38895</bug>: IIS: Use RAW headers instead of CGI headers by default + to prevent conversion of underscores '_' to hyphens '-' in header names. + Old behaviour can be enabled by defining USE_CGI_HEADERS. (timw) + </fix> + <fix> + <bug>49511</bug>: IIS: Do not override IIS log information when subsequent + requests on a keep-alive connection are not mapped into the ISAPI Redirector. (timw) + </fix> + <fix> + Docs: Document SSLOptions needed for SSL information forwarding. (rjung) + </fix> + <update> + Docs: Grammar and style improvements and clarification about serving + static content by IIS. + Patch provided by André Warnier. (rjung) + </update> + <fix> + Docs: Update subversion paths used in docs. (rjung) + </fix> + </changelog> + </subsection> +</section> +<section name="Changes between 1.2.28 and 1.2.30"> + <br /> + <subsection name="Native"> + <changelog> + <update> + Apache: Improve compatibility with Apache 2.3. (rjung) + </update> + <fix> + <bug>46632</bug>: Apache: Do not register child cleanup for + our pools. (mturk) + </fix> + <fix> + <bug>46893</bug>: Apache: Log warning only if JkShmSize was actually + set in the configuration. (mturk) + </fix> + <update> + IIS: Include optional chunking support. Off by default. (mturk) + </update> + <fix> + <bug>48763</bug>: IIS: Do not send Content-Length when using chunked encoding + or length larger 4GB. (mturk) + </fix> + <fix> + <bug>48223</bug>: IIS: Propagate correct backend error code to IIS. (rjung) + </fix> + <fix> + <bug>47867</bug>: IIS: crash during startup, when compiled with VS2008 + and workers.properties contains unsupported properties. + Patch provided by Indrek Juhani (rjung) + </fix> + <fix> + <bug>47628</bug>: IIS: Fix deadlock when restarting the Application Pool + caused by not releasing the critical section lock. + Patch provided by Bret Prucha. (mturk) + </fix> + <fix> + IIS/NSAPI: Correct log file flushing after each line. (mturk) + </fix> + <add> + NSAPI: Add Microsoft Visual C++ Makefile. (mturk) + </add> + <update> + AJP: Improve socket shutdown handling. (mturk) + </update> + <update> + AJP: Ensure we never reuse a non reusable socket. (mturk) + </update> + <update> + AJP: Tolerate a single excess packet when waiting for cpong. (mturk) + </update> + <update> + AJP: Check protocol correctness more strictly. (mturk) + </update> + <update> + <bug>48410</bug>: AJP: Use poll instead select so we can work with more + then 1024 sockets. (mturk) + </update> + <fix> + <bug>46503</bug>: AJP/Status: Garbage data in worker domain and route. (mturk) + </fix> + <fix> + <bug>48276</bug>: AJP: When worker contact cannot be resolved mark the + worker as disabled instead failing to start the server. (mturk) + </fix> + <fix> + <bug>48169</bug>: AJP: Improve CGI interoperability by closing all + sockets during EXEC. (mturk) + </fix> + <add> + Status: Add number of open backend connections to status worker. + This feature is experimental, the displayed value might not be + accurate. (mturk) + </add> + <update> + <bug>47224</bug>: Status: When address gets changed invalidate + all opened sockets in the endpoint cache. This will cause new + backend connections to get opened using new address. (mturk) + </update> + <fix> + <bug>48305</bug>: Status: Do not show "secret" property when + doing dump. (mturk) + </fix> + <fix> + <bug>45610</bug>: Status: Don't accept requests with + empty value for sub worker parameter. (rjung) + </fix> + <fix> + <bug>45610</bug>: Status: Fix erroneous unsetting of + sticky_session and sticky_session_force when updating other + load balancer attributes via the status worker. (rjung) + </fix> + <fix> + <bug>47222</bug>: Status: Add ping_timeout to the shared memory + and allow dynamic configuration. (mturk) + </fix> + <fix> + Status: Remove duplicate "errors" line in property view of + AJP13 workers that are part of a load balancer. (rjung) + </fix> + <fix> + LB: Fix route logging. (rjung) + </fix> + <update> + Logging: Automatically detect size of thread id for logging. (rjung) + </update> + <update> + Logging: Add optional log file locking for Windows when defining + JK_LOG_LOCKING. (mturk) + </update> + <update> + Configuration: Update example configuration. (rjung) + </update> + <update> + Docs: Update information about tools needed to create a release. (rjung) + </update> + <fix> + <bug>47983</bug>: Docs: Fix typo in example config + which breaks startup. (rjung) + </fix> + <update> + Build: Force copy of automake files. (rjung) + </update> + <update> + Build: Tomcat code repository structure cleanup reflected in documentation + and build script. (rjung, mturk) + </update> + </changelog> + </subsection> +</section> +<section name="Changes between 1.2.27 and 1.2.28"> + <br /> + <subsection name="Native"> + <changelog> + <add> + Apache: Add more environment variables to overwrite request + information. Useful in case a proxy is in front of Apache and sends + us original request information e.g. via custom headers. (rjung) + </add> + <update> + Apache: No longer preallocate entries for JK request log. (rjung) + </update> + <fix> + <bug>46352</bug>: Apache: Fix crash when using SetHandler jakarta-servlet + in VHost without any JkMount. Crash due to incorrect initialization + of mount extensions. (rjung) + </fix> + <fix> + Apache: JkWatchdogInterval had wrong interval calculation + causing a 10 times higher watchdog interval then configured. (mturk) + </fix> + <fix> + Apache: Activate forwarding of SSL key size by default. (rjung) + </fix> + <fix> + <bug>46169</bug>: Apache 1.3: Backport use_server_errors mount extension. (rjung) + </fix> + <fix> + <bug>46763</bug>: Apache 2.0: Survive the log mutex during graceful + restart. Patch provided by Eiji Takahashi. (mturk) + </fix> + <fix> + <bug>46416</bug>: Apache 2.0 on Windows: Include mstcipip.h even if + the apr doesn't include it. (mturk) + </fix> + <update> + IIS: Update uriworkermap.properties file on + a regular interval. This requires both worker_mount_reload + and watchdog_interval to be defined. (mturk) + </update> + <update> + IIS: Remove obsolete entries from registry file. (mturk) + </update> + <fix> + <bug>46579</bug>: IIS: Use local environment table instead environment + variables for setting the JKISAPI_PATH and JKISAPI_NAME. (mturk) + </fix> + <update> + LB: Add new property error_escalation_time to fine tune + escalation of local errors to global errors. (rjung) + </update> + <update> + LB: If the sticky session affinity mark contains a dot, treat the + part before the dot as the domain name. This allows to have full node + session affinity with domain failover. (mturk) + </update> + <fix> + LB: make forced recovery work with local error states. (rjung) + </fix> + <fix> + LB: Only update error state and error time, if we actually have a new state. (rjung) + </fix> + <fix> + LB: Set global worker state to error when we reach max_reply_timeouts, + or fail_on_status triggered hard error. (rjung) + </fix> + <update> + AJP: Add a new error type JK_AJP_PROTOCOL_ERROR. (mturk) + </update> + <update> + AJP: Allow worker ports lower or equal to 1024. (rjung) + </update> + <update> + AJP: Improve some AJP error log messages. (mturk) + </update> + <update> + Status: Allow changing worker address and port of AJP workers. + The address is resolved on next request for that worker. (mturk) + </update> + <update> + Status: Allow update actions to show error messages in the result page. (rjung) + </update> + <update> + Status: Refactor update actions. (rjung) + </update> + <update> + Status: Do not redirect to the show or list page, if an error occured + during an action. (rjung) + </update> + <update> + Status: Include error time in display. (rjung) + </update> + <update> + Status: Remove redundant port information from worker display. + Rename address column and remove its explanation from the legend. (rjung) + </update> + <update> + Status: Optimize forced uriworkermap.properties reload. (mturk) + </update> + <fix> + Status: Fix crash in text display. (rjung) + </fix> + <fix> + Status: Show - Edit - Show always ends in single lb member show, + even when started from all members lb show. (rjung) + </fix> + <fix> + Status: Wildcards in sub worker names were broken for update actions. (rjung) + </fix> + <fix> + Status: Add use_server_errors to map display. (rjung) + </fix> + <update> + SHM: Move locking into the data pull and push methods. (rjung) + </update> + <update> + JNI: Deprecate JNI workers. (rjung) + </update> + <fix> + Netware: Missing define for MAX_PATH. Patch by Guenter Knauf. (rjung) + </fix> + <update> + Docs: Add a new HowTo page about reverse proxies. (rjung) + </update> + <update> + Docs: Add an explanation of local error states to the timeouts documentation. (rjung) + </update> + <update> + Docs: Clarify relation between socket_timeout and socket_connect_timeout. (rjung) + </update> + <update> + Docs: Clarify IIS URL rewrite feature. (rjung) + </update> + <fix> + <bug>46834</bug>,<bug>46734</bug>: Docs: Fix a couple of missing or broken links. (markt,rjung) + </fix> + <fix> + Docs: Add 2008 news to main page and menues. (mturk, rjung) + </fix> + </changelog> + </subsection> +</section> +<section name="Changes between 1.2.26 and 1.2.27"> + <br /> + <subsection name="Native"> + <changelog> + <fix> + <bug>46109</bug>: Decay reply_timeouts even when lb method is + busyness. Also reset reply_timeouts during forced recovery. (rjung) + </fix> + <update> + AJP13: Recycle connection if previous request didn't complete. (mturk) + </update> + <update> + Maintain should not run multiple times in parallel. (mturk) + </update> + <fix> + Apache: Fix small memory leak during restart. (mturk) + </fix> + <update> + Improve signal handling during socket shutdown. (mturk) + </update> + <add> + URI Map: Add debug dump function for uri worker map. (rjung) + </add> + <update> + Add revision number to version info for non-release builds. (rjung) + </update> + <add> + IIS: Optionally allow chunked encoding for responses. + At the moment only usable, if build with ISAPI_ALLOW_CHUNKING + defined. Based on patch by Tim Whittington. (rjung) + </add> + <update> + IIS: Optionally use raw headers instead of CGI + headers. Fixes problem "underscore=dash" problem in + header names. At the moment only available, if build with USE_RAW_HEADERS + defined. (rjung) + </update> + <update> + IIS: Optionally improve IIS 5.1 compatibility. + At the moment only available, if build with AUTOMATIC_AUTH_NOTIFICATION + defined. Based on patch by Tim Whittington. (rjung) + </update> + <fix> + IIS: Fix memory corruption due to parallel initialization + by multiple threads. (rjung) + </fix> + <update> + Windows: Use non-default socket keepalive interval. (mturk) + </update> + <add> + IIS: Add environment variables JKISAPI_PATH and JKISAPI_NAME. (mturk) + </add> + <add> + Added socket_connect_timeout directive for setting the + connect timeout for the socket. This enables to have low + connection timeout but higher operational timeouts. (mturk) + </add> + <fix> + AJP13: + [<a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2008-5519"><b>CVE-2008-5519</b></a>] + Always send initial POST packet even if the client + disconnected after sending request but before providing + POST data. In that case or in case the client broke the + connection in a middle of read send an zero size packet + informing container about broken client connection. (mturk) + </fix> + <add> + AJP13: Added connection_acquire_timeout directive for setting the + absolute timeout the worker will wait for a free endpoint. (mturk) + </add> + <update> + Apache: Allow to set path parameter used when doing JkStripSession. (mturk) + </update> + <update> + Refactor retries implementation and change semantics of retries attributes. (mturk) + </update> + <update> + Status: Allow showing only a single member for a load balancer. (rjung) + </update> + <update> + Status: Add display of seconds since last statistics reset and access and + transfer rates. (rjung) + </update> + <add> + AJP13: Add a configurable retry_interval time. (rjung) + </add> + <update> + Documentation: Enhance description of connection_pool_size. (rjung) + </update> + <update> + IIS: Refactor error page generation. (mturk) + </update> + <fix> + IIS: SERVER_NAME variable can be the same for + multiple different server instances if requests + are handled according to the ip:port combination. + Use INSTANCE_ID variable to which the request + belongs instead. (mturk) + </fix> + <add> + Allow forwarding server error pages. This can be done + on per-uri basis using new use_server_errors extension. + (mturk) + </add> + <add> + Added session_cookie and session_path for configuring + default session identifiers. (mturk) + </add> + <update> + Use max_packet_size also as TCP send and receive buffer size. (mturk) + </update> + <update> + Apache: Do not allow Apache to start in multi-threaded mode if mod_jk + was only build for single threaded server (prefork). (mturk) + </update> + <fix> + <bug>45812</bug>: Add done() service method that + causes sending EOS bucket for Apache httpd 2.x. + This allows filter chain to work properly. (mturk) + </fix> + <add> + Added connection_ping_interval, ping_timeout and ping_mode directives. + (mturk) + </add> + <fix> + Apache: Use correct ld flags provided by apxs when building module. + Prevents some crashes on AIX for httpd 1.3 module. (rjung) + </fix> + <fix> + Documentation: "val" attribute numbering in status worker + needs to start with 0 instead of 1. (rjung) + </fix> + <update> + Documentation: Remove JNI parameters from sample configuration + in the workers generic howto. (rjung) + </update> + <fix> + <bug>45026</bug>: For Apache httpd 2.x add "Unknown Reason" + as the reason phrase, if we get an empty one from the backend. + Otherwise httpd 2.x returns status 500. (rjung) + </fix> + <fix> + Build: Fix Cygwin build. (rjung) + </fix> + <update> + Documentation: Add info to docs, that variables sent via JkEnvVar + are not listed in request.getAttributeNames(). (rjung) + </update> + <add> + Add watchdog background thread for Apache 2.x and IIS + doing internal maintenance (idle connection checks, backend probing). + See JkWatchdogInternal (Apache) and watchdog_interval (IIS). (mturk) + </add> + <update> + Change log level of some messages from error to info. (mturk) + </update> + <fix> + Documentation: Fix docs for worker attribute "secret". (rjung) + </fix> + <update> + Detect correct plugin name for various web servers via additional + preprocessor defines. (rjung) + </update> + <fix> + LB: Do not put loadbalancer node in error state if there is opened + channel. This fixes the bug when new connection fails due to + busyness, causing opened connections fail stickyness. + This brings back per-node busy counter and private state array + for each request. We can mark the state as error for failover to + work while still operating and reporting node as OK if there are + opened working connections. (mturk) + </fix> + <fix> + <bug>44738</bug>: Fix merging of JkOption ForwardURI* between virtual hosts. + Patch contributed by Toshihiro Sasajima. (rjung) + </fix> + <add> + URI Map: Add extension attributes to uri worker map. + Allowed are reply_timeout, active/disabled/stopped + and fail_on_status. + Usage currently only implemented for httpd and IIS. (rjung+mturk) + </add> + <fix> + URI Map: Make dynamic reloading atomic and free memory + not needed any longer. (rjung) + </fix> + <add> + Configure: Don't use post httpd 2.2.0 API functions when building + with new --enable-api-compatibility configure switch. (rjung) + </add> + <fix> + Apache: JkAutoAlias does not work in combination with JkMountCopy + if there are no JkMount in virtual host. (rjung) + </fix> + <update> + LB: Optimize state macros to improve performance. (rjung) + </update> + <add> + Apache: Allow dynamic setting of reply timeout using the environment + variable JK_REPLY_TIMEOUT. (rjung) + </add> + <add> + Status: Add manageability for ajp parameters of ajp + workers and ajp lb members. (rjung) + </add> + <update> + Status: Change parameter names of update action to + make them more easily distinguishable from other parameters. (rjung) + </update> + <add> + Status: Add ajp worker statistics also for + workers, that are not lb members. (rjung) + </add> + <update> + AJP: Refactor factories, move ajp13/ajp14 common parts into + ajp_factory. (rjung) + </update> + <update> + Status: Only sync shm worker config values of the workers + for which we changed values. (rjung) + </update> + <fix> + Status: Set lb_factor instead of distance. (rjung) + </fix> + <update> + Status: Minor layout changes, use drop down instead of multiple + text links. (rjung) + </update> + <update> + SHM: Use local copies of read mostly attributes of lb sub workers + in lb and status worker. (rjung) + </update> + <update> + Status: Add "dump" action to dump our initial configuration. (rjung) + </update> + <update> + Status: Use property table to decide which cmd action uses which + output elements. (rjung) + </update> + <update> + Common: Include original configuration map in worker_env + to make it available for workers, e.g. the status worker. (rjung) + </update> + <update> + LB: Refactor "route" return for httpd note. Don't use a + member of the worker_record, because that's not thread safe. (rjung) + </update> + <update> + Common: Refactor "retries", remove from service and jk_worker, + move into ajp worker instead. (rjung) + </update> + <update> + SHM: Use distinct structs for lb and ajp13 in shm. + Improves type safety and saves a few bytes. (rjung) + </update> + <update> + SHM: Remove unused attributes. (rjung) + </update> + <update> + SHM: Automatically determine shm size for all web servers. (rjung) + </update> + <update> + SHM: Make open/attach logging consistent for all web servers. (rjung) + </update> + <update> + Status: Include server local time in output. (rjung) + </update> + <fix> + <bug>44116</bug>: Fix handling of multiple JSESSIONID cookies. (rjung) + </fix> + <fix> + <bug>37850</bug>: Use thread safe localtime_r where appropriate. (rjung) + </fix> + <fix> + Use thread safe strtok_r on more platforms, especially AIX. (rjung) + </fix> + <update> + Status: Improve XSS hardening. (rjung) + </update> + <update> + <bug>35303</bug>: Move initialization of service members with defaults from + web server specific code to our generic jk_init_ws_service() function. (rjung) + </update> + <fix> + <bug>36385</bug>: Add missing prepost CPing/CPong directly after connect + in case prepost CPing is used, but no connect CPing. (rjung) + </fix> + <update> + <bug>37322</bug>: Apache: Enhance robustness of message formating + in jk_error_exit(). (rjung) + </update> + <fix> + <bug>44147</bug>: Multiple load balancing workers problem. (rjung) + </fix> + </changelog> + </subsection> +</section> +<section name="Changes between 1.2.25 and 1.2.26"> + <br /> + <subsection name="Native"> + <changelog> + <fix> + <bug>42003</bug>: Allocate memory instead using fixed size from + the stack. (mturk) + </fix> + <fix> + <bug>43229</bug>: Load balancer does not do fail over after + reply timeouts. (rjung) + </fix> + <fix> + JKStatus: Repair detailed Apache httpd version display. + This was broken for httpd version 2.2.4+. (rjung) + </fix> + <update> + LB/AJP: Refactoring of jk_connect.c, jk_ajp_common.c, + jk_lb_worker.c (rjung) + </update> + <fix> + Configure: Repair broken apxs auto-detection. (rjung) + </fix> + <update> + Configure: Remove trace logging from compiled code + via new --disable-trace configure switch. (rjung) + </update> + <update> + Common: Maintain idle connections in decreasing (LRU) + slot order. (rjung) + </update> + <update> + Apache: Create JK_WORKER_ROUTE and JK_REQUEST_DURATION notes for + access log even if no JkRequestLogFormat is set. (rjung) + </update> + <update> + JKStatus: Enhance URI to worker map listing for Apache httpd. + We now list maps for all virtual servers and not only + the one, in which JKStatus itself was called. (rjung) + </update> + <update> + JKStatus: Enhance URI to worker map listing. + Update stale uriworkermap.properties immediately. (rjung) + </update> + <fix> + <bug>43873</bug>: Fix small memory leak occuring during httpd restart. (rjung) + </fix> + <update> + Common: Allow '*' for the worker name in exclusion rules (resp. JkUnMount) + which will override all workers. (rjung) + </update> + <fix> + <bug>42038</bug>: Correct overlay of mounts and unmounts for IIS. (rjung) + </fix> + <fix> + <bug>43684</bug>: Replace JkMountFile by JkMountFileReload in + uriworkermap.properties docs. (rjung) + </fix> + <update> + Apache: Add new value "All" for JkMountCopy. (rjung) + </update> + <fix> + <bug>43516</bug>: Memory leak for Apache httpd module + of size 8KB for every virtual host without JK directive + after each restart. (rjung) + </fix> + <update> + Apache: Cleanup init and destroy of server configuration. (rjung) + </update> + <update> + Apache: Remove global configuration items from per server + configuration. (rjung) + </update> + <update> + Apache: Remove unused attributes secret_key and + automount/JkAutoMount. (rjung) + </update> + <update> + Cleanup of jk_uri_worker_map. (rjung) + </update> + <update> + Documentation: Small additions to JkShmFile documentation. + Contributed by Gerhardus Geldenhuis. (rjung) + </update> + <fix> + AJP13: Ignore flush packets before we received the response headers. (rjung) + </fix> + <fix> + Fix crash during startup when using worker configuration inheritance + (attribute "reference") and log level debug. (rjung) + </fix> + <fix> + AJP13: Match header names exactly against pre defined constants. Avoid + possible confusion with custom header names using a standard header name + as a prefix. (rjung) + </fix> + <fix> + jkstatus: Fix correct parameter validation at JkStatusUpdateTask and + JkStatusUpdateLoadbalancerTask ant tasks. Reported by Christian Mittendorf. (pero) + </fix> + </changelog> + </subsection> +</section> +<section name="Changes between 1.2.24 and 1.2.25"> + <br /> + <subsection name="Native"> + <changelog> + <update> + IIS: Fix shm shutdown behaviour. (rjung) + </update> + <update> + General: fail_on_status used in a load balancer can optionally + do fail over without putting the failed worker in error state. (rjung) + </update> + <update> + NSAPI: Improve build description for Unix. (rjung) + </update> + <update> + NSAPI: Add initialization startup message containing JK version. (rjung) + </update> + <fix> + General: Declare static functions as static. (jim) + </fix> + <update> + Documentation: Clarify fail_on_status behaviour. (rjung) + </update> + <fix> + General: Do fail_on_status before returning the response headers. (rjung) + </fix> + <update> + NSAPI: Fix shm shutdown behaviour. (rjung) + </update> + <update> + NSAPI: Set return status even if request ended with an error. (rjung) + </update> + <update> + NSAPI: Allow using without shm_file on WIN32 and Netware. (rjung) + </update> + <fix> + NSAPI: Fix Crash of nsapi for log level debug and unset refect_unsafe. (rjung) + </fix> + <update> + NSAPI: Improve Solaris and Linux Makefiles for nsapi build. (rjung) + </update> + <fix> + Build: Improve pid_t type detection during configure on Solaris. (rjung) + </fix> + <update> + Build: Experimental build support for gcc on WIN32 and Netware. (fuankg) + </update> + <update> + Build: Makefile optimizations for Apache httpd 1.3/Netware . (fuankg) + </update> + <fix> + General: Fix missing flush bug introduced in 1.2.24. (rjung) + </fix> + </changelog> + </subsection> +</section> +<section name="Changes between 1.2.23 and 1.2.24"> + <br /> + <subsection name="Native"> + <changelog> + <update> + Documentation: Improved workers.properties description in the + reference guide. (rjung) + </update> + <update> + Documentation: Add a HowTo about the various timeouts. rjung) + </update> + <update> + Logging: add milliseconds to the default timestamp format, + if we have gettimeofday(). (rjung) + </update> + <update> + Apache: add milliseconds (%Q) and microseconds (%q) as possible + JkLogStampFormat conversion specifiers. This does not use strftime(), + but needs gettimeofday(). (rjung) + </update> + <update> + IIS & Sun: Log service failures also, if return code is negative. (rjung) + </update> + <fix> + <bug>42849</bug>: Abort startup of Apache httpd 1.3 in case + mod_jk initialization failed. We already do the same + for Apache httpd 2.x. (rjung) + </fix> + <fix> + <bug>42849</bug>: Refuse to operate with IIS in case the + initialization failed. Instead requesting isapi_redirect.dll + 500 will be returned to the user. This is as closest as it + can get to Apache Httpd where we refuse to start the server + in case of fatal initialization errors. (mturk) + </fix> + <fix> + Load Balancer: Fix a deadlock in lb worker, which was exposed on Solaris + for threaded Apache MPMs. (rjung) + </fix> + <update> + Logging: handle LWP IDs as 32 Bit unsigned. Try to make + it work, although pthread IDs are opaque. (rjung) + </update> + <update> + JkStatus: Added manipulation of max_reply_timeouts. (rjung) + </update> + <update> + LB, Status: Add feature max_reply_timeouts, to make lb tolerant against + occasional long running requests. (rjung) + </update> + <update> + JkStatus: Added OK/IDLE as the successor of N/A. (rjung) + </update> + <update> + Status worker: Renamed runtime states. All states have a major + state (OK or ERR) and a substate. Changed the name N/A to OK/IDLE. + Added docs about the meaning of the states to the status worker + page in the reference guide. + No new states have been added to code. (rjung) + </update> + <update> + Common: Add recovery options for recovering idempotent http methods + HEAD and GET. (rjung) + </update> + <fix> + Correct documentation for worker attributes retries and + recovery_options. (rjung) + </fix> + <fix> + Make writing log lines and line endings more atomic. (rjung) + </fix> + <update> + Common: Refactored and unified jk_map_read_prop* and jk_map_load_prop* + for all use cases. (rjung) + </update> + <update> + Common/Apache/IIS/Netscape: Add an option to check decoded URLs for + potentially malicious constructions. (rjung) + </update> + <update> + IIS: Document auth_complete and uri_select. (rjung) + </update> + <update> + Apache/IIS/Netscape: Change the default forwarding encoding to the new + proxy method. (jfclere, rjung) + </update> + <update> + Common: Optionally reencode URIs before forwarding to the backend. + Based on the URI reencoding done bei httpd mod_proxy. (jfclere, rjung) + </update> + <update> + Common: auto-detect correct print format for pid_t. + This fixes at least compiler warnings on Solaris. (rjung) + </update> + <fix> + <bug>42608</bug>: Handle Content-length as unsigned 64Bit + to allow for huge up- and downloads. (rjung) + </fix> + <update> + Apache: Add forwarding uri to debug log. (rjung) + </update> + <update> + Docs: Clarify relation between worker names and jvmRoute for load balancing. (rjung) + </update> + <fix> + Use initial zero timeout for jk_is_socket_connected. The resulting + detection is the same but offers a huge performance increase + with mod_jk. In most cases the Operating System does not favor + the 1 microsecond timeout, but it rather rounds that up to much + higher value (frequency of interrupt timer which on most systems + defaults to 100Hz). + Patch provided by David McLaughlin. (mturk) + </fix> + <update> + NSAPI: Check correct log file and shm file configuration during startup. (rjung) + </update> + <fix> + NSAPI: Add support for the general options concerning retries, flushing + and connection persistance. (rjung) + </fix> + <fix> + NSAPI: fix crashes due to use of mount attribute in workers.properties. + Changed initialization order. (rjung) + </fix> + <fix> + Improved handling of libtool and discrepancies between CC env variable and + CC used during apache build by configure script. (rjung) + </fix> + <fix> + Always build with thread support, unless flag --enable-prefork + is set during for configure. (rjung) + </fix> + <update> + Use snprintf/vsnprintf from ap_snprintf.c for platforms other + than Windows, which might lack snprintf/vsnprintf implementations + when NOT build for Apache httpd 2.x/APR (e.g. Sub Web Server) + or without using configure. (fuankg) + </update> + <update> + Imported ap_snprintf() from Apache 1.3. (fuankg) + </update> + <fix> + Fix incorrect log object cleanup during statup, + leading to crashes at least on iSeries. (rjung) + </fix> + <update> + Add jk_stat() and jk_file_exists() as wrapper functions. + i5/OS V5R4 expects filename in ASCII for fopen but requires them + in EBCDIC for stat(). (hgomez) + </update> + <update> + i5/OS (AS/400) V5R4 port where Apache 2.0 modules should now use UTF8. (hgomez) + </update> + <update> + Docs: Add comments on i5/OS build for V5R4 and previous releases. (hgomez) + </update> + </changelog> + </subsection> +</section> +<section name="Changes between 1.2.22 and 1.2.23"> + <br /> + <subsection name="Native"> + <changelog> + <update> + [<a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2007-0450"><b>CVE-2007-0450</b></a>] + and + [<a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2007-1860"><b>CVE-2007-1860</b></a>]: + Change the default value of JkOptions to ForwardURICompatUnparsed. + The old default value was ForwardURICompat. + This should make URL interpretation between Apache httpd and + Tomcat consistent (prevent double decoding problems). (rjung) + </update> + </changelog> + </subsection> +</section> +<section name="Changes between 1.2.21 and 1.2.22"> + <br /> + <subsection name="Native"> + <changelog> + <fix> + Refactor line endings logging to make it correct for all + platforms and webservers. (mturk) + </fix> + <update> + Added command line windows make files. (mturk) + </update> + <update> + Allow fail_on_status directive to be multi line. (mturk) + </update> + <fix> + <bug>42076</bug>: Fix name of new option from ForwardCertChain to + ForwardSSLCertChain as documented. (rjung) + </fix> + <fix> + Docs: Fix a couple of typos, change format of a few tables, + fix links to news pages. (rjung) + </fix> + <fix> + Fix correct URL for TC 6 examples in new IIS rewrite.properties + configuration example file. (rjung) + </fix> + <fix> + Add svn properties to several files. (rjung) + </fix> + <update> + Add TC 6 examples to uriworkermap.properties in config examples. (rjung) + </update> + <update> + Allow multiple status codes for fail_on_status directive. + The status codes can be delimited by space or comma characters. (mturk) + </update> + <update> + IIS. Added pcre like regular expressions for url rewrite rules. (mturk) + </update> + <fix> + <bug>41922</bug>: Apache 1.3. Enable JkEnvVar. (mturk) + </fix> + <update> + Apache. Add --enable-flock configure parameter for explicit + compilation of faster flock() system calls for OS supporting + those calls. By default the fcntl system call for locking will + be used that is a little bit slower but it can work on NFS + mounted volumes as well. (mturk) + </update> + <fix> + <bug>41562</bug>: Add Debug logging for read from client in ISAPI Redirector. + Contributed by Tim Whittington. (mturk) + </fix> + <update> + Apache. Add ForwardSSLCertChain JkOption. + Contributed by Patrik Schnellmann. (mturk) + </update> + <fix> + IIS. Do not forbid access to web-inf or meta-inf if there is + no mapped worker. This allows to have resource with those names + that are outside mapped contexts. (mturk) + </fix> + <update> + Apache. Use process id for creating shared memory name and delete shared + memory and shared memory lock files on exit. (mturk) + </update> + <fix> + IIS. Fix Keep-Alive regression introduced in 1.2.21. (mturk) + </fix> + <update> + Delete unused check for empty init_map during startup. (rjung) + </update> + <fix> + <bug>41770</bug>: Fix startup error if no JkWorkersFile is used. (rjung) + </fix> + <update> + Use JK_TRUE/JK_FALSE instead of OK/!OK as return values in init_jk(). (rjung) + </update> + <update> + Minor adjustments to apache startup log messages (when to use STDERR, remove + deprecated NOERRNO flag, shm warning and warnings for usage of default files). (rjung) + </update> + <update> + Replace APR precompiler directive by httpd mpm_query to detect MPM threading. + Add a debug log message about auto-detected pool size. (rjung) + </update> + <fix> + Make MMN check easier to understand and a little more precise + (for new ap_get_server_banner()/ap_get_server_description()). + We use the new API only for Apache httpd 2.3. This way our binaries are not + tightly coupled to a minor 2.0 version, and we don't use ap_get_server_banner() + any way. (rjung) + </fix> + <fix> + Use the full description string ap_get_server_description() instead of + the truncated info from ap_get_server_banner(), because this info gets used internally + (status worker display and ajp14 backend communication) and is not send back to the + normal user. (rjung) + </fix> + <fix> + <bug>41757</bug>: Document the "--enable-prefork" flag of configure. (rjung) + </fix> + <update> + Enhance log messages for failures when parsing attribute maps. (rjung) + </update> + <fix> + Correct log message during worker initialization, in case remote host could not be + resolved. We logged the default host name "localhost" instead of the configured one. (rjung) + </fix> + <fix> + <bug>41770</bug>: Fix the second part of the bug: local_worker and local_worker_only + is missing from the list of deprecated attributes (and not supported either), so prevents + the web server from startup. (rjung) + </fix> + </changelog> + </subsection> +</section> +<section name="Changes between 1.2.20 and 1.2.21"> + <br /> + <subsection name="Native"> + <changelog> + <fix> + [<a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2007-0774"><b>CVE-2007-0774</b></a>]: + A denial of service and critical remote code execution vulnerability. + Caused by buffer overflow in map_uri_to_worker() when URL were longer that 4095 bytes. + Reported by ZDI (www.zerodayintiative.com). + Please note this issue only affected versions 1.2.19 and 1.2.20 of the + Apache Tomcat JK Web Server Connector and not previous versions. + Tomcat 5.5.20 and Tomcat 4.1.34 + included a vulnerable version in their source packages. + Other versions of Tomcat were not affected. + </fix> + <add> + Check the worker. parameters and don't start if the parameter is not a valid one. (jfclere) + </add> + <add> + <bug>41439</bug>: Allow session IDs to get stripped off URLs of static + content in Apache by adding JkStripSession + directive (configurable per vhost). (mturk) + </add> + <add> + Change semantics of empty defaults for JkEnvVar variables. + Until 1.2.19: not allowed. In 1.2.20: send variables as empty strings, if + neither set to non empty in config, nor during runtime. + Starting with 1.2.21: If config has no second argument only send + variable if set (even when set to empty string) during runtime. + Allows good combination with condition attribute in tomcat access log. (rjung) + </add> + <fix> + <bug>41610</bug>: Fix incorrect detection of missing Content-Length + header leading to duplicate headers. Contributed by Boris Maras. (rjung) + </fix> + <fix> + Better build support for SunONE (Netscape/iPlanet) webservers. (jim) + </fix> + <add> + Add warning if duplicate map keys are read and are not allowed, + e.g. when parsing uriworkermap.properties. (rjung) + </add> + <fix> + Don't concat worker names, if uriworkermap.properties has a duplicate + pattern, instead overwrite the worker. (rjung) + </fix> + <fix> + Log deprecation message even in duplication case. (rjung) + </fix> + <fix> + uriworkermap.properties: Fix off-by-one problem when deleting + URL mapping during reloading of uriworkermap.properties. (rjung) + </fix> + <add> + <bug>41439</bug>: Allow session IDs to get stripped off URLs of static + content in IIS (configurable). (rjung) + </add> + <add> + <bug>41333</bug>: Refactoring isapi_plugin configuration reading. (rjung) + </add> + <add> + <bug>41332</bug>: Add some more errno logging and unify the format. (rjung) + </add> + <add> + JkStatus: Improved logging by adding status worker name to messages. + Added messages to the recover worker action. (rjung) + </add> + <add> + JkStatus: Refactoring searching for workers and sub workers. (rjung) + </add> + <add> + <bug>41318</bug>: Add configuration to make status worker user + name checks case insensitive. (rjung) + </add> + <add> + JkStatus: Add estimated time until next global maintenance to other + mime types and adopt jkstatus ant task. (rjung) + </add> + <add> + JkStatus: Show estimated time until next global maintenance. + Change displayed time until next recovery to a min/max pair. (rjung) + </add> + <add> + JkStatus: Allow a user of a read/write status worker to switch it + to and from read_only mode temporarily. (rjung) + </add> + <fix> + JkStatus: Do not show read/write commands in a read_only status worker. (rjung) + </fix> + <add> + JkStatus: Allow lb sub workers in error state to be marked for recovery + administratively from the status worker. (rjung) + </add> + <add> + Load Balancer: Do not try to recover multiple times in parallel. + Use additional runtime states "PROBE" and "FORCED". (rjung) + </add> + <fix> + JkStatus: Improve data synchronization between different processes. (rjung) + </fix> + <fix> + <bug>41381</bug>: Fix segfault in feature fail_on_status + (wrong order of log arguments). Patch by Juri Haberland. (rjung) + </fix> + <fix> + Use correct windows line endings for log file on WIN32 platform. (rjung) + </fix> + </changelog> + </subsection> +</section> +<section name="Changes between 1.2.19 and 1.2.20"> + <br /> + <subsection name="Native"> + <changelog> + <add> + JkStatus Ant Task documentation page. (pero/rjung) + </add> + <add> + JkStatus Ant Tasks: Add new tasks for update and reset. (pero) + </add> + <update> + JkStatus Ant Tasks: Update for new xml status format. (pero) + </update> + <update> + Allow integer and string values when setting enumeration/boolean + attributes via status worker update action. (rjung) + </update> + <add> + Docs: New reference guide page for status worker. (rjung) + </add> + <update> + Docs: Renaming the config dir to reference and using the title + Reference Guide in the docs. (rjung) + </update> + <update> + Added retry_on_status for workers directive. (mturk) + </update> + <update> + Status Worker: Add directive to make property prefix + and good/bad rule configurable. (rjung) + </update> + <update> + Status Worker: Omit lb members when att=nosw. (rjung) + </update> + <update> + Status Worker: New command cmd=version for a short version output. (rjung) + </update> + <update> + Status Worker: New output stype mime=prop produces property lists. (rjung) + </update> + <fix> + Apache: Fix incorrect handling of JkEnvVar when Vars are set multiple times. (rjung) + </fix> + <update> + Renamed jvm_route to route. Deprecated jvm_route, but still use it as fallback + when parsing the worker configuration. (rjung) + </update> + <update> + IIS: Make uriworkermap file reload check interval configurable. (mturk) + </update> + <update> + Apache: Make uriworkermap file reload check interval configurable. (rjung) + </update> + <update> + Status Worker: Add directives for customizing the XML + output (ns, xmlns, doctype). (mturk) + </update> + <add> + Docs: New page with description of uriworkermap. (rjung) + </add> + <update> + Docs: Added short description of max_packet_size to worker + reference. (rjung) + </update> + <update> + Status Worker: All functions accessible also for xml and txt + mime types (list, show, update, reset). (rjung) + </update> + <update> + Status Worker: New global health indicators for load balancers + named bad (error, recovering or stopped), degraded (busy or disabled) + and good (the rest, active and OK or N/A). (rjung) + </update> + <update> + Status Worker: New edit page, to change one attribute for all + members of a load balancer. (rjung) + </update> + <update> + Status Worker: Standard logging for status worker. (rjung) + </update> + <update> + Status Worker: code refactoring. (rjung) + </update> + <update> + Status Worker: New attribute user (list) denies access, if + the request user in the sense of remote_user is not in this list. + Empty list = no deny (rjung) + </update> + <update> + Status Worker: New attribute read_only disables the parts + of the status worker, that change states and configurations. (rjung) + </update> + <fix> + <bug>36121</bug>: Don't change main uri when mod_jk serves + included uri. (markt) + </fix> + <update> + Apache VHosts: Merge JkOptions +base - -base + +vhost - -vhost. (rjung) + </update> + <update> + Apache Docs: Adding requirements, context information, default values and + inheritance rules to the Apache config documentation. (rjung) + </update> + <update> + Status Worker: Add source type to status worker, remove the redundant "context" + column in the map listing (context=uri). (rjung) + </update> + <update> + uriworkermap: On reload of the file, all old entries from the previous file + version get deleted, before the new ones are being read. (rjung) + </update> + <fix> + Keep normal maps and exclusion maps internally separate. Don't treat them + as the same when adding a rule. (rjung) + </fix> + <update> + Status Worker: Display mapping rules also for non-lb workers and in global view. (rjung) + </update> + <update> + Apache VHosts: Use the vhost log files instead of the main log. (rjung) + </update> + <update> + Apache VHosts: Allow individual timestamp formats by refactoring the formatting + method. (rjung) + </update> + <update> + Apache VHosts: Adding all missing config items to the virtual host level. + Don't overwrite the settings from the global server, but inherit them + in case they are not set in the virtual host. (rjung) + </update> + <update> + Apache: remove unnecessary function names from log messages. (rjung) + </update> + <update> + Apache: add a default log file location and a message, if the default gets used. (rjung) + </update> + <update> + Apache: add missing JK_IS_DEBUG_LEVEL() (rjung) + </update> + <update> + Apache VHosts: Allow JkWorkersFile, JKWorkerProperty, JkShmFile and JkShmFileSize + only in global virtual server. (rjung) + </update> + <update> + Add some more jk_close_socket() and reduce log level for some info messages. (rjung) + </update> + <update> + Load Balancer: Added the Sessions strategy. Contributed by Takayuki Kaneko. (rjung) + </update> + <update> + Docs: Minor enhancements and syncing with more recent versions. (rjung) + </update> + <fix> + <bug>40997</bug>: Separate uri mappings from their '!' + counterpart when checking for duplicates in uriworkermap + reloading. (rjung) + </fix> + <fix> + <bug>40877</bug>: Make sure the shared memory is reset on + attach for multiple web server child processes. (mturk) + </fix> + <update> + IIS: Added shm_size property to be able to deal with over 64 + workers configurations. (mturk) + </update> + <update> + IIS: Increase default thread count to 250, so its the same as Apache Httpd + default configuration. (mturk) + </update> + <fix> + <bug>40966</bug>: Fix socket descriptor checks on windows. (mturk) + </fix> + <fix> + <bug>40965</bug>: Initialize missing service parameters. (mturk) + </fix> + <fix> + <bug>40938</bug>: Fix releasing of rewrite map. + Thanks to Chris Adams for spotting that. (mturk) + </fix> + <update> + Apache: Added +FlushHeader JkOptions. (mturk) + </update> + <update> + Added explicit flush when AJP body packet size is zero. (mturk) + </update> + <fix> + <bug>40856</bug>: Fixing case sensitivity bug in URL mapping. (rjung) + </fix> + <fix> + <bug>40793</bug>: Documentation: Improvements to Apache HowTo provided by + Paul Charles Leddy. (markt) + </fix> + <fix> + <bug>40774</bug>: Fixing wrong recursion termination. This one restricted the + "reference" feature unintentionally to 20 workers. (rjung) + </fix> + <fix> + <bug>40716</bug>: Adding "reference" feature to IIS and Netscape. (rjung) + </fix> + <fix> + Documentation: Corrected SetEnvIf syntax in JK_WORKER_NAME example. (rjung) + </fix> + <fix> + Documentation: Added forgotten STATE and ACTIVATION notes for load balancer logging in Apache. (rjung) + </fix> + <update> + Apache: Use instdso.sh instead libtool: libtool does not work on HP-UX for example. (jfclere) + </update> + </changelog> + </subsection> +</section> +<section name="Changes between 1.2.18 and 1.2.19"> + <br /> + <subsection name="Native"> + <changelog> + <update> + Docs: Add SetHandler and new env var to Apache config docs. (rjung) + </update> + <update> + Apache 1.3: Backport "no-jk" feature. (rjung) + </update> + <update> + Apache: Add an environment variable to make SetHandler "jakarta-servlet" more + useful. The variable is JK_WORKER_NAME, but can be changed by the + new directive JkWorkerIndicator. (rjung) + </update> + <fix> + LB: Don't use single worker shortcut, if the single worker is being diabled. (rjung) + </fix> + <fix> + Status worker: Add short explanation of activation and error states to legend. (rjung) + </fix> + <fix> + Docs: Add meaning of zero timeout values for various timeouts + in workers.properties. (rjung) + </fix> + <fix> + LB: Cleanup of Mladens forced recovery. (rjung) + </fix> + <fix> + LB: Do not change lb_value for recovering workers to max, if + we are using BUSYNESS method. (rjung) + </fix> + <fix> + Apache: Since 1.2.14 mod_jk failed to detect client abort. (rjung) + </fix> + <fix> + Docs: Corrected description of JkEnvVar. (rjung) + </fix> + <fix> + Solaris: Detect filio.h in configure to make the new connection detection + build on solaris (r432825). (rjung) + </fix> + <update> + Add feature to force the recovery of workers that are + member of loadbalancer if all the members are in error + state. This fixes the time gap where 503 was returned + caused by recovery_timeout although the backend was + ready to handle the requests. (mturk) + </update> + <update> + Docs: Seperate deprecated directives in their own table. (rjung) + </update> + <update> + Docs: Allow "-" and "_" in worker names. (rjung) + </update> + <update> + Allow multiple lines with attributes "balance_workers" and "mount". (rjung) + </update> + <fix> + Make jk_is_some_property match more precisely. (rjung) + </fix> + <update> + JkStatus: Make refresh interval changeable. (rjung) + </update> + <fix> + JkStatus: Adjust display of recover time wrt. global maintenance. (rjung) + </fix> + <update> + LB: Resetting worker state from OK to NA, if worker has been idle + too long. (rjung) + </update> + <fix> + Avoid compiler warnings concerning the use of lb_*_type arrays. + Use functions instead. (rjung) + </fix> + <update> + Added %R JkRequestLogFormat option for Apache 1 and Apache 2. (mturk) + </update> + <update> + Allow changing jvm Route from status manager. (mturk) + </update> + <fix> + Do not retun 400 if Tomcat fails in the midle of the post + request. Return 500 insted. (mturk) + </fix> + <update> + LB: Combine ok/error/recovering/busy runtime states into a single scalar. (rjung) + </update> + <update> + LB: Combine active/disabled/stopped configuration states into a single scalar. (rjung) + </update> + <update> + LB: Add several Apache notes to enable standard logging for load balancer results. (rjung) + </update> + <update> + LB: Reorganisation of the main load balancer service loop. (rjung) + </update> + <update> + Implement hierarchical worker configuration via attribute "reference". (rjung) + </update> + <update> + Log deprecated properties. (rjung) + </update> + <fix> + IIS: Fix simple_rewrite for the cases where the + rewritten url is larger then the original one. (mturk) + </fix> + <update> + New JkOption "DisableReuse" to disable connection persistence. (jim) + </update> + <update> + LB: Move sessionid retrieval out of get_most_suitable_worker into service. (rjung) + </update> + <update> + Code cleanup for all service methods (use TRACE, JK_LOG_NULL_PARAMS, null pointer checks). (rjung) + </update> + <update> + JKSTATUS: add refresh link. No refresh for updates. Redirect to list view after update. (rjung) + </update> + <update> + Add new hook add_log_items into servers. (rjung) + </update> + <update> + APACHE httpd: Rename apache logging notes. (rjung) + </update> + <update> + LB: Rename lock and method constants. Add constants for defaults. (rjung) + </update> + <fix> + Default log level should be INFO and not DEBUG. + Default log level should be the same for all server types. (rjung) + </fix> + <fix> + Make rewrite_rule_map and log_level as non mandatory + directives for isapi_redirect. (mturk) + </fix> + <fix> + <bug>40107</bug>: Rewrite is_socket_connected function. + Non blocking socket is not used any more. (mturk) + </fix> + <update> + Allow building with VS2005 without too many warnings. (mturk) + </update> + <fix> + Decide by MMN, which piped log API we should use. + mod_jk 1.2.18 broke compilation with Apache 1.3 pre 1.3.28. (rjung) + </fix> + </changelog> + </subsection> +</section> +<section name="Changes between 1.2.17 and 1.2.18"> + <br /> + <subsection name="Native"> + <changelog> + <fix> + Using socklen_t in getsockopt. Also introducing jk_sock_t. (mturk) + </fix> + <update> + Allow recovery wait time below 60 seconds (new minimum is 1 second). (mturk) + </update> + </changelog> + </subsection> +</section> +<section name="Changes between 1.2.16 and JK 1.2.17"> + <br /> + <subsection name="Native"> + <changelog> + <fix> + Fix hanging jk status worker when certain attributes are being updated + due to double locking. (rjung) + </fix> + <update> + Allow JkMount to behave like uriworkermap.properties + by parsing pipe symbol as two directive marker. (mturk) + </update> + </changelog> + </subsection> +</section> +<section name="Changes between 1.2.15 and JK 1.2.16"> + <br /> + <subsection name="Native"> + <changelog> + <update> + Added simple rewrite capability for IIS. Although simple it + will fulfill most needs. (mturk) + </update> + <update> + Added RECOVER_ABORT_IF_CLIENTERROR recovery_option that closes + the connection if client connection is broken during the request. (mturk) + </update> + <update> + Renamed cache_timeout directive to connection_pool_timeout. (mturk) + </update> + <update> + Added connection_pool_minsize directive. (mturk) + </update> + <update> + Deprecate recycle_timeout directive. (mturk) + </update> + <update> + Corrected some HTML syntax bugs in output of status worker. (rjung) + </update> + <update> + Added the refresh=n parameter to the status worker. It will update the display every n seconds. (rjung) + </update> + <update> + Balancer: Add attribute distance to balanced workers to express preferences between workers. (rjung) + </update> + <update> + Balancer: Add attribute jvm_route to balanced workers to be able to use the same target in different balancers. (rjung) + </update> + <update> + Status: Add lb_mult to status. (rjung) + </update> + <update> + Balancer: Make different balancing strategies work in a similar way (use lb_value, use decay during global maintenance, use integer factors for weights. (rjung) + </update> + <update> + Balancer: Improve locking. (rjung) + </update> + <update> + Balancer: Workers start slower after recovering. (rjung) + </update> + <update> + Balancer: Make different balancing strategies work in a similar way (use lb_value, use decay during global maintenance, use integer factors lb_mult for weights). (rjung) + </update> + <update> + Balancer: Move recovery check to global maintenance. (rjung) + </update> + <update> + Balancer: Add global maintenance method, that is called in only one process. (rjung) + </update> + <update> + Extend our use of autoconf to find a 32Bit and a 64Bit unsigned type and their printf formats. (rjung) + </update> + <update> + Logging: piped loggers for JkLogFile and Apache 1.3. (rjung) + </update> + <update> + Logging: Add PID to log lines for each log level apart from REQUEST. (rjung) + </update> + <update> + Logging: flush buffered logs to keep lines in correct order. Output final newline together with log message. (rjung) + </update> + <update> + Reducing shm size. (rjung) + </update> + <update> + Only log removing of old worker, when we actually do it. (rjung) + </update> + <fix> + <bug>37469</bug>: Fix shared memory close for forked childs. + The shared memory will be closed by the parent process. (mturk) + </fix> + <fix> + <bug>37332</bug>: Fix potential misuse of buffer length with + snprintf functions. (mturk) + </fix> + <fix> + <bug>38859</bug>: + [<a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2006-7197"><b>CVE-2006-7197</b></a>] + Protect mod_jk against buggy or malicious + AJP servers in the backend. Patch provided by Ruediger Pluem. (mturk) + </fix> + <fix> + <bug>38889</bug>: Use worker map sorting depending on the path + elements, to comply with Servlet spec. Patch provided by + Steve Revilak. (mturk) + </fix> + <update> + <bug>36138</bug>: Added Busyness lb method. Patch provided + by Chris Lamprecht. (mturk) + </update> + <fix> + Fix pessimistic locking mode. The patch correctly handles the + burst load, by syncing the access to the shared memory data. (mturk) + </fix> + <fix> + <bug>38806</bug>: Reclycle worker even if it is disabled. + This fixes hot-standby workers in error state. (mturk) + </fix> + <fix> + <bug>37167</bug>: Allow building with BSD-ish like make. (mturk) + </fix> + <fix> + ISAPI plugin (isapi_redirect.dll) did not provide correct request data + for IIS + to include in the IIS log. (markt) + </fix> + </changelog> + </subsection> +</section> +<section name="Changes between 1.2.14 and 1.2.15"> + <br /> + <subsection name="Native"> + <changelog> + <fix> + Fix AJP13 Cookie2 parsing. Cookie2 was always send as Cookie. + Patch provided by Andre Gebers. (mturk) + </fix> + <fix> + <bug>35862</bug>: NSAPI plugin attempts to read freed memory and attempts to + dereference a null pointer. Patch provided by Brian Kavanagh. (markt) + </fix> + </changelog> + </subsection> +</section> +<section name="Changes between 1.2.13 and 1.2.14"> + <br /> + <subsection name="Native"> + <changelog> + <fix> + Fix lb for worker mpm's with cachesize set to lower number then + ThreadsPerChild is. If retries is set to value larger then 3 sleep for + 100 ms on each attempt. This enables to tune the connection cache, + and serialize incoming connections instead returning busy if connection + count is larger then cachesize. (mturk) + </fix> + <fix> + <bug>36525</bug>: Solaris core dump. (mturk) + </fix> + <fix> + <bug>36102</bug>: Worker actions do not persist. (mturk) + </fix> + <fix> + <bug>35864</bug>: Status worker doesn't list workers. + Patch provided by Martin Goldhahn. (mturk) + </fix> + <fix> + <bug>35809</bug>: JkMountCopy don't work for Apache 2.0 Patch provided by + Christophe Dubach. (mturk) + </fix> + <fix> + <bug>35298</bug>: Multiple JK/ISAPI redirectors on a single IIS site are not supported + Patch provided by Tim Whittington. (mturk) + </fix> + </changelog> + </subsection> +</section> +<section name="Changes between 1.2.12 and 1.2.13"> + <br /> + <subsection name="Native"> + <changelog> + <fix> + <bug>34397</bug>: Emergency was handled as Error. (jfclere) + </fix> + <fix> + <bug>34474</bug>: // in URL were not handled correctly with Apache-1.3. (jfclere) + </fix> + <fix> + Use 64 bits int for transferred/read bytes. + </fix> + <update> + Added JkOptions +FlushPackets used to optimize memory + usage when sending large data. (mturk) + </update> + <update> + Added lock directive for load balancer that allows more acurate + load balancing in case of burst load. (mturk) + </update> + <update> + Added worker.maintain directive to allow customizing default 10 + second timeout. On busy servers this value needs to be set on + higher value. (mturk) + </update> + <fix> + Fix for NetWare compiler to deal with different types between AP13 + and AP2 SDKs. (fuankg) + </fix> + <update> + Emit much more legible user.dmp crash analysis output for WIN32. (wrowe) + </update> + <fix> + <bug>34558</bug>: Fix first failover request. (mturk) + </fix> + </changelog> + </subsection> +</section> + +<section name="Changes between 1.2.11 and 1.2.12"> + <br /> + <subsection name="Native"> + <changelog> + <update> + Added ForwardLocallAddres JkOptions flag for passing local instead remote + address. Useful for remote addr valve. (mturk) + </update> + <fix>Fix that worker not used, when stopped flag is true. (pero) + </fix> + <update> + Add loadbalance default worker secret attribute to the documentation (pero) + </update> + </changelog> + </subsection> +</section> + +<section name="Changes between 1.2.10 and 1.2.11"> + <br /> + <subsection name="Native"> + <changelog> + <fix>Backport SC_M_JK_STORED from JK2 for passing arbitrary + methods instead failing the request. (mturk) + </fix> + <fix>Added missing SEARCH and ACL http methods. (mturk) + </fix> + <update> + Add worker secret attribute to the documentation (pero) + </update> + <update> + Add a stopped flag to worker configuration. Set flag True and + complete traffic to worker is stopped. + Also update the Ant JkStatusUpdateTask at Tomcat 5.5.10 release. + Only usefull in a replicated session cluster.(pero) + </update> + <update>Added worker maintain function that will maintain all + the workers instead just the current one. This enables to recycle + the connections on all workers. (mturk) + </update> + <update>Use shutdown when recycling connections instead hard + breaking the socket. (mturk) + </update> + <update>Add unique directives checking. The directives if + unique are now overwritten instead concatenated. (mturk) + </update> + <update>Allow multiple worker.list directives. (mturk) + </update> + <fix> + <bug>34577</bug>: For IIS log original request instead loging + the request for ISAPI extension. (mturk) + </fix> + <fix> + <bug>34558</bug>: Make sure the returned status codes are the same + for ajp and lb workers. (mturk) + </fix> + <fix> + <bug>34423</bug>: Use APR_USE_FLOCK_SERIALIZE for setting log lock + on platforms like FreeBSD. Patch provided by Allan Saddi. (mturk) + </fix> + <fix> + <bug>33843</bug>: Fix obtaining LDFLAGS that were used for building + Apache HTTPD. Patch provided by Beat Kneubuehl. (mturk) + </fix> + <fix> + <bug>34358</bug>: Enable load balancer method configuration. (glenn) + </fix> + <fix> + <bug>34357</bug>: In some situations Apache 2 mod_jk could segfault + when the JkAutoAlias directive is used. (glenn) + </fix> + <update> + Add --enable-prefork to the documentation (pero) + </update> + </changelog> + </subsection> +</section> +<section name="Changes between 1.2.9 and 1.2.10"> + <br /> + <subsection name="Native"> + <changelog> + <update>Set default shared memory to 64K instead 1M. (mturk) + </update> + <fix>Do not mark the worker in error state if headers are + larger then AJP13 limit. (mturk) + </fix> + <update> + On Series you should use the latest PTF for Apache 2.0 + (which is now 2.0.52) and ad minima SI17402/SI17061 or cumulative + including them. (hgomez) + </update> + <update> + Change the xml status format to xml attribute syntax (pero) + </update> + <fix> + <bug>33248</bug>: Fix builds where apxs defines multiple + directories for APR includes. (mturk) + </fix> + <fix> + <bug>32696</bug>: Return 404 instead 403 when WEB-INF is requested + to comply with Servlet spec. (mturk) + </fix> + <update>Added ANT task for managing jkstatus. (pero) + </update> + <update> + If socket_timeout is set, check if socket is alive before + sending any request to Tomcat. (mturk) + </update> + <update> + Added JkMountFile for Apache web servers. This file can contain + uri mappings in the form (/url=worker), and is checked for + updates at regular 60 second interval. (mturk) + </update> + <update> + Added status worker for managing worker runtime data using + web page. (mturk) + </update> + <update> + Added load balancer method directive that is used for setting + the algorithm used for balancing workers. Method can be either + Request (default) or Traffic. (mturk) + </update> + <update> + Added shared memory to allow dynamic configuration. Shared memory + is needed only for unix platform and web servers having multiple + child processes. For Apache web server two new directives has been + added (JkShmFile and JkShmSize). (mturk) + </update> + <update> + Added textupdate mode to status worker to handle remote updates + from ant tasks.(pero) + </update> + <fix> + <bug>33562</bug>: Fix Reply_timeout when recovery_options + is larger than 1. Patch provided by Takashi Satou. (mturk) + </fix> + <fix> + <bug>33308</bug>: Fix segfaults when ForwardDirectories is enabled + with Apache 1.3 + </fix> + </changelog> + </subsection> +</section> +<section name="Changes between 1.2.7 and 1.2.8"> + <br /> + <subsection name="Native"> + <changelog> + <update> + Allow anyone to debug and diagnose stack dumps using windbg or any + other debugging tool, and (if they add the .pdb files to their + installation) to make sense of dr watson logs. + Patch provided by William A. Rowe (wrowe) + </update> + <fix> + Fix in_addr_t usage by using the real struct ignoring typedef. + Patch provided by William A. Rowe (wrowe) + </fix> + <fix> + Fix url rewriting by restoring the in place uri from which the + jsessionid was removed. (mturk) + </fix> + <update> + Make load balancer algorithm thread safe by introducing mutex + to the load balancer worker. (mturk) + </update> + <fix> + Fix sending error pages for IIS to client by adding Content-Type header + using correct api function call. (mturk) + </fix> + <fix> + <bug>32696</bug>: Prevent IIS from crushing when web-inf url was requested. (mturk) + </fix> + <update> + Use default cachesize for servers that support discovering the number of + threads per child process. (mturk). + </update> + <fix> + Fix Apache content-length header parsing using case insensitive compare. (billbarker) + </fix> + <fix> + Fix parsing AJP headers using case insensitive compare. (mturk) + </fix> + <fix> + Use infinite socket timeout if socket_timeout is set to zero or less then zero. (mturk) + </fix> + <update> + Change <b>balanced_workers</b> to <b>balance_workers</b> but keep + backward compatibility preserving the old directive. (mturk). + </update> + <fix> + Fix ajp initialization for workers with cache_size set to zero. (mturk) + </fix> + <update> + <bug>32317</bug>: Making mod_jk replication aware (Clustering Support). + Patch provided by Rainer Jung. (mturk). + </update> + <fix> + <bug>31132</bug>: Core dump when JkLogFile is missing from conf. (mturk) + </fix> + </changelog> + </subsection> +</section> +<section name="Changes between 1.2.6 and 1.2.7"> + <br /> + <subsection name="Native"> + <changelog> + <update> + Added new property named recover_time that can be used to change the + default 60 second recover time. (mturk) + </update> + <update> + Added custom retries for worker, so we don't depend on default setting. + If set to a number grater then 3, it will sleep for 100ms on retry greater + then 3 and then try again. (mturk) + </update> + <update> + Added JkWorkerProperty directive that enables omiting workers.properties file. + For example: JkWorkerProperty worker.ajp13a.port=8009. (mturk) + </update> + <fix> + Check all JSESSIONID cookies for a valid jvmRoute. If you have multiple Tomcats + with overlapping domains, then you can get multiple cookies without a defined order. + This will route correctly as long as the different domains don't have any + Tomcats in common. (billbarker) + </fix> + <update> + Added JkUnMount directive for negative mappings that works as opposite to JkMount directives. + It is used for blocking of particular URL or content type. (mturk) + </update> + <update> + Added wildchar match uri mappings. One can now use JkMount to + map /app/*/servlet/* or /app?/*/*.jsp. (mturk) + </update> + <update> + Rewrite the logging by adding Trace options. (mturk) + </update> + <update> + Added socket_timeout property that sets the timeout + for the socket itself. (mturk) + </update> + <fix> + Changed socket_timeout property to recycle_timeout. This better + explains what the directive actually does. (mturk) + </fix> + <fix> + Changed the load balancer algorithm. + The idea behind this new scheduler is the following: + lbfactor is <i>how much we expect this worker to work</i>, + or <i>the worker's work quota</i>. + lbstatus is <i>how urgent this worker has to work to fulfill its quota + of work</i>. We distribute each worker's work quota to the worker, and then look + which of them needs to work most urgently (biggest lbstatus). This + worker is then selected for work, and its lbstatus reduced by the + total work quota we distributed to all workers. Thus the sum of all + lbstatus does not change.(*) + If some workers are disabled, the others will + still be scheduled correctly. (mturk) + </fix> + </changelog> + </subsection> +</section> +<section name="JK 2"> +<p>JK2 has been put in maintainer mode and no further development will take place. +The reason for shutting down JK2 development was the lack of developers interest. +Other reason was lack of users interest in adopting JK2, caused by configuration +complexity when compared to JK. +</p> +</section> + +</body> +</document> diff --git a/rubbos/app/tomcat-connectors-1.2.32-src/xdocs/miscellaneous/doccontrib.xml b/rubbos/app/tomcat-connectors-1.2.32-src/xdocs/miscellaneous/doccontrib.xml new file mode 100644 index 00000000..5108a85f --- /dev/null +++ b/rubbos/app/tomcat-connectors-1.2.32-src/xdocs/miscellaneous/doccontrib.xml @@ -0,0 +1,337 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!DOCTYPE document [ + <!ENTITY project SYSTEM "project.xml"> +]> +<document url="doccontrib.html"> + + &project; +<copyright> + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +</copyright> +<properties> +<title>How to Contribute to the Documentation</title> +<author email="rsowders@usgs.gov">Robert Sowders</author> +<date>$Date: 2010-03-15 16:27:18 +0100 (Mon, 15 Mar 2010) $</date> +</properties> +<body> +<section name="Introduction"> +<p> + This document describes how you can easily contribute to the +documentation. I'm going to try to make it easy for everyone to help out with +the documentation of Tomcat, more specifically the documentation for the +connectors. This is written from a windows user perspective as I believe they +will most benefit from it. For people using Unix it should be easy for them to +apply these steps. Just substitute Unix syntax where needed. +</p> +<p> + The documentation is produced using xml with xsl style sheets. This +effectivly seperates the content of the documents from the style, so all that +contributers need to worry about the content. It is much easier to use than +html. +</p> +<p> + It's all really quite simple. Here is what you will need: +<ul> +<li> +<b>A recent version of Ant</b> +</li> +<li> +<b>The source code for the connectors from subversion</b> +</li> +<li> +<b>Any ascii text editor</b> +</li> +</ul> +</p> +</section> +<section name="Getting Started Step by Step"> +<p> + After you get these tools they are simple to set up. +</p> + <subsection name="STEP 1. Get Ant"> +<p> + Install <a href="http://ant.apache.org/">Ant</a>. The only advice I +have is to choose a simple installation path. Now set an environment variable +for ANT_HOME, and then add the location of the Ant/bin directory to your PATH +variable. Consult your Operating system documentation for information on how +to do this. When you are finished verify that you can run ant from the command +line. +</p> +<p> + Ant is used to build the documentation, among other things, and it must be +able to see a file called <b>build.xml</b>. This file is located in the +<b>xdocs</b> directory. In the +<b>build.xml</b> file there is a target named <b>all</b> that will be used to build +the docs. +</p> +</subsection> +<subsection name="STEP 2. Get the sources"> +<p> + Get the sources for +<a href="http://svn.apache.org/repos/asf/tomcat/jk/trunk/">tomcat-connectors</a> +from the subversion repository. If you'll +be editing from a windows platform you will need a windows subversion client. There +are several available. I like <a href="http://tortoisesvn.tigris.org/">turtoiseSVN</a>. +Unix users should install the subversion client of their choice, +if they don't already have one. +</p> +<p> + You are ready to download the sources now. Change directory to the +location where you want your repository to be. For simplicity we will call this +your <b>SVN_HOME</b>. Mine is located in C:\build. +</p> +<p> + Run the following command to <b>checkout</b> the sources for the first time. +You should only need to do this once. +<screen> +<read> </read> +<read>C:\build\>svn checkout http://svn.apache.org/repos/asf/tomcat/jk/trunk/ +tomcat-connectors</read> +<read> </read> +</screen> +</p> +<p> + You should now be watching all the downloads come in. Now that you have +the sources on your machine the hard part is over. From now on, to update your +sources all you have to do is cd into any directory in your repository and run +the <b>svn update</b> command. + <screen> +<note> To update your xdocs directory simply cd into the xdocs directory +and:</note> +<read>C:\build\tomcat-connectors\>cd xdocs</read> +<read>C:\build\tomcat-connectors\xdocs\>svn update</read> +</screen> +</p> +</subsection> +<subsection name="STEP 3. Test your build environment"> +<p> + Open a command prompt window and cd to the directory where you downloaded +the source. Now cd into the xdocs directory so that <b>Ant</b> can see the +<b>build.xml</b> file. Then from a command prompt, run the following: +<screen> +<read> </read> +<read>C:\build\tomcat-connectors>cd xdocs</read> +<read>C:\build\tomcat-connectors\xdocs>ant all</read> +<read> </read> +</screen> +</p>. +<p> + You should see the ant compiler messages scrolling by rapidly and then stop +with the following: +<screen> +<read>[style] Transforming into C:\build\tomcat-connectors\build\docs\news\printer></read> +<read>[style] Processing C:\build\tomcat-connectors\xdocs\news\20041100.xml +to</read> +<read>C:\build\tomcat-connectors\build\docs\news/20041100.html</read> +<read>[style] Loading stylesheet C:\build\tomcat-connectors\xdocs\style.xsl</read> +<read>[style] Processing C:\build\tomcat-connectors\xdocs\news\20050101.xml +to</read> +<read>C:\build\tomcat-connectors\build\docs\news/20050101.html</read> +<read>[style] Processing C:\build\tomcat-connectors\xdocs\news\20060101.xml +to</read> +<read>C:\build\tomcat-connectors\build\docs\news/20060101.html</read> +<read>[style] Transforming into C:\build\tomcat-connectors\build\docs></read> +<read>[style] Processing C:\build\tomcat-connectors\xdocs\index.xml +to</read> +<read>C:\build\tomcat-connectors\build\docs\index.html</read> +<read>[style] Loading stylesheet C:\build\tomcat-connectors\xdocs\style.xsl</read> +<read> </read> +<read>BUILD SUCCESSFUL</read> +<read>Total time: 10 seconds</read> +<read>C:\build\tomcat-connectors></read> +</screen> +</p> +<p> + All the xml files present in the xdocs directory structure were transformed +to html and copied to the <b>SVN_HOME\tomcat-connectors\build\docs</b> +directory. Open one of the +html files in your browser and see how it looks. +</p> +</subsection> +<subsection name="STEP 4. The editing process."> +<p> + I find it easier to use two windows while doing my updates. One I call my +<b>build</b> window. I keep this one in the <b>SVN_HOME\tomcat-connectors\xdocs</b> +directory and I only run two commands in this window: +<screen> +<read> </read> +<note> First I run</note> +<read>ant clean</read> +<note> Then I run</note> +<read>ant all</read> +<read> </read> +</screen> +</p> +<p> + My second window I call my <b>edit</b> window and I keep that one in the +<b>SVN_HOME\tomcat-connectors\xdocs</b> directory where I'm doing my +edits, diffs and svn updates. +</p> +<p> + Before you start editing you should always update your local repository to +prevent conflicts. +<screen> +<note> You only need to update the xdocs directory</note> +<read>C:\build\tomcat-connectors>cd xdocs</read> +<read>C:\build\tomcat-connectors\xdocs></read> +<read>C:\build\tomcat-connectors\xdocs>svn update</read> +</screen> +</p> +<p> + Now that your repository is up to date you can begin editing. Find +something in the documentation to edit. When you find something remember the +name of the file. In your <b>edit</b> window find and edit the xml source file +with the same name. After you are done return to the <b>build</b> window, and +in the <b>SVN_HOME\tomcat-connectors\xdocs</b> directory run: +<screen> +<read> </read> +<read>C:\build\tomcat-connectors\xdocs> ant clean</read> +<read> </read> +</screen> +</p> +<p> + This will delete all the previous html files and make the area ready for +updated material. Now to make fresh documents that incorporate your changes +run: +<screen> +<read> </read> +<read>C:\build\tomcat-connectors\xdocs>ant all</read> +<read> </read> +</screen> +</p> +<p> + Use your browser to view the edits you just made, they will be in the +<b>SVN_HOME\tomcat-connectors\build\docs</b> sub-tree. If it looks +good and is ready to go, +all that is left to do is to create a patch and submit it. +</p> +</subsection> +<subsection name="STEP 5. Creating a patch and submitting it."> +<p> + From your <b>edit</b> window cd into the directory that contains the xml +file you are working on, and run the <b>svn update</b> command. For example, +to produce a diff of the index.xml file and call it patch.txt, you +would cd into the directory containing the index.xml file and: +<screen> +<read>C:\build\tomcat-connectors\xdocs\>svn diff index.xml > +patch.txt.</read> +<read> </read> +</screen> +</p> +<p> + Now that you have your patch you are ready to send it in. +</p> +<p> + Patches to the documentation are handled just like a bug report. You +should submit your patches to <a +href="http://issues.apache.org/bugzilla/">http://issues.apache.org/bugzilla/</a> + and include a good one line subject. If this is your first time to use the +bug database then you should read <a +href="http://issues.apache.org/bugzilla/bugwritinghelp.html">http://issues.apach +e.org/bugzilla/bugwritinghelp.html.</a> You will need to create a user +account. At the web site paste your patch into the web form and don't forget +to describe what it is your patch is for. Sooner or later a someone with +commit privileges will review your suggestion. +</p> +</subsection> +</section> +<section name="Subversion Basics"> +<p> + After you have checked out the sources the first time it is much easier to +use subversion. You can cd into any directory of the repository and run <b>svn +update</b> to get the latest sources for that directory. For editing +purposes you should always update your repository before you start editing to +reduce conflicts. +</p> +<p> + You will need to run <b>svn diff</b> to generate patches for submission. +Again cd into the directory containing the file you are editing and run <b>svn +diff name_of_the_file_you_edited > patch.txt</b> to generate a patch for +submission. +</p> +<p> + Pay attention to the terminal window during the update. +</p> +<p> + Lines begining with a <b>A</b> indicate files that have been added. +</p> +<p> + Lines begining with a <b>D</b> indicate files that have been deleted. +</p> +<p> + Lines begining with a <b>U</b> mean the local copy was patched to update it +to the current version in the master repository. +</p> +<p> + Lines begining with a <b>G</b> mean your local copy is different from the +master copy, and the changes were successfully merged into your copy. +</p> +<p> + Lines begining with a <b>C</b> mean there was a conflict in merging the +changes and you need to review the file and merge the changes manually. Search +for >>>> and merge the changes. +</p> +<p> + Lines begining with a <b>?</b> indicate files that reside on your local +system which are not part of the repository. You will normally see this when +you are creating new files for submission. +</p> +</section> + +<section name="Updating Web site"> +<p> + Only Committers are able to update the web site (http://tomcat.apache.org/connectors-doc/). + To do it: + <ul> + <li>Connect to people.apache.org.</li> + <li>umask 002</li> + <li>Copy the changed files to /www/tomcat.apache.org/connectors-doc/.</li> + <li>or use ant from a checkout tomcat/jk/trunk/xdocs repository:<br /> + ant -Dbuild.dir=/www/tomcat.apache.org -Ddist.name=connectors-doc + </li> + <li>The changes need around 4 hours to be synced to tomcat.apache.org.</li> + </ul> +</p> +</section> +<section name="Guides and Resources"> +<p> + A little help to get you started if you need it +</p> +<ul> +<li> +<a href="http://www.xml.org/xml/resources_focus_beginnerguide.shtml">XML +Beginner's Guide</a> +</li> +<li> +<a href="http://issues.apache.org/bugzilla/">Bugzilla</a> +</li> +<li> +<a href="http://issues.apache.org/bugwritinghelp.html">Bugzilla Bug +Writing Guide</a> +</li> +<li> +<a href="http://ant.apache.org/">Ant</a> +</li> +<li> +<a href="http://subversion.tigris.org/">Subversion Home</a> +</li> +<li> +<a href="http://svn.apache.org/repos/asf/tomcat/jk/trunk/xdocs/">JK Docs repository</a> +</li> +</ul> +</section> +</body> +</document> diff --git a/rubbos/app/tomcat-connectors-1.2.32-src/xdocs/miscellaneous/faq.xml b/rubbos/app/tomcat-connectors-1.2.32-src/xdocs/miscellaneous/faq.xml new file mode 100644 index 00000000..8525f815 --- /dev/null +++ b/rubbos/app/tomcat-connectors-1.2.32-src/xdocs/miscellaneous/faq.xml @@ -0,0 +1,324 @@ +<?xml version="1.0"?> +<!DOCTYPE document [ + <!ENTITY project SYSTEM "project.xml"> +]> +<document url="faq.html"> + + &project; +<copyright> + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +</copyright> +<properties> +<title>FAQ</title> +<author email="hgomez@apache.org">Henri Gomez</author> +<date>$Date: 2009-03-05 12:42:14 +0100 (Thu, 05 Mar 2009) $</date> +</properties> +<body> +<section name="General"> +<p> +General Informations and FAQ about JK +</p> +<subsection name="Where can I get help/support for JK ?"> +<p> +The primary mechanism for support is through the JK +documentation included in the doc directory. +Documentation is also available on the Apache Tomcat web site devoted to the +<a href="http://tomcat.apache.org/connectors-doc/"> +Apache Tomcat Connectors Project</a> +For additional help, the best resource is the Tomcat Users Discussion list. +You should start by searching +<a href="http://mail-archives.apache.org/mod_mbox/tomcat-users/"> +the mail list archive</a> +before you post questions to the list. +If you are unable to locate the answer to your question in the archive, +you can post questions about JK to the user list for assistance. +Make sure that you include the version of your Webserver, +that you are using as well as the platform you are running on +and go +<a href="http://tomcat.apache.org/lists.html"> +here</a> +to determine how to subscribe to tomcat mailing list. +</p> +</subsection> + +<subsection name="I can't find JK anywhere. Where is it?"> +<p> +Now that JK moved to the <b>tomcat-connectors</b> repository, +the source and the binaries for JK can be downloaded from a mirror at the +<a href="http://tomcat.apache.org/download-connectors.cgi"> +Tomcat Connectors (mod_jk, mod_jk2) Downloads</a> page. +</p> +</subsection> + +<subsection name="What's the difference between JK and mod_jk ?"> +<br /> +<p> +<b>JK</b> is a project covering web-servers to Tomcat connectors, +whereas <b>mod_jk</b> is the <a href="../webserver_howto/apache.html">Apache module</a> developed in JK. +</p> + +<p> +<a href="../webserver_howto/iis.html">IIS webserver</a>support is implemented on JK, using a redirector +called <b>isapi redirector</b>. +</p> + +<p> +<a href="../webserver_howto/nes.html">Netscape/SunONE/Sun webserver</a>webserver support is implemented on JK, using a redirector +called <b>nsapi redirector</b>. +</p> + +</subsection> + +<subsection name="Where can I get more information ?"> +<p> +For <b>JK 1.2.x</b>, you should read : +</p> + +<ul> + +<li> +<a href="../generic_howto/quick.html">For the impatient</a> +</li> + +<li> +<a href="../webserver_howto/apache.html">Apache and JK</a> +</li> + +<li> +<a href="../webserver_howto/iis.html">IIS and JK</a> +</li> + +<li> +<a href="../webserver_howto/nes.html">Netscape/SunONE/Sun and JK</a> +</li> + +<li> +<a href="../generic_howto/workers.html">Workers configuration</a> +</li> +</ul> + +<p> +For more detailed information, have a look at the Reference Guide. +You could also try searching the mailing list archives for "JK" or look at the source. +</p> +</subsection> + +<subsection name="Which protocol should I use? Ajp12 or Ajp13?"> +<p> +<a href="../ajp/ajpv13a.html">Ajp13</a> is a newer protocol, it's faster, and it works better with SSL. +You almost certainly want to use it now that <strong>ajp12 is deprecated</strong>. +</p> +<p> +Also ajp13 is supported by all Apache Tomcat including 3.2.x , 3.3.x, 4.0.x, 4.1.x, 5.0.x, 5.5.x +and the new tomcat 6. +</p> + +<p> +Others Servlet engines like <b>jetty</b> have support for Ajp13. +</p> +</subsection> + +<subsection name="I've got a firewall between my web server and Tomcat which drops ajp13 connections after some time"> +<p> +Ajp13 uses persistant connections where the traffic could be null if there is no request to be sent to Tomcat. +Firewalls use to drop inactive connections and will make your web server and Tomcat think the connection is valid. +</p> +<p> +Starting with JK 1.2.0, a <b>socket_keepalive</b> property as been added to ajp13 settings, and you should take a look at +it in <a href="../generic_howto/workers.html">Workers HowTo</a> and +<a href="../reference/workers.html">workers.properties reference</a>. +If nothing else helps, you can try <b>JkOptions +DisableReuse</b>, but this will have strong performance implications. +</p> +</subsection> + +<subsection name="Under heavy load, I've got many threads in Tomcat even if my Apache Web Server handles much of the load"> +<p> +Under heavy load, Apache Web Server creates many children to handle the load, +which will in turn create many connections +to Tomcat to forward the requests they should handle. +Apache Web Server will normally kill the children/threads when the load decreases. +But if the load is still there and even if only Apache handles the requests, +ie static contents, the children are kept and with them all the ajp13 connections, +even if they are no more used. +</p> +<p> +To close connections after some time of inactivity you can use <b>connection_pool_timeout</b>, +for more informations refer to <a href="../reference/workers.html">workers.properties reference</a>. +</p> +</subsection> + +</section> + +<section name="Apache"> +<p> +Informations and FAQ about mod_jk and Apache Web Servers. +</p> +<subsection name="Whenever I restart Tomcat, Apache locks up!"> +<p> +The Ajp13 protocol keeps an open socket between Tomcat and Apache. +Release of mod_jk present in J-T-C handles the network failure. +But with very ancient releases of mod_jk, you may have to restart Apache as well. +</p> +</subsection> + +<subsection name="Why do there exist two files mod_jk.so (-eapi ad -noeapi) in download directories for Apache 1.3?"> +<p> +Many versions of Apache use a modified API, known at Extended API, developed for use with the +<a href="http://www.modssl.org">mod_ssl module</a>. Starting with Apache 2.0 there is no more difference. +</p> + +<p> +For example, Apache 1.3 present in certains recent Linux distributions include the +<b>mod_ssl</b> module. +</p> + +<p> +So if you got such 'Extended Apache', you need to use <b>mod_jk.so-eapi</b>. +</p> + +<p> +You should use <b>mod_jk.so-noeapi</b> only for 'Standard Apache' (ie without mod_ssl). +</p> + +<p> +It's wise to avoid using EAPI modules on STD API Apache or to use standard API modules on EAPI Apache. +Allways be sure to have the <b>mod_jk.so</b> witch match your version of Apache +</p> +</subsection> + +<subsection name="What's that message about 'garbled DSO ?'"> +<p> +It's related to Apache EAPI, the message <code>'mod_jk.so is garbled - perhaps this is not an Apache module DSO ?'</code> +just told you, that your're trying to install a mod_jk.so DSO module that was compiled on an Apache using EAPI, +like apache-mod_ssl or apache from Redhat distro 6.2/7.0 but your system use the standard apache with normal API. +</p> +</subsection> + +<subsection name="And the message about 'module might crash under EAPI!"> +<p> +Also related to EAPI, the message <code>'[warn] Loaded DSO /usr/lib/apache/mod_jk.so uses plain Apache 1.3 API, +this module might crash under EAPI! (please recompile it with -DEAPI)'</code>, the mod_jk.so was compiled under normal +Apache with standard API and you try to install the module on an Apache using EAPI. +</p> +</subsection> + +<subsection name="APXS is getting an error during the build of mod_jk, like rc=0 or rc=255. I tried all of the steps in the build section, what do I do now ?"> +<p> +APXS is a Perl script that is created when you build the Apache web server from source. +Chances are that if you are getting these errors and you obtained Apache as a binary distribution, +that APXS is not configured correctly for your system. +Your best bet is to get the Apache source from http://httpd.apache.org and build it yourself. +Use the following for a basic build (read the Apache docs for other options): +<screen> +<type>cd /usr/local/src</type><br/> +<type>gzip -dc apache_1.3.19.tar.gz|tar xvf -</type><br/> +<type>cd apache_1.3.19</type><br/> +<type>./configure --prefix=/usr/local/apache \</type><br/> +<type> --enable-module=most \</type><br/> +<type> --enable-shared=max</type><br/> +<type>make</type><br/> +<type>make install</type><br/> +</screen> +</p> +<p> +Note: The above steps assume that you downloaded the Apache source and placed it in your /usr/local/src directory. +</p> +</subsection> + +<subsection name="Apache 2.0 complains about incorrect module version"> +<p> +Since Apache 2.0 API still change often, the Apache 2.0 teams decide to put in headers of compiled modules the +Apache 2.0 version used to compile the module. This check is called Magic Module Number bump. +</p> +<p> +At start time Apache 2.0 check that version in modules headers and stop if it detect that a module was compiled +for another Apache 2.0 version. As such you should allways use modules compiled for the same Apache 2.0 version. +This check may be removed if the future. +</p> +</subsection> + +<subsection name="Does it work for Apache 2.2?"> +<p> +mod_jk works well with Apache 2.2. You need a binary module compiled for version 2.2 of the Apache web server. +A binary compiled for version 2.0 will not work. +</p> +<p> +Important parts of the functionality of mod_jk have been reimplemented as Apache httpd modules mod_proxy_ajp +and mod_proxy_balancer. These are part of the standard distributoin of Apache 2.2. The new modules do not contain +all features of mod_jk, but you get them automatically with every Apache 2.2. +</p> +</subsection> + +<subsection name="JNI doesn't work with Apache 1.3"> +<warn>JNI workers have been deprecated. They will likely not work. Do not use them.</warn> +<p> +JNI support requires a multi-threaded environment which is not the general case for Apache 1.3. +You should verify if Apache 1.3 has been build with thread support and if not you could add the +the pthreads library to your <b>httpd.conf</b> file. +</p> + +<source> + # Add pthread to Apache in httpd.conf + LoadModule "/usr/lib/libpthreads.so" +</source> + +<p> +Also keep in mind that JNI is suited for multi-threaded servers and you should consider upgrading +to Apache 2.x to support JNI. +</p> +</subsection> + +<subsection name="JNI report that JVM couldn't be started under Linux"> +<warn>JNI workers have been deprecated. They will likely not work. Do not use them.</warn> +<p> +Under Linux, you should set some environment variables BEFORE launching your Apache server : +</p> + +<screen> +<read>export LD_LIBRARY_PATH=$jre/bin:$jre/bin/classic:$LD_LIBRARY_PATH</read> +</screen> + +<p> +Also some Linux distributions have enabled a GLIBC feature called 'floating stacks' which may not works with kernel +less than 2.4.10 on SMP machines. You should disable floating stacks by exporting an environment variable : +</p> + +<screen> +<read>export LD_ASSUME_KERNEL=2.2.5</read> +</screen> + +<p> +You could have to update your service scripts, ie <b>/etc/rc.d/init.d/httpd</b>, to set these env vars +before your httpd server starts. +</p> +</subsection> + +<subsection name="Mixed errors when building via configure"> +<p> +configure assume you have some GNU tools already installed and configured for your system, and ad minima <b>libtool</b>. +</p> +<p> +Also some systems may have mixed cc and gcc setup which may make you puzzled when trying to link an Apache built with native +c compiler with a jk/jk2 build with gcc. +</p> +<p> +In case the make processing doesn't work as expected, you should use a GNU make <b>gmake</b>. +</p> +</subsection> + +</section> +</body> +</document> diff --git a/rubbos/app/tomcat-connectors-1.2.32-src/xdocs/miscellaneous/jkstatustasks.xml b/rubbos/app/tomcat-connectors-1.2.32-src/xdocs/miscellaneous/jkstatustasks.xml new file mode 100644 index 00000000..290dec4d --- /dev/null +++ b/rubbos/app/tomcat-connectors-1.2.32-src/xdocs/miscellaneous/jkstatustasks.xml @@ -0,0 +1,218 @@ +<?xml version="1.0"?> +<!DOCTYPE document [ + <!ENTITY project SYSTEM "project.xml"> +]> +<document url="jkstatustasks.html"> + + &project; + +<copyright> + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +</copyright> + +<properties> +<title>Status Worker Ant Tasks</title> +<author>Peter Rossbach</author> +<date>$Date: 2008-03-26 00:47:22 +0100 (Wed, 26 Mar 2008) $</date> +</properties> + +<body> + +<section name="Introduction"> +<p>Since version 1.2.19 the JK release contains additional ant tasks. +They can be used to manage the JK web server plugins via the special status worker. +</p> +</section> + +<section name="Manage JK with remote Ant Tasks"> + +<subsection name="Simple antlib integration"> +<p> +<source> +<?xml version="1.0" encoding="UTF-8"?> + +<project name="modjk-status" + xmlns:jk="urn:org-apache-jk-status" + default="status" basedir="."> + + <property name="profile" value=""/> + <property file="jkstatus${profile}.properties"/> + <property file="jkstatus.properties.default"/> + + <path id="jkstatus.classpath"> + <fileset dir="${catalina.home}/bin"> + <include name="commons-logging-api-*.jar"/> + </fileset> + <pathelement location="${catalina.home}/server/lib/catalina-ant.jar"/> + <pathelement location="../dist/tomcat-jkstatus-ant.jar"/> + <pathelement location="${catalina.home}/server/lib/tomcat-util.jar"/> + </path> + + <typedef resource="org/apache/jk/status/antlib.xml" + uri="urn:org-apache-jk-status" classpathref="jkstatus.classpath"/> + + <target name="status" > + <jk:status url="${jkstatus.url}" + username="${jkstatus.username}" + password="${jkstatus.password}" + resultproperty="worker" + echo="off" + failOnError="off"/> + <echoproperties prefix="worker" /> + </target> +</project> +</source> +</p> +</subsection> + +<subsection name="Test Result"> +<p> +<source> +[echoproperties] #Ant properties +[echoproperties] #Sun Dec 10 20:40:21 CET 2006 +[echoproperties] worker.node01.lbmult=1 +[echoproperties] worker.loadbalancer.lock=Optimistic +[echoproperties] worker.node02.transferred=0 +[echoproperties] worker.loadbalancer.sticky_session=false +[echoproperties] worker.node01.distance=0 +[echoproperties] worker.node01.client_errors=0 +[echoproperties] worker.node02.lbmult=1 +[echoproperties] worker.node01.port=7309 +[echoproperties] worker.node01.elected=0 +[echoproperties] worker.loadbalancer.good=2 +[echoproperties] worker.loadbalancer.method=Sessions +[echoproperties] worker.server.port=2090 +[echoproperties] worker.loadbalancer.map.2.type=Wildchar +[echoproperties] worker.node02.route=node02 +[echoproperties] worker.node01.route=node01 +[echoproperties] worker.node01.lbvalue=0 +[echoproperties] worker.node01.lbfactor=1 +[echoproperties] worker.node01.max_busy=0 +[echoproperties] worker.node01.busy=0 +[echoproperties] worker.node01.redirect= +[echoproperties] worker.node02.distance=0 +[echoproperties] worker.loadbalancer.name=loadbalancer +[echoproperties] worker.loadbalancer.sticky_session_force=false +[echoproperties] worker.node02.state=N/A +[echoproperties] worker.node01.state=N/A +[echoproperties] worker.node01.transferred=0 +[echoproperties] worker.loadbalancer.map.length=2 +[echoproperties] worker.node01.type=ajp13 +[echoproperties] worker.node01.address=127.0.0.1\:7309 +[echoproperties] worker.result.type=OK +[echoproperties] worker.loadbalancer.member_count=2 +[echoproperties] worker.loadbalancer.map_count=2 +[echoproperties] worker.loadbalancer.mtime_to_maintenance_min=12 +[echoproperties] worker.loadbalancer.mtime_to_maintenance_max=75 +[echoproperties] worker.node02.lbfactor=1 +[echoproperties] worker.node02.max_busy=0 +[echoproperties] worker.jk_version=mod_jk/1.2.21-dev +[echoproperties] worker.loadbalancer.bad=0 +[echoproperties] worker.node02.redirect= +[echoproperties] worker.node01.host=localhost +[echoproperties] worker.node02.activation=ACT +[echoproperties] worker.loadbalancer.map.1.source=JkMount +[echoproperties] worker.loadbalancer.retries=2 +[echoproperties] worker.node02.elected=0 +[echoproperties] worker.loadbalancer.map.2.source=JkMount +[echoproperties] worker.node02.port=7409 +[echoproperties] worker.loadbalancer.length=2 +[echoproperties] worker.node02.lbvalue=0 +[echoproperties] worker.loadbalancer.degraded=0 +[echoproperties] worker.loadbalancer.map.1.type=Wildchar +[echoproperties] worker.loadbalancer.map.2.uri=/myapps* +[echoproperties] worker.node02.client_errors=0 +[echoproperties] worker.length=1 +[echoproperties] worker.node01.domain=d20 +[echoproperties] worker.loadbalancer.recover_time=60 +[echoproperties] worker.server.name=localhost +[echoproperties] worker.node02.domain= +[echoproperties] worker.result.message=Action finished +[echoproperties] worker.node02.busy=0 +[echoproperties] worker.node01.readed=0 +[echoproperties] worker.node01.errors=0 +[echoproperties] worker.node02.address=127.0.0.1\:7409 +[echoproperties] worker.node02.readed=0 +[echoproperties] worker.loadbalancer.busy=0 +[echoproperties] worker.web_server=Apache/2.0.59 (Unix) mod_jk/1.2.21-dev +[echoproperties] worker.node02.errors=0 +[echoproperties] worker.node02.type=ajp13 +[echoproperties] worker.loadbalancer.map.1.uri=/ClusterTest* +[echoproperties] worker.node01.activation=ACT +[echoproperties] worker.loadbalancer.max_busy=0 +[echoproperties] worker.loadbalancer.type=lb +[echoproperties] worker.node02.host=localhost +</source> +</p> +</subsection> + +<subsection name="Update Load Balancer"> +<p> +<source> + <target name="updatelb" > + <jk:updateloadbalancer url="${jkstatus.url}" + username="${jkstatus.username}" + password="${jkstatus.password}" + loadbalancer="loadbalancer" + method="Busyness" + retries="2" + recoverWaitTime="60" + lock="Optimistic" + forceStickySession="false" + stickySession="false"/> + </target> +</source> +</p> +</subsection> + +<subsection name="Update Worker"> +<p> +<source> + <target name="updatew" > + <jk:updateworker url="${jkstatus.url}" + username="${jkstatus.username}" + password="${jkstatus.password}" + loadbalancer="loadbalancer" + worker="node01" + lbfactor="2" + activation="Active" + redirect="" + domain="" + route="node01" + distance="0"/> + </target> +</source> +</p> +</subsection> + +<subsection name="Reset Worker"> +<p> +<source> + <target name="reset" > + <jk:reset url="${jkstatus.url}" + username="${jkstatus.username}" + password="${jkstatus.password}" + loadbalancer="loadbalancer" + worker="node01" + /> + </target> +</source> +</p> +</subsection> + +</section> +</body> +</document> diff --git a/rubbos/app/tomcat-connectors-1.2.32-src/xdocs/miscellaneous/project.xml b/rubbos/app/tomcat-connectors-1.2.32-src/xdocs/miscellaneous/project.xml new file mode 100644 index 00000000..00188659 --- /dev/null +++ b/rubbos/app/tomcat-connectors-1.2.32-src/xdocs/miscellaneous/project.xml @@ -0,0 +1,81 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<project name="Apache Tomcat Connector Documentation - Miscellaneous Documentation" + href="http://tomcat.apache.org/"> + + <title>The Apache Tomcat Connector - Miscellaneous Documentation</title> + + <logo href="/images/tomcat.gif"> + The Apache Tomcat Connector - Miscellaneous Documentation + </logo> +<body> + + <menu name="Links"> + <item name="Docs Home" href="../index.html"/> + </menu> + + <menu name="Reference Guide"> + <item name="workers.properties" href="../reference/workers.html"/> + <item name="uriworkermap.properties" href="../reference/uriworkermap.html"/> + <item name="Status Worker" href="../reference/status.html"/> + <item name="Apache HTTP Server" href="../reference/apache.html"/> + <item name="IIS" href="../reference/iis.html"/> + </menu> + + <menu name="Generic HowTo"> + <item name="For the impatient" href="../generic_howto/quick.html"/> + <item name="All about workers" href="../generic_howto/workers.html"/> + <item name="Timeouts" href="../generic_howto/timeouts.html"/> + <item name="Load Balancing" href="../generic_howto/loadbalancers.html"/> + <item name="Reverse Proxy" href="../generic_howto/proxy.html"/> + </menu> + + <menu name="Webserver HowTo"> + <item name="Apache HTTP Server" href="../webserver_howto/apache.html"/> + <item name="IIS" href="../webserver_howto/iis.html"/> + <item name="Netscape/SunOne/Sun" href="../webserver_howto/nes.html"/> + </menu> + + <menu name="AJP Protocol Reference"> + <item name="AJPv13" href="../ajp/ajpv13a.html"/> + <item name="AJPv13 Extension Proposal" href="../ajp/ajpv13ext.html"/> + </menu> + + <menu name="Miscellaneous Documentation"> + <item name="Frequently asked questions" href="../miscellaneous/faq.html"/> + <item name="Changelog" href="../miscellaneous/changelog.html"/> + <item name="Current Tomcat Connectors bugs" href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=Tomcat+Connectors&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0="/> + <item name="Contribute documentation" href="../miscellaneous/doccontrib.html"/> + <item name="JK Status Ant Tasks" href="../miscellaneous/jkstatustasks.html"/> + <item name="Reporting Tools" href="../miscellaneous/reporttools.html"/> + <item name="Old JK/JK2 documentation" href="http://tomcat.apache.org/connectors-doc-archive/jk2/index.html"/> + </menu> + + <menu name="News"> + <item name="2011" href="../news/20110701.html"/> + <item name="2010" href="../news/20100101.html"/> + <item name="2009" href="../news/20090301.html"/> + <item name="2008" href="../news/20081001.html"/> + <item name="2007" href="../news/20070301.html"/> + <item name="2006" href="../news/20060101.html"/> + <item name="2005" href="../news/20050101.html"/> + <item name="2004" href="../news/20041100.html"/> + </menu> + +</body> +</project> diff --git a/rubbos/app/tomcat-connectors-1.2.32-src/xdocs/miscellaneous/reporttools.xml b/rubbos/app/tomcat-connectors-1.2.32-src/xdocs/miscellaneous/reporttools.xml new file mode 100644 index 00000000..b5162abd --- /dev/null +++ b/rubbos/app/tomcat-connectors-1.2.32-src/xdocs/miscellaneous/reporttools.xml @@ -0,0 +1,91 @@ +<?xml version="1.0"?> +<!DOCTYPE document [ + <!ENTITY project SYSTEM "project.xml"> +]> +<document url="reporttools.html"> + + &project; +<copyright> + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +</copyright> +<properties> +<title>Reporting Tools</title> +<author>Glenn Nielsen</author> +<date>$Date: 2009-10-18 16:13:42 +0200 (Sun, 18 Oct 2009) $</date> +</properties> +<body> +<section name="Reporting Tools"> +<p> +The mod_jk source distribution contains two perl scripts in the +tools/reports directory which can be used to analyze the mod_jk +logs, save statistical data, and generate report graphs. +</p> + +<p><code>tomcat_trend.pl log_dir archive_dir</code></p> +<p> +Script for analyzing mod_jk.log data when logging tomcat request data using +the <code>JkRequestLogFormat</code> Apache mod_jk configuration. +Generates statistics for request latency and errors. Archives the generated +data to files for later use in long term trend graphs and reports. +</p> + +<p><code>tomcat_reports.pl archive_dir reports_dir</code></p> +<p> +Script for generating reports and graphs using statistical data generated +by the <code>tomcat_trend.pl</code> script. + +The following graphs are created: +<ul> + <li>tomcat_request.png - Long term trend graph of total number of tomcat + requests handled.</li> + <li>tomcat_median.png - Long term overall trend graph of tomcat request + latency median.</li> + <li>tomcat_deviation.png - Long term overall trend graph of tomcat request + mean and standard deviation.</li> + <li>tomcat_error.png - Long term trend graph of requests rejected by tomcat. + Shows requests rejected when tomcat has no request processors available. + Can be an indicator that tomcat is overloaded or having other scaling + problems.</li> + <li>tomcat_client.png - Long term trend graph of requests forward to tomcat + which were aborted by the remote client (browser). You will normally see + some aborted requests. High numbers of these can be an indicator that + tomcat is overloaded or there are requests which have very high latency.</li> +</ul> +</p> + +<p> +A great deal of statistical data is generated but at this time +only long term trend graphs are being created and no reports. +This is only a start. Many more graphs and reports could be +generated from the data. Please consider contributing back any +new reports or graphs you create. Thanks. +</p> + +<p> +These perl scripts depend upon the following perl modules and libraries: +<ul> + <li>GD 1.8.x graphics library <a href="http://www.boutell.com/gd/"> + http://www.boutell.com/gd/</a></li> + <li>GD 1.4.x perl module</li> + <li>GD Graph perl module</li> + <li>GD TextUtil perl module</li> + <li>StatisticsDescriptive perl module</li> +</ul> +</p> +</section> + +</body> +</document> |