Citrix Application Delivery Management service

Release Notes for Citrix ADM service February 10, 2022 Release

This release notes document describes the enhancements and changes, fixed and known issues that exist for the Citrix ADM service release Build February 10, 2022.


This release notes document does not include security related fixes. For a list of security related fixes and advisories, see the Citrix security bulletin.

What’s New

The enhancements and changes that are available in Build February 10, 2022.

Management and Monitoring

Support for the ShowConfiguration template

In the Configuration Editor, when you select Batch Configuration, you can now use the ShowConfiguration template. Drag the ShowConfiguration template to the right pane and enter the show commands to run on Citrix ADC instances.

For example, you can enter commands such as sh ns info, sh node, sh ns stats, and sh interface, shell ls /var/tmp and view the output.

You can download the output of the commands as a text file.


Configure an action policy to receive application event notifications

Apart from the existing analytics view of application events, you can configure an action policy to get application event notifications through Slack, Email, PagerDuty, or ServiceNow. The application events include performance issues, bot and WAF violations, and service graph violations. As an administrator, using the action policy, you can get event notifications in real time.

Using the action policy, you can:

  • Predefine certain conditions for the application events.

  • Get notified for the following events through Slack, Email, PagerDuty, and ServiceNow:

    • WAF SQL Violation

    • WAF XSS Violation

    • WAF Infer XML Violation


      To receive the WAF violation notification, the minimum violation transactions must be 20%. For example, out of 100 transactions, minimum 20 must be violation transactions.

    • Top 3 WAF violations

      (Total violations contributed by SQL, XSS, XML together must be 30%. For example, out of 100 transactions, 30 or more transactions must be a combination of SQL, XSS, Infer XML violations.)

    • Bot violations

      (For more information on the list of bot violation, see violation categories.)

    • App score violation

    • Client network latency

    • Server network latency

    • Server processing time

    • Service graph violation

For more information, see Configure an action policy to receive application event notifications.

[NSADM-70968], [NSADM-76588], [NSADM-72799]


Improvements to service graph

In global service graph and microservices service graph, you can now view the legend that provides the description for symbols available in service graph.




Configure settings for low-touch onboarding workflow emails

As a part of ADM Service Connect based low-touch onboarding workflow, you receive product initiated emails from Citrix ADM Service. You can configure and manage the emails that you receive as part of this workflow in the following ways:

  • Enable emails for all admins

  • Enable / disable emails for selected admins

  • Disable emails for all admins

For more information to configure and manage emails, see Email Settings.


View Citrix ADM agent diagnostics and receive alerts for endpoint verification

Citrix ADM now performs a periodic (every one hour) diagnostic check for Citrix ADM agent and provides the following information:

  • Endpoint reachability

  • Health check probe

  • Agent proxy

If the agent endpoint reachability status changes (from OK to Needs Review), the super administrator receives an email notification comprising the issue details.

For more information, see View agent diagnostics and receive alerts for endpoint verification.



Updates of the StyleBook configuration pack are automatically reconciled

Sometimes, updating a StyleBook configuration pack that is deployed on an ADC instance can have differences from its deployed state. In such cases, the configuration pack update fails. The StyleBook engine now automatically reconciles these differences and updates the configuration pack. Earlier, a message appeared on the GUI that needed your confirmation to reconcile the changes before updating the configuration pack.


Manage data sources in ADM

Defining a data source in Citrix ADM helps you to use data from external sources as an input while creating or updating StyleBook configurations. Otherwise, you have to explicitly supply each input required by the StyleBook. In Citrix ADM, you can use any managed ADC instance as a data source for the input to a StyleBook configuration. In Citrix ADM, you can use the managed ADC instances as data sources. You can also define custom data sources which can serve as input when creating or updating configurations. To view custom data sources, go to Applications > Configuration > Data Sources.

Use the datum built-in type in the StyleBook definition to define a data source.


    name: selected-lb
    label: Select an existing ADC
    type: datum
    required: true
      type: managed-adc

In this example, the datum parameter is used to define the managed-adc data source. This data source allows you to retrieve data from the ADC instances managed by Citrix ADM.


Check the StyleBook compatibility for a configuration pack

When you are changing the StyleBook for a configuration pack in the ADM GUI, you can now determine the changes from the newly selected StyleBook definition. And, how these changes affect the configuration pack. With this information, you can make necessary updates to the StyleBook definition before changing it. Or, you can decide to continue with the existing StyleBook.

For example, if you change the StyleBook for a configuration pack, the existing StyleBook can have an allowed port HTTPS whereas the newly selected StyleBook can have SSL. In this case, you may need to edit the same HTTPS values for SSL port as well.


Release Notes for Citrix ADM service February 10, 2022 Release

In this article