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.

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.

To 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 parameters 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

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.

• Server Configuration
• Client Configuration
• Source Machine

Server Configuration

First, configure your server by downloading and installing Ranorex License Manager:

1. Go to Ranorex License Manager 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

   1. In the Start menu, select Ranorex License Manager Tool

   2. Copy the License key in the edit field

   3. 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:

1. Go to Ranorex License Manager 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 silence it.

Source Machine

To register the client machine Ranorex uses the XCopy Command:

1. Start Command Prompt as administrator

2. 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

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 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)