Previous releases

December 10, 2018

This topic is the list of previous releases for Citrix Application Delivery Management (Citrix ADM).

October 27, 2018

This release includes enhancements and bug fixes.

The Citrix Application Delivery Manager (Citrix ADM) agents are, by default, automatically upgraded to Citrix ADM 12.1 build 504.131. You can view the agent details on the Networks > Agents page. You can also specify the time when you want the agent upgrades to happen. For more details, see Configuring Agent Upgrade Settings.

New and enhanced features

Ability to control the number of Syslog messages displayed

By default, Citrix ADM displays 50 Syslog messages in each page. You can now display more messages in one page by choosing 100, 250, 500, or 1,000 messages per page.

Fixed issues

Analytics

If you have read-only permissions, you cannot see diagnostic icons in any analytics view.

[715785]

Applications

Citrix ADM does not display the number of transactions and the data flow volume for GSLB applications on the application dashboard.

[716878]

Citrix ADM doesn’t display any information for virtual servers related to applications created on ADC instances deployed in high availability.

[716906]

Networks

Citrix ADM performance subsystem crashes every few hours and this has an impact on the network reporting.

System

You can now sort the files in Citrix ADM GUI according to the dates instead of sorting it as a string.

[715491]

October 12, 2018

This release includes enhancements and bug fixes.

By default, the Citrix ADM agents are automatically upgraded to Citrix ADM 12.1 build 502.127. You can view the agent details on the Networks > Agents page. You can also specify the time when you want the agent upgrades to happen. For more details, see Configuring Agent Upgrade Settings.

New and enhanced features

Support for EDT sessions in HDX Insight reports

The HDX Insight displays now displays the number of EDT sessions and non-EDT sessions as part of the active sessions report. The Users table displays a detailed report of all the users in the system. Also, a new donut chart has been introduced to allow you to see bandwidth consumed by the user and also the total number of bytes based on the type of protocol used by the users.

Support for displaying both load balancing and content switching virtual servers in Web Insight report

Support for displaying Citrix ADC instances in both high availability and cluster in Web Insight reports

The Citrix ADM analytics reports now display reports for ADC instances that are deployed in both high availability mode and in cluster mode. Both total session launch count and total application count in these two scenarios as a combined report instead of individual reports for each instance in the group.

Note:

All data previously collected before you upgraded to Citrix ADM 12.1 build 503.x continues to be displayed as independent reports for the period of time until the data persists.

Adding Citrix ADC CPX instance in Citrix ADM

Citrix ADM has been enhanced to provide support to the improvements that have been accomplished in CPX functionalities. Citrix ADC CPX instance is now added in Citrix ADM in one of the following two ways:

By providing an IP address for the CPX along with a device profile if the CPX instance is used for managing North-South traffic

By providing the IP address of the Docker host, if the Citrix ADC CPX instance is not reachable by Citrix ADM. That is if the CPX is required to manage the East-West traffic in a data center.

If the device is discovered through a Docker IP, the IP Address in the database is represented as NSIP_DOCKERIP. If the device is discovered through a reachable NSIP of the CPX, the IP address is represented by the NSIP of the CPX in the ADM database.

The process of addition of a CPX instance is now similar to how other ADC types such as VPX or MPX is added in ADM. Providing the device profile allows you to configure the SSH, HTTP, HTTPS port in the device profile rather than explicitly configuring them. Also, the registration of CPX in ADM has been enhanced. When a CPX starts, Citrix ADM automatically discovers and registers the CPX instance.

Support for the autoscaling of Citrix ADC instances deployed in AWS

The Citrix ADM autoscaling feature now supports scaling of Citrix ADC instances in AWS. The Citrix ADM autoscaling feature adds or removes Citrix ADC cluster nodes deployed in AWS depending on when and to what extent the backend servers autoscale. The Citrix ADM collects statistics (CPU usage, memory usage, throughput) from the autoscale provisioned clusters. These statistics are evaluated against the customer-configured value. Depending on whether the statistics exceed the maximum threshold or are operating below the minimum threshold, scale-in or scale-out is triggered respectively.

The advantages of the autoscaling features are:

Ensures that the application is up and running all the time irrespective of traffic demands.

Citrix ADC instances are added and removed dynamically making to a zero-touch manual configuration.

Fixed Issues

Analytics

The Application Summary table in Security Insight > Total Violations reports shows attack time as “NA-“ for all historical records.

[715905]

Networks

Statistics of virtual servers are not displayed if the virtual servers are part of Citrix ADC instances that are deployed in high availability.

[715243]

When you add a GSLB virtual server in Citrix ADM that is part of any custom application, ADM might not display the statistics correctly for the added GSLB server.

[715639]

When you add Citrix ADC SDX platform in ADM, and if the version of the ADC SDX is lesser than 11.0, then the dashboard of SDX visible in Citrix ADM might display errors.

[715803]

System

Sometimes, you might not be able to restart Citrix ADC instances from Citrix ADM. This is because some instances require more than ten minutes to restart and Citrix ADM waits only for ten minutes for the instances to restart. With this fix, you can now configure the Citrix ADM reboot time up to 30 minutes.

[716178]

September 14, 2018

This release includes enhancements and bug fixes.

By default, the Citrix ADM agents are automatically upgraded to Citrix ADM 12.1 build 502.127. You can view the agent details on the Networks > Agents page. You can also specify the time when you want the agent upgrades to happen. For more details, see Configuring Agent Upgrade Settings.

New and enhanced features

Including aggregated attack time in Security Insight reports

The Total Violations report in Security Insight displayed the attack time as “NA” if the selected duration is more than one hour. Now, if you select “1 Day” from the list, the report displays all attacks that are aggregated and the attack time is displayed in one-hour range. If you choose “1 Week” or “1 Month,” all attacks are aggregated and the attack time is displayed in one-day range. For more details, see Security Insight.

[686874]

Fixed Issues

System

In Citrix ADM, when you change user admin profiles, Citrix ADC instances are not rediscovered and you cannot log on to the Citrix ADC instances. the instances are not being updated with the new user details and the instances still use the originally applied admin profiles.

[699435]

Networks

The following two issues are noticed in Citrix ADM related to virtual servers:

When a virtual server is configured with a DNS server that has multiple IP addresses, Citrix ADM cannot discover those virtual servers.

When a virtual server has some non-English characters in the comment or any other field, Citrix ADM returns error and not able to discover virtual servers for that instance.

[713472]

August 23, 2018

This release includes enhancements and bug fixes.

By default, the Citrix ADM agents are automatically upgraded to Citrix ADM 12.1 build 501.123. You can view the agent details on the Networks > Agents page. You can also specify the time when you want the agent upgrades to happen. For more details, see Configuring Agent Upgrade Settings.

New and enhanced features

Renaming of NetScaler Management and Analytics Service

NetScaler Management and Analytics Service is now renamed to Citrix Application Delivery Management (ADM). This is part of the Citrix unified product portfolio.

You might notice new names in our products and product documentation. This is a result of the expansion of the Citrix portfolio and cloud strategy. For more details about the Citrix unified portfolio, see Citrix product guide.
Implementing this transition in our products and their documentation is an ongoing process.

In-product content and documentation might still contain former names. For example, you might see instances of earlier names in console text, messages, directory/file names, screenshots, and diagrams.

It is possible that some items (such as commands) might continue to retain their former names to prevent breaking existing customer scripts.

Related product documentation and other resources (such as videos and blog posts) that are linked from this product’s documentation might still contain former names.

[715090]

Fixed Issues

Networks

Duplicate entries are displayed when you filter all listed entries in network function such as load balancing, content switching, cache redirection, and others.

[704095]

When you navigate to Networks > Instances and select Configure Analytics for a Citrix ADC instance to enable Insight on virtual servers, the Configure Analytics page does not reflect the details of the virtual server if the virtual servers have a “space” in their names.

[713945]

When you configure collectors directly configured on the Citrix ADC instance, the Transport Mode column field in the Configure Analytics page doesn’t display any data.

[713946]

August 03, 2018

This release includes enhancements and bug fixes.

By default, the Citrix ADM agents are automatically upgraded to Citrix ADM 12.1 build 500.126. You can view the agent details on the Networks > Agents page. You can also specify the time when you want the agent upgrades to happen. For more details, see Configuring Agent Upgrade Settings.

What’s New

GitHub import and sync for StyleBooks

You can now use the “Repositories” feature in Citrix ADM to directly import and sync StyleBooks from GitHub repositories. You can sync StyleBooks from multiple GitHub repositories. StyleBooks that are created in GitHub and imported from GitHub repositories are still dependent on Citrix ADM RBAC policies in the same way as StyleBooks imported manually. You can configure a GitHub repository using either GitHub username and password or an API token.

Note:

You can only import and sync StyleBooks that do not have dependent StyleBooks associated with them (that is, the StyleBook must have all configurations defined in that file.)

The Sync from a GitHub repository needs to be initiated manually from the Citrix ADM GUI or API (that is, import of StyleBooks does not happen automatically based on GitHub commit activity.)

You can now automate the configuration of Citrix WAF (Web Application Firewall) feature using the new default WAF StyleBook in Citrix ADM. This StyleBook allows users to create a load balancing virtual server with associated App Firewall policies and settings.

Note:

Before you can configure App Firewall signatures, you must create the signatures objects in the Citrix ADC instance from the appropriate default signatures object template. You cannot configure or modify the default signatures objects through the WAF StyleBook.

Fixed Issues

Networks

While creating configuration jobs using the master config template, you might have to upload the same config file multiple times after editing the file. You can successfully upload the file the first time. Later uploads fail without any user notification.

Workaround: This is happening because of browser default behavior. If you want to upload the same file again after modifications, click Back to go to the Select Instances tab and then click Next and upload the same file again.

[711593]

Citrix ADM is not able to parse all bound service group members

[712022]

Analytics

It is not possible to see information in Web insight when you access Citrix ADM with “read-only” privileges.

[713404]

When you edit a previously created IP block in the Configure IP Blocks page under Analytics > Settings by changing the city, region, and country, and when you try to edit the settings again, the Configure IP Blocks page displayed the name of the previous city. This build fixes this issue.

[712110]

There might be a situation where a table spills over to multiple pages because Citrix ADM displays only 25 row entries in one page. Earlier you were able to sort row entries only on the current page. The other pages never displayed sorted entries. You can now sort the table in any page and all the pages of that table will display the sorted results.

Note: This feature works only if the number of records in a table is less than 25,000.

[689564]

Known Issues

Applications

When you navigate to Networks > Instances and select Configure Analytics for a Citrix ADC instance to enable Insight on virtual servers, the Configure Analytics page does not reflect the correct status of the virtual server if the virtual servers have a “space” in their names. For example, although the AppFlow Logging is enabled on the virtual server, it might be displayed as “disabled” on the Configure Analytics page.

[713945]

When you configure collectors directly on the Citrix ADC instance, the Transport Mode column field in the Configure Analytics page doesn’t display any data.

[713946]

Analytics

On certain occasions, HDX Insight and Citrix Gateway Insight nodes might not be displayed on the Citrix ADM GUI.

