Troubleshoot Offline Installation

Use this article if you’re installing Ranorex Studio on a machine without internet access, and the installation fails.

This information applies to offline installations using:

• RanorexStudio.exe 
• RanorexStudio.zip (prerequisites.msi, RanorexStudio.msi)

Prerequisites

You must have MSBuild Tools installed on the target machine.

• Ranorex Studio previous versions: MSBuild 16
• Ranorex Studio versions 12.7.1and later: MSBuild 16, 17, or 18

Important: If the machine is offline, the prerequisite step will try to download MSBuild and fail. In that case, install MSBuild manually (or temporarily connect to the internet), then restart the installation.

Symptoms

You may see one of the following:

• Setup stops at the Prerequisites step with an error message.
• prerequisites.msi fails with a generic error.
• You see a prerequisite error, but Ranorex Studio still installs and runs (this can happen when MSBuild is already installed, but the prerequisite tries to install another version).

Cause

Ranorex Studio requires MSBuild Tools. During offline installation, the prerequisite installer may fail because:

• It cannot download MSBuild without internet access, or
• It attempts to install MSBuild 17 even though MSBuild 16 or 18 is already installed and supported (12.7.1+)

Resolution

Do one of the following:

• Install the required MSBuild Tools manually on the machine (recommended for offline environments).
• Temporarily connect the machine to the internet so prerequisites can download MSBuild.

Then restart the Ranorex Studio installation:

• If you use RanorexStudio.exe, rerun RanorexStudio.exe.
• If you use prerequisites.msi, rerun prerequisites.msi then continue with the Ranorex Studio installer.