Brightmetrics Install Guide for MiVB

Required Permission Level: Company Administrator

Adding Brightmetrics for your MiVB environment takes a few steps and we'll document those here below.

The SMDR processor service (Brightmetrics SMDR) is a small utility that is installed on a server with network access to the MiVB server. It listens to the SMDR and ACD Event streams and logs the data to a local database for processing by the Brightmetrics™ MiVB Plugin.

System Requirements:

1. .NET Framework 4.5 or higher.

2. Microsoft SQL Server Local DB 2014 or newer

• For 2017, make sure this KB is installed to fix invalid path issues for DB
  creation: https://support.microsoft.com/en-us/topic/kb4101464-cumulative-
  update-6-for-sql-server-2017-3050a2f3-72b3-83c7-0a5d-bfd5e4bcedb6
  

3. Network access to MiVB servers, including the following TCP ports:

• SMDR Events: 1752
• ACD Events: 15373

4. Same timezone as the MiVB servers

5. Confirm that the SDS Form Sharing is enabled. System Properties -> System
Administration -> SDS Form Sharing. This is used to sync the configuration across
the different appliances.

6. In order for us to load configuration data, we will need to have a user authorization
profile created for our agent to access the MiVB server. This can be
accomplished within the MiVB Portal System Administration Tool.

• Navigate to System Properties>System Administration>User Authorization Profiles.
• Create a new user authorization profile with System Admin option checked, and the System Admin policy name set to "system".
• You will enter these credentials into the Data Source Configuration page in Brightmetrics when setting up the data source and agent.

Installation:

Step 1: Install all pre-requisites listed here below:

• .NET Framework 4.5 or better - Install Links
• Microsoft SQL Server Local Database
  Full information and available versions: https://docs.microsoft.com/en-us/sql/database-engine/configure-windows/sql-server-express-localdb
  Or quick install link for LocalDB 2016

Download the SMDR Processor Setup:

• Processor Setup Link

Run the SMDR Processor Setup Program:

• When prompted for the Server Address, enter the IP address(es) to your MiVB server(s)

**Note, if you have multiple servers, enter the addresses together using comma separation, ie 127.0.0.1, 192.168.1.1***

Step 2: Log into and navigate to the Data Source Configuration page in Brightmetrics and add your MiVB Data Source here(you will need to be an account admin to complete this):

• Fill in the following fields in the resulting dialog:
• Server Address(es) for the MiVB Server(s)
• MiVB User/Password that was created in Step 6 above
• Select "Add New Agent" from the drop down next for Agent Name and choose "Add New Agent" and the agent a name. 
• Click Save

** If you will also be adding Brightmetrics for MiCC or already have it installed you can use the same agent for MiVB as you are using for MiCC which is installed on the MiCC server. If you will be using the same agent the SMDR processor will need to be on the same server as MiCC as well.**

Questions or feedback? Please email us at [e-mail].