Workaround: Refresh the page and try again.

[690327]

Networks

Duplicate entries are displayed when you filter all listed entries in network function such as load balancing, content switching, cache redirection, and others.

[704095]

When you navigate to Networks > Instances and select “Configure Analytics” for a Citrix ADC instance to enable Insight on virtual servers, the Configure Analytics page does not reflect the details of the virtual server if the virtual servers have a “space” in their names.

[713945]

When you configure collectors directly configured on the Citrix ADC instance, the Transport Mode column field in the Configure Analytics page doesn’t display any data.

[713946]

Settings

When you delete the users from Citrix Cloud, the deleted user names continue to appear in Citrix ADM in Settings > User Administration > Users.

[686581]

July 12, 2018

This release includes bug fixes.

By default, the Citrix ADM agents are automatically upgraded to build 516.126. You can view the agent details on the Networks > Agents page. You can also specify the time when you want the agent upgrades to happen. For more details, see Configuring Agent Upgrade Settings.

What’s New

While sending emails for event notifications, you might want to send a test email to test the configured settings. The “Test” button now allows you to send a test email after configuring an email server, associated distributed lists and other settings. This feature ensures that settings are working fine. For more details, see Create event rules.

[684948]

Customization of event notification email subject line

In a large network that has many virtual servers configured, you as an admin might receive a high number of emails every day. But you might want to see the name of the affected entity in the mail popup when the mail is received so that you can determine the affected entity without having to open the email. Under Networks > Event > Rules, when you create a rule and set email notification rules, you now have an option to include some additional information such as the name of the affected entity (failure object.) For more details, see Create event rules.

[705142]

Improvements in pooled capacity feature

A few modifications have been made in the pooled licenses page in Citrix ADM for Citrix VPX instances. A new set of states have been introduced while you allocate licenses in the license pool to Citrix ADC instances on demand. The states are as follows:

Allocated

Grace

Sync in progress

Partially allocated

Device not managed

Allocated. Not applied to the device

Connection lost

Also, a few more details about the state of license allocation have been added to Citrix ADM. For more details, see Pooled capacity.

[709975]

Licensing feature availability in Citrix ADM

Citrix ADM now hosts a common bandwidth and instance pool that servers the Citrix VPX and MPX instances that are added in Citrix ADM. From this common pool, each Citrix ADC instance in your data center, regardless of platform or form factor, checks out one instance license and only as much bandwidth as it needs. For more details, see Pooled capacity.

[709679]

Configurable auto license support for non-addressable virtual servers

Citrix ADM, by default, does not automatically apply licenses to non-addressable virtual servers. For licensing non-addressable virtual servers, you must disable the auto-license option and manually select the non-addressable virtual servers. This increases your effort to manually select the non-addressable servers initially when you apply the licenses, and also when you need to select the new non-addressable virtual servers whenever they are added to your network.

The new option in Citrix ADM under Networks > Licenses > System Licenses is “Auto-select nonaddressable Virtual Servers.” Enabling this option now allows you to explicitly specify that the licensing should include non-addressable virtual servers also.

Note:

Citrix ADM, by default, still does not auto select non-addressable virtual servers for licensing.

Application analytics (App Dashboard) is the only analytics supported currently on licensed non-addressable virtual servers. For more information, see Managing Subscriptions

[707843]

Ability to provision Citrix ADC VPX instances on AWS using Citrix ADM

Citrix ADM now allows you to provision Citrix ADC VPX instances on Amazon Web Services (AWS) platform as a standalone deployment. Citrix ADC VPX on AWS enables you to use AWS Cloud computing capabilities and use Citrix ADC load balancing and traffic management features for their business needs. Citrix ADC on AWS supports all the traffic management features of a physical Citrix ADC appliance. For more details, see Provisioning Citrix ADC VPX Instances on AWS.

[680526]

Fixed Issues

High availability

If you configure one node in a pair of Citrix ADC instances in high availability mode with the IP address in the range 171.31.200.x, this pair of Citrix ADC instances are not discovered by Citrix ADM.

[710589]

Networks

While creating configuration jobs using the master config template, you might have to upload the same config file multiple times after editing the file. You can successfully upload the file the first time. Later uploads fail without any user notification.

Workaround: This is happening because of browser default behavior. If you want to upload the same file again after modifications, click Back to go to the Select Instances tab and then click Next and upload the same file again.

[711593]

The Networks event digest report data is getting truncated due to formatting issues.

[704980]

SNMP v3 based event reporting does not work after upgrading Citrix ADM to version 12.1. Citrix recommends the following workaround for the Citrix ADC instances in version 12.1, 48.13 build added in Citrix ADM.

Workaround: Use SNMP v2 traps until the SNMP v3 issue is fixed and released.

[710564]

When Citrix ADC instances failover when deployed in a high availability mode, the mas_afdecoder process doesn’t receive notification to update the license information. The mas_afdecoder process drops the data packet received from the primary node, and as a result, Web Insight reports do not appear on Citrix ADM GUI.

[711503]

System

Agent registration fails if the name of the city has a Unicode character.

[711737]

When you attempt to activate a new Citrix ADM agent, you might receive an “Invalid instance ID” error message.

[706527]

StyleBooks

Sharepoint Stylebook must support SSL protocol for all backend services.

[706507]

Author field shows null in the API response used to retrieve information about a StyleBook.

[711021]

Known Issues

Analytics

On certain occasions, HDX Insight and Citrix Gateway Insight nodes might not be displayed on the Citrix ADM GUI.

Workaround: Refresh the page and try again.

[690327]

Networks

Duplicate entries are displayed when you filter all listed entries in network function such as load balancing, content switching, cache redirection, and others.

[704095]

Settings

When you delete the users from Citrix Cloud, the deleted user names continue to appear in Citrix ADM in Settings > User Administration > Users.

[686581]

June 14, 2018

This release includes bug fixes.

By default, the Citrix ADM agents are automatically upgraded to build 515.116. You can view the agent details on the Networks > Agents page. You can also specify the time when you want the agent upgrades to happen. For more details, see Configuring Agent Upgrade Settings.

What’s New

Role Based Access Control on GSLB domains

You can now allow only authorized users to perform GSLB configuration using StyleBooks as RBAC is currently supported on GSLB domains also.

Citrix ADM now supports a new entity called “DNS Domain Name.” In Citrix ADM, navigate to Networks > DNS Domain Name and add the DNS domain names entries. Navigate to System > User Administration > Groups. Define RBAC settings for a user group on selected domain names from the available list of domain names.

This RBAC setting applies to your users when they are trying to configure GSLB using StyleBooks. The users can use only one or more DNS Domain Names that they are authorized to use.

[706988]

Improved functionality to search Citrix ADC instances

Consider a scenario where Citrix ADM is managing many Citrix ADC instances. You might want the flexibility to search the inventory of instances based on some search parameters. Citrix ADM now offers two search criteria - tags and properties to search efficiently for a subset of Citrix ADC instances that qualifies the search parameters.

Ability to tag Citrix ADC instances

Tags are terms or keywords that you can assign to a Citrix ADC instance to associate some additional description about the Citrix ADC instance. Citrix ADM now allows you to associate your Citrix ADC instances with tags. These tags allow you to group, identify, and search for the Citrix ADC instances. For more details, see Create tags and assign to instances.

[708603]

Ability to send event notifications to Slack

Earlier, in Citrix ADM GUI you had an option to send email notifications for events. You can now send an event notification to Slack channel also.

Configure the required Slack channel by providing the profile name and the webhook URL in Citrix ADM GUI. The event notifications are then sent to this channel. For more details, see Create event rules.

[656472]

Fixed Issues

Networks

You cannot configure AppFlow on virtual servers if Citrix ADM is configured with any interface other then 0/1.
[705330]

Do not include white spaces in configuration audit template names
[708003]

StyleBooks

You cannot create any entity using StyleBooks when you have defined custom headers in the StyleBook.
[709094]

Settings

Though you can see system notifications about “userlogout,” you might not receive any email notifications.
[704344]

Citrix ADM fails to prevalidate the Citrix ADC instance if the NTP details are added in rc.netscaler file. You can now select those Citrix ADC instances and remove them while upgrading the instances.
[708466]

High availability

When a Citrix ADC instance in high availability mode is assigned to a user group, and if the instance pair fails over, the instance is no longer assigned to the user group.
[709202]

Known Issues

Analytics

On certain occasions, HDX Insight and Citrix Gateway Insight nodes might not be displayed on the Citrix ADM GUI.Workaround: Refresh the page and try again.
[690327]

Networks

Duplicate entries are displayed when you filter all listed entries in network function such as load balancing, content switching, cache redirection, and others.
[704095]

Settings

When you delete the users from Citrix Cloud, the deleted user names continue to appear in Citrix ADM in Settings > User Administration > Users.
[686581]

May 24, 2018

This release includes bug fixes.

By default, the Citrix ADM agents are automatically upgraded to build 514.117. You can view the agent details on the Networks > Agents page. You can also specify the time when you want the agent upgrades to happen. For more details, see Configuring Agent Upgrade Settings.

Fixed Issues

Networks

Consider a scenario where you have RBAC access to only Networks, Analytics, and System nodes. The default behaviour is that the first node in the navigation pane, that is, Networks should be the landing page when you access Citrix ADM. But now the Analytics node is the landing page.
[705347]

When you create a configuration job using Internet Explorer 11.0, Firefox version 31.0, and Google Chrome version 31.0, the following error is displayed:

SCRIPT5017: Syntax error in regular expression rdx.js (61,583910)"

[707767]

A “No Diff” status message is displayed in the Citrix ADC Audit template violations graph when two scheduled audit templates polling the same instance, have one instance with violations.
[708404]

You cannot modify or edit the audit template name.
[708407]

In audit templates, the ‘&’ character in variable values are replaced with the ‘\&amp’ character in the input file.
[708766]

When you set a threshold for instances under Network Reporting, the list of instances includes Citrix ADC SDX instances in addition to Citrix ADC instances.
[707980]

When you add Citrix SD WAN WO instance to Citrix ADM, SNMP connection is not successful, and the GUI becomes unresponsive.
[709146]

Analytics

When you filter a Gateway Insight report based on the user name, Citrix ADM fails to filter user specific details.
[701514]

The mas_afdecoder process occasionally fails when there is a high volume of HTTP transactions.
[706509]

Known Issues

Analytics

On certain occasions, HDX Insight and Citrix Gateway Insight nodes might not be displayed on the Citrix ADM GUI.Workaround: Refresh the page and try again.
[690327]

Networks

Duplicate entries are displayed when you filter all listed entries in network function such as load balancing, content switching, cache redirection, and others.
[704095]

Settings

When you delete the users from Citrix Cloud, the deleted user names continue to appear in Citrix ADM in Settings > User Administration > Users.
[686581]

May 04, 2018

This release includes bug fixes.

By default, the Citrix ADM agents are automatically upgraded to build 513.120. You can view the agent details on the Networks > Agents page. You can also specify the time when you want the agent upgrades to happen. For more details, see Configuring Agent Upgrade Settings.

