Sv translation

language	en

Note
This page is no longer being updated. From BlueMind 4.8, please refer to the new BlueMind documentation

Introduction

This page describes the roll-out procedure for a BlueMind Edge server as a postfix and proxy relay.

Postulate

BlueMind is installed on the main server
the role bm-edge-role is installed on the so-called "Edge" server
the Edge server's nginx web server is set up as a proxy relay that serves as a main server

Panel

On this page:

Table of Contents

Related:

Gliffy Diagram

name	bm-edge-role-principe

Roll-out procedure

Install BlueMind on the main server following the usual procedure

Note
The storage space for BlueMind backups must be accessible on this new server at /var/backups/bluemind
Install the subscription on the secondary server as a file
Info
Reminder: the text file for the subscription can be installed on a server manually
for Ubuntu / Debian as /etc/apt/sources.list.d/bm.list
for RedHat / CentOS as /etc/yum.repos.d/bm.repo
Install the package bm-edge-role on the edge server
Tabs group
border all-sides
navcolor navy
Debian/UbuntuRedHat/CentOS
Add the smtp relay role to the edge server in the main server's admin panel:
- log into BlueMind on the main server as admin0@global.virt
- browse to System management > Application servers
- click New > Host
- fill in the information for the new server:
- click "Create & edit" or "Create" then click the corresponding row to edit it
- in the Server roles tab:
  - enable the role "Mail relay"
  - if you are using the BlueMind nginx on this server, also enable the role "Edge reverse proxy HTTPS (DMZ)"
  - click Save
- back in the servers list, the server is shown with the mail relay tag mail/smtp-edge:
Set up the domain so that the edge server is used as a mail relay:
- still signed in as admin0@global.virt, browse to System management > Manage domains
- click the row for the domain you want to configure
- in the Mail system tab, select the edge server you have created as mail server and click Save:
Set up the server to send outgoing messages through the relay:
- still signed in as admin0@global.virt, browse to System Management > System Configuration
- in the Mail tab, fill in the Relay host field with the IP address or the edge server's host name and click Save:

Nginx

Setting up web access

Info
If you are using the BlueMind nginx, and therefore you have enabled the role "Mail relay" on this server (see above), then this section doesn't apply to you – please move on to paragraph 4.2 below.

Log in as root on the edge server
Browse to the folder /etc/nginx/sites-available:
Code Block
bm35-edge.bluemind.loc:~# cd /etc/nginx/sites-available
Create a configuration file bm-proxy and edit it, e.g. using vim:
Code Block
bm35-edge.bluemind.loc:/etc/nginx/sites-available# vim bm-proxy

Add the following command lines:

Code Block

server {
  listen 80;
  # <bluemind_external_url> is the external url users use connect to
  server_name <bluemind_external_url>;

  location / {
	return 301 https://<bluemind_external_url>$request_uri;
  }
}

