DFS 9.0.0 - How to configure content delivery server

Owned by Magnus Frank
Last updated: Mar 05, 2018 by Martin Ulisse
2 min read

This section describes how to configure a content delivery (CD) server to use DAM for Sitecore.

1 Configure CD server according to Sitecore's specifications

Follow Sitecore's specifications on how to configure content delivery server:

2 Copy all the DAM for Sitecore DLLs into bin folder of CD

Copy the following DLLs into bin folder of CD Server

  • DFS.dll
  • DFS.Client.dll
  • DFS.Client.Services.dll
  • DFS.Connect.dll
  • DFS.Connect.Digizuite.dll
  • DFS.ContentSearch.dll
  • DFS.Digizuite.dll
  • DFS.Services.dll
  • RestSharp.dll

The latter is a DLL used for calling web services.

3 Copy all configuration files into CD server

locate the DAM For Sitecore configuration on the CM server: <website root>/app_config/include/damforsitecore and copy it into the corresponding location on the CD Server.

Locate the patched configuration file (typically located after the damforsitecore folder) and copy it into the CD Server in the same location.

4 Change configuration on CD Server

Change the following configuration:

  1. Configuration file DFS.Settings.config
    1. <setting name="DFS.AssetDatabase" value="master" /> change value to web.
    2. <setting name="DFS.AssetIndex" value="dfs_assets_master_index" /> change master to web.
  2. Add entry for httphandler in web.config, see DFS 9.0.0 - 3 Setting up Sitecore, section 3.1
  3. For Sitecore 8.x, disable configuration file DFS.Assets.Lucene.Index.Master.config. This is done by adding .disabled extension to the end of the file. This is not needed in Sitecore 9.

5 Disable auto-synchronization between Digizuite and Sitecore

For a CD Server, there is no reason for the auto synchronization to run, as that is handled by the CM server. 

To disable this, comment out the <hooks> </hooks> section in DFS.Connect.config found under Configuration/Sitecore. 

6 Disable security on DFSMedia pipeline (optional)

Everytime an asset is displayed on a page, a security check is made. For some sites (i.e. public sites), this is not needed and hence disabling this, increases performance of serving media.

To disable the security check, locate pipeline DFSMedia in DFS.Services.config and out comment the processor: <processor type="DFS.Services.Pipelines.DFSMedia.CheckSecurity, DFS.Services" /> 

If you do not disable security checks, because it is important, then the extranet\Anonymous user must be assigned role sitecore\Digizuite DAM for Sitecore Users as a minimum

7 Publish relevant parts of master to web

See DFS 9.0.0 - 5 Synchronize Silo, section 5.2