Mercurial > hg > tomcat-userconfig

annotate dist/README @ 25:620ec7263ee1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Formatting.
author Mikhail Kryshen <mikhail@kryshen.net>
date Tue, 03 Nov 2009 05:10:39 +0300 (2009-11-03)
parents d3495301ca01
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
17
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
1 = Description =
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
2
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
3 Tomcat event listener to automatically deploy update and undeploy
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
4 applications from user home directories.
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
5
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
6 This is a rewrite of org.apache.catalina.startup.UserConfig listener
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
7 included in Tomcat which adds the following features:
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
8 - multiple web applications for each user,
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
9 - automatic application deployment,
19
d3495301ca01 Fix appsPerUser limit.
Mikhail Kryshen <mikhail@kryshen.net>
parents: 18
diff changeset
10 - on UNIX read network user database using getent command.
17
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
11
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
12 = Installation =
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
13
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
14 Copy userconfig.jar to Tomcat lib directory. Add Listener to the Host
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
15 element in the Tomcat configuration file (server.xml).
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
16
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
17 Listener that uses passwd database to list users:
18
1915c9c69129 Rename package.
Mikhail Kryshen <mikhail@kryshen.net>
parents: 17
diff changeset
18 <Listener className="kryshen.catalina.userconfig.PasswdUserConfig"/>
17
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
19
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
20 Listener that considers all home directories in the specified base
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
21 directory:
18
1915c9c69129 Rename package.
Mikhail Kryshen <mikhail@kryshen.net>
parents: 17
diff changeset
22 <Listener className="kryshen.catalina.userconfig.HomesUserConfig"/>
17
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
23
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
24 = Listener properties =
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
25
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
26 Common:
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
27
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
28 directoryName - base directory for web applications inside user's
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
29 home directory. Default: "public_webapps".
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
30
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
31 appsPerUser - maximum number of application each user is allowed to
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
32 deploy. Default: -1 (unlimited).
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
33
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
34 PasswdUserConfig:
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
35
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
36 passwd - path to local passwd file. Default: "/etc/passwd".
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
37
19
d3495301ca01 Fix appsPerUser limit.
Mikhail Kryshen <mikhail@kryshen.net>
parents: 18
diff changeset
38 getent - path to getent program. Local passwd is used if this is not
d3495301ca01 Fix appsPerUser limit.
Mikhail Kryshen <mikhail@kryshen.net>
parents: 18
diff changeset
39 set. Default: not set (null).
17
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
40
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
41 HomesUserConfig
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
42
012d66bbc61f README. Set default homeBase value.
Mikhail Kryshen <mikhail@kryshen.net>
parents:
diff changeset
43 homeBase - base directory for user homes. Default: "/home".
19
d3495301ca01 Fix appsPerUser limit.
Mikhail Kryshen <mikhail@kryshen.net>
parents: 18
diff changeset
44
d3495301ca01 Fix appsPerUser limit.
Mikhail Kryshen <mikhail@kryshen.net>
parents: 18
diff changeset
45 = Example =
d3495301ca01 Fix appsPerUser limit.
Mikhail Kryshen <mikhail@kryshen.net>
parents: 18
diff changeset
46
d3495301ca01 Fix appsPerUser limit.
Mikhail Kryshen <mikhail@kryshen.net>
parents: 18
diff changeset
47 <Host name="localhost" appBase="webapps"
d3495301ca01 Fix appsPerUser limit.
Mikhail Kryshen <mikhail@kryshen.net>
parents: 18
diff changeset
48 unpackWARs="true" autoDeploy="true"
d3495301ca01 Fix appsPerUser limit.
Mikhail Kryshen <mikhail@kryshen.net>
parents: 18
diff changeset
49 xmlValidation="false" xmlNamespaceAware="false"
d3495301ca01 Fix appsPerUser limit.
Mikhail Kryshen <mikhail@kryshen.net>
parents: 18
diff changeset
50 backgroundProcessorDelay="15">
d3495301ca01 Fix appsPerUser limit.
Mikhail Kryshen <mikhail@kryshen.net>
parents: 18
diff changeset
51
d3495301ca01 Fix appsPerUser limit.
Mikhail Kryshen <mikhail@kryshen.net>
parents: 18
diff changeset
52 <Listener className="kryshen.catalina.userconfig.PasswdUserConfig"
d3495301ca01 Fix appsPerUser limit.
Mikhail Kryshen <mikhail@kryshen.net>
parents: 18
diff changeset
53 getent="/usr/bin/getent" appsPerUser="5"/>
d3495301ca01 Fix appsPerUser limit.
Mikhail Kryshen <mikhail@kryshen.net>
parents: 18
diff changeset
54 </Host>