1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<!--Converted with jLaTeX2HTML 2002 (1.62) JA patch-1.4
patched version by: Kenshi Muto, Debian Project.
LaTeX2HTML 2002 (1.62),
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>11. Virtual robot</TITLE>
<META NAME="description" CONTENT="11. Virtual robot">
<META NAME="keywords" CONTENT="sympa">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="Generator" CONTENT="jLaTeX2HTML v2002 JA patch-1.4">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="sympa.css">
<LINK REL="next" HREF="node13.html">
<LINK REL="previous" HREF="node11.html">
<LINK REL="up" HREF="sympa.html">
<LINK REL="next" HREF="node13.html">
</HEAD>
<BODY TEXT="#000000" BGCOLOR="#ffffff">
<!--Navigation Panel-->
<A NAME="tex2html949"
HREF="node13.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html943"
HREF="sympa.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html937"
HREF="node11.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<A NAME="tex2html945"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<A NAME="tex2html947"
HREF="node23.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html950"
HREF="node13.html">12. Customizing Sympa/WWSympa</A>
<B> Up:</B> <A NAME="tex2html944"
HREF="sympa.html">Sympa Mailing Lists Management Software version</A>
<B> Previous:</B> <A NAME="tex2html938"
HREF="node11.html">10. Authorization scenarios</A>
  <B> <A NAME="tex2html946"
HREF="node1.html">Contents</A></B>
  <B> <A NAME="tex2html948"
