Connector for Microsoft Exchange - Troubleshooting
Media Gateway Configuration
No access to the Intrexx MediaGateway
If you encounter errors while testing the connection to the administrator account, please check the following items. To log in successfully, you must enter the following login information correctly.
- MediaGateway Connection Information
Make sure the connection details you entered for the host and port are correct. The host address should be the address of the server on which the Intrexx MediaGateway was installed. If the Intrexx Media Gateway is not located on the same server as Intrexx, you should verify that the server is generally accessible—that is, that it is available on the network or can be reached via ping. The specified port (default 8087) must be accessible and must not be blocked, for example, by a firewall.
- MediaGateway Password
The default password after installing the Intrexx Media Gateway is 1234. If you are unable to log in using this information, the password has been... U. changed. If you have forgotten this password, please contact INTREXX GmbH support.
- Media Gateway Service
If the MediaGateway is installed successfully, a Windows service named "Intrexx MediaGateway Server" is created. Check to see if the service has started and is running properly.
Cannot Access the Exchange Account
If errors occur while testing the connection to the Exchange account, please check the following items.
Exchange 2010 / 2016
- Username and Password
Enter the username and password for the Exchange account here. Use the same credentials you would use to log in to a Windows computer.
- Email
Enter the email address associated with the account here.
- Server URL
Be sure to check the Exchange server URL as well. Be sure to use the fully qualified domain name. Typically, the URL begins with the protocol https://, followed by the fully qualified domain name and ews/Exchange.asmx. Example: https://mailserver.example.org/ews/Exchange.asmx. If the URL is correct, use ping, telnet, or nslookup in a command prompt to check whether the server is accessible from your current computer.
- Exchange Account Locked
If you enter incorrect login information multiple times, your account may be locked. In this case, please contact your administrator to have the account unlocked.
- Initialize Mailbox
For newly created Exchange accounts, you must access the account once via OWA or Outlook to ensure that the associated mailbox is initialized correctly.
- Outlook and OWA
Has OWA been installed on the Exchange server, and has this feature started correctly? In addition, the /exchange virtual directory must exist in the Exchange server's IIS. If this is not the case, please contact your Exchange administrator. For system security reasons, access to the /exchange virtual directory may be restricted or limited to specific computers or IP addresses. Check the access permissions in IIS on the Exchange server.
Kerberos - Exchange 2010 / 2016
Adjustment to EWSFindCountLimit
Starting with Exchange Server 2010, for security reasons, there is a limit on the maximum number of objects that are considered in a query. If a query exceeds this limit, no results will be returned. The maximum number is specified in the EWSFindCountLimit property of the ThrottlingPolicy. Starting with Exchange 2010 SP1, EWSFindCountLimit is set to 1,000 by default in the DefaultThrottlingPolicy. For example, if the "Inbox" folder contains 5,000 messages and EWSFindCountLimit is set to 1,000, a query on this folder will return no results. Only after the limit is raised to at least 5,000 can items in the inbox be retrieved. The value for EWSFindCountLimit can be defined either globally or for individual mailboxes. You can adjust the limit using the following commands, which must be run in the Exchange Management Shell.
- Global
-
Get-ThrottlingPolicy
-
Determine the name of the default policy from the output (e.g., DefaultThrottlingPolicy_3f6fa3c1-2bf1-4b54-a221-534d03203807)
-
Set-ThrottlingPolicy <PolicyName> -EWSFindCountLimit 10000 (or $NULL for unlimited)
-
iisreset (restarts IIS so that the change takes effect immediately)
-
- Per Mailbox
-
New-ThrottlingPolicy -Name "IntrexxThrottlingPolicy" -EWSFindCountLimit 10000 (or $NULL for unlimited)
-
Set-Mailbox <UserName> -ThrottlingPolicy "IntrexxThrottlingPolicy" (must be run for every user/mailbox that accesses Exchange via Intrexx)
-
iisreset
-
Calendar
TV Schedule
Recurring appointments can only be accessed if a date range is specified when querying the "Appointment" table. To do this, you must filter by the "StartDate" and "EndDate" fields.
Sorting Appointments
When the "Appointment" table is filtered by start and end dates, the appointments from the Exchange 2010/2016 server are always returned sorted in ascending order by start date. In this case, custom sorting settings in the application or browser are not supported.
IIS Server
If you are using an IIS server for your Intrexx portal, the following configurations may be required for use with the Intrexx Media Gateway.
File Uploads and Downloads
To upload or download Exchange file attachments—such as those in emails—you may need to adjust the file size limits as necessary. To do this, open the Internet Information Services (IIS) Manager and modify the ASP limit properties:
-
For the upload: Limit on the size of the entity body in the request (in bytes)
-
For download: Response buffer limit (in bytes)
Length of the query string
In the "Exchange – Resource" application, it may be necessary to increase the length of the query string when querying multiple overlapping resources. You can tell this is the case because when you try to edit overlapping resources, the browser returns the error "HTTP Error 404: Not Found." In this case, proceed as follows:
-
Open the Information Services (IIS) Manager
-
Change the feature settings for request filtering: Maximum length of a query string (in bytes)