Schema for cd_storage.xml and storage bundles

Question

Related to SDL Tridion - Storage:

Is there an XML Schema (XSD) definition (or other detailed documentation) for the cd_storage.xml and storage bundle xml files, including lists of valid nodes and values for node attributes? The best I could find so far is SDL Live Content, which is not exactly exhaustive.

If it exists already, could someone point me to the right place? If not, can this be considered a polite request for it to be created?!

Many thanks!

Answer 1

From your installation files, look in ..\Content Delivery\resources\schemas - You will find cd_storage_conf.xsd and cd_storage_dao_bundle.xsd.

I generally add this (and all the other Tridion CD Schemas) as a Schema References in Visual Studio, it really helps when editing config files, and can help rapidly solve configuration issues.

Update for Tridion 8.5:

xsd's have moved into each microservice e.g. ..\SDL Web 8.5\Content Delivery\roles\discovery\standalone\config\schemas

Answer 2

The one you provided SDLLIVEContent link is the best one. The document explains all the possible nodes and attributes which needs to be taken care for Configuring content storage cd_storage_conf.xml

If you really wants to know the location of XSD, it is available

Under Content Delivery Installation --> Resources --> Schemas --> cd_storage_conf.xsd

Answer 3

You can refer the

Content Delivery Installation --> Resources --> configurations-->cd_storage_conf_sample.xml

there are good comments in the Sample files for storage & deployer config. e.g in deployer XSD there is no mention of Phase="post-transaction" (in my problem i was searching for the possible values in XSD but could not found), but sample file do have. so referring both can help you to document.

Answer 4

For configuration of storage layer in cd_storage_conf.xml you can collectively make use of the SDL Live Content links as stated in your question along with the sample storage config file where a descriptive comment has been added for almost all the nodes.

Related to Storage Bundle xml files, you may want to explore the Storage Extension related topics given HERE and HERE (Requires Login).

In brief, Storage DAO Bundle xml file is generally used for extending the default functionality of Storage Layer of the Content Delivery module.

Typically, the content of a storage dao bundle file will look like as below:

<?xml version="1.0" encoding="UTF-8"?>
<StorageDAOBundles>
    <StorageDAOBundle type="<Which type of storage layer>">
          <StorageDAO typeMapping="<Which Action>"
                 class="Fully resolved custom storage layer extension class name" />
     </StorageDAOBundle>
</StorageDAOBundles>

For example:

1. For a Dynamic Component Presentation you want to invoke the Storage Extension at Publishing Action, the Storage DAO Bundle will looks as below:

   <?xml version="1.0" encoding="UTF-8"?>
   <StorageDAOBundles>
       <StorageDAOBundle type="persistence">
           <StorageDAO typeMapping="PublishAction"
               class="com.tridion.storage.extension.custom.JPAPublishActionDAO" />
           </StorageDAOBundle>
   </StorageDAOBundles>
   

2. If you want to invoke Storage Extension while publishing a page, the Storage DAO Bundle will looks as below:

   <?xml version="1.0" encoding="UTF-8"?>
   <StorageDAOBundles>
       <StorageDAOBundle type="filesystem">
           <StorageDAO typeMapping="Page"
               class="com.tridion.storage.extension.custom.FSPagePublishActionDAO" />
           </StorageDAOBundle>
   </StorageDAOBundles>
   

I hope it helps.