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.
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).
Excel data connector prerequisites
If Microsoft Excel is not installed on the machine running Test Suite Runner, install the standalone Microsoft Access Database Engine 2016 Redistributable on that machine before running tests that use Excel data connectors. Ranorex does not support Microsoft Access Runtime alone for Excel data connectors, including Microsoft 365 Access Runtime.
For Excel data loading settings and help with a lost connection when adding an Excel data source, see Run a Data-driven Test.