You are about to upgrade from a previous version to DAM for Sitecore (DFS). Which requires your attention.
| Info |
|---|
Things to be aware of before upgrading from a previous version
|
Before updating to 10.0.0:
...
Delete the silo with "Leave links" option
...
Confirm items under Digizuite have disappeared:
...
Empty data in dfs_assets_master_index and dfs_assets_web_index. Ensure Solr core replication does not interfere with this (if any).
Updating the module to DFS 10.0.0
- Install the new DFS 10.0.0 package and overwrite all when asked.
After updating to DFS 10.0.0:
...
Add the silo item through the Installation Wizard again which you packed in step 2a.
| Note |
|---|
It is important to delete the data of the index dfs_assets_master_index, before doing a full synchronization of the silo. If you don't do this, the full synchronization will fail. |
...
| Note |
|---|
Must read this document when upgrading to DC 5.8+ here: DFS 11.0 - Breaking Changes |
Before installing the new package
Delete all the config files in App_Config\Include\damforsitecore and any patch files that relates to our configuration.
Now start Installing the package
You will be asked to overwrite files, select Apply to all.
When it comes to items, here you must take one at a time. Choose overwrite until you get to the item /sitecore/media library/Digizuite, here you must choose merge. The rest you can choose overwrite.
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.
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).
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.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.
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.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
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