Install Ranorex silently on different physical machines in a network using command line arguments.
See also: Admin vs Non-Admin installation for more information about rights and limitations for centrally deployed installs.
Important: If Visual Studio Build Tools (MSBuild) are not installed, setup will download it from Microsoft. On offline machines, install Build Tools first, or the Ranorex installer will fail.
Installation packages
Ranorex uses the Microsoft/Windows Installer (MSI) for its setup. This allows you to use all standard MSI command line arguments with the following:
- The self-extracting ZIP file (Ranorex-x.x.x.exe)
- The setup package (setup.exe and Ranorex-x.x.x.x.msi inside Ranorex-x.x.x.zip file)
System administrators can install Ranorex using the MSI package for installation. Download the Ranorex-x.x.x.zip file, which includes the MSI package, from the Ranorex homepage or from Ranorex Studio Downloads. The download link is the same as for the self-extracting ZIP file Ranorex-x.x.x.exe, just replace exe with zip.
Note: Ensure all prerequisites are installed before running the MSI installer. Refer to the README.txt in the ZIP archive or the Ranorex system requirements. If unsure, use setup.exe or the .exe installer, which automatically installs the prerequisites.
Installation command line arguments
To perform a silent installation, use the following arguments:
Quiet (No UI):
msiexec /i Ranorex-x.x.x.x.msi /quiet
Ranorex-x.x.x.exe /quiet- Passive (Progress bar only):
setup.exe /passiveImportant: Due to legal limitations, silent installation does not work for prerequisites. If they are missing, a message pops up. To ensure a fully silent setup, install prerequisites separately (e.g., via a batch file) before running the Ranorex installer.
Component management
Customize the installation by specifying which features to include using the ADDLOCAL and REMOVE parameters.
Ensure that the Runtime/Manifest components are installed, which are necessary for the Main Feature to work properly:
msiexec /i Ranorex-x.x.x.x.msi /quiet ADDLOCAL="MainFeature,Runtime,Manifest"To install all Ranorex components except for Ranorex Studio:
msiexec /i Ranorex-x.x.x.x.msi ADDLOCAL=”ALL” REMOVE=”RanorexStudioFeature”
Ranorex-x.x.x.exe ADDLOCAL=”ALL” REMOVE=”RanorexStudioFeature”If you include multiple features in the ADDLOCAL and REMOVE parameters, use comma to separate them.
For more installation options see the help for the MsiExec program by typing (/v is needed for the *.exe files):
msiexec /help
setup /v /help
Ranorex-x.x.x.exe /v /helpNote: You need to include /v for the *.exe files.
Available features
| Feature | Feature_Parent | Title | Description |
| MainFeature | Ranorex Main Components | Includes all Ranorex Core Components and the Ranorex tools (Ranorex Recorder and Ranorex Spy). | |
| OmniSharp | OmniSharp | A Roslyn-based code analyzer system. | |
| RanorexCefPlugin | MainFeature | Cef Plug-in | |
| RanorexChromeExtension | Ranorex Chrome Add-on | An Add-on required to enable automation within Google Chrome. | |
| RanorexChromePlugin | MainFeature | Chrome Plug-in | |
| RanorexDelphiPlugin | MainFeature | Delphi Plug-In | |
| RanorexDocumentation | Documentation | Documentation for the Ranorex tools and API documentation. | |
| RanorexDriver | RanorexDriver | Ranorex Driver is a service tool based on a Ranorex test suite solution and is used for the automation of desktop applications.It exposes a W3C WebDriver interface on top of Ranorex runtime. As a result Ranorex Driver works with tests that are written using Selenium framework. | |
| RanorexExeManifestFeature | MainFeature | Ranorex EXE Manifest Files | Install to automate system dialogs and Windows Modern UI Apps. Do not install to enable SAP automation. |
| RanorexFirefoxExtension | Ranorex Firefox Add-on | An Add-on required to enable automation within Mozilla Firefox. | |
| RanorexFirefoxPlugin | MainFeature | Firefox Plug-in | |
| RanorexFlexPlugin | MainFeature | Flash/Flex Plug-in | |
| RanorexIEAddon | Ranorex Internet Explorer Add-on | An optional Add-on for Microsoft Internet Explorer that speeds up interaction with web pages. | |
| RanorexJavaPlugin | MainFeature | Java Plug-in | |
| RanorexMobilePlugin | MainFeature | Mobile Plug-in | |
| RanorexMsaaPlugin | MainFeature | MSAA Plug-in | |
| RanorexOfficePlugin | MainFeature | Office Plug-in | |
| RanorexParallelRunnerFeature | Ranorex ParallelRunner for WebDriver | An optional tool to execute a Ranorex web test on multiple Selenium endpoints at the same time. | |
| RanorexQtPlugin | MainFeature | Qt Plug-in | |
| RanorexRawTextPlugin | MainFeature | RawText Plug-in | |
| RanorexRuntimeFeature | MainFeature | Runtime | Creates a 'Runtime' folder inside 'INSTALLDIR\bin'. The folder contains all assemblies required for test execution. Allows easy deploy of the Ranorex runtime via file copy to arbitary target machines. |
| RanorexSamples | Samples | Quick start samples for Ranorex Studio. | |
| RanorexSapPlugin | MainFeature | SAP Plug-in | |
| RanorexStudioFeature | Ranorex Studio | Ranorex Studio provides an all-on-one environment for developing and managing test projects. | |
| RanorexUiaPlugin | MainFeature | UIA/Silverlight Plug-in | |
| RanorexWebDriverPlugin | MainFeature | WebDriver Plug-in | |
| RanorexWebPlugin | MainFeature | Internet Explorer Plug-in | |
| RanorexWin32Plugin | MainFeature | Win32 Plug-in | |
| RanorexWinFormsCorePlugin | MainFeature | Winforms Core Plug-in | |
| RanorexWinFormsPlugin | MainFeature | Winforms Plug-in | |
| RanorexWpfCorePlugin | MainFeature | WPF Core Plug-in | |
| RanorexWpfPlugin | MainFeature | WPF Plug-in | |
| Shortcuts | RanorexStudioFeature | Desktop shortcut | Create Desktop shortcut for RanorexStudio. |
Licensing
To finish your silent installation you have to install a valid license.
Install node-locked license
To install a node-locked license, generate a license file as follows:
- Authenticate your license key using the web address provided in your licensing email.
- Enter your license key and the machine’s hostname.
- Click Authenticate.
- Download and rename the license file: for example, Ranorex3.lic (for Ranorex 3.x), Ranorex2.lic (for Ranorex 2.x).
- Copy the license file to %ALLUSERSPROFILE% by using the XCOPY command in a batch file.
Install floating license
To install a floating license, follow the required steps based on your needs:
- Server Configuration
- Client Configuration
- Source Machine
Server configuration
- Go to Ranorex License Manager and download the latest version of Ranorex License Manager.
- Execute and install the Ranorex License Manager.
- Register your Ranorex Floating License using Ranorex License Manager tool
- In the Start menu, select Ranorex License Manager Tool
- Copy the License key in the edit field
- Click Install License(s) to activate the license(s)
Note: Open the port with number 7266 for TCP and UDP on your server to prevent the firewall from blocking communication between the license server and the client.
Client configuration
To use floating licenses on the client-server, follow these steps:
- Go to Ranorex License Manager and download the latest version of Ranorex License Manager.
- Execute and install the Ranorex License Manager.
- When the installation is completed, open Ranorex and use the following dialog to silence it.
Source machine
To register the client machine Ranorex uses the XCopy Command:
- Start Command Prompt as administrator
- Use the following command to copy the registered floating license file:
xcopy [source drive]\[folder] \\[destination shared network machine]\[shared drive]\[relevant folder]
For example:
xcopy C:\ProgramData\Ranorex3_Server.lic \\ClientMachine\C\ProgrammData - (From the example) A file is copied to the client ProgramData folder and Ranorex is registered silently on the other side as well without any intervention of the client machine user.
If you are unable to connect to our online License Authentication Server from the machine you installed Ranorex License Manager on, visit our License Authentication website from another computer.
For more information, refer to the Licensing documentation.