Use a trial upgrade to find potential issues (Office SharePoint Server)

Applies To: Office SharePoint Server 2007

This Office product will reach end of support on October 10, 2017. To stay supported, you will need to upgrade. For more information, see , Resources to help you upgrade your Office 2007 servers and clients.


Topic Last Modified: 2016-11-14

Before you begin the upgrade process, you'll want to know approximately how long it will take, how many customizations will have to be done again or reapplied, and which sites may not upgrade as expected. The following method will help you determine what issues you may run into during the upgrade process, so you can address them before or after upgrade as appropriate.

  1. Run the pre-upgrade scan tool to find any custom sites or unghosted pages (required).


    You must run the pre-upgrade scan tool before starting the upgrade process. This tool steps through each site collection and generates a report about the state of each site. It also saves list definition information for each list. You can review the reports to find issues and address them before you start the upgrade process. This scan must be run before you can upgrade; the SharePoint Products and Technologies Configuration Wizard will not run if this scan has not been performed. For more information about this tool and steps for running the scan, see Run the pre-upgrade scan tool (Office SharePoint Server).

  2. Review common issues to see which issues may apply to your environment.

    This list gives you a quick look at some common issues you may run across, and how to address them either before or after performing the upgrade.

  3. Perform a trial upgrade by using a backup or mirrored (read-only) site (recommended, but optional).

    This is the best method for discovering issues. You can preview the entire upgrade process and find any issues and address them before you start (or at least know what to expect). This method does require extra time and hardware; however, if you do invest in a trial run, you'll have a much easier time during the real upgrade process.

Review common issues

When you run the pre-upgrade scan tool or a test upgrade pass, you may notice one or more of the following common issues in your sites. If you have several sites with these issues, it is recommended that you perform a gradual upgrade. With a gradual upgrade, you have both the old version and the new version of any affected sites available, and you can revert to the old sites or make updates to the new sites before making the new versions live. If you must run upgrade in place, be sure to take a backup of your sites before running the upgrade.

Issue Explanation and what to do

I do not know what has been customized.

The most time-consuming step in the upgrade process may be to identify existing customizations and then decide which customizations to upgrade, migrate, and discard; and then map those customizations to Office SharePoint Server 2007. Use WinDiff, a tool that is provided with most Microsoft operating systems, to compare the original (default) site definition files to current (custom) site definition files to identify customizations.

