Install Ranorex silently on different physical machines in a network using command line arguments.
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.
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 /passive
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 /help
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)
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.