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

Overriding PowerShell credential winnowing

In the Exchange Online Hybrid Mailbox Configuration and the Exchange Online Native Mailbox Configuration data sources, you can specify multiple credentials that are used to connect to Exchange Online using remote PowerShell. Sometimes, an invalid credential might be specified such as an incorrect password.

When UC Analytics connects to Exchange Online through PowerShell, if a credential cannot connect, it assumes the credential is invalid and removes the credential from the list of credentials that is being used to connect. This process of removing invalid credentials is called “winnowing”. However, in some cases the credential may be valid and inability to connect is caused by Microsoft throttling of the PowerShell connections.

If you are sure all the PowerShell credentials you have specified are valid, you can edit a configuration file to override the winnowing process.

To force the data collection to use all the specified credentials
1
On the server that hosts the UC Analytics Data Engine, navigate to the folder in which the Data Engine collector role is installed. By default, the Data Engine folder is located at:
C:\Program Files\Quest\UC Analytics\Data Engine
2
Create a backup copy of the UC.Analytics.Insights.DataEngine.DataCollector.dll.config file and save it to a different location.
3
Using a text editor, open the UC.Analytics.Insights.DataEngine.DataCollector.dll.config file.
4
Locate the following section and find the winnowPowerSheelCredentials setting.
<exchangeOnlineMailboxJobSettings
enabled="true"
powerShellMaxAttempts="3"
powerShellSecondsBetweenAttempts="300"
...
winnowPowerShellCredentials="true"/>
5
Change the value for winnowPowerShellCredentials to "false".
6
Save your change.
7
For the changes to take effect, restart the Data Engine service.

Registry settings that affect service shutdown and startup

The UC Analytics servers may be rebooted for different reasons, such as Windows Update installations. Sometimes, for computers that are heavily loaded, a reboot may cause issues if services are not allowed enough time to shut down or to start.

As of release 8.5.1, two sections in the Windows registry are updated during installation to mitigate the effects of shutting services down too quickly or not allowing services enough time to start.

Allowing more time for services to shut down

Some users experienced an issue where the monthly Windows Update installation and computer reboot caused a corrupted Commit log (size is 0 kilobytes) which stopped the Storage Engine service from restarting. The computer would reboot and the Storage engine service would restart but then quickly shut down.

The issue can occur when the Storage Engine is shut down too quickly, either by Windows Update or by an administrator. A registry value controls how many milliseconds Windows will wait for services to clean up and save data before closing. The default value is 5000 milliseconds (5 seconds) for most operating systems which may not be enough time if a computer is heavily loaded.

As of release 8.5.1, the WaitToKillServiceTimeout registry setting has been updated to allow the UC Analytics Storage Engine enough time to properly shut down.

The registry key is at the following location:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control > WaitToKillServiceTimeout

After installation, the new value is set to 900000 (milliseconds).

Allowing more time for services to start

As of release 8.5.1, another Windows registry setting was updated to allow UC Analytics services enough time to restart. Some customers would experience system timeouts when the Data Engine service was restarting.

The timeout value for the service startup in the Windows registry has been changed. In the following registry location HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control, a new DWORD Value, was created for ServicesPipeTimeout.

The value of ServicesPipeTimeout is set to 60000 (milliseconds).​

Appendix F: Questions and answers about configuration

Appendix F:
Questions and answers about configuration
•
How often do the data collections actually gather data and when do they run?
•
When I view insights that show internal vs. external traffic, there is no data for internal traffic. Why?
•
Why are my OWA insights not showing any data?
•
Why did an insight show no data for a 30-day range though I initially set the data source to collect 30 days back?
•
If I collect both Exchange Tracking Logs and Exchange Mailbox Contents, are there duplicate items?
•
If I collect message data only from the Exchange tracking logs, is the message Send Date and delivery time available?
•
What are the differences between the Exchange Mailbox Contents and Exchange Tracking Logs data sources?
•
Why do I get an error when collecting Exchange configuration from multiple Exchange versions?
•
Why do I have to specify domain name when doing a multi-forest collection?
•
What insights are affected by the “Calculate insight data on server side” option?

Introduction

This section includes common questions and provides detailed answers to help you understand and troubleshoot your UC Analytics deployment.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating