2 image:./images/proxmox-logo.svg[] pass:[<br>] Proxmox Mail Gateway Administration Guide
3 =======================================================================================
6 Proxmox Mail Gateway Administration Guide
7 =========================================
10 :title: Proxmox Mail Gateway Administration Guide
19 // Push titles down one level.
22 include::pmg-intro.adoc[]
24 include::pmg-planning-deployment.adoc[]
26 include::pmg-installation.adoc[]
28 include::pmgconfig.adoc[]
30 include::pmg-mail-filter.adoc[]
32 include::pmgbackup.adoc[]
36 // Return to normal title levels.
44 [[create_bootable_usb]]
47 [[mail_server_config]]
50 [[fitering_outgoing_mail]]
51 fitering_outgoing_mail
54 Important Service Daemons
55 -------------------------
59 include::pmgdaemon.adoc[]
61 include::pmgproxy.adoc[]
63 include::pmg-smtp-filter.adoc[]
65 include::pmgpolicy.adoc[]
67 include::pmgtunnel.adoc[]
69 include::pmgmirror.adoc[]
74 Useful Command Line Tools
75 -------------------------
82 include::pmgversion.adoc[]
84 include::pmgsubscription.adoc[]
86 include::pmgperf.adoc[]
90 include::pmgreport.adoc[]
92 include::pmgupgrade.adoc[]
101 `nmap` is designed to allow system administrators to scan large
102 networks to determine which hosts are up and what services they are
103 offering. You can use nmap to test your firewall setting, for example
104 to see if the required ports are open.
106 .Test Razor port (tcp port 2703):
108 # nmap -P0 -sS -p 2703 c301.cloudmark.com
110 Starting Nmap 5.00 ( http://nmap.org ) at 2012-07-31 11:10 CEST
111 Interesting ports on c301.cloudmark.com (208.83.137.114):
113 2703/tcp open unknown
115 Nmap done: 1 IP address (1 host up) scanned in 0.17 seconds
118 See the manual page (`man nmap`) for more information about nmap.
123 include::pmg-bibliography.adoc[]
131 Access to the administration web interface is always done via
132 `https`. The default certificate is never valid for your browser and
133 you get always warnings.
135 If you want to get rid of these warnings, you have to generate a valid
136 certificate for your server.
138 Login to your Proxmox via ssh or use the console:
141 openssl req -newkey rsa:2048 -nodes -keyout key.pem -out req.pem
144 Follow the instructions on the screen, see this example:
147 Country Name (2 letter code) [AU]: AT
148 State or Province Name (full name) [Some-State]:Vienna
149 Locality Name (eg, city) []:Vienna
150 Organization Name (eg, company) [Internet Widgits Pty Ltd]: Proxmox GmbH
151 Organizational Unit Name (eg, section) []:Proxmox Mail Gateway
152 Common Name (eg, YOUR name) []: yourproxmox.yourdomain.com
153 Email Address []:support@yourdomain.com
155 Please enter the following 'extra' attributes to be sent with your certificate request
156 A challenge password []: not necessary
157 An optional company name []: not necessary
160 After you finished this certificate request you have to send the file
161 `req.pem` to your Certification Authority (CA). The CA will issue the
162 certificate (BASE64 encoded) based on your request – save this file as
163 `cert.pem` to your Proxmox.
165 To activate the new certificate, do the following on your Proxmox:
168 cat key.pem cert.pem >/etc/pmg/pmg-api.pem
171 The restart the API servers
174 systemctl restart pmgproxy
177 Test your new certificate by using your browser.
179 NOTE: To transfer files from and to your Proxmox, you can use secure
180 copy: If you desktop is Linux, you can use the `scp` command line
181 tool. If your desktop PC is windows, please use a scp client like
182 WinSCP (see http://winscp.net/).
186 Command Line Interface
187 ----------------------
189 *pmgbackup* - Proxmox Mail Gateway Backup and Restore Utility
190 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
192 include::pmgbackup.1-synopsis.adoc[]
195 *pmgcm* - Proxmox Mail Gateway Cluster Management Toolkit
196 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
198 include::pmgcm.1-synopsis.adoc[]
204 include::pmgsh.1-synopsis.adoc[]
207 *pmgperf* - Proxmox Simple Performance Benchmark
208 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
210 include::pmgperf.1-synopsis.adoc[]
213 *pmgconfig* - Configuration Management Toolkit
214 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
216 include::pmgconfig.1-synopsis.adoc[]
219 *pmgdb* - Database Management Toolkit
220 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
222 include::pmgdb.1-synopsis.adoc[]
229 *pmgdaemon* - {pmg} API Daemon
230 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
232 include::pmgdaemon.8-synopsis.adoc[]
235 *pmgproxy* - {pmg} API Proxy Daemon
236 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
238 include::pmgproxy.8-synopsis.adoc[]
241 *pmg-smtp-filter* - Proxmox SMTP Filter Daemon
242 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
244 include::pmg-smtp-filter.8-synopsis.adoc[]
247 *pmgpolicy* - {pmg} Policy Daemon
248 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
250 include::pmgpolicy.8-synopsis.adoc[]
253 *pmgtunnel* - Cluster Tunnel Daemon
254 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
256 include::pmgtunnel.8-synopsis.adoc[]
259 *pmgmirror* - Database Mirror Daemon
260 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
262 include::pmgmirror.8-synopsis.adoc[]
266 include::pmg-rule-macros.adoc[]
274 include::pmg.conf.adoc[]
276 include::cluster.conf.adoc[]
278 include::user.conf.adoc[]
280 include::ldap.conf.adoc[]