Upgradingto SharePoint 2013

Bert Johnson

About Bert Johnson• SharePoint Architect with Protiviti• Microsoft Certified Master since 2010

• bert@bertjohnson.net• http://www.slideshare.net/bertjohnsonnet/• Twitter: @SPBert

Agenda• Overcoming Upgrade Constraints• What To Know Before Upgrading• Upgrade Planning and Preparation• Executing the Upgrade• Upgrade Verification and Cleanup• Troubleshooting Upgrades• Behind the Scenes

Overcoming Upgrade Constraints

Cost Constraints• Licensing, which may be included in your Enterprise

Agreement• No “in-place upgrade”, so SharePoint 2013 will require dedicated servers / VMs• Legacy version upgrades (SPS2003, MOSS2007) may

require third-party migration applications• Training investments shouldn’t be overlooked

Time Constraints• One or more trial upgrades should take place beforehand• Features and Information Architecture may need

planning• Overall duration constrained by database size and IOPS• Once binaries and databases are upgraded, the search index needs to be rebuilt• Can be performed in phases:

• Upgrade service applications before web applications• As-needed or “deferred” web application upgrades• Individual site collection upgrades can be delegated to users

Usability Constraints• No more “pre-upgrade check”; the process is more

manual• To leverage new functionality, master pages need to

be converted to 15 mode• Overall, SharePoint 2013 provides a much more intuitive UI and requires less core training• SharePoint 2013 is mostly accretive, but some features have been removed

What To Know Before Upgrading

Upgrade Improvements• Test-SPContentDatabase• Deferred Site Collection Upgrades• Evaluation Upgrade Sites• Event Notifications System• Health Checks and Logging Improvements• Upgrade Throttling• V2V Service Application Support• All 2010 binaries, etc. installed; all features; existing

customizations work; default

Upgrading from Legacy Versions• No direct upgrade path from SPS2001/2003 or

MOSS2007• Options:• Upgrade to intermediate versions first• Use third-party tools• Manually migrate content

• These are the most complex upgrades

Office 365• Nothing to worry about; Microsoft has it covered…• …except for usability, training, and communications

• Office 365 is “versionless” going forward• Most SP2010->2013 cloud upgrades completed by end

of summer

Deprecated Features• Legacy Web Analytics Feature• Barcodes• Chart Web Part• Document and Meeting Workspaces• Internet Explorer 7 Support• PowerPoint Broadcasting• Project Web Access• Slide Libraries• Visual Upgrade

Upgrade Planning

What Happens in a SharePoint Upgrade?1. Planning

A. Inventory settingsB. Test for blocking issuesC. Plan for customizations and UI updatesD. Determine upgrade parametersE. Create project planF. Change Management and communications

2. PreparationA. Install new farmB. Mitigate blocking issuesC. Prepare customization upgrades

3. ExecutionA. BackupB. Upgrade service applicationsC. Set upgrade parametersD. Upgrade web applicationsE. Upgrade site collections (at once or deferred)

4. Verify, Clean Up, and Communicate

Why Upgrades Succeed or Fail

Planning Step 1: Inventory Settings• Survey:• Servers• Databases• Customizations and solution packages

• Save Get-SPFeature and Get-SPSolution files• Back up FEATURES directory

• “Unghosted” / customized files• Search Settings• Authentication

• Now is a great time to clean up unneeded content

Planning Step 2: Test for Blocking Issues• Install a SharePoint 2013 farm to test existing content

databases• This doesn’t have to be the eventual production environment• No, there’s no way to accurately test a 2010 database without

2013

• Run Test-SPContentDatabase for each content database and save the output

Planning Step 3: Plan for Customizations/UI• Review known customizations• Ensure that all WSPs are available• These can be exported using Get-SPSolution and its

SaveAs() method

• Look for FEATURE differences between farm servers• Determine how UI changes will be applied• We can use the default 15 master page or create our own

using the new Design Manager

• Plan for any custom authentication, such as FBA

Planning Step 4: Determine Upgrade Parameters• Are we doing a “big bang” upgrade with everything at

once or a gradual, user-defined upgrade?• If gradual, will “preview sites” be enabled?• Are we going to apply other changes, such as

navigation changes or feature roll-outs at the same time?• Should it be possible to create “SharePoint 2010 Mode”

sites in the new farm?• Will upgrade reminder emails be sent out?• How should concurrent site upgrades be throttled?

Planning Step 5: Create the Project Plan• Schedule pre-work and trial upgrades as far ahead as

possible• If necessary, assign pre-work to end users first (e.g.

delete unused content ahead of time)• Account for usual SLAs• Create a master checklist with explicit task assignments

Planning Step 6: Change Management• Always account for:

• Awareness• Desire• Knowledge• Ability• Reinforcement

• Alert to the coming change early and get people on board• Leverage your “SharePoint” champions• If performing other changes, hold focus groups and pilots• SharePoint 2013 shouldn’t need extensive training over

2010

Upgrade Preparation

Preparation Step 1: Install New Farm• First create and execute upgrades of preproduction

farms• You have those, right?

