Web-Cyradm on debian Woody.
===========================

Brice GIBOUDEAU 22/03/2003 (v0.1)


1) Packages installation.
-------------------------

Install with 'dselect' this packages.
	postfix-mysql
	apache
	php4
	php4-imap
	php4-mysql
	mysql-server
	libpam-mysql

2) Pam-Mysql configuration.
---------------------------

	a) Edit the file '/etc/pam.d/cyrus'.

<-------------------Cut Here------------------->
# PAM configuration file for Cyrus pwcheck
#
# If you want to use Cyrus in a setup where users don't have
# accounts on the local machine, you'll need to make sure
# you use something like pam_permit for account checking.
#

#auth           required                pam_unix.so nullok
#account        required                pam_unix.so

auth sufficient pam_mysql.so user=login passwd=passwd host=localhost db=admin table=accountuser usercolumn=username passwdcolumn=password crypt=1
auth sufficient pam_unix_auth.so

account required pam_mysql.so user=login passwd=passwd host=localhost db=admin table=accountuser usercolumn=username passwdcolumn=password crypt=1
account  sufficient       pam_unix_acct.so
<-------------------Cut Here------------------->

	b) Configuring 'pwcheck'.

 rm /usr/sbin/pwcheck
 ln -s /usr/sbin/pwcheck_pam /usr/sbin/pwcheck
 /etc/init.d/pwcheck restart

3) Cyrus configuration.
-----------------------

        a) Edit the file '/etc/imapd.conf'

<-------------------Cut Here------------------->
# Debian Cyrus imapd.conf
# See imapd.conf(5) for more information

# Configuration directory
configdirectory: /var/lib/cyrus

# Which partition to use for default mailboxes
defaultpartition: default
partition-default: /var/spool/cyrus/mail

# News setup
partition-news: /var/spool/cyrus/news
newsspool: /var/spool/news

# Uncomment the following and add the space-separated users who
# have admin rights
admins: cyrus

# No anonymous logins
allowanonymouslogin: no

# Minimum time between POP mail fetches in minutes
popminpoll: 1

# umask used by Cyrus programs
umask: 077
<-------------------Cut Here------------------->

4) Mysql Configuration.
-----------------------

	a) To work with postfix you must change the mysql configuration.(Postfix work in chrooted mode).

        mkdir -p /var/spool/postfix/var/run/mysqld
        chown mysql:root /var/spool/postfix/var/run/mysqld
        /etc/init.d/mysql stop
	Modify 'socket' path in '/etc/mysql/my.cnf'
        	-> socket          = /var/spool/postfix/var/run/mysqld/mysqld.sock
        rm /var/run/mysqld
        ln -s /var/spool/postfix/var/run/mysqld /var/run/mysqld
        /etc/init.d/mysql start
	
	b) Now you must configure databases.
	
	mysql -u root -p < /usr/share/webcyradm/scripts/insertuser_mysql.sql
	mysql -u root -p mail < /usr/share/webcyradm/scripts/insertuser_mysql.sql

5) Postfix configuration.
-------------------------

	a) You must create this files.

Sample '/etc/postfix/main.cf'.
<-------------------Cut Here------------------->
command_directory = /usr/sbin
daemon_directory = /usr/lib/postfix
program_directory = /usr/lib/postfix
#
smtpd_banner = $myhostname ESMTP $mail_name (Debian/GNU)
setgid_group = postdrop
biff = no
#
myhostname = server.mydomain.com
mydomain = server.mydomain.com
myorigin = $myhostname
mydestination = $myhostname, $mydomain, localhost.$mydomain
mynetworks = 127.0.0.0/8
#mynetworks = 127.0.0.0/8, hash:/var/lib/pop-before-smtp/hosts
#
mailbox_transport = cyrus
virtual_maps = mysql:/etc/postfix/mysql-virtual.cf
sender_canonical_maps = mysql:/etc/postfix/mysql-canonical.cf
relay_domains = mysql:/etc/postfix/mysql-relay.cf
transport_maps = mysql:/etc/postfix/mysql-transport.cf
#
alias_maps = hash:/etc/aliases
alias_database = hash:/etc/aliases
#
# appending .domain is the MUA's job.
append_dot_mydomain = no
relayhost =
smtpd_client_restrictions = permit_mynetworks
smtpd_sender_restrictions = permit_mynetworks, reject_unknown_sender_domain
smtpd_recipient_restrictions = permit_mynetworks, permit_mx_backup, check_relay_domains
<-------------------Cut Here------------------->

Sample '/etc/postfix/mysql-alias.cf'.
<-------------------Cut Here------------------->
sts = localhost
user = mail
password = mail
dbname = mail
table = alias
select_field = dest
where_field = alias
additional_conditions = and status = '1'
<-------------------Cut Here------------------->

Sample '/etc/postfix/mysql-canonical.cf'.
<-------------------Cut Here------------------->
hosts = localhost
user = mail
password = mail
dbname = mail
table = virtual
select_field = alias
where_field = username
additional_conditions = and status = '1' limit 1
<-------------------Cut Here------------------->

Sample '/etc/postfix/mysql-relay.cf'.
<-------------------Cut Here------------------->
hosts = localhost
user = mail
password = mail
dbname = mail
table = domain
select_field = domain_name
where_field = prefix
<-------------------Cut Here------------------->

Sample '/etc/postfix/mysql-transport.cf'.
<-------------------Cut Here------------------->
hosts = localhost
user = mail
password = mail
dbname = mail
table = domain
select_field = transport
where_field = domain_name
<-------------------Cut Here------------------->

Sample '/etc/postfix/mysql-virtual.cf'.
<-------------------Cut Here------------------->
hosts = localhost
user = mail
password = mail
dbname = mail
table = virtual
select_field = dest
where_field = alias
additional_conditions = and status = '1'
<-------------------Cut Here------------------->

	b) Restart Postfix.

/etc/init.d/postfix stop
/etc/init.d/postfix start

6) Installing webcyradm.
------------------------


 dpkg -i webcyradm_0.5.3-1_all.deb
 You just have to follow the instruction.




That's all, now you can use webcyradm without any compilation.

Brice GIBOUDEAU
brice@pingus.org