Skip to main content

Breeze Agent 3.x Overview

Breeze Agent 3.x is the current major generation of Cloudaware's OS-level agent. It retains the scheduled execution model used by Breeze Agent 1.x while modernizing installation, platform support, connectivity, self-update behavior, and day-to-day operations.

Why Upgrade to Breeze Agent 3.x​

Breeze Agent 3.x provides:

  • Modernized installation and self-update behavior for long-lived agent deployments.
  • Support for newer operating systems and processor architectures, such as Amazon Linux 2023 and recent Debian/Ubuntu releases.
  • Improved TLS, proxy, certificate, and cloud instance metadata handling.
  • Expanded command-line tools for troubleshooting, upgrades, and automation.

What's New in 3.x​

Compared with Breeze Agent 1.x, Breeze Agent 3.x introduces the following changes:

  • Versioned upgrades - the agent is installed as a versioned package. It upgrades itself when Cloudaware raises the minimum required version, and you can upgrade it on demand, or install a specific version, with breeze upgrade.
  • Modern runtime - Ruby 3.3 with OpenSSL 3, replacing the end-of-life runtime of Breeze Agent 1.x.
  • Extended platform coverage - expanded support across Linux distributions and Windows Server 2012+, including Windows Server Core.
  • Apple Silicon - native macOS installers for both Intel (x86_64) and Apple Silicon (arm64) Macs. macOS is not supported for migration from Breeze Agent 1.x.
  • Improved cloud integrations - better use of instance metadata and expanded coverage for platforms such as Oracle Cloud.
  • A single command line - one breeze command to run, check, schedule, troubleshoot, and upgrade the agent, in place of the separate scripts of Breeze Agent 1.x.
  • Operational polish - clearer logging, improved error handling, and stronger behavior when using proxies or custom CA bundles.

What Remains the Same​

The core Breeze Agent operating model remains consistent with Breeze Agent 1.x:

  • The agent runs as a scheduled task or service and executes Breeze plugins.
  • Managed hosts initiate outbound TLS connections over TCP port 443.
  • No inbound firewall ports are required for standard agent communication.
  • The agent sends OS-level inventory and telemetry to Cloudaware CMDB.
  • Collected data supports Cloudaware capabilities such as vulnerability management, intrusion detection, and automation. Some Breeze Agent 1.x capabilities, including patch management, are not available on 3.x yet: see Feature Availability.

Explore the Breeze Agent 3.x Documentation​

Use these guides to evaluate Breeze Agent 3.x, install and operate it, migrate from Breeze Agent 1.x, and review version-specific changes.

Check What 3.x Supports​

  1. Review feature availability. Confirm that the capabilities your hosts use are available on Breeze Agent 3.x.
  2. Review compatibility. Verify operating system, architecture, and environment support.

Install and Operate​

  • Installation: install on Linux and Windows, behind a proxy, and verify the result.
  • Configuration: the configuration file and its variables, including proxy, custom CA bundle, and preferred descriptor.
  • Command Line: run, schedule, check, troubleshoot, and upgrade the agent with breeze.
  • Uninstall: stop or remove the agent.

Migrate From Breeze Agent 1.x​

Follow Migration From Breeze Agent 1.x to 3.x to install Breeze Agent 3.x yourself or have Cloudaware migrate your hosts, remove Breeze Agent 1.x, and verify the result.

Track Breeze Agent 3.x Changes​

Review the Breeze Agent 3.x Changelog for version-specific features, fixes, and behavior changes.

For changes shared across agent generations, see the Breeze Agent 1.x Changelog.

On this page