Networks

When reports are exported in .csv format, the time column displays data in “epoch” format and not in user readable format.
[704828]

The execution summary for a configuration job is displayed as completed on Citrix ADM even when the commands in the configuration job are not fully run on the Citrix ADC instance.
[707317]

Known Issues

Analytics

On certain occasions, HDX Insight and Citrix Gateway Insight nodes might not be displayed on the Citrix ADM GUI.Workaround: Refresh the page and try again.
[690327]

Networks

Duplicate entries are displayed when you filter all listed entries in network function such as load balancing, content switching, cache redirection, and others.
[704095]

Settings

When you delete the users from Citrix Cloud, the deleted user names continue to appear in Citrix ADM in Settings > User Administration > Users.
[686581]

April 12, 2018

This release includes new features and bug fixes.

By default, the Citrix ADM agents are automatically upgraded to build 512.119. You can view the agent details on the Networks > Agents page. You can also specify the time when you want the agent upgrades to happen. For more details, see Configuring Agent Upgrade Settings.

What’s New

Ability to hide default StyleBooks from Citrix ADM

You can now hide all default StyleBooks from the list of available StyleBooks in Citrix ADM. Navigate to Applications > Configurations > Settings. Enable Hide Default StyleBooks check box. All default StyleBooks are now hidden and are not accessible to your users. You can further hide the Settings page itself from the users. Using RBAC feature, you can create a suitable access policy where the Settings page can be made inaccessible to users. Navigate to Account > User Administration > Access Policies. Create a policy and in the Permissions section unselect Settings under All > Applications > Configuration. For more information, see Hide all default StyleBooks.

[686914]

Ability to search for all user-defined StyleBooks in Citrix ADM

Citrix ADM now allows you search for StyleBooks based on their type. That is, you can now search for all custom StyleBooks in the StyleBooks listing page in Citrix ADM. For more information, see Use custom StyleBooks.

[681949]

Fixed Issues

Analytics

If the AppFlow traffic is from a Citrix ADC cluster, then Citrix ADM does not store the data for more than seven days.
[706348]

Networks

When you import a template or use a configuration template to create a job, the variable values are not displayed. Click Done after previewing to view the variable values.
[705884]

Configuration jobs are not completely executed when multiple configuration jobs are running simultaneously with numerous commands and in several instances. The execution of jobs gets stagnated and appear in “in-progress” state.
[706201]

Configuration templates are uploaded to Citrix ADM even if the import of the configuration templates is canceled.
[706219]

In Citrix ADM, when you navigate to Networks > Events> Syslog Messages, the oldest messages are shown first, though the Sort window shows “Newest First” option. Only when you select “Oldest First” and then select “Newest First,” the messages are displayed correctly.
[702305]

If you configure “suppress” event rule for an event in addition to other event rules, Citrix ADM executes all the configured event rules.
[702517]

System

You cannot access the same Citrix ADC instance again after closing it despite using single sign-on credentials.
[699435]

Known Issues

Analytics

On certain occasions, HDX Insight and Citrix Gateway Insight nodes might not be displayed on the Citrix ADM GUI.Workaround: Refresh the page and try again.
[690327]

Settings

When you delete the users from Citrix Cloud, the deleted user names continue to appear in Citrix ADM in Settings > User Administration > Users.
[686581]

March 22, 2018

This release includes new features and bug fixes.

By default, the Citrix ADM agents are automatically upgraded to build 511.118. You can view the agent details on the Networks > Agents page. You can also specify the time when you want the agent upgrades to happen. For more details, see Configuring Agent Upgrade Settings.

What’s New

Introducing help center in Citrix ADM

Citrix ADM now has a help center that allows you to access links for the various tasks that you might be performing. For example, you can learn how to onboard Citrix ADM for the first time. You can also view the latest release notes or learn how to manage your subscriptions.

[706025]

Configuring Citrix ADC instances as ADFS proxy using a StyleBook

You can now configure a Citrix ADC instance to work as a reverse proxy for Active Directory Federation Services (ADFS 2.0) using Stylebooks. The Citrix ADC instance can now extend the single sign-on (SSO) experience for Active Directory-authenticated clients to resources outside the enterprise data center. The instance can now support both active and passive ADFS authentication. For more information, see Microsoft ADFS proxy StyleBook.

[696203]

Instance dashboard improvements

The per-instance dashboard in Citrix ADM displays data polled from a specific instance. By default, every minute, managed instances are polled for data collection. Statistical information such as state, the HTTP requests per second, CPU usage, memory usage, and throughput are continuously collected using NITRO calls. As an administrator, you can view all this collected data on a single page. You can also identify issues in the instance, and take immediate action to rectify them.

The Overview tab which displays CPU, memory usage, and events of a specific instance. You can view other instance-specific dashboards for more detailed information of your instance. The other tabs are – SSL, configuration audit, network functions, and network usage.

[687676]

Network inventory improvements

You can now view the complete list of instances maintained by Citrix ADM. You can view the inventory report by navigating to Networks > Dashboard and click All Instances in the top right corner of your screen. The new inventory report displays the following information:

All instances

Instance versions

Serial numbers

[687676]

Polling progress indicator

You can now view the status of your polling action for instances on Citrix ADM. Previously, when you choose the Poll Now action (for instance certificates, configuration audits, and discovery) the GUI only displayed when polling was initiated. Now, you can see the progress of the polling, when it is in progress and if it is completed, and the information retrieved from the instance during the polling action.

The Citrix Cloud navigation bar is not visible when you log on using Internet Explorer 11.
[702339]

Known Issues

Networks

In Citrix ADM, when you navigate to Networks > Events > Syslog Messages, the oldest messages are shown first, though the Sort window shows “Newest First” option. Only when you select “Oldest First” and then select “Newest First,” the messages are displayed correctly.
[702305]

Analytics

On certain occasions, HDX Insight and Citrix Gateway Insight nodes might not be displayed on the Citrix ADM GUI.Workaround: Refresh the page and try again.
[690327]

Settings

When you delete the users from Citrix Cloud, the deleted user names continue to appear in Citrix ADM in Settings > User Administration > Users.
[686581]

March 3, 2018

This release includes new features and bug fixes.

By default, the Citrix ADM agents are automatically upgraded to build 510.120. You can view the agent details on the Networks > Agents page. You can also specify the time when you want the agent upgrades to happen. For more details, see Configuring Agent Upgrade Settings.

What’s New

Improved network reporting dashboard

You can now create customized dashboards with multiple widgets that display different reporting data. You can view multiple reports for any number of virtual servers and up to ten instances on your customised dashboard. You can also customize the duration of your reports and export them for further analysis. For more information, see Network reporting.

[702016]

Customize report duration

You can now use the slider to customise the duration of reports being generated on the Citrix ADM GUI. Previously, you could only generate and view reports for an hour, a day, a week, or a month. For more information, see Network reporting.

[666018]

New network reports

You can now generate and export performance reports for each interface of the selected Citrix ADC instance. The performance data collected is based on the counters selected and the data transmitted and received by the Citrix ADC instance. For more information, see Network reporting.

[683417]

You can now generate reports for selected Citrix ADC instances for throughput and bandwidth. Using the generated throughput reports, you can monitor network reporting data for each specific instance on the Network Reporting dashboard. For more information, see Network reporting.

You can now use StyleBooks to define the load balancing deployment process for Oracle E-Business Suite 12.2 with Citrix ADC. The configuration of load balancing consists of the definition of load balancing virtual servers and services that are linked to the LB vservers and bound to the individual Oracle E-Business Suite servers. For more information, see Oracle e-business Stylebook.

Citrix ADM now allows you to create custom applications by using either default or custom StyleBooks. StyleBooks simplify the task of managing complex Citrix ADC configurations for your applications. So, when you define custom applications on the application dashboard page, you can now select a StyleBook present in Citrix ADM. Citrix ADM then creates the configuration on the target Citrix ADC instances based on the StyleBook selected. Citrix ADM also creates a custom application made up of all the virtual servers in the configpack.

Note: A custom application and configpack are created if sufficient Citrix ADM licenses are available and if virtual server licensing is not set to manual. For more information, see Create an application definition.

[684460]

Ability to migrate existing config packs to a different StyleBook

Citrix ADM now allows you to migrate (or upgrade) your config pack to a new StyleBook without removing and recreating the config pack. This feature allows you to retain all the configurations on the target instances.

Consider that the parameters of the new StyleBook are a superset of the those in the existing StyleBook. Then, Citrix ADM can migrate your configpack to the new StyleBook without you having to re-enter any parameter values.

Note: This assumes that any new parameters that are part of the new StyleBook are optional.

During migration, Citrix ADM performs a config diff between the existing config and the new config generated by the new StyleBook. Citrix ADM then decides what config objects need to be added, removed, or updated on the target Citrix ADC instances.

Fixed Issues

Analytics

Networks

Citrix ADM does not display the number of backup files in the System Backup Settings page.
[703421]

A prompt warning message displays to the users before submission, when more than allowed virtual servers are selected under Networks > License Settings > System Licenses. [687058]

Known Issues

Networks

In Citrix ADM, when you navigate to Networks > Events > Syslog Messages, the oldest messages are shown first, though the Sort window shows “Newest First” option. Only when you select “Oldest First” and then select “Newest First,” the messages are displayed correctly.
[702305]

Analytics

On certain occasions, HDX Insight and Citrix Gateway Insight nodes might not be displayed on the Citrix ADM GUI.Workaround: Refresh the page and try again.
[690327]

GUI issue

The Citrix Cloud navigation bar is not visible when you log on using Internet Explorer 11.
[702339]

February 9, 2018

This release includes new features and bug fixes.

By default, the Citrix ADM agents are automatically upgraded to build 509.119. You can view the agent details on the Networks > Agents page. You can also specify the time when you want the agent upgrades to happen. For more details, see Configuring Agent Upgrade Settings.

What’s New

Application dashboard improvements

In Citrix ADM GUI, the following changes have been made to improve the usability of the application dashboard:

The 0 app score represents the number of application virtual servers that are down or out of service. This 0 app score is now part of the existing app score legend in application dashboard view.

The app summary panel now displays the text “Showing N/N Apps” instead of the earlier “Total Apps N/N.” Consider an example where you choose 60 in the app score graph. There are 16 applications out of the total 26 applications that have an app score between 40 and 60. The app summary panel displays “Showing 16/26 Apps.” If no criteria is selected, the app summary panel displays “Showing 26/26 Apps.”

The app summary panel now displays a new chart to filter applications based on the applicable categories. A new application category chart is added to the app summary panel. This chart displays a histogram for all categories defined in Citrix ADM. All discrete applications now appear under “Others” category, and custom applications appear under their respective category names. These category names are assigned while defining custom applications.

Ability to select load balancing virtual server state and percentage health as a parameter to filter applications

In virtual server health bar graph, Citrix ADM classifies applications based on the percentage of the virtual server health. The bar graph displays the number of applications that are grouped to have the health value between 0% to 100%.

