Install Sitecore Universal Tracker 1.x on Sitecore 9.1

Install Sitecore Universal Tracker 1.x on Sitecore 9.1

Sitecore Universal Tracker 1.0 was released along with Sitecore 9.1 on November 28th 2018. Sitecore Universal Tracker is an API first, a micro-service-based tracking service to track actions from mobile apps, IoT, AR, VR and other emerging channels.

Universal Tracking Vision
Universal Tracking
Universal Tracker Architecture

I followed the installation document and for the most part, it does a good job. There are a few steps that I would like to highlight which were not covered in detail.

Get the installation files and the documentation from Sitecore Universal Tracker 1.0.0

When you are asked to specify the database connection string in the config.xml file please use this format: “user id=SQLUSERNAME;password=SQLUSERPASSWORD;data source=YOURSQLINSTANCE;database=YOURUTDBNAME;ConnectRetryCount=5;ConnectRetryInterval=10;Connection Timeout=50;”

Once you install the processing service, you would need to specify the xConnect service url and the client certificate. Please get the client certificate value from your XP install’s connection strings config file.

    1. <add

      name

      =

      "xdb.referencedata.client.certificate"

      connectionString

      =

      "StoreName=My;StoreLocation=LocalMachine;FindType=FindByThumbprint;FindValue=3E95195FC91F11EFC04E87933BFA95D12D9F9645"

      />

You will have to create two self signed certificates for the Collection and the Processing services. Please follow the instructions in this blog post: Sitecore – Using SSL part 1.

Once all of that is taken care of, the most import thing you would need ot do is to add the IIS_IUSRS to the xConenct certificate.

Sitecore Universal Tracking Service
Sitecore Universal Tracking Service

If the install fails for the processing or the collection service, you can either delete them and retry or specify a custom instance or service name.

Credits:

If you have any questions or concerns, please get in touch with me. (@akshaysura13 on twitter or on Slack).

Special shout out to Alistair Deneys for helping me with the Universal Tracker.

KONABOS