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 setting quickly and efficiently.
In this chapter
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
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
- ‘MainFeature’ (Core components)
For more installation options see the help for the
msiexec /help or: setup /v /help or: Ranorex-x.x.x.exe /v /help
Install Ranorex license
To finish your silent installation you have to install a valid license.
If you would like to install a floating license you have to copy the file Ranorex3_Server.
If you would like to install a
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.