114

I want to use mstest.exe to run my unit test on build server, but I don't want to install Visual Studio on the build server. Can I just install MSTest without Visual Studio?

2

8 Answers 8

172

It is possible to run mstest.exe without visual studio.
Download one of the Agents for Visual Studio ISO's below and install the Test Agent on the server:

This installs everything needed for running mstest.exe from the command line and is much lighter weight than visual studio. ~500mb download and around ~300mb to install just the test agent if I remember correctly.

11
  • 1
    Where MsTest.exe is placed after install TestAgent and TestController? Oct 3, 2013 at 10:20
  • 5
    C:\Program Files\Microsoft Visual Studio 11.0\Common7\IDE\MSTest.exe
    – Foole
    Oct 23, 2013 at 0:20
  • 1
    Is there any agent for Visual Studio 2008? Sep 25, 2014 at 13:38
  • 3
    My group ran into an issue after installing the Visual Studio 2012 Test Agents. We think it modified some of the registry values and consequently made a mess of Visual Studio 2010 stuff that was on the same machine. Beware.
    – S. Dixon
    Dec 5, 2014 at 22:32
  • 1
    Link for 2015 is dead. Test agents can now be found via visualstudio.com/downloads/?q=agents
    – Onots
    Jul 27, 2017 at 8:21
20

This answer pertains specifically to Visual Studio 2017, and the answer is yes. Please refer to this answer as to how to locate the MSBuild.exe and/or MSTest.exe executables.

  • If you only need to build your unit test project(s), install the package MSTest.TestFramework into those project(s) and remove the reference to Microsoft.VisualStudio.QualityTools.UnitTestFramework from them. Now all you need is to install the Visual Studio 2017 Build Tools and invoke msbuild.exe to perform the build.
  • If you need to run your tests as well, things become trickier:
    • The simplest solution is to install VS2017 Community Edition (which includes both msbuild and mstest) - but I am unsure of the legality of this, and am not a lawyer, so be careful!
    • A legally safer solution (and far lighter, in terms of disk space) is to install the Visual Studio 2017 Test Agent and then Build Tools for Visual Studio 2017 (exact order is vital1); this will give you MSTest.exe and vstest.console.exe which you can then call out to. Do note that actually figuring out where these executables reside is a pain, because they won't exist in the same directory structure as MSBuild.exe in Build Tools.

Finally, and very importantly: if you do use MSTest.TestFramework and still need to be able to discover and run tests from within the Visual Studio IDE, you'll also need MSTest.TestAdapter installed in your unit test project(s).

1: While VS2017 supports side-by-side installs, it uses a single registry key that only records the most recent install. Hence, if you install Test Agent last, the key will point to its install directory... but Test Agent doesn't include MSBuild.exe, so any code that relies on this registry key to figure out that executable's path, will fail. Why Microsoft couldn't have made the Test Agent an optional part of Build Tools (so that all the EXEs live in the same directory hierarchy) is anyone's guess.

5
  • Installed via Test Agent method but mstest.exe still fails with File extension specified '.webtest' is not a valid test extension. for me. Jul 26, 2017 at 21:44
  • There's now vswhere - see other questions, e.g. "Programmatically finding the VS2017 installation directory" or "MSBuild.exe not found, cmd.exe" which use it.
    – Wai Ha Lee
    May 24, 2018 at 16:13
  • @WaiHaLee vswhere is better than nothing, but you still have to make an assumption as to where MSBuild is located relative to the VS install directory... if (when?) Microsoft decides to relocate any of those executables, that assumption is no longer valid. Why Microsoft can't or won't create a programmatic way to get the path to MSBuild/MSTest/VSTest (as opposed to the VS install dir, which nobody really cares about) remains beyond me.
    – Ian Kemp
    May 24, 2018 at 18:22
  • Yeah, the is it/isn't it there game is annoying. I'm sure they have their reasons, but....
    – Wai Ha Lee
    May 24, 2018 at 19:54
  • @Ian Kemp Per above , I have installed test agent and build tools but I am receiving error No test is available in C:\Users\..\Desktop\MyExeName.exe... . I have opened a question on SO . If you have any clue, I'd appreciate your help. Feb 3, 2020 at 18:33
5

@crocpulsar, you need to install Visual Studio on your build server, but you do NOT need to buy an additional licence.

There are just way too many dependencies to getting build & MSTest to work without VS installed, and it is most definitely not supported.

As long as the person who starts the build has a license, you do not need one for the build server. This has been the case since the dark days of 2005, and as long as there is edition parity then you are OK.

If everyone in your team has Ultimate, then you are free to install it on the build server; but if one of your team member's has Premium, then you should ideally install Premium on the build server. This also enables lots of other bits like Code Coverage, Test Impact Analysis, and Architecture Validation among others.

1
4

I think you probably can, but its definitely not supported.

I've found this blog article written by someone who claims to have MSTest working without Visual Studio installed.

