Installing the Lionbridge Connector

Important: Before installing the Connector, back up the Optimizely databases.

You use Visual Studio NuGet to install the Connector package. There are two ways to install the Connector, depending on whether you received the installation package directly from Lionbridge or you will download it from the Optimizely NuGet feed.

Optimizely version numbers in Lionbridge Connector packages

Important: There are different Connector packages for Optimizely 10 and Optimizely 11. Ensure that you download and install the correct package for your version of Optimizely.

You can identify the Optimizely version for the Lionbridge Connector from the last four digits of the NuGet package name, as described in the following table below.

Optimizely Version Lionbridge Connector Versioning
(MajorVersion.MinorVersion.Patch.Optimizely Version)
Example
Optimizely 10 1.x.x.1000 1.7.0.1000
Optimizely 11 1.x.x.1100 1.7.0.1100

To download and install the Connector:

Important: Follow these instructions if you did not receive the Connector as a NuGet package (with file extension .nupkg) directly from Lionbridge.

  • In Visual Studio, open the NuGet Package Manager Console. In the command line, type:
    Install-Package LionbridgeConnector.

To install the Connector:

Important: Follow these instructions if you received the Connector as a NuGet package (with file extension .nupkg) directly from Lionbridge.

  1. In Visual Studio, open the NuGet Package Manager Console.
  2. Type the following command in the command line, ensuring that you specify the latest Connector version for your CMS version:
    Install-PackageLionbridgeConnector -source [.nupkg file path] - version.x.x.1100
    For example, to install version 1.7.0 of the Connector on CMS version 11, type:
    Install-Package LionbridgeConnector -source C:\LionbridgeConnector -version 1.7.0.1100.1200

Third-Party Libraries required:

The following compatible third-party libraries are required to be installed.

Name Description Minimum Version
Newtonsoft.Json Json.NET is a popular high-performance JSON framework for .NET 12.0.1
Polly Polly is a library that allows developers to express resilience and transient fault handling policies such as Retry, Circuit Breaker, Timeout, Bulkhead Isolation, and Fallback in a fluent and thread-safe manner. 5.9
Serilog.Sinks.Graylog The Serilog Graylog Sink project is a sink (basically a writer) for the Serilog logging framework. Structured log events are written to sinks and each sink is responsible for writing it to its own backend, database, store etc. This sink delivers the data to Graylog2, a NoSQL search engine. 2.2.0
Serilog Simple .NET logging with fully-structured events 2.4
Castle.Core Castle Project Core, including DynamicProxy, Logging Abstractions and DictionaryAdapter 3.3.3
log4net.dll Log for Net Core 2.0.13

Note: The Serilog libraries will be installed by the Connector package.

Installation location

The Connector is installed in the \modules_protected folder of the Optimizely web root. If you use another folder for add-ons, you must manually move the Connector files to your modules folder.