Chat now with support
Chat with Support

Unified Communications Analytics 8.8.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 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

Step 1: Edit the backup.bat file parameters for your installation

After you have copied all the backup and restore files to the server that hosts the UC Analytics Storage Engine, you must edit the backup.bat file to specify the parameters for your environment.

The backup.bat file looks as follows:

-storageEngineDirectoryPath "C:\Program Files\Quest\UC Analytics\Storage Engine\bin" -storageDirectoryPath "C:\Program Files\Quest\UC Analytics\Storage" -backupDirectoryPath "c:\UCA\backup" -backupLabel "label" -portNumber 7299 -numberOfBackupCopies 2 -force

The parameters that you can edit are as follows:

 
Table 39. Backup batch file parameters
Parameter
Default value
Required information

storageEngineDirectoryPath

C:\Program Files\Quest\UC Analytics\Storage Engine\bin

Shows the location of the storage engine. If you installed using the default values, you can leave this parameter as shown.

storageDirectoryPath

C:\Program Files\Quest\UC Analytics\Storage

Shows the location of the storage folder. If you installed using the default values, you can leave this parameter as shown.

backupDirectoryPath

c:\UCA\backup

Enter the path and folder name for the folder to which you want to copy the backup files.

You can enter a UNC path if you are copying the backup files to a different server or share.

backupLabel

label

Enter a unique name to identify the storage folder and server that contains the Storage Engine data that you want to back up.

For example, you could enter Store1Server1.

portNumber

7299

Port used by the Cassandra nodetool.

numberOfBackupCopies

2

Enter the number of backup copies that will be retained at any one time. The backup folders are date-stamped so if you are retaining two copies, the two newest folders are kept and any older copies are removed.

NOTE: Do not change the port number from 7299. This is the port that is used by the Cassandra nodetool.

Step 2: Run the backup batch file

Once you have edited the backup.bat file to contain your local values, you can run the file to create a backup copy of your data. The backup script automatically detects the path to the latest version of Java (Oracle or Zulu OpenJDK) that is installed on the computer.

You run the backup batch file locally on the server on which the Storage Engine resides.

To create a snapshot backup file
1
Ensure that all the UC Analytics services are running.
2
Navigate to the folder that contains the backup and restore script files.
3
Open the command prompt and enter:
backup.bat

The batch file creates a folder with the current date in YYYY-MM-DD format that contains subfolders with files that contain the data structure information and files that contain the actual data.

Step 3: Edit the restore batch file

Before you restore a backup file, you must edit the restore.bat file to specify the parameters for your environment. The restore.bat file looks as follows:

-backupDirectoryPath "c:\UCA\backup" -backupLabel "label" -backupDate "YYYY-MM-DD" -storageDirectoryPath "C:\Program Files\Quest\UC Analytics\Storage" -storageEngineDirectoryPath "C:\Program Files\Quest\UC Analytics\Storage Engine\bin" -portNumber 7299

The parameters that you can edit are as follows:

 
Table 40. Restore batch file parameters
Parameter
Default value
Required information

backupDirectoryPath

C:\UCA\backup

Enter the path and folder name for the folder to which the backup batch file previously copied the backup files.

backupLabel

label

Enter the unique name that was assigned as the backup label when the backup was created.

The label name must exactly match the name that was entered in the backup.bat file when the backup was created.

backupDate

YYYY-MM-DD

Enter the date for the backup file from which you want to restore the data.

The backup folder is named with the date of the backup in YYYY-MM-DD format.

storageDirectoryPath

C:\Program Files\Quest\UC Analytics\Storage

Shows the location of the storage folder. If you installed using the default values, you can leave this parameter as shown.

storageEngineDirectoryPath

C:\Program Files\Quest\UC Analytics\Storage Engine\bin

Shows the location of the storage engine. If you installed using the default values, you can leave this parameter as shown.

portNumber

7299

Port used by the Cassandra nodetool.

NOTE: Do not change the port number from 7299. This is the port that is used by the Cassandra nodetool.

Step 4a: Restore the storage data in an existing installation

Use this procedure to restore your existing database if the data has become corrupted.

When you restore data from a snapshot, there is intensive processor and I/O activity on the node that is being restored. You run the backup batch file locally on the server on which the Storage Engine resides.

To restore a snapshot backup file in the same installation
1
Stop the UC Analytics services on all the servers in the deployment in the following order:
•
Data Engine
•
Query Engine
•
Storage Engine
2
Navigate to the folder that contains the backup and restore script files.
3
Open the command prompt and enter:
restore.bat
4
Restart all the UC Analytics services in the following order:
a
Storage Engine.
b
Query Engine
c
Data Engine
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating