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
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 parameter to ADDLOCAL or REMOVE (separated by commas) are:
- ‘MainFeature’ (Core components)
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
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.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.