server {
  listen 443 ssl http2;
  server_name <bluemind_external_url>;

  ssl_certificate /etc/ssl/certs/bm_cert.pem;
  ssl_certificate_key /etc/ssl/certs/bm_cert.pem;
  ssl_session_timeout 5m;
  ssl_prefer_server_ciphers on;

  ssl_protocols TLSv1.2;
  ssl_ciphers 'EDH+CAMELLIA:EDH+aRSA:EECDH+aRSA+AESGCM:EECDH+aRSA+SHA256:EECDH:+CAMELLIA128:+AES128:+SSLv3:!aNULL:!eNULL:!LOW:!3DES:!MD5:!EXP:!PSK:!DSS:!RC4:!SEED:!IDEA:!ECDSA:kEDH:CAMELLIA128-SHA:AES128-SHA';
  add_header Strict-Transport-Security max-age=15768000; # six months

 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

 location / {
	# <internal_srv> is the main BlueMind server
    proxy_pass https://<internal_srv>;
  }

  location /webmail/ {
    client_max_body_size 0m;
    proxy_pass https://<internal_srv>/webmail/;
  }

  location /Microsoft-Server-ActiveSync {
    proxy_pass https://<internal_srv>/Microsoft-Server-ActiveSync;
    proxy_read_timeout 1200s;
    proxy_headers_hash_bucket_size 128;
    proxy_headers_hash_max_size 2048;
    client_max_body_size 0m;
    proxy_pass_header Server;
  } 

  location /eventbus {
    proxy_pass https://<internal_srv>;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
  }

  location /api/filehosting/ {
    client_max_body_size 0m;
    proxy_pass https://<internal_srv>$request_uri;
    proxy_set_header        X-Real-IP       $remote_addr;
    proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_http_version 1.1;
    proxy_buffering off;
  }

  location /api/attachment/ {
    client_max_body_size 0m;
    proxy_pass https://<internal_srv>$request_uri;
    proxy_set_header        X-Real-IP       $remote_addr;
    proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_http_version 1.1;
    proxy_buffering off;
  }

  location /fh/ {
    proxy_pass https://<internal_srv>/fh/;
    proxy_http_version 1.1;
    proxy_buffering off;
  }
}

Save file and exit the editor

Run the following commands to set up the configuration:

Code Block

bm35-edge.bluemind.loc:/etc/nginx/sites-available# ln -s /etc/nginx/sites-available/bm-proxy /etc/nginx/sites-enabled/
bm35-edge.bluemind.loc:/etc/nginx/sites-available# rm /etc/nginx/sites-enabled/default

Reload the nginx server configuration:

Code Block
bm35-edge.bluemind.loc:/etc/nginx/sites-available# service bm-nginx reload

Setting up the mail service

On the edge server, copy the main server's configuration file located at /etc/nginx/global.d/bm-proxy-mail.conf. You can use scp to do this:
Code Block
bm35-edge.bluemind.loc:~# scp root@srv1.bluemind.loc:/etc/nginx/global.d/bm-mail-proxy.conf /etc/nginx/global.d/
Edit the file /etc/nginx/global.d/bm-mail-proxy.conf on the relay server and replace the IP address in the line auth_http by the main server's IP address

Reload the nginx configuration:

Code Block
bm35-edge.bluemind.loc:~# service bm-nginx reload

Setting up XMPP

For the server to manage the XMPP flow:

create a file /etc/nginx/global.d/bm-xmpp-proxy.conf with the following contents:

Code Block
stream { upstream backend_xmpp { least_conn; server 1.2.3.4:5222; server 1.2.3.5:5222 backup; } server { listen 5222; proxy_pass backend_xmpp ; } }

and replacing 1.2.3.4 by the main server's IP address or the server with the XMPP role if appropriate

Reload the nginx configuration:

Code Block
bm35-edge.bluemind.loc:~# service bm-nginx reload

Apache Proxy

Info
BlueMind advises against using Apache as a reverse proxy.

You can also use Apache as a proxy instead of Nginx. To do this, you need a version of Apache equal to or above 2.4 and enable the following modules:

mod_ssl
mod_proxy and mod_proxy_wstunnel
mod_rewrite

VirtualHost example for Apache:

Code Block

<VirtualHost *:80>
        Redirect / https://<bluemind_external_url>/
</VirtualHost>

<VirtualHost *:443>
        SSLEngine On

        SSLCertificateFile     "/etc/ssl/certs/bm_cert.pem"
        SSLCertificateKeyFile  "/etc/ssl/certs/bm_cert.pem"

        SSLProxyEngine On
        SSLProxyCheckPeerCN Off
        SSLProxyCheckPeerName Off
        SSLProxyVerify none

        # Websocket proxy
        RewriteEngine on
        RewriteCond %{HTTP:UPGRADE} ^WebSocket$ [NC]
        RewriteCond %{HTTP:CONNECTION} Upgrade$ [NC]
        RewriteRule .* wss://<internal_srv>%{REQUEST_URI} [P]

        ProxyPreserveHost On
        <Location />
                ProxyPass https://<internal_srv>/
                ProxyPassReverse https://<internal_srv>/
        </Location>
