
Troubleshooting the Installation of Team Foundation Server
The following symptoms match the problems that most frequently occur during installation of Team Foundation Server. The symptoms are listed from most frequent to least frequent. These errors appear in the installation wizard for Team Foundation Server. To isolate the cause of the error, open the VSMsiLog file, search for the error number, and analyze the command and parameters that are logged as part of the error. For information about viewing the log files, see Installation Log Files.
Error 32000
When installing Team Foundation Server or upgrading to Visual Studio Team System 2008 Team Foundation Server, the following error appears in the installation wizard:
Error 32000. The Commandline ‘[1]’ returned non-zero value: [2]
This error appears when a failure occurs that the setup process does not explicitly capture. Review the VSMsiLog file to help pinpoint the cause of the error. Search for the text "Return value 3" and review the command and parameters that were logged just prior to this text. To gain more insight into the cause of the failure, open a command prompt and run the same command and parameters.
Problem | Solution |
|---|
A problem that involves SQL Server Reporting Services. | Open Internet Information Services (IIS) Manager, remove the virtual directories and the application pool associated with Reporting Services, and then restart the installation of Team Foundation Server. Click Start, click Administrative Tools, and then click Internet Information Services (IIS) Manager. In the tree pane, expand the local computer, and then click Web Sites. For each Web site except Default Web Site, right-click the Web site and click Stop. In the tree pane, expand Web Sites, and then expand the Default Web Site. Right-click Reports, click Delete, and then click Yes to confirm the deletion. Right-click ReportServer, click Delete, and then click Yes to confirm the deletion. In the tree pane, expand Application Pools. Right-click ReportServer, click Delete, and then click Yes to confirm the deletion. To retry the installation of Team Foundation Server, on the Setup Failed page of the installation wizard, click Retry
|
The ISO image file is bad. This problem almost always involves a trial edition of Team Foundation Server. | Obtain a new ISO image file and retry the installation of Team Foundation Server. Download a new image file from this page on the Microsoft Web site: Visual Studio Team System 2008 Team Foundation Server (90-day Trial). To retry the installation of Team Foundation Server, on the Setup Failed page of the installation wizard, click Retry.
|
You started the installation while logged on with an account that is not a member of the Administrators group on the local computer. | Add the user account to the Administrators group on the local computer, or log on as a user that is already a member of that group. For more information, see Add a User Account to the Local Administrators Group). To retry the installation of Team Foundation Server, on the Setup Failed page of the installation wizard, click Retry.
|
The SQL Server sa account is named something other than sa. | Change the SQL Server system administration account name to sa, retry the installation, and then rename the account back to its former name. Note:A Microsoft recommended best practice is to change the name of the SQL Server system administration account. However, the installation of Team Foundation Server requires that this account be named sa. After installation, the account can be renamed. Open SQL Server Management Studio. For more information, see How to: Correct the Data-tier Name Configuration. Optional. To determine the name of the system administrator account, click New Query, type the following text, and then run the query: use master
select * from sys.server_principals
where principal_id=1
In Object Explorer, expand Security, and then click Logins. In Object Explorer Details, right-click the login for the system administrator account, and then click Rename. Change the account name to sa. Retry the installation of Team Foundation Server. Press the Retry button on the Setup Failed page. Optional. Rename the sa account back to the original name.
For more information, see this document on the Microsoft Web site: SQL Server 2005 Security Best Practices - Operational and Administrative Tasks. |
A non-zero value of -1 and a command-line error that contains "\Microsoft Shared\Web Server Extensions\60\Bin\Stsadm.exe" indicates that a host header has been defined for Default Web Site. | Remove the server binding assigned to Default Web Site, and then retry the installation of Team Foundation Server. Open IIS Manager. Right-click Default Web Site and click Properties. Click Web Site, and then click Advanced. Click the identity of the Web site, and then click Edit. Clear the text from Host Header value, and then click OK. Click OK twice again. To retry the installation of Team Foundation Server, on the Setup Failed page of the installation wizard, click Retry.
|
A non-zero value of -2130246810 in the error message indicates that the Default Web Site is bound to a specific IP address. | Remove the server binding assigned to Default Web Site, and then retry the installation of Team Foundation Server. Open Internet Information Services (IIS) Manager and change the IP address of Default Web Site to All Unassigned. For more information, see How to: Verify or Correct Server Binding Assignments. To retry the installation of Team Foundation Server, on the Setup Failed page of the installation wizard, click Retry.
|
At least one of the report schema files in the database has become corrupted. | |
The return value in the error message is -2130242250 or -1, which indicates an error in the installation of Windows SharePoint Services 2.0. | Uninstall Windows SharePoint Services 2.0. Either reinstall Windows SharePoint Services 2.0 or else install Windows SharePoint Services 3.0. Make sure to install all service packs that are available for the version you choose to install. Make sure that you install Windows SharePoint Services using the Server Farm option. For more inforamtion, see "How to: Install SharePoint Products and Technologies on Windows Server" in the installation guide of Team Foundation. To retry the installation of Team Foundation Server, on the Setup Failed page of the installation wizard, click Retry.
|
Various reasons. | In some cases, the installation of Team Foundation Server continues if, on the Setup Failed page of the installation wizard, you click Retry repeatedly: as many as four times. |
Error 29112
When installing Team Foundation Server, the following error appears in the installation wizard:
Error 29112. Team Foundation Report Server Configuration: Either SQL Reporting Services is not properly configured, or the Reporting Services Web site could not be reached. Use the Reporting Services Configuration tool to confirm that SQL Reporting Services is configured properly and that the Reporting Service Web site can be reached, and then run the installation again. For more information, see the Team Foundation Installation Guide.
Possible causes and solutions for this error are described below:
Problem | Solution |
|---|
SQL Server Reporting Services is not configured properly. | Correct the configuration of Reporting Services and then retry the installation of Team Foundation Server. To verify and correct the configuration for Reporting Services, see the procedures provided below: Verify or Correct the Configuration of SQL Server Reporting Services. To retry the installation of Team Foundation Server, on the Setup Failed page of the installation wizard click Retry.
|
The default application pool in IIS Manager is not running under the Network Service account. | Correct the account configuration of the ReportServer application pool, and then retry the installation of Team Foundation Server. Verify that the ReportServer application pool is running and correct its service account assignment as needed. For more information, see How to: Verify or Correct the IIS Configuration for an Application Pool. To retry the installation of Team Foundation Server, on the Setup Failed page of the installation wizard, click Retry.
|
A return value of - 2147220956 and a notice of invalid namespace in the MSI log file indicates that IIS 5.0 isolation mode may be enabled. | Disable IIS 5.0 isolation mode and retry the installation of Team Foundation Server. Note:By enabling isolation mode in IIS 5.0, you disable application pools that SharePoint Products and Technologies requires to connect to the configuration database. You can install SharePoint Products and Technologies with application pools disabled, but Team Foundation Server does not install correctly. Click Start, click Control Panel, click Administrative Tools, and then click Internet Information Services (IIS) Manager. Right-click the Web Sites folder, and then click Properties. On the Service tab, clear the Run WWW service in IIS 5.0 isolation mode check box. Click OK. To retry the installation of Team Foundation Server, on the Setup Failed page of the installation wizard, click Retry.
|
Error 29109
When installing Team Foundation Server, the following error appears in the installation wizard:
Error 29109. Team Foundation Report Server Configuration: SQL Reporting Services configuration encountered an unknown error. Verify that you have sufficient permissions to configure SQL Reporting Services, and try again.
Possible causes and solutions for this error are described below:
Problem | Solution |
|---|
The virtual directories for SQL Server Reporting Services are not in the correct location. The most common cause of this problem is that you install SharePoint Products and Technologies after you install Reporting Services. | Correct the configuration of Reporting Services and then retry the installation. On the server that is running Reporting Services, click Start, point to All Programs, point to Microsoft SQL Server, point to Configuration Tools If the server runs Windows Server 2003, click Reporting Services Configuration. If the server runs Windows Server 2008 , click Reporting Services Configuration Manager. In the Report Server Installation Instance Selection dialog box, ensure that the name of the current data-tier server appears, that the instance name is MSSQLSERVER, and then click Connect. Note:If you used a named instance for Team Foundation Server, you must specify the instance name instead of MSSQLSERVER. In the Explorer pane, click Report Server Virtual Directory. Ensure that the value of Name is ReportServer and the value of Website is Default Web Site. To retry the installation of Team Foundation Server, on the Setup Failed page of the installation wizard, click Retry.
|
The server that hosts Reporting Services is not running. | Restart the server that hosts SQL Server Reporting Services. To retry the installation of Team Foundation Server, on the Setup Failed page of the installation wizard, click Retry.
|
Error 28806
When installing Team Foundation Server, the following error appears in the installation wizard:
Error 28806. An unexpected error occurred. Verify that SQL Server Reporting Services is installed and running on the Team Foundation app tier and that you have sufficient privileges to access it. For more information, see the setup log.
The possible cause and solution for this error are described below:
Problem | Solution |
|---|
SQL Server Reporting Services is not running as the TFSService account. | Configure Reporting Services to use the TFSService account, and then retry the installation. Open the Reporting Services Configuration Manager. For instructions, see the procedures provided below: Verify or Correct the Configuration of SQL Server Reporting Services. In the Explorer pane, click Database Setup. In Credentials Type, click Windows Login. In Account Name and Password, type the username and password of the TFSService account. To retry the installation of Team Foundation Server, on the Setup Failed page of the installation wizard, click Retry.
|
Error 29000
When installing Team Foundation Server, the following error appears in the installation wizard:
Error 29000. An unexpected error occurred. Verify that SQL Server Reporting Services is installed and running on the Team Foundation app tier and that you have sufficient privileges to access it. For more information, see the setup log.
The possible causes and solutions for this error are described below:
Problem | Solution |
|---|
The server that hosts SQL Server Analysis Services is not running or the service account for Reporting Services has insufficient permissions. | Restart the server or add permissions to the service account for Reporting Services, and then retry the installation. If the server that hosts Analysis Services is not running, restart it. Grant the required permissions to the setup account on the server that hosts Analysis Services. The simplest way to grant the permissions is to add the setup account to the local administration group on the server that hosts Analysis Services. For detailed instructions, see Add a User Account to the Local Administrators Group. To retry the installation of Team Foundation Server, on the Setup Failed page of the installation wizard, click Retry.
|
SQL Server FullText Search is either not installed or is not running. | Open Services Manager and start SQL Server FullText Search. If Full Text Search is not installed, install it. Then retry the installation. Click Start, click Administrative Tools, and then click Services. Services Manager opens. If SQL Server FullText Search appears but the status is not Started, right-click the service and then click Restart. If SQL Server FullText Search is not listed, open Add or Remove Programs from the Control Panel, click Microsoft SQL Server 2005 or Microsoft SQL Server 2008, and then click Change. In the SQL Server Maintenance dialog box, click To install a new component, click here. In the Installation Media dialog box, browse to the location of the setup.exe file for your version of SQL Server. When the setup wizard launches, select FullText Search to add the missing service. To retry the installation of Team Foundation Server, on the Setup Failed page of the installation wizard, click Retry.
|
Error 28805
When installing Team Foundation Server, the following error may appear in the installation wizard:
Error 28805. The setup program cannot complete the request to the server that is running SQL Server Reporting Services. Verify that SQL Server Reporting Services is installed and running on the Team Foundation app tier and that you have sufficient permissions to access it. For more information, see the setup log.
The possible causes and solutions for this error are described below:
Problem | Solution |
|---|
The credentials for SQL Server Reporting Services are insufficient to create the Reporting Services data source. | Make sure the credentials for Reporting Services are set to use Network Service and then retry the installation. For more information, see "Update the Identity of the Service Account for Reporting Services" in How to: Redirect Reporting Services to Connect to a Different Data-Tier Server. To retry the installation of Team Foundation Server, on the Setup Failed page of the installation wizard, click Retry.
|
Certificates are installed on a Web site, and those certificates are not ignored. | Change the certificate settings for Reporting Services and then retry the installation. To ignore certificates, change SecureConnectionLevel to 0. For detailed instructions, see this page on the Microsoft Web site: RSReportServer Configuration File. To retry the installation of Team Foundation Server, on the Setup Failed page of the installation wizard, click Retry.
|
Error Message About SQL Server Collation
When installing Team Foundation Server, the following error may appear during the health check:
There is an error with the collation settings for SQL Server. The collation settings are not compatible with Team Foundation Server.
Team Foundation Server requires that collation is case insensitive and accent sensitive. If you want to use an installation of SQL Server with Team Foundation Server, the collation settings of SQL Server must meet these requirements. You cannot change the collation settings after you install SQL Server. For more information, see this page on the Microsoft Web site: Collation Settings in Setup.