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 diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/dist/README	Tue Nov 03 03:32:45 2009 +0300
     1.3 @@ -0,0 +1,43 @@
     1.4 += Description =
     1.5 +
     1.6 +Tomcat event listener to automatically deploy update and undeploy
     1.7 +applications from user home directories.
     1.8 +
     1.9 +This is a rewrite of org.apache.catalina.startup.UserConfig listener
    1.10 +included in Tomcat which adds the following features:
    1.11 + - multiple web applications for each user,
    1.12 + - automatic application deployment,
    1.13 + - on UNIX access remote user database using getent command.
    1.14 +
    1.15 += Installation =
    1.16 +
    1.17 +Copy userconfig.jar to Tomcat lib directory. Add Listener to the Host
    1.18 +element in the Tomcat configuration file (server.xml).
    1.19 +
    1.20 +Listener that uses passwd database to list users:
    1.21 +    <Listener className="kryshen.catalina.startup.PasswdUserConfig"/>
    1.22 +
    1.23 +Listener that considers all home directories in the specified base
    1.24 +directory:
    1.25 +    <Listener className="kryshen.catalina.startup.HomesUserConfig"/>
    1.26 +
    1.27 += Listener properties =
    1.28 +
    1.29 +Common:
    1.30 +
    1.31 +  directoryName - base directory for web applications inside user's
    1.32 +                  home directory. Default: "public_webapps".
    1.33 +
    1.34 +  appsPerUser - maximum number of application each user is allowed to
    1.35 +                deploy. Default: -1 (unlimited).
    1.36 +
    1.37 +PasswdUserConfig:
    1.38 +
    1.39 +  passwd - path to local passwd file. Default: "/etc/passwd".
    1.40 +
    1.41 +  getent - getent command. Local passwd is used if this is not set.
    1.42 +           Default: not set (null).
    1.43 +
    1.44 +HomesUserConfig
    1.45 +
    1.46 +  homeBase - base directory for user homes. Default: "/home".
     2.1 --- a/src/kryshen/catalina/startup/HomesUserConfig.java	Tue Nov 03 03:02:57 2009 +0300
     2.2 +++ b/src/kryshen/catalina/startup/HomesUserConfig.java	Tue Nov 03 03:32:45 2009 +0300
     2.3 @@ -31,7 +31,7 @@
     2.4      /**
     2.5       * The base directory containing user home directories.
     2.6       */
     2.7 -    private String homeBase = null;
     2.8 +    private String homeBase = "/home";
     2.9  
    2.10  
    2.11      public HomesUserConfig() {