Installer Didn't Run

This document helps troubleshoot situations where an installer does not run or fails to start. In most cases, installer issues are related to using the wrong installer for the operating system, distribution type, or system architecture of the device.

Before retrying the installation, it is important to confirm that the installer you downloaded matches the device you are installing it on.

Confirm the Operating System

Installers are created for specific operating systems, such as Windows, macOS, or Linux. An installer designed for one operating system will not run on another.

Verify that the installer you downloaded matches the operating system installed on the device.

Verify Distribution Type and Architecture

On some platforms, especially Linux, installers are further specific to the distribution type and system architecture.

For example, a Linux installer built for one distribution family may not run on another, and an installer compiled for a 64-bit system will not run on a 32-bit system.

If an installer fails to run or exits immediately, this is often a sign that the distribution type or architecture does not match.

If you are unsure how to determine your system’s distribution type or architecture, review the guide available on the Simplified Solutions website that walks through identifying this information on common platforms.

Check File Permissions

Some installers, particularly on macOS and Linux, require execute permissions before they can run.

If double-clicking the installer does nothing or produces a permission error, ensure that the file has permission to execute and that it is being run using the appropriate method for the operating system.

Run as an Administrator

Installers typically need administrative privileges to install system-level components.

On Windows, make sure the installer is run as an administrator. On macOS or Linux, ensure the installation is performed using an account with sufficient privileges.

Download a Fresh Installer

If the installer file was partially downloaded or corrupted, it may fail to run.

Return to the Simplified Solutions portal, generate or download the installer again, and retry the installation using the newly downloaded file.

When to Generate a New Installer

If you determine that the installer does not match the device’s operating system, distribution type, or architecture, generate a new installer that matches the device exactly.

Installers are reusable, but they are specific to platform type. Using the correct installer ensures that the agent can install and operate correctly.

If the Issue Persists

If the installer still does not run after verifying compatibility and permissions, the issue may be related to system restrictions, security controls, or missing dependencies on the device.

At this point, reviewing system logs or contacting support with details about the device’s operating system, version, and architecture can help identify the cause more quickly.