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.


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.