Microsoft

Upgrading Sitecore – 8.0 update 4 to 8.1 update 2 – Walkthrough

Microsoft - The Essential Guide to Microsoft Teams End-User Engagement
The Essential Guide to Microsoft Teams End-User Engagement

We take you through 10 best practices, considerations, and suggestions that can enrich your Microsoft Teams deployment and ensure both end-user adoption and engagement.

Get the Guide

Recently, I posted about issues that ran into during an upgrade of 8.0 update 4 rev. 150621 to 8.1 update 2 rev. 160302. That article is available here. That article did not cover the actual process of upgrading and I thought it may be beneficial to provide a walk-through of that.
To start off, I went to dev.sitecore.net to look at the upgrade information for the most current release, which at the time of the upgrade was 8.1 update 2. In the upgrade pdf that is available for download I found that 8.1 Initial Release rev. 151003 is required to upgrade to update 2.
SC81-2-UpgradePreReqs1
SC81-2-UpgradePreReqs2
From there I looked at the upgrade requirements to get to 8.1 Initial Release. The prerequisites to get to 8.1 Initial Release are 8.0 Initial Release rev. 141212 or later. So the upgrade process I needed to follow was actually 2 upgrades. The first one being 8.0 update 4 to 8.1 initial and then the second one being 8.1 initial to 8.1 update 2.
SC81-2-UpgradePreReqs3
SC81-2-UpgradePreReqs4
The first part of the process was to install the Update Installation Wizard 1.0.0 rev. 150930.zip package. That package is available from the same page that was used to retrieve the upgrade pdf. note: in the 8.1 update 2 pdf it lists that Update Installation Wizard 1.0.0 rev. 160203.zip should be used. Please read the issues that I ran into with that here.
Install the Update Installation Wizard:
Launch the Installation Wizard from the Sitecore Desktop’s Development Tool item.
WizardInstall1
Upload the Update Installation Wizard Package.
WizardInstall2
WizardInstall3
WizardInstall4
WizardInstall5
WizardInstall6
WizardInstall7
When prompted, overwrite the Sitecore.Update.dll.
WizardInstall8
WizardInstall9
Now it’s time to start the upgrade. As noted in the upgrade guide, I downloaded the ‘Sitecore update package’ and ‘configuration files for upgrade’ zip files. Before actually upgrading, there were a few modifications that needed to be made to the existing config files.
I had the GEOIP module installed, so disabling the related config files was necessary. To disable the files, append the ‘.disabled’ extension to them. If you don’t have these files that’s fine and continue on.
note: If you are using the Email Experience Manager (EXM) you’ll need to disable those configs as outlined in the upgrade pdf (pg 4).

ConfigDisable1
Disable the ‘Sitecore.Forms.config’ file, if you are not using WFFM then you may not have this file.
ConfigDisable2
Copy the .Net Assemblies from the configuration files zip folder to the site’s \bin directory.
DllCopy
DllCopy2
Disable analytics for the site by opening the Sitecore.Analytics.config and setting the ‘Analytics.Enabled’ setting to ‘false’.
DisableAnalytics1
DisableAnalytics2
Disable the ‘Sitecore.Analytics.Processing.Aggregation.Services.config’ and the ‘Sitecore.Analytics.Processing.Services.config’ files, located in the \App_Config\Include directory.
ConfigDisable3
In the site root’s web.config file, locate the <compilation> section in the <assemblies> node and remove the versions for System.Web.Mvc, System.Web.Http, System.Web.Http.WebHost, and System.Net.Http.Formatting.
WebConfig1
In the web.config file’s <assemblyBinding> node, point the versions to 5.2.3.0 for the dlls referenced above.
WebConfig2
WebConfig3
Open up the \App_Config\Includes\Sitecore.Mvc.config file and paste the following text after the <pipelines> section.

<mvc>
 <areas>
  <!-- MVC: Sitecore will by default register all areas in the initialize pipeline.
  Use the below list to specify areas that should not be registered in the initialize pipeline. -->
  <excludedAreas>
   <area type="Sitecore.Social.Client.Mvc.Areas.Social.SocialAreaRegistration, Sitecore.Social.Client.Mvc" />
  </excludedAreas>
 </areas>
