Attachment #124734 for bug #106301

View | Details | Raw Unified | Return to bug 106301 | Differences between
Collapse All | Expand All




<author title="Editor">
  <mail link="seather@scygro.za.net">Scygro</mail>
</author>
<author title="Editor">
  <mail link="swift@gentoo.org">Sven Vermeulen</mail>
</author>

<abstract>
This document details how to create a virtual mailhosting system based upon
postfix, mysql, courier-imap, and cyrus-sasl.
</abstract>

<version>1.3</version>
<date>2007-07-11</date>

<!--
Contents

</p>

<impo>
This howto was written for postfix-2.0.x. If you are using postfix &lt; 2 some
of the variables in this document will be different. It is recommended that you
upgrade. Some other packages included in this howto are version sensitive as
well. You are advised to read the documentation included with packages if you
run into issues with this.
</impo>

<impo>
This document uses apache-1.3.x. Apache-2 has been marked stable in portage.
However there are still a number of issues with php integration. Until php
support in apache-2.0.x is marked stable, this guide will continue to use the
1.3.x version.
</impo>

<impo>
You need a domain name to run a public mail server, or at least an MX record
for a domain. Ideally you would have control of at least two domains to take
advantage of your new virtual domain functionality.


<p>
Start up your favorite mail client and verify that all connections you've
started work for receiving and sending mail. Of course, you wont be able to log
on to any of the services because authentication hasn't been configured yet, but
it is wise to check if the connections themselves work or not.
</p>

<p>
Now that the basics work, we're
going to do a whole bunch of stuff at once to get the rest of the system
running. Again, please verify that what we've installed already works before
progressing.

<comment>(If the variables are not already present, just add them in a sensible place.)</comment>

# <i>cd misc</i>
# <i>./CA.pl -newreq-nodes</i>
<comment>(We need to add -nodes to the # create a certificate and
#create a certificate request code in order to let our new ssl
certs be loaded without a password. Otherwise when you
reboot your ssl certs will not be available.)</comment>

# create a certificate
system ("$REQ -new -nodes -x509 -keyout newreq.pem -out newreq.pem $DAYS");

# create a certificate request
system ("$REQ -new -nodes -keyout newreq.pem -out newreq.pem $DAYS");
		
# <i>./CA.pl -newca</i>
# <i>./CA.pl -newreq</i>
# <i>./CA.pl -sign</i>
# <i>cp newcert.pem /etc/postfix</i>
# <i>cp newreq.pem /etc/postfix</i>

</p>

<pre caption="Setting up apache and phpmyadmin">
# <i>emerge apache phpmyadmin</i>
</pre>

<p>
There are plenty of guides out there about how to set up apache with php,
including guides provided by the <uri link="/proj/en/php/">Gentoo PHP 
Project</uri>. There are also numerous posts on
<uri>http://forums.gentoo.org</uri> detailing how to solve problems with the
installation. So, that said, we're not going to cover it here.
Set up the apache and php installs, then continue
with this howto. Now, a word for the wise: .htaccess the directory that you put
phpmyadmin in. If you do not do this, search engine spiders will come along and
index the page which in turn will mean that anyone will be able to find your

</ul>

<pre caption="Install Apache SSL certificates">
# <i>cp /etc/ssl/misc/new.cert.cert /etc/apache2/ssl/</i>
# <i>cp /etc/ssl/misc/new.cert.key /etc/apache2/ssl/</i>
# <i>cd /etc/apache2/vhosts.d</i>
<comment>(Check if you have an ssl-vhost template already. 
 Copy that one instead of the default_vhost if that is the case)</comment>
# <i>cp 00_default_vhost.conf ssl-vhost.conf</i>
# <i>nano -w ssl-vhost.conf</i>

<comment>(Change the following parameters)</comment>
NameVirtualHost host.domain.name:443

&lt;VirtualHost host.domain.name:443&gt;
  ServerName host.domain.name
  ServerAdmin your@email.address

  DocumentRoot "/var/www/localhost/htdocs/phpmyadmin";
  &lt;Directory "/var/www/localhost/htdocs/phpmyadmin"&gt;
    ...
  &lt;/Directory&gt;

  SSLCertificateFile /etc/apache2/ssl/new.cert.cert
  SSLCertificateKeyFile /etc/apache2/ssl/new.cert.key
  SSLEngine on
  ...
&lt;/VirtualHost&gt;

# <i>nano -w /etc/conf.d/apache2</i>
<comment>(Add -D SSL -D PHP5 to the APACHE2_OPTS)</comment>
SSLCertificateFile /etc/apache/conf/ssl/new.cert.cert
SSLCertificateKeyFile /etc/apache/conf/ssl/new.cert.key

# <i>/etc/init.d/apache restart</i>
</pre>

<note>
If you have an existing apache install, you'll likely have to perform a full
server reboot to install your new certificates. Check your logs to verify
apache restarted successfully.
</note>

<p>
Next, configure phpMyAdmin.
</p>

<pre caption="Configuring phpMyAdmin">
# <i>cd /var/www/localhost/htdocs/phpmyadmin</i>
# <i>cp config.sample.inc.php config.inc.php</i>
# <i>nano -w config.inc.php</i>
<comment>(Change the following parameters.)</comment>
$cfg['blowfish_secret'] = 'someverysecretpassphraze';

$cfg['Servers'][$i]['host'] = 'localhost';          // MySQL hostname
$cfg['Servers'][$i]['controluser'] = 'mailsql';     // MySQL control user settings

</p>

<pre caption="Adding the vmail user">
# <i>adduser -d /home/vmail -s /bin/false -m vmail</i>
# <i>uid=`cat /etc/passwd | grep vmail | cut -f 3 -d :`</i>
# <i>groupadd -g $uid vmail</i>
# <i>mkdir /home/vmail</i>
# <i>chown vmail: /home/vmail</i>
</pre>

<p>
So now when you've set up the vmail account. You can create multiple accounts
if you want (to keep some structure in your set of virtual mail accounts). The
user id, group id and home dirs are referenced in the MySQL tables.
haven't gotten around to it yet, as phpmyadmin generally works fine for us.
</p>

</body>


<pre caption="/etc/postfix/mysql-virtual-gid.cf (optional)">
# <i>nano -w /etc/postfix/mysql-virtual-gid.cf</i>
# mysql-virtual-gid.cf

user          	= mailsql
password        = $password


<pre caption="/etc/postfix/main.cf">
# <i>nano -w /etc/postfix/main.cf</i>
<comment>(Ensure that there are no other alias_maps definitions)</comment>
alias_maps = mysql:/etc/postfix/mysql-aliases.cf
relocated_maps = mysql:/etc/postfix/mysql-relocated.cf


local_recipient_maps = $alias_maps $virtual_mailbox_maps unix:passwd.byname

virtual_transport = virtual
<comment>(The domains listed by the mydestination should not be listed in 
 the virtual_mailbox_domains parameter)</comment>
virtual_mailbox_domains = virt-bar.com, $other-virtual-domain.com

virtual_minimum_uid = 1000
<comment>(Substitute $vmail-gid with the GID of the vmail group)</comment>
virtual_gid_maps = static:$vmail-gid
virtual_mailbox_maps = mysql:/etc/postfix/mysql-virtual-maps.cf
virtual_alias_maps = mysql:/etc/postfix/mysql-virtual.cf
<comment>(Substitute $vmail-uid with the UID of the vmail user)</comment>
virtual_uid_maps = static:$vmail-uid
virtual_mailbox_base = /
#virtual_mailbox_limit =

here.
</p>

<p>
One further note, current versions of mailman install to
<path>/usr/local/mailman</path>. If you're like me and wish to change the
default install location, it can be overridden in the ebuild file by changing
the INSTALLDIR variable.
</p>

<pre caption="Install mailman">
# <i>emerge mailman</i>
</pre>

<pre caption="Setting defaults: Mailman/Defaults.py">
# <i> nano -w /usr/local/mailman/Mailman/Defaults.py</i>
<comment>(Change the values below to reflect your primary domain, virtuals will be set next.)</comment>
DEFAULT_EMAIL_HOST = 'domain.com'
DEFAULT_URL_HOST = 'www.domain.com'
</pre>

<pre caption="mailman config: mm_cfg.py">
# <i>nano -w /usr/local/mailman/Mailman/mm_cfg.py</i>
MTA = "Postfix"
POSTFIX_STYLE_VIRTUAL_DOMAINS = ['virt-domain.com', 'virt.domain2.com']	
add_virtualhost('www.virt.domain.com', 'virt.domain.com')


