proxmox-mirrors/pmg-docs
1
0
Fork 0
mirror of https://git.proxmox.com/git/pmg-docs synced 2025-06-06 13:21:31 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

pmgcm.adoc: improve wording and grammar

Browse Source 
Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>
This commit is contained in:
Oguz Bektas 2019-11-11 15:49:12 +01:00 committed by Dietmar Maurer
parent b458233401
commit 0c358d4574
1 changed files with 15 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
pmgcm.adoc
View File

@ -105,7 +105,7 @@ Hot standby with backup `MX` records
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Many people do not want to install two redundant mail proxies, instead Many people do not want to install two redundant mail proxies, instead
they use the mail proxy of their ISP as fall-back. This is simply done they use the mail proxy of their ISP as fallback. This is simply done
by adding an additional `MX` Record with a lower priority (higher by adding an additional `MX` Record with a lower priority (higher
number). With the example above this looks like that: number). With the example above this looks like that:
@ -113,20 +113,19 @@ number). With the example above this looks like that:
proxmox.com. 22879 IN MX 100 mail.provider.tld. proxmox.com. 22879 IN MX 100 mail.provider.tld.
---- ----
Sure, your provider must accept mails for your domain and forward In such a setup, your provider must accept mails for your domain and
received mails to you. Please note that such setup is not really forward them to you. Please note that this is not advisable, because
advisable, because spam detection needs to be done by that backup `MX` spam detection needs to be done by the backup `MX` server as well, and
server also, and external servers provided by ISPs usually don't do external servers provided by ISPs usually don't.
that.
You will never lose mails with such a setup, because the sending Mail However, you will never lose mails with such a setup, because the sending Mail
Transport Agent (MTA) will simply deliver the mail to the backup Transport Agent (MTA) will simply deliver the mail to the backup
server (mail.provider.tld) if the primary server (mail.proxmox.com) is server (mail.provider.tld) if the primary server (mail.proxmox.com) is
not available. not available.
NOTE: Any resononable mail server retries mail devivery if the target NOTE: Any reasonable mail server retries mail delivery if the target
server is not available, i.e. {pmg} stores mail and retries delivery server is not available, i.e. {pmg} stores mail and retries delivery
for up to one week. So you will not loose mail if you mail server is for up to one week. So you will not lose mail if your mail server is
down, even if you run a single server setup. down, even if you run a single server setup.
@ -140,8 +139,7 @@ avoid lower spam detection rates.
Anyways, it’s quite simple to set up a high performance load balanced Anyways, it’s quite simple to set up a high performance load balanced
mail cluster using `MX` records. You just need to define two `MX` records mail cluster using `MX` records. You just need to define two `MX` records
with the same priority. I will explain this using a complete example with the same priority. Here is a complete example to make it clearer.
to make it clearer.
First, you need to have at least 2 working {pmg} servers First, you need to have at least 2 working {pmg} servers
(mail1.example.com and mail2.example.com) configured as cluster (see (mail1.example.com and mail2.example.com) configured as cluster (see
@ -154,7 +152,7 @@ mail1.example.com. 22879 IN A 1.2.3.4
mail2.example.com. 22879 IN A 1.2.3.5 mail2.example.com. 22879 IN A 1.2.3.5
---- ----
Btw, it is always a good idea to add reverse lookup entries (PTR It is always a good idea to add reverse lookup entries (PTR
records) for those hosts. Many email systems nowadays reject mails records) for those hosts. Many email systems nowadays reject mails
from hosts without valid PTR records. Then you need to define your `MX` from hosts without valid PTR records. Then you need to define your `MX`
records: records:
@ -166,7 +164,7 @@ example.com. 22879 IN MX 10 mail2.example.com.
This is all you need. You will receive mails on both hosts, more or This is all you need. You will receive mails on both hosts, more or
less load-balanced using round-robin scheduling. If one host fails the less load-balanced using round-robin scheduling. If one host fails the
other is used. other one is used.
Other ways Other ways
@ -175,7 +173,7 @@ Other ways
Multiple address records Multiple address records
^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^
Using several DNS `MX` record is sometime clumsy if you have many Using several DNS `MX` records is sometimes clumsy if you have many
domains. It is also possible to use one `MX` record per domain, but domains. It is also possible to use one `MX` record per domain, but
multiple address records: multiple address records:
@ -210,7 +208,7 @@ Creating a Cluster
image::images/screenshot/pmg-gui-cluster-panel.png[] image::images/screenshot/pmg-gui-cluster-panel.png[]
You can create a cluster from any existing Proxmox host. All data is You can create a cluster from any existing {pmg} host. All data is
preserved. preserved.
* make sure you have the right IP configuration * make sure you have the right IP configuration
@ -245,7 +243,7 @@ Adding Cluster Nodes
image::images/screenshot/pmg-gui-cluster-join.png[] image::images/screenshot/pmg-gui-cluster-join.png[]
When you add a new node to a cluster (join) all data on that node is When you add a new node to a cluster (using `join`) all data on that node is
destroyed. The whole database is initialized with cluster data from destroyed. The whole database is initialized with cluster data from
the master. the master.
@ -296,7 +294,7 @@ damaged hardware or disk. {pmg} uses an asynchronous
clustering algorithm, so you just need to reboot the repaired node, clustering algorithm, so you just need to reboot the repaired node,
and everything will work again transparently. and everything will work again transparently.
The following scenarios only apply when you really loose the contents The following scenarios only apply when you really lose the contents
of the hard disk. of the hard disk.