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
<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.
Namespacechild elementGlobalchild sectionItemTypeschild sectionConfigRepositorychild sectionODatachild 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).
- Content Deployer
- Content Service
- Session-enabled Content Service
- Preview Service
- Context Service (deprecated)
- Content Interaction Libraries (CIL)
- Public Content API (PCA)
Global child section
Global child section has the following child sections and child elements:
| Child element or section | Required? | Remarks |
|---|---|---|
MetaQueryConstants child section | Documented in a separate subtopic | |
Storages child section | Documented in a separate subtopic | |
Taxonomies child element | Documented below | |
Transaction child element | Documented 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.
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:
Timeoutspecifies how long the system waits before proceeding to roll back a transaction.MonitorIntervalspecifies in which interval it will check if transactions should be rolled back.
ItemTypes child section
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 name | Required? | Description of value |
|---|---|---|
defaultStorageId | The 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. | |
cached | Whether 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. |
Item child item and set the following attributes:
| Attribute name | Required? | Type | Description of value |
|---|---|---|---|
typeMapping | string | The item type to map to a storage provider, one of the following values:
| |
storageId | string | The identifier of the storage provider to use for this specific Item type | |
cached | Boolean | Whether to cache this item type for this storage provider | |
itemExtension | string | An optional configuration of extended properties to be checked on the Item Type mapping |
Publication child item and set the following attributes, all optional:
| Attribute name | Type | Description of value |
|---|---|---|
defaultStorageId | string | The 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. |
Id | int | The identifier of this Publication |
cached | Boolean | Whether 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
DefaultTop, which you can set to the default OData$topoption to useFixedPublicationId, 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