Skip to content

Commit c6de282

Browse files
committed
docs: add 2.20 KIs
1 parent 494c076 commit c6de282

File tree

1 file changed

+77
-83
lines changed

1 file changed

+77
-83
lines changed

content/nim/releases/known-issues.md

Lines changed: 77 additions & 83 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,79 @@ This document lists and describes the known issues and possible workarounds in F
1313

1414
---
1515

16+
## 2.20.0
17+
18+
June 16, 2025
19+
20+
### {{% icon-bug %}} Failing to fetch CVE data when using forward proxy in K8s environments {#46177}
21+
22+
{{<bootstrap-table "table table-striped table-bordered">}}
23+
| Issue ID | Status |
24+
|----------------|--------|
25+
| 46177 | Open |
26+
{{</bootstrap-table>}}
27+
28+
#### Description
29+
30+
Fetching latest CVE data from internet might fail if you enable "ssl_verify" in Kubernetes environments.
31+
32+
33+
#### Workaround
34+
35+
1. Switch to the offline CVE database. To switch add the property "offline_nginx_cve: true" under the DPM section in the "nms.conf" file.
36+
37+
```cfg
38+
dpm:
39+
offline_nginx_cve: true
40+
```
41+
42+
2. Download the latest security advisories file from the [nginx.org repository]( https://raw.githubusercontent.com/nginx/nginx.org/main/xml/en/security_advisories.xml) and save them with "cve.xml" as filename in "/usr/share/nms/cve.xml”
43+
3. Restart the `nms` service.
44+
45+
After the restart you will see the line “loading CVE data from file” in the "nms.log" file.
46+
47+
---
48+
49+
### {{% icon-bug %}} New warning message when no usage data or report is available {#46022}
50+
51+
{{<bootstrap-table "table table-striped table-bordered">}}
52+
| Issue ID | Status |
53+
|----------------|--------|
54+
| 46022 | Won't be resolved |
55+
{{</bootstrap-table>}}
56+
57+
#### Description
58+
59+
Users now see a warning message when they click the **Send Usage To F5** button if no new usage data or report is available. The message reads:
60+
61+
> "Usage data is not available at the moment. Please try submitting usage details again later."
62+
63+
---
64+
65+
66+
## 2.19.1
67+
68+
March 27, 2025
69+
70+
### {{% icon-resolved %}} The certificate stats are not displayed correctly in the Certificates and Keys page as well as the Dashboard page. {#45991}
71+
72+
{{<bootstrap-table "table table-striped table-bordered">}}
73+
| Issue ID | Status |
74+
|----------------|--------|
75+
| 45991 | Fixed in Instance Manager 2.20.0 |
76+
{{</bootstrap-table>}}
77+
78+
#### Description
79+
80+
When the dashboard page and certificates page are loaded, the count displayed for total, valid, expired, expires soon, managed and unmanaged are incorrect.
81+
82+
#### Workaround
83+
84+
The changes required have been made and the UI displays the values correctly now. Pagination also works well along with the certificate stats.
85+
86+
---
87+
88+
1689
## 2.19.0
1790

1891
February 06, 2025
@@ -134,71 +207,19 @@ There is an issue that causes previous error messages to persist in the web inte
134207
---
135208

136209

137-
## 2.17.3
138-
139-
September 13, 2024
140-
141-
### {{% icon-resolved %}} The web interface can't display more than 100 certificates {#45565}
142-
143-
{{<bootstrap-table "table table-striped table-bordered">}}
144-
| Issue ID | Status |
145-
|----------------|--------|
146-
| 45565 | Fixed in Instance Manager 2.19.0 |
147-
{{</bootstrap-table>}}
148-
149-
#### Description
150-
151-
The Certificate Management screen can only show up to 100 certificates.
152-
153-
---
154-
155-
156210
## 2.17.0
157211

158212
July 10, 2024
159213

160-
### {{% icon-resolved %}} Mismatch in date formats in custom date selection on NGINX usage graph {#45512}
161-
162-
{{<bootstrap-table "table table-striped table-bordered">}}
163-
| Issue ID | Status |
164-
|----------------|--------|
165-
| 45512 | Fixed in Instance Manager 2.18.0 |
166-
{{</bootstrap-table>}}
167-
168-
#### Description
169-
170-
The months in the custom date range were not displayed correctly because NGINX Instance Manager assumed the data format was in the US timezone.
171-
172-
---
173-
174-
### {{% icon-resolved %}} NGINX Agent 2.36.0 fails to validate certain NGINX configurations in NGINX Instance Manager 2.17.0 {#45153}
175-
176-
{{<bootstrap-table "table table-striped table-bordered">}}
177-
| Issue ID | Status |
178-
|----------------|--------|
179-
| 45153 | Fixed in nginxagent-2.36.0 |
180-
{{</bootstrap-table>}}
181-
182-
#### Description
183-
184-
In NGINX Instance Manager 2.17.0, an "invalid number of arguments" error appears in the web interface when using specific configuration parameters in NGINX Agent 2.36.0.
185-
186-
#### Workaround
187-
188-
Install NGINX Agent **2.35.1** if you're using NGINX Instance Manager 2.17.0. This version is included with NGINX Instance Manager 2.17.0 by default.
189-
190-
If you're installing NGINX Agent from package files, follow the steps in the [Installing NGINX Agent](https://github.com/nginx/agent?tab=readme-ov-file#installing-nginx-agent-from-package-files) guide.
191-
192-
---
193-
194214
### {{% icon-bug %}} Web Analytics are not enabled after upgrading Instance Manager when keeping existing nms-http.conf {#45131}
195215

196216
{{<bootstrap-table "table table-striped table-bordered">}}
217+
197218
| Issue ID | Status |
198219
|----------------|--------|
199220
| 45131 | Open |
200-
{{</bootstrap-table>}}
201221

222+
{{</bootstrap-table>}}
202223
#### Description
203224

204225
When using NGINX Instance Manager, you configure OIDC by manually editing the /etc/nginx/conf.d/nms-http.conf and /etc/nms/nms.conf files.
@@ -218,11 +239,12 @@ add_header Content-Security-Policy "default-src 'none'; block-all-mixed-content;
218239
### {{% icon-bug %}} Failure to retrieve instance configuration when NAP-enabled instance doesn't register properly {#45113}
219240

220241
{{<bootstrap-table "table table-striped table-bordered">}}
242+
221243
| Issue ID | Status |
222244
|----------------|--------|
223245
| 45113 | Open |
224-
{{</bootstrap-table>}}
225246

247+
{{</bootstrap-table>}}
226248
#### Description
227249

228250
If NGINX Agent is configured to monitor NGINX App Protect before App Protect is installed, NGINX Agent will send an empty App Protect metadata structure to NGINX Instance Manager. This causes Instance Manager to fail to register the NGINX instance properly.
@@ -233,34 +255,6 @@ Edit the "/etc/nginx-agent/nginx-agent.conf" file and configure "precompiled_pub
233255

234256
---
235257

236-
### {{% icon-resolved %}} Failure to notify user when template configuration publish fails {#44975}
237-
238-
{{<bootstrap-table "table table-striped table-bordered">}}
239-
| Issue ID | Status |
240-
|----------------|--------|
241-
| 44975 | Fixed in Instance Manager 2.18.0 |
242-
{{</bootstrap-table>}}
243-
244-
#### Description
245-
246-
When publishing a configuration template fails, the system only displays "Accepted" without providing the final result, such as "Success" or "Failure."
247-
248-
---
249-
250-
### {{% icon-resolved %}} Editing template submissions now allows for using most recent template version {#44971}
251-
252-
{{<bootstrap-table "table table-striped table-bordered">}}
253-
| Issue ID | Status |
254-
|----------------|--------|
255-
| 44971 | Fixed in Instance Manager 2.17.0 |
256-
{{</bootstrap-table>}}
257-
258-
#### Description
259-
260-
When editing a template submission, you can now choose between using a snapshot of the template from when it was first deployed or the latest version of the template. **Important:** Note that if you use the latest version, changes to the templates might make an augment template incompatible with a base template, causing the publication to the data plane to fail.
261-
262-
---
263-
264258

265259
## 2.15.0
266260

0 commit comments

Comments
 (0)