• Ensure there’s plenty of storage for database upgrades• Deploy all solution packages and settings, including

authentication• Patch to desired Cumulative Update

Preparation Step 2: Test for Blocking Issues• Re-run Test-SPContentDatabase on each database• Address common issues at the source:• Missing dependencies

• Copy and deploy solution packages and/or feature folders

• Orphaned sites• Remove-SPSite

• Wide lists• Delete excess lookup, choice, or managed metadata columns

• Consider upgrading to claims authentication• In 2010, $wa.UseClaimsAuthentication = $true;

$wa.Update()

Preparation Step 3: Customization Upgrades• Recreate master pages using Design Manager• Plan feature-specific upgrades if appropriate• Check for deprecated APIs• Switch to using new REST web services• Make all custom code claims-aware

Upgrade Execution

Upgrade Step 1: Back Up Everything• Databases• File System• Encryption Key from User Profile Service

Upgrade Step 2: Service Applications• Core Service Applications are backwards compatible• Run PowerShell to upgrade each of the following first:• Business Data Connectivity• Managed Metadata• PerformancePoint• Search

• Administration Database Only

• Secure Store• User Profile

• Profile, Social, and Sync Databases Only

• Can attach to service proxies from original farm

Upgrade Step 2: Service Applications• Other Service Applications can be created from scratch• FAST Search• Requires several manual steps:

http://technet.microsoft.com/en-us/library/dn130132(v=office.15)

• Office Web Apps• New version should be installed; no need to upgrade data

Upgrade Step 3: Set Parameters• $wa.CompatabilityRange: OldVersions, NewVersion,

or AllVersions?• $wa.UpgradeReminderDelay and

$wa.UpgradeMaintenanceLink• $wa.SiteUpgradeThrottlingSettings limits• $site.AllowSelfServiceUpdate: $true or $false?

Upgrade Step 4: Upgrade Content Databases• Attach each content database using Mount-SPContentDatabase• Automatically starts upgrade; Upgrade-

SPContentDatabase resumes• Can run multiple database upgrades at a time

• Can even do this on separate farms / SQL servers, then move the upgraded databases later

• Optimize spindles / IOPS when possible

• Very upgraded sites work and are unlocked

Upgrade Step 5: Upgrade Site Collections• Optionally, can choose to preupgrade some or all site

collections• MySite host should be upgraded before MySites• Can be done through UI:

• Run site collection health checks• Request evaluation site• Upgrade the site• Upgrade information logged to new _catalogs directory

• Can be scripted:• Upgrade-SPSite

• Note: upgraded files aren’t shredded by default

Verify Upgrade, Clean Up, and Communicate

Verify Upgrade, Clean Up, and Communicate• Use the “Upgrade Status” page in Central Administration• Review the log files for errors and warnings• Spot check for:

• All content renders• Permissions appear correct• Search works• Custom functionality works• UI looks correct

• Clean up backups and optionally shrink databases• Should be communicating throughout: make sure to highlight

the benefits when the new version launches

Troubleshooting Upgrades

Troubleshooting• “Wide List” Issue

• Too many lookup, choice, and/or managed metadata columns• No workaround short of removing columns

• Missing Solutions and Feature Definitions• Can use PowerShell to export .WSP definitions• As a last resort, can copy feature folders between environments

• Path conflicts• Shouldn’t have created objects in _catalogs; will need to delete

• “Unghosted” / Customized Files• No shortcut; need to revert customizations in order to use SharePoint 2013 look and

feel

• Site locked after upgrading• Error likely occurred and upgrade didn’t finish; mitigate issue and rerun upgrade

• Always check the logs

Behind the Scenes

SharePoint Upgrade Internals• Objects upgraded via SPSequence and SPAction in this hierarchy:

• SPFarm• SPServices• SPFeatures• SPWebServiceInstances

• SPWebServices• SPWebApplications

• SPIISWebSite• SPFeatures• SPContentDatabases

• SPSiteCollection• SPFeatures• SPWeb

• SPWebTemplates• SPFeatures

• Upgrade pipeline can be viewed in [Hive]\Config\Upgrade

Q&A

Resources• TechNet SP2013 Upgrade Center: http://

technet.microsoft.com/en-us/library/cc303420.aspx• TechNet Known SP2013 Issues: http://

office.microsoft.com/en-us/help/sharepoint-foundation-2013-known-issues-HA102919008.aspx• Discontinued Features: http://

office.microsoft.com/en-us/sharepoint-help/discontinued-features-and-modified-functionality-in-microsoft-sharepoint-2013-HA102892827.aspx• Updates for SP2013:

http://technet.microsoft.com/en-us/sharepoint/jj891062.aspx• Introduction to Upgrade:

http://blogs.technet.com/b/wbaer/archive/2012/07/17/introduction-to-upgrade-in-sharepoint-server-2013.aspx

About Bert Johnson• SharePoint Architect with Protiviti• Microsoft Certified Master since 2010

• bert@bertjohnson.net• http://www.slideshare.net/bertjohnsonnet/• Twitter: @SPBert