Skip to main content

Walkthrough: Installing WFFM on Sitecore Azure

Abstract

Learn how to install WFFM on Sitecore Azure.

The Sitecore Web Forms for Marketers module supports the following configuration on Sitecore Azure:

  • WFFM 8.1 is the only version that is compatible with Sitecore Azure 8.1.

  • The WFFM module supports multiple content delivery servers in different geolocations in Sitecore Azure.

  • The WFFM module only supports one content management server in Sitecore Azure.

    You can only have one content management server in Sitecore Azure but you can deploy your content delivery servers in multiple different geolocations.

    You can have multiple content management servers in a non-Sitecore Azure environment.

    For more information about the Sitecore functionality and modules that are supported by Azure, see the Sitecore Azure Compatibility tables.

Installing WFFM 8.1 on a content delivery server in Azure

Work through the following steps to install WFFM 8.1 delivery server in Azure:

  1. Install Sitecore Azure on an on-premise content management server.You can download the Sitecore Azure installation package from the Sitecore Developer Portal.

  2. Install Web Forms for Marketers 8.1 rev. 160523 module on an on-premise content management server.

  3. Install Web Forms for Marketers 8.1 rev. 160523 Hotfix 123704.zip hotfix package on an on-premise content management server.This hotfix provides the support for Sitecore Azure.

  4. On the on-premise content management server, in the \App_Config\Include\Sitecore.Forms.config file, set the value of the WFM.SharedDatabase setting to Web.

  5. In the /Website/Web.config file, in the Configuration, system.webServer, Handlers section, add the following nodes:

    <add name="CaptchaImage" verb="*" path="CaptchaImage.axd" type="Sitecore.Form.Core.Pipeline.RequestProcessor.CaptchaResolver, Sitecore.Forms.Core" />
<add name="CaptchaAudio" verb="*" path="CaptchaAudio.axd" type="Sitecore.Form.Core.Pipeline.RequestProcessor.CaptchaResolver, Sitecore.Forms.Core" />

Storing the WFFM data in a SQL database

If you want to use a custom SQL database to store the WFFM data, you must configure the WFFM data provider to use the SQL database.

To configure the WFFM data provider to use the SQL database:

  1. In the \App_Config\Include\Sitecore.WFFM.Dependencies.config file, replace

    <formsDataProvider ref="/sitecore/wffm/analytics/analyticsFormsDataProvider"/> with

    <formsDataProvider ref="/sitecore/wffm/analytics/sqlFormsDataProvider"/>

  2. Repeat this step for every Sitecore Azure content delivery server.

Important

In the Connectionstrings.config file, the WFFM connection string may be missing. This occurs because the content delivery servers do not normally require access to the custom WFFM database.

Content delivery servers do not need the WFFM connection string.

Content management servers must have the WFFM connection string.

Post configuration

After you have configured all the servers, you must:

  • Perform a smart publish to the Sitecore Azure content delivery servers databases.

  • On every Sitecore Azure content delivery server, in Sitecore Azure, run the Upgrade Files command.