Installation Instructions - Live Monitor

Product version:

Live Monitor for EPiServer CMS 6 R2

Document last saved:

3/19/2012 8:43:24 AM 

Live Monitor is included in the EPiServer CMS 6 R2 installation package, you can select if you want to install it. Follow the instructions below.

Installing Live Monitor

  1. Download and run the EPiServer CMS installation package on your computer.
  2. Run the Live Monitor.msi file, which is included in the EPiServer CMS download.
  3. Start EPiServer Deployment Center, which is found in the EPiServer folder on the Start/All programs menu.
  4. Under the Quick Links tab, select the EPiServer CMS 6 R2 site for which you want to install Live Monitor. Select Install Live Monitor.
  5. The Live Monitor core files will be installed. When the installation is completed, return to the EPiServer Deployment Center.

Usage on Sites with Multiple Site Bindings

Live Monitor relies on WCF services for communication between the Silverlight client and the web server. If you are using multiple site bindings (e.g. http://mysite.com & http://www.mysite.com) on your site there is some specific configuration required.

If your site is running on ASP.NET 4 or later you can enable multiple site bindings using a configuration setting specific for this purpose. This configuration setting is a requirement if you want to run Live Monitor on multiple sites in an EPiServer Enterprise setup with multiple bindings.

<configuration>
  <system.serviceModel>
    <serviceHostingEnvironment multipleSiteBindingsEnabled="true" .../>
  </system.serviceModel>
</configuration>

If your site are running ASP.NET 3.5 you will need to select one specific address where Live Monitor should be available by configuring the "base address prefix filters".

<configuration>
  <system.serviceModel>
    <serviceHostingEnvironment ...>
      <baseAddressPrefixFilters>
        <!-- this is the address from which I want to run the live monitor client -->
        <add prefix="http://mysite.com"/>
      </baseAddressPrefixFilters>
    </serviceHostingEnvironment>
  </system.serviceModel>
</configuration>

Usage on Sites with Code Blocks (<% %>) Immediatly Inside the form tag ==

The symptom for this problem is that no trace information is logged, and no visitors are shown in the client. Code blocks prevents the live monitor tracking web control from beeing added at the end of the form tag. The most stright-forward option for fixing this is manually adding the epitrace tracking web control to the master page:

<%@ Register TagPrefix="epitrace"
Namespace="EPiServer.Trace.CMS.Web.WebControls"
Assembly="EPiServer.Trace.CMS" %>
<html><body>
<form runat="server">
<% // My code block and other markup %>
</form>
<epitrace:VisitTracker TrackingHandlerUrl="~/TrackerHandler.ashx" runat="server"/>
</body></html>

Also disable the page plugin in admin mode: Admin > Config > Plug-in Manager > Live Monitor > Overview.

Usage on Sites Running Oracle Database

When installing with Deployment Center uncheck "Database tables" and manually run [Program Files]\EPiServer\CMS\[Version]\Modules\EPiTrace\epitraceHits.ora with SQLPlus.exe connected to your existing <EPiServer Oracle User>.

Usage on Sites Using HTTPS Scheme

Open web.config set bindingConfiguration of the TraceService endpoint to a binding with the security mode set to "transport", e.g.:

   <system.serviceModel>
        <services>
            <service behaviorConfiguration="EPiServer.Trace.Services.TraceServiceBehavior" name="EPiServer.Trace.CMS.Services.TraceService">
                <endpoint bindingConfiguration="basicHttpBinding" .../>
            </service>
        </services>
		<bindings>
            <basicHttpBinding>
                <binding name="basicHttpBinding">
                    <security mode="Transport" />
                </binding>
            </basicHttpBinding>
        </bindings>

Live Monitor Troubleshooting

  1. Some machines may need registering a MIME type for extension .xap as application/x-silverlight-app. IIS7, update web.config: IIS5-IIS6: Go to IIS Manager > Server > Properties > Mime Types... > New...: Extension: .XAP MIME type: application/x-silverilght
  2. The browser used to access the site will need Silverlight 3 or 4 installed in order to run Live Monitor. http://www.microsoft.com/silverlight/get-started/install/default.aspx