Known Issues
This document is a summary of the known issues in NGINX Management Suite App Delivery Manager. Fixed issues are removed after 45 days.
We recommend upgrading to the latest version of App Delivery Manager to take advantage of new features, improvements, and bug fixes.
This topic describes an early access feature. These features are provided for you to try before they are generally available. You shouldn't use early access features for production purposes.
Share your thoughts about the documentation by taking this short survey: https://forms.gle/w6eDi53F4UcmDjw68.
4.0.0 August 24, 2023
App Delivery Manager module or its pre-configured roles missing after uploading license
Issue ID | Status |
---|---|
44006 | Open |
Description
The App Delivery Manager module or its pre-configured roles aren’t shown after uploading an App Delivery Manager license.
Workaround
-
In a Kubernetes environment, delete the App Delivery Manager pod (which will result in a new pod starting) to resolve this.
-
In a non-Kubernetes environment, restarting the
nms-adm
service will solve this issue:sudo systemctl restart nms-adm
False validation error when trying to publish an environment
Issue ID | Status |
---|---|
43949 | Open |
Description
Template validation can fail for valid templates when trying to publish an environment.
Workaround
Try publishing the environment again.
YUM package manager deletes old built-in templates during upgrade
Issue ID | Status |
---|---|
43928 | Open |
Description
Since the built-in templates’ files and directories have been renamed from *builtin*
to *f5*
, the yum
package manager deletes the older *builtin*
files and all files in the directories with *builtin*
name pattern.
Workaround
After installing the latest release, access the template directory and manually copy over all the *builtin*
files and directories from the newly created backup
directory to the root of the templates directory.
4.0.0 July 06, 2023
Gateway referencing mix of instance groups with and without WAF goes to Error state
Issue ID | Status |
---|---|
43313 | Open |
Description
When the NGINX WAF use case is enabled, a gateway referencing a mix of instance groups with WAF and without WAF goes into an error state if there is a component with WAF enabled referencing another gateway that has an instance group with WAF as a placement.
Workaround
Do not use gateways that reference instance groups with and without WAF
4.0.0 May 18, 2023
Cannot remove ADM object if deletion results in an error
Issue ID | Status |
---|---|
42520 | Open |
Description
If a system error on the nginx instance prevents a new configuration from being applied, it can result in App Delivery Manager objects going into an error state when deleted. This prevents the object from being removed from an environment. Multiple attempts to delete the object will also fail.
Workaround
To remove the object, the instance groups that the object is referencing (direct if a gateway object; indirectly if a component) must temporarily have the instances removed from the instance group.
Duplicate Certificate and Key published for managed certificates
Issue ID | Status |
---|---|
42517 | Fixed in App Delivery Manager 4.0.0-EA2 |
Description
When deploying a configuration with a certificate and key handled by NGINX Management Suite to a custom file path, it may deploy a duplicate copy of the certificate and key to the default /etc/nginx/ path. When deleting the certificate and key, it will only delete the certificate and key in the custom path, leaving the duplicate copy.
Workaround
Manually delete the certificate and key from the /etc/nginx/ path.
Certificate updates allow for multiples certs to share the same serial number
Issue ID | Status |
---|---|
42429 | Fixed in Instance Manager 2.11.0 |
Description
It is possible to update an existing certificate’s serial number to one already in use. This incorrectly changes the cert (matching the serial number) details to a new name.
Workaround
None
Certificate file is not updated automatically under certain conditions
Issue ID | Status |
---|---|
42425 | Fixed in Instance Manager 2.11.0 |
Description
Certificate file is not updated automatically when a config change is pushed to an offline instance after it comes back online.
Workaround
None
API Documentation is not displaying some description fields for schemas containing references to other objects
Issue ID | Status |
---|---|
42146 | Open |
Description
API Documentation for Sites, Web Components, and TCP/UDP Components displays the environmentRef
parameter as part of the response in metadata. environmentRef
is not a part of the response of those endpoints.
Workaround
None
Config push failure when Agent and NGINX Plus with the metrics module are deployed in a container
Issue ID | Status |
---|---|
41868 | Open |
Description
When the NGINX Agent and NGINX Plus are installed in a container, and the metrics module is also installed on that NGINX Plus instance, any config push to an instance group with that instance will fail.
Workaround
The stream module requires stream block to be in the config so when loading the metrics module use the stream block as well.
System Metrics not available without elevated access rights
Issue ID | Status |
---|---|
40945 | Open |
Description
System metrics, as seen in the Overview page, are not displayed for users with roles without elevated access rights, e.g., a Read-only role with no rights to perform other operations like Create, Update, or Delete.
Workaround
None
Modules that share the same Instance Group can create config conflicts
Issue ID | Status |
---|---|
38638 | Open |
Description
When multiple modules are deployed on the same NGINX Management Suite instance, modules may configure the same server block, and only one config will be applied.
Workaround
Use Role-based Account Control to prevent sharing of instance groups between App Delivery Manager and API Connectivity Manager.