DFS 8.1.0 - I: Update guide

This guide describes how to update the DAM for Sitecore (DFS) module without losing data.

Before beginning it is important that the reader has knowledge of how itemIds are calculated in DFS. This knowledge is important for understanding this guide. An explanation of this can be found here.

The updating process is as follows:

1. Backup Sitecore
2. Serialize the Asset silo item
   1. Go into content editor
   2. Right-click top bar and select developer tab (make Developer tab visible)
      
      
   3. Select the asset silo of the DFS installation
   4. Click the "serialize item" button in the Developer tab
      

1. 1. By default the item is stored beneath <sitecore root>\data\serialization (e.g. "C:\Inetpub\wwwroot\test802\Data\serialization\master\sitecore\media library\Digizuite")
2. Update the package
   1. Install the package as a normal Sitecore package

   2. Overwrite everything

      Note

      This will break ALL the links on the Sitecore webpage. It mends it self once the full re-synchronization has been run. This is due to the way Sitecore ItemIds are created.

3. Revert the item
   1. Go into Content Editor
   2. Select the Digizuite item in Media library
   3. 
   4. Go to the Developer tab
   5. Press Revert tree
   6. 
   7. Press F5
   8. Now your Asset silo will appear again
4. Do a full re-synchronization of the asset silo

All the links will mend themselves at this point (be un-broken). The reason that everything works after doing the above steps, is that the Sitecore itemIds of all assets and configurations will revert back to their pre-update itemIds from before.

The ItemIds are calculated based on the asset silo ItemId. As the "new" silo is the same as the one before, all the assets and configurations will also have the same itemIds again.