# <i>su mailman</i>
# <i>cd ~</i>
# <i>./bin/newlist test</i>
Enter the email of the person running the list: <i>your@email.address</i>
Initial test password:
Hit enter to continue with test owner notification...
<comment>(Virtual domain lists may be specified with
list@domain.com style list names.)</comment>
# <i>./bin/genaliases</i>
<comment>(Now that your aliases have been generated,
verify that they were added successfully.)</comment>


test-unsubscribe: "|/var/mailman/mail/mailman unsubscribe test"
# STANZA END: test

<comment>(Create the required mailman list)</comment>
# <i>./bin/newlist mailman</i>
# <i>./bin/genaliases</i>

<comment>(Return to the root user)</comment>
# <i>exit</i>

# <i>/etc/init.d/mailman start</i>
# <i>rc-update add mailman default</i>
<comment>(To start mailman at once and on every reboot.)</comment>

<comment>(Read README.POSTFIX.gz for details on this.)</comment>

alias_maps     =
	hash:/usr/local/mailman/data/aliases,
	mysql:/etc/postfix/mysql-aliases.cf

virtual_alias_maps =
	hash:/usr/local/mailman/data/virtual-mailman,
	mysql:/etc/postfix/mysql-virtual.cf
<comment>(This adds mailman alias file support to postfix
You may of course use the mysql tables for this,

</p>

<pre caption="Some services can dump their current config">
# <i>apache2ctl fullstatus</i> (needs lynx installed)
# <i>apache2ctl configtest</i> (checks config sanity)
# <i>postconf -n</i> (will tell you exactly what param's postfix is using)
# <i>/etc/init.d/$service restart</i>
</pre>

# <i>kill -USR1 `ps -C metalog -o pid=`</i>(to turn off metalog buffering)
# <i>nano -w /var/log/mail/current</i>
# <i>cat /var/log/mysql/mysql.log</i>
# <i>tail /var/log/apache2/error_log</i>
</pre>

<p>

Return to bug 106301

Lines 17-30 Link Here

(-)virt-mail-howto.xml.orig (-80 / +76 lines)
17	<author title="Editor">	17	<author title="Editor">
18	<mail link="seather@scygro.za.net">Scygro</mail>	18	<mail link="seather@scygro.za.net">Scygro</mail>
19	</author>	19	</author>
		20	<author title="Editor">
		21	<mail link="swift@gentoo.org">Sven Vermeulen</mail>
		22	</author>
20		23
21	<abstract>	24	<abstract>
22	This document details how to create a virtual mailhosting system based upon	25	This document details how to create a virtual mailhosting system based upon
23	postfix, mysql, courier-imap, and cyrus-sasl.	26	postfix, mysql, courier-imap, and cyrus-sasl.
24	</abstract>	27	</abstract>
25		28
26	<version>1.2</version>	29	<version>1.3</version>
27	<date>2006-09-04</date>	30	<date>2007-07-11</date>
28		31
29	<!--	32	<!--
30	Contents	33	Contents
Lines 101-121 Link Here
101	</p>	104	</p>
102		105
103	<impo>	106	<impo>
104	This howto was written for postfix-2.0.x. If you are using postfix < 2 some
105	of the variables in this document will be different. It is recommended that you
106	upgrade. Some other packages included in this howto are version sensitive as
107	well. You are advised to read the documentation included with packages if you
108	run into issues with this.
109	</impo>
110
111	<impo>
112	This document uses apache-1.3.x. Apache-2 has been marked stable in portage.
113	However there are still a number of issues with php integration. Until php
114	support in apache-2.0.x is marked stable, this guide will continue to use the
115	1.3.x version.
116	</impo>
117
118	<impo>
119	You need a domain name to run a public mail server, or at least an MX record	107	You need a domain name to run a public mail server, or at least an MX record
120	for a domain. Ideally you would have control of at least two domains to take	108	for a domain. Ideally you would have control of at least two domains to take
121	advantage of your new virtual domain functionality.	109	advantage of your new virtual domain functionality.
Lines 248-254 Link Here
248		236
249	<p>	237	<p>
250	Start up your favorite mail client and verify that all connections you've	238	Start up your favorite mail client and verify that all connections you've
251	started work for receiving and sending mail. Now that the basics work, we're	239	started work for receiving and sending mail. Of course, you wont be able to log
		240	on to any of the services because authentication hasn't been configured yet, but
		241	it is wise to check if the connections themselves work or not.
		242	</p>
		243
		244	<p>
		245	Now that the basics work, we're
252	going to do a whole bunch of stuff at once to get the rest of the system	246	going to do a whole bunch of stuff at once to get the rest of the system
253	running. Again, please verify that what we've installed already works before	247	running. Again, please verify that what we've installed already works before
254	progressing.	248	progressing.
Lines 318-337 Link Here
318	<comment>(If the variables are not already present, just add them in a sensible place.)</comment>	312	<comment>(If the variables are not already present, just add them in a sensible place.)</comment>
319		313
320	# <i>cd misc</i>	314	# <i>cd misc</i>
321	# <i>nano -w CA.pl</i>	315	# <i>./CA.pl -newreq-nodes</i>
322	<comment>(We need to add -nodes to the # create a certificate and
323	#create a certificate request code in order to let our new ssl
324	certs be loaded without a password. Otherwise when you
325	reboot your ssl certs will not be available.)</comment>
326
327	# create a certificate
328	system ("$REQ -new -nodes -x509 -keyout newreq.pem -out newreq.pem $DAYS");
329
330	# create a certificate request
331	system ("$REQ -new -nodes -keyout newreq.pem -out newreq.pem $DAYS");
332
333	# <i>./CA.pl -newca</i>	316	# <i>./CA.pl -newca</i>
334	# <i>./CA.pl -newreq</i>
335	# <i>./CA.pl -sign</i>	317	# <i>./CA.pl -sign</i>
336	# <i>cp newcert.pem /etc/postfix</i>	318	# <i>cp newcert.pem /etc/postfix</i>
337	# <i>cp newreq.pem /etc/postfix</i>	319	# <i>cp newreq.pem /etc/postfix</i>
Lines 541-555 Link Here
541	</p>	523	</p>
542		524
543	<pre caption="Setting up apache and phpmyadmin">	525	<pre caption="Setting up apache and phpmyadmin">
544	# <i>emerge apache mod_php phpmyadmin</i>	526	# <i>emerge apache phpmyadmin</i>
545	</pre>	527	</pre>
546		528
547	<p>	529	<p>
548	There are plenty of guides out there about how to set up apache with php. Like	530	There are plenty of guides out there about how to set up apache with php,
549	this one: <uri>http://www.linuxguruz.com/z.php?id=31</uri>. There are also	531	including guides provided by the <uri link="/proj/en/php/">Gentoo PHP
550	numerous posts on <uri>http://forums.gentoo.org</uri> detailing how to solve	532	Project</uri>. There are also numerous posts on
551	problems with the installation (search for 'apache php'). So, that said, I'm	533	<uri>http://forums.gentoo.org</uri> detailing how to solve problems with the
552	not going to cover it here. Set up the apache and php installs, then continue	534	installation. So, that said, we're not going to cover it here.
		535	Set up the apache and php installs, then continue
553	with this howto. Now, a word for the wise: .htaccess the directory that you put	536	with this howto. Now, a word for the wise: .htaccess the directory that you put
554	phpmyadmin in. If you do not do this, search engine spiders will come along and	537	phpmyadmin in. If you do not do this, search engine spiders will come along and
555	index the page which in turn will mean that anyone will be able to find your	538	index the page which in turn will mean that anyone will be able to find your
Lines 569-601 Link Here
569	</ul>	552	</ul>
570		553
571	<pre caption="Install Apache SSL certificates">	554	<pre caption="Install Apache SSL certificates">
572	# <i>cp /etc/ssl/misc/new.cert.cert /etc/apache/conf/ssl/</i>	555	# <i>cp /etc/ssl/misc/new.cert.cert /etc/apache2/ssl/</i>
573	# <i>cp /etc/ssl/misc/new.cert.key /etc/apache/conf/ssl/</i>	556	# <i>cp /etc/ssl/misc/new.cert.key /etc/apache2/ssl/</i>
574	# <i>nano -w /etc/apache/conf/vhosts/ssl.default-vhost.conf</i>	557	# <i>cd /etc/apache2/vhosts.d</i>
		558	<comment>(Check if you have an ssl-vhost template already.
		559	Copy that one instead of the default_vhost if that is the case)</comment>
		560	# <i>cp 00_default_vhost.conf ssl-vhost.conf</i>
		561	# <i>nano -w ssl-vhost.conf</i>
575		562
576	<comment>(Change the following parameters)</comment>	563	<comment>(Change the following parameters)</comment>
		564	NameVirtualHost host.domain.name:443
		565
		566	<VirtualHost host.domain.name:443>
		567	ServerName host.domain.name
		568	ServerAdmin your@email.address
		569
		570	DocumentRoot "/var/www/localhost/htdocs/phpmyadmin";
		571	<Directory "/var/www/localhost/htdocs/phpmyadmin">
		572	...
		573	</Directory>
		574
		575	SSLCertificateFile /etc/apache2/ssl/new.cert.cert
		576	SSLCertificateKeyFile /etc/apache2/ssl/new.cert.key
		577	SSLEngine on
		578	...
		579	</VirtualHost>
577		580
578	ServerName host.domain.name	581	# <i>nano -w /etc/conf.d/apache2</i>
579	ServerAdmin your@email.address	582	<comment>(Add -D SSL -D PHP5 to the APACHE2_OPTS)</comment>
580	SSLCertificateFile /etc/apache/conf/ssl/new.cert.cert
581	SSLCertificateKeyFile /etc/apache/conf/ssl/new.cert.key
582		583
583	# <i>/etc/init.d/apache restart</i>	584	# <i>/etc/init.d/apache restart</i>
584	</pre>	585	</pre>
585		586
586	<note>
587	If you have an existing apache install, you'll likely have to perform a full
588	server reboot to install your new certificates. Check your logs to verify
589	apache restarted successfully.
590	</note>
591
592	<p>	587	<p>
593	Next, configure phpMyAdmin.	588	Next, configure phpMyAdmin.
594	</p>	589	</p>
595		590
596	<pre caption="Configuring phpMyAdmin">	591	<pre caption="Configuring phpMyAdmin">
597	# <i>nano -w /var/www/localhost/htdocs/phpmyadmin/config.inc.php</i>	592	# <i>cd /var/www/localhost/htdocs/phpmyadmin</i>
		593	# <i>cp config.sample.inc.php config.inc.php</i>
		594	# <i>nano -w config.inc.php</i>
598	<comment>(Change the following parameters.)</comment>	595	<comment>(Change the following parameters.)</comment>
		596	$cfg['blowfish_secret'] = 'someverysecretpassphraze';
599		597
600	$cfg['Servers'][$i]['host'] = 'localhost'; // MySQL hostname	598	$cfg['Servers'][$i]['host'] = 'localhost'; // MySQL hostname
601	$cfg['Servers'][$i]['controluser'] = 'mailsql'; // MySQL control user settings	599	$cfg['Servers'][$i]['controluser'] = 'mailsql'; // MySQL control user settings
Lines 634-651 Link Here
634	</p>	632	</p>
635		633
636	<pre caption="Adding the vmail user">	634	<pre caption="Adding the vmail user">
637	# <i>adduser -d /home/vmail -s /bin/false vmail</i>	635	# <i>adduser -d /home/vmail -s /bin/false -m vmail</i>
638	# <i>uid=`cat /etc/passwd \| grep vmail \| cut -f 3 -d :`</i>
639	# <i>groupadd -g $uid vmail</i>
640	# <i>mkdir /home/vmail</i>
641	# <i>chown vmail: /home/vmail</i>
642	</pre>	636	</pre>
643		637
644	<p>	638	<p>
645	So now when you're setting up vmail accounts, use the vmail uid, gid, and	639	So now when you've set up the vmail account. You can create multiple accounts
646	homedir. When you're setting up local accounts, use that user's uid, gid, and	640	if you want (to keep some structure in your set of virtual mail accounts). The
647	homedir. We've been meaning to create a php admin page for this setup but	641	user id, group id and home dirs are referenced in the MySQL tables.
648	haven't gotten around to it yet, as phpmyadmin generally works fine for us.
649	</p>	642	</p>
650		643
651	</body>	644	</body>
Lines 735-741 Link Here
735		728
736	<pre caption="/etc/postfix/mysql-virtual-gid.cf (optional)">	729	<pre caption="/etc/postfix/mysql-virtual-gid.cf (optional)">
737	# <i>nano -w /etc/postfix/mysql-virtual-gid.cf</i>	730	# <i>nano -w /etc/postfix/mysql-virtual-gid.cf</i>
738	#myql-virtual-gid.cf	731	# mysql-virtual-gid.cf
739		732
740	user = mailsql	733	user = mailsql
741	password = $password	734	password = $password
Lines 794-799 Link Here
794		787
795	<pre caption="/etc/postfix/main.cf">	788	<pre caption="/etc/postfix/main.cf">
796	# <i>nano -w /etc/postfix/main.cf</i>	789	# <i>nano -w /etc/postfix/main.cf</i>
		790	<comment>(Ensure that there are no other alias_maps definitions)</comment>
797	alias_maps = mysql:/etc/postfix/mysql-aliases.cf	791	alias_maps = mysql:/etc/postfix/mysql-aliases.cf
798	relocated_maps = mysql:/etc/postfix/mysql-relocated.cf	792	relocated_maps = mysql:/etc/postfix/mysql-relocated.cf
799		793
Lines 801-814 Link Here
801	local_recipient_maps = $alias_maps $virtual_mailbox_maps unix:passwd.byname	795	local_recipient_maps = $alias_maps $virtual_mailbox_maps unix:passwd.byname
802		796
803	virtual_transport = virtual	797	virtual_transport = virtual
804	virtual_mailbox_domains =	798	<comment>(The domains listed by the mydestination should not be listed in
805	virt-bar.com,	799	the virtual_mailbox_domains parameter)</comment>
806	$other-virtual-domain.com	800	virtual_mailbox_domains = virt-bar.com, $other-virtual-domain.com
807		801
808	virtual_minimum_uid = 1000	802	virtual_minimum_uid = 1000
		803	<comment>(Substitute $vmail-gid with the GID of the vmail group)</comment>
809	virtual_gid_maps = static:$vmail-gid	804	virtual_gid_maps = static:$vmail-gid
810	virtual_mailbox_maps = mysql:/etc/postfix/mysql-virtual-maps.cf	805	virtual_mailbox_maps = mysql:/etc/postfix/mysql-virtual-maps.cf
811	virtual_alias_maps = mysql:/etc/postfix/mysql-virtual.cf	806	virtual_alias_maps = mysql:/etc/postfix/mysql-virtual.cf
		807	<comment>(Substitute $vmail-uid with the UID of the vmail user)</comment>
812	virtual_uid_maps = static:$vmail-uid	808	virtual_uid_maps = static:$vmail-uid
813	virtual_mailbox_base = /	809	virtual_mailbox_base = /
814	#virtual_mailbox_limit =	810	#virtual_mailbox_limit =
Lines 888-913 Link Here
888	here.	884	here.
889	</p>	885	</p>
890		886
891	<p>
892	One further note, current versions of mailman install to
893	<path>/usr/local/mailman</path>. If you're like me and wish to change the
894	default install location, it can be overridden in the ebuild file by changing
895	the INSTALLDIR variable.
896	</p>
897
898	<pre caption="Install mailman">	887	<pre caption="Install mailman">
899	# <i>emerge mailman</i>	888	# <i>emerge mailman</i>
900	</pre>	889	</pre>
901		890
902	<pre caption="Setting defaults: Mailman/Defaults.py">	891	<pre caption="Setting defaults: Mailman/Defaults.py">
903	# <i> nano -w /var/mailman/Mailman/Defaults.py</i>	892	# <i> nano -w /usr/local/mailman/Mailman/Defaults.py</i>
904	<comment>(Change the values below to reflect your primary domain, virtuals will be set next.)</comment>	893	<comment>(Change the values below to reflect your primary domain, virtuals will be set next.)</comment>
905	DEFAULT_EMAIL_HOST = 'domain.com'	894	DEFAULT_EMAIL_HOST = 'domain.com'
906	DEFAULT_URL_HOST = 'www.domain.com'	895	DEFAULT_URL_HOST = 'www.domain.com'
907	</pre>	896	</pre>
908		897
909	<pre caption="mailman config: mm_cfg.py">	898	<pre caption="mailman config: mm_cfg.py">
910	# <i>nano -w /var/mailman/Mailman/mm_cfg.py</i>	899	# <i>nano -w /usr/local/mailman/Mailman/mm_cfg.py</i>
911	MTA = "Postfix"	900	MTA = "Postfix"
912	POSTFIX_STYLE_VIRTUAL_DOMAINS = ['virt-domain.com', 'virt.domain2.com']	901	POSTFIX_STYLE_VIRTUAL_DOMAINS = ['virt-domain.com', 'virt.domain2.com']
913	add_virtualhost('www.virt.domain.com', 'virt.domain.com')	902	add_virtualhost('www.virt.domain.com', 'virt.domain.com')
Lines 920-932 Link Here
920		909
921	# <i>su mailman</i>	910	# <i>su mailman</i>
922	# <i>cd ~</i>	911	# <i>cd ~</i>
923	# <i>bin/newlist test</i>	912	# <i>./bin/newlist test</i>
924	Enter the email of the person running the list: <i>your@email.address</i>	913	Enter the email of the person running the list: <i>your@email.address</i>
925	Initial test password:	914	Initial test password:
926	Hit enter to continue with test owner notification...	915	Hit enter to continue with test owner notification...
927	<comment>(Virtual domain lists may be specified with	916	<comment>(Virtual domain lists may be specified with
928	list@domain.com style list names.)</comment>	917	list@domain.com style list names.)</comment>
929	# <i>bin/genaliases</i>	918	# <i>./bin/genaliases</i>
930	<comment>(Now that your aliases have been generated,	919	<comment>(Now that your aliases have been generated,
931	verify that they were added successfully.)</comment>	920	verify that they were added successfully.)</comment>
932		921
Lines 945-950 Link Here
945	test-unsubscribe: "\|/var/mailman/mail/mailman unsubscribe test"	934	test-unsubscribe: "\|/var/mailman/mail/mailman unsubscribe test"
946	# STANZA END: test	935	# STANZA END: test
947		936
		937	<comment>(Create the required mailman list)</comment>
		938	# <i>./bin/newlist mailman</i>
		939	# <i>./bin/genaliases</i>
		940
		941	<comment>(Return to the root user)</comment>
		942	# <i>exit</i>
		943
948	# <i>/etc/init.d/mailman start</i>	944	# <i>/etc/init.d/mailman start</i>
949	# <i>rc-update add mailman default</i>	945	# <i>rc-update add mailman default</i>
950	<comment>(To start mailman at once and on every reboot.)</comment>	946	<comment>(To start mailman at once and on every reboot.)</comment>
Lines 957-967 Link Here
957	<comment>(Read README.POSTFIX.gz for details on this.)</comment>	953	<comment>(Read README.POSTFIX.gz for details on this.)</comment>
958		954
959	alias_maps =	955	alias_maps =
960	hash:/var/mailman/data/aliases,	956	hash:/usr/local/mailman/data/aliases,
961	mysql:/etc/postfix/mysql-aliases.cf	957	mysql:/etc/postfix/mysql-aliases.cf
962		958
963	virtual_alias_maps =	959	virtual_alias_maps =
964	hash:/var/mailman/data/virtual-mailman,	960	hash:/usr/local/mailman/data/virtual-mailman,
965	mysql:/etc/postfix/mysql-virtual.cf	961	mysql:/etc/postfix/mysql-virtual.cf
966	<comment>(This adds mailman alias file support to postfix	962	<comment>(This adds mailman alias file support to postfix
967	You may of course use the mysql tables for this,	963	You may of course use the mysql tables for this,
Lines 1092-1099 Link Here
1092	</p>	1088	</p>
1093		1089
1094	<pre caption="Some services can dump their current config">	1090	<pre caption="Some services can dump their current config">
1095	# <i>apachectl fullstatus</i> (needs lynx installed)	1091	# <i>apache2ctl fullstatus</i> (needs lynx installed)
1096	# <i>apachectl configtest</i> (checks config sanity)	1092	# <i>apache2ctl configtest</i> (checks config sanity)
1097	# <i>postconf -n</i> (will tell you exactly what param's postfix is using)	1093	# <i>postconf -n</i> (will tell you exactly what param's postfix is using)
1098	# <i>/etc/init.d/$service restart</i>	1094	# <i>/etc/init.d/$service restart</i>
1099	</pre>	1095	</pre>
Lines 1117-1123 Link Here
1117	# <i>kill -USR1 `ps -C metalog -o pid=`</i>(to turn off metalog buffering)	1113	# <i>kill -USR1 `ps -C metalog -o pid=`</i>(to turn off metalog buffering)
1118	# <i>nano -w /var/log/mail/current</i>	1114	# <i>nano -w /var/log/mail/current</i>
1119	# <i>cat /var/log/mysql/mysql.log</i>	1115	# <i>cat /var/log/mysql/mysql.log</i>
1120	# <i>tail /var/log/apache/error_log</i>	1116	# <i>tail /var/log/apache2/error_log</i>
1121	</pre>	1117	</pre>
1122		1118
1123	<p>	1119	<p>