Upgrading Windows SharePoint Services 2.0 to 3.0 After Upgrading Team Foundation Server

  • Article

When you upgrade Team Foundation Server 2005 to Team Foundation Server 2008, Windows SharePoint Services are not automatically upgraded. If you intend to use the newest version of SharePoint Services together with Team Foundation Server 2008, you must manually upgrade Windows SharePoint Services 2.0 to Windows SharePoint Services 3.0.

The upgrade process includes the following tasks:

  1. Upgrade to Windows SharePoint Services 3.0.
    • Prepare to upgrade.
    • Complete an in-place upgrade to Windows SharePoint Services 3.0.
    • Configure SharePoint Services.
  2. Update the port number for SharepointAdminUri.
  3. Install and configure the Team Foundation Server 2008 templates for Windows SharePoint Services 3.0.
  4. Perform Post-Upgrade Tasks.
    • Optional: Migrate Team Foundation Server 2005 content.
    • Optional: Uninstall Windows SharePoint Services 2.0.

Content for this article was based in part on Knowledge Base (KB) article 952692 Upgrading Windows SharePoint Services from version 2.0 to 3.0 after upgrading Team Foundation Server 2005 to version 2008.

Upgrade to Windows SharePoint Services 3.0

The Windows SharePoint Services documentation includes a wealth of information for preparing to upgrade from SharePoint Services 2.0 to 3.0. The full set of topics can be found at Upgrading to Windows SharePoint Services 3.0.

To prepare to upgrade

  1. Read the topic Perform pre-upgrade steps and complete the recommended tasks.

  2. Run the pre-upgrade scan tool to identify any issues with the Web site that would stop the upgrade.

  3. Fix the issues that were identified by the pre-upgrade scan tool.

You are now ready to upgrade. For detailed Help, see Install and configure Windows SharePoint Services for an in-place upgrade.

Note

If you have custom site definitions or custom Web applications installed on your server, you must create upgrade definition files before you install the upgrade. For more information, see Install and configure Windows SharePoint Services for an in-place upgrade.

To complete an in-place upgrade

  1. Double-click SharePoint.exe located on the Microsoft Visual Studio 2008 Team Foundation Server installation media in the folder \AT\wcu\WSS.

    You can also download and install Windows SharePoint Services 3.0 from the Microsoft Download Center.

  2. Read and accept the Microsoft Software License Terms.

  3. On the Upgrade earlier versions page, click Yes, perform an automated in-place upgrade.

  4. On the Server Type tab, select Web Front End.

  5. Click Install Now.

  6. In the final dialog box, select Run the SharePoint Products and Technologies Configuration Wizard now check box and then click Close.

After you install Windows SharePoint Services 3.0, you must specify a new port number for SharePoint Web applications.

To configure SharePoint Services

  1. On the Welcome page, click Next.

  2. In the first message box, click Yes.

  3. In the second message box, click OK.

  4. On the Configure SharePoint Central Administration Web Application page, select the Specify port number check box, and then type a new port number to use.

    Warning

    You cannot specify the old port number, such as the default port number 17012 for a Team Foundation Server 2005 installation, because that port is being used. You must select a new port number, such as 17013. Make a note of this port number.

  5. In the Configure Security Settings section, select NTLM.

  6. Follow the instructions on the remaining pages of the wizard to finish configuring SharePoint Services.

  7. If a message box appears, click OK.

    The Configuring SharePoint Products and Technologies page will appear after you click Next. This page updates one time per minute until the upgrade is completed.

Update the Port Number Information

After you have configured SharePoint Services, you must update Team Foundation Server to use the new port number. For more information, see TFSAdminUtil Command-Line Commands.

Note

If you did not note the new port number, you can locate the port number by going to Control Panel\Administrative Tools\SharePoint 3.0 Central Administration.

To update the port number for SharepointAdminUri

  1. At the Windows command line, browse to the location where you installed Team Foundation Server 2008. The default location is \Program Files\Microsoft Visual Studio 2008 Team Foundation Server.

  2. Locate the Tools folder.

  3. Type the following and then press Enter:

    tfsadminutil configureconnections /view

  4. Copy the value of SharepointAdminUri.

  5. Type the following and then press Enter:

    tfsadminutil configureconnections /SharepointAdminUri:http://machinename:port/_vti_adm/admin.asmx

    Where the value of port is the new port number you created in the previous procedure.

  6. To verify that the value of SharepointAdminUri was changed successfully, type the following and then press Enter:

    tfsadminutil configureconnections /view

  7. Note the returned values for SharepointAdminUri, ReportsUri, and ReportServerUri, because this information will be used in the next procedure.

Install and Configure Windows SharePoint Services Extensions

Windows SharePoint Services Extensions includes templates used by Team Foundation Server for project portals.

To install and configure Team Foundation Server templates for SharePoint Services 3.0

  1. Double-click Setup.exe located on the Microsoft Visual Studio 2008 Team Foundation Server installation media.

  2. Select Windows SharePoint Services Extensions and then click Install.

    When setup reaches the end, the Team Foundation Server SharePoint Configuration dialog box appears.

  3. In the Windows SharePoint Services site text box, enter the SharePointSitesUri value that you wrote down in the previous procedure, starting with http://.

  4. In the Reporting Services reports site text box, enter the value for ReportsUri that you wrote down in the previous procedure, starting with http://.

  5. In the Reporting Services administrative site text box, enter the value for ReportServerUri, starting with http:// but excluding/ReportService.asmx.

  6. Click Apply.

  7. If a message box appears and asks you to overwrite the current values for Reports and Report Server, click Yes.

  8. A message box might appear, confirming that the Windows SharePoint Services site has been updated successfully. Click OK.

  9. Click Exit to close the Team Foundation Server SharePoint Configuration dialog box.

Perform Post-Upgrade Tasks

Windows SharePoint Services 3.0 Help includes detailed information about actions you should take when you have completed the initial upgrade from 2.0 to 3.0. The full list of steps is found in the topic Performing post-upgrade steps (Windows SharePoint Services).

Specifically, you might consider migrating Team Foundation Server 2005 content stored in the STS_Content_TFS database. For more information, see Migrate content or sites after upgrade (Windows SharePoint Services).

Once you have completed any post-upgrade steps, you can safely uninstall Windows SharePoint Services 2.0. Team Foundation Server 2008 will now use Windows SharePoint Services 3.0.

See Also

Other Resources

Upgrading SharePoint Products and Technologies for Team Foundation Server
TFSAdminUtil Command-Line Commands
Team Foundation Installation Guide