Upgrading Test Controllers from Visual Studio 2010

If you are using a test controller to manage lab environments, the version of your test controller must match the version of your Team Foundation Server. Test controllers for Visual Studio 2010 are not compatible with Visual Studio Team Foundation Server 2012. If you upgrade your Team Foundation Server to Visual Studio Team Foundation Server 2012, you must upgrade the test controller to a Visual Studio 2012 test controller. If you don’t upgrade, you won’t be able to access your physical environments.

Upgrading Visual Studio 2010 test controllers for lab environments

If you have standard environments or lab environments that are associated with coded UI tests on Team Foundation Server 2010, you have to upgrade your test controller so that the configuration data is not lost. In this scenario, you have two options. You can upgrade the existing test controller, or you can install a Visual Studio 2012 test controller on a new machine and copy your old configuration files to your new test controller. The following procedures describe both options.

Upgrading a Visual Studio 2010 test controller

  1. Important

    Install the Visual Studio 2012 test controller first. Do not uninstall your Visual Studio 2010 test controller before you install the Visual Studio 2012 test controller. If you uninstall you Visual Studio 2010 test controller first, you will lose the lab management configuration settings for your physical environments and coded UI tests.

    Install a Visual Studio 2012 test controller on the machine where your Visual Studio 2010 test controller is installed. For information about installing a test controller, see Setting Up Test Controllers in Lab Environments with Microsoft Test Manager.

  2. At the end of the installation, the Visual Studio 2012 Configuration Tool starts. Configure your new test controller to connect to Visual Studio Team Foundation Server 2012.

    At the end of the configuration, your physical environments will be converted to standard environments on Visual Studio Team Foundation Server 2012.

Copying test controller configuration files to a new machine

  1. Install and configure a Visual Studio 2012 test Controller on a new machine. For details about installing a Visual Studio 2012, see Installing and Configuring Test Agents and Test Controllers.

  2. On the machine where the Visual Studio 2010 test controller is installed, copy the configuration file for the test controller at <drive letter:>\<Program Files>\Microsoft Visual Studio 10.0\Common7\IDE\QTControllerConfig.xml.

  3. On the machine where you installed the Visual Studio 2012 test controller, paste the configuration file for the Visual Studio 2012 test controller to <drive letter:>\<Program Files>\Microsoft Visual Studio 11.0\Common7\IDE\QTController.xml.

  4. Uninstall the Visual Studio 2010 test controller.

  5. On the machine where you installed the Visual Studio 2012 test controller, open an elevated command prompt, and then run the following command: TestControllerConfig.exe upgrade.

See Also

Other Resources

Upgrading Lab Management Components from Visual Studio 2010