Virtual server health represents the health of virtual servers that are grouped under discrete applications. But if there are custom applications that comprise two or more virtual servers, the least virtual server health is considered among the group.

You can now apply a filter and see only those applications in the application dashboard that match the selection criteria.

Built-in Citrix ADM agent in a Citrix ADC instance

Citrix ADC instances running release 12.0 build 56.20 and later include a Citrix ADM built-in agent. This agent enables communication between the instance and Citrix ADM. You do not have to install an external agent.

The management, monitoring, and application dashboard features are supported for Citrix ADC instances using built-in agents. The following features are not supported: Web Insight, SSL Insight, HDX Insight, Citrix Gateway Insight, Security Insight, and Advanced Analytics.

To use this built-in agent, you have to upgrade your Citrix ADC instance to release 12.0 build 56.20 and initiate the agent.

Note: Built-in agent is available only on the following Citrix ADC instance types:

Citrix ADC MPX appliance

Citrix ADC VPX appliance

Citrix Gateway

Citrix Secure Web Gateway

For more information and instructions about using the built-in agent, see the following articles:

Support for Web Insight

Citrix ADM now supports Web Insight. The Web Insight feature provides visibility into enterprise web applications. It allows IT administrators to monitor all web applications served by the Citrix ADC by providing integrated and real-time monitoring of applications. For more information, see Web Insight.

Web Insight processes data from Citrix ADC using an approximation algorithm. It provides top 1,000 records of the metrics related to the web applications in your enterprise.

[688206]

Support for SSL insight

Citrix ADM now supports SSL Insight. The SSL insight feature provides visibility into secure transactions on the web (HTTPs). It allows IT administrators to monitor all web applications served by the Citrix ADC by providing integrated, real-time, and historical monitoring of web transactions. For more information, see SSL Insight.

SSL insight processes data from Citrix ADC using an approximation algorithm. It provides top 1,000 records of the metrics related to the web transactions in your enterprise.

Citrix ADM now allows you to add Citrix ADC instances and associate them with sites. While discovering an instance, you can either create a site or select an existing site. Provide the Citrix ADM agent details and always associate the agent with the site.

To add an instance:

Navigate to Networks > Instances.

Select the type of Citrix ADC instance and click Add.

Enter the IP address and select the profile.

Select the site and the agent.

Click the edit icon next to the Agent field.

Select the agent and click Attach Site and select the required site.

Click OK.

The instance is now associated with the site. Navigate to the Networks Dashboard to view the newly added instances under the associated site.

Ability to discover Citrix ADC instances with same private IP address

You can now discover Citrix ADC instances with the same private IP addresses on different networks when instances are registered using built-in agent using Citrix ADM.

[699962]

Fixed Issues

Networks

Incorrect values for DH (Diffie-Hellman) and Ephemeral RSA keys are displayed if an SSL profile carrying different properties is attached to an SSL virtual server. Values are correctly displayed only for SSL virtual server IPs that do not have an SSL profile.
[702680]

Duplicate service or service group entries are displayed for each partition’s service or service group after a Citrix ADC failover. This issue does not occur with services or service groups that belong to the default partition.
[699224]

Known Issues

Analytics

On certain occasions, HDX Insight and Citrix Gateway Insight nodes might not be displayed on the Citrix ADM GUI.Workaround: Refresh the page and try again.
[690327]

GUI issue

The Citrix Cloud navigation bar is not visible when you log on using Internet Explorer 11.
[702339]

January 18, 2018

This release includes new features and bug fixes.

By default, the Citrix ADM agents are automatically upgraded to build 508.116. You can view the agent details on the Networks > Agents page. You can also specify the time when you want the agent upgrades to happen. For more details, see Configuring Agent Upgrade Settings.

What’s New

Import a Certificate from a specific Citrix ADC instance

You can now import a certificate from a specific Citrix ADC instance and apply it to other targeted Citrix ADC instances from the Citrix ADM GUI. With this enhancement, you do not have to download the certificate to your local system and then apply the downloaded certificate to the selected instances. For more information, see How to Install SSL Certificates on a Citrix ADC instance.

[688029]

View Network Reports for Multiple Citrix ADC instances

Citrix ADM allows you to choose multiple Citrix ADC instances (and up to five virtual servers) while generating a network report. You can now monitor network reporting data for multiple instances simultaneously.

You can also export and schedule the report generated from the Network Reporting feature on the Citrix ADM. For more information, see Network Reporting.

[665989]

Upgrade Citrix ADC instance in High Availability Mode

The process of upgrading your Citrix ADC instances in High Availability mode from Citrix ADM has been improved. You can create a maintenance task to upgrade the HA pair in two stages. You can first schedule or perform the upgrade on the initial node, and then schedule the upgrade for the second node later on. The administrator can proceed with the upgrade of the second node only if the upgrade of the first node is successful.

Note:

Currently, the second node of the HA pair is upgraded first, and the upgrade for the first node is scheduled later.

Synchronization and propagation of the nodes are disabled until both the nodes are upgraded successfully.

You see a warning if your nodes in the HA pair are on different builds or versions when the first node is being upgraded. You can cancel the upgrade process for the second node until they are in the same build and version. Or you can schedule it for a later time, after the nodes are in the same build and version.

View Bound Entities for Servers

You can now view the bound entities on your managed Citrix ADC instances for specific server. You can now see the following:

You can now view the bound services and bound service groups for a selected Load Balancing server.

Navigate to Networks > Network Functions > Load Balancing > Servers. Select a server, and click Show Bound Services or Show Bound Service Groups. On the Bound Services page, you can either enable or disable the service and poll the entity. Similarly, on the Bound Service Groups page, you can enable or disable the service group, view the bound service group members and poll the entity.

You can view the bound LB virtual servers for a server on a Content Switching virtual server.

Navigate to Networks > Network Functions > Content Switching. Select a server, and click Show Bound LB Virtual Servers. On the Bound LB Servers page, you can either enable or disable the virtual server and poll it.

You can view the bound target LB virtual servers for a server on a Cache Redirection virtual server.

Navigate to Networks > Network Functions > Cache Redirection. A new Target LB Virtual Server column is displayed on the Cache Redirection Virtual Servers page that lists the name of the target LB virtual server.

[698772]

View Throughput Details for Licensed Virtual Servers

You can manage and allocate licenses to your virtual servers based on the throughput details (which is the sum of the Request Bytes and Response Bytes). This is displayed as a column on the System Licenses page. You can sort through the Throughput column to see which virtual server has less or more throughput usage and allocate licenses accordingly.

To view throughput details:

Navigate to Networks > Licenses > System Licenses.

On the System Licenses page, under Managed Virtual Servers, ensure that the option to Auto-select Virtual Servers is turned OFF. You can now explicitly select the virtual servers that you’d like to manage.

To choose virtual servers, select Click to select.

On the Choose Virtual Servers page, you can now see the Throughput details as a column under each virtual server tab.

[687056]

New Configuration Flow for Setting Up Agents and Adding Citrix ADC instances

Citrix ADM now provides a new intuitive GUI for setting up Citrix ADM agents and also to add Citrix ADC instances to Citrix ADM. For more information, see Getting Started.

[700033]

Python SDK Support for StyleBooks

In Citrix ADM, Python SDK now supports Nitro calls for StyleBooks.

[672420]

View Additional Information about Citrix ADC instances

You can now view information about the following parameters of Citrix ADC instance on Citrix Citrix ADM.

Model ID: Displays the model ID that is derived from the type of license that is applied to a Citrix ADC instance. You can view the model ID on the Instances page and on the Instance Dashboard.

Host ID: Displays the host ID, which is the Mac ID of a Citrix ADC instance. The Host ID is used to generate the license for the instance. You can view the host ID on the Instances page and on the Instance Dashboard.

NetScaler UUID: Universally Unique Identifier (UUID) that identifies unique internet devices or data. An algorithm generates the UUID using values that are based on the network address of the instance. You can view the NetScaler UUID on the Instance Dashboard.

CPU: Displays the current frequency of the CPU. The CPUs operate at different frequencies based on the load capacity. The increase/decrease of MHz is determined by CPU, motherboard architecture, and temperature. You can view the CPU usage details on the Instance Dashboard.

Manufactured on: Displays the manufacturing date of a Citrix ADC instance on the Instance Dashboard.

Note: By default, the Model ID and Host ID of an instance do not display on the Instance page.

To view the new parameters:

Navigate to Networks > Instances, and select the type of Citrix ADC instance for which you want to view the parameter information.

To view the Model ID and Host ID:

On top-right corner, click the Settings icon next to Search.

Select Model ID and Host ID and click Done.
The Model ID and Host ID values are displayed as shown in the following image.

To view Host ID, NetScaler UUID, CPU, and Manufactured Date on the dashboard:

Select the instance and click Dashboard.

In the Information section, you can view the details of Model ID, Host ID, NetScaler UUID, CPU, and Manufactured on as shown in the following image.

Fixed Issues

Analytics

Networks

When device API proxy requests are sent to Citrix ADM, it returns the Content-Length and Transfer-Encoding in the response header which is contrary to RFC 2616. [700717]

Currently, permissions for some dependent resources (ns_lbvserver,ns_csvserver, and so on) are given as part of Network Reporting feature permission. But as part of the new enhancement, these permissions should be given only if users have access to the corresponding node under Network Functions. For example, if users want to run the reporting on Load Balancing virtual servers, they should have access only to the Load Balancing virtual servers under Network Functions and vice versa.
[700859]

Known Issues

Analytics

On certain occasions, HDX Insight and Citrix Gateway Insight nodes might not be displayed on the Citrix ADM GUI.Workaround: Refresh the page and try again.
[690327]

December 28, 2017

This release includes new features and bug fixes.

By default, the Citrix ADM agents are automatically upgraded to build 507.114. You can view the agent details on the Networks > Agents page. You can also specify the time when you want the agent upgrades to happen. For more details, see Configuring Agent Upgrade Settings.

What’s New

Access policy management for role-based access control (RBAC) in Citrix ADM now lets you configure permissions for network functions sub nodes also. Access policy settings can be configured for all sub nodes such as virtual servers, services, service groups, and servers. Currently, you can provide such a granular level access permission only for sub nodes under Load Balancing node and also for sub nodes under GSLB node. For more information, see Configuring Access Policies on Citrix Application Delivery Management.

[692034]

Ability to Export and Schedule Reports for selected Network Functions

You can generate a comprehensive report for selected network functions such as Load Balancing, Content Switching, Cache Redirection, Global Server Load Balancing (GSLB), Authentication, and Citrix Gateway in Citrix ADM. This report allows you to have a high-level view of mapping between the Citrix ADC instances, partitions, and the corresponding bound entities (virtual servers, service groups and services) that are present in the network. You can export these reports in .csv file format.

The report displays the following virtual server data:

NetScaler IP address

Host name

Partition data

Type of virtual server

Virtual Server name

Target LB Virtual Server

Service name

Service Group name.

For more information, see How to Export or Schedule Export of Network Functions Reports.

[696259]

Importing StyleBooks using Files or ZIP Bundles

