← Back to branch summary

~ubuntu-branches/ubuntu/jaunty/ubuntu-docs/jaunty-proposed

« back to all changes in this revision

Viewing changes to serverguide/C/mail.xml

  • Committer: Bazaar Package Importer
  • Author(s): Matthew East
  • Date: 2009-02-15 11:50:28 UTC
  • Revision ID: james.westby@ubuntu.com-20090215115028-exdnd0gtie61uvn2
Tags: 9.04.2
https://launchpad.net/bugs/203829
https://launchpad.net/bugs/291772
https://launchpad.net/bugs/298605
https://launchpad.net/bugs/306289
https://launchpad.net/bugs/311900
https://launchpad.net/bugs/312506
https://launchpad.net/bugs/313232
https://launchpad.net/bugs/314951
https://launchpad.net/bugs/319179
https://launchpad.net/bugs/320840
https://launchpad.net/bugs/323203
https://launchpad.net/bugs/324399
https://launchpad.net/bugs/325828
https://launchpad.net/bugs/285484
https://launchpad.net/bugs/295279
https://launchpad.net/bugs/307582
https://launchpad.net/bugs/322367
https://launchpad.net/bugs/309735
https://launchpad.net/bugs/310081
https://launchpad.net/bugs/310713
https://launchpad.net/bugs/327060
https://launchpad.net/bugs/185892
https://launchpad.net/bugs/298513
https://launchpad.net/bugs/321308
https://launchpad.net/bugs/314680
https://launchpad.net/bugs/321179
https://launchpad.net/bugs/275592
https://launchpad.net/bugs/290467
* Various serverguide fixes:
  - Grammar error (LP: #203829) - Dean Sas
  - Fix mailman dependencies (LP: #291772) - Morten Siebuhr
  - CVS installation error (LP: #298605) - Thomas M
  - Postfox installation error (LP: #306289) - Adam Sommer
  - SSH update (LP: #311900) - Dean Sas
  - unzoo replaced by zoo (LP: #312506)
  - Samba instructions update (LP: #313232) - Adam Sommer
  - Clearer SSL instructions (LP: #314951) - Adam Sommer
  - LDAP error (LP: #319179) - Adam Sommer
  - MoinMoin installation fix (LP: #320840) - Adam Sommer
  - Postfix ssl improvements (LP: #323203) - Adam Sommer
  - Ebox instructions error (LP: #324399) - Dean Sas
  - Typo in openssh section (LP: #325828) - Dean Sas
  - Typo in samba section (LP: #285484) - Nick Ellery
  - SSHD fix (LP: #295279) - Adam Sommer
  - Jeos fix (LP: #307582) - Adam Sommer
  - Remove reference to ebox-all package (LP: #322367) - Adam Sommer

* Typo in "switching from windows" (LP: #309735)
* Broken link in "programming" (LP: #310081) - Jonathan Jesse
* lsb_release issue in "basic commands" (LP: #310713) - Thomas M
* Updating logout instructions (LP: #327060) - Dean Sas
* Updating all documents to use apt-url for installation instructions
* Refreshing pot files for Rosetta
* Recompress *.png files with 'advpng -z -4 file.png' to save space -  Sahak Petrosyan
* Improve instructions on pasting commands (LP: #185892) - Martin Mai
* Rewrite of networking instructions (LP: #298513, LP: #321308, LP: #314680, LP: #321179) - Dougie Richardson
* Amend punctuation of about-ubuntu (LP: #275592) - Dougie Richardson
* Documentation for automatic login (LP: #290467) - Dougie Richardson

Show diffs side-by-side

added added

removed removed

Lines of Context:
serverguide/C/mail.xml
124
124
                </step>
125
125
                <step>
126
126
                <para>
127
 
                Next, configure the digital certificate for TLS. When asked questions, follow 
128
 
                the instructions and answer appropriately:
 
127
                Next, obtain a digital certificate for TLS. See <xref linkend="certificates-and-security"/> for details.
 
128
                This example also uses a Certificate Authority (CA).  For information on generating a CA certificate see
 
129
                <xref linkend="certificate-authority"/>.
129
130
                </para>
130
 
<screen>
131
 
openssl genrsa -des3 -rand /etc/hosts -out smtpd.key 1024
132
 
chmod 600 smtpd.key
133
 
openssl req -new -key smtpd.key -out smtpd.csr
134
 
sudo openssl x509 -req -days 365 -in smtpd.csr -signkey smtpd.key -out smtpd.crt
135
 
openssl rsa -in smtpd.key -out smtpd.key.unencrypted
136
 
mv -f smtpd.key.unencrypted smtpd.key
137
 
openssl req -new -x509 -extensions v3_ca -keyout cakey.pem -out cacert.pem -days 3650
138
 
sudo mv smtpd.key /etc/ssl/private/
139
 
sudo mv smtpd.crt /etc/ssl/certs/
140
 
sudo mv cakey.pem /etc/ssl/private/
141
 
sudo mv cacert.pem /etc/ssl/certs/
142
 
</screen>
143
131
                <note>
144
132
                <para>
145
133
                You can get the digital certificate from a certificate
154
142
                </step>
155
143
                <step>
156
144
                <para>
157
 
                Configure Postfix to provide TLS encryption for both incoming and outgoing mail:
 
145
                Once you have a certificate, configure Postfix to provide TLS encryption for both incoming and outgoing mail:
158
146
                </para>
159
147
<screen>
160
148
sudo postconf -e 'smtpd_tls_auth_only = no'
161
149
sudo postconf -e 'smtp_use_tls = yes'
162
150
sudo postconf -e 'smtpd_use_tls = yes'
163
151
sudo postconf -e 'smtp_tls_note_starttls_offer = yes'
164
 
sudo postconf -e 'smtpd_tls_key_file = /etc/ssl/private/smtpd.key'
165
 
sudo postconf -e 'smtpd_tls_cert_file = /etc/ssl/certs/smtpd.crt'
 
152
sudo postconf -e 'smtpd_tls_key_file = /etc/ssl/private/server.key'
 
153
sudo postconf -e 'smtpd_tls_cert_file = /etc/ssl/certs/server.crt'
166
154
sudo postconf -e 'smtpd_tls_CAfile = /etc/ssl/certs/cacert.pem'
167
155
sudo postconf -e 'smtpd_tls_loglevel = 1'
168
156
sudo postconf -e 'smtpd_tls_received_header = yes'
235
223
    }
236
224
  }
237
225
</programlisting>
 
226
 
 
227
            <para>
 
228
            In order to let <application>Outlook</application> clients use SMTPAUTH, in the <emphasis>auth default</emphasis> 
 
229
            section of /etc/dovecot/dovecot.conf add <emphasis>"login"</emphasis>:
 
230
            </para>
 
231
 
 
232
<programlisting>
 
233
  mechanisms = plain login
 
234
</programlisting>
 
235
 
238
236
            <para>
239
237
            Once you have <application>Dovecot</application> configured restart it with:
240
238
            </para>
562
560
          <application>Exim4</application> is now configured with SMTP-AUTH using TLS and SASL authentication.
563
561
          </para>
564
562
        </sect2>
 
563
        <sect2 id="exim4-references" status="review">
 
564
          <title>References</title>
 
565
    
 
566
          <itemizedlist>
 
567
            <listitem>
 
568
              <para>
 
569
              See <ulink url="http://www.exim.org/">exim.org</ulink> for more information.
 
570
              </para>
 
571
            </listitem>
 
572
            <listitem>
 
573
              <para>
 
574
              There is also an <ulink url="http://www.uit.co.uk/content/exim-smtp-mail-server">Exim4 Book</ulink> available.
 
575
              </para>
 
576
            </listitem>
 
577
          </itemizedlist>
 
578
 
 
579
        </sect2>
565
580
      </sect1>
566
581
      <sect1 id="dovecot-server" status="review">
567
582
        <title>Dovecot Server</title> 
688
703
            </itemizedlist>
689
704
          </para>
690
705
        </sect2>
 
706
        <sect2 id="dovecot-references" status="review">
 
707
          <title>References</title>
 
708
 
 
709
          <itemizedlist>
 
710
            <listitem>
 
711
              <para>
 
712
              See the <ulink url="http://www.dovecot.org/">Dovecot website</ulink> for more information.
 
713
              </para>
 
714
            </listitem>
 
715
          </itemizedlist>
 
716
 
 
717
        </sect2>
691
718
      </sect1>
692
719
      <sect1 id="mailman" status="review">
693
720
        <title>Mailman</title> 
702
729
        <sect2 id="mailman-installation" status="review">
703
730
          <title>Installation</title>
704
731
            <para>
705
 
            Mailman provides a web interface for the administrators
706
 
            and users. So, it requires Apache with mod_perl support.
707
 
            Mailman uses an external mail server to send and receive 
708
 
            emails. It works perfectly with the following mail servers:
 
732
                        Mailman provides a web interface for the administrators and users,
 
733
                        using an external mail server to send and receive emails. It works
 
734
                        perfectly with the following mail servers:
709
735
            </para>
710
736
            <para>
711
737
            <itemizedlist spacing="compact">