</VirtualHost>

Sv translation

language	de

Note
Diese Seite ist nicht mehr aktuell. Ab der Version BlueMind 4.8 finden Sie alle Infos in der neuen Dokumentation

Präsentation

In diesem Dokument wird das Verfahren für die Bereitstellung eines BlueMind Edge-Servers als Postfix- und Proxy-Relay beschrieben.

Prinzip

BlueMind ist auf dem Hauptserver installiert
die Rolle bm-edge-role ist auf dem sogenannten "Edge"-Server installiert
der nginx-Webserver des Edge-Servers ist als Proxy-Relay konfiguriert, das den Hauptserver bedient

Panel

Auf dieser Seite:

Table of Contents

Verwandt:

Gliffy Diagram

displayName	bm-edge-role-principe
name	bm-edge-role-principe
pagePin	1

Ablauf der Bereitstellung

Installieren Sie BlueMind auf dem Hauptserver nach dem üblichen Verfahren
Note
Der Speicherplatz für BlueMind-Backups muss auf diesem neuen Server unter /var/backups/bluemind zugänglich sein

Installieren Sie das Abonnement auf dem sekundären Server als Datei

Info

Zur Erinnerung: Die Textdatei, die dem Abonnement entspricht, kann manuell auf einem Server installiert werden

für Ubuntu / Debian als /etc/apt/sources.list.d/bm.list
für RedHat / CentOS als /etc/yum.repos.d/bm.repo

installieren Sie das Paket bm-edge-role auf dem Edge-Server:
Tabs group
border all-sides
navcolor navy
Debian/UbuntuRedHat/CentOS
Dem Edge-Server im Administrationsbereich des Hauptservers die Rolle des smtp-Relays hinzufügen:
- Auf dem Hauptserver mit dem Benutzer admin0@global.virt die Verbindung zu BlueMind herstellen
- Navigieren Sie zu Systemadministration > Application Servers
- Klicken Sie auf die Schaltfläche Neu > Server
- Geben Sie die neuen Serverinformationen ein und klicken Sie auf Erstellen
  
  Klicken Sie auf "Erstellen & Editieren" oder auf "Erstellen" und in der Liste der Server auf die entsprechende Zeile
- Gehen Sie auf die Registerkarte Server-Rollen:
  - Aktivieren Sie die Rolle "Mail-Relay"
  - Wenn Sie nginx von BlueMind auf diesem Serververwenden, aktivieren Sie auch die Rolle „HTTPS-Proxy Relay (DMZ)"
  - Klicken Sie auf "Speichern"
- In der Liste der Server erscheint der Edge-Server nun mit dem Tag, das mit dem Mail/Smtp-Edge-Mail-Relay verknüpft ist
Die Domain für die Verwendung dieses Servers als Mail-Relaykonfigurieren
- Bleiben Sie als Benutzer admin0@global.virt angemeldet und gehen Sie zu Systemadministration > Überwachte Domains
- klicken Sie auf die Zeile, die der zu konfigurierenden Domain entspricht
- Wählen Sie auf der Registerkarte Messaging den Edge-Server als Mail-Relay aus und klicken Sie auf Speichern:
Konfiguration des Servers, um ausgehende E-Mails über das Relay zu schicken:
- Bleiben Sie als Benutzer admin0@global.virt angemeldet und gehen Sie zu Systemadministration > Systemkonfiguration
- Füllen Sie in der Registerkarte Messaging das Feld Relay mit der IP-Adresse oder dem Hostnamen des Edge-Servers aus und klicken Sie auf Speichern:

Nginx

Konfigurieren des Webzugriffs