Citrix ADM allows you to import multiple StyleBooks in YAML format. You can compress more than one YAML StyleBook file in a zip (.zip) format or tarball (.tgz, .gz) format. For more information, see How to Use User-Defined StyleBooks.

[694938]

Excluding Default Citrix ADC Certificates in SSL Dashboard

Citrix ADM allows you to show or hide default Citrix ADC certificates showing up on the SSL Dashboard charts based on your preferences. To show or hide default certificates on the SSL dashboard:

For more information, see Excluding default Citrix ADC certificates on the SSL Dashboard.

[687609]

Fixed Issues

Networks

To create a configuration job using user-defined templates from templates list, you must drag the templates to the editor and edit the variables by providing new values. But when the config job is executed, the variables are not replaced by the new values provided by you. [698812]

In Citrix ADM, when event age is set in a rule for an event, those events are not seen in the GUI. Also, as the entityUp, entityDown, and entityOfs entities are correlated, they should be updated for the same event. But these traps are seen separately in event messages. [699487]

Citrix ADM displays a message in Events that always says that the licenses are expiring in the next 30 days, though the licenses might be expiring earlier than that. [696976]

Known Issues

Analytics

On certain occasions, HDX Insight and Citrix Gateway Insight nodes might not be displayed on the Citrix ADM GUI.

Workaround: Refresh the page and try again. [690327]

Networks

Currently, permissions for some dependent resources(ns_lbvserver,ns_csvserver etc) are given as part of Network Reporting feature permission. But as part of the new enhancement, these permissions should be given only if users have access to the corresponding node under Network Functions. For example, if users want to run the reporting on Load Balancing virtual servers, they should have access only to the Load Balancing virtual servers under Network Functions and vice versa. [700859]

December 07, 2017

This release includes new features and bug fixes.

By default, the Citrix ADM agents are automatically upgraded to build 506.122. You can view the agent details on the Networks > Agents page. You can also specify the time when you want the agent upgrades to happen. For more details, see Configuring Agent Upgrade Settings.

What’s New

Enhancements to the Multicloud GLB StyleBook to Support Parent-Child Deployment and Statistics-Based GLB Algorithms

The global load balancing (GLB) solution enables users to distribute the client requests across several data centers and application servers. The data centers are distributed on multiple clouds and the application servers are deployed on premises. This solution supports the following features:

Parent-child topology. The topology is used when statistics based GLB algorithms are used to configure GLB and LB nodes. This topology is also used if the LB nodes are deployed on a different Citrix ADC instance.

Spillover persistence. The backup virtual server continues to process the requests it receives, even after the load on the primary falls lower than the threshold.

Internet Protocol version 6 (IPv6).

Metric-based, non-metric based, and proximity-based GLB methods.

Use the “Multi-cloud GLB StyleBook,” version 1.1 to execute the GLB configuration on the selected GLB Citrix ADC instance. Use the Multi-cloud GLB StyleBook for LB Node to configure one LB node at a time to create GLB parent-child topology in any of the following cases:

If you are using the metric-based GLB algorithms (Least Packets, Least Connections, Least Bandwidth) to configure GLB and LB nodes

Providing Description for Groups

In Citrix ADM, when you create groups, you can now type a description of your group in the Group Description box. Provide a good description of the group. A good description helps you to understand the role and function of the group in a better way at a later point. For more information, see Configuring Groups on Citrix Application Delivery Management.

[685186]

Integration of Citrix ADM Advanced Analytics

Advanced Analytics feature of Citrix ADM monitors the virtual servers and services configured for an application and displays critical information about them. This feature helps you to monitor, manage, and take decisions during outages, and other events. A few key functionalities of advanced analytics are listed as follows:

Auto-Register the Citrix ADM Agent in AWS to Citrix ADM

You can now automatically register the Citrix ADM agent with Citrix ADM by providing the Service-URL and Activation Code details of Citrix ADM while deploying the Citrix ADM agent in Amazon Web Service (AWS). For more information, see Installing Citrix ADM Agent on AWS.

[688901]

Configuration Audit when Citrix ADM Receives ChangeConfig SNMP Trap

When a configuration change happens in a Citrix ADC instance in the network, the instance updates the configuration. The instance then sends a ConfigChange SNMP trap to Citrix ADM. You can enable Citrix ADM to run configuration audit on that instance. You can configure Citrix ADM to generate a configuration audit diff, whenever it receives a ConfigChange SNMP trap. For more information, see How to Generate Configuration Audit Diff for ConfigChange SNMP Traps.

[682007]

Support for Scheduling the Maintenance Tasks

You can now schedule all the following maintenance tasks at a specific date and time using Citrix ADM.

Upgrade Citrix ADC instances

Upgrade Citrix SDWAN-WO instances

Upgrade Citrix ADC SDX instances

Configure HA pair of Citrix ADC instances

Convert HA pair of instances to Cluster

You can also configure email notification while scheduling maintenance task. Once configured, an email notification is sent every time a job is executed or scheduled.

[681934]

Built-in YAML Viewer/Editor to View/Create StyleBook Definitions

Citrix ADM provides you a built-in YAML editor that allows you to compose your StyleBook that corresponds to YAML guidelines. The content is validated against YAML standards and any deviation is highlighted. You can then correct the content and import the StyleBook into Citrix ADM. The built-in YAML editor provides two advantages while writing your own StyleBook:

Color coded. The color coding of the content helps you to differentiate easily between the keys and the values defined in the YAML content.

YAML validation. The content is validated for any YAML errors as you type in and any deviation is immediately highlighted.

Viewing Private StyleBooks in Citrix ADM GUI

As the number of StyleBooks - both public and private increases, you need an ability to search for the particular StyleBook that you want to access. You also need an ability to view both types of StyleBooks separately. In Citrix ADM GUI when you navigate to Applications > StyleBooks, you can view a list of StyleBooks that are present in the system. Both types of StyleBooks have distinct icons that declare them as either private or public. For more information, see How to View Different Groups of StyleBooks.

[686913]

HA Proxy App Dashboard Integration

In Citrix ADM, the application analytics and management feature is extended to support HAProxy applications. The Application dashboard provides a complete view of all the applications monitored by Citrix ADM, that is, both Citrix ADC and HAProxy applications. HAProxy discrete applications are created automatically for every managed HAProxy frontend. You can also group these applications to form custom applications similar to Citrix ADC applications.

Configuring App Score in Citrix ADM

Citrix ADM allows you to configure App Scores. Calculation of the App Score is based on the average values of the following three key components:

Performance Score (APDEX score of the application)

Citrix ADC instance Resource

Server Resource

The App Scores are displayed for all the applications that are discovered as well as the custom applications you define on the application dashboard. For more information, see Application Performance Analytics.

The App Activity Investigator in the Dashboard tab displays key information of a selected application such as App Score components, errors, events, and anomalies. Each of the legends is aggregated at one-minute interval if the selected duration is one hour, and at a one-hour interval, if the selected duration is one day. These deviations are displayed as rectangular legends on the graph. These legends are aggregated and are color-coded according to the number of events that have occurred.

[693769]

Creating Thresholds and Configuring Rules and Alerts for HDX Insight

The threshold management for HDX Insight in Citrix ADM allows you to proactively configure alerts whenever the thresholds set are breached. This threshold management is extended to configure a group of threshold rules and monitor the group instead of individual rules. A threshold rule group comprises one or more user-defined threshold rules for metrics chosen from entities such as users, apps, and desktops with an expected value.

The threshold management for HDX Insight in Citrix ADM allows you to proactively configure alerts whenever the thresholds set are breached. This threshold management is extended to configure a group of threshold rules and monitor the group instead of individual rules. A threshold rule group comprises one or more user-defined threshold rules for metrics chosen from entities such as users, apps, and desktops with an expected value. Threshold groups can also be bound to geolocations for geo-specific monitoring for user entity.

[652447]

Fixed Issues

Networks

In Citrix ADM GUI, the hostname of the Citrix ADC instance does not appear on the details page of SSL Certificate. With this fix, the hostname is visible.

In Citrix ADM, navigate to Networks > SSL Dashboard.

On the SSL Dashboard page, click inside one of the circles.

Select a certificate on the SSL Certificates page, and click Details. [670374]

When scheduling instance backup settings, there is a difference of few hours between the scheduled time of backup and the time displayed on the Citrix ADM GUI. [695489]

If you are trying to export two charts from the Network Reports page in Citrix ADM GUI, only the first chart is exported as a report. With this fix, all charts on the Network Reports page are now exported.

Note: The reports are exported in .pdf, .png, or .jpeg format. [699380]

November 17, 2017

This release includes new features and bug fixes.

By default, the Citrix ADM agents are automatically upgraded to build 505.117. You can view the agent details on the Networks > Agents page. You can also specify the time when you want the agent upgrades to happen. For more details, see Configuring Agent Upgrade Settings.

What’s New

Proxy Server Support for Agents on Citrix ADM

You can now connect your agents to the Citrix ADM using a proxy server. Using this enhancement, agents forward all their data to the proxy server, which then sends the data to the Citrix ADM via the internet.

To forward data using the proxy server, type the proxy server details on the agent using the following script: proxy_input.py, and follow the instructions provided by the script to enter more information. The agent fetches this information while it connects to the Citrix ADM using the proxy server.

You can authenticate your proxy server by providing your user name and password information. When the agent sends the data, the proxy server authenticates the user credentials before forwarding it to the Citrix ADM.

Note: Proxy server supports only basic authentication.

[697617]

Enabling Single Sign-On for Google Apps in Citrix ADC instances using StyleBook

The default SSO Google Apps StyleBook in Citrix ADM allows you to enable Single Sign-On for Google applications in Citrix ADC instances. The StyleBook configures the Citrix ADC instance as a SAML identity provider for authenticating users to access Google Apps. For more information, see How to Use SSO Google Apps StyleBook.

You can now assess the peak usage trend of an application. You can also compare its impact on the application performance based on App Score from the Application Dashboard in Citrix ADM. You can use the peak usage trend and performance impact on the application information and make necessary changes in your deployment. This helps to improve the performance of the application.

To view the peak usage trend of an application, navigate to Applications > App Dashboard. Select the application and click Peak Usage.

Fixed Issues

Networks

In Citrix ADM Configurations Job > Jobs page, if any row has a blue background, the Create Job button is disabled. With this fix, the Create Job button is active and does not get disabled. [695397]

In Citrix ADM Networks > Events > Event Messages, when you try to sort the event messages based on date, the sorting does not happen correctly. The messages are sorted in the reverse order to the direction of the sorting arrows. For example, when the messages are sorted from newer to older, the arrow points upwards. [696737]

There is a validation error when you upload the ns.conf file to Citrix ADM for configuration advise. [696920]

A trap message sent to Citrix ADM displays the name of the entity along with the IP address of the virtual server where the trap originates and the port. The following example shows the entity name in trap message received by Citrix ADM:

Citrix ADM does not display the name of the entity, the IP address, and port number as separate parameters in the Message column in Networks > Events > Event Messages table. [696639]

In an event rule, when you execute a script that has a message that has space (“ “), the script is not activated. [696896]

