Unified Communications Analytics 8.6.1

Chat now with support

Get Live Help
Complete Registration

Sign In

Request Pricing

Contact Sales

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 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?

Backing up and restoring your data using scripts

UC Analytics provides two scripts (batch files) that allow you to back up data from your UC Analytics Storage Engine. The backup batch file uses the “snapshot” command that is included in the Cassandra nodetool utility.

When you run the backup script, you take a snapshot of all your stored data while the Storage Engine service is running. When you take a snapshot, you are backing up your data at a specific point in time.

NOTE: This will temporarily double the amount of data in your Storage directory while the batch file runs.

Supported scenarios

About the backup and restore batch files

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

For information about creating a task to back up your data automatically, see Scheduling the backup batch file to run automatically .

Supported scenarios

The following scenarios are supported by the backup and restore scripts:

•

You can back up an existing installation and restore to the same installation

•

You can back up an existing installation and restore to a new installation.The Data Engine and Query Engine roles installed in a new installation can be different than the original installation. However, the new installation must meet the following criteria:

•

have the same number of installed Storage Engines as the old installation

•

use the same time zone settings on all Storage Engines as the old installation. UC Analytics performs the backup using a date-related label.

•

have the same server name and IP address as the old installation in which the backup was created.

For example, any of the following installations could be backed up and interchangeably restored:

Scenario 1

Server A: All components - Web Site, Data Engine (Insights), Query Engine (Insights), Data Engine (collector role, Query Engine (Collector), Storage Engine.

Server B: Storage Engine

Scenario 2

Server A: Web Site, Data Engine (Insights), Query Engine (Insights), Storage Engine

Server B: Data Engine (Collector), Query Engine (Collector), Storage Engine

Scenario 3

Server A: Web Site, Data Engine (Insights), Data Engine (Collector), Storage Engine

Server B: Query Engine (Insights), Query Engine (Collector), Storage Engine

What is backed up by the backup script?

All your configuration and collected data is backed up when you run the backup script. When you run the restore script, the configuration and collected data are restored to the state when backup was created.

The backup process saves data from all the tables in the \Storage\data\Doradus folder and creates a separate subdirectory for each saved table. Each snapshot directory contains numerous files of data captured at the time of the snapshot. The backup process also saves configuration data from the \Storage\data\System folder.

The batch file then copies the snapshot data created to the backup folder (named based on the current date and time), then removes the snapshot directories from the original Storage folder.

About the backup and restore batch files

In the UC Analytics installation path, there is a folder named Storage Engine Backup Scripts. By default, the directory is located in the following path:

C:\Program Files\Quest\UC Analytics\Storage Engine Backup Scripts

The folder contains two batch files:

•

backup.bat

•

restore.bat

The folder also contains several PowerShell script files:

•

BackupScript.ps1

•

PurgeScript.ps1

•

RestoreScript.ps1

To use the scripts, copy all the files to the folder on each server that hosts the UC Analytics Storage Engine. If you have multiple storage nodes, you must run the script on each node. All nodes must be in the same time zone.

Prerequisites

To run the backup and restore batch files, you must have PowerShell 3.0 or later installed on the server that hosts the UC Analytics Storage Engine.

To run the backup.bat file to create the backup, all the UC Analytic services must be running.

For deployments with multiple storage nodes, the scripts must be run on each node. All nodes must be within the same time zone.

The prerequisites for running the restore.bat differ depending whether you are restoring to the existing installation or to a new installation.


	IMPORTANT: On Windows Server 2016, you must open a cmd window as Administrator to run the scripts.

Please select your product:

To serve you better, please complete the Purpose of your Chat:

Recommended Solutions for Your Problem

Unified Communications Analytics 8.6.1 - Deployment Guide

Backing up and restoring your data using scripts

Supported scenarios

About the backup and restore batch files

Prerequisites