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.
46 [[create_bootable_usb]]
49 [[mail_server_config]]
52 [[fitering_outgoing_mail]]
53 fitering_outgoing_mail
56 Important Service Daemons
57 -------------------------
61 include::pmgdaemon.adoc[]
63 include::pmgproxy.adoc[]
65 include::pmg-smtp-filter.adoc[]
67 include::pmgpolicy.adoc[]
69 include::pmgtunnel.adoc[]
71 include::pmgmirror.adoc[]
76 Useful Command Line Tools
77 -------------------------
84 include::pmgversion.adoc[]
86 include::pmgsubscription.adoc[]
88 include::pmgperf.adoc[]
92 include::pmgreport.adoc[]
94 include::pmgupgrade.adoc[]
102 `nmap` is designed to allow system administrators to scan large
103 networks to determine which hosts are up and what services they are
104 offering. You can use nmap to test your firewall setting, for example
105 to see if the required ports are open.
107 .Test Razor port (tcp port 2703):
109 # nmap -P0 -sS -p 2703 c301.cloudmark.com
111 Starting Nmap 5.00 ( http://nmap.org ) at 2012-07-31 11:10 CEST
112 Interesting ports on c301.cloudmark.com (208.83.137.114):
114 2703/tcp open unknown
116 Nmap done: 1 IP address (1 host up) scanned in 0.17 seconds
119 See the manual page (`man nmap`) for more information about nmap.
124 include::pmg-bibliography.adoc[]
132 Access to the administration web interface is always done via
133 `https`. The default certificate is never valid for your browser and
134 you get always warnings.
136 If you want to get rid of these warnings, you have to generate a valid
137 certificate for your server.
139 Login to your Proxmox via ssh or use the console:
142 openssl req -newkey rsa:2048 -nodes -keyout key.pem -out req.pem
145 Follow the instructions on the screen, see this example:
148 Country Name (2 letter code) [AU]: AT
149 State or Province Name (full name) [Some-State]:Vienna
150 Locality Name (eg, city) []:Vienna
151 Organization Name (eg, company) [Internet Widgits Pty Ltd]: Proxmox GmbH
152 Organizational Unit Name (eg, section) []:Proxmox Mail Gateway
153 Common Name (eg, YOUR name) []: yourproxmox.yourdomain.com
154 Email Address []:support@yourdomain.com
156 Please enter the following 'extra' attributes to be sent with your certificate request
157 A challenge password []: not necessary
158 An optional company name []: not necessary
161 After you finished this certificate request you have to send the file
162 `req.pem` to your Certification Authority (CA). The CA will issue the
163 certificate (BASE64 encoded) based on your request – save this file as
164 `cert.pem` to your Proxmox.
166 To activate the new certificate, do the following on your Proxmox:
169 cat key.pem cert.pem >/etc/pmg/pmg-api.pem
172 The restart the API servers
175 systemctl restart pmgproxy
178 Test your new certificate by using your browser.
180 NOTE: To transfer files from and to your Proxmox, you can use secure
181 copy: If you desktop is Linux, you can use the `scp` command line
182 tool. If your desktop PC is windows, please use a scp client like
183 WinSCP (see http://winscp.net/).
187 Command Line Interface
188 ----------------------
190 *pmgbackup* - Proxmox Mail Gateway Backup and Restore Utility
191 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
193 include::pmgbackup.1-synopsis.adoc[]
196 *pmgcm* - Proxmox Mail Gateway Cluster Management Toolkit
197 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
199 include::pmgcm.1-synopsis.adoc[]
205 include::pmgsh.1-synopsis.adoc[]
208 *pmgperf* - Proxmox Simple Performance Benchmark
209 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
211 include::pmgperf.1-synopsis.adoc[]
214 *pmgconfig* - Configuration Management Toolkit
215 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
217 include::pmgconfig.1-synopsis.adoc[]
220 *pmgdb* - Database Management Toolkit
221 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
223 include::pmgdb.1-synopsis.adoc[]
230 *pmgdaemon* - {pmg} API Daemon
231 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
233 include::pmgdaemon.8-synopsis.adoc[]
236 *pmgproxy* - {pmg} API Proxy Daemon
237 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
239 include::pmgproxy.8-synopsis.adoc[]
242 *pmg-smtp-filter* - Proxmox SMTP Filter Daemon
243 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
245 include::pmg-smtp-filter.8-synopsis.adoc[]
248 *pmgpolicy* - {pmg} Policy Daemon
249 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
251 include::pmgpolicy.8-synopsis.adoc[]
254 *pmgtunnel* - Cluster Tunnel Daemon
255 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
257 include::pmgtunnel.8-synopsis.adoc[]
260 *pmgmirror* - Database Mirror Daemon
261 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
263 include::pmgmirror.8-synopsis.adoc[]
267 include::pmg-rule-macros.adoc[]
275 include::pmg.conf.adoc[]
277 include::cluster.conf.adoc[]
279 include::user.conf.adoc[]
281 include::ldap.conf.adoc[]