Welcome to the new Ranorex Support Portal

Silent installation

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.

In this chapter

Installation Packages


Ranorex uses the Microsoft/Windows Installer (MSI) for its setup. Consequently, all standard MSI command line arguments can be used. The command line arguments work both with the self-extracting zip file (Ranorex-x.x.x.exe) and the setup.exe and Ranorex-x.x.x.x.msi files contained in the Ranorex-x.x.x.zip file.

System administrators may use the Ranorex MSI package for installation. You can download the Ranorex-x.x.x.zip containing the MSI package from our homepage; the download link is the same as for the self-extracting zip file Ranorex-x.x.x.exe. Just replace the file ending exe with zip.

When installing Ranorex using the MSI package you have to make sure that all Ranorex prerequisites are installed before executing the MSI package (please see the README.txt included in the ZIP archive or the ⇢ Ranorex system requirements). If you are unsure, please use the setup.exe or self-extracting zip file Ranorex-x.x.x.exe to start the installation, which will also install all required prerequisites.

Installation Command Line Arguments


o install Ranorex silently, pass the /quiet (no UI) or /passive (progress bar only) command line argument:

msiexec /i Ranorex-x.x.x.x.msi /quiet
or: setup.exe /passive
or: Ranorex-x.x.x.exe /quiet

The silent installation will not work for any prerequisites (a message will pop-up asking whether you want to install the required components) due to legal limitations. If you want to make sure that all ⇢ required prerequisites are installed silently as well, you need to install them separately, e.g. using a batch file.

If you do not want to install all Ranorex features, you can (de)select these features using the command line options ADDLOCAL and REMOVE.

For example, the following command line will install all Ranorex components except for Ranorex Studio:

msiexec /i Ranorex-x.x.x.x.msi ADDLOCAL=”ALL” REMOVE=”RanorexStudioFeature”
or: Ranorex-x.x.x.exe ADDLOCAL=”ALL” REMOVE=”RanorexStudioFeature”

Possible feature names used as parameter to ADDLOCAL or REMOVE (separated by commas) are:

  • ‘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
or: setup /v /help
or: Ranorex-x.x.x.exe /v /help

Install Node Locked Ranorex 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. The web address used to authenticate the license key is part of the licensing email delivered after purchasing licenses. Simply open a browser, navigate to the authentication page and enter your license key and the machine’s host name into the respective fields. After clicking the Authenticate button you will be able to download the license file. Rename the downloaded file to Ranorex3.lic (for Ranorex3.x installations) or Ranorex2.lic (for Ranorex 2.x installations) and copy it to the folder %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:

  1. Go to RanorexLicenseManager-10.x.x.exe and download Ranorex License Manager v10.x.x

  2. Execute and install Ranorex License Manager v10.x.x

3

Register your Ranorex Floating License using Ranorex License Manager tool

a

In the Start menu, select Ranorex License Manager Tool

b

Copy the License key in the edit field

c

Click Install License(s) to activate the license(s)

Note Icon

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:

  1. Go to RanorexLicenseManager-10.x.x.exe and download Ranorex License Manager v10.x.x

  2. Execute and install Ranorex License Manager v10.x.x

  3. When the installation is completed, open Ranorex and use the following dialog to quite it.

Source Machine

To register the client machine Ranorex use the XCopy Command:

  1. Start Command Prompt as administrator

  2. Use the following command to copy 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

  3. (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 not 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)

USERS LOVE US

SUBSCRIBE TO OUR NEWSLETTER

Get the latest test automation information right in your mailbox.

FOLLOW US

© 2024 Ranorex GmbH. All Rights Reserved