Chat now with support

Live-Hilfe anfordern
Registrierung abschließen

Anmelden

Preisinformationen anfragen

Vertrieb kontaktieren

Unified Communications Analytics 8.8.3 - Deployment Guide

Inhaltsnavigation

Prerequisites for your installation

Overview Supported environments

Supported browsers

Information stored by the Storage Engine

Deployment options Hardware minimum requirements

Suggested hardware configurations for different size environments

Software prerequisites

Prerequisites for the UC Analytics services Web site prerequisites

Firewall configuration: ports for data collection Planning for deployment Determining where to install services What files need to communicate through software firewalls? What files should be excluded from anti-virus software? About UC Analytics configuration

Installing UC Analytics

Types of installations

Upgrading from 8.1 or later

Considerations before you install

About a pilot installation About a production installation

Accounts used during installation Performing a pilot installation Performing a production installation

Installing a second Storage Engine after installation Installing additional collector roles

Activating the UC Analytics license Setting up the web site for HTTPS

Configuring UC Analytics

About administration settings How do I set a user to be a product administrator? Configuration process overview Modifying the initial target environment Adding multiple Active Directory forests Configuring UC Analytics for resource forests Adding a target environment for native Office 365 Setting the time period for retaining data Setting the start date for data collection Adding and configuring data sources

Entering multiple values in a field Recommendations for collecting from Office 365

How often do collections update the data? Viewing the collection job status Forcing a data source collection to run now Renaming a data source

When would I use the Delete Data option?

Managing data sources through batch operations Managing credentials used by multiple data sources Identifying your internal domains Classifying domains for message traffic Setting where data calculation for insights is performed Excluding <none> values from insights Excluding today's data in insights Setting time zone usage for all users Granting full access to Admin Settings Granting users access to data Setting working hours for rooms Accessing the UC Analytics web site

Adding data sources for Active Directory or Azure Active Directory

Adding data sources for different target environments Permissions needed to collect Active Directory data Adding data sources for Active Directory / Office 365 (hybrid)

Creating an Domain Controller data source Creating a data source for Office 365 user subscription configuration

Adding data sources for native Office 365

Adding data sources, chargeback costs, and thresholds for Exchange and Exchange Online

Permissions needed to collect Exchange on-premises or hybrid data

Permissions needed for the Exchange Configuration data source Permissions needed for the Exchange Tracking Logs data source Permissions needed for Exchange Mailbox Contents, Exchange Mailbox Content Summary, or Exchange Calendar data sources Permissions needed for the Exchange IIS Logs (ActiveSync and OWA) data source Permissions needed for the Exchange Public Folders data source Permissions needed for the Exchange Online Hybrid User Configuration data source Permissions needed for the Exchange OnlineHybrid Mailbox Configuration data source Permissions needed for the Exchange OnlinePublic Folders data source Permissions needed for Exchange Online Mailbox Contents data Permissions needed for Exchange Online Mailbox Content Summary and Exchange Online Calendar data

Permissions needed to collect from native Exchange Online Creating an Exchange Configuration data source

Best practices for gathering performance Using dynamic distribution groups to select target mailboxes What types of mailboxes are excluded? Can I enter the Domain Users group as the target for the data collection? Troubleshooting the Exchange configuration collection

Creating an Exchange Tracking Logs data source Creating an Exchange Mailbox Contents data source

Tips for better performance for mailbox contents collection

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

About AD synchronization methods for hybrid Exchange Online About PowerShell collection method options Creating an Exchange Online Hybrid User Configuration data source Creating an Exchange Online Hybrid Mailbox Configuration data source

Adding Exchange Online data sources for native Office 365

Creating an Exchange Online Native User Configuration data source Creating an Exchange Online Native Mailbox Configuration data source Creating an Exchange Online Mailbox Contents data source Creating an Exchange Online Mailbox Content Summary data source Creating an Exchange Online Calendar data source Creating an Exchange Online Public Folders data source

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

Permissions needed to collect Skype for Business/Lync data

Permissions needed for Skype for Business/Lync configuration data source Permissions needed for Skype for Business/Lync CDR data source Permissions needed for Skype for Business/Lync QoE data source

Creating a data source for Skype for Business/Lync configuration Creating a data source for Skype for Business/Lync CDR Database Creating a data source for Skype for Business/Lync QoE Database Setting call classifications for Skype for Business/Lync Setting chargeback costs for Skype for Business/Lync Setting thresholds for Skype for Business/Lync metrics

Adding new threshold classifications

Adding data sources, chargeback, and thresholds for Cisco

Permissions needed to collect Cisco data

Permissions needed for the Cisco configuration data source Permissions needed for the Cisco CDR logs data source

Creating a data source for Cisco configuration Creating a data source for Cisco CDR logs Setting call classifications for Cisco Setting chargeback costs for Cisco Setting thresholds for Cisco metrics

Managing which insights can seen by users

Enabling a Company Home Page Setting insight visibility settings

Configuring and managing subscriptions

What are insight subscriptions? Configuring settings for subscriptions Managing user subscriptions

Making changes to your deployment

Options available in the Deployment Manager Changing the service account Deploying a second Storage Engine Deploying additional collectors Using the Tools menu for support activities

Appendix A:Configuring Exchange and Office 365

Overview Setting impersonation for Exchange 2013/2016/2019 Configuring impersonation for Office 365 Registering UC Analytics with the Microsoft Azure portal Installing the Exchange Online PowerShell module Setting up a multi-forest environment with a one-way trust

Appendix B:Configuring the Skype for Business or Lync Server

Configuring Lync Server 2010

1. Adding the SQL store for monitoring 2. Installing the Monitoring role 3. Enabling Call Detail Recording (CDR) 4. Starting the monitoring services

Configuring Lync Server 2013 or Skype for Business 2015/2019

1. Associating the store with the Front-End pool 2. Updating the Lync or Skype for Business Server 3. Enabling and configuring monitoring 4. Starting the monitoring services

Appendix C:Configuring IIS Log Files to capture ActiveSync or OWA events

Configuring IIS Logging on the Exchange CAS and Mailbox servers

Configuring IIS if Exchange is hosted on Windows 2003 Server Configuring IIS Logging if Exchange is hosted on Windows Server 2008 or later

What ActiveSync events are collected and displayed in the insights?

Appendix D:PowerShell cmdlets used by data sources

Exchange Configuration data source Exchange and Exchange Online Public Folders data sources Skype for Business/Lync Configuration data source Exchange Online Hybrid and Native User Configuration data sources Exchange Online Hybrid and Native Mailbox Configuration data sources Exchange Online Mailbox Contents data source Office 365 User Subscription Configuration data source

Appendix E:Backup and recovery options

Backing up and restoring your data using scripts

Supported scenarios About the backup and restore batch files

Prerequisites

Step 1: Edit the backup.bat file parameters for your installation Step 2: Run the backup batch file Step 3: Edit the restore batch file Step 4a: Restore the storage data in an existing installation Step 4b: Restore the storage data to a new installation

Scheduling the backup batch file to run automatically Performing a manual backup of the storage folder before upgrade Moving your storage location Recommendations for disaster recovery

Appendix F:Custom configurations

Setting LDAP connections to use LDAPS (LDAP over SSL) Modifying the Data Query Availability job run Modifying collection days for data collections from log files Changing initial collection days for Exchange (Online) Mailbox Contents data sources Changing default values for formatted .csv or .tsv file exports Excluding insight date range and filters from subscription emails Changing the PowerShell wait time after transient errors Changing the PowerShell reconnect interval for Exchange Online Mailbox Configuration jobs Modifying timeout values for EWS collection jobs Setting a custom title page for exported or subscription insights Changing the interval time before job status is purged Configuring remote PowerShell to use the required proxy settings Overriding PowerShell credential winnowing Registry settings that affect service shutdown and startup

Appendix G: Questions and answers about UC Analytics

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 andExchange 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 ExchangeMailbox Contents and Exchange Tracking Logs data sources? Why do I get an error when collecting Exchangeconfiguration 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?

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"

powerShellIdleTimeout="60"

powerShellOpenTimeout="60"

powerShellOperationTimeout="60"

<exchangeOnlineUserJobSettings

powerShellSecondsAfterTransientServerProblem="0"

powerShellIdleTimeout="60"

powerShellOpenTimeout="60"

powerShellOperationTimeout="60"

<office365UserSubscriptionJobSettings

powerShellSecondsAfterTransientServerProblem="0"

powerShellIdleTimeout="60"

powerShellOpenTimeout="60"

powerShellOperationTimeout="60"

<exchangeOnlineMailboxJobSettings

powerShellSecondsAfterTransientServerProblem="0"

powerShellIdleTimeout="60"

powerShellOpenTimeout="60"

powerShellOperationTimeout="60"

<exchangeOnlinePublicFoldersJobSettings

powerShellSecondsAfterTransientServerProblem="0"

powerShellIdleTimeout="60"

powerShellOpenTimeout="60"

powerShellOperationTimeout="60"

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.

Changing the PowerShell reconnect interval for Exchange Online Mailbox Configuration jobs

To prevent Office 365 throttling in the Exchange Online (Native / Hybrid) Mailbox Configuration data collections when using the same credential, UC Analytics disconnects the PowerShell connection after each round in the job. To prevent the job from running too slowly over time, UC Analytics reconnects the PowerShell session periodically. By default, the reconnection interval time is 60 minutes. If the connection is currently in use, it is disconnected only after the current batch of mailboxes (in which the connection is being used) is completed.

You can change the time interval that is used for the PowerShell reconnection by editing the UC.Analytics.Insights.DataEngine.DataCollector.dll.config file. If you set the reconnection time to 0, UC Analytics will not re-establish the PowerShell session.

To modify the PowerShell reconnection time

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:

<exchangeOnlineMailboxJobSettings

powerShellTimeoutMinutes="30"

powerShellBatchSize="50"

powerShellConnectionReestablishMinutes="60"

3

After powerShellConnectionReestablishMinutes, enter a new value for the number of minutes that UC Analytics should wait before re-establishing the PowerShell session.

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.

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	“	"
Apostrophe	‘	'
Ampersand	&	&
Less than	<	<
Greater than	>	>

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 &Co."/>

</insightRenderingConfiguration>

</configuration>

5

Save your changes.

6

For the changes to take effect, restart the Data Engine service.

Verwandte Dokumente

The document was helpful.

Bewertung auswählen

I easily found the information I needed.

Bewertung auswählen

© ALL RIGHTS RESERVED. Nutzungsbedingungen Datenschutz Cookie Preference Center