Install the Connector for Microsoft Exchange - MediaGateway

Prerequisite: .NET Framework 4.8

The MediaGateway version included with Intrexx Steady Track 11.2 or later requires the .NET Framework 4.8. Install this before installing or updating the MediaGateway. NET Framework 4.8 can be downloaded here:

https://dotnet.microsoft.com/en-us/download/dotnet-framework/net48

Installation

To use the Intrexx Microsoft Exchange Connector, you must first install the Intrexx MediaGateway. Intrexx MediaGateway is an application for Microsoft Windows. You can install it on any Windows Server. After installation, MediaGateway runs as a standard Windows service.

The installation file for the Intrexx MediaGateway is located in the installation directory "adapter\microsoft_exchange\MediaGateway\IntrexxMediaGateway.exe".

Step-by-Step

  1. Run the "IntrexxMediaGateway.exe" file.

    The Setup Wizard will start.

  2. Follow the instructions in the Setup Wizard.

  3. In the last dialog box, click "Finish."

    You have installed the Intrexx MediaGateway.

    After installation, you can find the MediaGateway process or service in the Windows Task Manager or in the Windows Services console.

     

MediaGateway Administration Tool

If necessary, the MediaGateway Administration Tool is available to you. You can use it to check or adjust various settings and processes.

Launch the MediaGateway Administration Tool

Run MgOdbcReg64.exe

To start the MediaGateway Administration Tool, you must first (once) run the "MgOdbcReg64.exe" file.

You can find the file here:

<MediaGateway installation directory>\Intrexx MediaGateway\MgOdbcDriver\MgOdbcReg64.exe

If you followed the standard installation procedure, you will find the file in the following location:

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

Run MG.Server.Administration.exe

You can find the "MG.Server.Administration.exe" file in the following location:

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

If you followed the standard installation procedure, you'll find the file in the following location:

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

Step-by-Step

  1. Run the "MG.Server.Administration.exe" file.

    The login dialog box appears.

  2. Enter the required information.

    (The login credentials for the administration tool are the same ones you use in Intrexx when setting up the Microsoft Exchange data source.)

  3. Click "OK."

    The MediaGateway administration tool is launched.

    You can now perform the desired actions.

Updating the "Intrexx MediaGateway" Installation File

Updates for the "Intrexx MediaGateway" are installed via the Intrexx software update feature. This automatically updates the MediaGateway installation file. You must then manually run the updated installation file for the update to take effect.

You can find the MediaGateway installation file at the following path: <Intrexx installation directory>\adapter\msexchange\IntrexxMediaGateway.exe

Update for Intrexx MediaGateway as of Intrexx 11 Run

Preliminary Remarks

Up through Intrexx Steady 11, the Exchange Connector used the CORBA protocol to communicate with the MediaGateway (ConnectBridge). As part of efforts to improve support for Exchange Online/MS365, the connector for OAuth2 authentication has been enhanced and the communication protocol has been migrated to gRPC. When updating the Exchange Connector or upgrading Intrexx to version 11, please follow the procedure below.

  • Before upgrading Intrexx, you should reset the MediaGateway admin password to 1234 via the Exchange configuration in Portal Manager.

  • Before upgrading Intrexx, you should stop the Intrexx MediaGateway service and back up the MediaGateway folder (C:\Program Files (x86)\INTREXX GmbH\Intrexx MediaGateway). You should also back up the Exchange configuration file located in the portal directory "internal\cfg\exchange\exchange.cfg."

Procedure

After successfully upgrading Intrexx, you must update the Intrexx MediaGateway. Before updating the Intrexx MediaGateway, make sure that the .NET Framework 4.8 is installed on the Windows system.

  1. Run the setup routine located in the installation directory: "adapter\msexchange\IntrexxMediaGateway.exe". Specify the existing MediaGateway installation folder as the installation location.

  2. After the update, the MediaGateway service has started.

  3. Start the Exchange configuration in Portal Manager. On the first page, change the connection type to gRPC.

  4. Run connection tests and save your information.

  5. Change the MediaGateway's admin password.

If you use Exchange Online, a refresh token is required and requested the first time you access Exchange Online via Portal Manager. For detailed information on this, see the section "Request an MS365 Refresh Token."

Initialize the MediaGateway Database

If the configuration cannot be saved without errors or if the Exchange refresh token cannot be determined, the MediaGateway database must be reinitialized. This will result in the loss of the previous settings (Exchange shares), which will need to be re-entered.

The MediaGateway database can be reinitialized as follows:

  1. Reset the admin password for the MediaGateway service to 1234.

  2. Stop the MediaGateway service.

  3. In the MediaGateway installation folder, rename the "database" subfolder to "database_bak."

  4. Start the MediaGateway service.

  5. In Portal Manager, open the Exchange configuration.

  6. Run connection tests and save your information.

  7. Record permissions for user mailboxes using the "Exchange Settings" app or through the additional users.