Lab Management is not configured correctly on Team Foundation Server

The information in this article applies to:

  • Visual Studio Team Foundation Server 2010

  • Visual Studio 2010 Lab Management

  • Windows Server 2003 and Windows Server 2008 

  • Application-tier server

  • Team Foundation Server Complete Health Check

  • Visual Studio Lab Management Health Check

The Best Practices Analyzer tool for Team Foundation Server checks the configuration of Visual Studio Lab Management for each team project collection.

To use Lab Management, you must resolve all errors, which are indicated by the Error icon icon. You do not have to resolve warnings, which are indicated by the Warning icon icon.

In this topic

  • Warning icon Warning Messages

  • Error icon Error Messages

  • Locating Information Logged in the Tree Report Server

Warning Messages

A warning appears if the tool detects one of the following conditions:

  • A problem occurred while performing checks on System Center Virtual Machine Manager (SCVMM)

  • A problem occurred while performing permission checks for System Center Virtual Machine Manager (SCVMM)

  • Cannot access System Center Virtual Machine Manager (SCVMM)

  • Cannot access the server for System Center Virtual Machine Manager (SCVMM)

  • Cannot access VMM

  • Cannot determine if the System Center Virtual Machine Manager Administration Console is installed on the application tier for Team Foundation Server

  • Insufficient permissions to access Windows Management Instrumentation (WMI) on the server for System Center Virtual Machine Manager (SCVMM)

    To correct this condition, the user who is running the scan must be granted administrative permissions on the server for SCVMM.

  • Lab URL is not configured or is not configured correctly on the application tier for Team Foundation Server

    To correct this condition, correct the configuration of the Lab URL for Lab Management. For more information, see the following page on the Microsoft Web site: Configuring Lab Management for the First Time.

  • MAC address range is not configured in Virtual Machine Manager

  • Recommended Windows Remote Management settings are not configured

    For information about how to correct this condition, see "Improve the Reliability of WinRM" in the following page on the Microsoft Web site: Configuring Lab Management for the First Time.

  • Required software patches are not installed for the server for System Center Virtual Machine Manager (SCVMM)

    To correct this condition, install the named updates on the server for SCVMM.

  • Service account for Lab Management is not added to the build service accounts group for the team project collection

    To correct this condition, add the service account for Lab Management to the build service accounts for the named project collection. For more information, see the following page on the Microsoft Web site: How to: Configure the Service Account for the Testing and Workflow Integration.

  • Service account for Lab Management is not configured

    To correct this condition, configure the service account for Lab Management. For more information, see the following page on the Microsoft Web site: Configuring Lab Management for the First Time.

Cannot access VMM

To resolve this warning, you should determine whether the server that is running Virtual Machine Manager (VMM) has been changed or if it has been rejoined to the domain after it was installed. These conditions could occur under the following circumstances:

  • There is a problem with the network, or the domain controller is not online.

  • The server lost trust with the domain and was re-added.

  • A domain controller was installed on the server after VMM was installed.

In either event, the tool cannot connect to the server that is running VMM.

To resolve a problem accessing VMM

  • Log on to the server that is running VMM, and invoke an operation that uses a domain account.

    • If Error 813 appears, the problem is related to the network or the domain controller. Verify that these resources are online and operational.

    • If Error 813 does not appear, you must uninstall and then reinstall VMM. You will lose all VMM data as part of this process.

MAC address range is not configured in Virtual Machine Manager

If this message appears, the tool has detected that the Media Access Control (MAC) address range on the server that is running VMM is set to the default value. Lab Management uses Hyper-V to assign MAC addresses for non-network isolated environments, but network isolated environments are assigned the MAC addresses from VMM. When multiple servers are running VMM on the same network and network isolation is used for lab environments, the same MAC address may be assigned to more than one virtual machine. Therefore, when you connect to a virtual machine by using Lab Environment Viewer, you might connect to another virtual machine.

To correct this issue, open the VMM Administrator Console, connect to the server that is running VMM, and change the MAC address range.

To set the range of static MAC addresses for virtual machines

  1. Open the VMM Administrator Console.

  2. In Administration view, in the navigation pane, click Networking.

  3. In the results pane, click Global Static MAC Address Range.

  4. In the Actions pane, under Settings, click Modify.

  5. In Start range at and End range at, type different values.

  6. Click OK.

    For more information, see the following page on the Microsoft Web site: How to Set the Static MAC Address Range for Virtual Network Devices.

Error Messages

An error message appears if the tool detects one of the following conditions:

  • An incompatible version of System Center Virtual Machine Manager (SCVMM) is detected

    To correct this condition, install SCVMM 2008 R2 on the named server.

  • Invalid DNS suffix is configured for Lab Management

    To correct this condition, register each virtual machine in a network isolated environment with a unique external name and the specified Domain Name System (DNS) suffix. For more information, see the following page on the Microsoft Web site: TFSConfig Lab /DNS Commands.

  • System Center Virtual Machine Manager Admin console is not installed on the application tier of Team Foundation Server

  • System Center Virtual Machine Manager server is not responding

  • System Center Virtual Machine Manager service is not responding

  • The service account for Team Foundation Server does not have appropriate permissions on the System Center Virtual Machine Manager

  • Unsupported operating system or version is installed on the System Center Virtual Machine Manager (SCVMM) server

  • Unsupported version of System Center Virtual Machine Manage (SCVMM) server is installed

    To correct this condition, install SCVMM 2008 R2 on the named server.

  • Unsupported version of System Center Virtual Machine Manager Admin console is installed

  • You cannot configure the service account for Team Foundation Server as Network Service

