Catch up on the latest product updates, best practices, and expert insights from the Checkmk Conference #12 – Watch the livestream recordings now
back to website

Werk #16920: Aerohive HiveManager NG: new ExtremeCloud IQ special agent

Component Checks & agents
Title Aerohive HiveManager NG: new ExtremeCloud IQ special agent
Date Jun 12, 2026
Level Prominent Change
Class New Feature
Compatibility Compatible - no manual interaction needed
Checkmk versions & editions
3.0.0b1
Not yet released 		Checkmk Community, Checkmk Pro, Checkmk Ultimate, Checkmk Cloud, Checkmk Ultimate MT
2.5.0p10
Not yet released 		Checkmk Community, Checkmk Pro, Checkmk Ultimate, Checkmk Cloud, Checkmk Ultimate MT
2.4.0p35
Not yet released 		Checkmk Community, Checkmk Pro, Checkmk Ultimate, Checkmk Cloud, Checkmk Ultimate MT

The special agent for Aerohive HiveManager NG used the legacy Aerohive Developer API (base URL https://[rdc-id].aerohive.com/xapi/, endpoint GET /xapi/v1/monitor/devices).

Extreme Networks announced in field notice FN-2026-526 that the legacy Aerohive Developer API will be permanently shut down on July 12, 2026. After that date all requests to the legacy endpoints fail, so the old special agent stops delivering data.

This werk adds a new special agent "Extreme Networks ExtremeCloud IQ" that talks to the ExtremeCloud IQ API (XAPI) instead:

  • The device list is retrieved from GET /devices (base URL https://api.extremecloudiq.com) instead of the legacy /xapi/v1/monitor/devices endpoint.
  • Authentication uses the ExtremeCloud IQ username and password: the agent obtains a bearer token from POST /login and releases it again with POST /logout. The obsolete ownerId query parameter and the legacy X-AH-API-CLIENT-ID, X-AH-API-CLIENT-SECRET and X-AH-API-CLIENT-REDIRECT-URI headers are no longer sent.

The new agent produces the same section as before, so the discovered services ("Client <hostname>") stay unchanged.

The existing "Aerohive HiveManager NG" special agent and its rules are left untouched, so your configuration stays valid. Because the authentication scheme changed completely, the old rules cannot be migrated automatically: you have to create new "Extreme Networks ExtremeCloud IQ" rules by hand.

  • The URL is prefilled with the ExtremeCloud IQ API endpoint https://api.extremecloudiq.com and normally does not need to be changed.
  • Enter the ExtremeCloud IQ username and password.

cmk-update-config prints a warning if it still finds legacy "Aerohive HiveManager NG" rules, reminding you to migrate them. Once you have recreated your rules with the new special agent, you can delete the obsolete ones.

The legacy "Aerohive HiveManager NG" special agent no longer receives data once the Aerohive Developer API is shut down and is only kept for compatibility. It is planned to be removed in a future release, so please migrate any remaining rules.

To the list of all Werks