2006-04-29 10:59:37 +02:00
|
|
|
How to use ezmlm-web with debian
|
|
|
|
|
|
|
|
|
|
Table of content
|
|
|
|
|
1 - install the package
|
|
|
|
|
2 - install required additional software
|
|
|
|
|
3 - create user-sprecific suid binaries
|
|
|
|
|
4 - create a user-specific configuration
|
2006-04-30 10:06:21 +02:00
|
|
|
5 - enable stylesheet
|
2006-04-29 10:59:37 +02:00
|
|
|
5 - access control
|
|
|
|
|
6 - testing
|
|
|
|
|
|
|
|
|
|
#################################################################
|
|
|
|
|
|
|
|
|
|
1) install the package
|
2006-04-30 10:06:21 +02:00
|
|
|
you surely did this already :)
|
2006-04-29 10:59:37 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
2) install required additional software
|
2006-04-30 10:06:21 +02:00
|
|
|
clearsilver perl bindings:
|
|
|
|
|
* download clearsilver (http://clearsilver.net) v0.10.2 or higher
|
|
|
|
|
* compile and install it with perl enabled
|
2006-04-29 10:59:37 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
3) create user-specific suid binaries
|
2006-04-30 10:06:21 +02:00
|
|
|
As perl-suid is considered deprecated, you have to compile a C-wrapper
|
|
|
|
|
for every user of your debian system, who wants to manage his mailing
|
|
|
|
|
lists with ezmlm-we.
|
|
|
|
|
Usually you do this only for your virtual mailing list user.
|
2006-04-29 10:59:37 +02:00
|
|
|
|
2006-04-30 10:06:21 +02:00
|
|
|
to create a wrapper, type the following:
|
|
|
|
|
ezmlm-web-make-suid USERNAME DESTINATION_FILE
|
2006-04-29 10:59:37 +02:00
|
|
|
|
2006-04-30 10:06:21 +02:00
|
|
|
e.g: ezmlm-web-make-suid john ~john/public_html/cgi-bin/ezmlm-web
|
2006-04-29 10:59:37 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
4) create a user-specific configuration file (optional)
|
2006-04-30 10:06:21 +02:00
|
|
|
Copy /usr/share/doc/ezmlm-web/examples/ezmlmwebrc to ~john/.ezmlmwebrc
|
|
|
|
|
and change its content according to your setup.
|
2006-04-29 10:59:37 +02:00
|
|
|
|
|
|
|
|
|
2006-04-30 10:06:21 +02:00
|
|
|
5) enable the stylesheet
|
|
|
|
|
Copy the stylesheet file (/usr/share/ezmlm-web/css/default.css)
|
|
|
|
|
to a location of your choice. It has to be accessible by an URL - maybe
|
|
|
|
|
a place like "/var/www/ezmlm-web.css" could be appropriate.
|
|
|
|
|
Now you may have to change the "HTML_CSS_FILE" setting in your
|
|
|
|
|
ezmlmwebrc file. This value is a URL - not the local filename.
|
2006-04-29 10:59:37 +02:00
|
|
|
|
|
|
|
|
|
2006-04-30 10:06:21 +02:00
|
|
|
6) access control (optional)
|
|
|
|
|
Configure access control for the fresh cgi binary. Maybe you can
|
|
|
|
|
use the htaccess.sample file in /usr/share/doc/ezmlm-web/examples as
|
|
|
|
|
a template.
|
2006-04-29 10:59:37 +02:00
|
|
|
|
2006-04-30 10:06:21 +02:00
|
|
|
Now you should create a webusers file to define the permissions of all
|
|
|
|
|
possible web users. An example webusers file can be found at
|
|
|
|
|
/usr/share/doc/ezmlm-web/examples/webusers.sample.
|
|
|
|
|
|
|
|
|
|
See /usr/share/doc/ezmlm-web/README for details about access control.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
7) testing
|
|
|
|
|
Now you can access the ezmlm-web interface by using your web browser.
|
|
|
|
|
e.g. point it to http://localhost/~john/cgi-bin/ezmlm-web
|
|
|
|
|
If the web interface looks not as colorful as you expected, then you
|
|
|
|
|
may have to revisit your stylesheet setting (HTML_CSS_FILE in ezmlmwebrc).
|
2006-04-29 10:59:37 +02:00
|
|
|
|
