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
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.
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.
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.
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 TcpUdp Components displays the environmentRef parameter as part of the response in metadata. environmentRef is not a part of the response of those endpoints.
Certificate file is not updated automatically under certain conditions
| Issue ID | Status |
|---|---|
| 42425 | Open |
Description
Certificate file is not updated automatically when a config change is pushed to an offline instance after it comes back online.
Certificate updates allow for multiples certs to share the same serial number
| Issue ID | Status |
|---|---|
| 42429 | Open |
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.
Duplicate Certificate and Key published for managed certificates
| Issue ID | Status |
|---|---|
| 42517 | Open |
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.
Cannot remove App Delivery Manager 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.