]> git.proxmox.com Git - pmg-docs.git/blobdiff - pmg-planning-deployment.adoc
stats: some grammar layout and content additions/adaptions
[pmg-docs.git] / pmg-planning-deployment.adoc
index 2d4c7913c70ce9fafeb837a7d158197816bd535e..928757413ba2baf9332d42d5f46b8cbd600ce159 100644 (file)
@@ -2,56 +2,55 @@
 Planning for Deployment
 =======================
 
-Easy integration into existing e-mail server architecture
----------------------------------------------------------
+Easy Integration into Existing Email Server Architecture
+--------------------------------------------------------
 
-In this sample configuration, your e-mail traffic (SMTP) arrives on
-the firewall and will be directly forwarded to your e-mail server.
+In this sample configuration, your email traffic (SMTP) arrives on
+the firewall and will be directly forwarded to your email server.
 
 image::images/2018_IT_infrastructure_without_Proxmox_Mail_Gateway_final_1024.png[]
 
-By using the {pmg}, all your e-mail traffic is forwarded to the
-Proxmox Mail Gateway, which filters the whole e-mail traffic and
-removes unwanted e-mails. You can manage incoming and outgoing mail
+By using {pmg}, all your email traffic is forwarded to
+the {pmg} instance, which filters the email traffic and
+removes unwanted emails. This allows you to manage incoming and outgoing mail
 traffic.
 
 image::images/2018_IT_infrastructure_with_Proxmox_Mail_Gateway_final_1024.png[]
 
 
-Filtering outgoing e-mails
---------------------------
+Filtering Outgoing Emails
+-------------------------
 
-Many e-mail filter solutions do not scan outgoing mails. Opposed to
-that {pmg} is designed to scan both incoming and outgoing
-e-mails. This has two major advantages:
+Many email filtering solutions do not scan outgoing mails. In contrast, {pmg} is
+designed to scan both incoming and outgoing emails. This has two major
+advantages:
 
 . {pmg} is able to detect viruses sent from an internal host. In many
-countries you are liable for sending viruses to other
-people. The {pmg} outgoing e-mail scanning feature is an additional
+countries, you are liable for sending viruses to other
+people. The outgoing email scanning feature is an additional
 protection to avoid that.
 
-. {pmg} can gather statistics about outgoing e-mails too. Statistics
-about incoming e-mails looks nice, but they are quite
-useless. Consider two users, user-1 receives 10 e-mails from news
-portals and wrote 1 e-mail to a person you never heard from. While
-user-2 receives 5 e-mails from a customer and sent 5 e-mails
-back. Which user do you consider more active? I am sure it's user-2,
-because he communicates with your customers. {pmg} advanced address
-statistics can show you this important information. A solution which
-does not scan outgoing e-mail cannot do that.
+. {pmg} can gather statistics about outgoing emails too. Statistics
+about incoming emails may look nice, but they aren't necessarily helpful.
+Consider two users; user-1 receives 10 emails from news
+portals and writes 1 email to an unknown individual, while
+user-2 receives 5 emails from customers and sends 5 emails
+in return. With this information, user-2 can be considered as the more active
+user, because they communicate more with your customers. {pmg} advanced address
+statistics can show you this important information, whereas a solution which
+does not scan outgoing email cannot do this.
 
-To enable outgoing e-mail filtering you just need to send all outgoing
-e-mails through your {png} (usually by specifying Proxmox as
-"smarthost" on your e-mail server.
+To enable outgoing email filtering, you simply need to send all outgoing
+emails through your {pmg} (usually by specifying {pmg} as
+"smarthost" on your email server).
 
 [[firewall_settings]]
-Firewall settings
+Firewall Settings
 -----------------
 
-In order to pass e-mail traffic to the {pmg} you need to allow traffic
-on the SMTP the port. Our servers use the Network Time Protocol (NTP)
-for time synchronization, RAZOR, DNS, SSH, HTTP and port 8006 for the web
-based management interface.
+In order to pass email traffic to {pmg}, you need to allow traffic on the
+SMTP port. Our software uses the Network Time Protocol (NTP), RAZOR, DNS, SSH,
+and HTTP, as well as port 8006 for the web-based management interface.
 
 [options="header"]
 |======
@@ -63,10 +62,11 @@ based management interface.
 |RAZOR   |2703    |TCP      |Proxmox    |Internet
 |DNS     |53      |TCP/UDP  |Proxmox    |DNS Server
 |HTTP    |80      |TCP      |Proxmox    |Internet
+|HTTPS   |443     |TCP      |Proxmox    |Internet
 |GUI/API |8006    |TCP      |Intranet   |Proxmox
 |======
 
-CAUTION: It is advisable to restrict access to the GUI/API port as far
+CAUTION: It is recommended to restrict access to the GUI/API port as far
 as possible.
 
 The outgoing HTTP connection is mainly used by virus pattern updates,
@@ -81,8 +81,8 @@ section xref:nmap[port scans]).
 System Requirements
 -------------------
 
-The {pmg} can run on dedicated server hardware or inside a virtual machine on
-any of the following plattforms:
+{pmg} can run on dedicated server hardware or inside a virtual machine on
+any of the following platforms:
 
 * Proxmox VE (KVM)
 
@@ -92,18 +92,17 @@ any of the following plattforms:
 
 * KVM (virtio drivers are integrated, great performance)
 
-* Virtual box™
+* VirtualBox™
 
 * Citrix Hypervisor™ (former XenServer™)
 
 * LXC container
 
-* and others supporting Debian Linux as guest OS
+* and others that support Debian Linux as a guest OS
 
-Please see http://www.proxmox.com for details.
+Please see https://www.proxmox.com for details.
 
-In order to get a benchmark from your hardware, just run 'pmgperf'
-after installation.
+To benchmark your hardware, run 'pmgperf' after installation.
 
 
 Minimum System Requirements
@@ -113,42 +112,42 @@ Minimum System Requirements
 
 * 2 GB RAM
 
-* bootable CD-ROM-drive or USB boot support
+* Bootable CD-ROM-drive or USB boot support
 
-* Monitor with a resolution of 1024x768 for the installation
+* Monitor with a minimum resolution of 1024x768 for the installation
 
 * Hard disk with at least 8 GB of disk space
 
-* Ethernet network interface card
+* Ethernet network interface card (NIC)
 
 
 Recommended System Requirements
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-* Multicore CPU: 64bit (Intel EMT64 or AMD64), +
-  for use as virtual machine activate Intel VT/AMD-V CPU flag
+* Multi-core CPU: 64bit (Intel EMT64 or AMD64), +
+** for use in a virtual machine, activate Intel VT/AMD-V CPU flag
 
 * 4 GB RAM
 
-* bootable CD-ROM-drive or USB boot support
+* Bootable CD-ROM-drive or USB boot support
 
-* Monitor with a resolution of 1024x768 for the installation
+* Monitor with a minimum resolution of 1024x768 for the installation
 
-* 1 Gbps Ethernet network interface card
+* 1 Gbps Ethernet network interface card (NIC)
 
-* Storage: at least 8 GB free disk space, best setup with redundancy,
-  use hardware RAID controller with battery backed write cache (``BBU'') or
-  ZFS. ZFS is not compatible with a hardware RAID controller. For best
-  performance use Enterprise class SSD with power loss protection.
+* Storage: at least 8 GB free disk space, best set up with redundancy,
+  using a hardware RAID controller with battery backed write cache (``BBU'') or
+  ZFS. ZFS is not compatible with hardware RAID controllers. For best
+  performance, use enterprise-class SSDs with power loss protection.
 
 
 Supported web browsers for accessing the web interface
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-To use the web interface you need a modern browser, this includes:
+To use the web interface, you need a modern browser. This includes:
 
 * Firefox, a release from the current year, or the latest Extended
 Support Release
 * Chrome, a release from the current year
-* Microsofts currently supported version of Edge
+* Microsoft's currently supported version of Edge
 * Safari, a release from the current year