CVS lucene/debian

[Jeff Breidenbach]

Update of /cvsroot/pkg-java/lucene/debian
In directory haydn:/tmp/cvs-serv25701

Modified Files:
      Tag: RB_1_4_3
	README.Debian 
Log Message:
add some instructions for webapp

--- /cvsroot/pkg-java/lucene/debian/README.Debian	2005/03/22 19:38:51	1.2.2.2
+++ /cvsroot/pkg-java/lucene/debian/README.Debian	2005/04/18 22:58:48	1.2.2.3
@@ -1,15 +1,50 @@
 Lucene for Debian
 -----------------
 
-The Javadoc(TM) for Lucene can be found at /usr/share/doc/liblucene-java-doc/docs/index.html.
+The Javadoc(TM) for Lucene can be found at
 
-The Lucene demo applications are included in the liblucene-java package.  It includes the following files:
+ /usr/share/doc/liblucene-java-doc/docs/index.html
 
-	/var/lib/tomcat4/webapps/luceneweb.war
-	/usr/share/java/lucene-demos-x.x.jar
+The Lucene demo applications are included in the liblucene-java
+package.  It includes the following files:
 
-The demonstration applications require additional configuration to be used.  To configure the demonstration command-line applications for Lucene, see the documentation at /usr/share/doc/liblucene-java-doc/docs/demo.html.  A walkthrough of the source code for the demo is also provided at /usr/share/doc/liblucene-java-doc/docs/demo2.html.
-
-See /usr/share/doc/liblucene-java-doc/docs/demo3.html for information on configuring the Lucene web application to be run in a Java(TM) web container such as Tomcat.  A source code walkthrough for this application can be found at /usr/share/doc/liblucene-java-doc/docs/demo4.html
+ /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 and run the demonstration command-line applications
+for Lucene, see the following documentation and source code walkthrough:
+
+ /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 the following
+documentation and source code walkthrough:
+
+ /usr/share/doc/liblucene-java-doc/docs/demo3.html
+ /usr/share/doc/liblucene-java-doc/docs/demo4.html
+
+Several modifications are required if you wish to run the Lucene web
+application on a stock Debian tomcat4 configuration. Note that Debian's
+default Tomcat configuration may have changed since these instructions
+were written.
+
+1) 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 package. 
+
+2) You will need to add the following permissions to the
+   grant {...} section of /etc/tomcat4/policy.d/04webapps.policy.
+   Debian's default tomcat configuration
+
+// 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,delete";
+permission java.io.FilePermission "/var/lib/tomcat4/temp/*", "read,write,delete";
 
  -- Barry Hawkins <barry@alltc.com>, Tue, 22 Mar 2005 14:20:38 -0500