MediaGateway installieren

Lizenzierung

Für den Einsatz des Connectors für Microsoft Exchange müssen Sie eine Lizenz erwerben. Zur Freischaltung des Connectors starten Sie den Intrexx Portal Manager. Öffnen Sie den Lizenzmanager über das Hauptmenü "Extras / Lizenzmanager".

Voraussetzung - .NET Framework 4.8

Die mit Intrexx Steady Track 11.2 ausgelieferte MediaGateway-Version erfordert das .NET Framework 4.8. Installieren Sie dieses vor der Installation bzw. vor dem Update des MediaGateway.

Installation

Um den Intrexx Microsoft Exchange Connector nutzen zu können, müssen Sie zunächst das Intrexx MediaGateway installieren. Beim Intrexx MediaGateway handelt es sich um eine Applikation für Microsoft Windows. Sie können es auf einem beliebigen Windows Server installieren. Nach der Installation läuft das MediaGateway als regulärer Windows-Dienst.

Die Installationsdatei für das Intrexx MediaGateway finden Sie an folgender Stelle:

<IntrexxInstallationsverzeichnis>\adapter\microsoft_exchange/MediaGateway\IntrexxMediaGateway.exe

Schritt-für-Schritt

1. Führen Sie die Datei "IntrexxMediaGateway.exe" aus.

   Der Setup Assistent wird gestartet.

   

2. Folgen Sie den Anweisungen des Setup Assistenten.

3. Klicken Sie im letzten Dialog auf "Fertigstellen".

   

   Sie haben das Intrexx MediaGateway installiert.

   Nach der Installation finden Sie den MediaGateway-Prozess bzw. -Dienst im Windows Task-Manager bzw. in der Windows-Dienste-Verwaltung..

   

    

   

MediaGateway Administrationstool

Bei Bedarf steht Ihnen das MediaGateway Administrationstool zur Verfügung. Mit dessen Hilfe können Sie diverse Einstellungen und Vorgänge überprüfen oder anpassen.

MediaGateway Administrationstool starten

MgOdbcReg64.exe ausführen

Um das MediaGateway Administrationstool zu starten, müssen Sie zunächst (einmalig) die Datei MgOdbcReg64.exe ausführen.

Die Datei MgOdbcReg64.exe finden Sie an folgender Stelle:

<InstallationsverzeichnisMediaGateway>\Intrexx MediaGateway\MgOdbcDriver\MgOdbcReg64.exe

Wenn Sie der Standardinstallationsroutine gefolgt sind, finden Sie die Datei an folgender Stelle:

C:\Program Files (x86)\United Planet GmbH\Intrexx MediaGateway\MgOdbcDriver

MG.Server.Administration.exe ausführen

Die Datei MG.Server.Administration.exe finden Sie an folgender Stelle:

<InstallationsverzeichnisMediaGateway>\Intrexx MediaGateway\MgTools\MGAdministrationTool\MG.Server.Administration.exe

Wenn Sie der Standardinstallationsroutine gefolgt sind, finden Sie die Datei an folgender Stelle:

C:\Program Files (x86)\United Planet GmbH\Intrexx MediaGateway\MgTools\MGAdministrationTool\MG.Server.Administration.exe

Schritt-für-Schritt

1. Führen Sie die Datei "MG.Server.Administration.exe" aus.

   Der Login-Dialog wird angezeigt.

   

2. Erfassen Sie die erforderlichen Angaben.

   (Die Login-Daten für das Administrationstool sind dieselben, die Sie auch in Intrexx beim Einrichten der Microsoft Exchange Datenquelle verwenden.

3. Klicken Sie auf "OK".

   Das MediaGateway Administrationstool wird gestartet.

   

   Sie können nun die gewünschten Aktionen ausführen.

Aktualisierung der "Intrexx MediaGateway" Installationsdatei

Updates für das "Intrexx MediaGateway" erfolgen über die Softwareaktualisierung für Intrexx. Dabei wird die MediaGateway-Installationsdatei automatisch aktualisiert. Anschließend müssen Sie die aktualisierte Installationsdatei manuell ausführen, damit das Update wirksam wird.

Die MediaGateway-Installationsdatei finden Sie unter folgendem Pfad: <InstallationsverzeichnisIntrexx>\adapter\msexchange\IntrexxMediaGateway.exe

Update für Intrexx MediaGateway ab Intrexx 11 ausführen

Vorbemerkung

Für die Kommunikation mit dem MediaGateway (ConnectBridge) verwendete der Exchange Connector bis Intrexx Steady 11 das CORBA Protokoll. Im Zuge der besseren Unterstützung für Exchange Online/MS365 wurde der Connector für die OAuth2-Anmeldung erweitert und das Kommunikationsprotokoll auf gRPC umgestellt. Dabei ist beim Update des Exchange Connectors bzw. beim Upgrade von Intrexx auf Version 11 Steady folgende Vorgehensweise zu beachten.

• Vor dem Intrexx-Upgrade sollten Sie das Admin-Passwort des MediaGateways über die Exchange Konfiguration im Portal Manager auf 1234 zurücksetzen.

• Vor dem Intrexx-Upgrade sollte der Intrexx MediaGateway-Dienst beendet und der MediaGateway-Ordner gesichert werden (C:\Programme x86\United Planet GmbH\Intrexx MediaGateway). Zudem sollten Sie die Exchange Konfigurationsdatei unter <PORTAL_HOME>\internal\cfg\exchange\exchange.cfg sichern.

Vorgehensweise

Nach dem erfolgreichen Intrexx-Upgrade müssen Sie das Intrexx MediaGateway aktualisieren. Stellen Sie vor dem Update des Intrexx MediaGateways sicher, dass auf dem Windows System das .NET Framework 4.8 installiert ist.

1. Rufen Sie die Setup Routine unter <INTREXX_HOME>\adapter\msexchange\IntrexxMediaGateway.exe auf. Geben Sie als Installationsort den bisherigen MediaGateway-Installationsordner an.

2. Nach dem Update ist der MediaGateway-Dienst gestartet.

3. Starten Sie die Exchange-Konfiguration im Portal Manager. Stellen Sie auf der ersten Seite den Verbindungstyp auf gRPC um.

4. Führen Sie Verbindungstests durch und speichern Sie Ihre Angaben.

5. Ändern Sie das Admin-Passwort des MediaGateways.

Wenn Sie Exchange Online einsetzen, wird beim ersten Zugriff ein Refresh Token für den Zugriff auf Exchange Online über den Portal Manager benötigt und abgefragt. Detaillierte Informationen hierzu finden Sie in Abschnitt MS365 Refresh Token (Aktualisierungstoken) anfordern.

MediaGateway-Datenbank initialisieren

Sollte die Konfiguration nicht ohne Fehler gespeichert werden können bzw. das Exchange Refresh Token nicht ermittelt werden können, so muss die MediaGateway-Datenbank neu initialisiert werden. Dabei gehen die bisherigen Einstellungen (Exchange Freigaben) verloren und müssen neu erfasst werden.

Die MediaGateway Datenbank kann wie folgt neu initialisiert werden:

1. Setzen Sie das Admin Passwort des MediaGateway-Dienstes auf 1234 zurück.

2. Beenden Sie den MediaGateway-Dienst.

3. Benennen Sie im Installationsordner des MediaGateways den Unterordner "database" nach "database_bak" um.

4. Starten Sie den MediaGateway Dienst.

5. Öffnen Sie im Portal Manager die Exchange Konfiguration.

6. Führen Sie Verbindungstests durch und speichern Sie Ihre Angaben.

7. Erfassen Sie Freigaben auf Benutzerpostfächer über die App "Exchange-Einstellungen" bzw. über die zusätzlichen Benutzer.