lars
70d0ae5d01
README.clearsilver is obsolete adapt ezmlmwebrc.dist to the new HTML_CSS_COMMON setting (renamed from HTML_CSS_FILE) separate style and color settings (CSS) add HTML_CSS_COLOR setting adapted Makefile.PL to the new paths cleaned up the README file prevent uppercase letters in dotqmail filenames
72 lines
2.4 KiB
Text
72 lines
2.4 KiB
Text
How to use ezmlm-web with debian
|
|
|
|
$Id$
|
|
|
|
Table of content
|
|
1 - install the package
|
|
2 - create user-sprecific suid binaries
|
|
3 - create a user-specific configuration
|
|
4 - enable stylesheet
|
|
5 - access control
|
|
6 - testing
|
|
|
|
#################################################################
|
|
|
|
1) install the package
|
|
The debian packages for ezmlm-web are not part of the main
|
|
debian distribution. Instead you have to use the debian repository
|
|
at systemausfall.org. Just add the following line to your
|
|
/etc/apt/sources.list:
|
|
|
|
deb http://systemausfall.org/toolforge/debian testing main contrib non-free
|
|
|
|
Now you may simply execute the following commands:
|
|
apt-get update
|
|
apt-get install ezmlm-web
|
|
|
|
|
|
2) create user-specific suid binaries
|
|
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.
|
|
|
|
to create a wrapper, type the following:
|
|
ezmlm-web-make-suid USERNAME DESTINATION_FILE
|
|
|
|
e.g: ezmlm-web-make-suid john ~john/public_html/cgi-bin/ezmlm-web
|
|
|
|
|
|
3) create a user-specific configuration file (optional)
|
|
Copy /usr/share/doc/ezmlm-web/examples/ezmlmwebrc to ~john/.ezmlmwebrc
|
|
and change its content according to your setup.
|
|
|
|
|
|
4) enable the stylesheet
|
|
Copy the stylesheet files (/usr/share/ezmlm-web/www-data/*) to a location
|
|
of your choice. These files have to be accessible via a URL - maybe a place
|
|
like "/var/www/ezmlm-web-data/" could be appropriate.
|
|
Now you may have to change the "HTML_CSS_COMMON" and "HTML_CSS_COLOR"
|
|
settings in your ezmlmwebrc file. These values are URLs - not local
|
|
filenames.
|
|
|
|
|
|
5) 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.
|
|
|
|
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.
|
|
|
|
|
|
6) 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 does not look like you would expect it, then you
|
|
may have to revise your stylesheet settings (HTML_CSS_COMMON and
|
|
HTML_CSS_COLOR in ezmlmwebrc).
|
|
|