Mercurial > hg > tomcat-userconfig
changeset 27:ec5d764b73a3
Move README.
author | Mikhail Kryshen <mikhail@kryshen.net> |
---|---|
date | Tue, 03 Nov 2009 18:09:31 +0300 |
parents | 9501a363dcbb |
children | 3349a282943a |
files | README dist/README |
diffstat | 2 files changed, 54 insertions(+), 54 deletions(-) [+] |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/README Tue Nov 03 18:09:31 2009 +0300 @@ -0,0 +1,54 @@ += Description = + +Host lifecycle event listener for Apache Tomcat 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 read network 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 - path to getent program. Local passwd is used if this is not + set. Default: not set (null). + +HomesUserConfig + + homeBase - base directory for user homes. Default: "/home". + += Example = + +<Host name="localhost" appBase="webapps" + unpackWARs="true" autoDeploy="true" + xmlValidation="false" xmlNamespaceAware="false" + backgroundProcessorDelay="15"> + + <Listener className="kryshen.catalina.userconfig.PasswdUserConfig" + getent="/usr/bin/getent" appsPerUser="5"/> +</Host>
--- a/dist/README Tue Nov 03 17:20:42 2009 +0300 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,54 +0,0 @@ -= 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 read network 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 - path to getent program. Local passwd is used if this is not - set. Default: not set (null). - -HomesUserConfig - - homeBase - base directory for user homes. Default: "/home". - -= Example = - -<Host name="localhost" appBase="webapps" - unpackWARs="true" autoDeploy="true" - xmlValidation="false" xmlNamespaceAware="false" - backgroundProcessorDelay="15"> - - <Listener className="kryshen.catalina.userconfig.PasswdUserConfig" - getent="/usr/bin/getent" appsPerUser="5"/> -</Host>