Loading...
Area: Optimizely CMS
Applies to versions: 10-11
Other versions:
ARCHIVED This content is retired and no longer maintained. See the version selector for other versions of this topic.

Configuring .NET SignalR

Recommended reading 

ASP.NET SignalR is a library for developing real-time web functionality, allowing for bi-directional communication between server and client. SignalR is used by some of the Episerver add-ons, such as Live Monitor.

Note: If you get errors about SignalR not being set up correctly when you start the Episerver user interface in the JavaScript console, clear the .NET temporary files.

Configure SignalR as follows:

  1. If you are using Visual Studio 2012, ensure that .NET Framework 4.5.1 (or later) and the developer pack are installed.
  2. In Visual Studio, do the following steps in a project file, such as Alloy.csproj:
    1. Right-click the project and select Properties.
    2. Change Target framework to .NET Framework 4.5.1 or later.

    3. Save the project as solution, for example, Alloy.sln.
  3. Install the Microsoft.AspNet.SignalR package from NuGet.org, or go to Visual Studio > ToolsNuGet Package Manager > Package Manager Console, and run the command:
    Install-Package Microsoft.AspNet.SignalR -Version 2.0.3
  4. Open web.config and add the following lines:
    <configuration>
    ...
      <runtime>
        <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
        ...
          <dependentAssembly>
            <assemblyIdentity name="Microsoft.Owin" publicKeyToken="31bf3856ad364e35" culture="neutral" />
              <bindingRedirect oldVersion="0.0.0.0-2.0.999.999" newVersion="2.0.1.0" />
          </dependentAssembly>
          <dependentAssembly>
            <assemblyIdentity name="Microsoft.Owin.Security" publicKeyToken="31bf3856ad364e35" culture="neutral" />
              <bindingRedirect oldVersion="0.0.0.0-2.0.999.999" newVersion="2.0.1.0" />
          </dependentAssembly>
          <dependentAssembly>
            <assemblyIdentity name="Microsoft.AspNet.SignalR.Core" publicKeyToken="31bf3856ad364e35" culture="neutral" />
              <bindingRedirect oldVersion="0.0.0.0-2.0.3.0" newVersion="2.0.3.0" />
          </dependentAssembly>
        </assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      </runtime>
    ...
    </configuration>

    The newVersion is the real version value of running assemblies on the website. For example, 2.0.1.0 for Microsoft.Owin, 2.0.3.0 for Microsoft.AspNet. SignalR.Core might not be running on your website.

  5. Add the following line in web.config under appSettings:
    <add key="owin:AutomaticAppStartup" value="false" />
  6. Rebuild the solution and refresh the website. Ensure the website runs as normal.
  7. Log in to the website and go to Add-ons and install the Live Monitor and Content Collaboration add-ons.
  8. Restart the website.
  9. Open web.config again, and change the following line under appSettings:
    <add key="owin:AutomaticAppStartup" value="false" />

      to

    <add key="owin:appStartup" value="EPiServerContentCollaborationOWINStartup" />

    This example shows configuration for Content Collaboration. For LiveMonitor, the startup value is EPiServerLiveMonitorOWINStartup.

OWIN start up and optimizeCompilations

Note: The OWIN startup needs a class. To set up a start-up class, see Episerver and OWIN.

If your project previously did not have an OWIN startup class, and optimizeCompilations was enabled, then sometimes the new code is not executed, which may result in errors because the OWIN functionality is not set up. To work around this, temporarily set optimizeCompilations in web.config to false to clear the cache, start the site, and then you can set optimizeCompilations to true again.

Do you find this information helpful? Please log in to provide feedback.

Last updated: May 26, 2021

Recommended reading