Some network reports take a longer time to generate in Citrix ADM. When such reports are scheduled to be exported, incomplete reports are exported. With this fix, Citrix ADM waits until the reports are generated completely before exporting them. [695500]

In Citrix ADM, you cannot export reports for some tabular views and dashboards. With this fix, you can now export the content of the tables and dashboards. [670226]

In Citrix ADM, consider that you are in a list view and you have navigated further into specific pages. You cannot navigate back using the navigation pane on the left side of the GUI. You might have to navigate by using the breadcrumbs at the top of the page. For example, consider that you are currently in Networks > Instances > NetScaler VPX > Backup/Restore page. When you select the Citrix ADC instance type under Networks > Instances, the corresponding Citrix ADC instance list page does not open after you click NetScaler VPX in the navigation pane. [684922]

In Citrix ADM, any error in processing the configuration audit report results in an empty mail sent to the mail recipients. [697138]

Settings

At the time of node registration and deployment in Citrix ADM in HA, password of both the nodes has to be the default password “nsroot.” Node registration fails if the password is different from “nsroot.” [691836]

In Citrix ADM, when you enter special characters such as “&” in the input fields, such as name and description, “&” is replaced by “\&amp”. [692656]

In Citrix ADM, when you enter special characters such as “&” in the input fields such as name and description, “\&amp” replaces “&”. [692656]

You can add applications to a group and also specify a regex to apply the search criteria to add applications to the group. In such a case, when you edit a group some multiple times, the name of the application is converted to an invalid regex expression. This causes the RBAC to fail and the users can see all the applications.

In Citrix ADM, navigate to System > User Administration > Groups, and click Add. Enter the group name, and in Authorization Settings tab, select the required application and add it to the group and click Create Group.

When you want to add a regex, navigate to Groups page, select the group and click Edit.

In Authorization Settings tab, add the regex in the Add Regular Expression text box and save the settings.

If you edit the group again, in Authorization Settings tab, you might find that the name of the application that you added earlier is converted to a regex. Because this is an invalid regex, RBAC fails and your user can see all applications. [696515]

High Availability

When Citrix ADC instances in HA setup fails over and if the new primary is inaccessible from Citrix ADM, the instance is no longer seen in Citrix ADM GUI. [697017]

When you restore a backup file from one Citrix ADC instance in a pair that is in HA setup to another instance in the same pair, that Citrix ADC instance becomes inaccessible because of a conflict in IP address. Citrix ADM checks if the IP address in the backup file and the IP address of the instance on which the restoration is performed is the same. If the IP addresses do not match, an error message is displayed and the restoration is stopped. [686829]

When you are upgrading a pair of Citrix ADC instances that are in HA, the Citrix ADC instances are unstable. The instances might have to wait for some time before responding to the NITRO calls sent from Citrix ADM.

With this fix, you can set a waiting time in the instance profile so that Citrix ADM waits for the set time before sending a NITRO call to the instances. The default waiting time is 60 seconds. [690860]

Known Issues

Analytics

On certain occasions, HDX Insight and Gateway Insight nodes might not be displayed on the Citrix ADM GUI.
Workaround: Refresh the page and try again. [690327]

Settings

When you delete the users from Citrix Cloud, the deleted user names continue to appear in Citrix ADM in Settings > User Administration > Users. [686581]

Maintenance tasks in Citrix ADM are not working. [696952]

October 27, 2017

This release includes new features and bug fixes.

By default, the Citrix ADM agents are automatically upgraded to build 504.115. You can view the agent details on the Networks > Agents page. You can also specify the time when you want the agent upgrades to happen. For more details, see Configuring Agent Upgrade Settings.

What’s New

Ability to Import and Export the Configuration Templates

You can export the configuration templates and import the template to the same or another tenant in the Citrix ADM. The exported template data (like configuration commands, variable definitions, and parameters) are not lost after importing.

To export the configuration template, navigate to Networks > Configuration Jobs > Configuration Templates. Select the configuration template and click Export. The exported configuration templates are saved in the local system in a JSON file format. You can then import this file to same or another tenant in the Citrix ADM to create a configuration template. To import the configuration template, click Import and select the JSON file that you have saved locally.

Support for Revision History Difference and Audit Template for Admin Partitions

The revision history difference and the audit template for administrator partition are now supported in Citrix ADM.

Revision history difference for administrator partition allows you to view the difference between the five latest configuration files for a partitioned Citrix ADC instance. You can compare the configuration files against each other (example Configuration Revision - 1 with Configuration Revision -2) or against the current running/saved configuration with Configuration Revision. Along with the differences in configuration, the correction configurations are also shown. You can export all the corrective commands to your local folder and correct the configurations.

Audit templates for partition allow you to create a custom configuration template and associate it with a partition instance. Any variation in the running configuration of the instance with the audit template is shown in the “Template vs Running diff” column of the Audit Reports page. Along with the differences in configuration, the correction configurations are also shown. You can also export all the corrective commands to your local folder and correct the configurations.

[657300]

Ability to Add Multiple Templates of Different Types in Configuration Jobs

You can now add multiple templates of different types in the configuration job editor while creating a configuration job. To add multiple templates, navigate to the Networks > Configuration Jobs and click Create Job. On the Create Job page, enter the job name, and select the instance type. From the Configuration Source drop-down list, you can select the required source and then drag multiple templates that you require to the configuration editor. The template source types are Configuration Template, Inbuilt Template, Master Configuration, Record and Play, Instance, and File.

Ability to Persist the Input Variable Values in Configuration Jobs

In Citrix ADM, while creating the configuration jobs, the specified input variable values including input files are now persisted. You can view and edit these values and also the input files that you have uploaded earlier while creating the configuration job. To view the input variable values, navigate to Network > Configuration Jobs, select the job and click Edit. On the Specify Variable Values tab, you can view the persisted variable values. The input file that you uploaded earlier also persists. You can download the input file, edit the file and then upload the same input file without changing the name.

[691584]

Ability to Reorder Commands in Configuration Job Editor

You can now rearrange and reorder the commands in the configuration job editor. You can now move the commands from one line to another by dragging the command line. You can also move or rearrange the command line from one line to any target line by simply changing the command line number.

[684164]

Configuring Network Reporting Prune Settings for Citrix ADM

You can now configure the prune interval of network reporting data in Citrix ADM. This limits the amount of network reporting data being stored in the Citrix ADM server’s database. By default, pruning happens every 24 hours (at 01.00 hours) for the network reporting historical data.

[692461]

Ability to Preview and Modify the Variables in Configuration Job

In Citrix ADM, you can now preview all the variables that you have defined while creating or editing a configuration job in a single consolidated view.

Click Preview Variables tab in Configuration Job Editor to preview the variables in a single consolidated view. A new pop-up window appears and displays all the parameters of variables such as Name, Display Name, Type, and default value in a tabular format. You can also edit and modify these parameters. Click Done after you have edited or modified any of the parameters.

You can do one of the following to preview all the variables in a single consolidated view:

Creating a configuration job. Navigate to Networks > Configuration Jobs, select Create Job. On the Create Job page, you can preview all the variables.

Editing a configuration job. Navigate to Network > Configuration Jobs, select the job name and click Edit. On the Configure Job page, you can preview all the variables that were added while creating the configuration job.

[684166]

Wildcard Support for Dynamically Adding Applications to Groups in Citrix ADM

When you add applications to a group in Citrix ADM, you can use regex to search and add the applications that meet the regex criteria to the groups. The users who are bound to these groups can access only those specific applications. The regex expression specified is persisted in Citrix ADM. When a new application is added to the system, Citrix ADM applies the search criteria to the new application, and the application that meets the criteria dynamically becomes part of the group. You do not have to manually add the new application to the group. The applications are updated dynamically in the system, and the respective group users can see the applications under appropriate modules in Citrix ADM.

Exporting of Configuration Audit Diff Report

Citrix ADM allows you to download the configuration audit diff report in configuration audit section. The configuration audit section enables you to export the summary report across all instances and per instance and also allows you to export granular diff report for each instance-template pair.

Citrix ADM allows all the audit templates under Networks > Configuration Audit > Audit Templates to be run at a time that is scheduled individually or globally as per your requirement. You can schedule the config audit template to be run at a specific time rather than running the template at a default time configured by the system. When you select Customize template schedule option, you can schedule the template to be run daily, on a specific day in the week, or on a specific day in the month. For each option, you must also enter the schedule time when Citrix ADM should run the template. Citrix ADM provides you with the following options to schedule exporting of the config audit diff report.

Use global polling interval. Select this option to run the template on the instances at a time configured globally on Citrix ADM.

Customize template schedule. Use this option to configure the time and the frequency at which the templates need to be run.

Send report through email. Use this option to configure the mail profile to which the diff report should be sent as a mail attachment.

Ability to visualize dependencies of a StyleBook as a graph

You can now visualize all the dependencies of a StyleBook, that is, any other StyleBooks that your selected StyleBook depends on. Dependencies are created as a result of composing new StyleBooks by using existing ones. Dependencies are visualized as a graph of boxes and arrows, where each box represents a StyleBook and each arrow represents a direction dependency from a StyleBook to its dependent one. Navigate to Applications > Configurations > StyleBooks and in the list of StyleBooks that are displayed on the right-side panel, click the View Dependencies link for the StyleBook that you want to visualize.

[697175]

Downloading Custom StyleBooks and the Dependent Custom StyleBooks

You can now download a custom StyleBook and its dependent StyleBooks in YAML format to your system as a ZIP or TGZ file. In Citrix ADM, navigate to Applications > Configurations > StyleBooks, and from the list of StyleBooks that is displayed on the right-side panel, click the Download link for the StyleBook that you want to download.

Note: You cannot download default StyleBooks.

[696383]

Deleting Custom StyleBooks and the Dependent Custom StyleBooks

You can remove a custom StyleBook and its dependent StyleBooks from Citrix ADM folder system. Navigate to Applications > Configurations > StyleBooks, and from the list of StyleBooks that is displayed on the right-side panel, and click “X” icon on the right of the StyleBook you want to delete. You are given the option of deleting just the file or all the dependent StyleBooks too.

Note: You cannot delete default StyleBooks.

[696384]

Manage and Monitor HAProxy Instances

You can now manage and monitor HAProxy instances in your deployment using Citrix ADM. When you add an HAProxy host to Citrix ADM, it automatically discovers the HAProxy instances on the host and enables you to manage and monitor them by providing the following:

HAProxy App Dashboard: Displays real-time statistics of the frontends on the HAProxy instances. The dashboard lists the front ends as discovered applications and shows real-time transactions, throughput, and session’s information about the applications.

Ability to restart an HAProxy Instance: You can restart an HAProxy instance from the Citrix ADM GUI. Also, you can perform hard restart or soft restart an HAProxy instance from the Citrix ADM GUI.

Fixed Issues

Analytics

The Analytics feature does not display any data if you have added Citrix ADC CPX instances in Citrix ADM.Workaround: Do not add any Citrix ADC CPX instances to Citrix ADM. [694792]

Agents

