changeset 17:012d66bbc61f

README. Set default homeBase value.
author Mikhail Kryshen <mikhail@kryshen.net>
date Tue, 03 Nov 2009 03:32:45 +0300
parents 283527b97f1e
children 1915c9c69129
files dist/README src/kryshen/catalina/startup/HomesUserConfig.java
diffstat 2 files changed, 44 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/dist/README	Tue Nov 03 03:32:45 2009 +0300
@@ -0,0 +1,43 @@
+= Description =
+
+Tomcat event listener to automatically deploy update and undeploy
+applications from user home directories.
+
+This is a rewrite of org.apache.catalina.startup.UserConfig listener
+included in Tomcat which adds the following features:
+ - multiple web applications for each user,
+ - automatic application deployment,
+ - on UNIX access remote user database using getent command.
+
+= Installation =
+
+Copy userconfig.jar to Tomcat lib directory. Add Listener to the Host
+element in the Tomcat configuration file (server.xml).
+
+Listener that uses passwd database to list users:
+    <Listener className="kryshen.catalina.startup.PasswdUserConfig"/>
+
+Listener that considers all home directories in the specified base
+directory:
+    <Listener className="kryshen.catalina.startup.HomesUserConfig"/>
+
+= Listener properties =
+
+Common:
+
+  directoryName - base directory for web applications inside user's
+                  home directory. Default: "public_webapps".
+
+  appsPerUser - maximum number of application each user is allowed to
+                deploy. Default: -1 (unlimited).
+
+PasswdUserConfig:
+
+  passwd - path to local passwd file. Default: "/etc/passwd".
+
+  getent - getent command. Local passwd is used if this is not set.
+           Default: not set (null).
+
+HomesUserConfig
+
+  homeBase - base directory for user homes. Default: "/home".
--- a/src/kryshen/catalina/startup/HomesUserConfig.java	Tue Nov 03 03:02:57 2009 +0300
+++ b/src/kryshen/catalina/startup/HomesUserConfig.java	Tue Nov 03 03:32:45 2009 +0300
@@ -31,7 +31,7 @@
     /**
      * The base directory containing user home directories.
      */
-    private String homeBase = null;
+    private String homeBase = "/home";
 
 
     public HomesUserConfig() {