<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>The Apache Tomcat Connectors - Miscellaneous Documentation - Status Worker Ant Tasks</title><meta name="author" value="Peter Rossbach"><meta name="email" value=""><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 Software Foundation" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--LEFT SIDE NAVIGATION--><td width="20%" valign="top" nowrap="true"><p><strong>Links</strong></p><ul><li><a href="../index.html">Docs Home</a></li></ul><p><strong>Common HowTo</strong></p><ul><li><a href="../common_howto/quick.html">For the impatient</a></li><li><a href="../common_howto/workers.html">All about workers</a></li><li><a href="../common_howto/timeouts.html">Timeouts</a></li><li><a href="../common_howto/loadbalancers.html">Load Balancing</a></li><li><a href="../common_howto/proxy.html">Reverse Proxy</a></li></ul><p><strong>Webserver HowTo</strong></p><ul><li><a href="../webserver_howto/apache.html">Apache HTTP Server</a></li><li><a href="../webserver_howto/iis.html">IIS</a></li><li><a href="../webserver_howto/nes.html">Netscape/SunOne/Sun</a></li></ul><p><strong>Reference Guide</strong></p><ul><li><a href="../reference/workers.html">workers.properties</a></li><li><a href="../reference/uriworkermap.html">uriworkermap.properties</a></li><li><a href="../reference/status.html">Status Worker</a></li><li><a href="../reference/apache.html">Apache HTTP Server</a></li><li><a href="../reference/iis.html">IIS</a></li></ul><p><strong>AJP Protocol Reference</strong></p><ul><li><a href="../ajp/ajpv13a.html">AJPv13</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul><p><strong>Miscellaneous Documentation</strong></p><ul><li><a href="../miscellaneous/faq.html">Frequently asked questions</a></li><li><a href="../miscellaneous/changelog.html">Changelog</a></li><li><a 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=">Current Tomcat Connectors bugs</a></li><li><a href="../miscellaneous/doccontrib.html">Contribute documentation</a></li><li><a href="../miscellaneous/jkstatustasks.html">JK Status Ant Tasks</a></li><li><a href="../miscellaneous/reporttools.html">Reporting Tools</a></li><li><a href="http://tomcat.apache.org/connectors-doc-archive/jk2/index.html">Old JK/JK2 documentation</a></li></ul><p><strong>News</strong></p><ul><li><a href="../news/20140201.html">2014</a></li><li><a href="../news/20120301.html">2012</a></li><li><a href="../news/20110701.html">2011</a></li><li><a href="../news/20100101.html">2010</a></li><li><a href="../news/20090301.html">2009</a></li><li><a href="../news/20081001.html">2008</a></li><li><a href="../news/20070301.html">2007</a></li><li><a href="../news/20060101.html">2006</a></li><li><a href="../news/20050101.html">2005</a></li><li><a href="../news/20041100.html">2004</a></li></ul></td><!--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 Connectors - Miscellaneous Documentation</h1><h2>Status Worker Ant Tasks</h2></td><td align="right" valign="top" nowrap="true"><small><a href="printer/jkstatustasks.html"><img src="../images/printer.gif" border="0" alt="Printer Friendly Version"><br>print-friendly<br>version </a></small></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> <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> </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="Manage JK with remote Ant Tasks"><strong>Manage JK with remote Ant Tasks</strong></a></font></td></tr><tr><td><blockquote> <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Simple antlib integration"><strong>Simple antlib integration</strong></a></font></td></tr><tr><td><blockquote> <p> <div class="example"><pre> <?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> </pre></div> </p> </blockquote></td></tr></table> <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Test Result"><strong>Test Result</strong></a></font></td></tr><tr><td><blockquote> <p> <div class="example"><pre> [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 </pre></div> </p> </blockquote></td></tr></table> <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Update Load Balancer"><strong>Update Load Balancer</strong></a></font></td></tr><tr><td><blockquote> <p> <div class="example"><pre> <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> </pre></div> </p> </blockquote></td></tr></table> <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Update Worker"><strong>Update Worker</strong></a></font></td></tr><tr><td><blockquote> <p> <div class="example"><pre> <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> </pre></div> </p> </blockquote></td></tr></table> <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Reset Worker"><strong>Reset Worker</strong></a></font></td></tr><tr><td><blockquote> <p> <div class="example"><pre> <target name="reset" > <jk:reset url="${jkstatus.url}" username="${jkstatus.username}" password="${jkstatus.password}" loadbalancer="loadbalancer" worker="node01" /> </target> </pre></div> </p> </blockquote></td></tr></table> </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> Copyright © 1999-2015, Apache Software Foundation </em></font></div></td></tr></table></body></html>