Published: May 12, 2010
You can use the pre-upgrade checker to report on the status of your environment and SharePoint sites before you upgrade to Microsoft SharePoint Foundation 2010. We highly recommend that the server administrator run the pre-upgrade checker and resolve as many problems as possible before scheduling the upgrade.
The pre-upgrade checker is an Stsadm operation that you run in a Windows SharePoint Services 3.0 environment to find any potential issues for upgrade and to review recommendations and best practices. The operation is available with Windows SharePoint Services 3.0 Service Pack 2 and has been updated in the October 2009 Cumulative Update for Windows SharePoint Services 3.0. You can download and install the October 2009 Cumulative Update from October 2009 Cumulative Update Packages for SharePoint Server 2007 and Windows SharePoint Services 3.0 are published (http://go.microsoft.com/fwlink/p/?LinkID=169179).
Note:
|
|
You might need to run the pre-upgrade checker more than once. For example, if you run the tool to evaluate your server farm but do not perform the upgrade for a few weeks, you can run the tool again just before you perform the upgrade to scan any new sites and to ensure that no additional issues have appeared in the meantime.
|
In this article:
Note:
|
|
One frequent cause of failures during upgrade is that the environment is missing customized features, solutions, or other elements. Be sure that any custom elements you need are installed on your front-end Web servers before you begin the upgrade process. You can use the pre-upgrade checker — and, for a database attach upgrade, the test-spcontentdatabaseWindows PowerShell cmdlet — to identify any custom elements that your sites might be using. For more information, see Identify and install customizations in the article "Use a trial upgrade to find potential issues."
|
About the pre-upgrade checker report
The pre-upgrade checker reports information about the status of your environment and the SharePoint sites in that environment, including:
-
Upgrade readiness and supported paths Returns a list of all servers and components in the farm and information about whether the servers meet requirements for upgrading.
-
Alternate access mapping settings Returns a list of the alternate access mapping URLs that are being used in the farm.
-
Installed elements Returns a list of all site definitions, site templates, features, and language packs that are installed in the farm. You need to know which site templates have been installed or used so that you can verify that they are available after an upgrade or database attach. You also need to know which elements have been customized so you can verify the customizations again after the upgrade. For example, you need to know whether a site depends on a language pack for Windows SharePoint Services 3.0 that does not exist yet for SharePoint Foundation 2010, so you can plan how to handle that site during upgrade.
-
Unsupported customizations Reports whether any server-side customizations that are not supported (such as database schema modifications) exist in the farm.
-
Orphaned objects Lists any database or site orphans in the farm. Objects such as list items, lists, documents, Web sites, and site collections can become orphaned — that is, the objects exist but are not associated with a particular site. Because orphaned objects do not work in the previous version, they won’t work after the upgrade. If you perform an in-place upgrade, the orphaned items will still exist, but will not work. We recommend that you repair any orphaned objects before upgrading.
-
Valid configuration settings Reports any missing or invalid configuration settings (such as a missing Web.config file, invalid host names, or invalid service accounts) that exist in the farm.
-
Database requirements Reports whether the databases meet the requirements for upgrade — for example, databases are set to read/write, and any databases and site collections that are stored in the Windows Internal Database are not larger than 4 GB.
Use the information gathered from the pre-upgrade checker to determine:
-
Whether to perform an in-place upgrade or a database attach upgrade.
Determine upgrade approach (SharePoint Foundation 2010) provides information to help you decide which type of upgrade to perform. It is important to consider the report generated by the pre-upgrade checker when you make this decision. If your servers do not meet the requirements for in-place upgrade, you need to consider performing a database attach upgrade.
-
Whether to upgrade some or all site collections that contain customized sites.
-
Which sites need to have customizations reapplied or redone after upgrade and therefore might take longer than others in the review stage.
A worksheet is available so you can record information about your environment while you prepare for upgrade. Download the worksheet from http://go.microsoft.com/fwlink/p/?LinkId=179928.
Run the pre-upgrade checker
Before you perform this procedure, confirm that:
To run the pre-upgrade checker
After you run the pre-upgrade checker, the report automatically opens in your default browser. You can also view the report by opening it from its location in the %COMMONPROGRAMFILES%\Microsoft Shared\Web Server Extensions\12\LOGS directory. The report is named in the following format: PreUpgradeCheck_YYYYMMDD-HHMMSS-SSS-random-number.htm, where YYYYMMDD is the date and HHMMSS-SSS is the time (hours in 24-hour clock format, minutes, seconds, and milliseconds), and the random number is used to differentiate between possible simultaneous attempts to run the pre-upgrade checker. There are also TXT and XML versions of the report in the same location.
Use the report to find and troubleshoot issues. You can also share the relevant results with other members of the upgrade team. For example, you can report issues such as customized site templates or custom Web Parts to the appropriate site owner, Web designer, or developer before scheduling the upgrade, to give them time to resolve the issues.
Other Resources
Downloadable book: Upgrading to SharePoint Foundation 2010
Resource Center: Upgrade and Migration for SharePoint Foundation 2010
Change History
|
Date
|
Description
|
|
May 12, 2010
|
Initial publication
|