Produced by Araxis Merge on 5/25/2018 9:21:43 AM Central Daylight Time. See www.araxis.com for information about Merge. This report uses XHTML and CSS2, and is best viewed with a modern standards-compliant browser. For optimum results when printing this report, use landscape orientation and enable printing of background images and colours in your browser.
| # | Location | File | Last Modified |
|---|---|---|---|
| 1 | C:\AraxisMergeCompare\Pri_un\ZIP\DSM-cif\Direct Implementation\java\install\build\download\apache-tomcat-6.0.37.tar\apache-tomcat-6.0.37\webapps\docs | manager-howto.html | Mon Apr 29 09:36:10 2013 UTC |
| 2 | C:\AraxisMergeCompare\Pri_re\ZIP\DSM-cif\Direct Implementation\java\install\build\download\apache-tomcat-6.0.37.tar\apache-tomcat-6.0.37\webapps\docs | manager-howto.html | Thu May 24 19:51:16 2018 UTC |
| Description | Between Files 1 and 2 |
|
|---|---|---|
| Text Blocks | Lines | |
| Unchanged | 3 | 2606 |
| Changed | 2 | 4 |
| Inserted | 0 | 0 |
| Removed | 0 | 0 |
| Whitespace | |
|---|---|
| Character case | Differences in character case are significant |
| Line endings | Differences in line endings (CR and LF characters) are ignored |
| CR/LF characters | Not shown in the comparison detail |
No regular expressions were active.
| 1 | <html><hea d><META ht tp-equiv=" Content-Ty pe" conten t="text/ht ml; charse t=iso-8859 -1"><title >Apache To mcat 6.0 ( 6.0.37) - Manager Ap p HOW-TO</ title><met a name="au thor" cont ent="Craig R. McClan ahan"><sty le type="t ext/css" m edia="prin t"> | |
| 2 | .noPri nt {displa y: none;} | |
| 3 | td#mai nBody {wid th: 100%;} | |
| 4 | </st yle></head ><body bgc olor="#fff fff" text= "#000000" link="#525 D76" alink ="#525D76" vlink="#5 25D76"><ta ble border ="0" width ="100%" ce llspacing= "0"><!--PA GE HEADER- -><tr><td> <!--PROJEC T LOGO-->< a href="ht tp://tomca t.apache.o rg/"><img src="./ima ges/tomcat .gif" alig n="right" alt=" | |
| 5 | The Apache Tom cat Servle t/JSP Cont ainer | |
| 6 | " bord er="0"></a ></td><td> <h1><font face="aria l,helvetic a,sanserif ">Apache T omcat 6.0< /font></h1 ><font fac e="arial,h elvetica,s anserif">V ersion 6.0 .37, Apr 2 9 2013</fo nt></td><t d><!--APAC HE LOGO--> <a href="h ttp://www. apache.org /"><img sr c="./image s/asf-logo .gif" alig n="right" alt="Apach e Logo" bo rder="0">< /a></td></ tr></table ><table bo rder="0" w idth="100% " cellspac ing="4"><! --HEADER S EPARATOR-- ><tr><td c olspan="2" ><hr nosha de="noshad e" size="1 "></td></t r><tr><!-- LEFT SIDE NAVIGATION --><td wid th="20%" v align="top " nowrap=" nowrap" cl ass="noPri nt"><p><st rong>Links </strong>< /p><ul><li ><a href=" index.html ">Docs Hom e</a></li> <li><a hre f="http:// wiki.apach e.org/tomc at/FAQ">FA Q</a></li> </ul><p><s trong>User Guide</st rong></p>< ul><li><a href="intr oduction.h tml">1) In troduction </a></li>< li><a href ="setup.ht ml">2) Set up</a></li ><li><a hr ef="appdev /index.htm l">3) Firs t webapp</ a></li><li ><a href=" deployer-h owto.html" >4) Deploy er</a></li ><li><a hr ef="manage r-howto.ht ml">5) Man ager</a></ li><li><a href="real m-howto.ht ml">6) Rea lms and AA A</a></li> <li><a hre f="securit y-manager- howto.html ">7) Secur ity Manage r</a></li> <li><a hre f="jndi-re sources-ho wto.html"> 8) JNDI Re sources</a ></li><li> <a href="j ndi-dataso urce-examp les-howto. html">9) J DBC DataSo urces</a>< /li><li><a href="cla ss-loader- howto.html ">10) Clas sloading</ a></li><li ><a href=" jasper-how to.html">1 1) JSPs</a ></li><li> <a href="s sl-howto.h tml">12) S SL</a></li ><li><a hr ef="ssi-ho wto.html"> 13) SSI</a ></li><li> <a href="c gi-howto.h tml">14) C GI</a></li ><li><a hr ef="proxy- howto.html ">15) Prox y Support< /a></li><l i><a href= "mbeans-de scriptor-h owto.html" >16) MBean Descripto r</a></li> <li><a hre f="default -servlet.h tml">17) D efault Ser vlet</a></ li><li><a href="clus ter-howto. html">18) Clustering </a></li>< li><a href ="balancer -howto.htm l">19) Loa d Balancer </a></li>< li><a href ="connecto rs.html">2 0) Connect ors</a></l i><li><a h ref="monit oring.html ">21) Moni toring and Managemen t</a></li> <li><a hre f="logging .html">22) Logging</ a></li><li ><a href=" apr.html"> 23) APR/Na tive</a></ li><li><a href="virt ual-hostin g-howto.ht ml">24) Vi rtual Host ing</a></l i><li><a h ref="aio.h tml">25) A dvanced IO </a></li>< li><a href ="extras.h tml">26) A dditional Components </a></li>< li><a href ="maven-ja rs.html">2 7) Maveniz ed</a></li ></ul><p>< strong>Ref erence</st rong></p>< ul><li><a href="RELE ASE-NOTES. txt">Relea se Notes</ a></li><li ><a href=" config/ind ex.html">C onfigurati on</a></li ><li><a hr ef="api/in dex.html"> Javadocs</ a></li><li ><a href=" http://tom cat.apache .org/conne ctors-doc/ ">JK 1.2 D ocumentati on</a></li ></ul><p>< strong>Apa che Tomcat Developme nt</strong ></p><ul>< li><a href ="building .html">Bui lding</a>< /li><li><a href="cha ngelog.htm l">Changel og</a></li ><li><a hr ef="http:/ /wiki.apac he.org/tom cat/Tomcat Versions"> Status</a> </li><li>< a href="de velopers.h tml">Devel opers</a>< /li><li><a href="arc hitecture/ index.html ">Architec ture</a></ li><li><a href="func specs/inde x.html">Fu nctional S pecs.</a>< /li></ul>< /td><!--RI GHT SIDE M AIN BODY-- ><td width ="80%" val ign="top" align="lef t" id="mai nBody"><h1 >Apache To mcat 6.0</ h1><h2>Man ager App H OW-TO</h2> <table bor der="0" ce llspacing= "0" cellpa dding="2"> <tr><td bg color="#52 5D76"><fon t color="# ffffff" fa ce="arial, helvetica. sanserif"> <a name="T able of Co ntents"><! --()--></a ><a name=" Table_of_C ontents">< strong>Tab le of Cont ents</stro ng></a></f ont></td>< /tr><tr><t d><blockqu ote> | |
| 7 | <ul><li><a href="#In troduction ">Introduc tion</a></ li><li><a href="#Con figuring_M anager_App lication_A ccess">Con figuring M anager App lication A ccess</a>< /li><li><a href="#Su pported_Ma nager_Comm ands">Supp orted Mana ger Comman ds</a><ol> <li><a hre f="#Deploy _A_New_App lication_R emotely">D eploy A Ne w Applicat ion Remote ly</a></li ><li><a hr ef="#Deplo y_A_New_Ap plication_ from_a_Loc al_Path">D eploy A Ne w Applicat ion from a Local Pat h</a></li> <li><a hre f="#List_C urrently_D eployed_Ap plications ">List Cur rently Dep loyed Appl ications</ a></li><li ><a href=" #Reload_An _Existing_ Applicatio n">Reload An Existin g Applicat ion</a></l i><li><a h ref="#List _OS_and_JV M_Properti es">List O S and JVM Properties </a></li>< li><a href ="#List_Av ailable_Gl obal_JNDI_ Resources" >List Avai lable Glob al JNDI Re sources</a ></li><li> <a href="# List_Avail able_Secur ity_Roles" >List Avai lable Secu rity Roles </a></li>< li><a href ="#Session _Statistic s">Session Statistic s</a></li> <li><a hre f="#Start_ an_Existin g_Applicat ion">Start an Existi ng Applica tion</a></ li><li><a href="#Sto p_an_Exist ing_Applic ation">Sto p an Exist ing Applic ation</a>< /li><li><a href="#Un deploy_an_ Existing_A pplication ">Undeploy an Existi ng Applica tion</a></ li><li><a href="#Fin ding_memor y_leaks">F inding mem ory leaks< /a></li><l i><a href= "#Server_S tatus">Ser ver Status </a></li>< /ol></li>< li><a href ="#Executi ng_Manager _Commands_ With_Ant"> Executing Manager Co mmands Wit h Ant</a>< ol><li><a href="#Tas ks_output_ capture">T asks outpu t capture< /a></li></ ol></li><l i><a href= "#Using_th e_JMX_Prox y_Servlet" >Using the JMX Proxy Servlet</ a><ol><li> <a href="# What_is_JM X_Proxy_Se rvlet">Wha t is JMX P roxy Servl et</a></li ><li><a hr ef="#JMX_Q uery_comma nd">JMX Qu ery comman d</a></li> <li><a hre f="#JMX_Se t_command" >JMX Set c ommand</a> </li></ol> </li></ul> | |
| 8 | </blockquo te></td></ tr></table ><table bo rder="0" c ellspacing ="0" cellp adding="2" ><tr><td b gcolor="#5 25D76"><fo nt color=" #ffffff" f ace="arial ,helvetica .sanserif" ><a name=" Introducti on"><stron g>Introduc tion</stro ng></a></f ont></td>< /tr><tr><t d><blockqu ote> | |
| 9 | ||
| 10 | <p>In many productio n environm ents, it i s very use ful to hav e the capa bility | |
| 11 | to deploy a new web applicatio n, or unde ploy an ex isting one , without having | |
| 12 | to shut do wn and res tart the e ntire cont ainer. In addition, you can r equest | |
| 13 | an existin g applicat ion to rel oad itself , even if you have n ot declare d it | |
| 14 | to be <cod e>reloadab le</code> in the Tom cat 6 serv er | |
| 15 | configurat ion file.< /p> | |
| 16 | ||
| 17 | <p>To supp ort these capabiliti es, Tomcat 6 include s a web ap plication | |
| 18 | (installed by defaul t on conte xt path <c ode>/manag er</code>) that supp orts | |
| 19 | the follow ing functi ons:</p> | |
| 20 | <ul> | |
| 21 | <li>Deploy a new web applicati on from th e uploaded contents of a WAR f ile.</li> | |
| 22 | <li>Deploy a new web applicati on, on a s pecified c ontext pat h, from th e | |
| 23 | server file syst em.</li> | |
| 24 | <li>List t he current ly deploye d web appl ications, as well as the | |
| 25 | sessio ns that ar e currentl y active f or those w eb apps.</ li> | |
| 26 | <li>Reload an existi ng web app lication, to reflect changes i n the | |
| 27 | conten ts of <cod e>/WEB-INF /classes</ code> or < code>/WEB- INF/lib</c ode>. | |
| 28 | </li> | |
| 29 | <li>List t he OS and JVM proper ty values. </li> | |
| 30 | <li>List t he availab le global JNDI resou rces, for use in dep loyment | |
| 31 | tools that are p reparing < code><R esourceLin k></cod e> element s | |
| 32 | nested in a <cod e><Cont ext></c ode> deplo yment desc ription.</ li> | |
| 33 | <li>List t he availab le securit y roles de fined in t he user da tabase.</l i> | |
| 34 | <li>Start a stopped applicatio n (thus ma king it av ailable ag ain).</li> | |
| 35 | <li>Stop a n existing applicati on (so tha t it becom es unavail able), but | |
| 36 | do not undeploy it.</li> | |
| 37 | <li>Undepl oy a deplo yed web ap plication and delete its docum ent base | |
| 38 | direct ory (unles s it was d eployed fr om file sy stem).</li > | |
| 39 | </ul> | |
| 40 | ||
| 41 | <p>A defau lt Tomcat installati on include s the mana ger. To ad d an insta nce of the | |
| 42 | Manager we b applicat ion <code> Context</c ode> to a new host i nstall the | |
| 43 | <code>mana ger.xml</c ode> conte xt configu ration fil e in the | |
| 44 | <code>$CAT ALINA_BASE /conf/[eng inename]/[ hostname]< /code> fol der. Here is an | |
| 45 | example:</ p> | |
| 46 | <pre> | |
| 47 | <Contex t | |
| 48 | docBas e="/usr/lo cal/tomcat 6/webapps/ manager" | |
| 49 | antiRe sourceLock ing="false " privileg ed="true" useHttpOnl y="true"&g t; | |
| 50 | <Valv e classNam e="org.apa che.catali na.valves. RemoteAddr Valve" | |
| 51 | all ow="127\.0 \.0\.1" /& gt; | |
| 52 | </Conte xt> | |
| 53 | </pre> | |
| 54 | ||
| 55 | <p>If you have Tomca t configur ed to supp ort multip le virtual hosts | |
| 56 | (websites) you would need to c onfigure a Manager f or each.</ p> | |
| 57 | ||
| 58 | <p>There a re three w ays to use the <stro ng>Manager </strong> web applic ation.</p> | |
| 59 | <ul> | |
| 60 | <li>As an applicatio n with a u ser interf ace you us e in your browser. | |
| 61 | Here is an example U RL where y ou can rep lace <code >localhost </code> wi th | |
| 62 | your websi te host na me: <code >http://lo calhost/ma nager/html /</code> . </li> | |
| 63 | <li>A mini mal versio n using HT TP request s only whi ch is suit able for u se | |
| 64 | by scripts setup by system adm inistrator s. Comman ds are giv en as part of the | |
| 65 | request UR I, and res ponses are in the fo rm of simp le text th at can be easily | |
| 66 | parsed and processed . See <a href="#Sup ported Man ager Comma nds"> | |
| 67 | Supported Manager Co mmands</a> for more informatio n.</li> | |
| 68 | <li>A conv enient set of task d efinitions for the < em>Ant</em > | |
| 69 | (version 1 .4 or late r) build t ool. See | |
| 70 | <a href="# Executing Manager Co mmands Wit h Ant">Exe cuting Man ager Comma nds | |
| 71 | With Ant</ a> for mor e informat ion.</li> | |
| 72 | </ul> | |
| 73 | ||
| 74 | </blockquo te></td></ tr></table ><table bo rder="0" c ellspacing ="0" cellp adding="2" ><tr><td b gcolor="#5 25D76"><fo nt color=" #ffffff" f ace="arial ,helvetica .sanserif" ><a name=" Configurin g Manager Applicatio n Access"> <!--()-->< /a><a name ="Configur ing_Manage r_Applicat ion_Access "><strong> Configurin g Manager Applicatio n Access</ strong></a ></font></ td></tr><t r><td><blo ckquote> | |
| 75 | ||
| 76 | <block quote> | |
| 77 | <p><em >The descr iption bel ow uses th e variable name $CAT ALINA_BASE to refer the | |
| 78 | base d irectory a gainst whi ch most re lative pat hs are res olved. If you have | |
| 79 | not co nfigured T omcat 6 fo r multiple instances by settin g a CATALI NA_BASE | |
| 80 | direct ory, then $CATALINA_ BASE will be set to the value of $CATALI NA_HOME, | |
| 81 | the di rectory in to which y ou have in stalled To mcat 6.</e m></p> | |
| 82 | </bloc kquote> | |
| 83 | ||
| 84 | <p>It woul d be quite unsafe to ship Tomc at with de fault sett ings that allowed | |
| 85 | anyone on the Intern et to exec ute the Ma nager appl ication on your serv er. | |
| 86 | Therefore, the Manag er applica tion is sh ipped with the requi rement tha t anyone | |
| 87 | who attemp ts to use it must au thenticate themselve s, using a username and | |
| 88 | password t hat have t he appropr iate role associated with them . | |
| 89 | Further, t here is no username in the def ault users file | |
| 90 | (<code>$CA TALINA_BAS E/conf/tom cat-users. xml</code> ) that is assigned a n | |
| 91 | appropriat e role. T herefore, access to the Manage r applicat ion is com pletely | |
| 92 | disabled b y default. </p> | |
| 93 | ||
| 94 | <p>To enab le access to the Man ager web a pplication , you must either cr eate | |
| 95 | a new user name/passw ord combin ation and associate one of the manager r oles with | |
| 96 | it, or add a manager role to s ome existi ng usernam e/password combinati on. There | |
| 97 | are four r oles defin ed by the manager ap plication: </p> | |
| 98 | <ul> | |
| 99 | <li><em>ma nager-gui< /em> - All ows access to the ht ml interfa ce</li> | |
| 100 | <li><em>ma nager-scri pt</em> - Allows acc ess to the plain tex t interfac e</li> | |
| 101 | <li><em>ma nager-jmx< /em> - All ows access to the JM X proxy in terface</l i> | |
| 102 | <li><em>ma nager-stat us</em> - Allows acc ess to the read-only status pa ges</li> | |
| 103 | </ul> | |
| 104 | <p>The man ager appli cation is configured to use th e CSRF pre vention fi lter. For | |
| 105 | this filte r to be ef fective, a ny user as signed the <code>man ager-gui</ code> role | |
| 106 | must not b e assigned the <code >manager-s cript</cod e> nor the | |
| 107 | <code>mana ger-jmx</c ode> roles .</p> | |
| 108 | ||
| 109 | <p>Exactly where rol es are ass ociated to users dep ends on wh ich | |
| 110 | <code>Real m</code> i mplementat ion you ar e using:</ p> | |
| 111 | <ul> | |
| 112 | <li><em>Me moryRealm< /em> - If you have n ot customi zed your | |
| 113 | <code> $CATALINA_ BASE/conf/ server.xml </code> to select a different one, | |
| 114 | Tomcat 6 default s to an XM L-format f ile stored at | |
| 115 | <code> $CATALINA_ BASE/conf/ tomcat-use rs.xml</co de>, which can be | |
| 116 | edited with any text edito r. This f ile contai ns an XML | |
| 117 | <code> <user&g t;</code> for each i ndividual user, whic h might | |
| 118 | look s omething l ike this: | |
| 119 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 120 | <user n ame=" us r " password =" PW " roles="s tandard,ma nager-gui" /> | |
| 121 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 122 | which defines th e username and passw ord used b y this ind ividual to | |
| 123 | log on , and the role names he or she is associ ated with. You can | |
| 124 | add a role, e.g. <strong>m anager-gui </strong>, to the co mma-delimi ted | |
| 125 | <code> roles</cod e> attribu te for one or more e xisting us ers, and/o r | |
| 126 | create new users with that assigned role.</li> | |
| 127 | <li><em>JD BCRealm</e m> - Your user and r ole inform ation is s tored in | |
| 128 | a data base acces sed via JD BC. Add t he require d role(s) to one or more | |
| 129 | existi ng users, and/or cre ate one or more new users with the requi red | |
| 130 | role(s ) assigned , followin g the stan dard proce dures for your | |
| 131 | enviro nment.</li > | |
| 132 | <li><em>JN DIRealm</e m> - Your user and r ole inform ation is s tored in | |
| 133 | a dire ctory serv er accesse d via LDAP . Add the required role(s) to one or | |
| 134 | more e xisting us ers, and/o r create o ne or more new users with the required | |
| 135 | role(s ) assigned , followin g the stan dard proce dures for your | |
| 136 | enviro nment.</li > | |
| 137 | </ul> | |
| 138 | ||
| 139 | <p>The fir st time yo u attempt to issue o ne of the Manager co mmands | |
| 140 | described in the nex t section, you will be challen ged to log on using | |
| 141 | BASIC auth entication . The use rname and password y ou enter d o not matt er, | |
| 142 | as long as they iden tify a val id user in the users database who posses ses | |
| 143 | the approp riate role .</p> | |
| 144 | ||
| 145 | <p>In addi tion to th e password restricti ons the ma nager web applicatio n | |
| 146 | could be r estricted by the rem ote IP add ress or ho st by addi ng a | |
| 147 | <code>Remo teAddrValv e</code> o r <code>Re moteHostVa lve</code> . Here is | |
| 148 | an example of restri cting acce ss to the localhost by IP addr ess:</p> | |
| 149 | <pre> | |
| 150 | <Contex t antiReso urceLockin g="false" privileged ="true" us eHttpOnly= "true"> | |
| 151 | <Valv e classNam e="org.apa che.catali na.valves. RemoteAddr Valve" | |
| 152 | a llow="127\ .0\.0\.1"/ > | |
| 153 | </Conte xt> | |
| 154 | </pre> | |
| 155 | </blockquo te></td></ tr></table ><table bo rder="0" c ellspacing ="0" cellp adding="2" ><tr><td b gcolor="#5 25D76"><fo nt color=" #ffffff" f ace="arial ,helvetica .sanserif" ><a name=" Supported Manager Co mmands"><! --()--></a ><a name=" Supported_ Manager_Co mmands"><s trong>Supp orted Mana ger Comman ds</strong ></a></fon t></td></t r><tr><td> <blockquot e> | |
| 156 | ||
| 157 | <p>All com mands that the Manag er applica tion knows how to pr ocess are | |
| 158 | specified in a singl e request URI like t his:</p> | |
| 159 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 160 | http://{ho st}:{port} /manager/{ command}?{ parameters } | |
| 161 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 162 | <p>where < code>{host }</code> a nd <code>{ port}</cod e> represe nt the hos tname | |
| 163 | and port n umber on w hich Tomca t is runni ng, <code> {command}< /code> | |
| 164 | represents the Manag er command you wish to execute , and | |
| 165 | <code>{par ameters}</ code> repr esents the query par ameters | |
| 166 | that are s pecific to that comm and. In t he illustr ations bel ow, custom ize | |
| 167 | the host a nd port ap propriatel y for your installat ion.</p> | |
| 168 | ||
| 169 | <p>Most co mmands acc ept one or more of t he followi ng query p arameters: </p> | |
| 170 | <ul> | |
| 171 | <li><stron g>path</st rong> - Th e context path (incl uding the leading sl ash) | |
| 172 | of the web appli cation you are deali ng with. To select the ROOT w eb | |
| 173 | applic ation, spe cify "/". <strong>N OTE</stron g> - | |
| 174 | It is not possib le to perf orm admini strative c ommands on the | |
| 175 | Manage r applicat ion itself .</li> | |
| 176 | <li><stron g>war</str ong> - URL of a web applicatio n archive (WAR) file , | |
| 177 | pathna me of a di rectory wh ich contai ns the web applicati on, or a | |
| 178 | Contex t configur ation ".xm l" file. You can us e URLs in any of the | |
| 179 | follow ing format s: | |
| 180 | <ul> | |
| 181 | <li><s trong>file :/absolute /path/to/a /directory </strong> - The abso lute | |
| 182 | pa th of a di rectory th at contain s the unpa cked versi on of a we b | |
| 183 | ap plication. This dir ectory wil l be attac hed to the context p ath | |
| 184 | yo u specify without an y changes. </li> | |
| 185 | <li><s trong>file :/absolute /path/to/a /webapp.wa r</strong> - The abs olute | |
| 186 | pa th of a we b applicat ion archiv e (WAR) fi le. This is valid | |
| 187 | <s trong>only </strong> for the <c ode>/deplo y</code> c ommand, an d is | |
| 188 | th e only acc eptable fo rmat to th at command .</li> | |
| 189 | <li><s trong>jar: file:/abso lute/path/ to/a/warfi le.war!/</ strong> - The | |
| 190 | UR L to a loc al web app lication a rchive (WA R) file. You can us e any | |
| 191 | sy ntax that is valid f or the <co de>JarURLC onnection< /code> cla ss | |
| 192 | fo r referenc e to an en tire JAR f ile.</li> | |
| 193 | <li><s trong>file :/absolute /path/to/a /context.x ml</strong > - The | |
| 194 | ab solute pat h of a web applicati on Context configura tion ".xml " | |
| 195 | fi le which c ontains th e Context configurat ion elemen t.</li> | |
| 196 | <li><s trong>dire ctory</str ong> - The directory name for the web | |
| 197 | ap plication context in the Host' s applicat ion base d irectory.< /li> | |
| 198 | <li><s trong>weba pp.war</st rong> - Th e name of a web appl ication wa r file | |
| 199 | lo cated in t he Host's applicatio n base dir ectory.</l i> | |
| 200 | </ul>< /li> | |
| 201 | </ul> | |
| 202 | ||
| 203 | <p>Each co mmand will return a response i n <code>te xt/plain</ code> form at | |
| 204 | (i.e. plai n ASCII wi th no HTML markup), making it easy for b oth humans and | |
| 205 | programs t o read). The first line of th e response will begi n with eit her | |
| 206 | <code>OK</ code> or < code>FAIL< /code>, in dicating w hether the requested | |
| 207 | command wa s successf ul or not. In the c ase of fai lure, the rest of th e first | |
| 208 | line will contain a descriptio n of the p roblem tha t was enco untered. Some | |
| 209 | commands i nclude add itional li nes of inf ormation a s describe d below.</ p> | |
| 210 | ||
| 211 | <p><em>Int ernational ization No te</em> - The Manage r applicat ion looks up | |
| 212 | its messag e strings in resourc e bundles, so it is possible t hat the st rings | |
| 213 | have been translated for your platform. The examp les below show the E nglish | |
| 214 | version of the messa ges.</p> | |
| 215 | ||
| 216 | <blockquot e> | |
| 217 | <p><em><st rong>WARNI NG:</stron g> the le gacy comma nds <code> /install</ code> and | |
| 218 | <code>/rem ove</code> are depre cated. | |
| 219 | They are p resently e quivalent to <code>/ deploy</co de> and <c ode>/undep loy</code> , | |
| 220 | but could be removed in a futu re release .</em></p> | |
| 221 | </blockquo te> | |
| 222 | ||
| 223 | <table bor der="0" ce llspacing= "0" cellpa dding="2"> <tr><td bg color="#82 8DA6"><fon t color="# ffffff" fa ce="arial, helvetica. sanserif"> <a name="D eploy A Ne w Applicat ion Remote ly"><!--() --></a><a name="Depl oy_A_New_A pplication _Remotely" ><strong>D eploy A Ne w Applicat ion Remote ly</strong ></a></fon t></td></t r><tr><td> <blockquot e> | |
| 224 | ||
| 225 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 226 | http://loc alhost:808 0/manager/ deploy?pat h=/foo | |
| 227 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 228 | ||
| 229 | <p>Upload the web ap plication archive (W AR) file t hat is spe cified as the | |
| 230 | request da ta in this HTTP PUT request, i nstall it into the < code>appBa se</code> | |
| 231 | directory of our cor responding virtual h ost, and s tart , usi ng the dir ectory | |
| 232 | name or th e war file name with out the .w ar extensi on as the path. The | |
| 233 | applicatio n can late r be undep loyed (and the corre sponding a pplication directory | |
| 234 | removed) b y use of t he <code>/ undeploy</ code> comm and.</p> | |
| 235 | ||
| 236 | <p>The .WA R file may include T omcat spec ific deplo yment conf iguration, by | |
| 237 | including a Context configurat ion XML fi le in | |
| 238 | <code>/MET A-INF/cont ext.xml</c ode>.</p> | |
| 239 | ||
| 240 | <p>URL par ameters in clude:</p> | |
| 241 | <ul> | |
| 242 | <li><code> update</co de>: When set to tru e, any exi sting upda te will be | |
| 243 | undepl oyed first . The defa ult value is set to false.</li > | |
| 244 | <li><code> tag</code> : Specifyi ng a tag n ame, this allows ass ociating t he | |
| 245 | deploy ed webapp with a ver sion numbe r. The app lication v ersion can | |
| 246 | be lat er redeplo yed when n eeded usin g only the tag.</li> | |
| 247 | </ul> | |
| 248 | ||
| 249 | <p><strong >NOTE</str ong> - Thi s command is the log ical | |
| 250 | opposite o f the <cod e>/undeplo y</code> c ommand.</p > | |
| 251 | ||
| 252 | <p>If inst allation a nd startup is succes sful, you will recei ve a respo nse | |
| 253 | like this: </p> | |
| 254 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 255 | OK - Deplo yed applic ation at c ontext pat h /foo | |
| 256 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 257 | ||
| 258 | <p>Otherwi se, the re sponse wil l start wi th <code>F AIL</code> and inclu de an | |
| 259 | error mess age. Poss ible cause s for prob lems inclu de:</p> | |
| 260 | <ul> | |
| 261 | <li><em>Ap plication already ex ists at pa th /foo</e m> | |
| 262 | <block quote> | |
| 263 | <p>The context p aths for a ll current ly running web appli cations mu st be | |
| 264 | unique . Therefo re, you mu st undeplo y the exis ting web | |
| 265 | applic ation usin g this con text path, or choose a differe nt context path | |
| 266 | for th e new one. The <code >update</c ode> param eter may b e specifie d as | |
| 267 | a para meter on t he URL, wi th a value of <code> true</code > to avoid this | |
| 268 | error. In that c ase, an un deploy wil l be perfo rmed on an existing | |
| 269 | applic ation befo re perform ing the de ployment.< /p> | |
| 270 | </bloc kquote></l i> | |
| 271 | <li><em>En countered exception< /em> | |
| 272 | <block quote> | |
| 273 | <p>An exception was encoun tered tryi ng to star t the new web applic ation. | |
| 274 | Check the Tomcat 6 logs fo r the deta ils, but l ikely expl anations i nclude | |
| 275 | proble ms parsing your <cod e>/WEB-INF /web.xml</ code> file , or missi ng | |
| 276 | classe s encounte red when i nitializin g applicat ion event listeners and | |
| 277 | filter s.</p> | |
| 278 | </bloc kquote></l i> | |
| 279 | </ul> | |
| 280 | ||
| 281 | </blockquo te></td></ tr></table > | |
| 282 | ||
| 283 | <table bor der="0" ce llspacing= "0" cellpa dding="2"> <tr><td bg color="#82 8DA6"><fon t color="# ffffff" fa ce="arial, helvetica. sanserif"> <a name="D eploy A Ne w Applicat ion from a Local Pat h"><!--()- -></a><a n ame="Deplo y_A_New_Ap plication_ from_a_Loc al_Path">< strong>Dep loy A New Applicatio n from a L ocal Path< /strong></ a></font>< /td></tr>< tr><td><bl ockquote> | |
| 284 | ||
| 285 | <p>Deploy and start a new web applicatio n, attache d to the s pecified c ontext | |
| 286 | <code>path </code> (w hich must not be in use by any other web applicati on). | |
| 287 | This comma nd is the logical op posite of the <code> /undeploy< /code> com mand.</p> | |
| 288 | ||
| 289 | <p>There a re a numbe r of diffe rent ways the deploy command c an be used .</p> | |
| 290 | ||
| 291 | <h3>Deploy a version of a prev iously dep loyed weba pp</h3> | |
| 292 | ||
| 293 | <p>This ca n be used to deploy a previous version o f a web ap plication, which | |
| 294 | has been d eployed us ing the <c ode>tag</c ode> attri bute. Note that the work | |
| 295 | directory for the ma nager weba pp will co ntain the previously deployed WARs; | |
| 296 | removing i t would ma ke the dep loyment fa il.</p> | |
| 297 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 298 | http://loc alhost:808 0/manager/ deploy?pat h=/footoo& amp;tag=fo otag | |
| 299 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 300 | ||
| 301 | ||
| 302 | <h3>Deploy a Directo ry or WAR by URL</h3 > | |
| 303 | ||
| 304 | <p>Deploy a web appl ication di rectory or ".war" fi le located on the To mcat | |
| 305 | server. If no <code> path</code > is speci fied, the directory name or th e war file | |
| 306 | name witho ut the ".w ar" extens ion is use d as the p ath. The < code>war</ code> | |
| 307 | parameter specifies a URL (inc luding the <code>fil e:</code> scheme) fo r either | |
| 308 | a director y or a web applicati on archive (WAR) fil e. The sup ported syn tax for | |
| 309 | a URL refe rring to a WAR file is describ ed on the Javadocs p age for th e | |
| 310 | <code>java .net.JarUR LConnectio n</code> c lass. Use only URLs that refe r to | |
| 311 | the entire WAR file. </p> | |
| 312 | ||
| 313 | <p>In this example t he web app lication l ocated in the direct ory | |
| 314 | <code>/pat h/to/foo</ code> on t he Tomcat server is deployed a s the | |
| 315 | web applic ation cont ext named <code>/foo too</code> .</p> | |
| 316 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 317 | http://loc alhost:808 0/manager/ deploy?pat h=/footoo& amp;war=fi le:/path/t o/foo | |
| 318 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 319 | ||
| 320 | ||
| 321 | <p>In this example t he ".war" file <code >/path/to/ bar.war</c ode> on th e | |
| 322 | Tomcat ser ver is dep loyed as t he web app lication c ontext nam ed | |
| 323 | <code>/bar </code>. N otice that there is no <code>p ath</code> parameter | |
| 324 | so the con text path defaults t o the name of the we b applicat ion archiv e | |
| 325 | file witho ut the ".w ar" extens ion.</p> | |
| 326 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 327 | http://loc alhost:808 0/manager/ deploy?war =jar:file: /path/to/b ar.war!/ | |
| 328 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 329 | ||
| 330 | ||
| 331 | <h3>Deploy a Directo ry or War from the H ost appBas e</h3> | |
| 332 | ||
| 333 | <p>Deploy a web appl ication di rectory or ".war" fi le located in your H ost | |
| 334 | appBase di rectory. T he directo ry name or the war f ile name w ithout the ".war" | |
| 335 | extension is used as the path. </p> | |
| 336 | ||
| 337 | <p>In this example t he web app lication l ocated in a sub dire ctory name d | |
| 338 | <code>foo< /code> in the Host a ppBase dir ectory of the Tomcat server is | |
| 339 | deployed a s the web applicatio n context named <cod e>/foo</co de>. Notic e | |
| 340 | that the c ontext pat h used is the name o f the web applicatio n director y.</p> | |
| 341 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 342 | http://loc alhost:808 0/manager/ deploy?war =foo | |
| 343 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 344 | ||
| 345 | ||
| 346 | <p>In this example t he ".war" file <code >bar.war</ code> loca ted in you r | |
| 347 | Host appBa se directo ry on the Tomcat ser ver is dep loyed as t he web | |
| 348 | applicatio n context named <cod e>/bar</co de>.</p> | |
| 349 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 350 | http://loc alhost:808 0/manager/ deploy?war =bar.war | |
| 351 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 352 | ||
| 353 | ||
| 354 | <h3>Deploy using a C ontext con figuration ".xml" fi le</h3> | |
| 355 | ||
| 356 | <p>If the Host deplo yXML flag is set to true you c an deploy a web | |
| 357 | applicatio n using a Context co nfiguratio n ".xml" f ile and an optional | |
| 358 | ".war" fil e or web a pplication directory . The cont ext <code> path</code > | |
| 359 | is not use d when dep loying a w eb applica tion using a context ".xml" | |
| 360 | configurat ion file.< /p> | |
| 361 | ||
| 362 | <p>A Conte xt configu ration ".x ml" file c an contain valid XML for a | |
| 363 | web applic ation Cont ext just a s if it we re configu red in you r | |
| 364 | Tomcat <co de>server. xml</code> configura tion file. Here is a n | |
| 365 | example:</ p> | |
| 366 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 367 | <Contex t path="/f oobar" doc Base="/pat h/to/appli cation/foo bar"> | |
| 368 | ||
| 369 | <!-- Link to th e user dat abase we w ill get ro les from - -> | |
| 370 | <Reso urceLink n ame="users " global=" UserDataba se" | |
| 371 | type ="org.apac he.catalin a.UserData base"/> | |
| 372 | ||
| 373 | </Conte xt> | |
| 374 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 375 | ||
| 376 | ||
| 377 | <p>When th e optional <code>war </code> pa rameter is set to th e URL | |
| 378 | for a web applicatio n ".war" f ile or dir ectory it overrides any | |
| 379 | docBase co nfigured i n the cont ext config uration ". xml" file. </p> | |
| 380 | ||
| 381 | <p>Here is an exampl e of deplo ying an ap plication using a Co ntext | |
| 382 | configurat ion ".xml" file.</p> | |
| 383 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 384 | http://loc alhost:808 0/manager/ deploy?con fig=file:/ path/conte xt.xml | |
| 385 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 386 | ||
| 387 | ||
| 388 | <p>Here is an exampl e of deplo ying an ap plication using a Co ntext | |
| 389 | configurat ion ".xml" file and a web appl ication ". war" file located | |
| 390 | on the ser ver.</p> | |
| 391 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 392 | http://loc alhost:808 0/manager/ deploy | |
| 393 | ?config=f ile:/path/ context.xm l&war= jar:file:/ path/bar.w ar!/ | |
| 394 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 395 | ||
| 396 | ||
| 397 | <h3>Deploy ment Notes </h3> | |
| 398 | ||
| 399 | <p>If the Host is co nfigured w ith unpack WARs=true and you de ploy a war | |
| 400 | file, the war will b e unpacked into a di rectory in your Host appBase | |
| 401 | directory. </p> | |
| 402 | ||
| 403 | <p>If the applicatio n war or d irectory i s installe d in your Host appBa se | |
| 404 | directory and either the Host is configu red with a utoDeploy= true or | |
| 405 | liveDeploy =true, the Context p ath must m atch the d irectory n ame or | |
| 406 | war file n ame withou t the ".wa r" extensi on.</p> | |
| 407 | ||
| 408 | <p>For sec urity when untrusted users can manage we b applicat ions, the | |
| 409 | Host deplo yXML flag can be set to false. This pre vents untr usted user s | |
| 410 | from deplo ying web a pplication s using a configurat ion XML fi le and | |
| 411 | also preve nts them f rom deploy ing applic ation dire ctories or ".war" | |
| 412 | files loca ted outsid e of their Host appB ase.</p> | |
| 413 | ||
| 414 | ||
| 415 | <h3>Deploy Response< /h3> | |
| 416 | ||
| 417 | <p>If inst allation a nd startup is succes sful, you will recei ve a respo nse | |
| 418 | like this: </p> | |
| 419 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 420 | OK - Deplo yed applic ation at c ontext pat h /foo | |
| 421 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 422 | ||
| 423 | <p>Otherwi se, the re sponse wil l start wi th <code>F AIL</code> and inclu de an | |
| 424 | error mess age. Poss ible cause s for prob lems inclu de:</p> | |
| 425 | <ul> | |
| 426 | <li><em>Ap plication already ex ists at pa th /foo</e m> | |
| 427 | <block quote> | |
| 428 | <p>The context p aths for a ll current ly running web appli cations mu st be | |
| 429 | unique . Therefo re, you mu st undeplo y the exis ting web | |
| 430 | applic ation usin g this con text path, or choose a differe nt context path | |
| 431 | for th e new one. The <code >update</c ode> param eter may b e specifie d as | |
| 432 | a para meter on t he URL, wi th a value of <code> true</code > to avoid this | |
| 433 | error. In that c ase, an un deploy wil l be perfo rmed on an existing | |
| 434 | applic ation befo re perform ing the de ployment.< /p> | |
| 435 | </bloc kquote></l i> | |
| 436 | <li><em>Do cument bas e does not exist or is not a r eadable di rectory</e m> | |
| 437 | <block quote> | |
| 438 | <p>The URL speci fied by th e <code>wa r</code> p arameter m ust identi fy a | |
| 439 | direct ory on thi s server t hat contai ns the "un packed" ve rsion of a | |
| 440 | web ap plication, or the ab solute URL of a web applicatio n archive (WAR) | |
| 441 | file t hat contai ns this ap plication. Correct the value specified by | |
| 442 | the <c ode>war</c ode> param eter.</p> | |
| 443 | </bloc kquote></l i> | |
| 444 | <li><em>En countered exception< /em> | |
| 445 | <block quote> | |
| 446 | <p>An exception was encoun tered tryi ng to star t the new web applic ation. | |
| 447 | Check the Tomcat 6 logs fo r the deta ils, but l ikely expl anations i nclude | |
| 448 | proble ms parsing your <cod e>/WEB-INF /web.xml</ code> file , or missi ng | |
| 449 | classe s encounte red when i nitializin g applicat ion event listeners and | |
| 450 | filter s.</p> | |
| 451 | </bloc kquote></l i> | |
| 452 | <li><em>In valid appl ication UR L was spec ified</em> | |
| 453 | <block quote> | |
| 454 | <p>The URL for t he directo ry or web applicatio n that you specified | |
| 455 | was no t valid. Such URLs must start with <cod e>file:</c ode>, and URLs | |
| 456 | for a WAR file m ust end in ".war".</ p> | |
| 457 | </bloc kquote></l i> | |
| 458 | <li><em>In valid cont ext path w as specifi ed</em> | |
| 459 | <block quote> | |
| 460 | <p>The context p ath must s tart with a slash ch aracter. T o referenc e the | |
| 461 | ROOT w eb applica tion use " /".</p> | |
| 462 | </bloc kquote></l i> | |
| 463 | <li><em>Co ntext path must matc h the dire ctory or W AR file na me:</em> | |
| 464 | <block quote> | |
| 465 | If the applicati on war or directory is install ed in your Host appB ase | |
| 466 | direct ory and ei ther the H ost is con figured wi th autoDep loy=true o r | |
| 467 | liveDe ploy=true, the Conte xt path mu st match t he directo ry name or | |
| 468 | war fi le name wi thout the ".war" ext ension. | |
| 469 | </bloc kquote></l i> | |
| 470 | <li><em>On ly web app lications in the Hos t web appl ication di rectory ca n | |
| 471 | be in stalled</e m> | |
| 472 | <bloc kquote> | |
| 473 | If th e Host dep loyXML fla g is set t o false th is error w ill happen | |
| 474 | if an attempt i s made to deploy a w eb applica tion direc tory or | |
| 475 | ".wa r" file ou tside of t he Host ap pBase dire ctory. | |
| 476 | </blo ckquote></ li> | |
| 477 | </ul> | |
| 478 | ||
| 479 | </blockquo te></td></ tr></table > | |
| 480 | ||
| 481 | <table bor der="0" ce llspacing= "0" cellpa dding="2"> <tr><td bg color="#82 8DA6"><fon t color="# ffffff" fa ce="arial, helvetica. sanserif"> <a name="L ist Curren tly Deploy ed Applica tions"><!- -()--></a> <a name="L ist_Curren tly_Deploy ed_Applica tions"><st rong>List Currently Deployed A pplication s</strong> </a></font ></td></tr ><tr><td>< blockquote > | |
| 482 | ||
| 483 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 484 | http://loc alhost:808 0/manager/ list | |
| 485 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 486 | ||
| 487 | <p>List th e context paths, cur rent statu s (<code>r unning</co de> or | |
| 488 | <code>stop ped</code> ), and num ber of act ive sessio ns for all currently | |
| 489 | deployed w eb applica tions. A typical re sponse imm ediately | |
| 490 | after star ting Tomca t might lo ok like th is:</p> | |
| 491 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 492 | OK - Liste d applicat ions for v irtual hos t localhos t | |
| 493 | /webdav:ru nning:0 | |
| 494 | /examples: running:0 | |
| 495 | /manager:r unning:0 | |
| 496 | /:running: 0 | |
| 497 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 498 | ||
| 499 | </blockquo te></td></ tr></table > | |
| 500 | ||
| 501 | <table bor der="0" ce llspacing= "0" cellpa dding="2"> <tr><td bg color="#82 8DA6"><fon t color="# ffffff" fa ce="arial, helvetica. sanserif"> <a name="R eload An E xisting Ap plication" ><!--()--> </a><a nam e="Reload_ An_Existin g_Applicat ion"><stro ng>Reload An Existin g Applicat ion</stron g></a></fo nt></td></ tr><tr><td ><blockquo te> | |
| 502 | ||
| 503 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 504 | http://loc alhost:808 0/manager/ reload?pat h=/example s | |
| 505 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 506 | ||
| 507 | <p>Signal an existin g applicat ion to shu t itself d own and re load. Thi s can | |
| 508 | be useful when the w eb applica tion conte xt is not reloadable and you h ave | |
| 509 | updated cl asses or p roperty fi les in the <code>/WE B-INF/clas ses</code> | |
| 510 | directory or when yo u have add ed or upda ted jar fi les in the | |
| 511 | <code>/WEB -INF/lib</ code> dire ctory. | |
| 512 | </p> | |
| 513 | <p><strong >NOTE:</st rong> The <code>/WEB -INF/web.x ml</code> | |
| 514 | web applic ation conf iguration file is no t reread o n a reload . | |
| 515 | If you hav e made cha nges to yo ur web.xml file you must stop | |
| 516 | then start the web a pplication . | |
| 517 | </p> | |
| 518 | ||
| 519 | <p>If this command s ucceeds, y ou will se e a respon se like th is:</p> | |
| 520 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 521 | OK - Reloa ded applic ation at c ontext pat h /example s | |
| 522 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 523 | ||
| 524 | <p>Otherwi se, the re sponse wil l start wi th <code>F AIL</code> and inclu de an | |
| 525 | error mess age. Poss ible cause s for prob lems inclu de:</p> | |
| 526 | <ul> | |
| 527 | <li><em>En countered exception< /em> | |
| 528 | <block quote> | |
| 529 | <p>An exception was encoun tered tryi ng to rest art the we b applicat ion. | |
| 530 | Check the Tomcat 6 logs fo r the deta ils.</p> | |
| 531 | </bloc kquote></l i> | |
| 532 | <li><em>In valid cont ext path w as specifi ed</em> | |
| 533 | <block quote> | |
| 534 | <p>The context p ath must s tart with a slash ch aracter. T o referenc e the | |
| 535 | ROOT w eb applica tion use " /".</p> | |
| 536 | </bloc kquote></l i> | |
| 537 | <li><em>No context e xists for path /foo< /em> | |
| 538 | <block quote> | |
| 539 | <p>The re is no d eployed ap plication on the con text path | |
| 540 | that y ou specifi ed.</p> | |
| 541 | </bloc kquote></l i> | |
| 542 | <li><em>No context p ath was sp ecified</e m> | |
| 543 | <block quote> | |
| 544 | The <c ode>path</ code> para meter is r equired. | |
| 545 | </bloc kquote></l i> | |
| 546 | <li><em>Re load not s upported o n WAR depl oyed at pa th /foo</e m> | |
| 547 | <block quote> | |
| 548 | Curren tly, appli cation rel oading (to pick up c hanges to the classe s or | |
| 549 | <code> web.xml</c ode> file) is not su pported wh en a web a pplication is | |
| 550 | deploy ed directl y from a W AR file. It only wo rks when t he web app lication | |
| 551 | is dep loyed from an unpack ed directo ry. If yo u are usin g a WAR fi le, | |
| 552 | you sh ould <code >undeploy< /code> and then <cod e>deploy</ code> or | |
| 553 | <code> deploy</co de> with t he <code>u pdate</cod e> paramet er the | |
| 554 | applic ation agai n to pick up your ch anges. | |
| 555 | </bloc kquote></l i> | |
| 556 | </ul> | |
| 557 | ||
| 558 | </blockquo te></td></ tr></table > | |
| 559 | ||
| 560 | <table bor der="0" ce llspacing= "0" cellpa dding="2"> <tr><td bg color="#82 8DA6"><fon t color="# ffffff" fa ce="arial, helvetica. sanserif"> <a name="L ist OS and JVM Prope rties"><!- -()--></a> <a name="L ist_OS_and _JVM_Prope rties"><st rong>List OS and JVM Propertie s</strong> </a></font ></td></tr ><tr><td>< blockquote > | |
| 561 | ||
| 562 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 563 | http://loc alhost:808 0/manager/ serverinfo | |
| 564 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 565 | ||
| 566 | <p>Lists i nformation about the Tomcat ve rsion, OS, and JVM p roperties. </p> | |
| 567 | ||
| 568 | <p>If an e rror occur s, the res ponse will start wit h <code>FA IL</code> and | |
| 569 | include an error mes sage. Pos sible caus es for pro blems incl ude:</p> | |
| 570 | <ul> | |
| 571 | <li><em>En countered exception< /em> | |
| 572 | <block quote> | |
| 573 | <p>An exception was encoun tered tryi ng to enum erate the system pro perties. | |
| 574 | Check the Tomcat 6 logs fo r the deta ils.</p> | |
| 575 | </bloc kquote></l i> | |
| 576 | </ul> | |
| 577 | ||
| 578 | </blockquo te></td></ tr></table > | |
| 579 | ||
| 580 | <table bor der="0" ce llspacing= "0" cellpa dding="2"> <tr><td bg color="#82 8DA6"><fon t color="# ffffff" fa ce="arial, helvetica. sanserif"> <a name="L ist Availa ble Global JNDI Reso urces"><!- -()--></a> <a name="L ist_Availa ble_Global _JNDI_Reso urces"><st rong>List Available Global JND I Resource s</strong> </a></font ></td></tr ><tr><td>< blockquote > | |
| 581 | ||
| 582 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 583 | http://loc alhost:808 0/manager/ resources[ ?type=xxxx x] | |
| 584 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 585 | ||
| 586 | <p>List th e global J NDI resour ces that a re availab le for use in resour ce | |
| 587 | links for context co nfiguratio n files. If you spe cify the < code>type< /code> | |
| 588 | request pa rameter, t he value m ust be the fully qua lified Jav a class na me of | |
| 589 | the resour ce type yo u are inte rested in (for examp le, you wo uld specif y | |
| 590 | <code>java x.sql.Data Source</co de> to acq uire the n ames of al l availabl e | |
| 591 | JDBC data sources). If you do not speci fy the <co de>type</c ode> reque st | |
| 592 | parameter, resources of all ty pes will b e returned .</p> | |
| 593 | ||
| 594 | <p>Dependi ng on whet her the <c ode>type</ code> requ est parame ter is spe cified | |
| 595 | or not, th e first li ne of a no rmal respo nse will b e:</p> | |
| 596 | <pre> | |
| 597 | OK - Lis ted global resources of all ty pes | |
| 598 | </pre> | |
| 599 | <p>or</p> | |
| 600 | <pre> | |
| 601 | OK - Lis ted global resources of type x xxxx | |
| 602 | </pre> | |
| 603 | <p>followe d by one l ine for ea ch resourc e. Each l ine is com posed of f ields | |
| 604 | delimited by colon c haracters (":"), as follows:</ p> | |
| 605 | <ul> | |
| 606 | <li><em>Gl obal Resou rce Name</ em> - The name of th is global JNDI resou rce, | |
| 607 | which would be u sed in the <code>glo bal</code> attribute of a | |
| 608 | <code> <Resour ceLink> </code> el ement.</li > | |
| 609 | <li><em>Gl obal Resou rce Type</ em> - The fully qual ified Java class nam e of | |
| 610 | this g lobal JNDI resource. </li> | |
| 611 | </ul> | |
| 612 | ||
| 613 | <p>If an e rror occur s, the res ponse will start wit h <code>FA IL</code> and | |
| 614 | include an error mes sage. Pos sible caus es for pro blems incl ude:</p> | |
| 615 | <ul> | |
| 616 | <li><em>En countered exception< /em> | |
| 617 | <block quote> | |
| 618 | <p>An exception was encoun tered tryi ng to enum erate the global JND I | |
| 619 | resour ces. Chec k the Tomc at 6 logs for the de tails.</p> | |
| 620 | </bloc kquote></l i> | |
| 621 | <li><em>No global JN DI resourc es are ava ilable</em > | |
| 622 | <block quote> | |
| 623 | <p>The Tomcat se rver you a re running has been configured without | |
| 624 | global JNDI reso urces.</p> | |
| 625 | </bloc kquote></l i> | |
| 626 | </ul> | |
| 627 | ||
| 628 | ||
| 629 | </blockquo te></td></ tr></table > | |
| 630 | ||
| 631 | ||
| 632 | <table bor der="0" ce llspacing= "0" cellpa dding="2"> <tr><td bg color="#82 8DA6"><fon t color="# ffffff" fa ce="arial, helvetica. sanserif"> <a name="L ist Availa ble Securi ty Roles"> <!--()-->< /a><a name ="List_Ava ilable_Sec urity_Role s"><strong >List Avai lable Secu rity Roles </strong>< /a></font> </td></tr> <tr><td><b lockquote> | |
| 633 | ||
| 634 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 635 | http://loc alhost:808 0/manager/ roles | |
| 636 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 637 | ||
| 638 | <p>List th e security role name s (and cor responding descripti ons) that are | |
| 639 | available in the <co de>org.apa che.catali na.UserDat abase</cod e> resourc e that | |
| 640 | is linked to the <co de>users</ code> reso urce refer ence in th e web.xml file | |
| 641 | for the Ma nager web applicatio n. This w ould typic ally be us ed, for ex ample, | |
| 642 | by a deplo yment tool that want ed to crea te | |
| 643 | <code>< security-r ole-ref> ;</code> e lements to map secur ity role n ames | |
| 644 | used in a web applic ation to t he role na mes actual ly defined within th e | |
| 645 | container. </p> | |
| 646 | ||
| 647 | <p>By defa ult, the < code>users </code> re source ref erence is pointed at the | |
| 648 | global <co de>UserDat abase</cod e> resourc e. If you choose to utilize a | |
| 649 | different user datab ase per vi rtual host , you shou ld modify the | |
| 650 | <code>< ResourceLi nk></co de> elemen t in the d efault | |
| 651 | <code>mana ger.xml</c ode> conte xt configu ration fil e to point at the gl obal | |
| 652 | user datab ase resour ce for thi s virtual host.</p> | |
| 653 | ||
| 654 | <p>When th is command is execut ed, the fi rst line o f the resp onse will be:</p> | |
| 655 | <pre> | |
| 656 | OK - Lis ted securi ty roles | |
| 657 | </pre> | |
| 658 | <p>followe d by one l ine for ea ch securit y role. E ach line i s composed of | |
| 659 | fields del imited by colon char acters (": ") as foll ows:</p> | |
| 660 | <ul> | |
| 661 | <li><em>Se curity Rol e Name</em > - A secu rity role name that is known t o Tomcat | |
| 662 | in the user data base.</li> | |
| 663 | <li><em>De scription< /em> - Des cription o f this sec urity role (useful i n | |
| 664 | creati ng user in terfaces f or selecti ng roles.< /li> | |
| 665 | </ul> | |
| 666 | ||
| 667 | <p>If an e rror occur s, the res ponse will start wit h <code>FA IL</code> and | |
| 668 | include an error mes sage. Pos sible caus es for pro blems incl ude:</p> | |
| 669 | <ul> | |
| 670 | <li><em>Ca nnot resol ve user da tabase ref erence</em > - A JNDI error pre vented | |
| 671 | the su ccessful l ookup of t he <code>o rg.apache. catalina.U serDatabas e</code> | |
| 672 | resour ce. Check the Tomca t log file s for a st ack trace associated with | |
| 673 | this e rror.</li> | |
| 674 | <li><em>No user data base is av ailable</e m> - You h ave not co nfigured a resource | |
| 675 | refere nce for th e <code>us ers</code> resource that point s at an | |
| 676 | approp riate user database instance. Check you r <code>ma nager.xml< /code> | |
| 677 | file a nd ensure that you h ave create d an appro priate | |
| 678 | <code> <Resour ceLink> </code> or | |
| 679 | <code> <Resour ceParams&g t;</code> element fo r this res ource.</li > | |
| 680 | </ul> | |
| 681 | ||
| 682 | </blockquo te></td></ tr></table > | |
| 683 | ||
| 684 | ||
| 685 | <table bor der="0" ce llspacing= "0" cellpa dding="2"> <tr><td bg color="#82 8DA6"><fon t color="# ffffff" fa ce="arial, helvetica. sanserif"> <a name="S ession Sta tistics">< !--()--></ a><a name= "Session_S tatistics" ><strong>S ession Sta tistics</s trong></a> </font></t d></tr><tr ><td><bloc kquote> | |
| 686 | ||
| 687 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 688 | http://loc alhost:808 0/manager/ sessions?p ath=/examp les | |
| 689 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 690 | ||
| 691 | <p>Display the defau lt session timeout f or a web a pplication , and the | |
| 692 | number of currently active ses sions that fall with in ten-min ute ranges of | |
| 693 | their actu al timeout times. F or example , after re starting T omcat and then | |
| 694 | executing one of the JSP sampl es in the <code>/exa mples</cod e> web app , | |
| 695 | you might get someth ing like t his:</p> | |
| 696 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 697 | OK - Sessi on informa tion for a pplication at contex t path /ex amples | |
| 698 | Default ma ximum sess ion inacti ve interva l 30 minut es | |
| 699 | 30 - <4 0 minutes: 1 sessions | |
| 700 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 701 | ||
| 702 | </blockquo te></td></ tr></table > | |
| 703 | ||
| 704 | ||
| 705 | <table bor der="0" ce llspacing= "0" cellpa dding="2"> <tr><td bg color="#82 8DA6"><fon t color="# ffffff" fa ce="arial, helvetica. sanserif"> <a name="S tart an Ex isting App lication"> <!--()-->< /a><a name ="Start_an _Existing_ Applicatio n"><strong >Start an Existing A pplication </strong>< /a></font> </td></tr> <tr><td><b lockquote> | |
| 706 | ||
| 707 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 708 | http://loc alhost:808 0/manager/ start?path =/examples | |
| 709 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 710 | ||
| 711 | <p>Signal a stopped applicatio n to resta rt, and ma ke itself available again. | |
| 712 | Stopping a nd startin g is usefu l, for exa mple, if t he databas e required by | |
| 713 | your appli cation bec omes tempo rarily una vailable. It is usu ally bette r to | |
| 714 | stop the w eb applica tion that relies on this datab ase rather than lett ing | |
| 715 | users cont inuously e ncounter d atabase ex ceptions.< /p> | |
| 716 | ||
| 717 | <p>If this command s ucceeds, y ou will se e a respon se like th is:</p> | |
| 718 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 719 | OK - Start ed applica tion at co ntext path /examples | |
| 720 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 721 | ||
| 722 | <p>Otherwi se, the re sponse wil l start wi th <code>F AIL</code> and inclu de an | |
| 723 | error mess age. Poss ible cause s for prob lems inclu de:</p> | |
| 724 | <ul> | |
| 725 | <li><em>En countered exception< /em> | |
| 726 | <block quote> | |
| 727 | <p>An exception was encoun tered tryi ng to star t the web applicatio n. | |
| 728 | Check the Tomcat 6 logs fo r the deta ils.</p> | |
| 729 | </bloc kquote></l i> | |
| 730 | <li><em>In valid cont ext path w as specifi ed</em> | |
| 731 | <block quote> | |
| 732 | <p>The context p ath must s tart with a slash ch aracter. T o referenc e the | |
| 733 | ROOT w eb applica tion use " /".</p> | |
| 734 | </bloc kquote></l i> | |
| 735 | <li><em>No context e xists for path /foo< /em> | |
| 736 | <block quote> | |
| 737 | <p>The re is no d eployed ap plication on the con text path | |
| 738 | that y ou specifi ed.</p> | |
| 739 | </bloc kquote></l i> | |
| 740 | <li><em>No context p ath was sp ecified</e m> | |
| 741 | <block quote> | |
| 742 | The <c ode>path</ code> para meter is r equired. | |
| 743 | </bloc kquote></l i> | |
| 744 | </ul> | |
| 745 | ||
| 746 | </blockquo te></td></ tr></table > | |
| 747 | ||
| 748 | <table bor der="0" ce llspacing= "0" cellpa dding="2"> <tr><td bg color="#82 8DA6"><fon t color="# ffffff" fa ce="arial, helvetica. sanserif"> <a name="S top an Exi sting Appl ication">< !--()--></ a><a name= "Stop_an_E xisting_Ap plication" ><strong>S top an Exi sting Appl ication</s trong></a> </font></t d></tr><tr ><td><bloc kquote> | |
| 749 | ||
| 750 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 751 | http://loc alhost:808 0/manager/ stop?path= /examples | |
| 752 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 753 | ||
| 754 | <p>Signal an existin g applicat ion to mak e itself u navailable , but leav e it | |
| 755 | deployed. Any reque st that co mes in whi le an appl ication is | |
| 756 | stopped wi ll see an HTTP error 404, and this appli cation wil l show as | |
| 757 | "stopped" on a list applicatio ns command .</p> | |
| 758 | ||
| 759 | <p>If this command s ucceeds, y ou will se e a respon se like th is:</p> | |
| 760 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 761 | OK - Stopp ed applica tion at co ntext path /examples | |
| 762 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 763 | ||
| 764 | <p>Otherwi se, the re sponse wil l start wi th <code>F AIL</code> and inclu de an | |
| 765 | error mess age. Poss ible cause s for prob lems inclu de:</p> | |
| 766 | <ul> | |
| 767 | <li><em>En countered exception< /em> | |
| 768 | <block quote> | |
| 769 | <p>An exception was encoun tered tryi ng to stop the web a pplication . | |
| 770 | Check the Tomcat 6 logs fo r the deta ils.</p> | |
| 771 | </bloc kquote></l i> | |
| 772 | <li><em>In valid cont ext path w as specifi ed</em> | |
| 773 | <block quote> | |
| 774 | <p>The context p ath must s tart with a slash ch aracter. T o referenc e the | |
| 775 | ROOT w eb applica tion use " /".</p> | |
| 776 | </bloc kquote></l i> | |
| 777 | <li><em>No context e xists for path /foo< /em> | |
| 778 | <block quote> | |
| 779 | <p>The re is no d eployed ap plication on the con text path | |
| 780 | that y ou specifi ed.</p> | |
| 781 | </bloc kquote></l i> | |
| 782 | <li><em>No context p ath was sp ecified</e m> | |
| 783 | <block quote> | |
| 784 | The <c ode>path</ code> para meter is r equired. | |
| 785 | </bloc kquote></l i> | |
| 786 | </ul> | |
| 787 | ||
| 788 | </blockquo te></td></ tr></table > | |
| 789 | ||
| 790 | ||
| 791 | <table bor der="0" ce llspacing= "0" cellpa dding="2"> <tr><td bg color="#82 8DA6"><fon t color="# ffffff" fa ce="arial, helvetica. sanserif"> <a name="U ndeploy an Existing Applicatio n"><!--()- -></a><a n ame="Undep loy_an_Exi sting_Appl ication">< strong>Und eploy an E xisting Ap plication< /strong></ a></font>< /td></tr>< tr><td><bl ockquote> | |
| 792 | ||
| 793 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 794 | http://loc alhost:808 0/manager/ undeploy?p ath=/examp les | |
| 795 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 796 | ||
| 797 | <p><strong ><font col or="red">W ARNING</fo nt> - This command w ill delete any web | |
| 798 | applicatio n artifact s that exi st within <code>appB ase</code> directory | |
| 799 | (typically "webapps" ) for this virtual h ost</stron g>. | |
| 800 | This will delete the the appli cation .WA R, if pres ent, | |
| 801 | the applic ation dire ctory resu lting eith er from a deploy in unpacked f orm | |
| 802 | or from .W AR expansi on as well as the XM L Context definition from | |
| 803 | <code>$CAT ALINA_BASE /conf/[eng inename]/[ hostname]/ </code> di rectory. | |
| 804 | If you sim ply want t o take an applicatio n | |
| 805 | out of ser vice, you should use the <code >/stop</co de> comman d instead. </p> | |
| 806 | ||
| 807 | <p>Signal an existin g applicat ion to gra cefully sh ut itself down, and | |
| 808 | remove it from Tomca t (which a lso makes this conte xt path av ailable fo r | |
| 809 | reuse late r). In ad dition, th e document root dire ctory is r emoved, if it | |
| 810 | exists in the <code> appBase</c ode> direc tory (typi cally "web apps") for | |
| 811 | this virtu al host. This comma nd is the logical op posite of the | |
| 812 | <code>/dep loy</code> command.< /p> | |
| 813 | ||
| 814 | <p>If this command s ucceeds, y ou will se e a respon se like th is:</p> | |
| 815 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 816 | OK - Undep loyed appl ication at context p ath /examp les | |
| 817 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 818 | ||
| 819 | <p>Otherwi se, the re sponse wil l start wi th <code>F AIL</code> and inclu de an | |
| 820 | error mess age. Poss ible cause s for prob lems inclu de:</p> | |
| 821 | <ul> | |
| 822 | <li><em>En countered exception< /em> | |
| 823 | <block quote> | |
| 824 | <p>An exception was encoun tered tryi ng to unde ploy the w eb applica tion. | |
| 825 | Check the Tomcat 6 logs fo r the deta ils.</p> | |
| 826 | </bloc kquote></l i> | |
| 827 | <li><em>In valid cont ext path w as specifi ed</em> | |
| 828 | <block quote> | |
| 829 | <p>The context p ath must s tart with a slash ch aracter. T o referenc e the | |
| 830 | ROOT w eb applica tion use " /".</p> | |
| 831 | </bloc kquote></l i> | |
| 832 | <li><em>No context e xists for path /foo< /em> | |
| 833 | <block quote> | |
| 834 | <p>The re is no d eployed ap plication on the con text path | |
| 835 | that y ou specifi ed.</p> | |
| 836 | </bloc kquote></l i> | |
| 837 | <li><em>No context p ath was sp ecified</e m> | |
| 838 | <block quote> | |
| 839 | The <c ode>path</ code> para meter is r equired. | |
| 840 | </bloc kquote></l i> | |
| 841 | </ul> | |
| 842 | ||
| 843 | </blockquo te></td></ tr></table > | |
| 844 | ||
| 845 | <table bor der="0" ce llspacing= "0" cellpa dding="2"> <tr><td bg color="#82 8DA6"><fon t color="# ffffff" fa ce="arial, helvetica. sanserif"> <a name="F inding mem ory leaks" ><!--()--> </a><a nam e="Finding _memory_le aks"><stro ng>Finding memory le aks</stron g></a></fo nt></td></ tr><tr><td ><blockquo te> | |
| 846 | ||
| 847 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 848 | http://loc alhost:808 0/manager/ findleaks | |
| 849 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 850 | ||
| 851 | <p><strong >The find leaks diag nostic tri ggers a fu ll garbage collectio n. It | |
| 852 | should be used with extreme ca ution on p roduction systems.</ strong></p > | |
| 853 | ||
| 854 | <p>The fin d leaks di agnostic a ttempts to identify web applic ations tha t have | |
| 855 | caused mem ory leaks when they were stopp ed, reload ed or unde ployed. Re sults | |
| 856 | should alw ays be con firmed | |
| 857 | with a pro filer. The diagnosti c uses add itional fu nctionalit y provided by the | |
| 858 | StandardHo st impleme ntation. I t will not work if a custom ho st is used that | |
| 859 | does not e xtend Stan dardHost.< /p> | |
| 860 | ||
| 861 | <p>Explici tly trigge ring a ful l garbage collection from Java code is d ocumented | |
| 862 | to be unre liable. Fu rthermore, depending on the JV M used, th ere are op tions to | |
| 863 | disable ex plicit GC triggering , like <co de>-XX:+Di sableExpli citGC</cod e>. | |
| 864 | If you wan t to make sure, that the diagn ostics wer e successf ully runni ng a full GC, | |
| 865 | you will n eed to che ck using t ools like GC logging , JConsole or simila r.</p> | |
| 866 | ||
| 867 | <p>If this command s ucceeds, y ou will se e a respon se like th is:</p> | |
| 868 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 869 | /leaking-w ebapp | |
| 870 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 871 | ||
| 872 | <p>Each co ntext path for a web applicati on that wa s stopped, reloaded or | |
| 873 | undeployed , but whic h classes from the p revious ru ns are sti ll loaded in memory, | |
| 874 | thus causi ng a memor y leak, wi ll be list ed on a ne w line. If an applic ation | |
| 875 | has been r eloaded se veral time s, it may be listed several ti mes.</p> | |
| 876 | ||
| 877 | <p>If the command do es not suc ceed, the response w ill start with | |
| 878 | <code>FAIL </code> an d include an error m essage.</p > | |
| 879 | ||
| 880 | </blockquo te></td></ tr></table > | |
| 881 | ||
| 882 | <table bor der="0" ce llspacing= "0" cellpa dding="2"> <tr><td bg color="#82 8DA6"><fon t color="# ffffff" fa ce="arial, helvetica. sanserif"> <a name="S erver Stat us"><!--() --></a><a name="Serv er_Status" ><strong>S erver Stat us</strong ></a></fon t></td></t r><tr><td> <blockquot e> | |
| 883 | ||
| 884 | <p>From th is link , you can vi ew informa tion about the serve r.</p> | |
| 885 | ||
| 886 | <p>First, you have t he server and JVM ve rsion numb er, JVM pr ovider, OS name | |
| 887 | and number followed by the arc hitecture type.</p> | |
| 888 | ||
| 889 | <p>Second, there is several in formation about the memory usa ge of the JVM | |
| 890 | (available , total an d max memo ry).</p> | |
| 891 | ||
| 892 | <p>Then, t here is in formation about the Tomcat AJP and HTTP connectors . | |
| 893 | The same i nformation is availa ble for bo th of them : | |
| 894 | </p> | |
| 895 | <ul> | |
| 896 | <li><p >Threads i nformation : Max thr eads, min and max sp are thread s, | |
| 897 | curren t thread c ount and c urrent thr ead busy.< /p></li> | |
| 898 | <li><p >Request i nformation : Max pro cessing ti me and pro cessing ti me, | |
| 899 | reques t and erro r count, b ytes recei ved and se nt.</p></l i> | |
| 900 | <li><p >A table s howing Sta ge, Time, Bytes Sent , Bytes Re ceive, Cli ent, | |
| 901 | VHost and Reques t. All exi sting thre ads are li sted in th e table. | |
| 902 | Here i s the list of the po ssible thr ead stages :</p> | |
| 903 | <ul> | |
| 904 | <l i><p><em>" Parse and Prepare Re quest"</em > : The re quest head ers are | |
| 905 | be ing parsed or the ne cessary pr eparation to read th e request body (if | |
| 906 | a transfer e ncoding ha s been spe cified) is taking pl ace.</p></ li> | |
| 907 | <l i><p><em>" Service"</ em> : The thread is processing a request and | |
| 908 | ge nerating t he respons e. This st age follow s the "Par se and Pre pare | |
| 909 | Re quest" sta ge and pre cedes the "Finishing " stage. T here is al ways at | |
| 910 | le ast one th read in th is stage ( the server -status pa ge).</p></ li> | |
| 911 | <l i><p><em>" Finishing" </em> : Th e end of t he request processin g. Any | |
| 912 | re mainder of the respo nse still in the out put buffer s is sent to the | |
| 913 | cl ient. This stage is followed b y "Keep-Al ive" if it is approp riate to | |
| 914 | ke ep the con nection al ive or "Re ady" if "K eep-Alive" is not | |
| 915 | ap propriate. </p></li> | |
| 916 | <l i><p><em>" Keep-Alive "</em> : T he thread keeps the connection open to | |
| 917 | th e client i n case the client se nds anothe r request. If anothe r request | |
| 918 | is recieved, the next stage will br "Parse and Prepa re Requst" . If no | |
| 919 | re quest is r eceived be fore the k eep alive times out, the conne ction will | |
| 920 | be closed an d the next stage wil l be "Read y".</p></l i> | |
| 921 | <l i><p><em>" Ready"</em > : The th read is at rest and ready to b e | |
| 922 | us ed.</p></l i> | |
| 923 | </ul> | |
| 924 | </li> | |
| 925 | </ul> | |
| 926 | </blockquo te></td></ tr></table > | |
| 927 | ||
| 928 | </blockquo te></td></ tr></table ><table bo rder="0" c ellspacing ="0" cellp adding="2" ><tr><td b gcolor="#5 25D76"><fo nt color=" #ffffff" f ace="arial ,helvetica .sanserif" ><a name=" Executing Manager Co mmands Wit h Ant"><!- -()--></a> <a name="E xecuting_M anager_Com mands_With _Ant"><str ong>Execut ing Manage r Commands With Ant< /strong></ a></font>< /td></tr>< tr><td><bl ockquote> | |
| 929 | ||
| 930 | <p>In addi tion to th e ability to execute Manager c ommands vi a HTTP req uests, | |
| 931 | as documen ted above, Tomcat 6 includes a convenien t set of T ask defini tions | |
| 932 | for the <e m>Ant</em> (version 1.4 or lat er) build tool. In order to u se these | |
| 933 | commands, you must p erform the following setup ope rations:</ p> | |
| 934 | <ul> | |
| 935 | <li>Downlo ad the bin ary distri bution of Ant from | |
| 936 | <a hre f="http:// ant.apache .org">http ://ant.apa che.org</a >. | |
| 937 | You mu st use ver sion <stro ng>1.4</st rong> or l ater.</li> | |
| 938 | <li>Instal l the Ant distributi on in a co nvenient d irectory ( called | |
| 939 | ANT_HO ME in the remainder of these i nstruction s).</li> | |
| 940 | <li>Copy t he file <c ode>server /lib/catal ina-ant.ja r</code> f rom your T omcat 6 | |
| 941 | instal lation int o Ant's li brary dire ctory (<co de>$ANT_HO ME/lib</co de>). | |
| 942 | </li> | |
| 943 | <li>Add th e <code>$A NT_HOME/bi n</code> d irectory t o your <co de>PATH</c ode> | |
| 944 | enviro nment vari able.</li> | |
| 945 | <li>Config ure at lea st one use rname/pass word combi nation in your Tomca t | |
| 946 | user d atabase th at include s the <cod e>manager- script</co de> role.< /li> | |
| 947 | </ul> | |
| 948 | ||
| 949 | <p>To use custom tas ks within Ant, you m ust declar e them fir st with a | |
| 950 | <code>< taskdef> ;</code> e lement. T herefore, your <code >build.xml </code> | |
| 951 | file might look some thing like this:</p> | |
| 952 | ||
| 953 | <table bor der="1"> | |
| 954 | <tr><td><p re> | |
| 955 | <projec t name="My Applicati on" defaul t="compile " basedir= "."> | |
| 956 | ||
| 957 | <!-- Configure the direct ory into w hich the w eb applica tion is bu ilt --> | |
| 958 | <prop erty name= "build" value="${ basedir}/b uild"/> | |
| 959 | ||
| 960 | <!-- Configure the contex t path for this appl ication -- > | |
| 961 | <prop erty name= "path" value="/m yapp"/> | |
| 962 | ||
| 963 | <!-- Configure properties to access the Manag er applica tion --> ; | |
| 964 | <prop erty name= "url" value="ht tp://local host:8080/ manager"/& gt; | |
| 965 | <prop erty name= "username" value="my username"/ > | |
| 966 | <prop erty name= "password" value="my password"/ > | |
| 967 | ||
| 968 | <!-- Configure the custom Ant tasks for the M anager app lication - -> | |
| 969 | <task def name=" deploy" classname ="org.apac he.catalin a.ant.Depl oyTask"/&g t; | |
| 970 | <task def name=" list" classname ="org.apac he.catalin a.ant.List Task"/> | |
| 971 | <task def name=" reload" classname ="org.apac he.catalin a.ant.Relo adTask"/&g t; | |
| 972 | <task def name=" resources" classname ="org.apac he.catalin a.ant.Reso urcesTask" /> | |
| 973 | <task def name=" roles" classname ="org.apac he.catalin a.ant.Role sTask"/> ; | |
| 974 | <task def name=" start" classname ="org.apac he.catalin a.ant.Star tTask"/> ; | |
| 975 | <task def name=" stop" classname ="org.apac he.catalin a.ant.Stop Task"/> | |
| 976 | <task def name=" undeploy" classname ="org.apac he.catalin a.ant.Unde ployTask"/ > | |
| 977 | ||
| 978 | <!-- Executable Targets - -> | |
| 979 | <targ et name="c ompile" de scription= "Compile w eb applica tion"> | |
| 980 | <!- - ... cons truct web applicatio n in ${bui ld} subdir ectory, an d | |
| 981 | generate d a ${path }.war ... --> | |
| 982 | </tar get> | |
| 983 | ||
| 984 | <targ et name="d eploy" des cription=" Install we b applicat ion" | |
| 985 | depends="c ompile"> ; | |
| 986 | <de ploy url=" ${url}" us ername="${ username}" password= "${passwor d}" | |
| 987 | path="${ path}" war ="file:${b uild}${pat h}.war"/&g t; | |
| 988 | </tar get> | |
| 989 | ||
| 990 | <targ et name="r eload" des cription=" Reload web applicati on" | |
| 991 | depends="c ompile"> ; | |
| 992 | <re load url= "${url}" u sername="$ {username} " password ="${passwo rd}" | |
| 993 | path="${ path}"/> ; | |
| 994 | </tar get> | |
| 995 | ||
| 996 | <targ et name="u ndeploy" d escription ="Remove w eb applica tion"> | |
| 997 | <un deploy url ="${url}" username=" ${username }" passwor d="${passw ord}" | |
| 998 | path="${ path}"/> ; | |
| 999 | </tar get> | |
| 1000 | ||
| 1001 | </proje ct> | |
| 1002 | </pre></td ></tr> | |
| 1003 | </table> | |
| 1004 | ||
| 1005 | <p>Note: T he definit ion of the resources task abov e will ove rride the resources | |
| 1006 | datatype a dded in An t 1.7. If you wish t o use the resources datatype y ou will | |
| 1007 | need to us e Ant's na mespace su pport to a ssign the Tomcat tas ks to thei r own | |
| 1008 | namespace. </p> | |
| 1009 | ||
| 1010 | <p>Now, yo u can exec ute comman ds like <c ode>ant de ploy</code > to deplo y the | |
| 1011 | applicatio n to a run ning insta nce of Tom cat, or <c ode>ant re load</code > to | |
| 1012 | tell Tomca t to reloa d it. Not e also tha t most of the intere sting valu es in | |
| 1013 | this <code >build.xml </code> fi le are def ined as re placeable properties , so | |
| 1014 | you can ov erride the ir values from the c ommand lin e. For ex ample, you might | |
| 1015 | consider i t a securi ty risk to include t he real ma nager pass word in yo ur | |
| 1016 | <code>buil d.xml</cod e> file's source cod e. To avo id this, o mit the pa ssword | |
| 1017 | property, and specif y it from the comman d line:</p > | |
| 1018 | <pre> | |
| 1019 | ant -Dpass word= PW deploy | |
| 1020 | </pre> | |
| 1021 | ||
| 1022 | <table bor der="0" ce llspacing= "0" cellpa dding="2"> <tr><td bg color="#82 8DA6"><fon t color="# ffffff" fa ce="arial, helvetica. sanserif"> <a name="T asks outpu t capture" ><!--()--> </a><a nam e="Tasks_o utput_capt ure"><stro ng>Tasks o utput capt ure</stron g></a></fo nt></td></ tr><tr><td ><blockquo te> | |
| 1023 | ||
| 1024 | <p>Using < em>Ant</em > version <strong>1. 6.2</stron g> or late r, | |
| 1025 | the Catali na tasks o ffer the o ption to c apture the ir output in | |
| 1026 | properties or extern al files. They suppo rt directl y the foll owing subs et of the | |
| 1027 | <code>< redirector ></code > type att ributes: | |
| 1028 | </p> | |
| 1029 | ||
| 1030 | <table bor der="1" ce llpadding= "2" cellsp acing="0"> | |
| 1031 | <tbody> | |
| 1032 | <tr> | |
| 1033 | <td valign ="top"><b> Attribute< /b></td> | |
| 1034 | <td valign ="top"><b> Descriptio n</b></td> | |
| 1035 | <td align= "center" v align="top "><b>Requi red</b></t d> | |
| 1036 | </tr> | |
| 1037 | <tr> | |
| 1038 | <td valign ="top">out put</td> | |
| 1039 | <td valign ="top">Nam e of a fil e to which to write the output . If | |
| 1040 | the error stream is not also r edirected to a file or propert y, it will | |
| 1041 | appear in this outpu t.</td> | |
| 1042 | <td align= "center" v align="top ">No</td> | |
| 1043 | </tr> | |
| 1044 | <tr> | |
| 1045 | <td valign ="top">err or</td> | |
| 1046 | <td valign ="top">The file to w hich the s tandard er ror of the | |
| 1047 | command sh ould be re directed.< /td> | |
| 1048 | <td align= "center" v align="top ">No</td> | |
| 1049 | </tr> | |
| 1050 | <tr> | |
| 1051 | <td valign ="top">log Error</td> | |
| 1052 | <td valign ="top">Thi s attribut e is used when you w ish to see | |
| 1053 | error outp ut in Ant' s log and you are re directing output to a | |
| 1054 | file/prope rty. The e rror outpu t will not be includ ed in the output | |
| 1055 | file/prope rty. If yo u redirect error wit h the <i>e rror</i> o r <i>error Property</ i> | |
| 1056 | attributes , this wil l have no effect.</t d> | |
| 1057 | <td align= "center" v align="top ">No</td> | |
| 1058 | </tr> | |
| 1059 | <tr> | |
| 1060 | <td valign ="top">app end</td> | |
| 1061 | <td valign ="top">Whe ther outpu t and erro r files sh ould be | |
| 1062 | appended t o or overw ritten. De faults to <code>fals e</code>.< /td> | |
| 1063 | <td align= "center" v align="top ">No</td> | |
| 1064 | </tr> | |
| 1065 | <tr> | |
| 1066 | <td valign ="top">cre ateemptyfi les</td> | |
| 1067 | <td valign ="top">Whe ther outpu t and erro r files sh ould be cr eated | |
| 1068 | even when empty. Def aults to < code>true< /code>.</t d> | |
| 1069 | <td align= "center" v align="top ">No</td> | |
| 1070 | </tr> | |
| 1071 | <tr> | |
| 1072 | <td valign ="top">out putpropert y</td> | |
| 1073 | <td valign ="top">The name of a property in which t he output of | |
| 1074 | the comman d should b e stored. Unless the error str eam is red irected to | |
| 1075 | a separate file or s tream, thi s property will incl ude the er ror output .</td> | |
| 1076 | <td align= "center" v align="top ">No</td> | |
| 1077 | </tr> | |
| 1078 | <tr> | |
| 1079 | <td valign ="top">err orproperty </td> | |
| 1080 | <td valign ="top">The name of a property in which t he standar d | |
| 1081 | error of t he command should be stored.</ td> | |
| 1082 | <td align= "center" v align="top ">No</td> | |
| 1083 | </tr> | |
| 1084 | </tbody> | |
| 1085 | </table> | |
| 1086 | ||
| 1087 | <p>A coupl e of addit ional attr ibutes can also be s pecified: | |
| 1088 | </p> | |
| 1089 | <table bor der="1" ce llpadding= "2" cellsp acing="0"> | |
| 1090 | <tbody> | |
| 1091 | <tr> | |
| 1092 | <td valign ="top"><b> Attribute< /b></td> | |
| 1093 | <td valign ="top"><b> Descriptio n</b></td> | |
| 1094 | <td align= "center" v align="top "><b>Requi red</b></t d> | |
| 1095 | </tr> | |
| 1096 | <tr> | |
| 1097 | <td valign ="top">alw aysLog</td > | |
| 1098 | <td valign ="top">Thi s attribut e is used when you w ish to see the | |
| 1099 | output you are captu ring, appe aring also in the An t's log. I t must not be | |
| 1100 | used unles s you are capturing task outpu t. | |
| 1101 | Defaults t o <code>fa lse</code> . | |
| 1102 | <em>This a ttribute w ill be sup ported dir ectly by < code><r edirector& gt;</code> | |
| 1103 | in Ant 1.6 .3</em></t d> | |
| 1104 | <td align= "center" v align="top ">No</td> | |
| 1105 | </tr> | |
| 1106 | <tr> | |
| 1107 | <td valign ="top">fai lonerror</ td> | |
| 1108 | <td valign ="top">Thi s attribut e is used when you w ish to avo id that | |
| 1109 | any manage r command processing error ter minates th e ant exec ution. Def aults to < code>true< /code>. | |
| 1110 | It must be set to <c ode>false< /code>, if you want to capture error out put, | |
| 1111 | otherwise execution will termi nate befor e anything can be ca ptured. | |
| 1112 | <br> | |
| 1113 | This attri bute acts only on ma nager comm and execut ion, | |
| 1114 | any wrong or missing command a ttribute w ill still cause Ant execution terminatio n. | |
| 1115 | </td> | |
| 1116 | <td align= "center" v align="top ">No</td> | |
| 1117 | </tr> | |
| 1118 | </tbody> | |
| 1119 | </table> | |
| 1120 | ||
| 1121 | <p>They al so support the embed ded <code> <redire ctor></ code> elem ent | |
| 1122 | in which y ou can spe cify | |
| 1123 | its full s et of attr ibutes, bu t <code>in put</code> , <code>in putstring< /code> and | |
| 1124 | <code>inpu tencoding< /code> tha t, even if accepted, are not u sed becaus e they hav e | |
| 1125 | no meaning in this c ontext. | |
| 1126 | Refer to < a href="ht tp://ant.a pache.org" >ant manua l</a> for details on | |
| 1127 | <code>< redirector ></code > element attributes . | |
| 1128 | </p> | |
| 1129 | ||
| 1130 | <p> | |
| 1131 | Here is a sample bui ld file ex tract that shows how this outp ut redirec tion suppo rt | |
| 1132 | can be use d: | |
| 1133 | </p> | |
| 1134 | ||
| 1135 | <table bor der="1"> | |
| 1136 | <tr><td><p re> | |
| 1137 | <targ et name="m anager.dep loy" | |
| 1138 | depend s="context .status" | |
| 1139 | if="co ntext.notI nstalled"& gt; | |
| 1140 | <de ploy url=" ${mgr.url} " | |
| 1141 | user name="${mg r.username }" | |
| 1142 | pass word="${mg r.password }" | |
| 1143 | path ="${mgr.co ntext.path }" | |
| 1144 | conf ig="${mgr. context.de scriptor}" /> | |
| 1145 | </tar get> | |
| 1146 | ||
| 1147 | <targ et name="m anager.dep loy.war" | |
| 1148 | depend s="context .status" | |
| 1149 | if="co ntext.depl oyable"> ; | |
| 1150 | <de ploy url=" ${mgr.url} " | |
| 1151 | user name="${mg r.username }" | |
| 1152 | pass word="${mg r.password }" | |
| 1153 | upda te="${mgr. update}" | |
| 1154 | path ="${mgr.co ntext.path }" | |
| 1155 | war= "${mgr.war .file}"/&g t; | |
| 1156 | </tar get> | |
| 1157 | ||
| 1158 | <targ et name="c ontext.sta tus"> | |
| 1159 | <pr operty nam e="running " value="$ {mgr.conte xt.path}:r unning"/&g t; | |
| 1160 | <pr operty nam e="stopped " value="$ {mgr.conte xt.path}:s topped"/&g t; | |
| 1161 | ||
| 1162 | <li st url="${ mgr.url}" | |
| 1163 | outp utproperty ="ctx.stat us" | |
| 1164 | user name="${mg r.username }" | |
| 1165 | pass word="${mg r.password }"> | |
| 1166 | </l ist> | |
| 1167 | ||
| 1168 | <co ndition pr operty="co ntext.runn ing"> | |
| 1169 | < contains s tring="${c tx.status} " substrin g="${runni ng}"/> | |
| 1170 | </c ondition&g t; | |
| 1171 | <co ndition pr operty="co ntext.stop ped"> | |
| 1172 | < contains s tring="${c tx.status} " substrin g="${stopp ed}"/> | |
| 1173 | </c ondition&g t; | |
| 1174 | <co ndition pr operty="co ntext.notI nstalled"& gt; | |
| 1175 | < and> | |
| 1176 | &l t;isfalse value="${c ontext.run ning}"/> ; | |
| 1177 | &l t;isfalse value="${c ontext.sto pped}"/> ; | |
| 1178 | < /and> | |
| 1179 | </c ondition&g t; | |
| 1180 | <co ndition pr operty="co ntext.depl oyable"> ; | |
| 1181 | < or> | |
| 1182 | &l t;istrue v alue="${co ntext.notI nstalled}" /> | |
| 1183 | &l t;and> | |
| 1184 | <istrue value="${ context.ru nning}"/&g t; | |
| 1185 | <istrue value="${ mgr.update }"/> | |
| 1186 | &l t;/and> | |
| 1187 | &l t;and> | |
| 1188 | <istrue value="${ context.st opped}"/&g t; | |
| 1189 | <istrue value="${ mgr.update }"/> | |
| 1190 | &l t;/and> | |
| 1191 | < /or> | |
| 1192 | </c ondition&g t; | |
| 1193 | <co ndition pr operty="co ntext.unde ployable"& gt; | |
| 1194 | < or> | |
| 1195 | &l t;istrue v alue="${co ntext.runn ing}"/> | |
| 1196 | &l t;istrue v alue="${co ntext.stop ped}"/> | |
| 1197 | < /or> | |
| 1198 | </c ondition&g t; | |
| 1199 | </tar get> | |
| 1200 | </pre></td ></tr> | |
| 1201 | </table> | |
| 1202 | ||
| 1203 | <p><strong >WARNING:< /strong> e ven if it doesn't ma ke many se nse, and i s always a bad idea, | |
| 1204 | calling a Catalina t ask more t han once, | |
| 1205 | badly set Ant tasks depends ch ains may c ause that a task be called | |
| 1206 | more than once in th e same Ant run, even if not in tended to. A bit of caution sh ould be ex ercised wh en you are | |
| 1207 | capturing output fro m that tas k, because this coul d lead to something unexpected :</p> | |
| 1208 | <ul> | |
| 1209 | <li>when c apturing i n a proper ty you wil l find in it only th e output f rom the <e m>first</e m> call, b ecause | |
| 1210 | Ant proper ties are i mmutable a nd once se t they can not be cha nged, | |
| 1211 | </li> | |
| 1212 | <li>when c apturing i n a file, each run w ill overwr ite it and you will find in it only the <em>last</ em> call | |
| 1213 | output, un less you a re using t he <code>a ppend="tru e"</code> attribute, in which case you w ill | |
| 1214 | see the ou tput of ea ch task ca ll appende d to the f ile. | |
| 1215 | </li> | |
| 1216 | </ul> | |
| 1217 | ||
| 1218 | </blockquo te></td></ tr></table > | |
| 1219 | ||
| 1220 | </blockquo te></td></ tr></table ><table bo rder="0" c ellspacing ="0" cellp adding="2" ><tr><td b gcolor="#5 25D76"><fo nt color=" #ffffff" f ace="arial ,helvetica .sanserif" ><a name=" Using the JMX Proxy Servlet">< !--()--></ a><a name= "Using_the _JMX_Proxy _Servlet"> <strong>Us ing the JM X Proxy Se rvlet</str ong></a></ font></td> </tr><tr>< td><blockq uote> | |
| 1221 | ||
| 1222 | <table b order="0" cellspacin g="0" cell padding="2 "><tr><td bgcolor="# 828DA6"><f ont color= "#ffffff" face="aria l,helvetic a.sanserif "><a name= "What is J MX Proxy S ervlet"><! --()--></a ><a name=" What_is_JM X_Proxy_Se rvlet"><st rong>What is JMX Pro xy Servlet </strong>< /a></font> </td></tr> <tr><td><b lockquote> | |
| 1223 | The JM X Proxy Se rvlet is a lightweig ht proxy t o get and set the | |
| 1224 | tomcat internals . (Or any class that has been exposed vi a an MBean ) | |
| 1225 | Its us age is not very user friendly but the UI is | |
| 1226 | extrem ely help f or integra ting comma nd line sc ripts for monitoring | |
| 1227 | and ch anging the internals of tomcat . You can do two thi ngs with t he proxy: | |
| 1228 | get in formation and set in formation. For you t o really u nderstand the | |
| 1229 | JMX Pr oxy Servle t, you sho uld have a general u nderstandi ng of JMX. | |
| 1230 | If you don't kno w what JMX is, then prepare to be confus ed. | |
| 1231 | </blockq uote></td> </tr></tab le> | |
| 1232 | ||
| 1233 | <table b order="0" cellspacin g="0" cell padding="2 "><tr><td bgcolor="# 828DA6"><f ont color= "#ffffff" face="aria l,helvetic a.sanserif "><a name= "JMX Query command"> <!--()-->< /a><a name ="JMX_Quer y_command" ><strong>J MX Query c ommand</st rong></a>< /font></td ></tr><tr> <td><block quote> | |
| 1234 | This t akes the f orm: | |
| 1235 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 1236 | http://web server/man ager/jmxpr oxy/?qry=S TUFF | |
| 1237 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 1238 | Where <code>STUF F</code> i s the JMX query you wish to pe rform. For example, | |
| 1239 | here a re some qu eries you might wish to run: | |
| 1240 | <ul> | |
| 1241 | <li> | |
| 1242 | <c ode>qry=*% 3Atype%3DR equestProc essor%2C* --> | |
| 1243 | t ype=Reques tProcessor </code> wh ich will l ocate all | |
| 1244 | w orkers whi ch can pro cess reque sts and re port | |
| 1245 | t heir state . | |
| 1246 | </li > | |
| 1247 | <li> | |
| 1248 | <c ode>qry=*% 3Aj2eeType =Servlet%2 c* --> | |
| 1249 | j2eeType =Servlet</ code> whic h return a ll loaded servlets. | |
| 1250 | </li > | |
| 1251 | <li> | |
| 1252 | <c ode>qry=Ca talina%3At ype%3DEnvi ronment%2C resourcety pe%3DGloba l%2Cname%3 DsimpleVal ue --> | |
| 1253 | Catalina :type=Envi ronment,re sourcetype =Global,na me=simpleV alue</code > | |
| 1254 | which lo ok for a s pecific MB ean by the given nam e. | |
| 1255 | </li > | |
| 1256 | </ul> | |
| 1257 | You'll need to e xperiment with this to really understand its capab ilites. | |
| 1258 | If you provide n o <code>qr y</code> p arameter, then all o f the MBea ns will | |
| 1259 | be dis played. We really re commend lo oking at t he tomcat source cod e and | |
| 1260 | unders tand the J MX spec to get a bet ter unders tanding of all the q ueries | |
| 1261 | you ma y run. | |
| 1262 | </blockq uote></td> </tr></tab le> | |
| 1263 | ||
| 1264 | <table b order="0" cellspacin g="0" cell padding="2 "><tr><td bgcolor="# 828DA6"><f ont color= "#ffffff" face="aria l,helvetic a.sanserif "><a name= "JMX Set c ommand"><! --()--></a ><a name=" JMX_Set_co mmand"><st rong>JMX S et command </strong>< /a></font> </td></tr> <tr><td><b lockquote> | |
| 1265 | Now th at you can query an MBean, its time to m uck with T omcat's in ternals! | |
| 1266 | The ge neral form of the se t command is : | |
| 1267 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 1268 | http://web server/man ager/jmxpr oxy/?set=B EANNAME&am p;att=MYAT TRIBUTE&am p;val=NEWV ALUE | |
| 1269 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 1270 | So you need to p rovide 3 r equest par ameters: | |
| 1271 | <ol> | |
| 1272 | <li> <code>set< /code>: Th e full bea n name</li > | |
| 1273 | <li> <code>att< /code>: Th e attribut e you wish to alter< /li> | |
| 1274 | <li> <code>val< /code>: Th e new valu e </li> | |
| 1275 | </ol> | |
| 1276 | If all goes ok, then it wi ll say OK, otherwise an error message wi ll be | |
| 1277 | shown. For examp le, lets s ay we wish to turn u p debuggin g on the f ly for the | |
| 1278 | <code> ErrorRepor tValve</co de>. The f ollowing w ill set de bugging to 10. | |
| 1279 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 1280 | http://loc alhost:808 0/manager/ jmxproxy/ | |
| 1281 | ?set=Cata lina%3Atyp e%3DValve% 2Cname%3DE rrorReport Valve%2Cho st%3Dlocal host | |
| 1282 | &att= debug& val=10 | |
| 1283 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 1284 | and my result is (YMMV): | |
| 1285 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 1286 | Result: ok | |
| 1287 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 1288 | ||
| 1289 | Here i s what I s ee if I pa ss in a ba d value. H ere is the URL I use d, | |
| 1290 | I try set debugg ing equal to 'cow': | |
| 1291 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 1292 | http://loc alhost:808 0/manager/ jmxproxy/ | |
| 1293 | ?set=Cata lina%3Atyp e%3DValve% 2Cname%3DE rrorReport Valve%2Cho st%3Dlocal host | |
| 1294 | &att= debug& val=cow | |
| 1295 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 1296 | When I try that, my result is | |
| 1297 | <div align ="left"><t able cells pacing="4" cellpaddi ng="0" bor der="0"><t r><td bgco lor="#0232 64" width= "1" height ="1"><img src="./ima ges/void.g if" alt="" width="1" height="1 " vspace=" 0" hspace= "0" border ="0"></td> <td bgcolo r="#023264 " height=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td><t d bgcolor= "#023264" width="1" height="1" ><img src= "./images/ void.gif" alt="" wid th="1" hei ght="1" vs pace="0" h space="0" border="0" ></td></tr ><tr><td b gcolor="#0 23264" wid th="1"><im g src="./i mages/void .gif" alt= "" width=" 1" height= "1" vspace ="0" hspac e="0" bord er="0"></t d><td bgco lor="#ffff ff" height ="1"><pre> | |
| 1298 | Error: jav a.lang.Num berFormatE xception: For input string: "c ow" | |
| 1299 | </pre></td ><td bgcol or="#02326 4" width=" 1"><img sr c="./image s/void.gif " alt="" w idth="1" h eight="1" vspace="0" hspace="0 " border=" 0"></td></ tr><tr><td bgcolor=" #023264" w idth="1" h eight="1"> <img src=" ./images/v oid.gif" a lt="" widt h="1" heig ht="1" vsp ace="0" hs pace="0" b order="0"> </td><td b gcolor="#0 23264" hei ght="1"><i mg src="./ images/voi d.gif" alt ="" width= "1" height ="1" vspac e="0" hspa ce="0" bor der="0"></ td><td bgc olor="#023 264" width ="1" heigh t="1"><img src="./im ages/void. gif" alt=" " width="1 " height=" 1" vspace= "0" hspace ="0" borde r="0"></td ></tr></ta ble></div> | |
| 1300 | </blockq uote></td> </tr></tab le> | |
| 1301 | ||
| 1302 | ||
| 1303 | </blockquo te></td></ tr></table ></td></tr ><!--FOOTE R SEPARATO R--><tr><t d colspan= "2"><hr no shade="nos hade" size ="1"></td> </tr><!--P AGE FOOTER --><tr><td colspan=" 2"><div al ign="cente r"><font c olor="#525 D76" size= "-1"><em> | |
| 1304 | Co pyright &c opy; 1999- 2013, Apac he Softwar e Foundati on | |
| 1305 | </ em></font> </div></td ></tr></ta ble></body ></html> |
Araxis Merge (but not the data content of this report) is Copyright © 1993-2016 Araxis Ltd (www.araxis.com). All rights reserved.