From c339d7a3b5da43f2c95073ffc365e9b415960b09 Mon Sep 17 00:00:00 2001 From: Zhang Huangbin Date: Tue, 7 Jul 2015 21:09:17 +0800 Subject: [PATCH] New: howto/0-performance.tuning.md, 3 tips added. --- convert.sh | 1 - howto/0-performance.tuning.md | 24 ++++++++++ .../concurrent.processing.md | 4 +- howto/enable.postscreen.md | 30 ++++++++++++ html/concurrent.processing.html | 5 +- html/enable.postscreen.html | 46 ++++++++++++++++++ html/index.html | 19 ++++++-- html/install.iredmail.on.debian.ubuntu.html | 2 + html/install.iredmail.on.freebsd.html | 2 + ...install.iredmail.on.freebsd.with.jail.html | 2 + html/install.iredmail.on.openbsd.html | 2 + html/install.iredmail.on.rhel.html | 2 + html/performance.tuning.html | 48 +++++++++++++++++++ .../0-install.iredmail.on.debian.ubuntu.md | 3 +- installation/0-install.iredmail.on.freebsd.md | 3 +- ...0-install.iredmail.on.freebsd.with.jail.md | 3 +- installation/0-install.iredmail.on.openbsd.md | 2 + installation/0-install.iredmail.on.rhel.md | 3 +- installation/_links.md | 13 +++-- performance.tunning/_title.md | 1 - 20 files changed, 198 insertions(+), 17 deletions(-) create mode 100644 howto/0-performance.tuning.md rename {performance.tunning => howto}/concurrent.processing.md (94%) create mode 100644 howto/enable.postscreen.md create mode 100644 html/enable.postscreen.html create mode 100644 html/performance.tuning.html delete mode 100644 performance.tunning/_title.md diff --git a/convert.sh b/convert.sh index 05dec430..fcd899a3 100644 --- a/convert.sh +++ b/convert.sh @@ -36,7 +36,6 @@ all_chapter_dirs="overview \ upgrade \ migrations \ howto \ - performance.tunning \ integrations \ cluster \ troubleshooting \ diff --git a/howto/0-performance.tuning.md b/howto/0-performance.tuning.md new file mode 100644 index 00000000..0c8f94a8 --- /dev/null +++ b/howto/0-performance.tuning.md @@ -0,0 +1,24 @@ +# Performance tuning + +[TOC] + +If you're running a busy mail server (many inbound/outbound emails every day), +you can follow below suggestions for better performance. + +### Setup a DNS server in LAN or localhost to cache DNS queries + +Mail services heavily rely on DNS service and perform many many DNS queries, +a cache DNS server in LAN or localhost helps a lot. + +### Enable postscreen service to help reduce spam + +* [Enable postscreen service](./enable.postscreen.html) + +If you don't want to use postscreen service, you can [enable DNSBL service](./enable.dnsbl.html) +instead, it helps a lot too, but less effective than postscreen service. + +postscreen and DNSBL service help catch a lot spam, save much system resource. + +### Update Amavisd + Postfix config files to process more emails concurrently + +* [Process more emails concurrently](./concurrent.processing.html) diff --git a/performance.tunning/concurrent.processing.md b/howto/concurrent.processing.md similarity index 94% rename from performance.tunning/concurrent.processing.md rename to howto/concurrent.processing.md index bb6db7c9..b66c0fcd 100644 --- a/performance.tunning/concurrent.processing.md +++ b/howto/concurrent.processing.md @@ -1,4 +1,6 @@ -# Amavisd: process more emails concurrently +# Process more emails concurrently + +__WARNING__: Processing more concurrent emails require more RAM. Amavisd-new is content filter, it invokes SpamAssassin and ClamAV for spam/virus scanning, it also offers additional features like DKIM signing and diff --git a/howto/enable.postscreen.md b/howto/enable.postscreen.md new file mode 100644 index 00000000..aebe6874 --- /dev/null +++ b/howto/enable.postscreen.md @@ -0,0 +1,30 @@ +# Enable postscreen service + +__WARNING__: With postscreen service enabled, your users must use port 587 to +send email, port 25 will be used by postscreen service instead of normal smtp +service. + +iRedMail ships a script to enable postscreen. You can enable it with steps below: + +* Download script `enable_postscreen.sh` from [iRedMail source code repository](https://bitbucket.org/zhb/iredmail/src/default/iRedMail/tools/?at=default) +* Upload this script to your iRedMail server, then below command to enable + postscreen: + +``` +# bash enable_postscreen.sh +``` + +It uses several DNSBL servers by default, you'd better open +`/etc/postfix/main.cf` (Linux/OpenBSD) or `/usr/local/etc/postfix/main.cf` +(FreeBSD) to check the DNSBL servers it enabled, you're free to remove some +DNSBL servers if you want. + +## See Also + +If you don't want to use postscreen service, you can [enable DNSBL service](./enable.dnsbl.html) +instead, it helps a lot too, but less effective than postscreen service. + +## References + +* [Postfix Postscreen Howto](http://www.postfix.org/POSTSCREEN_README.html) +* [Postfix manual page: postscreen(8)](http://www.postfix.org/postscreen.8.html) diff --git a/html/concurrent.processing.html b/html/concurrent.processing.html index 71d6b926..b89c991c 100644 --- a/html/concurrent.processing.html +++ b/html/concurrent.processing.html @@ -1,7 +1,7 @@ - Amavisd: process more emails concurrently + Process more emails concurrently @@ -10,7 +10,8 @@ iRedMail web site // Document Index -