6
  • Any URL with the word Hacking really requires questioning the value of effort if MS decide to change its implementation your environment could be volatile and unexpected things could happen with each Windows update (we keep regular updates, right?).
    – Russell
    Aug 4, 2010 at 5:52
  • In this case, it seems to be unlikely that a windows update will break the hack. But newer version of mstest (for example, within a newer version or service pack of VS) may work differently.
    – Doc Brown
    Aug 4, 2010 at 6:25
  • @Russell - Personally I'd either shell out for an extra VS license, or just use NUnit instead.
    – Justin
    Aug 4, 2010 at 6:34
  • Thanks for all the replies, I will just get an extra VS license.
    – yang-qu
    Aug 5, 2010 at 1:51
  • 1
    As the author of the above Blog Post, I can attest that it does work, and that it is highly unlikely to break. At least for VS2008. I haven't looked at this for VS2010. MSTest being so deeply integrated into VS is a huge weakness of the test kit, but I don't think MS will fix it, since it encourages people to use Team System.
    – foxxtrot
    Aug 28, 2010 at 16:08
2

I just got this working on my servers without installing the Visual Studio 2017 IDE. My requirement was

  • Build projects
  • Build test projects
  • Run tests using VSTest (I believe it is a similar process for MSTest)

I had to do a combination of a few things stated in other answers and then also another one here.

VS2017:

  1. BuildTools - This can be found on the Microsoft downloads page, and then scroll down to "Tools for Visual Studio 2017" -> "Build Tools for Visual Studio 2017"
  2. TestAgent - This can be found on the Microsoft downloads page, and then scroll down to "Tools for Visual Studio 2017" -> "Agents for Visual Studio 2017"
  3. Nuget Package to include the visual studio unit testing dll - This can be found here

Step 3 was to fix the following issue:

"Could not resolve this reference. Could not locate the assembly "Microsoft.VisualStudio.QualityTools.UnitTestFramework""

Which then caused:

"error CS0234: The type or namespace name 'VisualStudio' does not exist in the namespace 'Microsoft' (are you missing an assembly reference?) "

I did not have to add any references to the project. However, the path to the vstest.console.exe is contained in the TestAgent folder (for me it was "C:\Program Files (x86)\Microsoft Visual Studio\2017\TestAgent\Common7\IDE\CommonExtensions\Microsoft\TestWindow")

1

Here are the steps I took to get my build server to run MsTest without installing VS 2012:

  1. Created 'Mstest' directory folder in c:\dev.
  2. Copied 'Mstest.exe' and 'Mstest.exe.config' from C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\IDE to 'Mstest' directory
  3. Copy Microsoft.VisualStudio.QualityTools.UnitTestFramework.dll to 'Mstest' directory
  4. Created 'assemblies' directory in 'Mstest' folder
  5. Extracted all v11 Microsoft.VisualStudio.QualityTools.*.dlls from C:\Windows\assembly to 'Mstest/assemblies' directory
  6. Copy all 'v11' Microsoft.VisualStudio.QualityTools..dlls and Microsoft.VisualStudio.TestTools..dlls from C:\Windows\Microsoft.NET\assembly\GAC_MSIL to 'Mstest/assemblies'
  7. Copy all v11 Microsoft.VisualStudio.QualityTools..dlls and Microsoft.VisualStudio.TestTools..dll from C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\IDE\PrivateAssemblies to 'Mstest/assemblies'
  8. Add 'assemblies' to the 'privatePath' attribute of in 'Mstest.exe.config'
  9. Export 'HKEY_LOCAL_MACHINE/SOFTWARE/Wow6432Node/Microsoft/VisualStudio/11.0/Enterprise/QualityTools and apply it to hudson box.
  10. Copy QTAgent32.exe and QTAgent32.exe.config to 'MsTest' directory from C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\IDE
  11. Add 'assemblies' to the 'privatePath' attribute of in 'QTAgent32.exe.config'
  12. Copy 'msdia110.dll' from 'C:\Program Files (x86)\Microsoft Visual Studio 11.0\Common7\Packages\Debugger' to 'MsTest/assemblies'
  13. Register 'msdia110.dll' with c:/windows/syswow64/regsvr32.exe /i '../mstest/assemblies/msdia110.dll'(This threw an error, but for some reason it still worked. I ran it a couple times and tried different regsvr32.exe versions before I checked, but it's there in the registry)

  14. Add environment variable 'MSTEST_HOME' and set it to 'c:\dev\mstest\' or to your path. I used the environment variable in my build script.

Debugging MsTest execution error:

Add to 'MsTest.exe.config'

<system.diagnostics> 
  <trace autoflush="true" indentsize="4"> 
    <listeners> 
      <add name="EqtListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="C:\MsTest.log" /> 
    </listeners> 
  </trace> 
  <switches> 
    <add name="EqtTraceLevel" value="Verbose" /> 
  </switches> 
</system.diagnostics>
0

If you need to run mstest.exe webtest tool then you can install Visual Studio Enterprise trial and make sure to run it at least once (just start it) under account under which test will be running with nothing additional needs to be done. So if your test run under System account then you need to use something like below

PS C:\agent> psexec -s cmd.exe
C:\Windows\system32>"C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\mstest.exe"
Microsoft (R) Test Execution Command Line Tool Version 15.0.27520.0
Copyright (c) Microsoft Corporation. All rights reserved.

Please specify tests to run, or specify the /publish switch to publish results.
For switch syntax, type "MSTest /help"
0

MSTest was announced for .NET Core users. The announcement has usage example with the dotnet tool. I haven't figured myself how to get the standalone mstest executable.

2
  • Link is broken :-(
    – James
    May 7, 2020 at 3:38
  • 2
    @James Just fixed the link
    – user7610
    May 7, 2020 at 7:45

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.