X-Git-Url: https://git.proxmox.com/?p=pmg-docs.git;a=blobdiff_plain;f=pmg-admin-guide.adoc;h=6dbb4606103606997a4c3bdb926d5668ad2e5a57;hp=b82f8041594fa1cadcd6706d9ea648a1217e7b4c;hb=ae62f1b78d71380644d8ec9d2dd58793aa3f35e7;hpb=e051eef829db6457a27bbd49cd3cfc52f4981682 diff --git a/pmg-admin-guide.adoc b/pmg-admin-guide.adoc index b82f804..6dbb460 100644 --- a/pmg-admin-guide.adoc +++ b/pmg-admin-guide.adoc @@ -21,12 +21,18 @@ ifndef::manvolnum[] include::pmg-intro.adoc[] -include::pmg-quick-start.adoc[] - include::pmg-planning-deployment.adoc[] +include::pmg-installation.adoc[] + include::pmgconfig.adoc[] +include::pmg-mail-filter.adoc[] + +include::pmgbackup.adoc[] + +include::pmgcm.adoc[] + // Return to normal title levels. :leveloffset: 0 @@ -60,6 +66,10 @@ include::pmg-smtp-filter.adoc[] include::pmgpolicy.adoc[] +include::pmgtunnel.adoc[] + +include::pmgmirror.adoc[] + :leveloffset: 0 @@ -71,15 +81,99 @@ include::pmgdb.adoc[] include::pmgsh.adoc[] +include::pmgversion.adoc[] + +include::pmgsubscription.adoc[] + include::pmgperf.adoc[] +include::pmgqm.adoc[] + +include::pmgreport.adoc[] + +include::pmgupgrade.adoc[] + + +:leveloffset: 1 + +include::pmg-bibliography.adoc[] + :leveloffset: 0 +[appendix] +SSL certificate +--------------- + +Access to the administration web interface is always done via +`https`. The default certificate is never valid for your browser and +you get always warnings. + +If you want to get rid of these warnings, you have to generate a valid +certificate for your server. + +Login to your Proxmox via ssh or use the console: + +---- +openssl req -newkey rsa:2048 -nodes -keyout key.pem -out req.pem +---- + +Follow the instructions on the screen, see this example: + +---- +Country Name (2 letter code) [AU]: AT +State or Province Name (full name) [Some-State]:Vienna +Locality Name (eg, city) []:Vienna +Organization Name (eg, company) [Internet Widgits Pty Ltd]: Proxmox GmbH +Organizational Unit Name (eg, section) []:Proxmox Mail Gateway +Common Name (eg, YOUR name) []: yourproxmox.yourdomain.com +Email Address []:support@yourdomain.com + +Please enter the following 'extra' attributes to be sent with your certificate request +A challenge password []: not necessary +An optional company name []: not necessary +---- + +After you finished this certificate request you have to send the file +`req.pem` to your Certification Authority (CA). The CA will issue the +certificate (BASE64 encoded) based on your request – save this file as +`cert.pem` to your Proxmox. + +To activate the new certificate, do the following on your Proxmox: + +---- +cat key.pem cert.pem >/etc/pmg/pmg-api.pem +---- + +The restart the API servers + +---- +systemctl restart pmgproxy +---- + +Test your new certificate by using your browser. + +NOTE: To transfer files from and to your Proxmox, you can use secure +copy: If you desktop is Linux, you can use the `scp` command line +tool. If your desktop PC is windows, please use a scp client like +WinSCP (see http://winscp.net/). + [appendix] Command Line Interface ---------------------- +*pmgbackup* - Proxmox Mail Gateway Backup and Restore Utility +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +include::pmgbackup.1-synopsis.adoc[] + + +*pmgcm* - Proxmox Mail Gateway Cluster Management Toolkit +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +include::pmgcm.1-synopsis.adoc[] + + *pmgsh* - API Shell ~~~~~~~~~~~~~~~~~~~ @@ -132,6 +226,18 @@ include::pmg-smtp-filter.8-synopsis.adoc[] include::pmgpolicy.8-synopsis.adoc[] +*pmgtunnel* - Cluster Tunnel Daemon +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +include::pmgtunnel.8-synopsis.adoc[] + + +*pmgmirror* - Database Mirror Daemon +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +include::pmgmirror.8-synopsis.adoc[] + + [appendix] include::pmg-rule-macros.adoc[] @@ -143,6 +249,12 @@ Configuration Files include::pmg.conf.adoc[] +include::cluster.conf.adoc[] + +include::user.conf.adoc[] + +include::ldap.conf.adoc[] + :leveloffset: 0 :leveloffset: 1