File: README.debian

package info (click to toggle)
sympa 5.2.3-1.2%2Betch1
  • links: PTS
  • area: main
  • in suites: etch
  • size: 21,384 kB
  • ctags: 3,566
  • sloc: perl: 27,368; sh: 3,990; makefile: 1,366; ansic: 226; php: 105; lisp: 32
file content (192 lines) | stat: -rw-r--r-- 7,194 bytes parent folder | download | duplicates (4)
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
sympa for Debian
----------------

-- Debian-specific Changes

The defaults for the subscribe and unsubscribe parameters in the list
creation templates have been changed from open to auth where applicable.
That is a more sane default and allowed me to enable the installation
of the subscribe alias by default.

Stefan Hornburg (Racke) <racke@linuxia.de>  Wed, 30 Apr 2003 13:33:30 +0200

-- Updating informations

With version 3.3.1, mailing lists configurations have been moved
to /var/lib/sympa as well as web archives and X509 certificates
Everything is set up for those locations if you never installed
sympa before.

With version 3.1.1, sympa and sympa-db were merged together into
sympa, for upgrade reasons.

With version 3.0, the package was deeply reorganized. There are now
three different packages:
 - sympa which contains the base configuration
 - sympa-db which provides a database support to Sympa
 - wwsympa which contains WWSympa, a mailing list administration
   Web interface

With version 2.6, sympa needs a cookie parameter in sympa.conf, i'm
automatically generating a /etc/sympa/cookie file for this purpose and the
default sympa configuration file reads the cookie from this file.

With version 2.5 there has been some major changements. All the files in
/etc/sympa/config are useless now. They have been replaced by templates
files. You'll find default templates in /usr/lib/sympa/templates and
you can override those files by putting your own templates in
/etc/sympa/templates. This does also apply to scenari, you can put
your own scenari in /etc/sympa/scenari. The sympa.conf file has also been
considerably modified, make sure you updated your config file. You
have to remove the lists* and help* entries. And you have to add the etc
entry which tells sympa where to look for site-specific configuration.
Make also sure that you have a listmaster entry.

With version 2.2.4 of the package some files have been renamed, the
postinst script will rename them automatically.

With version 1.5.1 of the package some binaries have moved, some symlinks
may be created if needed (notably for /usr/lib/sympa/bin/queue).


-- Configuring new features from Sympa 3.3

  . Virtual Robots
    Sympa allow that you create virtual domains which are similar to
    Apache Virtual Hosts.

    In order to set up a given virtual domain, say `my.domain.org',
    - create a directory called /etc/sympa/my.domain.org,
    - create a file named `robot.conf' in that directory.
      You can grab an example of a robot.conf file from
      /usr/share/doc/sympa/examples/config.

    See section 9 of the user manual for more details.

  . LDAP
    Configuring Sympa for LDAP requires that you create and configure
    a file called /etc/sympa/auth.conf. You can grab an example of 
    a auth.conf file from /usr/share/doc/sympa/examples/config.

    See section 7 of the user manual for further details.


-- Managing your aliases with alias_manager(.pl)

  Instead of configuring mail aliases in the main alias file /etc/mail/aliases,
  you can chose to use a dedicated alias file for Sympa mailing list aliases.

  alias_manager is a script which aims to help you in managing mailing lists
  aliases. It is preconfigured for storing aliases in /etc/mail/sympa.aliases.
  Please note that you have to configure your MTA if you want it to take into
  account this dedicated alias file.

  Further details can be found in alias_manager manpage.


-- How to reconfigure Sympa?

All Sympa configuration files are located in /etc/sympa.

Note that some files have a `.in' extension. These are package specific
configuration files. These may contain both
 - pre-configured variables. These variables must be modified by hand
 - template variables whose values will be automatically replaced by the
   Debian Configuration frontend. These variables are surrounded with `@'
   and must not be modified by hand.

Here are package configuration files discribed for all packages.

sympa
-----
  sympa.conf
    This is the only configuration file for Sympa.
    You can directly modify parameters and add optional variables as they
    will dynamically be taken into account by sympa.

    Database configuration must not be modify by hand. If you want to
    configure Sympa for using a database or if you want to modify
    the database configuration, please reconfigure sympa with:

      dpkg-reconfigure --priority=low sympa

  sympa.conf-smine.in
    S/MIME specific parameters must be configured through this file.
    You can only modify pre-configured variables: template variables must
    not be modified. Once you want sympa to be reconfigured, please run

      dpkg-reconfigure --priority=low sympa

wwsympa
------- 
 WWSympa does configure itself through the wwsympa.conf file. However, this
 file does not exist in the package since it is automatically generated
 by the means of the following files:

 wwsympa.conf
   This file is the configuration file for WWSympa.
   You can directly modify parameters and add optional variables as they
   will dynamically be taken into account by wwsympa.

 httpd.conf-fcgi
   This file contains the WWSympa specific FastCGI configuration for Apache.
   If you want to change this configuration, you will have to edit this file.
   Do not modify httpd.conf directly.

   FastCGI configuration
     One of the parameters you may have to change is the number of FastCGI
   processes you want to run at a time: the more processes you run, the
   fastest will be CGI responses.
   This parameter can be changed in the following line:

     FastCgiServer /usr/lib/cgi-bin/sympa/wwsympa.fcgi -processes <nb-processes>

 httpd.conf-cgi
   This file contains the WWSympa specific CGI configuration (basic configuration)
   for Apache.
   If you want to change this configuration, you will have to edit this file.
   Do not modify httpd.conf directly.

 Once you want reconfigure WWSympa with one of those modifications, please run
 
   dpkg-reconfigure --priority=low wwsympa


-- Making Sympa work with PostgreSQL

In order to make Sympa work with Postgresql and ident authentication, you
need the following:

in /etc/postgres/pg_hba.conf:

local  sympa  ident sympa

in /etc/postgres/pg_ident.conf:

sympa     root     root
sympa     root     postgres
sympa     postgres postgres
sympa     sympa    sympa

This gives the required access to the database to the relevant users.


-- Comments regarding the Package

There's a French speaking mailing-list called sympa-fr@cru.fr,  
you can subscribe to it by sending a message with this line in the body
"SUB sympa-fr First_Name Family_Name" to sympa@cru.fr.

There's also an english-speaking mailing-list called sympa-users@cru.fr,
you can subscribe to it by sending a message with this line
in the body "SUB sympa-users First_Name Family_Name" to sympa@cru.fr.

The sympa web page is : http://listes.cru.fr/sympa/

Any translation of documentation should be sent to me in order
to include it to the package, you can also send me others
messages catalogs for sympa. I'll forward them to the upstream
author if they weren't already.

Jerome Marant <jerome@debian.org>, Fri,  7 Aug 1998 21:53:43 +0200