The Ranorex Test Suite Runner is a stand-alone program that executes test suites without Ranorex Studio. It opens automatically when you double-click a test suite file (.rxtst) in Windows.
When to use Test Suite Runner
Use Test Suite Runner when you want to:
- Run tests on a machine that doesn’t need the full Studio UI (for example, a runtime machine).
- Quickly execute a test suite by double-clicking the .rxtst file.
- Let non-authors run tests without editing the solution.
Test Suite Runner capabilities and limitations
You can:
- Execute entire test suites
- Run specific test cases and smart folders
- Run a specific module
- Create and select run configurations (same concept as in Studio)
You can’t:
- Modify the test suite structure or contents (it’s for execution, not authoring)
Run a test suite in Test Suite Runner
- Open
C:\Program Files (x86)\Ranorex\Studio\Bin\Ranorex TestSuite Runner - In the Test Suite Runner, click the open file icon to select the Test Suite you want to open.
- Click RUN.
Note: During execution, don’t use the mouse/keyboard in the AUT unless your test explicitly expects it—manual interaction can cause failures.
Licensing
Running tests via Test Suite Runner uses a Runtime license type (floating), which is intended for running tests via tools like Test Suite Runner, command line, or Agents.
32-bit vs 64-bit
Test Suite Runner is available in 32-bit and 64-bit versions (like Studio and Spy).
Common runtime tip: Excel connectors
If your data-driven test uses Excel connectors, runtime machines (including Test Suite Runner environments) don’t need an Excel license; install Microsoft Access Database Engine (>= 2013) instead.