HREF="node23.html">Index</A></B>
<BR>
<BR>
<!--End of Navigation Panel-->
<!--Table of Child-Links-->
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
<UL>
<LI><A NAME="tex2html951"
HREF="node12.html#SECTION001210000000000000000">11.1 How to create a virtual robot</A>
<LI><A NAME="tex2html952"
HREF="node12.html#SECTION001220000000000000000">11.2 robot.conf</A>
<UL>
<LI><A NAME="tex2html953"
HREF="node12.html#SECTION001221000000000000000">11.2.1 Robot customization</A>
</UL>
<BR>
<LI><A NAME="tex2html954"
HREF="node12.html#SECTION001230000000000000000">11.3 Managing multiple virtual robots</A>
</UL>
<!--End of Table of Child-Links-->
<HR>
<H1><A NAME="SECTION001200000000000000000"></A>
<A NAME="virtual-robot"></A>
<BR>
11. Virtual robot
</H1>
<P>
Sympa is designed to manage multiple distinct mailing list servers on
a single host with a single Sympa installation. Sympa virtual robots
are like Apache virtual hosting. Sympa virtual robot definition includes
a specific email address for the robot itself and its lists and also a virtual
http server. Each robot provides access to a set of lists, each list is
related to only one robot.
<P>
Most configuration parameters can be redefined for each robot except
general Sympa installation parameters (binary and spool location, smtp engine,
antivirus plugging,...).
<P>
The Virtual robot name as defined in <I>Sympa</I> documentation and configuration file refers
to the Internet domaine of the Virtual robot.
<P>
Note that the main limitation of virtual robots in Sympa is that you cannot create
2 lists with the same name (local part) among your virtual robots.
<P>
<H1><A NAME="SECTION001210000000000000000">
11.1 How to create a virtual robot</A>
</H1>
<P>
You don't need to install several Sympa servers. A single <A NAME="6298"></A><TT>sympa.pl</TT> daemon
and one or more fastcgi servers can serve all virtual robot. Just configure the
server environment in order to accept the new domain definition.
<UL>
<LI><B>The DNS</B> must be configured to define a new mail exchanger record (MX)
to route message to your server. A new host (A record) or alias (CNAME) are mandatory
to define the new web server.
</LI>
<LI>Configure your <B>MTA (sendmail, postfix, exim, ...)</B> to accept incoming
messages for the new robot domain. Add mail aliases for the robot :
<P>
<I>Examples (with sendmail):</I> <PRE>
sympa@your.virtual.domain: "| /home/sympa/bin/queue sympa@your.virtual.domain"
listmaster@your.virtual.domain: "| /home/sympa/bin/queue listmaster@your.virtual.domain"
</PRE>
<P>
</LI>
<LI>Define a <B>virtual host in your HTTPD server</B>. The fastcgi servers defined
in the common section of you httpd server can be used by each virtual host. You don't
need to run dedicated fascgi server for each virtual robot.
<P>
<I>Examples:</I> <PRE>
FastCgiServer /home/sympa/bin/wwsympa.fcgi -processes 3 -idle-timeout 120
.....
<VirtualHost 195.215.92.16>
ServerAdmin webmaster@your.virtual.domain
DocumentRoot /var/www/your.virtual.domain
ServerName your.virtual.domain
<Location /wws>
SetHandler fastcgi-script
</Location>
ScriptAlias /wws /home/sympa/bin/wwsympa.fcgi
</VirtualHost>
</PRE>
<P>
</LI>
<LI>Create a <A NAME="6301"></A><TT>robot.conf</TT> for the virtual robot (current web interface does
not provide Virtual robot creation yet).
<P>
</LI>
</UL>
<P>
<H1><A NAME="SECTION001220000000000000000">
11.2 robot.conf</A>
</H1>
A robot is named by its domain, let's say my.domain.organd defined by a directory
<A NAME="6304"></A><TT>/home/sympa/etc/my.domain.org</TT>. This directory must contain at least a
<A NAME="6307"></A><TT>robot.conf</TT> file. This files has the same format as <A NAME="6310"></A><TT>/etc/sympa.conf</TT>
(have a look at robot.conf in the sample dir).
Only the following parameters can be redefined for a particular robot :
<P>
<UL>
<LI><A NAME="6313"></A><TT>http_host</TT>
<BR>
This hostname will be compared with 'SERVER_NAME' environment variable in wwsympa.fcgi
to determine the current Virtual Robot. You can a path at the end of this parameter if
you are running multiple Virtual robots on the same host.
<PRE>Examples: \\
http_host myhost.mydom
http_host myhost.mydom/sympa
</PRE>
<P>
</LI>
<LI><A NAME="6316"></A><TT>wwsympa_url</TT>
<BR>
The base URL of WWSympa
<P>
</LI>
<LI><A NAME="6319"></A><TT>soap_url</TT>
<BR>
The base URL of Sympa's SOAP server (if it is running ; see <A HREF="node9.html#soap">8</A>, page <A HREF="node9.html#soap"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>)
<P>
</LI>
<LI><A NAME="6322"></A><TT>cookie_domain</TT>
<P>
</LI>
<LI><A NAME="6325"></A><TT>email</TT>
<P>
</LI>
<LI><A NAME="6328"></A><TT>title</TT>
<P>
</LI>
<LI><A NAME="6331"></A><TT>default_home</TT>
<P>
</LI>
<LI><A NAME="6334"></A><TT>create_list</TT>
<P>
</LI>
<LI><A NAME="6337"></A><TT>lang</TT>
<P>
</LI>
<LI><A NAME="6340"></A><TT>log_smtp</TT>
<P>
</LI>
<LI><A NAME="6343"></A><TT>listmaster</TT>
<P>
</LI>
<LI><A NAME="6346"></A><TT>max_size</TT>
<P>
</LI>
<LI><A NAME="6349"></A><TT>dark_color</TT>, <A NAME="6352"></A><TT>light_color</TT>, <A NAME="6355"></A><TT>text_color</TT>, <A NAME="6358"></A><TT>bg_color</TT>, <A NAME="6361"></A><TT>error_color</TT>, <A NAME="6364"></A><TT>selected_color</TT>, <A NAME="6367"></A><TT>shaded_color</TT>
</LI>
</UL>
<P>
These settings overwrite the equivalent global parameter defined in <A NAME="6370"></A><TT>/etc/sympa.conf</TT>
for my.domain.orgrobot ; the main <A NAME="6373"></A><TT>listmaster</TT> still has privileges on Virtual
Robots though. The http_host parameter is compared by wwsympa with the SERVER_NAME
environment variable to recognize which robot is in used.
<P>
<H2><A NAME="SECTION001221000000000000000">
11.2.1 Robot customization</A>
</H2>
<P>
If needed, you can customize each virtual robot using its set of templates and authorization scenarios.
<P>
<A NAME="6376"></A><TT>/home/sympa/etc/my.domain.org/wws_templates/</TT>,
<A NAME="6379"></A><TT>/home/sympa/etc/my.domain.org/templates/</TT>,
<A NAME="6382"></A><TT>/home/sympa/etc/my.domain.org/scenari/</TT> directories are searched when
loading templates or scenari before searching into <A NAME="6385"></A><TT>/home/sympa/etc</TT> and <A NAME="6388"></A><TT>/home/sympa/bin/etc</TT>. This allows to define different privileges and a different GUI for a Virtual Robot.
<P>
<H1><A NAME="SECTION001230000000000000000">
11.3 Managing multiple virtual robots</A>
</H1>
<P>
If you are managing more than 2 virtual robots, then you might cinsider moving all the mailing lists in the default
robot to a dedicated virtual robot located in the <A NAME="6391"></A><TT>/home/sympa/expl/my.domain.org/</TT> directory. The main benefit of
this organisation is the ability to define default configuration elements (templates or authorization scenarios)
for this robot without inheriting them within other virtual robots.
<P>
To create such a virtual robot, you need to create <A NAME="6394"></A><TT>/home/sympa/expl/my.domain.org/</TT> and <A NAME="6397"></A><TT>/home/sympa/etc/my.domain.org/</TT> directories ;
customize <A NAME="6400"></A><TT>host</TT>, <A NAME="6403"></A><TT>http_host</TT> and <A NAME="6406"></A><TT>wwsympa_url</TT> parameters in the <A NAME="6409"></A><TT>/home/sympa/etc/my.domain.org/robot.conf</TT>
with the same values as the default robot (as defined in <A NAME="6412"></A><TT>sympa.conf</TT> and <A NAME="6415"></A><TT>wwsympa.conf</TT> files).
<P>
<HR>
<!--Navigation Panel-->
<A NAME="tex2html949"
HREF="node13.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html943"
HREF="sympa.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html937"
HREF="node11.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<A NAME="tex2html945"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<A NAME="tex2html947"
HREF="node23.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html950"
HREF="node13.html">12. Customizing Sympa/WWSympa</A>
<B> Up:</B> <A NAME="tex2html944"
HREF="sympa.html">Sympa Mailing Lists Management Software version</A>
<B> Previous:</B> <A NAME="tex2html938"
HREF="node11.html">10. Authorization scenarios</A>
  <B> <A NAME="tex2html946"
HREF="node1.html">Contents</A></B>
  <B> <A NAME="tex2html948"
HREF="node23.html">Index</A></B>
<!--End of Navigation Panel-->
<ADDRESS>
root
2004-09-10
</ADDRESS>
</BODY>
</HTML>
|
