Issues you might run into when upgrading Sitecore

Recently we have been working on migrating one of our customers solution from Sitecore 6.6 to 8.0 (Yes, I know 8.1 has been released, but it wasn't when we started the upgrade project).


Here is some of the issues we have run into, and what we have done to fix them.

• Moving the items to the new master database:

The best way we have found to move the templates, media items, items etc. to the new solution, is to copy the current master database to the same database server as the new databases, and then change the connectionstring for master to point to the old database.


Then, log into Sitecore and create packages containing the things you need (remember to keep the package file size below 2GB, or Sitecore will fail to install it, since it cannot parse the zip file if is that big...) - you most likely need these items: Templates (Remember to only include your own templates, not the ones Sitecore comes with), Layouts (sublayouts, renderings etc.), System items, Media Items (make several separate packages containing these, to stay below the size limit) and content.


Once the packages has been created - change the connectionstring back, so master points to the new master database (the reason for this, is that the packages must be made from items in the database named "master" to be able to install them into the database named "master"), and install the packages - Start with the package containing the templates, so the rest of the content is supported).

• Different DLL's from Sitecore Support:

I don't think there exists any Sitecore solution, that doesn't have at least a few DLL's from Sitecore Support (not suprising, since it is made by humans, and humans make mistakes).


However, when upgrading Sitecore, there is a good chance that some of these issues has been fixed - so start by contacting Sitecore Support, and ask them which of the Support DLL's that is still needed.


Once they have told you which one of them that is still needed - test them and see if they still works (Sitecore Support will most likely say that they works, but experience shows that they don't test them before saying that they work - so do your own testing!)

• Some media items no longer works:

Somewhere while developing Sitecore 7.x, replacers has been changed to also work for media items.
This means, that if you for instance has a replacer that replaces " " with "-", to make URL's more SEO friendly, this now also impacts media items.


So, if there is any media items (or media folders), containing some of the characters you are replacing, they can no longer be opened by users.


An easy fix is to make a small tool that runs through the media library, looks for items with those names (remember to check display names for all languages, if useDisplayNames is set to true on the LinkManager), and then rename them.

• Some items does not have any version (and therefore cannot be published):

When installing the items using the packages, some items might end up without any version (we had to add an version to some folders inside the Layouts folder, to be able to publish them and get the site working).


Again, make a small tool that crawls the entire solution and look for items without any version at all, and create an English version (or that ever your default language for the solution is).

• WFFM forms:

If you have to move WFFM forms from Sitecore 6.6 to 8.0, do note that the data the users has entered will not be moved, so make sure that is okay with the customer (most likely it is old data, and okay to not move along).


You might run into some issues when moving them, but they are solution specific, so be prepared to get some help from Sitecore Support.


That is all the problems we have run into, but nothing that cannot be fixed, which is okay.
Just remember to account for it, when estimating how long the upgrade is going to take you.

Certain users suddenly cannot insert components using the page editor

Okay, this was an interresting issue to debug.


One of our customers was having an issue with one (and only one) of their users not being able to insert components on pages using the page editor.


First we tried comparing permissions, role membership with other users (they matched btw.), and nothing helped.


To solve it, we wrote a small aspx page, that changed the current user context to the broken user (to avoid having to ask the user for her password, since she is loaded using the AD module, getting her AD password is a big no-no).


Then, as soon as we had the user context, it was pretty easy to open the page editor, and see for ourselves.


For some reason, if the user has unchecked the Design checkbox, the New Component button is just disabled (hint to UI designes - if you disable something, add a tooltip that tells why it is disabled!).


That also explains why it only happened to her, since it is saved on her Sitecore profile.

When the From field in WFFM is not being used

If you might happen to be running Sitecore 6.6 still, and be using WFFM for your forms, you can run into this issue.


It seems that, for some reason, the WFFM module ignores the From field defined locally on a form, and always use the one defined on the Send Email Message save action.


This has been fixed in WFFM 2.4 rev. 150619, but if you are using Sitecore 6.6, you cannot upgrade to this version of the module.


So to fix this, you need a single DLL from Sitecore Support (just ask for the file "Sitecore.Support.420165.dll", and change the Save Email Message save action to use this Assembly and Class: "Sitecore.Support.420165.dll" and "Sitecore.Support.Form.Submit.SendMessage"


They publish the save action to the web database.


Now the save action will be sending mails using the locally defined From, and only fall back to the one on the save action when needed.