Chat now with support
Chat with Support

Unified Communications Analytics 8.6.1 - Deployment Guide

Prerequisites for your installation Installing UC Analytics Configuring UC Analytics Adding data sources for Active Directory or Azure Active Directory Adding data sources, chargeback costs, and thresholds for Exchange and Exchange Online
Permissions needed to collect Exchange on-premises or hybrid data Permissions needed to collect from native Exchange Online Creating an Exchange Configuration data source Creating an Exchange Tracking Logs data source Creating an Exchange Mailbox Contents data source Do I need both Exchange Tracking Logs and Exchange Mailbox Contents collections? Creating an Exchange IIS Logs data source Creating an Exchange Mailbox Content Summary data source Creating an Exchange Calendar data source Creating an Exchange Public Folders data source Adding Exchange Online hybrid data sources for hybrid Office 365 Adding Exchange Online data sources for native Office 365 Setting chargeback costs for Exchange Setting thresholds for Exchange metrics Omitting words when filtering by subject or body
Adding data sources, chargeback costs, and thresholds for Skype for Business/Lync Adding data sources, chargeback, and thresholds for Cisco Managing which insights can seen by users Configuring and managing subscriptions Making changes to your deployment Appendix A:Configuring Impersonation Appendix B:Configuring the Skype for Business or Lync Server Appendix C:Configuring IIS Log Files to capture ActiveSync or OWA events Appendix D:PowerShell cmdlets used by data sources Appendix E:Custom configurations and backup and recovery options Appendix F: Questions and answers about configuration

Changing the PowerShell wait time after transient errors

When the PowerShell exception "An error caused a change in the current set of domain controllers" occurred in the following data source collections, UC Analytics would wait for 300 seconds before retrying. Now it will create a new session and retry immediately (by default).

•
Exchange Online Native/Hybrid Mailbox Configuration
•
Exchange Online Native/Hybrid User Configuration
•
Exchange Online Mailbox Contents
•
Exchange Online Public Folders
•
Office 365 User Subscription Configuration

If you want to customize the PowerShell wait time, you can edit the value for each data source.in the UC.Analytics.Insights.DataEngine.DataCollector.dll.config file.

To modify default wait time for PowerShell connection
1
Using a text editor, open the UC.Analytics.Insights.DataEngine.DataCollector.dll.config file.
By default, the file is located in C:\Program Files\Quest\UC Analytics\Data Engine.
2
Locate the following section and parameters:
<exchangeOnlineMailboxContentsJobSettings
powerShellSecondsAfterTransientServerProblem="0"
<exchangeOnlineUserJobSettings
powerShellSecondsAfterTransientServerProblem="0"
<office365UserSubscriptionJobSettings
powerShellSecondsAfterTransientServerProblem="0"
<exchangeOnlineMailboxJobSettings
powerShellSecondsAfterTransientServerProblem="0"
<exchangeOnlinePublicFoldersJobSettings
powerShellSecondsAfterTransientServerProblem="0"
3
After powerShellSecondsAfterTransientServerProblem, enter a new value for the number of seconds that UC Analytics should wait before retrying PowerShell
4
Restart the UC Analytics Data Engine service.

Modifying timeout values for EWS collection jobs

By default, the Microsoft Exchange EWS (Exchange Web Services) API sets a timeout property value of 100000 ms (100 seconds) as the default. For Office 365 data collections, this timeout value may not long enough for a data source to collect data.

Parameters in the UC.Analytics.Insights.DataEngine.DataCollector.dll.config file are used to set different timeout defaults for Exchange and Exchange Online EWS data collections to provide flexible timeout configuration and to reduce data source collection timeouts.

The default value "ewsTimoutSeconds = 100" is used for on-premises EWS job settings:

exchangeWebServicesJobSettings
exchangeMailboxContentSummaryJobSettings
exchangeCalendarJobSettings

The default value “ewsTimoutSeconds= 1800" is used for online EWS job settings:

exchangeOnlineMailboxContentsJobSettings

Data sources that are affected by the EWS timeout setting are as follows:

•
Exchange Mailbox Contents
•
Exchange Online Mailbox Contents
•
Exchange Mailbox Content Summary
•
Exchange Online Mailbox Content Summary
•
Exchange Calendar
•
Exchange Online Calendar
To modify the default timeout for online EWS collection jobs
1
Using a text editor, open the UC.Analytics.Insights.DataEngine.DataCollector.dll.config file.
By default, the file is located in C:\Program Files\Quest\UC Analytics\Data Engine.
2
Locate the following parameter:
exchangeOnlineMailboxContentsJobSettings = 1800
3
Enter a new value for the number of seconds for the EWS timeout.
4
Restart the UC Analytics Data Engine service.

Appendix A:Configuring Impersonation

Appendix A:
Configuring Impersonation

Any credentials that are used to collect data using the Exchange Mailbox Contents or the Exchange Online Mailbox Contents data sources must have application impersonation rights or “Exchange Impersonation” permissions to all the target mailboxes:

•
For information about how to set Exchange impersonation for Exchange 2013, Exchange 2016. or Exchange 2019, see Setting impersonation for Exchange 2013/2016/2019 .
•
For information about how to set Exchange impersonation for Exchange 2010, see the following Microsoft article: Configuring Exchange Impersonation.
•
For information about how to set impersonation for Office 365, see Setting impersonation for Office 365 .

Setting impersonation for Exchange 2013/2016/2019

To collect data from Exchange 2013/2016/2019, the credentials used to collect Exchange data must have Application Impersonation rights for the mailboxes from which you are collecting.

To set impersonation for the collection credentials
1
Open the web-based Exchange Admin Center (EAC) for your Exchange server.
2
Click Permissions.
3
Under Admin Roles, click +.
4
Enter a name for the new role group, such as Impersonation for Exchange.
5
Under the Roles heading, click +.
6
Select ApplicationImpersonation and click add->.
7
Click OK.
8
Under the Users heading, click +.
9
Select an account to be used to collect the mailbox contents data from Exchange and click OK.
Ensure that all the accounts you are using for Exchange Mailbox Contents data collections are added to this role group.
10
Click Save.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating