From f83ba917b21f1fe6aae1a89e2b2c927814974562 Mon Sep 17 00:00:00 2001 From: Travis Martin Date: Fri, 24 Apr 2026 11:45:14 -0700 Subject: [PATCH 1/3] Added release notes for NIM 2.22.0 --- content/nim/releases/release-notes.md | 51 +++++++++++++++++++++++++++ 1 file changed, 51 insertions(+) diff --git a/content/nim/releases/release-notes.md b/content/nim/releases/release-notes.md index 6fffc58a4..15bf93285 100644 --- a/content/nim/releases/release-notes.md +++ b/content/nim/releases/release-notes.md @@ -15,6 +15,57 @@ The release notes for F5 NGINX Instance Manager highlight the latest features, i {{< /details >}} +## 2.22.0 + +April 27, 2026 + +### Upgrade Paths {#2-22-0-upgrade-paths} + +NGINX Instance Manager 2.22.0 supports upgrades from these previous versions: + +- 2.19.0 - 2.21.1 + +If your NGINX Instance Manager version is older, you may need to upgrade to an intermediate version before upgrading to the target version. + +### What's new {#2-22-0-whats-new} + +This release includes the following updates: + +- {{% icon-feature %}} **New licensing flow sends raw usage data; JWT license no longer required** + + NGINX Instance Manager now sends raw usage data to the new licensing endpoint instead of aggregated data to the legacy endpoint. A JWT license is no longer required, and disconnected environments no longer need to upload usage report acknowledgements. + +- {{% icon-feature %}} **Log profiles section added to the NGINX Instance Manager UI** + + NGINX Instance Manager now includes a Log Profiles section in the UI, where you can view, manage, configure, compile, and download log profiles. The section includes form-based and JSON-based editors, similar to the WAF Policies section. + +- {{% icon-feature %}} **Custom TLS certificates now supported through Vault and external service certificates** + + NGINX Instance Manager now supports custom TLS certificates for its API Gateway and externally provided internal service certificates. The Helm chart supports both the existing default certificate flow and a new external certificates flow for pre-existing per-service secrets. + +### Changes in default behavior{#2-22-0-changes-in-behavior} + +This release has the following changes in default behavior: + +- {{% icon-feature %}} **Saving a modified WAF policy now always creates a new version** + + NGINX Instance Manager now creates a new version each time a modified WAF policy is saved, even if the current version isn't deployed. Previously, a new version was created only for deployed policy versions. + + - The `PUT` endpoint for updating WAF policies is deprecated. + - Submit WAF policy changes through `POST` requests. + +- {{% icon-feature %}} **Usage reporting and the NGINX Usage page have changed in version 2.22** + + The new licensing endpoint is: `https://product.connect.nginx.com/api/nginx-usage/batch` + + - In connected environments that restrict outbound access, add the new licensing endpoint to your allowlist. + - In disconnected mode, use the new bash script to process the larger download file. + - The NGINX Usage page no longer shows hourly aggregated data. It now shows usage reporting details such as instance and cluster IDs and last reported times. + +### Known issues {#2-22-0-known-issues} + +You can find information about known issues in the [Known Issues]({{< ref "/nim/releases/known-issues.md" >}}) topic. + ## 2.21.1 March 2, 2026 From 72445951b11270a9cd43c59bed8b8aa50dfba432 Mon Sep 17 00:00:00 2001 From: Travis Martin Date: Fri, 24 Apr 2026 11:46:24 -0700 Subject: [PATCH 2/3] Changed NIM 2.22.0 GA date to TBD --- content/nim/releases/release-notes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/nim/releases/release-notes.md b/content/nim/releases/release-notes.md index 15bf93285..ff8dbf208 100644 --- a/content/nim/releases/release-notes.md +++ b/content/nim/releases/release-notes.md @@ -17,7 +17,7 @@ The release notes for F5 NGINX Instance Manager highlight the latest features, i ## 2.22.0 -April 27, 2026 +TBD, 2026 ### Upgrade Paths {#2-22-0-upgrade-paths} From d4c1b340eabe3c75e97c725f898440a72138bde0 Mon Sep 17 00:00:00 2001 From: Travis Martin Date: Mon, 27 Apr 2026 12:45:25 -0700 Subject: [PATCH 3/3] added known issues for NIM 2.22.0 --- content/nim/releases/known-issues.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/content/nim/releases/known-issues.md b/content/nim/releases/known-issues.md index f57d5b736..034231e61 100644 --- a/content/nim/releases/known-issues.md +++ b/content/nim/releases/known-issues.md @@ -12,6 +12,34 @@ This document lists and describes the known issues and possible workarounds in F {{< call-out "tip" >}}We recommend you upgrade to the latest version of NGINX Instance Manager to take advantage of new features, improvements, and bug fixes.{{< /call-out >}} +## 2.22.0 + +April 27, 2026 + +### {{% icon-bug %}} Custom users can't access security log profile objects {#47286} + +| Issue ID | Status | +|----------------|--------| +| 47286 | Open | + +#### Description + +Custom users can't perform any actions on the **Security Log Profiles** tab. + +--- + +### {{% icon-bug %}} NATS messages flush slowly after switching to connected mode {#47287} + +| Issue ID | Status | +|----------------|--------| +| 47287 | Open | + +#### Description + +When NGINX Instance Manager switches from disconnected to connected mode, NATS messages flush very slowly, processing one message at a time. + +--- + ## 2.21.0 November 07, 2025