If you navigate to Networks > Agents and try to download an agent from the Agents screen, you might see an error such as “File not found.”Workaround: To download an agent, navigate to Settings > Set Up Agent, select the hypervisor, and then click Download Image. [695998]

Known Issues

The following known issues exist in this release:

Analytics

On certain occasions, HDX Insight and Gateway Insight nodes might not be displayed on the Citrix ADM GUI.Workaround: Refresh the page and try again. [690327]

Settings

When you delete the users from Citrix Cloud, the deleted user names continue to appear in Citrix ADM in Settings > User Administration > Users. [686581]

In Citrix ADM, when you enter special characters such as “&” in the input fields such as name and description, “\&amp” replaces “&”. [692656]

Maintenance tasks in Citrix ADM are not working. [696952]

You can add applications to a group and also specify a regex to apply the search criteria to add applications to the group. In such a case, when you edit a group some multiple times, the name of the application is converted to an invalid regex expression. This causes the RBAC to fail and the users can see all the applications.

In Citrix ADM, navigate to Settings > User Administration > Groups, and click Add. Enter the group name, and in Authorization Settings tab, select the required application and add it to the group and click Create Group.

When you want to add a regex, navigate to Groups page, select the group and click Edit.

In Authorization Settings tab, add the regex in the Add Regular Expression text box and save the settings.

If you edit the group again, in Authorization Settings tab, you might find that the name of the application that you added earlier is converted to a regex. Because this is an invalid regex, RBAC fails and your user can see all applications. [696515]

October 7, 2017

This release includes new features and bug fixes.

The Citrix ADM agents are automatically upgraded to build 503.115. You can view the agent details on the Networks > Agents page.

What’s New

The following enhancements are available in this release.

Configure Agent Upgrade Time

By default, an agent is upgraded automatically when a newer version is available. However, you can specify the time when you want the agent upgrade to happen. If you select a specific time, the agents are upgraded at that specified time, but in the time zone where your agents are deployed. During the upgrade, there might be a downtime of approximately 30 minutes. To specify the agent upgrade time, navigate to Networks > Agents, click Configure Upgrade Settings, and then specify when you want the agent to be upgraded. For more details, see Configuring Agent Upgrade Settings.

Accessing the GUI of a Managed Citrix ADC instance from Citrix ADM

You can now access the GUI of a managed Citrix ADC instance from Citrix ADM. To manage and monitor Citrix ADC instances, add them to the Citrix ADM. You can then access them from the Citrix ADM. Make sure that you are connected to the Citrix network.

To access a Citrix ADC instance GUI from Citrix ADM, navigate to Networks > Instances. Under Instances, select the type of instance you want to view (for example, Citrix ADC VPX), and then click the IP address of the instance that you want to access.

[693970]

Manage Citrix SWG Instances from Citrix ADM

Citrix ADM now supports the discovery, management, and monitoring of Citrix Secure Web Gateway (SWG) instances. You can view the Citrix SWG instances under Networks > Instances as shown in the following image:

[692493]

Support for Grace Period After License Expiry

After the license is expired, Citrix ADM provides 90 days of grace period. During the grace period, the data collected by Citrix ADM is retained for 30 days, and the configurations are retained for 90 days. During the grace period, you cannot access the Citrix ADM.

[691069]

Entity-Specific Polling Support

Citrix ADM enables you to poll specific entities configured on an instance. This reduces the refresh time that Citrix ADM requires to display the most recent status of the entities bound to an instance. You can now poll the following entities for any update to their status: services, service groups, load balancing virtual servers, cache reduction virtual servers, content switching virtual servers, authentication virtual servers, VPN virtual servers, GSLB virtual servers, and application servers. For detailed documentation, see How to Poll Citrix ADC instances and Entities.

[692958]

Fixed Issues

The following issues have been fixed in this release.

Agent

If you are using an agent provisioned on Microsoft Azure cloud, the managed instances associated with this agent appear in the down state in the Citrix ADM GUI. [690941]

After agent registration is completed, you might not be able to log on to the agent from the hypervisor console. [691181]

Networks

In Citrix ADM, while creating configuration jobs the files do not get uploaded automatically. You must select the files that you want to upload and click on the Upload button. The Upload button is not available now and the file gets uploaded automatically after you select the files that you want to upload. [686889]

In Networks > Configuration jobs > Preview, you can view the associated rollback commands of the configuration job on the preview page. [687621]

Settings

In Citrix ADM, Citrix SD-WAN WO advanced platform backup does not work with a user-defined device profile. [690508]

Known Issues

The following known issues exist in this release:

Agents

If you navigate to Networks > Agents and try to download an agent from the Agents screen, you might see an error such as “File not found.”Workaround: To download an agent, navigate to Settings > Set Up Agent, select the hypervisor, and then click Download Image. [695998]

Analytics

On certain occasions, HDX Insight and Gateway Insight nodes might not be displayed on the Citrix ADM GUI.Workaround: Refresh the page and try again. [690327]

The Analytics feature does not display any data if you have added Citrix ADC CPX instances in Citrix ADM.Workaround: Do not add any Citrix ADC CPX instances to Citrix ADM. [694792]

What’s New

The global load balancing (GLB) solution enables users to distribute the client requests across multiple data centers in multiple clouds and to application servers deployed on premises. This solution supports both multi-cloud and hybrid cloud deployments. The core advantages of this solution are:

Enables you to create, manage, and monitor GLB nodes across geographic locations from a single, unified console.

Provides the flexibility of moving part of the infrastructure to the cloud.

Manage and Monitor HAProxy Instances (Preview)

You can now manage and monitor HAProxy instances in your deployment using Citrix ADM. When you add an HAProxy host to Citrix ADM, it automatically discovers the HAProxy instances on the host and enables you to manage and monitor them by providing the following:

HAProxy App Dashboard: Displays real-time statistics of the frontends on the HAProxy instances. The dashboard lists the front ends as discovered applications and shows real-time transactions, throughput, and session’s information about the applications.

Ability to restart an HAProxy Instance: You can restart an HAProxy instance from the Citrix ADM GUI. Also, you can perform a hard restart or soft restart an HAProxy instance from the Citrix ADM GUI.

Fixed Issues

The following issues have been fixed in this release.

Networks

If control proxy is not available during agent start up process, the agent is not able to retrieve the SNMP trap settings from Citrix ADM and all the traps received from Citrix ADC instances are dropped. [687027]

When you configure a rule to monitor specific events in Citrix ADM, emails are not sent for the events that match the filter criteria. [688985]

Upgrade Citrix ADC feature in Maintenance Tasks is not supported in Citrix ADM. But, you can still view the option in the GUI. [689068]

In Citrix ADM, the Hamburger icon (menu icon on the left corner) changes to Close icon (X) when clicked to open the Navigation Menu. With this fix, if we open any configuration page, for example, Add Instance, Configure Insight, and others, the navigation menu panel is hidden, and the “X” icon is disabled. [687203]

In Networks > Events > Event Messages, when you select an event and click the Details tab, the values of the following parameters like User Name, Configuration Command, Authorization Status, Execution Status, and Entity Type are missing on the Events Details page. [686791]

In Networks > Network Functions > Load Balancing > Service Groups, you can now filter the applications by ID and use this in Python SDK. [692061]

In Networks > Network Functions > Load Balancing > Virtual Servers, for some load balancing virtual servers that are in the UP state for more than 248 days, the column UP Since displays incorrect values. [693146]

Settings

In Citrix ADM, if you create a group name that has spaces, certain functionalities, such as retrieving apps, that use group names for permissions may not work as expected. [ 692629]

Upgrading Citrix ADC instances in HA mode from Citrix ADM fails because the secondary node takes some time to restart causing the force failover from primary to fail. [ 693119]

StyleBooks

The ”*“ is accepted as a valid input for the tcp-port parameter in the CLI command. [694155]

Known Issues

The following known issues exist in this release:

Agent

If you are using an agent provisioned on Microsoft Azure cloud, the managed instances associated with this agent appear in the down state in the Citrix ADM GUI. [690941]

After agent registration is completed, you might not be able to log on to the agent from the hypervisor console.Workaround: Log on to the agent using an SSH client. [691181]

Analytics

On certain occasions, HDX Insight and Gateway Insight nodes might not be displayed on the Citrix ADM GUI.Workaround: Refresh the page and try again. [690327]

The Analytics feature does not display any data if you have added Citrix ADC CPX instances in Citrix ADM.Workaround: Do not add any Citrix ADC CPX instances to Citrix ADM. [0694792]

Note: [XXXXXX] labels are internal tracking IDs used by the Citrix ADM team.

August 25, 2017

This release includes new features and bug fixes.

An upgrade for the Citrix ADM agent is available with this refresh. You have to upgrade the agent to build 501.117. For instructions on how to upgrade an agent, see How to Upgrade a Citrix ADM Agent.

What’s New

The following enhancements are available in this release.

Citrix ADM Evergreen Agent Upgrades

In Citrix ADM, agents running on software version 12.0 build 501.117 and later are automatically upgraded to newer and recommended versions by Citrix ADM.
To enable this feature for your Citrix ADM agents, you need to manually upgrade your existing agents to Citrix ADM agent version 12.0 build 501.117.

Fixed Issues

The following issues have been fixed in this release.

Networks

In Citrix ADM, if you try to delete the default certificates of any discovered Citrix ADC instances, an error message is displayed. Now once you select the default certificates, “Delete” button is disabled.
[687610]

In Citrix ADM, if you delete a Citrix ADC instance, failure objects associated with the respective Citrix ADC instances are not deleted.
[690059]

In Citrix ADM, while performing entity polling, if the number of Citrix ADC instances that are to be discovered are are very high, Citrix ADM UI might become unresponsive.
Workaround: Close your web browser, and re-logon to your Citrix ADM after 10-15 minutes.
[692617]

On-Boarding

After you on-board a new tenant in Citrix ADM, and once you click “Manage” button, it might display the error “Page not Working” for the first time.
[691018]

Known Issues

The following known issues exist in this release:

Agent

If you are using an agent provisioned on Microsoft Azure cloud, the managed instances associated with this agent appear in the down state in the Citrix ADM GUI. [690941]

After agent registration is completed, you might not be able to log on to the agent from the hypervisor console.Workaround: Log on to the agent using an SSH client. [691181]

Analytics

On certain occasions, HDX Insight and Gateway Insight nodes might not be displayed on the Citrix ADM GUI.Workaround: Refresh the page and try again. [690327]

Networks

If control proxy is not available during agent start up process, the agent is not able to retrieve the SNMP trap settings from Citrix ADM and all the traps received from Citrix ADC instances are dropped.Workaround: Run “masd restart” on agent when connectivity to Citrix ADM has been established. [687027]

When you configure a rule to monitor specific events in Citrix ADM, emails are not sent for the events that match the filter criteria. [688985]

Upgrade Citrix ADC feature in Maintenance Tasks is not supported in Citrix ADM. But, you can still view the option in the GUI. [689068]

Settings

When you delete the users from Citrix Cloud, the deleted user names continue to appear in Citrix ADM in Settings > User Administration > Users. [686581]

