Silent installation is an automated Ranorex method for installing Ranorex on different physical machines in a network. This allows system administrators to set up a Ranorex environment quickly and efficiently.
Installation Packages
Ranorex uses the Microsoft/Windows Installer (MSI) for its setup. Allowing you to use all standard MSI command line arguments. These arguments work with both
- 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. The Ranorex-x.x.x.zip file, which includes the MSI package can be downloaded from the Ranorex homepage. 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 install Ranorex silently, pass the /quiet (no UI) or /passive (progress bar only) command line argument:
Quiet (No UI)
msiexec /i Ranorex-x.x.x.x.msi /quiet
Ranorex-x.x.x.exe /quiet
Passive (with progress bar)
setup.exe /passive
Installing Specific Features
For a complete installation, you must specify the required features and subfeatures in your ADDLOCAL parameter during the silent installation.
Example:
msiexec /i Ranorex-x.x.x.x.msi /quiet ADDLOCAL="MainFeature,Runtime,Manifest"
This ensures that the Runtime/Manifest components are installed, which are necessary for the Main Feature to work properly.
Component Management
If you want to customize installed features, use ADDLOCAL and REMOVE options.
Example: 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”
Use the following feature names used as parameters to ADDLOCAL or REMOVE (separated by commas):
- ‘MainFeature’ (Core components)
- ‘RanorexSamples’
- ‘RanorexStudioFeature’
- ‘RanorexFirefoxExtension’
- ‘RanorexIEAddon’
- ‘RanorexDocumentation’
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
List of 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. |
Install Node Locked Ranorex License
To finish your silent installation you have to install a valid license.To finish your silent installation you have to install a valid license. If you would like to install a node-locked license you have to generate a license file:
- 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:
- Ranorex3.lic (for Ranorex 3.x)
- Ranorex2.lic (for Ranorex 2.x)
Copy it to %ALLUSERSPROFILE% by using the XCOPY command in a batch file.
Install Floating Ranorex License
Follow the required steps to complete your silent installation based on your needs:- Server Configuration
- Client Configuration
- Source Machine
Server Configuration
First, configure your server by downloading and installing Ranorex License Manager:
-
Go to Ranorex License Manager and download Ranorex License Manager v10.x.x
-
Execute and install Ranorex License Manager v10.x.x
-
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 Ranorex License Manager v10.x.x
-
Execute and install Ranorex License Manager v10.x.x
-
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.
When unable to connect to our License Authentication Server online from the machine you installed Ranorex License Manager on or you have no internet connection, please visit our License Authentication website from another computer.
For more information please see the Licensing documentation.
System administrators can also download the following ZIP archive and use the contained MSI package to install Ranorex. Make sure that all Ranorex prerequisites are installed before executing the MSI package (please see the “README.txt” included in the ZIP archive)