You can use standard MSI command line arguments (see below for examples) to customize the Ranorex installation, for example, to install the Ranorex Runtime silently on different (virtual) machines.
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.
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:
For more installation options see the help for the MsiExec program by typing ('/v' is needed for the '*.exe' files):
or: setup /v /help
or: Ranorex-x.x.x.exe /v /help
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.lic (for Ranorex3.x installations) or Ranorex2_Server.lic (for Ranorex 2.x installations) into the folder '%ALLUSERSPROFILE%' by using the 'XCOPY' command in a batch file. The file will be created when you first install a License Server license on a Ranorex Client. Just search for that file on a client machine running a floating 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.
Download Test Automation Guide
(PDF file, 20MB)