tomcat & webapps & permissions

[Jeff Breidenbach <jeff@jab.org>]

Hi Barry & other Debian-Java folks,

I was just playing with the demo web application that comes in
liblucene-java-1.4.3-4.  This is one of those .war things and it
requires adjusting some Tomcat permissions for it to work. Is this
best left to README.Debian, or should the liblucene-java package
somehow automatically adjust Tomcat permissions?

Cheers,
Jeff

===== possible future README.Debian for liblucene-java package ====

Lucene for Debian
-----------------

The Javadoc(TM) for Lucene can be found at

 /usr/share/doc/liblucene-java-doc/docs/index.html

The Lucene demo applications are included in the liblucene-java
package.  It includes the following files:

 /var/lib/tomcat4/webapps/luceneweb.war
 /usr/share/java/lucene-demos-x.x.jar

The demonstration applications require additional configuration to be
used.  To configure the demonstration command-line applications for
Lucene, see the documentation and source code walthrough

 /usr/share/doc/liblucene-java-doc/docs/demo.html
 /usr/share/doc/liblucene-java-doc/docs/demo2.html

For information on configuring the Lucene web application to be run in
a Java(TM) web container such as Tomcat, see documentation and
source walkthough.

 /usr/share/doc/liblucene-java-doc/docs/demo3.html
 /usr/share/doc/liblucene-java-doc/docs/demo4.html

The Lucene web application looks for Lucene index data in
/opt/lucene/index, although we may change this location in a future
version of the Debian pacakge. If you want to run on a stock Debian
tomcat4 configuration, you will need to add extra permissions to the
grant {...} section of /etc/tomcat4/policy.d/04webapps.policy

 // Allows luceneweb demo to work
 permission java.util.PropertyPermission "disableLuceneLocks", "read";
 permission java.util.PropertyPermission "java.io.tmpdir", "read";
 permission java.util.PropertyPermission "org.apache.lucene.*", "read";
 permission java.io.FilePermission "/opt/lucene/index", "read";
 permission java.io.FilePermission "/opt/lucene/index/*", "read";
 permission java.io.FilePermission "/var/lib/tomcat4/temp", "read,write,delet\
\
e";
 permission java.io.FilePermission "/var/lib/tomcat4/temp/*", "read,write,del\
\
ete";