Amavisd: process more emails concurrently

+

Process more emails concurrently

+

WARNING: Processing more concurrent emails require more RAM.

Amavisd-new is content filter, it invokes SpamAssassin and ClamAV for spam/virus scanning, it also offers additional features like DKIM signing and verification.

diff --git a/html/enable.postscreen.html b/html/enable.postscreen.html new file mode 100644 index 00000000..36cefad5 --- /dev/null +++ b/html/enable.postscreen.html @@ -0,0 +1,46 @@ + + + + Enable postscreen service + + + + +

Enable postscreen service

+

WARNING: With postscreen service enabled, your users must use port 587 to +send email, port 25 will be used by postscreen service instead of normal smtp +service.

+

iRedMail ships a script to enable postscreen. You can enable it with steps below:

+ +
# bash enable_postscreen.sh
+
+ +

It uses several DNSBL servers by default, you'd better open +/etc/postfix/main.cf (Linux/OpenBSD) or /usr/local/etc/postfix/main.cf +(FreeBSD) to check the DNSBL servers it enabled, you're free to remove some +DNSBL servers if you want.

+

See Also

+

If you don't want to use postscreen service, you can enable DNSBL service +instead, it helps a lot too, but less effective than postscreen service.

+

References

+

Document published under a CC BY-ND 3.0 license. If you found something wrong, please do contact us to fix it. + \ No newline at end of file diff --git a/html/index.html b/html/index.html index 58d4de69..df65d2c9 100644 --- a/html/index.html +++ b/html/index.html @@ -27,11 +27,22 @@

  • -

    Setup DNS records for your iRedMail server

    +

    After installtion:

    +
  • +
  • +

    Additional installation tips

    + +
  • +
  • +

    Performance tuning for a busy server

    +
  • +

    Configure mail client applications

    If you're using different mail clients, please help write documents to guide other users to setup the mail clients.

    Access webmail and other web applications

    After installation successfully completed, you can access web-based programs diff --git a/html/install.iredmail.on.freebsd.with.jail.html b/html/install.iredmail.on.freebsd.with.jail.html index c49aaedb..8dff675d 100644 --- a/html/install.iredmail.on.freebsd.with.jail.html +++ b/html/install.iredmail.on.freebsd.with.jail.html @@ -269,6 +269,8 @@ automatically. Type y or Y and press Enterfree SSL cert offerred by StartSSL.com. We have a document for you to use a bought SSL certificate. +

  • If you're running a busy mail server, we have some suggestions for better + performance.
  • Access webmail and other web applications

    After installation successfully completed, you can access web-based programs diff --git a/html/install.iredmail.on.openbsd.html b/html/install.iredmail.on.openbsd.html index 1c50aaae..5483b100 100644 --- a/html/install.iredmail.on.openbsd.html +++ b/html/install.iredmail.on.openbsd.html @@ -240,6 +240,8 @@ automatically. Type y or Y and press Enterfree SSL cert offerred by StartSSL.com. We have a document for you to use a bought SSL certificate.

    +
  • If you're running a busy mail server, we have some suggestions for better + performance.
  • Access webmail and other web applications

    After installation successfully completed, you can access web-based programs diff --git a/html/install.iredmail.on.rhel.html b/html/install.iredmail.on.rhel.html index 18c97d1f..d2da70ea 100644 --- a/html/install.iredmail.on.rhel.html +++ b/html/install.iredmail.on.rhel.html @@ -223,6 +223,8 @@ automatically. Type y or Y and press Enterfree SSL cert offerred by StartSSL.com. We have a document for you to use a bought SSL certificate. +

  • If you're running a busy mail server, we have some suggestions for better + performance.
  • Access webmail and other web applications

    After installation successfully completed, you can access web-based programs diff --git a/html/performance.tuning.html b/html/performance.tuning.html new file mode 100644 index 00000000..7408ffc9 --- /dev/null +++ b/html/performance.tuning.html @@ -0,0 +1,48 @@ + + + + Performance tuning + + + + +

    Performance tuning

    +
    + +
    +

    If you're running a busy mail server (many inbound/outbound emails every day), +you can follow below suggestions for better performance.

    +

    Setup a DNS server in LAN or localhost to cache DNS queries

    +

    Mail services heavily rely on DNS service and perform many many DNS queries, +a cache DNS server in LAN or localhost helps a lot.

    +

    Enable postscreen service to help reduce spam

    + +

    If you don't want to use postscreen service, you can enable DNSBL service +instead, it helps a lot too, but less effective than postscreen service.

    +

    postscreen and DNSBL service help catch a lot spam, save much system resource.

    +

    Update Amavisd + Postfix config files to process more emails concurrently

    +

    Document published under a CC BY-ND 3.0 license. If you found something wrong, please do contact us to fix it. + \ No newline at end of file diff --git a/installation/0-install.iredmail.on.debian.ubuntu.md b/installation/0-install.iredmail.on.debian.ubuntu.md index d1ab8e4a..a6ccb9ae 100644 --- a/installation/0-install.iredmail.on.debian.ubuntu.md +++ b/installation/0-install.iredmail.on.debian.ubuntu.md @@ -192,7 +192,8 @@ Configuration completed. HTTPS/IMAPS/POP3/SMTPS. Or, you can use [free SSL cert offerred by StartSSL.com](http://www.startssl.com/?app=1). We have a document for you to [use a bought SSL certificate](http://www.iredmail.org/docs/use.a.bought.ssl.certificate.html). - +* If you're running a busy mail server, we have [some suggestions for better + performance](./performance.tuning.html). ## Access webmail and other web applications diff --git a/installation/0-install.iredmail.on.freebsd.md b/installation/0-install.iredmail.on.freebsd.md index b245727d..b53774a0 100644 --- a/installation/0-install.iredmail.on.freebsd.md +++ b/installation/0-install.iredmail.on.freebsd.md @@ -197,7 +197,8 @@ Configuration completed. HTTPS/IMAPS/POP3/SMTPS. Or, you can use [free SSL cert offerred by StartSSL.com](http://www.startssl.com/?app=1). We have a document for you to [use a bought SSL certificate](http://www.iredmail.org/docs/use.a.bought.ssl.certificate.html). - +* If you're running a busy mail server, we have [some suggestions for better + performance](./performance.tuning.html). ## Access webmail and other web applications diff --git a/installation/0-install.iredmail.on.freebsd.with.jail.md b/installation/0-install.iredmail.on.freebsd.with.jail.md index f3df10b4..1c85f98c 100644 --- a/installation/0-install.iredmail.on.freebsd.with.jail.md +++ b/installation/0-install.iredmail.on.freebsd.with.jail.md @@ -255,7 +255,8 @@ Configuration completed. HTTPS/IMAPS/POP3/SMTPS. Or, you can use [free SSL cert offerred by StartSSL.com](http://www.startssl.com/?app=1). We have a document for you to [use a bought SSL certificate](http://www.iredmail.org/docs/use.a.bought.ssl.certificate.html). - +* If you're running a busy mail server, we have [some suggestions for better + performance](./performance.tuning.html). ## Access webmail and other web applications diff --git a/installation/0-install.iredmail.on.openbsd.md b/installation/0-install.iredmail.on.openbsd.md index 973ddbd5..1004e0d5 100644 --- a/installation/0-install.iredmail.on.openbsd.md +++ b/installation/0-install.iredmail.on.openbsd.md @@ -224,6 +224,8 @@ Configuration completed. HTTPS/IMAPS/POP3/SMTPS. Or, you can use [free SSL cert offerred by StartSSL.com](http://www.startssl.com/?app=1). We have a document for you to [use a bought SSL certificate](http://www.iredmail.org/docs/use.a.bought.ssl.certificate.html). +* If you're running a busy mail server, we have [some suggestions for better + performance](./performance.tuning.html). ## Access webmail and other web applications diff --git a/installation/0-install.iredmail.on.rhel.md b/installation/0-install.iredmail.on.rhel.md index a3362a43..b7487c69 100644 --- a/installation/0-install.iredmail.on.rhel.md +++ b/installation/0-install.iredmail.on.rhel.md @@ -210,7 +210,8 @@ Configuration completed. HTTPS/IMAPS/POP3/SMTPS. Or, you can use [free SSL cert offerred by StartSSL.com](http://www.startssl.com/?app=1). We have a document for you to [use a bought SSL certificate](http://www.iredmail.org/docs/use.a.bought.ssl.certificate.html). - +* If you're running a busy mail server, we have [some suggestions for better + performance](./performance.tuning.html). ## Access webmail and other web applications diff --git a/installation/_links.md b/installation/_links.md index ac1724f4..3ffbd4cf 100644 --- a/installation/_links.md +++ b/installation/_links.md @@ -5,6 +5,13 @@ * [FreeBSD (without Jail)](./install.iredmail.on.freebsd.html), [FreeBSD with Jail (ezjail)](./install.iredmail.on.freebsd.with.jail.html) * [OpenBSD](./install.iredmail.on.openbsd.html) -* [Setup DNS records for your iRedMail server](./setup.dns.html) -* [Install iRedMail with a remote MySQL server](./install.iredmail.with.remote.mysql.server.html) -* [Perform silent/unattended iRedMail installation](./unattended.iredmail.installation.html) +* After installtion: + + * [Setup DNS records for your iRedMail server](./setup.dns.html) + +* Additional installation tips + + * [Install iRedMail with a remote MySQL server](./install.iredmail.with.remote.mysql.server.html) + * [Perform silent/unattended iRedMail installation](./unattended.iredmail.installation.html) + +* [Performance tuning for a busy server](./performance.tuning.html) diff --git a/performance.tunning/_title.md b/performance.tunning/_title.md deleted file mode 100644 index 4d86f117..00000000 --- a/performance.tunning/_title.md +++ /dev/null @@ -1 +0,0 @@ -Performance tunning