Chat now with support
Chat with Support

Unified Communications Analytics 8.7 - 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 Exchange and Office 365 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:Backup and recovery options Appendix F:Custom configurations Appendix G: Questions and answers about UC Analytics

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.

Setting a custom title page for exported or subscription insights

When you export an insight (or create an insight subscription) that uses PDF or .docx format, the exported insight displays UC Analytics and the Quest logo on the title page. You can customize the title page to include your own logo and company name by editing a file called UC.Analytics.Insights.DataEngine.InsightLogic.dll.config.

The UC.Analytics.Insights.DataEngine.InsightLogic.dll.config file contains the following text:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<section name="insightRenderingConfiguration" type="UC.Analytics.Common.General.Core.Configuration.SettingsNameValueCollection, UC.Analytics.Common.General.Core"/>
</configSections>
<insightRenderingConfiguration>
<add name="exportLogoImageFilePath" value=""/>
<add name="exportTitle" value=""/>
</insightRenderingConfiguration>
</configuration>
 

When you edit the file and enter your own values, the characters that you enter in the value fields must use valid XML characters. For certain characters, such as double quotation marks (“), ampersand (&), and apostrophe (‘), you must escape the characters to have them render correctly on the title page.

 
Table 41. Using XML special characters
Name
Character
How entered in file

Double quotation marks

“

&quot;

Apostrophe

‘

&apos;

Ampersand

&

&amp;

Less than

<

&lt;

Greater than

>

&gt;

To customize the title page for insight exports or subscriptions
1
On the server that hosts the UC Analytics Data Engine, navigate to the folder in which the Data Engine 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.InsightLogic.dll.config file and save it to a different location.
3
Using a text editor, open the UC.Analytics.Insights.DataEngine.InsightLogic.dll.config file.
Suppose that you want to show the company name Sitraka & Co. as the title and also include a graphic file that is located at C:\Users\Admin\My Pictures\CompanyLogo.png.
4
You would edit the <add key> values as shown in the following example:
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<section name="insightRenderingConfiguration" type="UC.Analytics.Common.General.Core.Configuration.SettingsNameValueCollection, UC.Analytics.Common.General.Core"/>
</configSections>
<insightRenderingConfiguration>
<add name="exportLogoImageFilePath" value="C:\Users\Admin\My Pictures\CompanyLogo.png"/>
<add name="exportTitle" value="Sitraka &amp;Co."/>
</insightRenderingConfiguration>
</configuration>
5
Save your changes.
6
For the changes to take effect, restart the Data Engine service.

Changing the interval time before job status is purged

By default, UC Analytics purges the job status summary information for a data collection job 30 days after the job has run. UC Analytics purges the job status details information after 7 days. Depending on the size and number of your data collections, you might want to modify the time periods that UC Analytics will keep job status summary and details. You can configure UC Analytics to clean out job status details records separately from job status summary records.

For example, you might decide to keep job status summary records for longer than the job status details records since the details records will occupy much more space.

To change the time period for which UC Analytics will retain job run status summary and details records, you edit the UC.Analytics.Insights.DataEngine.DataCollector.dll.config file.The configuration file is located in the data engine directory on the server that hosts a data storage engine.

To modify the job status purge intervals
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 text section in the file:
<purgeJobStatusJobSettings
enabled="true"
primaryCollectorOnly="true"
executionAlignmentTimeInMinutes="60"
executionFrequencyInMinutes="1440"
retentionPeriodInDays="30"
 
/>
5
To change the retention period for the job status details records, change the 30 beside retentionPeriodInDays= to the number of days that you want retain the job status details data.
6
Save your changes.
7
For the changes to take effect, restart the Data Engine service.

Configuring remote PowerShell to use the required proxy settings

Configuring remote PowerShell to use the required proxy settings

For the Exchange Online data sources, if your environment requires explicit proxy settings to access the internet, you must configure the Exchange Online data sources to use the required proxy settings.

To set the PowerShell proxy access type for the Exchange Online data collections
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 text in three locations in the Dell.UC.Insights.DataEngine.DataCollector.dll.config file:
powerShellProxyAccessType="None"
5
Modify the text to use the proxy setting that you want. The setting will be one of the following:
•
IEConfig
•
WinHttpConfig
•
AutoDetect
•
NoProxyServer:
For example, if you want the Exchange Online collectors to create the remote PowerShell sessions using the IE proxy configuration settings of the service account, you would set the following:
powerShellProxyAccessType="IEConfig"

These settings affect all Exchange Online data sources that use a remote PowerShell connection.

For more information about the Microsoft PowerShell proxy settings, search for New-PSSessionOption in the Microsoft PowerShell documentation web site.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating