• Become a portal pro
• Download
• Print
• My Downloads ()

• Support
• Technical Documentation
• Unified Communications Analytics 8.6.1
• Unified Communications Analytics 8.6.1 - Deployment Guide

Unified Communications Analytics 8.6.1 - Deployment Guide

Table of Contents  

Prerequisites for your installation

Overview Supported environments

Supported browsers

Architecture

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

Planning for deployment Determining where to install services What files should be excluded from anti-virus software? What files need to communicate through software firewalls? 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 additional Storage Engine services 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

Recommendations for collecting from Office 365 When would I use the Delete Data option?

How often do collections update the data? Viewing the collection job status Forcing a data source collection to run now Renaming a data source Identifying your internal domains Classifying domains for message traffic Setting where data calculation for insights is performed Setting time zone usage for all users Granting full access to Admin Settings Granting users access to data 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 Creating a data source for Skype for Business/Lync QoE 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 additional Storage Engines Deploying additional collectors Using the Tools menu for support activities Modifying the Data Query Availability job run Modifying collection days for IIS log and Exchange tracking log collections Changing default values for formatted .csv or .tsv file exports Changing the PowerShell wait time after transient errors Modifying timeout values for EWS collection jobs

Appendix A:Configuring Impersonation

Setting impersonation for Exchange 2013/2016/2019 Setting impersonation for Office 365

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:Custom configurations and backup and recovery options

Setting up a multi-forest environment with a one-way trust Firewall configuration: ports for data collection 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 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 F: Questions and answers about configuration

Introduction

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?

• Viewing Topics 41 - 44 of 202

×

Adding and configuring data sources

You can configure the data sources to create the data collections that collect information from different environments. The workflow to add data sources and set up data collection is similar for each target environment.

 

Data source name	Types of information collected
Active Directory data sources for Active Directory Forest/Office 365 Hybrid target environment
Domain Controller	User, group, and contact data from Active Directory. See Creating an Domain Controller data source .
Office 365 User Subscription Configuration	User subscription information including licenses and subscribed services such as Exchange Online, Skype for Business Online, SharePoint Online, using remote PowerShell. See To set up an Office 365 user subscription configuration collection
Azure Active Directory data sources for native Office 365 target environment
Office 365 User Subscription Configuration	User subscription information including licenses and subscribed services such as Exchange Online, Skype for Business Online, SharePoint Online, using remote PowerShell. See To set up an Office 365 user subscription configuration collection
Exchange data sources for Active Directory Forest/Office 365 Hybrid target environment
Exchange Configuration	Exchange configuration from the Exchange server including organization, server, DAG, mailbox, database status, database copy, mobile device configuration, personal archive and mailbox statistics. See Creating an Exchange Configuration data source .
Exchange Tracking Logs	Exchange message traffic and DLP rule matches from your Exchange message tracking logs. See Creating an Exchange Tracking Logs data source .
Exchange Mailbox Contents	Exchange message data through Exchange Web Services (EWS) from your target mailboxes. See Creating an Exchange Mailbox Contents data source .
Exchange Calendar	Exchange calendar data including meetings and appointments that were created by your users in Outlook. See Creating an Exchange Calendar data source .
Exchange IIS Logs	Mobile device events and email statistics from the ActiveSync IIS log files on Exchange Client Access Services (CAS). Also can collect Outlook on the Web (OWA) logon details. See Creating an Exchange IIS Logs data source .
Exchange Mailbox Content Summary	Statistics including size and number of items for mailbox folders such as Inbox, Deleted Items, and Junk E-Mail. See Creating an Exchange Mailbox Content Summary data source .
Exchange Public Folders	Statistics for legacy public folders (Exchange 2010) and for new public folders (Exchange 2013, Exchange 2016, and Exchange 2019). See Creating an Exchange Public Folders data source .
Exchange Online Hybrid User Configuration	Detailed information for Exchange Online users and distribution groups in a hybrid environment. See Creating an Exchange Online Hybrid User Configuration data source .
Exchange Online Hybrid Mailbox Configuration	Exchange Online mailbox statistics, permissions, and mobile device data from a hybrid (Office 365 and on-premise Exchange) environment. See Creating an Exchange Online Hybrid Mailbox Configuration data source .
Exchange Online Mailbox Contents	Information about email traffic from Exchange Online user mailboxes using Exchange Web Services (EWS). You can collect from some or all mailboxes. See Creating an Exchange Online Mailbox Contents data source .
Exchange Online Mailbox Content Summary	Statistics including size and number of items for mailbox folders for Exchange Online mailbox users. See Creating an Exchange Online Mailbox Content Summary data source .
Exchange Online Public Folders	Public folder statistics and configuration information from Office 365 using PowerShell. See Creating an Exchange Online Public Folders data source .
Exchange Online Calendar	Exchange Online calendar data including meetings and appointments that were created by your users in Outlook. See Creating an Exchange Online Calendar data source .
Exchange Online data sources for native Office 365 target environment
Exchange Online Native User Configuration	Exchange Online user and group data from a native Office 365 environment using PowerShell. See Creating an Exchange Online Native User Configuration data source .
Exchange Online Native Mailbox Configuration	Exchange Online mailbox configuration including statistics, permissions and mobile devices from native Office 365 using remote PowerShell. See Creating an Exchange Online Native Mailbox Configuration data source .
Exchange Online Mailbox Contents	Information about email traffic from Exchange Online user mailboxes using Exchange Web Services (EWS). You can collect from some or all mailboxes. See Permissions needed for Exchange Online Mailbox Contents data .
Exchange Online Mailbox Content Summary	Statistics including size and number of items for mailbox folders for Exchange Online mailbox users. See Creating an Exchange Online Mailbox Content Summary data source .
Exchange Online Public Folders	Public folder statistics and configuration information from Office 365 using PowerShell. See Creating an Exchange Online Public Folders data source .
Exchange Online Calendar	Exchange Online calendar data including meetings and appointments that were created by your users in Outlook. See Creating an Exchange Online Calendar data source .
Skype for Business/Lync data sources for on-premise Active Directory forest target environment
Skype for Business/Lync Configuration	Server, pool, and user policy configuration data directly from the Skype for Business/Lync server. See Creating a data source for Skype for Business/Lync configuration .
Skype for Business/Lync CDR Database	Skype for Business/Lync peer-to-peer session and conference data from the CDR database. See Creating a data source for Skype for Business/Lync CDR .
Skype for Business/Lync QoE Database	Skype for Business/Lync Quality of Experience (QoE) data from the QoE database. Creating a data source for Skype for Business/Lync QoE .
Cisco data sources for on-premise Active Directory forest target environment
Cisco Configuration	Cisco server and end-user data the Cisco Unified Communications Manager server and synchronized user data from Active Directory. See Creating a data source for Cisco configuration .
Cisco CDR Logs	Cisco peer-to-peer call, ad hoc conference call, and meet-me conference call information from Cisco CDR log files. See Creating a data source for Cisco CDR logs .

To set up data collection for your environments

1	Click the gear icon on the home page side bar.

2	Click Data Collection.

3	Click + beside the name of the target environment.

4	Select the data sources for Active Directory (Domain Controller), Exchange, Skype for Business/Lync, Cisco, and Office 365 from which you want to collect data.

Tiles for each data source are displayed.

5	Click the data source tile to enter the configuration information for the data collection.

6	For specific instructions about how to create data sources for each supported platform, see the following sections:

•	Adding data sources for Active Directory or Azure Active Directory

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

•	Adding data sources, chargeback costs, and thresholds for Skype for Business/Lync

•	Adding data sources, chargeback, and thresholds for Cisco

Adding more than one instance of the same data source

You must add data sources for each target environment that you have created. So if you have two Active Directory forests added as target environments, you would add the same data sources for each target environment.

For performance reasons, you can add multiple data sources of the same type to distribute the collection load or for different platform versions. For example, you would add an Exchange configuration data source for your Exchange 2010 servers and an Exchange configuration data source for your Exchange 2013/2016/2019 servers.

You can use the rename option to rename each data source so that it reflects the information that is being collected. For information about renaming data sources, see Renaming a data source .

After a data collection is created and is running on a regular basis, you can modify the collection. For example, you could select additional types of data to be collected.

Specifying explicit domain controllers for LDAP connections

For data sources that require an LDAP connection, auto-discovery is used by default to determine the domain controller that is used. However, for a large environment, you might want to explicitly specify a pool of domain controllers to be used rather than using auto-discovery.

For example, in a large environment you might configure six or more Exchange Configuration data sources, several Tracking Logs data sources, and several IIS Logs data sources. If all the data sources use auto-discovery for the LDAP connection, the data sources would tend to use the same domain controller. To avoid this situation, you can specify a pool of domain controllers to be used for certain collections to spread the gathering load.

If you decide to specify a pool of domain controllers, UC Analytics will resolve the LDAP connection to the first available domain controller. If several different data collections use the same pool with the same sequence of domain controllers, the data source collections may all resolve to the same domain controller. For this reason, you should vary the first domain controller that is specified when you specify a pool of domain controllers for a collection.

The following data sources require LDAP connections:

•	Domain Controller

•	Exchange Configuration

•	Exchange Mailbox Contents

•	Exchange IIS Logs

•	Exchange Tracking Logs

•	Exchange Mailbox Content Summary

•	Exchange Calendar

•	Exchange Online Hybrid User Configuration

•	Exchange Online Hybrid Mailbox Configuration

•	Skype for Business/Lync Configuration

•	Cisco Configuration

To explicitly specify domain controllers for LDAP connections

1	On the data source configuration page, select Show advance settings in the LDAP Connection Parameters section.

2	Under Global Catalog Domain Controller, select Use specific domain controller and click Add domain controller.

3	Enter the host name or FQDN for the domain controller and click Add.

4	Repeat step 3. for each domain controller you want to add.

- OR -

5	Enter the FQDN or host names for all the domain controllers you want, each entry separated by a semi-colon (;), and click Add.

Recommendations for collecting from Office 365

Many of the data sources that collect from Office 365, including Exchange Online (hybrid or native), use remote PowerShell to collect the data from Office 365. You must specify the account is used to connect to Exchange Online when you configure the data source.

It is recommended that you specify a different account for the PowerShell credentials that are used for each Exchange Online or Office 365 data source that you configure.

When would I use the Delete Data option?

On the Data Collections page, there is a Delete Data button. Typically you only use this option if you want to delete all the data you have collected. To do this, you must first delete all the data sources that you have configured. By deleting all the data sources and then deleting all the collected data, you can essentially start over again.

If you only want to remove old data, adjust the time period for data retention.

How often do collections update the data?

By default, each data collection has a default job interval set. When you configure a data collection, you have the option of changing the schedule for that collection to a different run interval or to an explicit time every x days. For some types of data, the data is collected only once a day regardless of the set schedule so the new data will not be available in insights until the following day.

Essentially, there are two types of data source collections that you can schedule:

•	Data source jobs that collect and update data every time the data collection job is run.

•	Data source jobs that collect a “snapshot” of data once a day, regardless of how often the data collection job is run.

For each data source collection that you configure, you have the option of setting an explicit schedule (run at a specific time every x days). The main advantage of setting an explicit schedule for a data source collection is that it allows you to have jobs run separately over different time periods. This option is useful for staggering when jobs run in environments with a large number of configured data source jobs.

Collects and updates each time job is run

Some of the data collections update each time that the collection job is run. For these data collections, only the data that changed from the previous job run is gathered. The data collections that update the data that changed since the last job run are as follows:

•	Exchange Tracking Logs (message traffic, DLP matches) using PowerShell and LDAP.

•	Exchange Mailbox Contents (message information) using LDAP and EWS.

•	Exchange ActiveSync IIS Logs (mobile device event and email statistics, OWA logons) using PowerShell and LDAP.

•	Exchange Online Mailbox Contents (message information) using EWS.

•	Skype for Business/Lync CDR Database (peer-to-peer session and conference information)

•	Skype for Business/Lync QoE Database (Quality of Experience data)

•	Cisco CDR Logs (peer-to-peer calls, ad hoc conference calls, and meet-me conference calls)

Collects a once-a-day data “snapshot”

Some data collections take a once-a-day “snapshot” of the data even if they are scheduled to run more than once a day. Data collections that gather data only once a day are follows:

•	Domain Controller (user information from Active Directory) through LDAP.

•	Exchange Configuration (Exchange server, database, mailbox, mobile device configuration, and statistics) using LDAP and PowerShell.

•	Exchange Mailbox Content Summary (mailbox folder statistics for Exchange user mailboxes) using LDAP and EWS.

•	Exchange Public Folders (statistics for legacy Exchange 2010 and new Exchange 2013/2016/2019 public folders using remote PowerShell.

•	Exchange Online Hybrid Mailbox Configuration (mailbox information) using LDAP and PowerShell.

•	Exchange Online Hybrid User Configuration (users and distribution groups) in hybrid environments using LDAP and remote PowerShell.

•	Exchange Online Native Mailbox Configuration (mailbox information) using remote PowerShell.

•	Exchange Online Native User Configuration (user information) using remote PowerShell.

•	Office 365 User Subscription Configuration (subscription configuration) using remote PowerShell.

•	Exchange Online Mailbox Content Summary (mailbox folder statistics) for Exchange Online user mailboxes using EWS.

•	Exchange Online Public Folders (public folder statistics and configuration) using remote PowerShell.

•	Skype for Business/Lync Configuration (server, pool, and user policy configuration) using LDAP and PowerShell.

•	Cisco Configuration (LDAP for Active Directory and Cisco Unified Communications Manager)

Data sources that run in background as needed

Additionally, there are data collections that run in the background and update data only as needed:

•	Database Consistency (used to ensure messages received before and after UTC midnight are inserted in the database only once).

•	Exchange Calculation (recipient response times, message delivery times)

•	Cisco Calculation (duration times for ad hoc conferences)

•	Data Query Availability (used to make the data available for queries. Data collected between runs of the Data Query Availability job are not available until the job runs)

For more information, see How often do the data collections actually gather data and when do they run? .

•  Previous
• Viewing Topics 41 - 44 of 202
• Next 

Search this document Search all documents for this product-version Search all documents for this product Search all documents

×

 Welcome to Quest Support

You can find online support help for Quest *product* on an affiliate support site. Click continue to be directed to the correct support content and assistance for *product*.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating

© 2024 Quest Software Inc. ALL RIGHTS RESERVED. Feedback Terms of Use Privacy Cookie Preference Center