Breadcrumbs

Windows Agent Command Line Installation troubleshooting

Overview

When installing the Cloudamize Windows Agent via msiexec, the installer may occasionally fail to launch or may appear to hang without immediate feedback. Because the installation runs as a background process, the final status (Success/Failure) must be verified using the Windows Event Viewer.

⚠️ Important Architecture Restriction: The Cloudamize Windows Agent is designed exclusively for x64 architecture. It does not support AArch64 (ARM64) or ARM32 architectures.

Verification Steps (Using Event Viewer)

If the msiexec command executes without throwing an immediate command-line error, the installation is processing. Typically, an event log entry will appear within 10 minutes.

To check the installation status:

  1. Open the Event Viewer (eventvwr.msc).

  2. Navigate to Windows Logs ➔ Application.

  3. Click Filter Current Log in the right-hand Actions pane.

  4. Set the Event Source to MsiInstaller and click OK.

Possible Outcomes

Outcome

Description

Next Steps

Success

Log contains text:


Product: Cloudamize Windows Agent -- Installation completed successfully.

No further action required. The agent is running.

Failure

Log contains text:

Product: Cloudamize Windows Agent -- Installation failed.

Proceed to the Troubleshooting section below.

Pending

Neither log is present.

The installation is still underway. See the Network and proxy retries section.

Troubleshooting & Known Issues

1. Missing or Inaccessible MSI File

If the msiexec command fails instantly, the MSI file may be missing or blocked by OS permissions.

  • Resolution: Review your file path and ensure local administration accounts have appropriate read/write privileges. For detailed steps, see Incorrect Security Permission.

2. Network & Proxy Retries (Up to 24 Hours)

To withstand significant network outages, the installer will automatically retry failed connections for up to 24 hours. Because of this resilience, success or failure logs might not appear immediately.

  • Symptoms: No MsiInstaller events appear for an extended period.

  • Common Cause: Incorrect proxy username or password configurations.

  • How to Check: Clear your Event Viewer filter and filter by Event Source: Cloudamize Windows Installation. Look for warning messages detailing the connectivity problem.

Resolving Proxy/Network Issues:

  • Option A (Recommended): Allow the 24-hour retry window to expire. Once the formal failure log appears, correct the proxy credentials and re-attempt the installation.

  • Option B (Manual Termination): Manually kill the installation process.

    ❗ Critical: If you choose to manually terminate the installation, you must kill all msiexec processes in the precise order specified in the documentation guide: Manual cancellation of Cloudamize Windows agent installation.

If you cannot resolve the issue using the event logs, please gather the following diagnostic data before contacting support:

  1. Screenshot: Capture a screenshot of any explicit error outputs or relevant Event Viewer logs.

  2. Log File: Collect the log_backup.txt file from the following directory:

    C:\Program Files (x86)\Cloudamize\log_backup.txt

Email both items to helpdesk@cloudamize.com for advanced engineering assistance.


If you have any queries, please get in touch with the helpdesk via our Helpdesk Portal or by email at helpdesk@cloudamize.com.