How to: Run a Scan

You can prevent or troubleshoot problems in a deployment of Visual Studio Team Foundation Server by scanning it with the Best Practices Analyzer tool for Team Foundation Server. Before you run a scan, you should consider which computers you should scan and from which computer you will run the scan.

You can run a scan from any computer where you have installed the Best Practices Analyzer tool for Team Foundation Server. As a best practice, you should install the tool and run the scan from the computer whose information you most need to collect because some rules can run only on a local computer. For more information, see Supported Versions and Configurations and Access is not available.

Required Permissions

To perform these procedures, you must be a member of the Administrators security group on the computer from which you run the scan.

To perform a scan

  1. Log on to the computer where the Best Practices Analyzer tool for Team Foundation Server is installed.

  2. Open the Start menu, point to Programs, point to Microsoft Team Foundation Server Admin tools, and then click Best Practices Analyzer.

    The Best Practices Analyzer tool for Team Foundation Server opens.

    Or, in the left pane, click Start a scan.

  3. On the Welcome page, click Select options for a new scan.

  4. In Scan name (optional), type a name for the scan so that you can access the scan in the future.

    Otherwise, you can leave this blank and the tool will automatically label the scan with a date and time stamp.

  5. In the Scan type list, click the type of scan that you want from the following choices:

    Team Foundation Server Complete Health Check

    Scans all components in the deployment and validates their configurations against the rules that are defined for that component.

    Team Foundation Server Framework Health Check

    Scans all application-tier and data-tier servers and validates their configurations against the rules that are defined for Team Foundation Server.

    Team Foundation Server Warehouse Health Check

    Scans the components that host SQL Server Analysis Services and SQL Server Reporting and validates their configurations against the rules that are defined for the data warehouse.

    Team Foundation Build Health Check

    Scans the components that host the Team Foundation Build Service and validates their configurations against the rules that are defined for Team Foundation Build.

    Visual Studio Lab Management Health Check

    Scans the components that are configured under Visual Studio Lab Management and validates their configurations against the rules that are defined for Lab Management.

    SharePoint Products Health Check

    Scans the components that integrate SharePoint Products and Team Foundation Server and validates their configurations against the rules that are defined for SharePoint Products.

    Team Foundation Server Statistics

    Collects and reports usage data for the deployment of Team Foundation Server. 

    For more information, see Rule Checking Performed by the Best Practices Analyzer Tool.

  6. In the Team Foundation Server URL (including port) text box, type the URL for the Web service of Team Foundation Server. The text box is automatically filled in with the http://LocalServerName:8080 name by using information from the registry as soon as that information is available.

    Be sure that you include the port number after the computer name in the form http://ServerName:PortNumber/VirtualDirectoryName. For example, type the following strings, but replace the placeholder text as necessary:

    http://AppTierServerName:8080/VirtualDirectoryName

    or

    https:/AppTierServerName:8080/VirtualDirectoryName

    By default, VirtualDirectoryName is tfs.

  7. Click Start Scanning to start the scan of the system.

  8. On the Scanning Completed page, click View a Report of this Best Practices scan.

    For a description of the reports, see Reports and Messages that the Best Practices Analyzer Tool Generates.

See Also

Tasks

How to: Open the Best Practices Analyzer Tool

How to: List Scans and View Reports

Concepts

Supported Versions and Configurations

Rule Checking Performed by the Best Practices Analyzer Tool

Reports and Messages that the Best Practices Analyzer Tool Generates

Other Resources

Using the Best Practices Analyzer Tool