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.
Most configuration parameters can be define for each robot except general Sympa installation parameters (binary and spool location, smtp engine, antivirus plugging,...).
The Virtual robot name as defined in Sympa documentation and configuration file refers to the Internet domaine of the Virtual robot.
You don't need to install several Sympa server. A single sympa.pl deamon and one or more fastcgi servers can serve all virtual robot. Just configure the server environment in order to accept the new domain definition.
Examples:
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>
A robot is named by its domain, let's say my.domain.organd defined by a directory ~sympa/etc/my.domain.org. This directory must contain at least a robot.conf file. This files has the same format as /etc/sympa.conf (have a look at robot.conf in the sample dir). Only the following parameters can be redefined for a particular robot :
These settings overwrite the equivalent global parameter as defined in /etc/sympa.conf for my.domain.orgrobot ; the main listmaster 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.
If needed, you can customize each virtual robot using its set of templates and scenario.
~sympa/etc/my.domain.org/wws_templates/, ~sympa/etc/my.domain.org/templates/, ~sympa/etc/my.domain.org/scenari/ directories are searched when loading templates or scenari before searching into ~sympa/etc and ~sympa/bin/etc. This allows to define different privileges and a different GUI for a Virtual Robot.