Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

You are about to upgrade from a previous version to DAM for Sitecore (DFS). Which requires your attention.

Note

Must read this document when upgrading to DC 5.8+ here: DFS 11.0 - Breaking Changes

Before installing the new package 

  1. Delete all the config files in App_Config\Include\damforsitecore and

...

  1. any patch files that relates to our configuration.

Now start Installing the package

  1. You will be asked to

...

  1. overwrite files, select

...

  1. Apply to all.

  2. When it comes to items, here you must take one at a time. Choose

...

  1. overwrite until you get to the item /sitecore/media library/Digizuite, here you must choose merge. The rest you can choose

...

  1. overwrite.

  2. No follow the next section DFS 11.0 - 3 Setting up Sitecore. You should allready have this handler in your web.config, but the namespace has changed in the new one, so please check the handler.

  3. Reload the site, go to /sitecore/media library/Digizuite, Here you should see 2 items, a new one called Assets and the one from the existing connector, if you havent renamed it, then it would be called Assets silo.
    You must delete all child items under the assets silo (all the synchronized assets). 

...

titleImportant
  1. NB: When you delete the items, you must choose "Leave links – the links will appear in the Broken Links report". This will give us the opportunity to fix the broken links on reference pages.

  2. Once all items has been deleted. You must update one config that tells the connector the guid of the Asset silo. By default it points at the one coming with connector Assets. Open App_Config → Include → damforsitecore → DFS.Settings.config and local the setting named DFS.DefaulAssetSiloId, change the guid (itemId) to the one matching the Assets silo.

...

titleImportant
  1. NB: This step is very important. Because we deleted all items in #4, all pages that references any assets from the Asset silo, will contain broken links. In order for the connector to automatically fix the broken links, it need to know which asset silo to use.

  2. Reload the site. If you go to a page that contains digizuite content, the connector should automatically resync the asset and fix the broken links. If you want to fix all broken links in one go, then read this page DFS 11.0 - Broken Links.

Clean up legacy items and files

ith In this version there are items and files from the old connector, that no longer are in use and can be deleted.

Core DB

  • /sitecore/client/Applications/Launchpad/PageSettings/Buttons/ContentEditing/DAM for Sitecore Explorer

  • /sitecore/content/Applications/Content Editor/Ribbons/Contextual Ribbons/Digizuite

  • /sitecore/content/Applications/Content Editor/Menues/Digizuite

  • /sitecore/client/DamForSitecore/AssetBrowser

  • /sitecore/client/DamForSitecore/MultiSelectAssetBrowser

  • /sitecore/client/DamForSitecore/DamExplorer

  • /sitecore/client/DamForSitecore/Dialogs

  • /sitecore/client/DamForSitecore/Shared

  • /sitecore/client/DamForSitecore/Templates

  • /sitecore/client/DamForSitecore/AssetReferrer

  • /sitecore/client/DamForSitecore/Settings

  • /sitecore/system/Dictionary/DamForSitecore

Master DB

  • /sitecore/templates/Branches/DFS

  • /sitecore/system/Modules/Digizuite/Filter Options

  • /sitecore/system/Modules/Digizuite/MetaDataRoot_0 (If it exists)

  • /sitecore/system/Modules/Digizuite/SortOrders

Physical files on web server

  • bin/DFS.Connect.Digizuite.dll

  • bin/DFS.ContentSearch.dll

  • bin/DFS.Digizuite.dll

  • bin/DFS.Services.dll