Brightmetrics Install Guide for MiVB

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:

Install all pre-requisites:

• .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***

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

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