NGINX Documentation

NGINX Controller Releases

NGINX Controller Version 2.3.0

These release notes provide general information and describe known issues for NGINX Controller version 2.3.0, in the following categories:

Updates

Platform

  • Configure dashboard graph sets using one or more tags
  • Support spaces in upstream group name, route alias, system alias

Load Balancer

  • Configuration Templates
    • Ability to preview config file
    • Additional feedback around in-progress config push

API Management

  • Ability to edit environment policies
  • Usability improvements to API Definitions page
    • Entry point hostname color-coding:
      • Grey - config not pushed to the entry point
      • Green - config pushed, all associated instances are online
      • Yellow - config pushed, one or more instances offline & one or more instances online
      • Red - config pushed, all instances offline
    • Number of unrouted resources is displayed for each environment

Known Issues

  • Amazon Linux 2. Docker installation issues: Controller install script cannot handle the setup of docker. Please install docker before running the controller install script.

Supported Versions

  • NGINX Plus R15, R16, R17, R18

NGINX Controller Version 2.2.0

These release notes provide general information and describe known issues for NGINX Controller version 2.2.0, in the following categories:

Updates

Platform

  • Ability to configure the ServiceNow alert integration within Controller

Load Balancer

  • Configuration Templates - ability to name versions
  • Instances are sorted by display name (system alias, or hostname if no alias is set) in the inventory list and dropdown menus
    • Inventory menu in the app header defaults to sorting by display name, with options to change sort parameter

API Management

  • New “card” layout for the API Definition list view

Known Issues

No known major issues in this release

Supported Versions

  • NGINX Plus R15, R16, R17

NGINX Controller Version 2.1.0

These release notes provide general information and describe known issues for NGINX Controller version 2.1.0, in the following categories:

Updates

Platform

  • Ubuntu 18 is qualified for hosting Controller Agents

Load Balancer

  • Configuration Templates can now be deleted

Known Issues

No known major issues in this release

NGINX Controller Version 2.0.0

These release notes provide general information and describe known issues for NGINX Controller version 2.0.0, in the following categories:

Updates

Load Balancer

  • Configuration Templates
    • Config
    • Associated Instances
    • Version History
    • Version Differencing
    • Arbitrary Reverting
  • Multi-push from Load Balancing → Instances
  • Notifications for multi-push status
  • ServiceNow alerting integration
  • Ability to enable error_log and access_log in virtual server
  • Renamed Amplify metrics
  • Rename tab from “Configure” → “Load Balancing”
  • Ability to tag instances from the ‘Load Balancing → Instances’ tab
  • Config-push deferral - ability to change a config and save it without pushing
  • Promote session persistence to its own section (Upstream Group config)
  • Offline installer / updater
  • Various bug-fixes

API Management

  • New API Management tab in Controller primary navigation
  • Create and manage API Definitions
  • Create and manage Upstream Groups
  • Create and manage Entry Points
  • Manage Clients and Client Groups
  • Policies can be applied to various objects in API Management

Known Issues

  • If upgrading from a previous version of Controller, password needs to be updated/reset.
  • Load Balancing - Instances page hangs when there are no hosts registered in Controller.
  • Load Balancing - Orange indicators will appear when you have unsaved changes, and may take several minutes to accurately reflect the correct status.
  • API Management - When configuring multiple rate limit policies for an Environment, each must use the same status code.

NGINX Controller Version 1.0.1

These release notes provide general information and describe known issues for NGINX Controller version 1.0.1, in the following categories:

Updates

  • Alerts - fix issue where editing an alert with threshold could result in an error
  • Analyzer - fix issue where old SSL cert could still be evident in the report alongside the new cert that replaced it
  • Analyzer - show appropriate message when port is missing for the listen directive
  • Configure - provide better error descriptions in the UI
  • Configure - fix issue where error notifications disappeared too quickly before they could be fully read
  • Configure - fix issue where user would see “undefined” error when loading a config that included a stream block
  • Configure - fix issue where virtual server SSL block is inactive after a page reload
  • Configure - fix issue where empty directives were not copied to the generated config file
  • Configure - fix issue where proxy is not allowed in regex location
  • Configure - fix issue where the validation for healthcheck URI does not allow for query params
  • Configure - fix issue of no validation for duplicate upstreams
  • Configure - fix the wrong visualisation of healthcheck config after a push config action fails
  • Configure - fix error about server name being too long in the generated config

Known Issues

No known major issues in this release