|
27
|
1 = Description =
|
|
|
2
|
|
|
3 Host lifecycle event listener for Apache Tomcat to automatically
|
|
|
4 deploy update and undeploy applications from user home directories.
|
|
|
5
|
|
|
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.
|
|
|
11
|
|
|
12 = Installation =
|
|
|
13
|
|
|
14 Copy userconfig.jar to Tomcat lib directory. Add Listener to the Host
|
|
|
15 element in the Tomcat configuration file (server.xml).
|
|
|
16
|
|
|
17 Listener that uses passwd database to list users:
|
|
|
18 <Listener className="kryshen.catalina.userconfig.PasswdUserConfig"/>
|
|
|
19
|
|
|
20 Listener that considers all home directories in the specified base
|
|
|
21 directory:
|
|
|
22 <Listener className="kryshen.catalina.userconfig.HomesUserConfig"/>
|
|
|
23
|
|
|
24 = Listener properties =
|
|
|
25
|
|
|
26 Common:
|
|
|
27
|
|
|
28 directoryName - base directory for web applications inside user's
|
|
|
29 home directory. Default: "public_webapps".
|
|
|
30
|
|
|
31 appsPerUser - maximum number of application each user is allowed to
|
|
|
32 deploy. Default: -1 (unlimited).
|
|
|
33
|
|
|
34 PasswdUserConfig:
|
|
|
35
|
|
|
36 passwd - path to local passwd file. Default: "/etc/passwd".
|
|
|
37
|
|
|
38 getent - path to getent program. Local passwd is used if this is not
|
|
|
39 set. Default: not set (null).
|
|
|
40
|
|
|
41 HomesUserConfig
|
|
|
42
|
|
|
43 homeBase - base directory for user homes. Default: "/home".
|
|
|
44
|
|
|
45 = Example =
|
|
|
46
|
|
|
47 <Host name="localhost" appBase="webapps"
|
|
|
48 unpackWARs="true" autoDeploy="true"
|
|
|
49 xmlValidation="false" xmlNamespaceAware="false"
|
|
|
50 backgroundProcessorDelay="15">
|
|
|
51
|
|
|
52 <Listener className="kryshen.catalina.userconfig.PasswdUserConfig"
|
|
|
53 getent="/usr/bin/getent" appsPerUser="5"/>
|
|
|
54 </Host>
|
