Share via

SharePoint Products and Technologies is not configured correctly

  • Article

The information in this article applies to:

  • Visual Studio 2005 Team Foundation Server

  • Visual Studio Team System 2008 Team Foundation Server

  • SharePoint Products and Technologies

  • Application-tier server or server where SharePoint Products and Technologies is installed

  • Health check

The Best Practices Analyzer tool for Team Foundation Server checks the configuration of SharePoint Products and Technologies. An error appears if one of the following conditions is true:

  • Windows SharePoint Services ISAPI filter is missing.

    To resolve this issue, open Internet Information Services (IIS) Manager on the application-tier server, and configure the ISAPI filter for the Default Web Site. For more information, see the first procedure in this topic.

    Note

    This rule is checked and applies only if Windows SharePoint Services 2.0 is deployed. 

  • SharePoint Products and Technologies custom template is missing.

    To resolve this issue, retrieve and upload the missing site template. For more information, see the second procedure in this topic.

    Note

    When you create a project, Team Foundation Server uses both process templates and site templates. Process templates have a .zip extension (for example, MsfAgile_New.zip and MsfFormal_New.zip) and are stored in the Team Foundation database. Site templates have an .stp extension (for example, MSFAgile.stp and MSFFormal.stp) and are stored in the database for SharePoint Products and Technologies. When you create a project, you specify a process template, which then references the site template by name. If the site template is missing, you cannot create projects.

  • SharePoint Products and Technologies content database name is incorrect.

    To resolve this issue, use the SharePoint Central Administration site to remove and re-add the content database. For more information, see The number of SharePoint sites do not match.

  • SharePoint Products and Technologies configuration database name is incorrect.

    Note

    This rule is checked and applies only if Windows SharePoint Services 2.0 is deployed.

    To resolve this issue, uninstall and reinstall SharePoint Products and Technologies.

  • SharePoint Products and Technologies Config Database has no sites.

  • SharePoint Products and Technologies Content Database has no sites.

    Each configuration and content database for SharePoint Products and Technologies, contains a Sites table. These databases include STS_Config_TFS and STS_Content_TFS (for Visual Studio 2005 Team Foundation Server) and WSS_Config and WSS_Content (for Visual Studio Team System 2008 Team Foundation Server). The number of sites in each table must match. When you use the installation wizard for Team Foundation Server to install SharePoint Products and Technologies, the content database contains only the default Web site.

    To resolve this issue, use the SharePoint Central Administration site to remove and re-add the content database. For more information, see The number of SharePoint sites do not match.

Required Permissions

To perform this procedure, you must be a member of the Administrators security group on the application-tier server.

To configure the ISAPI filter in IIS 6.0

  1. Log on to the application-tier server.

  2. Click Start, point to Administrative Tools, and click Internet Information Services (IIS) Manager.

    Internet Information Services (IIS) Manager opens.

  3. In the tree pane, expand the local computer, and expand Web Sites.

  4. Right-click Default Web Site, and click Properties.

  5. On the ISAPI Filters tab, verify that the stsfltr filter is not listed, and then click Add.

    The Add/Edit Filter Properties dialog box opens.

  6. In Filter name, type stsfltr.

  7. Click Browse, and locate the directory that contains the STSFLTR.DLL file.

    By default, this file is located in Drive:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\60\bin.

  8. Click the file, and then click OK twice.

  9. Close Internet Information Services (IIS) Manager.

Required Permissions

To use stsadm.exe, you must be a member of the local Administrators group for the server on which SharePoint Products and Technologies is running.

To verify that the default site templates are missing

  1. Log on to the server on which SharePoint Products and Technologies is running. 

  2. Open a Command Prompt window, and change to the directory that contains the stsadm utility:

    For Windows SharePoint Services 2.0, the default directory is Drive:\Program Files\Common Files\Microsoft Shared\web server extensions\60\bin

    For Windows SharePoint Services 3.0 and Microsoft Office SharePoint Server 2007, the default directory is Drive:\Program Files\Common Files\Microsoft Shared\web server extensions\12\bin

    Note

    Even if you are logged on with administrative credentials, you must open an elevated Command Prompt to perform this function on a server that is running Windows Server 2008. To open an elevated Command Prompt, click Start, right-click Command Prompt, and click Run as administrator. For more information, see the Microsoft Web site.

  3. Type the following command:

    Stsadm.exe –o enumtemplates

    The command returns a list of all site templates that have been uploaded to the database for SharePoint Products and Technologies. 

    If VSTS_MSFAgile or VSTS_MSF_CMMI is not listed, you are missing a default site template. The site template must be present to create a project that is based on the corresponding process template.

To retrieve a missing site template

  1. Log on to the application-tier server for Team Foundation.

  2. Open Windows Explorer, and locate the missing templates in one of the following directories:

    For Visual Studio 2005 Team Foundation Server, the default directory is Drive:\Program Files\Microsoft Visual Studio 2005 Team Foundation Server\Tools\Templates

    For Visual Studio Team System 2008 Team Foundation Server, the default directory is Drive:\Program Files\Microsoft Visual Studio 2008 Team Foundation Server\Tools\Templates

  3. Identify the appropriate file, depending on the version of SharePoint Products and Technologies that you are using, as listed in the following table.

    Template

    File name

    MSF for Agile Software Development

    MsfAgile.stp (for Windows SharePoint Services 2.0)

    MsfAgile30.stp (for Windows SharePoint Services 3.0 and Microsoft Office SharePoint Server 2007)

    MSF for CMMI Process Improvement

    MsfFormal.stp (for Windows SharePoint Services 2.0)

    MsfFormal30.stp (for Windows SharePoint Services 3.0 and Microsoft Office SharePoint Server 2007)

  4. Copy the appropriate file to the same directory that you accessed in step 2 in the previous procedure.

To add the template to the database for Sharepoint Products and Technologies

  1. On the server on which SharePoint Products and Technologies is running, open a Command Prompt window, and change to the directory that contains the stsadm utility:

    For Windows SharePoint Services 2.0, the default directory is Drive:\Program Files\Common Files\Microsoft Shared\web server extensions\60\bin

    For Windows SharePoint Services 3.0 and Microsoft Office SharePoint Server 2007, the default directory is Drive:\Program Files\Common Files\Microsoft Shared\web server extensions\12\bin

    Note

    Even if you are logged on with administrative credentials, you must open an elevated Command Prompt to perform this function on a server that is running Windows Server 2008. To open an elevated Command Prompt, click Start, right-click Command Prompt, and click Run as administrator. For more information, see the Microsoft Web site.

  2. Type the following command, replacing FileName and TitleName for the template file and template title that you want to restore:

    stsadm -o addtemplate -filenameFileName.stp -titleTitleName

    For example, type the following commands:

    stsadm -o addtemplate -filename MsfAgile30.stp -title VSTS_MSFAgile

    - or -

    stsadm -o addtemplate -filename MsfFormal30.stp -title VSTS_MSF_CMMI

    Important noteImportant Note:

    You must specify the correct title for the site template, either VSTS_MSFAgile or VSTS_MSF_CMMI. The process template references the site template by these specific names.

  3. Restart Internet Information Services (IIS) so that the added template is available.

    Type iisreset, and then press ENTER.

See Also

Tasks

The number of SharePoint sites do not match

Other Resources

Issues That Relate to SharePoint Products and Technologies