= 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.userconfig.PasswdUserConfig"/>

Listener that considers all home directories in the specified base
directory:
    <Listener className="kryshen.catalina.userconfig.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".