Configuring FXM

Last updated Thursday, October 12, 2017 in Sitecore Experience Platform for Developer, Administrator

The following configuration files for the Federated Experience Manager (FXM) are stored in the /App_Config/Include/FXM directory:

  • Sitecore.FXM.Bundle.config – the configuration settings for the beacon script and for bundling – minification and caching.
  • Sitecore.FXM.config – the main configuration settings for FXM.
  • Sitecore.FXM.Lucene.DomainsSearch.DefaultIndexConfiguration.config – the default configuration of the Lucene search index.
  • Sitecore.FXM.Lucene.DomainsSearch.Index.Master.config – the configuration of the Lucene search index for the master database.
  • Sitecore.FXM.Lucene.DomainsSearch.Index.Web.config – the configuration of the Lucene search index for the web database.
  • Sitecore.FXM.Solr.DomainsSearch.DefaultIndexConfiguration.config – the default configuration for the Solr search index.
  • Sitecore.FXM.Solr.DomainsSearch.Index.Master.config – the configuration of the Solr search index for the master database,
  • Sitecore.FXM.Solr.DomainsSearch.Index.Web.config – the configuration of the Solr search index for the web database.
  • Sitecore.FXM.Speak.config – the configuration settings for the FXM SPEAK application.

Configuring in a distributed environment

In a distributed environment, you must enable the following two configuration files on all the servers:

  • Sitecore.FXM.Bundle.config
  • Sitecore.FXM.config

Also, make sure that the following configuration files are enabled on your content management servers:

  • Sitecore.FXM.Speak.config
  • Search configs

In addition, on each content management server, you must specify which content delivery server that the content management server should use. In the Sitecore.FXM.config file, in the FXMHostname setting, specify the content delivery server:

<setting name="FXM.Hostname" value="scalingcdservername" /> 

This parameter is empty by default.

Important

To ensure that external pages are tracked, on each content delivery server, you must disable the Sitecore.ExperienceAnalytics.dll, Sitecore.ExperienceAnalytics.Client.dll and Sitecore.ExperienceAnalytics.ReAggregation.dll files.

Logging

FXM has its own dedicated log file that is stored in the default log directory. For a more detailed output, in the /App_Config/Include/Sitecore.FXM.config file, set the log level to DEBUG:

<logger name="Sitecore.FXM.Diagnostics" additivity="false">   
<level value="DEBUG" />   
<appender-ref ref="FxmLogFileAppender" /> 
</logger>

Note

Debug logging generates a number of extra operations and a large log file, therefore, you should only enable debug logging in a production environment for short periods of time.

Send feedback about the documentation to docsite@sitecore.net.