Documentation Center

Storage Layer configuration reference

The Storage Layer configuration file, cd_storage_conf.xml, specifies which published content should be stored where, and how to cache retrieved content.

Overall structure of file

The file has the following basic structure:
<Configuration>
  <Namespace>
  <Global>
    <MetaQueryConstants>
      <FindByURLCaseSensitivity/>
    </MetaQueryConstants>
    <Storages>
      <StorageBindings>
        <Bundle/>
        ...
      </StorageBindings>
      <Wrappers>
        <Wrapper/>
        ...
      </Wrappers>
      <Storage/>
      ...
    </Storages>
    <Taxonomies/>
    <Transaction/>
  </Global>
  <ItemTypes>
    <Item/>
    ...
    <Publication>
      <Item/>
      ...
    ...
  </ItemTypes>
  <ConfigRepository>
    <Roles>
      <Role>
        <Targets>
          <Target/>
          ...
        </Targets>
        ...
        <Urls>
          <Url/>
          ...
        </Urls>
        ...
      </Role>
      ...
    </Roles>
  </ConfigRepository>
  <OData>
    <DefaultTop/>
    <FixedPublicationId/>
  </OData>
</Configuration>

Configuration root element

The root element, Configuration, has a Version attribute that is to be set to the version of the file, that is, the Content Delivery version (without specifying a service pack), which is 12.0 in this release.

Within this element, there are the following child sections and child elements, all of which are optional:
  • Namespace child element
  • Global child section
  • ItemTypes child section
  • ConfigRepository child section
  • OData child section

Namespace child element

This optional element specifies the type of content source (identified by a namespace identifier, as set in the default attribute). If omitted, this element is assumed to have its default attribute set to the value tcm (for Tridion Sites). The other allowed value is ish (for Tridion Docs).

This setting is used by:
  • Content Deployer
  • Content Service
  • Session-enabled Content Service
  • Preview Service
  • Context Service (deprecated)
This setting is ignored by:
  • Content Interaction Libraries (CIL)
  • Public Content API (PCA)

Global child section

The Global child section has the following child sections and child elements:
Child element or sectionRequired?Remarks
MetaQueryConstants child sectionnoDocumented in a separate subtopic
Storages child sectionyesDocumented in a separate subtopic
Taxonomies child elementnoDocumented below
Transaction child elementnoDocumented below

The Taxonomies child element configures settings for the storage of Taxonomies. If its optional CountEnabled attribute is set to true, the keyword reference count is updated during storage modifications, impacting storage performance. When set to false, the keyword reference count is not updated.

The Transaction child element configures transaction storage settings, how long before a transaction gets rolled back and on which interval to monitor for outstanding transactions. This element has two optional integer attributes:
  • Timeout specifies how long the system waits before proceeding to roll back a transaction.
  • MonitorInterval specifies in which interval it will check if transactions should be rolled back.

ItemTypes child section

The ItemTypes child section configures which storage provider to use for individual item types (in zero or more Item child elements) or Publication-item type combinations (in zero or more Publication child sections). The ItemTypes element has two attributes:
Attribute nameRequired?Description of value
defaultStorageIdyesThe identifier of the default storage provider. The storage provider with this ID is used for item types and Publication-item type combinations for which no specific storage provider is provided.
cachednoWhether to perform caching for a storage provider, defaults to false. This value is the default caching behavior for item types and Publication-item type combinations for which no specific caching behavior is specified.
To specify a custom storage provider or caching behavior for specific item types, regardless the Publication, use an Item child item and set the following attributes:
Attribute nameRequired?TypeDescription of value
typeMappingnostringThe item type to map to a storage provider, one of the following values:
  • Binary
  • ComponentLinkClick
  • ComponentPresentation
  • ComponentVisit
  • DynamicLinkInfo
  • ExtensionData
  • Metadata
  • Page
  • Personalization
  • Publication
  • Query
  • Taxonomy
  • Timeframe
  • TrackedPage
  • XSLT
storageIdyesstringThe identifier of the storage provider to use for this specific Item type
cachednoBooleanWhether to cache this item type for this storage provider
itemExtensionnostringAn optional configuration of extended properties to be checked on the Item Type mapping
To specify a custom storage provider or caching behavior for item types in a specific Publication, use a Publication child item and set the following attributes, all optional:
Attribute nameTypeDescription of value
defaultStorageIdstringThe identifier of the default storage provider for this Publication. The storage provider with this ID is used for all item types within this Publication for which no specific storage provider is provided.
IdintThe identifier of this Publication
cachedBooleanWhether to perform caching for storage providers configured for this Publication. This value is the default caching behavior for item types within this Publication for which no specific caching behavior is specified.

To further configure storage or caching for a specific item type within this Publication, create a child element Item within the Publication element, and configure it like the Item element specified above.

ConfigRepository child section

This section is explained in a separate subtopic.

OData child section

This section contains OData-specific settings in two optional child elements:
  • DefaultTop, which you can set to the default OData $top option to use
  • FixedPublicationId, which you can set to a fixed Publication ID for friendly URLs, in order to allow only one Publication to be queried through the friendly URL filter