</mvc>

 
MvcConfig
MvcConfig2
In the \App_Config\Includes\Sitecore.Speak.config, comment out the Speak.Components.KnockoutPresenter setting.
SpeakConfig
Two SQL scripts were required to be run against the Sitecore databases.
Run the CMS80u3_BeforeInstall.sql script against the master, core, and web databases. The scripts came in the Configuration files for upgrade zip file downloaded earlier.
81DbScripts
*note: the zip file contains CMS81_AfterInstall.sql which is needed for Item Clones. The instance I was working with did not have any clones so that process is not covered. Please review the upgrade pdf (pg 7) if you are following along and using Item Clones.
81DbScripts2
Run against master, core, and web by selecting the database from the database selection drop-down.
81DbScripts4
Run the SXP81_BeforeInstall.sql script against the reporting (analytics) databases.
81DbScripts3
81DbScripts5
81DbScripts6
Backup the dictionary.dat file located in \temp. After backing up that file, delete it from the \temp directory.
DeleteTempDat
That’s it for the pre-update changes needed. The next part is to start the actual upgrade using the Sitecore update package downloaded previously.
Backup your Website directory.
Launch the Update Installation wizard by navigating to http://<yoursiteinstance>/sitecore/admin/UpdateInstallationWizard.aspx
Press the ‘Choose a package’ button.
81Wizard1
Press the ‘Choose File’ button.
81Wizard2
Select the ‘Sitecore 8.1 rev. 151003.update’ file from the update package zip downloaded earlier.
81Wizard3
Select ‘View package information’ to continue.
81Wizard4
Press the ‘Analyze and install the package’ button to continue.
81Wizard5
In my instance the items listed as potential problems, were not actual problems. You’ll want to review your list to verify any potential issues before continuing. Press the ‘Install the package’ button to continue.
81Wizard6
Once installation is complete, press the ‘Installation result’ button to continue.
81Wizard7
The package is now installed and Sitecore is updated with 8.1 rev 151003 (initial release).
81Wizard8
Copy the \App_Config directory from the ‘Configuration files for upgrade to Sitecore 8.1 rev.151003.zip’ file downloaded earlier, to the website’s \App_Config directory. This directory was backed up prior to the upgrade so the necessary ConnectionStrings.config, DataFolder.config, SiteDefinition.config and other instance specific configs are safe.
81ConfigReplace
81ConfigReplace2
Do the same thing for the web.config file.
81ConfigReplace3
Once the config files were updated, I verified that my Sitecore instance loaded and that I could log into the client interface.
The last half of the upgrade is bringing the Sitecore instance from 8.1 to 8.1 update 2. For this part of the upgrade I needed to download the 8.1 rev. 160302 update package and configuration files as outlined in the 8.1 Update 2 Upgrade Guide pdf.
SC81-2-UpgradeFiles
The pre-update changes for this part are not as much as the last part.
Disable analytics by setting the ‘Xdb.Enabled’ and ‘Xdb.Tracking.Enabled’ values to ‘false’ in the \App_Config\Include\Sitecore.Xdb.config file.
812Configs
Disable ‘Sitecore.Analytics.Processing.Aggregation.Services.config’ and ‘Sitecore.Analytics.Processing.Services.config’. These files are located in \App_Config\Include.
ConfigDisable3
 
Backup your Website directory.
Launch the Update Installation wizard by navigating to http://<yoursiteinstance>/sitecore/admin/UpdateInstallationWizard.aspx
Press the ‘Choose a package’ button.
812Wizard
Locate the ‘Sitecore 8.1  rev. 160302.update’ file from the zip file that was downloaded.
812UpdateFile
Press the ‘Analyze and install the package’ button to continue.
812Wizard2
Press the ‘Analysis results’ button to continue.
812Wizard3
In my instance the items listed as potential problems, were not actual problems. You’ll want to review your list to verify any potential issues before continuing. Press the ‘Install the package’ button to continue.
812Wizard4
Press the ‘Installation results’ button to continue.
812Wizard5
The package has now been successfully installed.
812Wizard6
Copy the \App_Config directory from the ‘Config Files for Sitecore 8.1 Update-2.zip’ file downloaded earlier and paste them into your website’s \App_Config folder. This directory was backed up prior to this part of the upgrade as well, so the necessary ConnectionStrings.config, DataFolder.config, SiteDefinition.config and other instance specific configs are safe.
812ConfigFileUpdate
812ConfigFileUpdate1
Do the same thing for the web.config file.
812ConfigFileUpdate2
Once the config files were updated, I verified that my Sitecore instance loaded and that I could log into the client interface.
Now that the instance is updated to 8.1 update 2, there are a few more steps to get the databases back in sync.
As noted in the upgrade guide rebuilding the Search Indexes and Link Database is recommended after performing the upgrade.
Open the Control Panel from the Sitecore Launchpad.
PostUpgrade
Locate the ‘Indexing’ section and select the Indexing manager
PostUpgrade1
Select All indexes and press the ‘Rebuild’ button.
PostUpgrade2
PostUpgrade3
Select Rebuild search indexes from the ‘Database’ section.
PostUpgrade4
Check the box for Quick search index and press the Rebuild button.
PostUpgrade5
PostUpgrade6
Now select Rebuild link databases from the ‘Database’ section.
Check the boxes for core, master, and web then press the Rebuild button.
PostUpgrade7
PostUpgrade8
Next, make sure to turn Analytics (XDB) back on. Navigate to the Sitecore.Xdb.config file located in \App_Config\Include and set the values to ‘true’ for the settings ‘Xdb.Enabled’ and ‘Xdb.Tracking.Enabled’.
PostUpgrade9
That was it for my upgrade process. There are additional upgrade steps required for the Web Forms For Marketers module and potentially any other module that you may have installed in your instance. Information on the individual module upgrades can be obtained from dev.sitecore.net under the Downloads section for the specific module.
Thanks.

About the Author

More from this Author

Thoughts on “Upgrading Sitecore – 8.0 update 4 to 8.1 update 2 – Walkthrough”

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Subscribe to the Weekly Blog Digest:

Sign Up
Categories