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 keeps the scheduled execution model of Breeze Agent 1.x and reports the same kind of data to Cloudaware CMDB, on a modern runtime, with versioned releases, a single command line, and a dedicated configuration file.

Why Upgrade to Breeze Agent 3.x​

  • A modern runtime - Breeze Agent 3.x runs on Ruby 3.3 with OpenSSL 3, a current, actively maintained runtime.
  • Versioned releases - Breeze Agent 3.x is installed as a versioned package, so you always know which release a host runs. Cloudaware rolls out an upgrade by raising the minimum required version, and you can upgrade on demand, or install a specific version, with breeze upgrade.
  • One 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.
  • Windows Server Core and Apple Silicon - Breeze Agent 3.x supports the same Linux distributions and Windows Server versions as 1.x, and adds Windows Server Core and native installers for Apple Silicon (arm64) Macs alongside Intel (x86_64). macOS is not supported for migration from Breeze Agent 1.x. See Compatibility.
  • A dedicated configuration file - the proxy, proxy exclusions, and a custom CA bundle are set in one configuration file, instead of by editing the agent's launcher script as on Breeze Agent 1.x.
note

Some Breeze Agent 1.x capabilities, such as patch management, are still being added to 3.x. Check Feature Availability for the capabilities your hosts use. Hosts that need one that is not available yet can stay on Breeze Agent 1.x, which keeps running as before.

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.

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