|
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
|
|
28
|
32 deploy. If greater than 1 (multi-app mode) each user's
|
|
|
33 application subdirectory in the base directory is
|
|
|
34 mapped to "/~username/application", "ROOT" is mapped
|
|
|
35 to "/~username". In single-app mode (appsPerUser = 1)
|
|
|
36 the base directory is mapped to "/~username".
|
|
27
|
37
|
|
|
38 PasswdUserConfig:
|
|
|
39
|
|
|
40 passwd - path to local passwd file. Default: "/etc/passwd".
|
|
|
41
|
|
|
42 getent - path to getent program. Local passwd is used if this is not
|
|
|
43 set. Default: not set (null).
|
|
|
44
|
|
|
45 HomesUserConfig
|
|
|
46
|
|
|
47 homeBase - base directory for user homes. Default: "/home".
|
|
|
48
|
|
|
49 = Example =
|
|
|
50
|
|
|
51 <Host name="localhost" appBase="webapps"
|
|
|
52 unpackWARs="true" autoDeploy="true"
|
|
|
53 xmlValidation="false" xmlNamespaceAware="false"
|
|
|
54 backgroundProcessorDelay="15">
|
|
|
55
|
|
|
56 <Listener className="kryshen.catalina.userconfig.PasswdUserConfig"
|
|
|
57 getent="/usr/bin/getent" appsPerUser="5"/>
|
|
|
58 </Host>
|
