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.
- In Visual Studio, open the NuGet Package Manager Console.
- 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.