For more information, see Areas, Bucketwebs, Upgrade and Redirects ( and Upgrading SharePoint Portal Server 2003 Customizations to SharePoint Server 2007 (

The local server and server farm administrators cannot browse to the sites.

In the new release, local server and server farm administrators are not automatically granted access to site content. If you want these users to have access to all site content, you can use the Web application policy to grant these users access to all sites. For more information about policy, see "Policy for Web applications" in the Logical architecture components article.

My branding customizations are lost during upgrade.

The methods to use for branding your site have changed in the new version. For example, you can now use Master Pages to control the layout and structure of your pages. Reapply branding by using the new methods. For more information, see Plan Web pages.

My themes are lost during upgrade.

Themes have been reworked and redesigned for the new version. Apply a new theme.

Customizations done in Microsoft® Office FrontPage® 2003, are retained (my pages are still unghosted), but new functionality does not appear in the site.

Revert the pages to template to get the latest functionality, then reapply customizations in Microsoft Office SharePoint Designer 2007. For more information about reverting to a template, see Reapply customizations in the browser and Microsoft Office SharePoint Designer 2007.

Hard-coded URLs in Web Parts and pages that pointed to specific places in my sites no longer work.

The URLs for certain pages may have changed during upgrade (for example, if you had some areas with the /C2/ or /C16/ paths, then those paths may have been updated to /sites/ instead). Navigate to the appropriate location, and then recreate the URLs to point to the new location.

My sites are based on a heavily customized site definition.

Before upgrading your sites, create a new site definition, and then create an upgrade definition file so the upgrade process can map your old site definition elements to the new site definition.

I had extended form libraries and they no longer work.

Support for forms has been changed from form libraries to document libraries. Redeploy and reapply the forms to new document libraries.

We started the gradual upgrade process, and now my forms do not work.

Some InfoPath forms contain hard-coded links to a data location (such as a specific SharePoint list, Web service, or XML file). Because the link is hard-coded, it cannot be fixed automatically to point to the temporary URL that is used for sites that have not yet been upgraded during gradual upgrade. To fix the forms, you can immediately upgrade the sites that contain forms with broken links (thus restoring the original URL). If you cannot upgrade the sites immediately (for example, if there are other issues with the site that you need to investigate before upgrading), you can republish the forms and point to the temporary URL domain. Note that, if you choose to republish the forms, you'll have to republish the forms again after you upgrade the sites to point to the original URL, so use this option sparingly. For more information about the temporary URLs used during gradual upgrade, see How the upgrade process works (Office SharePoint Server).

I had custom message text for Alerts and it is no longer displayed.

The custom messages are preserved, but you must manually transfer the message file to the new path.

I had custom event handlers configured for my environment.

You may need to reapply the event handlers, or use new features to perform the tasks instead.

Some controls that I rely on have been deprecated.

Remove the references to the controls from your new site definition. For more information about deprecated controls and which controls or features to use instead, see the Microsoft Office SharePoint Server 2007 Software Development Kit (SDK).

My Web Parts were obfuscated in the old version, and now they do not work in the new version.

You may need to rebuild the Web Parts with ASP.NET 2.0.

My custom Web services relied on hard-coded URLs or functionality that has changed.

You may need to rework the Web services to use the new URL schemes and new functionality. For more information, see the Office SharePoint Server 2007 Software Development Kit (SDK) and Comparison of key features.

My contributing users can edit and change landing pages after upgrade.

Because areas are now sites and the pages in the areas are stored in the Area Pages document library, members of your old contributor group can now edit them. If you need to control who can edit these pages, change the permissions for the document library to be more restrictive.

Some files (with extensions .asmx, .rem, .resx, .soap, or .ashx) are no longer visible or cannot be opened after upgrade.

These file extensions have been added to the list of blocked file extensions for the new version. If you need to allow users to upload or download files with these extensions, you can remove the entries for these extensions from the list. For more information about managing blocked file extensions, see the topic Manage blocked file types in the Office SharePoint Server 2007 Central Administration Help system.

I don't see a Link to Outlook button on View pages anymore.

You must revert the page to the template version to get the new user interface controls on the View pages, such as this control.

I can't revert a custom page to template.

If you added a completely custom page to your site (for example, if you replaced default.aspx with a completely different file rather than making changes to the existing default.aspx file), that page has no association with the site definition and so cannot revert to template. If you want your custom page to have the same look and feel as the other pages in your site, consider creating a new page based on the site definition and transferring your customizations to that new page.

In addition to the above issues, some changes in functionality between the previous version and the new version result in issues that you'll have to resolve either before or after upgrade. These issues include:

Issue Explanation and what to do

Search scopes do not upgrade.

Because of the changes in the scope infrastructure, search scopes from SharePoint Portal Server 2003 do not upgrade directly to Office SharePoint Server 2007. After upgrade, you must recreate your search scopes in the new infrastructure. For more information, see the search topics in the Planning Guide.

The site directory has been redesigned.

Many changes have been made to how the site directory works, including the following:

  • The site directory search box is removed from the site directory page after upgrade. This is because the default search box now can search the site directory and its subsites. To search just the Site directory list, use the contextual scope to search only This List.

  • Creating a site from the Site directory now creates subsites under the Site directory, not site collections. Existing sites under the Site directory remain site collections after upgrade, and there is no navigation hierarchy for them (except for the data that was already populated in the Site Directory list); however, any new sites are created as subsites and do appear in the navigation hierarchy as well as in the sites list in the Site Directory.

E-mail–enabled document libraries have been replaced with the incoming e-mail feature.

In the previous version, you could set up a public folder, and have documents sent to the public folder automatically added to a specific document library. This functionality has been replaced with the incoming e-mail feature in the new version and will no longer work after you perform the upgrade. After upgrade, you can configure incoming e-mail to restore the ability to archive documents from e-mail messages. For more information, see Plan incoming e-mail (Office SharePoint Server).

Perform a trial upgrade

If you have the resources available, it is recommended that you perform a trial upgrade to discover any issues before you perform the actual upgrade. You can perform this trial upgrade on either a backup or a mirrored version of your site.

To perform a trial upgrade on a backup version of your environment:

  1. Take a full backup of your server or server farm.

  2. Restore the backup on separate hardware, and configure that environment so it is identical to your product environment (for example, install any custom Web Parts, custom binaries, site definitions, and so on).

  3. Perform the pre-upgrade, upgrade, and post-upgrade steps for the upgrade path you will use in your live environment.

  4. Review the results and look for issues that you can address before performing the upgrade in your live environment.

To perform a trial upgrade on a mirrored (read-only) version of your environment:

  1. In the mirrored environment, perform the pre-upgrade, upgrade, and post-upgrade steps for the upgrade path you will use in your live environment.

  2. Review the results and look for issues that you can address before performing the upgrade in your live environment.

Download this book

This topic is included in the following downloadable book for easier reading and printing:

See the full list of available books at Downloadable content for Office SharePoint Server 2007.