Info
Wenn Sie nginx von BlueMind verwenden und daher die „Proxy-Relay“-Rolle auf diesem Server aktiviert haben (siehe oben), betrifft dieser Abschnitt Sie nicht. Sie können zu Punkt 4.2 unten übergehen.

Melden Sie sich als root auf dem Edge-Server an
Gehen Sie zum Ordner /etc/nginx/sites-available
Code Block
bm35-edge.bluemind.loc:~# cd /etc/nginx/sites-available
Erstellen Sie eine bm-proxy-Konfigurationsdatei und bearbeiten Sie diese z.B. mit vim:
Code Block
bm35-edge.bluemind.loc:/etc/nginx/sites-available# vim bm-proxy

Fügen Sie die folgenden Zeilen ein:

Code Block

server {
  listen 80;
  # <url_externe_bluemind> désigne l'url externe à laquelle les utilisateurs se connectent
  server_name <url_externe_bluemind>;

  location / {
	return 301 https://<url_externe_bluemind>$request_uri;
  }
}

server {
  listen 443 ssl http2;
  server_name <url_externe_bluemind>;

  ssl_certificate /etc/ssl/certs/bm_cert.pem;
  ssl_certificate_key /etc/ssl/certs/bm_cert.pem;
  ssl_session_timeout 5m;
  ssl_prefer_server_ciphers on;

  ssl_protocols TLSv1.2;
  ssl_ciphers 'EDH+CAMELLIA:EDH+aRSA:EECDH+aRSA+AESGCM:EECDH+aRSA+SHA384:EECDH+aRSA+SHA256:EECDH:+CAMELLIA256:+AES256:+CAMELLIA128:+AES128:+SSLv3:!aNULL:!eNULL:!LOW:!3DES:!MD5:!EXP:!PSK:!DSS:!RC4:!SEED:!ECDSA:CAMELLIA256-SHA:AES256-SHA:CAMELLIA128-SHA:AES128-SHA';
  add_header Strict-Transport-Security max-age=15768000; # six months

 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

 location / {
	# <srv_interne> est le serveur BlueMind principal
    proxy_pass https://<srv_interne>;
  }

  location /webmail/ {
    client_max_body_size 0m;
    proxy_pass https://<srv_interne>/webmail/;
  }

  location /Microsoft-Server-ActiveSync {
    proxy_pass https://<srv_interne>/Microsoft-Server-ActiveSync;
    proxy_read_timeout 1200s;
    proxy_headers_hash_bucket_size 128;
    proxy_headers_hash_max_size 2048;
    client_max_body_size 0m;
    proxy_pass_header Server;
  } 

  location /eventbus {
    proxy_pass https://<srv_interne>;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
  }

  location /api/filehosting/ {
    client_max_body_size 0m;
    proxy_pass https://<srv_interne>$request_uri;
    proxy_set_header        X-Real-IP       $remote_addr;
    proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_http_version 1.1;
    proxy_buffering off;
  }

  location /api/attachment/ {
    client_max_body_size 0m;
    proxy_pass https://<srv_interne>$request_uri;
    proxy_set_header        X-Real-IP       $remote_addr;
    proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_http_version 1.1;
    proxy_buffering off;
  }

  location /fh/ {
    proxy_pass https://<srv_interne>/fh/;
    proxy_http_version 1.1;
    proxy_buffering off;
  }
}

Speichern Sie die Datei und schließen Sie den Editor

Führen Sie die folgenden Befehle aus, um die Konfiguration einzurichten:

Code Block

bm35-edge.bluemind.loc:/etc/nginx/sites-available# ln -s /etc/nginx/sites-available/bm-proxy /etc/nginx/sites-enabled/
bm35-edge.bluemind.loc:/etc/nginx/sites-available# rm /etc/nginx/sites-enabled/default

Laden Sie die nginx-Serverkonfiguration neu:

Code Block
bm35-edge.bluemind.loc:/etc/nginx/sites-available# service bm-nginx reload

Messaging-Konfiguration

Kopieren Sie auf dem Edge-Server die Hauptserver-Konfigurationsdatei, die sich unter /etc/nginx/global.d/bm-proxy-mail.conf befindet. Dies kann mit scp erfolgen:
Code Block
bm35-edge.bluemind.loc:~# scp root@srv1.bluemind.loc:/etc/nginx/global.d/bm-mail-proxy.conf /etc/nginx/global.d/
Bearbeiten Sie die Datei /etc/nginx/global.d/bm-mail-proxy.conf auf dem Edge-Server und ersetzen Sie die IP-Adresse der Zeile auth_http durch die IP-Adresse des Hauptservers

Laden Sie die nginx-Konfiguration neu:

Code Block
bm35-edge.bluemind.loc:~# service bm-nginx reload

XMPP-Konfiguration

Um zu erreichen, dass der Server das XMPP-Stream-Management unterstützt:

erstellen Sie die Datei /etc/nginx/global.d/bm-xmpp-proxy.conf mit folgendem Inhalt:

Code Block
stream { upstream backend_xmpp { least_conn; server 1.2.3.4:5222; server 1.2.3.5:5222 backup; } server { listen 5222; proxy_pass backend_xmpp ; } }

Indem Sie 1.2.3.4 durch die IP-Adresse des Hauptservers oder ggf. des Servers mit der XMPP-Rolle ersetzen

Laden Sie die nginx-Konfiguration neu:

Code Block
bm35-edge.bluemind.loc:~# service bm-nginx reload

Apache-Proxy

Info
BlueMind rät jedoch davon ab, Apache als Reverse-Proxy zu verwenden

Es ist auch möglich, Apache als Proxy anstelle von Nginx zu verwenden. Dazu müssen Sie eine Version >=2.4 von Apache verwenden und die folgenden Module aktivieren:

mod_ssl
mod_proxy und mod_proxy_wstunnel
mod_rewrite

VirtualHost-Beispiel für Apache:

Code Block

<VirtualHost *:80>
        Redirect / https://<url_externe_bluemind>/
</VirtualHost>

<VirtualHost *:443>
        SSLEngine On

        SSLCertificateFile     "/etc/ssl/certs/bm_cert.pem"
        SSLCertificateKeyFile  "/etc/ssl/certs/bm_cert.pem"

        SSLProxyEngine On
        SSLProxyCheckPeerCN Off
        SSLProxyCheckPeerName Off
        SSLProxyVerify none

        # Websocket proxy
        RewriteEngine on
        RewriteCond %{HTTP:UPGRADE} ^WebSocket$ [NC]
        RewriteCond %{HTTP:CONNECTION} Upgrade$ [NC]
        RewriteRule .* wss://<srv_interne>%{REQUEST_URI} [P]

        ProxyPreserveHost On
        <Location />
                ProxyPass https://<srv_interne>/
                ProxyPassReverse https://<srv_interne>/
        </Location>
</VirtualHost>

Speichern

Page tree

Versions Compared

Old Version 54

New Version Current

Key

Introduction

Postulate

Roll-out procedure

Nginx

Setting up web access

Setting up the mail service

Setting up XMPP

Apache Proxy

Präsentation

Prinzip

Ablauf der Bereitstellung

Nginx

Konfigurieren des Webzugriffs

Messaging-Konfiguration

XMPP-Konfiguration

Apache-Proxy

Page tree

Page History

Versions Compared

Old Version 54

New Version Current

Key

Introduction

Postulate

Roll-out procedure

Nginx

Setting up web access

Setting up the mail service

Setting up XMPP

Apache Proxy

Präsentation

Prinzip

Ablauf der Bereitstellung

Nginx

Konfigurieren des Webzugriffs

Messaging-Konfiguration

XMPP-Konfiguration

Apache-Proxy