rubbos/app/tomcat-connectors-1.2.32-src/docs/reference/printer/status.html

   1 <html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>The Apache Tomcat Connector - Reference Guide - Status Worker Reference</title><meta name="author" value="Rainer Jung"><meta name="email" value="rjung@apache.org"><link href="../../style.css" type="text/css" rel="stylesheet"></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="4"><!--PAGE HEADER--><tr><td colspan="2"><!--TOMCAT LOGO--><a href="http://tomcat.apache.org/"><img src="../../images/tomcat.gif" align="left" alt="Apache Tomcat" border="0"></a><!--APACHE LOGO--><a href="http://www.apache.org/"><img src="http://www.apache.org/images/asf-logo.gif" align="right" alt="Apache Logo" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left"><table border="0" width="100%" cellspacing="4"><tr><td align="left" valign="top"><h1>The Apache Tomcat Connector - Reference Guide</h1><h2>Status Worker Reference</h2></td><td align="right" valign="top" nowrap="true"><img src="../../images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Introduction"><strong>Introduction</strong></a></font></td></tr><tr><td><blockquote>
   2 <br>
   3 <p>
   4 Tomcat Connectors has a special type of worker, the so-called status worker.
   5 The status worker does not forward requests to Tomcat instances. Instead it allows
   6 to retrieve status and configuration information at runtime,
   7 and furthermore to change many configuration items dynamically. This can be done
   8 via a simple embedded web interface.
   9 </p>
  10 <p>
  11 The status worker is especially powerful, when used together with load balancing workers.
  12 </p>
  13 <p>
  14 This document does not explain the HTML user interface of the status worker.
  15 Until now it is very simple, so just go ahead and use it. This doc instead
  16 tries to explain the less obvious features of the status worker. We also will give a
  17 complete coverage of the various request parameters and their meaning, so that you can
  18 include the status worker in your automation scripts.
  19 </p>
  20 <p>
  21 The documentation of the status worker starts with <b>jk 1.2.20</b>
  22 </p>
  23 </blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Usage Patterns"><strong>Usage Patterns</strong></a></font></td></tr><tr><td><blockquote>
  24 <br>
  25 <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Actions"><strong>Actions</strong></a></font></td></tr><tr><td><blockquote>
  26 <br>
  27 <p>
  28 The status worker knows about six actions.
  29 <ul>
  30 <li>
  31 <b>list</b>: lists the configurations and runtime information of all configured workers.
  32 The output will be grouped by global information first (version data), then load balancer
  33 information, after that AJP worker information and finally the legend. For load balancers,
  34 there will be a summary part, and after that details for each member worker. For all workers,
  35 we also include the URL mappings (forward definitions).
  36 </li>
  37 <li>
  38 <b>show</b>: the same as list, but only shows data for one chosen worker
  39 </li>
  40 <li>
  41 <b>edit</b>: produces a form to edit configuration data for a chosen worker. There is a
  42 special subtype of "edit", that makes it easy to change one attribute for all members of
  43 a load balancer, e.g. their activation state.
  44 </li>
  45 <li>
  46 <b>update</b>: commit changes made in an edit form. <b>Caution</b>: the changes will not be
  47 persisted to the configuration files. As soon as your restart your web server, all changes
  48 made through the status worker will be lost! On the other hand, the changes done by the status
  49 worker will be applied during runtime without a restart of the web server.
  50 </li>
  51 <li>
  52 <b>reset</b>: reset all runtime statistics for a worker.
  53 </li>
  54 <li>
  55 <b>recover</b>: Mark a member of a load balancer, that is in error state, for immediate recovery.
  56 </li>
  57 <li>
  58 <b>version</b>: only show version information of the web server and the JK software
  59 </li>
  60 <li>
  61 <b>dump</b>: list the original workers configuration. <b>Caution</b>: the dump will only contain
  62 the configuration that was used during startup. Any changes applied later by the dynamic management
  63 interface of the status worker itself will not be contained in this dump.
  64 The dump action has been added in version 1.2.27.
  65 </li>
  66 </ul>
  67 </p>
  68 </blockquote></td></tr></table>
  69
  70 <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Output Format"><strong>Output Format</strong></a></font></td></tr><tr><td><blockquote>
  71 <br>
  72 <p>
  73 For most actions you can choose between 4 output formats.
  74 <ul>
  75 <li>
  76 <b>HTML</b>: Used interactively with a browser
  77 </li>
  78 <li>
  79 <b>XML</b>: Mostly useful for automation, when your scripting environment is XML friendly.
  80 This format has rich structure information, but does not work line based, so you would really
  81 like to use it together with XML tools.
  82 </li>
  83 <li>
  84 <b>Properties</b>: This format is a line based format, that conforms to the rules of Java
  85 property files. Most structure information is contained in the hierarchical key. For information,
  86 that is of configuration nature, the format should produce lines very similar to the ones you can
  87 use in workers.properties. It will not produce a complete configuration file!
  88 </li>
  89 <li>
  90 <b>Text</b>: A simple textual output format.
  91 </li>
  92 </ul>
  93 The "edit" action does only make sense for the HTML output type.
  94 </p>
  95 </blockquote></td></tr></table>
  96
  97 <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="User Interface Features"><strong>User Interface Features</strong></a></font></td></tr><tr><td><blockquote>
  98 <br>
  99 <p>
 100 In the HTML view, there is an <b>automatic refresh</b> feature, implemented via the meta refresh
 101 option of HTML. Once you start the automatic refresh, the UI will will respect it for all actions
 102 except edit, update and maintain. Even if you navigate through one of those, the automatic refresh
 103 will start again as soon as you come back to one of the other actions.
 104 </p>
 105 <p>
 106 Many parts of the HTML page can be minimised, if they are not interesting for you. There are a couple
 107 of "Hide" links, which will collapse parts of the information. The feature exists for the following
 108 blocks of information:
 109 <ul>
 110 <li>
 111 <b>Legend</b>: Do not show the legend for the information presented in "list" and "show" actions
 112 </li>
 113 <li>
 114 <b>URI mappings</b>: Do not show the URI mapping for the workers
 115 </li>
 116 <li>
 117 <b>Load Balancing Workers</b>: Do not show workers of type "lb"
 118 </li>
 119 <li>
 120 <b>AJP Workers</b>: Do not show workers of type ajp
 121 </li>
 122 <li>
 123 <b>Balancer Members</b>: Do not show detailed information concerning each member of load balancers
 124 </li>
 125 <li>
 126 <b>Load Balancer Configuration</b>: Do not show configuration data for load balancers
 127 </li>
 128 <li>
 129 <b>Load Balancer Summary</b>: Do not show status summary for load balancers
 130 </li>
 131 <li>
 132 <b>AJP Configuration</b>: Do not show configuration data for ajp workers load balancer members
 133 </li>
 134 </ul>
 135 The last three minimisation features have been added in version 1.2.27.
 136 </p>
 137 </blockquote></td></tr></table>
 138
 139 <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Special Considerations concerning URL Maps and Virtual Hosts"><strong>Special Considerations concerning URL Maps and Virtual Hosts</strong></a></font></td></tr><tr><td><blockquote>
 140 <br>
 141 <p>
 142 <b>Note: </b>The following restriction has been removed starting with version 1.2.26.
 143 </p>
 144 <p>
 145 The Apache module mod_jk makes use of the internal Apache httpd infrastructure concerning
 146 virtual hosts. The downside of this is, that the status worker can only show URL maps, for
 147 the virtual host it is defined in. It is not able to reach the configuration objects
 148 for other virtual hosts. Of course you can define a status worker in any virtual host you
 149 are using. All information presented apart from the URL maps will be the same, independent
 150 of the virtual host the status worker has been called in.
 151 </p>
 152 </blockquote></td></tr></table>
 153
 154 <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Logging"><strong>Logging</strong></a></font></td></tr><tr><td><blockquote>
 155 <br>
 156 <p>
 157 The status worker will log changes made to the configuration with log level "info" to the usual
 158 JK log file. Invalid requests will be logged with log level "warn". If you want to report some
 159 broken behaviour, log file content of level "debug" or even "trace" will be useful.
 160 </p>
 161 </blockquote></td></tr></table>
 162
 163 </blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Configuration"><strong>Configuration</strong></a></font></td></tr><tr><td><blockquote>
 164 <br>
 165 <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Basic Configuration"><strong>Basic Configuration</strong></a></font></td></tr><tr><td><blockquote>
 166 <br>
 167 <p>
 168 The basic configuration of a status worker is very similar to that of a usual ajp worker.
 169 You need to specify a name for the worker, and the URLs you want to map to it. The first
 170 part of the configuration happens in the workers.properties file. We define a worker named
 171 mystatus of type status:
 172 <div class="example"><pre>
 173 worker.list=mystatus
 174 worker.mystatus.type=status
 175 </pre></div>
 176 Then we define a URL, which should be mapped to this worker, i.e. the URL we use
 177 to reach the functionality of the status worker. You can use any method mod_jk supports
 178 for the web server of your choice. Possibilities are maps inside uriworkermap.properties,
 179 an additional mount attribute in workers.properties, or in Apache JkMount. Here's an
 180 example for a uriworkermap.properties line:
 181 <div class="example"><pre>
 182 /private/admin/mystatus=mystatus
 183 </pre></div>
 184 The URI pattern is case sensitive.
 185 </p>
 186 <p>
 187 As you will learn in the following sections, the status worker is very powerful. You should
 188 use the usual authentication and authorisation methods of your web server to secure this URL.
 189 </p>
 190 <p>
 191 You can also define multiple instances of the status worker, by using different names and URL mappings.
 192 For instance you might want to configure them individually
 193 and then allow special groups of people to use them
 194 </p>
 195 </blockquote></td></tr></table>
 196
 197 <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Output Customisation"><strong>Output Customisation</strong></a></font></td></tr><tr><td><blockquote>
 198 <br>
 199 <p>
 200 There are a couple of attributes for the workers.properties entries, which allow to customise
 201 various aspects of the output of the status worker.
 202 </p>
 203 <p>
 204 The attribute <b>css</b> can be set to the URL of a stylesheet:
 205 <div class="example"><pre>
 206 worker.mystatus.css=/private/admin/static/mystatus.css
 207 </pre></div>
 208 When writing HTML output, the status worker then includes the line
 209 <div class="example"><pre>
 210 &lt;link rel="stylesheet" type="text/css" href="/private/admin/static/mystatus.css" /&gt;
 211 </pre></div>
 212 There is no sample stylesheet included with the mod_jk release, and by default the attribute css
 213 is empty, so no stylesheet reference will be included in the pages. The HTML code
 214 of the status worker output pages does not include any class attributes. If you like to contribute a
 215 stylesheet or improvements to the HTML layout, please contact us on the tomcat developers list.
 216 </p>
 217 <p>
 218 The properties output format can be customised via the attribute <b>prefix</b>. The names of all
 219 properties the status worker does output, will begin with this prefix. The default is "worker".
 220 </p>
 221 <p>
 222 Several attributes influence the format when writing XML output.
 223 The attribute <b>ns</b> allows to set a namespace prefix, that will be used for every status worker+element.
 224 The default is "jk:". Setting it to "-" disables the namespace prefix.
 225 </p>
 226 <p>
 227 With the attribute xmlns you can map the prefix to a namespace URL. The default value
 228 is xmlns:jk="http://tomcat.apache.org". Setting it to "-" disables the output of the URL.
 229 </p>
 230 <p>
 231 Finally you can specify an XML document type via the attribute doctype. The specified string will
 232 be inserted at the beginning of the document, directly after the xml header. The default is empty.
 233 </p>
 234 </blockquote></td></tr></table>
 235
 236 <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Securing Access"><strong>Securing Access</strong></a></font></td></tr><tr><td><blockquote>
 237 <br>
 238 <p>
 239 We urge you to use the builtin access control features of your web server to control
 240 access to the status worker URLs you have chosen. Nevertheless two configuration
 241 attributes of status workers are helpful. The attribute "read_only" disables all features of
 242 the status worker, that can be used to change configurations or runtime status of the other workers.
 243 A read_only status worker will not allow access to the edit, update, reset or recover actions.
 244 The default value is "False", ie. read/write. To enable read_only you need to set it to "True".
 245 </p>
 246 <p>
 247 You could configure two status workers, one has read_only and will be made available to a larger
 248 admin group, the other one will be used fully featured, but only by fewer people:
 249 <div class="example"><pre>
 250 worker.list=jk-watch
 251 worker.jk-watch.type=status
 252 worker.jk-watch.read_only=True
 253 worker.jk-watch.mount=/user/status/jk
 254 worker.list=jk-manage
 255 worker.jk-manage.type=status
 256 worker.jk-manage.mount=/admin/status/jk
 257 </pre></div>
 258 Starting with version 1.2.21, a read/write status worker can also be switched temporarily
 259 into read-only mode by the user via a link in the HTML GUI. The user can always switch it
 260 back to read/write. Only a status worker configured as read-only via the "read_only" attribute
 261 is completely safe from applying any changes.
 262 </p>
 263 <p>
 264 The other attribute you can use is <b>user</b>. By default this list is empty, which means
 265 no limit on the users. You can set "user" to a comma separated list of user names. If your
 266 web server is configured such that it sends the user names with the request, the status worker
 267 will check, if the name attached with the request is contained in it's "user" list.
 268 </p>
 269 <p>
 270 The user list can be split over multiple occurrences of the "user" attribute.
 271 </p>
 272 <p>
 273 By default, the user names are matched case sensitively. Starting with version 1.2.21 you can set
 274 the attribute <b>user_case_insensitive</b> to "True". Then the comparison will be made case insensitive.
 275 </p>
 276 </blockquote></td></tr></table>
 277
 278 <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Service Availability Rating"><strong>Service Availability Rating</strong></a></font></td></tr><tr><td><blockquote>
 279 <br>
 280 <p>
 281 For load balancing workers the status worker shows some interesting overview information.
 282 It categorises the members of the load balancer into the classes "good", "bad" and degraded".
 283 This feature can be combined with external escalation procedures. Depending on your global
 284 system design and your operating practises your preferred categorisation might vary.
 285 </p>
 286 <p>
 287 The categorisation is based on the activation state of the workers (active, disabled or stopped),
 288 which is a pure configuration state, and the runtime state
 289 (OK or ERR with possible substates idle, busy, recovering, probing, and forced recovery)
 290 which only depends on the runtime situation.
 291 </p>
 292 <p>
 293 The runtime substates have the following meaning:
 294 <ul>
 295 <li>
 296 <b>OK (idle)</b>: This worker didn't receive any request since the last balancer
 297 maintenance. By default balancer maintenance runs every 60 seconds. The
 298 worker should be OK, but since we didn't have to use it for some time, we
 299 can't be sure. This state has been called N/A before version 1.2.24.
 300 </li>
 301 <li>
 302 <b>OK (busy)</b>: All connections for this worker are in use for requests.
 303 </li>
 304 <li>
 305 <b>ERROR (recovering)</b>: The worker was in error state for some time and is now
 306 marked for recovery. The next request suitable for this worker will use it.
 307 </li>
 308 <li>
 309 <b>ERROR (probing)</b>: After setting the worker to recovering, we received a request
 310 suitable for this worker. This request is now using the worker.
 311 </li>
 312 <li>
 313 <b>ERROR (forced recovery)</b>: The worker is in error, but we don't have an alternative
 314 worker, so we keep using it.
 315 </li>
 316 </ul>
 317 </p>
 318 <p>
 319 By default the status worker groups into "good" all members, that have activation "active" and
 320 runtime state not equal to "error" with empty substate.
 321 The "bad" group consists of the members, that have either activation
 322 "stopped", or are in runtime state "error" with empty substate.
 323 </p>
 324 <p>
 325 Workers that fit neither of the two groups, are considered to be "degraded".
 326 </p>
 327 <p>
 328 You can define other rules for the grouping into good, bad and degraded.
 329 The two attributes "good" and "bad" can be populated by a comma-separated list ob single characters or
 330 dot-separated pairs. Each character stands for the first character of one of the possible states "active",
 331 "disabled", "stopped", "ok", "idle", "busy", "recovering" and "error". The additional states "probing"
 332 and "forced recovery" are always rated equivalent to "recovering".
 333 Comma-separated entries will be combined
 334 with logical "or", if you combine a configuration and a runtime state with a dot. the are combined with logical
 335 "and". So the default value for "good" is "a.o,a.i,a.b,a.r", for "bad" it is "e,s".
 336 </p>
 337 <p>
 338 The status worker first tries to match against the "bad" definitions, if this doesn't succeed
 339 it tries to match against "good", and finally it chooses "degraded", if no "bad" or "good" match
 340 can be found.
 341 </p>
 342 </blockquote></td></tr></table>
 343 </blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Request Parameters"><strong>Request Parameters</strong></a></font></td></tr><tr><td><blockquote>
 344 <br>
 345 <p>
 346 This section should help you building automation scripts based on the jk status
 347 management interface. This interface is stable in the sense, that we only expect
 348 to add further parameters in the future. Existing parameters from previous versions
 349 will keep their original semantics. We also expect the output formats XML, Properties
 350 and Text to be kept stable. So please use those, if you want to parse status worker
 351 output in your automation scripts.
 352 </p>
 353 <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Actions"><strong>Actions</strong></a></font></td></tr><tr><td><blockquote>
 354 <br>
 355 <p>
 356 The action is determined by the parameter <b>cmd</b>. It can have the values "list", "show",
 357 "edit", "update", "reset", "recover", "version" and "dump". If you omit the <b>cmd</b> parameter,
 358 the default "list" will be used.
 359 All actions except for "list", "refresh", "version" and "dump" need additional parameters.
 360 </p>
 361 <p>
 362 The action "dump" has been added in version 1.2.27.
 363 </p>
 364 </blockquote></td></tr></table>
 365 <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Output Format"><strong>Output Format</strong></a></font></td></tr><tr><td><blockquote>
 366 <br>
 367 <p>
 368 The format is determined by the parameter <b>mime</b>. It can have the values "html", "xml",
 369 "txt" and "prop". If you omit the <b>mime</b> parameter, the default "html"
 370 will be used. The action "edit" (the edit form) does only make sense for "mime=html".
 371 </p>
 372 </blockquote></td></tr></table>
 373 <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Worker Selection"><strong>Worker Selection</strong></a></font></td></tr><tr><td><blockquote>
 374 <br>
 375 <p>
 376 Actions that operate on a single worker need one or two additional parameters to select
 377 this worker. The parameter <b>w</b> contains the name of the worker from the worker list.
 378 If an action operates on a member (sub worker) of a load balancer, the parameter <b>w</b>
 379 contains the name of the load balancer worker, and the additional parameter <b>sw</b> contains the
 380 name of the sub worker.
 381 </p>
 382 </blockquote></td></tr></table>
 383 <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Automatic Refresh"><strong>Automatic Refresh</strong></a></font></td></tr><tr><td><blockquote>
 384 <br>
 385 <p>
 386 During automatic refresh, the parameter <b>re</b> contain the refresh interval in seconds.
 387 If you omit this parameter, automatic refresh will be off.
 388 </p>
 389 </blockquote></td></tr></table>
 390 <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Hide Options"><strong>Hide Options</strong></a></font></td></tr><tr><td><blockquote>
 391 <br>
 392 <p>
 393 The parameter <b>opt</b> contains a bit mask of activated options. The default is 0, so
 394 by default no options are activated. The following options exist:
 395 <ul>
 396 <li>
 397 <b>0x0001</b>: hide members of lb workers
 398 </li>
 399 <li>
 400 <b>0x0002</b>: hide URL maps
 401 </li>
 402 <li>
 403 <b>0x0004</b>: hide the legend
 404 </li>
 405 <li>
 406 <b>0x0008</b>: hide load balancer workers
 407 </li>
 408 <li>
 409 <b>0x0010</b>: hide ajp workers
 410 </li>
 411 <li>
 412 <b>0x0020</b>: only allow read_only actions for a read/write status worker.
 413 </li>
 414 <li>
 415 <b>0x0040</b>: hide load balancer configuration
 416 </li>
 417 <li>
 418 <b>0x0080</b>: hide load balancer status summary
 419 </li>
 420 <li>
 421 <b>0x0100</b>: hide configuration for ajp and load balancer member workers
 422 </li>
 423 </ul>
 424 Values 0x0040-0x0100 have been added in version 1.2.27.
 425 </p>
 426 </blockquote></td></tr></table>
 427 <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Data Parameters for the standard Update Action"><strong>Data Parameters for the standard Update Action</strong></a></font></td></tr><tr><td><blockquote>
 428 <br>
 429 <p>
 430 You can use the edit action with a final click to the update button, to change settings of workers.
 431 But you can also make direct calls to the update action. The following request parameters
 432 contain the configuration information, you want to change. First the list for load balancer workers:
 433 <ul>
 434 <li>
 435 <b>vlr</b>: retries (number)
 436 </li>
 437 <li>
 438 <b>vlt</b>: recover_time (seconds)
 439 </li>
 440 <li>
 441 <b>vlee</b>: error_escalation_time (seconds)
 442 </li>
 443 <li>
 444 <b>vlx</b>: max_reply_timeouts (number)
 445 </li>
 446 <li>
 447 <b>vls</b>: sticky_session (0/f/n/off=off, 1/t/y/on=on; case insensitive)
 448 </li>
 449 <li>
 450 <b>vlf</b>: sticky_session_force (0/f/n/off=off, 1/t/y/on=on; case insensitive)
 451 </li>
 452 <li>
 453 <b>vlm</b>: method (0/r="Requests", 1/t="Traffic", 2/b="Busyness", 3/s="Sessions"; case insensitive, only first character is used)
 454 </li>
 455 <li>
 456 <b>vll</b>: lock (0/o="Optimistic", 1/p="Pessimistic"; case insensitive, only first character is used)
 457 </li>
 458 </ul>
 459 And now the list of parameters you can use to change settings for load balancer members:
 460 <ul>
 461 <li>
 462 <b>vwa</b>: activation flag (0/a="active", 1/d="disabled", 2/s="stopped"; case insensitive, only first character is used)
 463 </li>
 464 <li>
 465 <b>vwf</b>: load balancing factor (integer weight)
 466 </li>
 467 <li>
 468 <b>vwn</b>: route for use with sticky sessions (string)
 469 </li>
 470 <li>
 471 <b>vwr</b>: redirect to define simple failover rules (string)
 472 </li>
 473 <li>
 474 <b>vwc</b>: domain to tell JK about your replication design (string)
 475 </li>
 476 <li>
 477 <b>vwd</b>: distance to express preferences (integer)
 478 </li>
 479 </ul>
 480 Finally the list of parameters you can use to change settings for ajp workers and ajp load balancer members:
 481 <ul>
 482 <li>
 483 <b>vahst</b>: host (string)
 484 </li>
 485 <li>
 486 <b>vaprt</b>: port (number)
 487 </li>
 488 <li>
 489 <b>vacpt</b>: connection_pool_timeout (number)
 490 </li>
 491 <li>
 492 <b>vact</b>: connect_timeout (number)
 493 </li>
 494 <li>
 495 <b>vapt</b>: prepost_timeout (number)
 496 </li>
 497 <li>
 498 <b>vart</b>: reply_timeout (number)
 499 </li>
 500 <li>
 501 <b>var</b>: retries (number)
 502 </li>
 503 <li>
 504 <b>varo</b>: recovery_options (number)
 505 </li>
 506 <li>
 507 <b>vamps</b>: max_packet_size (number)
 508 </li>
 509 </ul>
 510 Note that changing the host name or port will only take effect for new connections.
 511 Already established connections to the old address will still be used.
 512 Nevertheless this feature is interesting, because you can provision load balancer
 513 members with port "0", which will automatically be stopped during startup. Later
 514 when you know the final names and ports, you can set them and they will be
 515 automatically activated.
 516 </p>
 517 <p>
 518 The leading character "v" has been added to the parameters in version 1.2.27.
 519 Changing settings for ajp workers has also been introduced in version 1.2.27.
 520 </p>
 521 <p>
 522 For the details of all parameters, we refer to the <a href="workers.html">workers.properties Reference</a>.
 523 </p>
 524 </blockquote></td></tr></table>
 525 <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Aspect Editing for Load Balancer Members"><strong>Aspect Editing for Load Balancer Members</strong></a></font></td></tr><tr><td><blockquote>
 526 <br>
 527 <p>
 528 You can use the edit action to edit all settings for a load balancer or for a
 529 member of a load balancer respectively on one page. If you want to edit one
 530 configuration aspect for all members of a load balancer simultaneously, this
 531 will be triggered by the parameter <b>att</b>. The value of the parameter indicates,
 532 which aspect you want to edit. The list is the same as in the previous section,
 533 except for "vahst" and "vaprt":
 534 "vwa", "vwf", "vwn", "vwr", "vwc", "vwd", "vacpt", "vact", "vapt", "vart", "var",
 535 "varo" and "vamps". But here you
 536 need to put the name into the parameter <b>att</b>, instead of using it as a request
 537 parameter name.
 538 </p>
 539 <p>
 540 The values of the common aspect for all the load balancer members will be given
 541 in parameters named "val0", "val1", ....
 542 </p>
 543 </blockquote></td></tr></table>
 544 </blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font color="#525D76" size="-1"><em>
 545         Copyright &copy; 1999-2011, Apache Software Foundation
 546         </em></font></div></td></tr></table></body></html>