System Center Virtual Machine Manager Admin console is not installed on the application tier of Team Foundation Server

The Best Practices Analyzer tool for Team Foundation Server checks that the System Center Virtual Machine Manager (VMM) R2 Administrator Console is installed on the application-tier server for Team Foundation. The tool also determines whether an unsupported version of the System Center Virtual Machine Manager Administrator Console is installed. An error message appears if one of the following conditions is found to be true:

  • SCVMM Admin console is not installed on the application tier of Team Foundation Server

  • Unsupported version of System Center Virtual Machine Manager Admin console is installed

To resolve these errors, follow these steps:

To install the VMM Administrator console on the application-tier server for Team Foundation

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

  2. Install Virtual Machine Manager Administrator Console. You can just click Next in all pages except the following pages of the configuration wizard:

    1. On the System Center Virtual Machine Manager 2008 startup page, under Setup, click VMM Administrator Console.

    2. On the Summary of Settings page, click Install.

    3. On the Installation page, click Close.

For more information, see the following pages on the Microsoft Web site:

System Center Virtual Machine Manager server is not responding

To determine why the server that is running VMM and that is configured for Lab Management is not responding

  • Perform one or more of the following actions:

    • Make sure that the server is online and can be accessed.

    • Try to connect to the server from the VMM Administrator Console.

    • Examine the VMM Server event logs for more information.

System Center Virtual Machine Manager service is not responding

You can start and stop the Virtual Machine Manager Service just as you can other Windows services.

To start a service that is stopped

  1. Log on to the server that is running VMM.

  2. Open the Start menu, point to Administrative Tools, and then click Services.

    The Services snap-in opens.

  3. Right-click Virtual Machine Manager Service, and then click Start.

    참고

    If you encounter problems when you start this service, check the VMM Server event logs for more information.

The service account for Team Foundation Server does not have appropriate permissions on the System Center Virtual Machine Manager

To configure Lab Management on the application tier, the service account for Team Foundation Server must be added to the SCVMM Administrators role. This membership is required to establish a communication channel between Team Foundation Server and the server that is running VMM.

For more information, see "Configure Lab Management for Team Foundation Server" in the following page on the Microsoft Web site: Configuring Lab Management for the First Time.

To update the credentials for Lab Management in Team Foundation Server

  1. On the application-tier server that the error message names, click Start, point to All Programs, point to Microsoft Team Foundation Server 2010, and then click Team Foundation Administration Console.

  2. In the administration console, under the Application Tier node, click Lab Management.

  3. Click Configure Lab Management.

  4. Click Test to determine whether Team Foundation Server can communicate with the server that is running VMM.

    If the service account for Team Foundation Server does not have the appropriate permissions on the specified server, a dialog box prompts you for your username and password.

    Specify the credentials of an existing member of the VMM Administrators role. If you specify this username and password, the service account for Team Foundation Server is added to the VMM Administrator Role.

    If Team Foundation Server cannot contact the server that is running VMM, a red X and an error message appears.

Unsupported operating system or version is installed on the System Center Virtual Machine Manager server

To resolve the following two errors, you must install System Center Virtual Machine Manager 2008 R2 for Lab Management on Windows Server 2008 with SP2 or Windows Server 2008 R2. 

  • Unsupported operating system is installed on the System Center Virtual Machine Manager (SCVMM) server

  • Unsupported version of System Center Virtual Machine Manager server is installed

For more information, see the "Install and Configure SCVMM" and "System Requirements" in the following page on the Microsoft Web site: Configuring Lab Management for the First Time:

The following table lists the operating systems and additional software that System Center Virtual Machine Manager supports:

Operating Systems

Additional Software

  • the 64-bit versions of Windows Server 2008 R2: Standard, Enterprise, and Datacenter Editions

  • Windows Server 2008 with Service Pack 2: Standard, Enterprise, and Datacenter Editions

  • the final release of System Center Virtual Machine Manager (VMM) 2008 R2

    Important noteImportant
    Do not use any other version of VMM.

You cannot configure the service account for Team Foundation Server as Network Service

When Team Foundation Server and VMM are installed on the same server, you cannot configure the service account for Team Foundation Server as Network Service.

To correct this condition, change the service account for Team Foundation Server to a domain account. You can use the TFSConfig Accounts command to change the service account. For more information, see the following page on the Microsoft Web site: Accounts Command.

Locating Information Logged in the Tree Report

The tool logs the information that it gathers in the tree report under the Lab Management node for each application-tier server and each project collection.

You can locate the Lab Management node for an application-tier server by expanding Team Foundation Server Complete Health Check, expanding Team Foundation Server, expanding Team Foundation Server Applications Tiers, and then expanding Team Foundation Server AT- named server.

You can locate the Lab Management node for a project collection by expanding Team Foundation Server Complete Health Check, expanding Team Foundation Server, expanding Team Project Collections, and then expanding a named project collection.

See Also

Other Resources

Issues That Relate to Lab Management and Test Controllers