You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@beehive.apache.org by ri...@apache.org on 2005/10/17 21:46:18 UTC
svn commit: r325968 - in
/beehive/trunk/docs/forrest/release/src/documentation/content/xdocs:
controls/tutorial_controls.xml netui/netui-samples.xml
netui/sample_jpf_jsf_integration.xml netui/tutorial_pageflow.xml
samples/petstore.xml
Author: rich
Date: Mon Oct 17 12:46:08 2005
New Revision: 325968
URL: http://svn.apache.org/viewcvs?rev=325968&view=rev
Log:
Added notes on the Tomcat 5.5.x Windows JAR-locking problem (http://issues.apache.org/jira/browse/BEEHIVE-960), and instructions for working around it when redeploying a web application.
tests: build.release in docs/forrest/release (WinXP)
Modified:
beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/controls/tutorial_controls.xml
beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/netui-samples.xml
beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/sample_jpf_jsf_integration.xml
beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tutorial_pageflow.xml
beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/samples/petstore.xml
Modified: beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/controls/tutorial_controls.xml
URL: http://svn.apache.org/viewcvs/beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/controls/tutorial_controls.xml?rev=325968&r1=325967&r2=325968&view=diff
==============================================================================
--- beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/controls/tutorial_controls.xml (original)
+++ beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/controls/tutorial_controls.xml Mon Oct 17 12:46:08 2005
@@ -268,6 +268,22 @@
<p>On Windows:</p>
<source>
copy controls_tutorial.war %CATALINA_HOME%\webapps /Y</source>
+ <note>
+ On Windows, there are file-locking issues that Tomcat versions 5.5.x and above are sensitive to.
+ In particular, any web application that uses Struts will <strong>fail to redeploy</strong> if you
+ copy in a new .war file as described here. The Commons Digester team is adding a workaround for the
+ issue (see
+ <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=37034">this bug</a>), but in the meantime,
+ you can work around it with the <code>antiResourceLocking</code> option in Tomcat. Just add a file
+ called <code>context.xml</code> in a directory called <code>META-INF</code> inside the
+ <code>web</code> directory before building (so it will end up as <code>META-INF/context.xml</code>
+ in your <code>controls_tutorial.war</code>):
+ <br/>
+ <br/>
+ <code> <?xml version="1.0" encoding="UTF-8"?></code><br/>
+ <code> <Context antiResourceLocking="true"></code><br/>
+ <code> </Context></code>
+ </note>
<p>Everywhere else:</p>
<source>
cp controls_tutorial.war $CATALINA_HOME/webapps</source>
Modified: beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/netui-samples.xml
URL: http://svn.apache.org/viewcvs/beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/netui-samples.xml?rev=325968&r1=325967&r2=325968&view=diff
==============================================================================
--- beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/netui-samples.xml (original)
+++ beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/netui-samples.xml Mon Oct 17 12:46:08 2005
@@ -149,6 +149,22 @@
<p>To deploy the samples, copy the WAR file to Tomcat's <code>webapps</code> directory.</p>
<p>On Windows:</p>
<source>copy C:\beehive_projects\netui-samples.war %CATALINA_HOME%\webapps /Y</source>
+ <note>
+ On Windows, there are file-locking issues that Tomcat versions 5.5.x and above are sensitive to.
+ In particular, any web application that uses Struts will <strong>fail to redeploy</strong> if you
+ copy in a new .war file as described here. The Commons Digester team is adding a workaround for the
+ issue (see
+ <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=37034">this bug</a>), but in the meantime,
+ you can work around it with the <code>antiResourceLocking</code> option in Tomcat. Just add a file
+ called <code>context.xml</code> in a directory called <code>META-INF</code> inside the
+ web application directory before building (so it will end up as <code>META-INF/context.xml</code>
+ in your <code>controls_tutorial.war</code>):
+ <br/>
+ <br/>
+ <code> <?xml version="1.0" encoding="UTF-8"?></code><br/>
+ <code> <Context antiResourceLocking="true"></code><br/>
+ <code> </Context></code>
+ </note>
<p>Everywhere else:</p>
<source>cp /beehive_projects/netui-samples.war $CATALINA_HOME/webapps</source>
</section>
Modified: beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/sample_jpf_jsf_integration.xml
URL: http://svn.apache.org/viewcvs/beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/sample_jpf_jsf_integration.xml?rev=325968&r1=325967&r2=325968&view=diff
==============================================================================
--- beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/sample_jpf_jsf_integration.xml (original)
+++ beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/sample_jpf_jsf_integration.xml Mon Oct 17 12:46:08 2005
@@ -147,6 +147,22 @@
<p>To deploy the samples, copy the WAR file to Tomcat's <code>webapps</code> directory.</p>
<p>On Windows:</p>
<source>copy C:\beehive_projects\netui-jsf.war %CATALINA_HOME%\webapps /Y</source>
+ <note>
+ On Windows, there are file-locking issues that Tomcat versions 5.5.x and above are sensitive to.
+ In particular, any web application that uses Struts will <strong>fail to redeploy</strong> if you
+ copy in a new .war file as described here. The Commons Digester team is adding a workaround for the
+ issue (see
+ <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=37034">this bug</a>), but in the meantime,
+ you can work around it with the <code>antiResourceLocking</code> option in Tomcat. Just add a file
+ called <code>context.xml</code> in a directory called <code>META-INF</code> inside the
+ web application directory before building (so it will end up as <code>META-INF/context.xml</code>
+ in your <code>controls_tutorial.war</code>):
+ <br/>
+ <br/>
+ <code> <?xml version="1.0" encoding="UTF-8"?></code><br/>
+ <code> <Context antiResourceLocking="true"></code><br/>
+ <code> </Context></code>
+ </note>
<p>Everywhere else:</p>
<source>cp /beehive_projects/netui-jsf.war $CATALINA_HOME/webapps</source>
</section>
Modified: beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tutorial_pageflow.xml
URL: http://svn.apache.org/viewcvs/beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tutorial_pageflow.xml?rev=325968&r1=325967&r2=325968&view=diff
==============================================================================
--- beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tutorial_pageflow.xml (original)
+++ beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/netui/tutorial_pageflow.xml Mon Oct 17 12:46:08 2005
@@ -288,8 +288,23 @@
directory.</p>
<p>On Windows:</p>
<source>
-copy pageflow_tutorial.war %CATALINA_HOME%\webapps /Y
-</source>
+copy pageflow_tutorial.war %CATALINA_HOME%\webapps /Y</source>
+ <note>
+ On Windows, there are file-locking issues that Tomcat versions 5.5.x and above are sensitive to.
+ In particular, any web application that uses Struts will <strong>fail to redeploy</strong> if you
+ copy in a new .war file as described here. The Commons Digester team is adding a workaround for the
+ issue (see
+ <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=37034">this bug</a>), but in the meantime,
+ you can work around it with the <code>antiResourceLocking</code> option in Tomcat. Just add a file
+ called <code>context.xml</code> in a directory called <code>META-INF</code> inside the
+ <code>web</code> directory before building (so it will end up as <code>META-INF/context.xml</code>
+ in your <code>controls_tutorial.war</code>):
+ <br/>
+ <br/>
+ <code> <?xml version="1.0" encoding="UTF-8"?></code><br/>
+ <code> <Context antiResourceLocking="true"></code><br/>
+ <code> </Context></code>
+ </note>
<p>Everywhere else:</p>
<source>
cp pageflow_tutorial.war $CATALINA_HOME/webapps
Modified: beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/samples/petstore.xml
URL: http://svn.apache.org/viewcvs/beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/samples/petstore.xml?rev=325968&r1=325967&r2=325968&view=diff
==============================================================================
--- beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/samples/petstore.xml (original)
+++ beehive/trunk/docs/forrest/release/src/documentation/content/xdocs/samples/petstore.xml Mon Oct 17 12:46:08 2005
@@ -275,6 +275,22 @@
<p>To deploy the web application, copy the WAR file to Tomcat's webapps directory.</p>
<p>On Windows:</p>
<source>copy C:\beehive_projects\petstoreWeb.war %CATALINA_HOME%\webapps /Y</source>
+ <note>
+ On Windows, there are file-locking issues that Tomcat versions 5.5.x and above are sensitive to.
+ In particular, any web application that uses Struts will <strong>fail to redeploy</strong> if you
+ copy in a new .war file as described here. The Commons Digester team is adding a workaround for the
+ issue (see
+ <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=37034">this bug</a>), but in the meantime,
+ you can work around it with the <code>antiResourceLocking</code> option in Tomcat. Just add a file
+ called <code>context.xml</code> in a directory called <code>META-INF</code> inside the
+ <code>web</code> directory before building (so it will end up as <code>META-INF/context.xml</code>
+ in your <code>controls_tutorial.war</code>):
+ <br/>
+ <br/>
+ <code> <?xml version="1.0" encoding="UTF-8"?></code><br/>
+ <code> <Context antiResourceLocking="true"></code><br/>
+ <code> </Context></code>
+ </note>
<p>Everywhere else:</p>
<source>cp /beehive_projects/petstoreWeb.war $CATALINA_HOME/webapps</source>