PreEmptive Analytics Data Hub User Guide

Installation

Once a suitable host is selected for the Data Hub, follow the relevant sections below to install the software and begin accepting messages.

Standard Installation

To install the Data Hub software:

  1. Copy the provided installer to your server.
  2. As a user with local administrator rights to the machine, run the installer.
  3. Follow the prompts in the installer.
    • On most screens the default choices are probably acceptable; any changes should be based on your internal hosting and network policies.
    • When asked to choose a location for the RabbitMQ data folder, you may wish to choose a different location for performance reasons.
  4. When ready to install, click Install.
  5. When the installation has finished, record the provided Endpoint URL for use when instrumenting your applications.
    • Note that the URL provided will use the machine name as the hostname. If the Data Hub is to receive messages through another domain name, use that name instead.
  6. Optionally configure logging and/or configure Windows Event Log retention settings.
  7. Optionally (but recommended) configure SSL.
  8. Check the Windows Event Log for any errors or warnings.

Assuming there are no errors, you should now be able to configure appropriate destinations and begin sending data to the Data Hub using the Endpoint URL provided.

Headless Installation

Prerequisites

Ensure that the following prequisites are already installed on all target machines:

  • Visual C++ 2010 Redistributable x64
  • .NET Framework 4.5 (minimum)

If any prerequisites are missing, then the installation will switch into an interactive dialog mode in order to install them.

Basic Command

To run the installer via commandline without the UI:

  • Use the /qn commandline option to do a silent install.
  • Provide a value of true for the required ACCEPT_EULA installer property to indicate that you accept the license agreement.
  • Provide a true or false value for the required OPT_IN installer property to indicate whether you want to opt-in or opt-out of the Custom Experience Improvement Program (CEIP).
  • Optionally, log the installer output by adding /L*v log.txt to the command.

Headless installation will not start the Dispatch Service at the end of the install. It will, however, start the IIS website. The installer will exit with an exit code of 0 when the installation is a success and non-0 otherwise.

The default settings for the installation can be found here.

An example command:

PreEmptive.Analytics.Data.Hub.exe /qn /L*v log.txt ACCEPT_EULA="true" OPT_IN="true"

Additional Options

Some of the installation options can be configured by changing the corresponding installer property values:

  • The application directory can be configured by changing the APPDIR installer property.
  • RabbitMQ's data location can be configured by changing the RABBITMQ_DATA_PATH installer property.
    • The RabbitMQ data directory cannot be located at the root of a drive. E.G., you should not specify G:\, but you could specify G:\RabbitMQData.
  • The IIS website's name can be configured by changing the WEBSITE_NAME installer property.
    • The name cannot be empty, a period, or contain \ / ? ; : @ & = + $ , | \" < > *
  • The IIS website's port can be configured by changing the PORT installer property.
    • The port must have a numeric value between 1 and 65535

An example command:

PreEmptive.Analytics.Data.Hub.exe /qn /L*v log.txt ACCEPT_EULA="true" OPT_IN="true" APPDIR="C:\Hub" RABBITMQ_DATA_PATH="D:\RabbitDataPath" WEBSITE_NAME="PA Hub" PORT=82


Data Hub Version 1.5.0. Copyright © 2015 PreEmptive Solutions, LLC