Mercurial > hg > tomcat-userconfig
view dist/README @ 19:d3495301ca01
Fix appsPerUser limit.
| author | Mikhail Kryshen <mikhail@kryshen.net> |
|---|---|
| date | Tue, 03 Nov 2009 04:04:45 +0300 |
| parents | 1915c9c69129 |
| children |
line source
1 = Description =
3 Tomcat event listener to automatically deploy update and undeploy
4 applications from user home directories.
6 This is a rewrite of org.apache.catalina.startup.UserConfig listener
7 included in Tomcat which adds the following features:
8 - multiple web applications for each user,
9 - automatic application deployment,
10 - on UNIX read network user database using getent command.
12 = Installation =
14 Copy userconfig.jar to Tomcat lib directory. Add Listener to the Host
15 element in the Tomcat configuration file (server.xml).
17 Listener that uses passwd database to list users:
18 <Listener className="kryshen.catalina.userconfig.PasswdUserConfig"/>
20 Listener that considers all home directories in the specified base
21 directory:
22 <Listener className="kryshen.catalina.userconfig.HomesUserConfig"/>
24 = Listener properties =
26 Common:
28 directoryName - base directory for web applications inside user's
29 home directory. Default: "public_webapps".
31 appsPerUser - maximum number of application each user is allowed to
32 deploy. Default: -1 (unlimited).
34 PasswdUserConfig:
36 passwd - path to local passwd file. Default: "/etc/passwd".
38 getent - path to getent program. Local passwd is used if this is not
39 set. Default: not set (null).
41 HomesUserConfig
43 homeBase - base directory for user homes. Default: "/home".
45 = Example =
47 <Host name="localhost" appBase="webapps"
48 unpackWARs="true" autoDeploy="true"
49 xmlValidation="false" xmlNamespaceAware="false"
50 backgroundProcessorDelay="15">
52 <Listener className="kryshen.catalina.userconfig.PasswdUserConfig"
53 getent="/usr/bin/getent" appsPerUser="5"/>
54 </Host>