Note: [XXXXXX] labels are internal tracking IDs used by the Citrix ADM team.

August 13, 2017

This is a bug fix release. There are no new features in this release.

An upgrade for the Citrix ADM agent is available with this refresh. You have to upgrade the agent to build 500.122. For instructions on how to upgrade an agent, see How to Upgrade a Citrix ADM Agent.

Fixed Issues

The following issues have been fixed in this release.

Analytics

While using HDX insight in Citrix ADM, geo maps might not work for IP blocks which are created through Private IP block. [691947]

While creating two IP block sites, the geo location of the first IP site is not displayed properly. If you delete and recreate the first IP site, the geo map doesn’t display any information about the first IP site. [691965]

Networks

For easier debugging in Citrix ADM, the subsystem log files display the tenant names for any database exceptions thrown. [692663]

Known Issues

The following known issues exist in this release:

Agent

If you are using an agent provisioned on Microsoft Azure cloud, the managed instances associated with this agent appear in the down state in the Citrix ADM GUI. [690941]

After agent registration is completed, you might not be able to log on to the agent from the hypervisor console.Workaround: Log on to the agent using an SSH client. [691181]

Analytics

On certain occasions, HDX Insight and Gateway Insight nodes might not be displayed on the Citrix ADM GUI.Workaround: Refresh the page and try again. [690327]

Networks

If control proxy is not available during agent start up process, the agent is not able to retrieve the SNMP trap settings from Citrix ADM and all the traps received from Citrix ADC instances are dropped.Workaround: Run “masd restart” on agent when connectivity to Citrix ADM has been established. [687027]

When you configure a rule to monitor specific events in Citrix ADM, emails are not sent for the events that match the filter criteria. [688985]

Upgrade Citrix ADC feature in Maintenance Tasks is not supported in Citrix ADM. But, you can still view the option in the GUI. [689068]

On-Boarding

After you on-board a new tenant in Citrix ADM, and once you click “Manage” button, it might display the error “Page not Working” for the first time.Workaround:
Wait for an hour (60 mins), and log in again. The delay is due to the time taken for provisioning the new tenant. [691018]

Settings

When you delete the users from Citrix Cloud, the deleted user names continue to appear in Citrix ADM in Settings > User Administration > Users. [686581]

Note: [XXXXXX] labels are internal tracking IDs used by the Citrix ADM team.

August 10, 2017

This release includes new features and bug fixes.

An upgrade for the Citrix ADM agent is available with this refresh. You have to upgrade the agent to build 500.120. For instructions on how to upgrade an agent, see How to Upgrade a Citrix ADM Agent.

What’s New

The following enhancements are available in this release.

Suppress Syslog Messages in Citrix ADM

Citrix ADM receives all configured syslogs sent to it by the managed Citrix ADC instances. Because of large number of syslog messages, the syslogs occupy huge space in the database. Many of these messages may not be of importance to you and you may want to get only the important syslog messages.

You can now suppress some of the syslogs received on Citrix ADM by setting up filters. The two filters that you can use to suppress syslogs are severity and facility. You can suppress messages coming from one or more Citrix ADC instances.

You can also use text patterns to search and suppress messages. Citrix ADM drops all messages that match the specified criteria. The dropped syslogs aren’t seen on Citrix ADM nor are they stored in the customer database. Therefore, a large amount of space is saved on the storage server.

You can generate reports of load balancing entities, such as virtual servers and services that are configured on managed Citrix ADC instances. You can view consolidated reports of all the entities. These reports allow you to have a high-level view of the following:

Save Variable Values when a Configuration Job is Saved for Later Execution

When creating configuration jobs, you may specify variable values, but save and execute the job later or schedule the job to run later. In such a scenario, Citrix ADM now retains the variable values in saved jobs.
[637830]

Support for Customized SSH Port for Citrix ADC instances

You can now specify user-defined SSH port for communication between Citrix ADM and the Citrix ADC instances.

To set the SSH port for the instance profiles

Log on to Citrix ADM using a supported web browser.

Navigate to Networks and select the instance type of the Citrix ADC instance you want to discover in Citrix ADM.

Click Profiles.

In the Admin Profiles page, click Add.

In SSH Port, type the configured custom SSH port number for Citrix ADC instances to communicate with Citrix ADM.

Click OK.

[689369]

Fixed Issues

The following issues have been fixed in this release.

Agent

By default, only the super administrator user (the first user of your organization to sign up and log on to Citrix ADM) has the permission to generate the activation code required to register an agent to the service. A delegated administrator (every subsequent user that logs on) does not have the permission to generate the activation code. When a delegated administrator clicks Generate Activation Code, the following error appears: “Not Authorized to perform this operation.”
[690576]

Application Analytics and Management

Networks

When you configure a rule to monitor specific events in Citrix ADM, SNMP traps are not sent to external trap destinations.
[689018]

When you configure a rule to monitor specific events in Citrix ADM, job is not executed for the events that match the filter criteria that you have specified. [688986]

When you configure a rule to monitor specific events in Citrix ADM, events are not suppressed for the configured time period. [688988]

When you create a group in Citrix ADM from Settings > User Administration > Group, the success message informing that the group is created appears before all the steps in the wizard are completed. [684944]

Known Issues

The following known issues exist in this release:

Agent

If you are using an agent provisioned on Microsoft Azure cloud, the managed instances associated with this agent appear in the down state in the Citrix ADM GUI. [690941]

After agent registration is completed, you might not be able to log on to the agent from the hypervisor console.Workaround: Log on to the agent using an SSH client. [691181]

Analytics

On certain occasions, HDX Insight and Gateway Insight nodes might not be displayed on the Citrix ADM GUI.Workaround: Refresh the page and try again. [690327]

Networks

If control proxy is not available during agent startup process, the agent is not able to retrieve the SNMP trap settings from Citrix ADM and all the traps received from Citrix ADC instances are dropped.Workaround: Run “masd restart” on agent when connectivity to Citrix ADM has been established. [687027]

When you configure a rule to monitor specific events in Citrix ADM, emails are not sent for the events that match the filter criteria. [688985]

Upgrade Citrix ADC feature in Maintenance Tasks is not supported in Citrix ADM. But, you can still view the option in the GUI. [689068]

On-Boarding

After you on-board a new tenant in Citrix ADM, and once you click “Manage” button, it might display the error “Page not Working” for the first time.
Workaround:
Wait for an hour (60 mins), and log in again. The delay is due to the time taken for provisioning the new tenant. [ 691018]

Settings

When you delete the users from Citrix Cloud, the deleted user names continue to appear in Citrix ADM in Settings > User Administration > Users. [686581]

Note: [XXXXXX] labels are internal tracking IDs used by the Citrix ADM team.

July 23, 2017

This is a bug fix release. There are no new features in this release.

An upgrade for the Citrix ADM agent is available with this refresh. You have to upgrade the agent to build 45.108. For instructions on how to upgrade an agent, see How to Upgrade a Citrix ADM Agent.

Fixed Issues

The following issues have been fixed in this release.

Citrix Cloud

After logging on to citrix.cloud.com, clicking the Manage button on the Citrix ADM tile displays the following error “page not available.”
[690267]

Networks

If you have enabled Secure Only access on your Citrix ADC instances, these instances are not discovered properly in Citrix ADM and the status might appear as “Out of Service” after the discovery process is completed.
[690431]

Known Issues

The following known issues exist in this release:

Agent

If you are using an agent provisioned on Microsoft Azure cloud, the managed instances associated with this agent appear in the down state in the Citrix ADM GUI. [690941]

After agent registration is completed, you might not be able to log on to the agent from the hypervisor console.Workaround: Log on to the agent using an SSH client. [691181]

By default, only the super administrator user (the first user of your organization to sign up and log on to Citrix ADM) has the permission to generate the activation code required to register an agent to the service. A delegated administrator (every subsequent user that logs on) does not have the permission to generate the activation code. When a delegated administrator clicks Generate Activation Code, the following error appears: “Not Authorized to perform this operation.”Workaround: Super administrator must assign the required permissions to the delegated administrator. For details, see How to Assign Additional Permissions to Delegated Admin Users. [690576]

Analytics

On certain occasions, HDX Insight and Gateway Insight nodes might not be displayed on the Citrix ADM GUI.Workaround: Refresh the page and try again. [690327]

Application Analytics and Management

If you use Safari browser on Microsoft Windows operating system, App Dashboard and Security Analytics Dashboard do not load. You can see other features of Citrix ADM. [ 688617]

Networks

If control proxy is not available during agent startup process, the agent is not able to retrieve the SNMP trap settings from Citrix ADM and all the traps received from Citrix ADC instances are dropped.Workaround: Run “masd restart” on agent when connectivity to Citrix ADM has been established. [687027]

When you configure a rule to monitor specific events in Citrix ADM, emails are not sent for the events that match the filter criteria. [688985]

When you configure a rule to monitor specific events in Citrix ADM, job is not executed for the events that match the filter criteria that you have specified. [688986]

When you configure a rule to monitor specific events in Citrix ADM, events are not suppressed for the configured time period. [688988]

When you configure a rule to monitor specific events in Citrix ADM, SNMP traps are not sent to external trap destinations. [689018]

Upgrade Citrix ADC feature in Maintenance Tasks is not supported in Citrix ADM. But, you can still view the option in the GUI. [689068]

Networks

If control proxy is not available during agent startup process, the agent is not able to retrieve the SNMP trap settings from Citrix ADM and all the traps received from Citrix ADC instances are dropped.Workaround: Run “masd restart” on agent when connectivity to Citrix ADM has been established. [687027]

When you configure a rule to monitor specific events in Citrix ADM, emails are not sent for the events that match the filter criteria. [688985]

When you configure a rule to monitor specific events in Citrix ADM, job is not executed for the events that match the filter criteria that you have specified. [688986]

When you configure a rule to monitor specific events in Citrix ADM, events are not suppressed for the configured time period. [688988]

When you configure a rule to monitor specific events in Citrix ADM, SNMP traps are not sent to external trap destinations. [689018]

Upgrade Citrix ADC feature in Maintenance Tasks is not supported in Citrix ADM. But, you can still view the option in the GUI. [689068]

Networks

If control proxy is not available during agent startup process, the agent cannot retrieve the SNMP trap settings from Citrix ADM, and all the traps received from Citrix ADC instances are dropped.Workaround: Run “masd restart” on agent when connectivity to Citrix ADM has been established. [687027]

Note: [XXXXXX] labels are internal tracking IDs used by the Citrix ADM team.

The official version of this content is in English. Some of the Citrix documentation content is machine translated for your convenience only. Citrix has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Citrix product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Citrix, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Citrix will not be held responsible for any damage or issues that may arise from using machine-translated content.

THIS SERVICE MAY CONTAIN TRANSLATIONS POWERED BY GOOGLE. GOOGLE DISCLAIMS ALL WARRANTIES RELATED TO THE TRANSLATIONS, EXPRESS OR IMPLIED, INCLUDING ANY WARRANTIES OF ACCURACY, RELIABILITY, AND ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.