PreEmptive Analytics Standalone Repository User Guide

Installation

BEFORE YOU BEGIN: If you are upgrading from 1.0 to 1.1, please refer to the Upgrading page instead.

Install a Data Hub

First, install the latest PreEmptive Analytics Data Hub on the same host you will be installing the Standalone Repository. The Data Hub provides run-time conveniences related to queuing, routing, and filtering of incoming data. It is also required for the PreEmptive Analytics Replayer.

  1. Copy PreEmptive.Analytics.Data.Hub.exe to the machine that will host the Standalone Repository.
  2. As an administrator, run that executable and follow the prompts.
  3. After the Data Hub has been successfully installed, make note of the endpoint URL displayed on the last dialog of the installer. This is the URL that upstream hosts (either other Data Hubs or instrumented applications) should use as their destination.

Install the Standalone Repository

Before installing the Standalone Repository software, a supported version of MongoDB must be installed on the same host:

  1. Install MongoDB 2.6.10 (x64), or a later release in the 2.6.x series by following these instructions.
  2. Copy PreEmptive.Analytics.Standalone.Repository.exe to the host machine.
  3. As an administrator, run that executable and follow the prompts.
  4. After the Standalone Repository has been successfully installed, make note of the endpoint URL displayed on the last dialog of the installer. This is the URL that the upstream host - the Data Hub previously installed - will use as its destination.

Install the Replayer

Next, install the PreEmptive Analytics Replayer on the same host. The Replayer is a command-line tool that can "replay" raw analytics envelopes stored in the Standalone Repository to an arbitrary endpoint.

  1. Copy PreEmptive.Analytics.Replayer.exe to the host machine.
  2. As an administrator, run that executable and follow the prompts.

Debugging Installer Issues

If an installer encounters an issue and rolls back, you can try again with logging enabled:

  1. Open a command prompt.
  2. Run the relevant installer with the arguments: /L*V "<logfile name>". For example:
    • PreEmptive.Analytics.Data.Hub.exe /L*V "install_hub_log.txt"
    • PreEmptive.Analytics.Standalone.Repository.exe /L*V "install_repo_log.txt"
    • PreEmptive.Analytics.Replayer.exe /L*V "install_replayer_log.txt"
  3. Check the log file for errors and contact support if necessary.

Configure the Data Hub

In order for data to be delivered from an application to the Data Hub endpoint, then through to the Standalone Repository, you must configure the Data Hub to send all envelopes to the Standalone Repository:

  1. Using a text editor, open DispatchService\Dispatch.config in the Data Hub installation folder.
  2. Within the <destinations> element, create a new destination element, and save:
    <destination id="Repository" url="http://127.0.0.1:99/endpoint" >
    <include>
    <all/>
    </include>
    </destination>
  3. Open services.msc (Windows Services) and restart the PreEmptive Analytics Data Hub Dispatch Service.
  4. Open a browser and navigate to http://localhost:15672/#/queues. Log in as guest/guest.
  5. After approximately one minute, you should see three total queues:
    • pahub.endpoint
    • pahub.repository_errored
    • pahub.repository_offline


Standalone Repository Version 1.1.0. Copyright © 2015 PreEmptive Solutions, LLC