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
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
|
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2011-03-02 17:28+0500\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):6
msgid "Virtual Mailhosting System with Postfix Guide"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(author:title):8 ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(author:title):11
msgid "Author"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(mail:link):9
msgid "antifa@gentoo.org"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(mail):9
msgid "Ken Nowack"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(mail:link):12
msgid "ezra@revoltltd.org"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(mail):12
msgid "Ezra Gorman"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(author:title):14 ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(author:title):17 ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(author:title):20 ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(author:title):23
msgid "Editor"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(mail:link):15
msgid "klasikahl@gentoo.org"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(mail):15
msgid "Zack Gilburd"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(mail:link):18
msgid "seather@scygro.za.net"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(mail):18
msgid "Scygro"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(mail:link):21
msgid "swift@gentoo.org"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(mail):21
msgid "Sven Vermeulen"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(mail:link):24
msgid "nightmorph"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(abstract):27
msgid "This document details how to create a virtual mailhosting system based upon postfix, mysql, courier-imap, and cyrus-sasl."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(version):32
msgid "3"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(date):33
msgid "2011-03-01"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):36 ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):1020
msgid "Introduction"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):40
msgid "For most Gentoo users, a simple mail client and fetchmail will do. However, if you're hosting a domain with your system, you'll need a full blown MTA (Mail Transfer Agent). And if you're hosting multiple domains, then you'll definitely need something more robust to handle all of the email for your users. This system was designed to be an elegant solution to that problem."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):48
msgid "A virtual mail system needs to be able to handle email for numerous domains with multiple users over a variety of interfaces. This presents some issues that must be dealt with. For instance, what if you have two users on different domains that want the same user name? If you are providing imap access and smtp-auth, how do combine the various authentication daemons into a single system? How do you provide security for the numerous components that comprise the system? How do you manage it all?"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):58
msgid "This howto will show you how to set up with a mail system capable of handling mail for as many domains as your hardware can handle, supports virtual mail users that don't require shell accounts, has domain specific user names, can authenticate web, imap, smtp, and pop3 clients against a single database, utilizes ssl for transport layer security, has a web interface, can handle mailing lists for any domain on the machine, and is controlled by a nice, central and easy mysql database."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):68
msgid "There are quite a variety of ways to go about setting up a virtual mailhosting system. With so may options, another may be the best choice for your specific needs. Consider investigating <uri>http://www.qmail.org/</uri> and <uri>http://www.exim.org/</uri> to explore your options."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):75
msgid "The following packages are used in this setup: apache, courier-imap, courier-authlib postfix, mod_php, phpmyadmin, squirrelmail, cyrus-sasl, mysql, php, and mailman."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):81
msgid "Make sure to turn on the following USE variables in <path>/etc/make.conf</path> before compiling the packages: <c>USE=\"mysql imap libwww maildir sasl ssl\"</c>. Otherwise you will most likely have to recompile things to get the support you need for all the protocols. Further, it's a good idea to turn off any other mail and network variables, like ipv6."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(impo):89
msgid "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."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(impo):95
msgid "Make sure <path>/etc/conf.d/hostname</path> is set to the right hostname for your mail server. You can apply any changes you make to this file by running <c>/etc/init.d/hostname restart</c>. Verify your hostname is set correctly with <c>hostname</c>. Also verify that there are no conflicting entries in <path>/etc/hosts</path>."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(note):103
msgid "It is recommended that you read this entire document and familiarize yourself with all the steps before attempting the install. If you run into problems with any of the steps, check the troubleshooting guide at the end of this document. Also, not all the referenced packages are necessary, this set up is very flexible. For instance, if you do not desire a web interface, feel free to skip the squirrelmail section."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):117
msgid "Postfix Basics"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):121
msgid "Install postfix"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):121
#, no-wrap
msgid "\n# <i>emerge postfix</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(warn):125
msgid "Verify that you have not installed any other MTA, such as ssmtp, exim, or netqmail, or you will surely have BIG problems."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):130
msgid "After postfix is installed, it's time to configure it. Change the following options in <path>/etc/postfix/main.cf</path>. Remember to replace <c>$variables</c> with your own names."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):136 ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):327 ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):782
msgid "/etc/postfix/main.cf"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):136
#, no-wrap
msgid "\nmyhostname = $host.domain.name\nmydomain = $domain.name\ninet_interfaces = all\nmydestination = $myhostname, localhost.$mydomain $mydomain\nmynetworks = my.ip.net.work/24, 127.0.0.0/8\nhome_mailbox = .maildir/\nlocal_destination_concurrency_limit = 2\ndefault_destination_concurrency_limit = 10\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):147
msgid "Next change the following in <path>/etc/postfix/master.cf</path>. This will turn on verbose output for debugging:"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):152
msgid "/etc/postfix/master.cf"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):152
#, no-wrap
msgid "\n# service type private unpriv chroot wakeup maxproc command + args\n# (yes) (yes) (yes) (never) (50)\n#\n==========================================================================\n<comment>(Just add the \"-v\" after the smtpd in the following line)</comment>\nsmtp inet n - n - - smtpd -v\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):161
msgid "Next, edit <path>/etc/mail/aliases</path> to add your local aliases. There should at least be an alias for root like: <c>root: your@email.address</c>."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):166
msgid "Starting postfix for the first time"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):166
#, no-wrap
msgid "\n# <i>/usr/bin/newaliases</i>\n<comment>(This will install the new aliases. You only need to do this\nwhen you update or install aliases.)</comment>\n\n# <i>/etc/init.d/postfix start</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):174
msgid "Now that postfix is running, fire up your favorite console mail client and send yourself an email. I use <c>mutt</c> for all my console mail. Verify that postfix is delivering mail to local users, once that's done, we're on to the next step."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(note):181
msgid "I strongly recommend that you verify this basic postfix setup is functioning before you progress to the next step of the howto."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):191
msgid "Courier-imap"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):195
msgid "Install courier-imap and courier-authlib"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):195
#, no-wrap
msgid "\n# <i>emerge courier-imap courier-authlib</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):199
msgid "Courier-imap configuration"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):199
#, no-wrap
msgid "\n# <i>cd /etc/courier-imap</i>\n<comment>(If you want to use the ssl capabilities of courier-imap or pop3,\nyou'll need to create certs for this purpose.\nThis step is recommended. If you do not want to use ssl, skip this step.)</comment>\n\n# <i>nano -w pop3d.cnf</i>\n# <i>nano -w imapd.cnf</i>\n<comment>(Change the C, ST, L, CN, and email parameters to match your server.)</comment>\n\n# <i>mkpop3dcert</i>\n# <i>mkimapdcert</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):213
msgid "Start the courier services you need."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):213
#, no-wrap
msgid "\n# <i>/etc/init.d/courier-imapd start</i>\n# <i>/etc/init.d/courier-imapd-ssl start</i>\n# <i>/etc/init.d/courier-pop3d start</i>\n# <i>/etc/init.d/courier-pop3d-ssl start</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):220
msgid "Start up your favorite mail client and verify that all connections you've started work for receiving and sending mail. Of course, you won't 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."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):227
msgid "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."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):238
msgid "Cyrus-sasl"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):242
msgid "Next we're going to install cyrus-sasl. Sasl is going to play the role of actually passing your auth variables to courier-auth, which will in turn pass that information to mysql for authentication of smtp users. For this howto, we'll not even try to verify that sasl is working until mysql is set up and contains a test user. Which is fine since we'll be authenticating against mysql in the end anyway."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):251
msgid "Configuring and installing the cyrus-sasl ebuild"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):251
#, no-wrap
msgid "\n# <i>emerge cyrus-sasl</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):255
msgid "Next, edit <path>/etc/sasl2/smtpd.conf</path>."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):259
msgid "Starting sasl"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):259
#, no-wrap
msgid "\n# <i>nano -w /etc/sasl2/smtpd.conf</i>\nmech_list: PLAIN LOGIN\npwcheck_method: saslauthd\n# <i>nano -w /etc/conf.d/saslauthd</i>\nSASLAUTHD_OPTS=\"${SASLAUTH_MECH} -a rimap -r\"\nSASLAUTHD_OPTS=\"${SASLAUTHD_OPTS} -O localhost\"\n# <i>/etc/init.d/saslauthd start</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):274
msgid "SSL Certs for Postfix and Apache"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):278
msgid "Next we're going to make a set of ssl certificates for postfix and apache."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):282
msgid "Making ssl certicates"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):282
#, no-wrap
msgid "\n# <i>cd /etc/ssl/</i>\n# <i>nano -w openssl.cnf</i>\n\n<comment>Change the following default values for your domain:</comment>\ncountryName_default\nstateOrProvinceName_default\nlocalityName_default\n0.organizationName_default\ncommonName_default\nemailAddress_default.\n\n<comment>(If the variables are not already present, just add them in a sensible place.)</comment>\n\n# <i>cd misc</i>\n# <i>./CA.pl -newreq-nodes</i>\n# <i>./CA.pl -newca</i>\n# <i>./CA.pl -sign</i>\n# <i>cp newcert.pem /etc/postfix</i>\n# <i>cp newkey.pem /etc/postfix</i>\n# <i>cp demoCA/cacert.pem /etc/postfix</i>\n<comment>(Now we do the same thing for apache.)</comment>\n\n# <i>openssl req -new > new.cert.csr</i>\n# <i>openssl rsa -in privkey.pem -out new.cert.key</i>\n# <i>openssl x509 -in new.cert.csr -out new.cert.cert -req -signkey new.cert.key -days 365</i>\n<comment>(Just leave the resulting certificates here for now.\nWe'll install them after Apache is installed.)</comment>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):317
msgid "Adding SSL and SASL support to Postfix"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):321
msgid "Now edit the postfix config's to make it aware of your new sasl and ssl capabilities. Add the following parameters to the end of the file where they will be easy to find."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):327
#, no-wrap
msgid "\n# <i>nano -w /etc/postfix/main.cf</i>\n\nsmtpd_sasl_auth_enable = yes\nsmtpd_sasl_security_options = noanonymous\nbroken_sasl_auth_clients = yes\nsmtpd_sasl_local_domain =\n\n<comment>(The broken_sasl_auth_clients option and the login auth method\nare for outlook and outlook express only and are undocumented.\nIsn't having to hack software for stupid, broken, M$ BS great?\nsmtpd_sasl_local_domain appends a domain name to clients using\nsmtp-auth. Make sure it's blank or your user names will get\nmangled by postfix and be unable to auth.)</comment>\n\nsmtpd_recipient_restrictions =\n permit_sasl_authenticated,\n permit_mynetworks,\n reject_unauth_destination\n\n<comment>(The next two options enable outgoing encryption.)</comment>\nsmtp_use_tls = yes\nsmtp_tls_note_starttls_offer = yes\nsmtpd_use_tls = yes\n#smtpd_tls_auth_only = yes\nsmtpd_tls_key_file = /etc/postfix/newkey.pem\nsmtpd_tls_cert_file = /etc/postfix/newcert.pem\nsmtpd_tls_CAfile = /etc/postfix/cacert.pem\nsmtpd_tls_loglevel = 3\nsmtpd_tls_received_header = yes\nsmtpd_tls_session_cache_timeout = 3600s\ntls_random_source = dev:/dev/urandom\n\n<comment>(smtpd_tls_auth_only is commented out to ease testing the system.\nYou can turn this on later if you desire.)</comment>\n\n# <i>postfix reload</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):366
msgid "Now we're going to verify that the config's we added were picked up by postfix. For this we are going to use <c>telnet</c> (provided by for instance <c>net-misc/netkit-telnetd</c>) although you can also use <c>nc</c> (provided by <c>net-analyzer/netcat</c>):"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):373
msgid "Verifying sasl and tls support"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):373
#, no-wrap
msgid "\n# <i>telnet localhost 25</i>\n\nTrying 127.0.0.1...\nConnected to localhost.\nEscape character is '^]'.\n220 mail.domain.com ESMTP Postfix\n<i>EHLO domain.com</i>\n250-mail.domain.com\n250-PIPELINING\n250-SIZE 10240000\n250-VRFY\n250-ETRN\n250-STARTTLS\n250-AUTH LOGIN PLAIN\n250-AUTH=LOGIN PLAIN\n250-XVERP\n250 8BITMIME\n<i>^]</i>\ntelnet> <i>quit</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):395
msgid "Verify that the above AUTH and STARTTLS lines now appear in your postfix install. As I said before, as it stands now AUTH will not work. that's because sasl will try to auth against it's sasldb, instead of the shadow file for some unknown reason, which we have not set up. So we're going to just plow through and set up mysql to hold all of our auth and virtual domain information."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):408
msgid "The vmail user"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):412
msgid "Before we set up our virtual mailhosting environment, we create a functional user under which the virtual mailboxes will be hosted. For clarity's sake we will call this <e>vmail</e>:"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):418
msgid "Adding the vmail user"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):418
#, no-wrap
msgid "\n# <i>useradd -d /home/vmail -s /bin/false -m vmail</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):422
msgid "So now 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."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):428
msgid "Next to the user account we also need to create the location where the mailboxes will reside:"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):433
msgid "Creating mailboxes"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):433
#, no-wrap
msgid "\n# <i>mkdir -p /home/vmail/virt-domain.com/foo</i>\n# <i>chown -R vmail:vmail /home/vmail/virt-domain.com</i>\n# <i>maildirmake /home/vmail/virt-domain.com/foo/.maildir</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):444
msgid "MySQL"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):448
msgid "Next we're going to install and configure MySQL. You'll need the <uri link=\"http://www.gentoo.org/doc/en/files/genericmailsql.sql\">genericmailsql.sql</uri> dumpfile for this step."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):454
msgid "Installing and configuring MySQL"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):454
#, no-wrap
msgid "\n# <i>emerge mysql</i>\n\n# <i>/usr/bin/mysql_install_db</i>\n<comment>(After this command runs follow the onscreen directions\nfor adding a root password with mysql, otherwise your db will\nbe wide open.)</comment>\n\n# <i>/etc/init.d/mysql start</i>\n# <i>mysqladmin -u root -p create mailsql</i>\n# <i>mysql -u root -p mailsql < genericmailsql.sql</i>\n# <i>mysql -u root -p mysql</i>\nmysql> <i>GRANT SELECT,INSERT,UPDATE,DELETE</i>\n -> <i>ON mailsql.*</i>\n -> <i>TO mailsql@localhost</i>\n -> <i>IDENTIFIED BY '$password';</i>\nQuery OK, 0 rows affected (0.02 sec)\n\nmysql> <i>FLUSH PRIVILEGES;</i>\nQuery OK, 0 rows affected (0.00 sec)\n\nmysql> <i>quit</i>\n<comment>(Verify that the new mailsql user can connect to the mysql server.)</comment>\n\n# <i>mysql -u mailsql -p mailsql</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):481
msgid "Your new database has default values and tables set up for two domains. The following tables are included:"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(li):487
msgid "alias - local email alias and mailman alias information."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(li):488
msgid "relocated - relocated user email address maps"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(li):489
msgid "transport - default mail transport information for all domains you are hosting"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(li):493
msgid "users - all user account information"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(li):494
msgid "virtual - virtual domain email alias maps"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):497
msgid "alias table sample"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):497
#, no-wrap
msgid "\nid alias destination\n1 root foo@bar.com\n2 postmaster foo@bar.com\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):503
msgid "user table sample"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):503
#, no-wrap
msgid "\n<comment>(Line wrapped for clarity.)</comment>\nid email clear name uid gid homedir \\\n maildir quota postfix\n10 foo@virt-domain.com $password realname virtid virtid /home/vmail \\\n /home/vmail/virt-domain.com/foo/.maildir/ y\n13 foo@bar.com $password realname localid localid /home/foo \\\n /home/foo/.maildir/ y\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):513
msgid "The values of the <c>virtid</c> uid and gid should be those of the <c>vmail</c> user and group."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):518
msgid "transport table sample"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):518
#, no-wrap
msgid "\nid domain destination\n1 bar.com local:\n2 virt-domain.com virtual:\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):524
msgid "virtual table sample"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):524
#, no-wrap
msgid "\nid email destination\n3 root@virt-domain.com other@email.address\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):534
msgid "Apache and phpMyAdmin"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):538
msgid "Next we'll set up apache and add an interface to interact with the database more easily."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):543
msgid "Setting up apache and phpmyadmin"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):543
#, no-wrap
msgid "\n# <i>emerge apache phpmyadmin</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):547
msgid "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 phpmyadmin page via google and in turn be able to come change your database however they want which is <e>BAD!</e> There are many howtos on this including: <uri>http://www.csoft.net/docs/micro/htaccess.html.en</uri>."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):562
msgid "Now we're going to install the Apache certificates we made previously. The Apache-SSL directives that you need to use the resulting cert are:"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(li):568
msgid "SSLCertificateFile /path/to/certs/new.cert.cert"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(li):569
msgid "SSLCertificateKeyFile /path/to/certs/new.cert.key"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):572
msgid "Install Apache SSL certificates"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):572
#, no-wrap
msgid "\n# <i>cp /etc/ssl/misc/new.cert.cert /etc/apache2/ssl/</i>\n# <i>cp /etc/ssl/misc/new.cert.key /etc/apache2/ssl/</i>\n# <i>cd /etc/apache2/vhosts.d</i>\n<comment>(Check if you have an ssl-vhost template already.\n Copy that one instead of the default_vhost if that is the case)</comment>\n# <i>cp 00_default_vhost.conf ssl-vhost.conf</i>\n# <i>nano -w ssl-vhost.conf</i>\n\n<comment>(Change the following parameters)</comment>\nNameVirtualHost host.domain.name:443\n\n<VirtualHost host.domain.name:443>\n ServerName host.domain.name\n ServerAdmin your@email.address\n\n DocumentRoot \"/var/www/localhost/htdocs/phpmyadmin\";\n <Directory \"/var/www/localhost/htdocs/phpmyadmin\">\n ...\n </Directory>\n\n SSLCertificateFile /etc/apache2/ssl/new.cert.cert\n SSLCertificateKeyFile /etc/apache2/ssl/new.cert.key\n SSLEngine on\n ...\n</VirtualHost>\n\n# <i>nano -w /etc/conf.d/apache2</i>\n<comment>(Add -D SSL -D PHP5 to the APACHE2_OPTS)</comment>\n\n# <i>/etc/init.d/apache2 restart</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):605
msgid "Next, configure phpMyAdmin."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):609
msgid "Configuring phpMyAdmin"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):609
#, no-wrap
msgid "\n# <i>cd /var/www/localhost/htdocs/phpmyadmin</i>\n# <i>cp config.sample.inc.php config.inc.php</i>\n# <i>nano -w config.inc.php</i>\n<comment>(Change the following parameters.)</comment>\n$cfg['blowfish_secret'] = 'someverysecretpassphraze';\n\n$cfg['Servers'][$i]['host'] = 'localhost'; // MySQL hostname\n$cfg['Servers'][$i]['controluser'] = 'mailsql'; // MySQL control user settings\n // (this user must have read-only\n$cfg['Servers'][$i]['controlpass'] = '$password'; // access to the \"mysql/user\"\n // and \"mysql/db\" tables)\n$cfg['Servers'][$i]['user'] = 'mailsql'; // MySQL user\n$cfg['Servers'][$i]['password'] = '$password'; // MySQL password\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):625
msgid "Now enter the phpmyadmin page and browse the tables. You'll want to add in your local aliases, edit your user table to add a test user, and change your transport table to add information about your domains. The default values supplied with the dumpfile should be a sufficient guide to what values need to go where. Make sure that if you put information in the database that it is accurate. For instance, make sure the local user's home dir exists and that the correct uid/gid values are in place. The maildirs should be created automatically by postfix when the user receives their first email. So, in general, it's a good idea to send a \"Welcome\" mail to a new user after you setup their account to make sure the .maildir gets created."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):643
msgid "Configuring MySQL Authentication and vhosts"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):647
msgid "Next we'll reconfigure our authentication to use the mailsql database in courier-imap and postfix. In all of the following examples, replace <c>$password</c> with the password you set for the mailsql mysql user."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):653
msgid "Configuring authentication"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):653
#, no-wrap
msgid "\n# <i>nano -w /etc/courier/authlib/authdaemonrc</i>\nauthmodulelist=\"authmysql authpam\"\n\n# <i>nano -w /etc/courier/authlib/authmysqlrc</i>\nMYSQL_SERVER localhost\nMYSQL_USERNAME mailsql\nMYSQL_PASSWORD $password\nMYSQL_DATABASE mailsql\nMYSQL_USER_TABLE users\n<comment>(Make sure the following line is commented out since we're storing plaintext.)</comment>\n#MYSQL_CRYPT_PWFIELD crypt\nMYSQL_CLEAR_PWFIELD clear\nMYSQL_UID_FIELD uid\nMYSQL_GID_FIELD gid\nMYSQL_LOGIN_FIELD email\nMYSQL_HOME_FIELD homedir\nMYSQL_NAME_FIELD name\nMYSQL_MAILDIR_FIELD maildir\n\n# <i>/etc/init.d/courier-authlib restart</i>\n# <i>/etc/init.d/saslauthd restart</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):677
msgid "We're almost there, I promise! Next, set up the rest of the necessary configs for postfix to interract with the database for all its other transport needs. Remember to replace each value with the name of your own user, user id, password, alias, email address, and so on."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):684
msgid "/etc/postfix/mysql-aliases.cf"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):684
#, no-wrap
msgid "\n# <i>nano -w /etc/postfix/mysql-aliases.cf</i>\n# mysql-aliases.cf\n\nuser = mailsql\npassword = $password\ndbname = mailsql\ntable = alias\nselect_field = destination\nwhere_field = alias\nhosts = unix:/var/run/mysqld/mysqld.sock\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):697
msgid "/etc/postfix/mysql-relocated.cf"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):697
#, no-wrap
msgid "\n# <i>nano -w /etc/postfix/mysql-relocated.cf</i>\n# mysql-relocated.cf\n\nuser = mailsql\npassword = $password\ndbname = mailsql\ntable = relocated\nselect_field = destination\nwhere_field = email\nhosts = unix:/var/run/mysqld/mysqld.sock\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):710
msgid "/etc/postfix/mysql-transport.cf (optional)"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):710
#, no-wrap
msgid "\n# <i>nano -w /etc/postfix/mysql-transport.cf</i>\n# mysql-transport.cf\n\nuser = mailsql\npassword = $password\ndbname = mailsql\ntable = transport\nselect_field = destination\nwhere_field = domain\nhosts = unix:/var/run/mysqld/mysqld.sock\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):723
msgid "/etc/postfix/mysql-virtual-gid.cf (optional)"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):723
#, no-wrap
msgid "\n# <i>nano -w /etc/postfix/mysql-virtual-gid.cf</i>\n# mysql-virtual-gid.cf\n\nuser = mailsql\npassword = $password\ndbname = mailsql\ntable = users\nselect_field = gid\nwhere_field = email\nadditional_conditions = and postfix = 'y'\nhosts = unix:/var/run/mysqld/mysqld.sock\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):737
msgid "/etc/postfix/mysql-virtual-maps.cf"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):737
#, no-wrap
msgid "\n# <i>nano -w /etc/postfix/mysql-virtual-maps.cf</i>\n# mysql-virtual-maps.cf\n\nuser = mailsql\npassword = $password\ndbname = mailsql\ntable = users\nselect_field = maildir\nwhere_field = email\nadditional_conditions = and postfix = 'y'\nhosts = unix:/var/run/mysqld/mysqld.sock\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):751
msgid "/etc/postfix/mysql-virtual-uid.cf (optional)"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):751
#, no-wrap
msgid "\n# <i>nano -w /etc/postfix/mysql-virtual-uid.cf</i>\n# mysql-virtual-uid.cf\n\nuser = mailsql\npassword = $password\ndbname = mailsql\ntable = users\nselect_field = uid\nwhere_field = email\nadditional_conditions = and postfix = 'y'\nhosts = unix:/var/run/mysqld/mysqld.sock\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):765
msgid "/etc/postfix/mysql-virtual.cf"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):765
#, no-wrap
msgid "\n# <i>nano -w /etc/postfix/mysql-virtual.cf</i>\n# mysql-virtual.cf\n\nuser = mailsql\npassword = $password\ndbname = mailsql\ntable = virtual\nselect_field = destination\nwhere_field = email\nhosts = unix:/var/run/mysqld/mysqld.sock\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):778
msgid "Lastly, edit <path>/etc/postfix/main.cf</path> one more time."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):782
#, no-wrap
msgid "\n# <i>nano -w /etc/postfix/main.cf</i>\n<comment>(Ensure that there are no other alias_maps definitions)</comment>\nalias_maps = mysql:/etc/postfix/mysql-aliases.cf\nrelocated_maps = mysql:/etc/postfix/mysql-relocated.cf\n\nlocal_transport = local\nlocal_recipient_maps = $alias_maps $virtual_mailbox_maps unix:passwd.byname\n\nvirtual_transport = virtual\n<comment>(The domains listed by the mydestination should not be listed in\n the virtual_mailbox_domains parameter)</comment>\nvirtual_mailbox_domains = virt-domain.com, $other-virtual-domain.com\n\nvirtual_minimum_uid = 1000\n<comment>(Substitute $vmail-gid with the GID of the vmail group)</comment>\nvirtual_gid_maps = static:$vmail-gid\nvirtual_mailbox_maps = mysql:/etc/postfix/mysql-virtual-maps.cf\nvirtual_alias_maps = mysql:/etc/postfix/mysql-virtual.cf\n<comment>(Substitute $vmail-uid with the UID of the vmail user)</comment>\nvirtual_uid_maps = static:$vmail-uid\nvirtual_mailbox_base = /\n#virtual_mailbox_limit =\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):807
msgid "For security reasons you should change the permissions of the various <path>/etc/mail/mysql-*.cf</path>:"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):812
msgid "Changing file permission"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):812
#, no-wrap
msgid "\n# <i>chmod 640 /etc/postfix/mysql-*.cf</i>\n# <i>chgrp postfix /etc/postfix/mysql-*.cf</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):817
msgid "As of Postfix 2.0.x, there were a number of significant changes over the 1.1.x release. Notably the transport, virtual-gid, and virtual-uid tables are no longer necessary. The tables are still included if you wish to use them."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(note):823
msgid "It is recommended that you read VIRTUAL_README included with the postfix docs for more information."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):828
msgid "Make postfix reload its tables"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):828
#, no-wrap
msgid "\n# <i>postfix reload</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):832
msgid "Now, if all went well, you should have a functioning mailhost. Users should be able to authenticate against the sql database, using their full email address, for pop3, imap, and smtp. I would highly suggest that you verify that everything is working at this point. If you run into problems (with as many things as this setup has going on, it's likely that you will) check the troubleshooting section of this howto."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):846
msgid "Squirrelmail"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):850
msgid "Install squirrelmail"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):850
#, no-wrap
msgid "\n# <i>emerge squirrelmail</i>\n<comment>(Install squirrelmail to localhost so that it's accessed by http://localhost/mail)\n(Substitute 1.4.3a-r2 with the version you use)</comment>\n\n# <i>webapp-config -I -h localhost -d /mail squirrelmail 1.4.3a-r2</i>\n# <i>cd /var/www/localhost/htdocs/mail/config</i>\n# <i>perl ./conf.pl</i>\n<comment>(Change your Organization, Server, and Folder settings for squirrelmail.\nNow you should be able to login to squirrelmail, again - with your full email address,\nand use your new webmail setup.)</comment>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):868
msgid "Mailman"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):872
msgid "Last step: mailman. The new version of mailman has very nice virtual domain support, which is why I use it, not to mention it's really a great package. To get this package installed and working correctly for virtual domains is going to require a bit of hacking. I really recommend reading all of the mailman documentation, including README.POSTFIX.gz, to understand what's being done here."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):881
msgid "Install mailman"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):881
#, no-wrap
msgid "\n# <i>emerge mailman</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):885
msgid "Setting defaults: Mailman/Defaults.py"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):885
#, no-wrap
msgid "\n# <i> nano -w /usr/local/mailman/Mailman/Defaults.py</i>\n<comment>(Change the values below to reflect your primary domain, virtuals will be set next.)</comment>\nDEFAULT_EMAIL_HOST = 'domain.com'\nDEFAULT_URL_HOST = 'www.domain.com'\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):892
msgid "mailman config: mm_cfg.py"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):892
#, no-wrap
msgid "\n# <i>nano -w /usr/local/mailman/Mailman/mm_cfg.py</i>\nMTA = \"Postfix\"\nPOSTFIX_STYLE_VIRTUAL_DOMAINS = ['virt-domain.com', 'virt.domain2.com']\nadd_virtualhost('www.virt.domain.com', 'virt.domain.com')\nadd_virtualhost('www.virt.domain2.com', 'virt.domain2.com')\n<comment>(This is required for your virtual domains for mailman to function.)</comment>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):901
msgid "And last but not least"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):901
#, no-wrap
msgid "\n<comment>(Once that's finished, add your first list.)</comment>\n\n# <i>su mailman</i>\n# <i>cd ~</i>\n# <i>./bin/newlist --urlhost='www.virt-domain.com' --emailhost='virt-domain.com' test</i>\nEnter the email of the person running the list: <i>your@email.address</i>\nInitial test password:\nHit enter to continue with test owner notification...\n<comment>(Virtual domain lists may also be specified with\nlist@domain.com style list names.)</comment>\n# <i>./bin/genaliases</i>\n<comment>(Now that your aliases have been generated,\nverify that they were added successfully.)</comment>\n\n# <i>nano -w data/aliases</i>\n# STANZA START: test\n# CREATED:\ntest: \"|/usr/local/mailman/mail/mailman post test\"\ntest-admin: \"|/usr/local/mailman/mail/mailman admin test\"\ntest-bounces: \"|/usr/local/mailman/mail/mailman bounces test\"\ntest-confirm: \"|/usr/local/mailman/mail/mailman confirm test\"\ntest-join: \"|/usr/local/mailman/mail/mailman join test\"\ntest-leave: \"|/usr/local/mailman/mail/mailman leave test\"\ntest-owner: \"|/usr/local/mailman/mail/mailman owner test\"\ntest-request: \"|/usr/local/mailman/mail/mailman request test\"\ntest-subscribe: \"|/usr/local/mailman/mail/mailman subscribe test\"\ntest-unsubscribe: \"|/usr/local/mailman/mail/mailman unsubscribe test\"\n# STANZA END: test\n\n<comment>(Create the required mailman list)</comment>\n# <i>./bin/newlist mailman</i>\n# <i>./bin/genaliases</i>\n\n<comment>(Return to the root user)</comment>\n# <i>exit</i>\n\n# <i>/etc/init.d/mailman start</i>\n# <i>rc-update add mailman default</i>\n<comment>(To start mailman at once and on every reboot.)</comment>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):943
msgid "Adding mailman alias support to postfix"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):943
#, no-wrap
msgid "\n# <i>nano -w /etc/postfix/main.cf</i>\nowner_request_special = no\nrecipient_delimiter = +\n<comment>(Read README.POSTFIX.gz for details on this.)</comment>\n\nalias_maps =\n hash:/usr/local/mailman/data/aliases,\n mysql:/etc/postfix/mysql-aliases.cf\n\nvirtual_alias_maps =\n hash:/usr/local/mailman/data/virtual-mailman,\n mysql:/etc/postfix/mysql-virtual.cf\n<comment>(This adds mailman alias file support to postfix\nYou may of course use the mysql tables for this,\nbut I hate doing that by hand. Also, if you are not\nusing virtual domains, adding the virtual alias maps\nto postfix may cause problems, be warned.)</comment>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):963
msgid "You should now be able to setup mailing lists for any domain on your box. Last note on this, make sure you run all mailman commands as the user mailman (<c>su mailman</c>) or else the permissions will be wrong and you'll have to fix them. Read the mailman doc's for more information on setting up and managing mailman lists."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):976
msgid "Content Filtering and Anti-Virus"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):980
msgid "For content filtering and Anti-Virus, please consult our <uri link=\"/doc/en/mailfilter-guide.xml\">mail filtering gateway guide</uri>."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):990
msgid "Wrap Up"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):994
msgid "Ok, you're all set, edit <path>/etc/postfix/master.cf</path> and turn off verbose mode for production use. You'll probably also want to add the services to your startup routine to make sure everything comes back up on a reboot. Make sure to add all the services you're using - apache, mysql, saslauthd, postfix, courier-imapd, courier-imapd-ssl, courier-pop3d, and courier-pop3d-ssl are all up to your decision on what access you want to provide. I generally have all the services enabled."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):1004
msgid "Wrap up"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):1004
#, no-wrap
msgid "\n# <i>postfix reload</i>\n# <i>rc-update add $service default</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(e):1010
msgid "Have fun!"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):1018
msgid "Troubleshooting"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):1023
msgid "Troubleshooting: This is a short troubleshooting guide for the set up we've detailed how to install here. It is not exhaustive, but meant as a place to get you started in figuring out problems. With a complicated setup such as this, it's imperative that you narrow down the problem to the particular component that is malfunctioning. In general I do that by following a few steps. Start from the base of the system and work your way up, ruling out components that work along the way until you discover which component is having the problem."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):1036
msgid "Step 1: Check your config files"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):1039
msgid "Typos are killers, especially when dealing with authentication systems. Scan your config's and mailsql database for typo's. You can debug all you want, but if you're not passing the right information back and forth to your mail system, it's not going to work. If you make a change to a config file for a service, make sure you restart that service so that the config change gets picked up."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):1047
msgid "How to restart a service"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):1047
#, no-wrap
msgid "\n# <i>/etc/init.d/service restart</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):1054
msgid "Step 2: Are all the necessary services actually running?"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):1057
msgid "If it's not running, start it up. It's awful hard to debug a service that isn't running. Sometimes a service will act like it's started but still not function. Sometimes, when a bad config is used, or a bad transmission comes into a mail component, the service will hang and keep the port from being used by another process. Sometimes you can detect this with netstat. Or, if you've been at it awhile, just take a break and reboot your box in the meantime. That will clear out any hung services. Then you can come back fresh and try it again."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):1067
msgid "Checking the status of a service"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):1067
#, no-wrap
msgid "\n# <i>/etc/init.d/$service status</i>\n# <i>netstat -a | grep $service (or $port)</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):1075
msgid "Step 3: Are all the service using the current config's?"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):1078
msgid "If you've recently made a change to a config file, restart that service to make sure it's using the current version. Some of the components will dump their current config's to you, like postfix."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):1084
msgid "Some services can dump their current config"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):1084
#, no-wrap
msgid "\n# <i>apache2ctl fullstatus</i> (needs lynx installed)\n# <i>apache2ctl configtest</i> (checks config sanity)\n# <i>postconf -n</i> (will tell you exactly what param's postfix is using)\n# <i>/etc/init.d/$service restart</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):1094
msgid "Step 4: Check the logs"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):1097
msgid "Repeat after me, logs are my friend. My next troubleshooting stop is always the logs. Sometimes it's helpful to try a failed operation again then check the logs so that the error message is right at the bottom (or top depending on your logger) instead of buried in there somewhere. See if there is any information in your log that can help you diagnose the problem, or at the very least, figure out which component is having the problem."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):1106
msgid "Checking the logs"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):1106
#, no-wrap
msgid "\n# <i>kill -USR1 `ps -C metalog -o pid=`</i>(to turn off metalog buffering)\n# <i>nano -w /var/log/mail/current</i>\n# <i>cat /var/log/mysql/mysql.log</i>\n# <i>tail /var/log/apache2/error_log</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):1113
msgid "You may also find the debug_peer parameters in main.cf helpful. Setting these will increase log output over just verbose mode."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):1118
msgid "adding debug_peer support"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):1118
#, no-wrap
msgid "\n# <i>nano -w /etc/postfix/main.cf</i>\ndebug_peer_level = 5\ndebug_peer_list = $host.domain.name\n<comment>(Uncomment one of the suggested debugger\ncommands as well.)</comment>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):1129
msgid "Step 5: Talk to the service itself"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):1132
msgid "SMTP, IMAP, and POP3 all respond to telnet sessions. As we've seen earlier when we verified postfix's config. Sometimes it's helpful to open a telnet session to the service itself and see what's happening."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):1138
msgid "Connect to a service with telnet"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):1138
#, no-wrap
msgid "\n# <i>telnet localhost $port</i>\n<comment>(SMTP is 25, IMAP is 143, POP3 is 110. You should receive at least an OK string,\nletting you know that the service is running and ready to respond to requests.)</comment>\n\nTrying 127.0.0.1...\nConnected to localhost.\nEscape character is '^]'.\n* OK Courier-IMAP ready. Copyright 1998-2002 Double Precision, Inc.\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):1152
msgid "Step 6: Sometimes only the big guns will give you the information you need: strace"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):1155
msgid "You should have this installed anyway. This is an invaluable tool for debugging software. You can start commands from the command line with strace and watch all the system calls as they happen. It often dumps a huge amount of information, so you'll either need to watch it realtime as you retry a failed transaction with the mail system, or dump the output to a file for review."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre:caption):1163
msgid "Using strace"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(pre):1163
#, no-wrap
msgid "\n# <i>emerge strace</i>\n# <i>strace $command</i>\n# <i>strace -p `ps -C $service -o pid=`</i>\n"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(title):1172
msgid "Step 7: Research"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(p):1175
msgid "Once you have the information, if you can diagnose and fix the problem, great! If not, you'll probably need to go digging on the net for information that will help you fix it. Here's a list of sites you can check to see if your error has already been resolved. There's also a really good howto on setting up smtp-auth which contains some great debugging ideas."
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(li):1184
msgid "<uri>http://forums.gentoo.org/</uri> - Great forums for gentoo users"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(li):1185
msgid "<uri>http://bugs.gentoo.org/</uri> - Bugs database for gentoo - great place to look for specific errors"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(li):1189
msgid "<uri>http://postfix.state-of-mind.de/</uri> - smtp-auth howto"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(li):1190
msgid "<uri>http://marc.theaimsgroup.com/?l=postfix-users</uri> - Postfix mailing lists - searchable"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(li):1194
msgid "<uri>http://sourceforge.net/mailarchive/forum.php?forum_id=6705</uri> - Courier-imap mailing list archives - not searchable"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(li):1198
msgid "<uri>http://www.google.com/</uri> - If all else fails, there's always google, which has never failed me"
msgstr ""
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(li):1202
msgid "I also spend a lot of time on <uri link=\"irc://irc.gentoo.org/gentoo\">#gentoo</uri>. IRC is a great place to go for help."
msgstr ""
#. Place here names of translator, one per line. Format should be NAME; ROLE; E-MAIL
#: ../../gentoo/xml/htdocs/doc/en//virt-mail-howto.xml(None):0
msgid "translator-credits"
msgstr ""
|