Product Documentation

Release Notes

Aug 15, 2017

The NetScaler Management and Analytics Service (NetScaler MA Service) release notes describe the new features, enhancements to existing features, fixed issues, and the known issues available in a service release. The date indicates the date when the NetScaler MA Service was upgraded.

The release notes includes one or more of the following sections:

  • What's New: The new features and enhancements to existing features available in a release.
  • Fixed Issues: The issues fixed in a release.
  • Known Issues: The issues that exist in a release, and their workarounds, wherever applicable.

August 13, 2017

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

An upgrade for the NetScaler MA Service 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 NetScaler MA Service Agent.

Fixed Issues

The following issues have been fixed in this release.

Analytics

  • While using HDX insight in NetScaler MA Service, 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 NetScaler MA Service, 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 NetScaler MA Service 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 occassions, HDX Insight and Gateway Insight nodes might not be displayed on the NetScaler MA Service 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 NetScaler Management and Analytics Service and all the traps received from NetScaler instances are dropped.
    Workaround: Run "masd restart" on agent when connectivity to NetScaler Management and Analytics Service has been established. [# 687027]
  • When you configure a rule to monitor specific events in NetScaler MA Service, emails are not sent for the events that match the filter criteria. [# 688985]
  • Upgrade NetScaler feature in Maintenance Tasks is not supported in NetScaler MA Service. But, you can still view the option in the GUI. [# 689068]

On-Boarding

  • After you on-board a new tenant in NetScaler MA Service, 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

  • On the SettingsSubscriptions page, the storage data consumption might appear greater than the entitled storage limit of 5 GB. [# 689330]
  • When you delete the users from Citrix Cloud, the deleted user names continue to appear in NetScaler MA Service in Settings > User Administration > Users. [# 686581]

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

August 10, 2017

This release includes new features and bug fixes.

An upgrade for the NetScaler MA Service 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 NetScaler MA Service Agent.

What's New

The following enhancements are available in this release.

Suppress Syslog Messages in NetScaler MA Service

NetScaler MA Service receives all configured syslogs sent to it by the managed NetScaler 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 NetScaler MA Service 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 NetScaler instances.

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

For more information, see: How to Suppress Syslog Messages in NetScaler MA Service
[#6779274]

Generate and View Reports of Load Balancing Entities Configured on NetScaler Instances

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

  • NetScaler instances
  • Load balancing virtual servers
  • Admin partitions
  • Services
  • Service groups

The consolidated report helps you to create a mapping among these entities. For more information, see: How to Generate Reports for Load Balancing Entities
[#663174]

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, NetScaler MA Service now retains the variable values in saved jobs.
[# 637830]

Support for Customized SSH Port for NetScaler Instances

You can now specify user-defined SSH port for communication between NetScaler MA Service and the NetScaler instances.

To set the SSH port for the instance profiles

  1. Log on to NetScaler MA Service using a supported web browser.
  2. Navigate to Networks and select the instance type of the NetScaler Instance you want to discover in NetScaler MA Service.
  3. Click Profiles.
  4. In the Admin Profiles page, click Add.
  5. In SSH Port, type the configured custom SSH port number for NetScaler Instances to communicate with NetScaler MA Service.
  6. Click OK.

[# 689369]

Fixed Issues

The following issues have been fixed in this release.

Agent

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

Application Analytics and Management

Application Dashboard in NetScaler MA-Service shows incorrect security metrics for custom-defined applications.
[#689041]

Networks

  • When you configure a rule to monitor specific events in NetScaler MA Service, SNMP traps are not sent to external trap destinations.
    [# 689018]
  • When you configure a rule to monitor specific events in NetScaler MA Service, 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 NetScaler MA Service, events are not suppressed for the configured time period. [# 688988]
  • When you create a group in NetScaler MA Service 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 NetScaler MA Service 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 occassions, HDX Insight and Gateway Insight nodes might not be displayed on the NetScaler MA Service 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 NetScaler Management and Analytics Service and all the traps received from NetScaler instances are dropped.
    Workaround: Run "masd restart" on agent when connectivity to NetScaler Management and Analytics Service has been established. [# 687027]
  • When you configure a rule to monitor specific events in NetScaler MA Service, emails are not sent for the events that match the filter criteria. [# 688985]
  • Upgrade NetScaler feature in Maintenance Tasks is not supported in NetScaler MA Service. But, you can still view the option in the GUI. [# 689068]

On-Boarding

  • After you on-board a new tenant in NetScaler MA Service, 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

  • On the SettingsSubscriptions page, the storage data consumption might appear greater than the entitled storage limit of 5 GB. [# 689330]
  • When you delete the users from Citrix Cloud, the deleted user names continue to appear in NetScaler MA Service in Settings > User Administration > Users. [# 686581]

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

July 23, 2017

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

An upgrade for the NetScaler MA Service 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 NetScaler MA Service 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 NetScaler Management and Analytics Service tile displays the following error "page not available."
[#690267]

Networks

If you have enabled Secure Only access on your NetScaler instances, these instances are not discovered properly in NetScaler MA Service 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 NetScaler MA Service 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 admin user (the first user of your organization to sign up and log on to NetScaler MA Service) has the permission to generate the activation code required to register an agent to the service. A delegated admin (every subsequent user that logs on) does not have the permission to generate the activation code. When a delegated admin clicks Generate Activation Code, the following error appears: "Not Authorized to perform this operation."
    Workaround: Super admin must assign the required permissions to the delegated admin. For details, see How to Assign Additional Permissions to Delegated Admin Users. [#690576]

Analytics

  • On certain occassions, HDX Insight and Gateway Insight nodes might not be displayed on the NetScaler MA Service 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 NetScaler MA Service. [# 688617]
  • Application Dashboard in NetScaler MA Service shows incorrect security metrics for custom-defined applications. [# 689041]

Networks

  • If control proxy is not available during agent start up process, the agent is not able to retrieve the SNMP trap settings from NetScaler Management and Analytics Service and all the traps received from NetScaler instances are dropped.
    Workaround: Run "masd restart" on agent when connectivity to NetScaler Management and Analytics Service has been established. [# 687027]
  • When you configure a rule to monitor specific events in NetScaler MA Service, emails are not sent for the events that match the filter criteria. [# 688985]
  • When you configure a rule to monitor specific events in NetScaler MA Service, 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 NetScaler MA Service, events are not suppressed for the configured time period. [# 688988]
  • When you configure a rule to monitor specific events in NetScaler MA Service, SNMP traps are not sent to external trap destinations. [# 689018]
  • Upgrade NetScaler feature in Maintenance Tasks is not supported in NetScaler MA Service. But, you can still view the option in the GUI. [# 689068]

Settings

  • On the SettingsSubscriptions page, the storage data consumption might appear greater than the entitled storage limit of 5 GB. [# 689330]
  • You might get logged out of NetScaler MA Service abruptly.
    Workaround: Log on to NetScaler MA Service again. [# 689012]
  • When you delete the users from Citrix Cloud, the deleted user names continue to appear in NetScaler MA Service in Settings > User Administration > Users. [# 686581]

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

July 16, 2017

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

Fixed Issues

The following issues have been fixed in this release:

Analytics

  • While using the NetScaler MA Service agent in AWS, analytics data is not displayed as the Telemetry package which contains ULFD features is missing from the agent AMI. [#690225]

  • Exporting reports to PDF/JPEG/PNG is not working in NetScaler MA Service. [# 683778]

  • If you enable Insight from NetScaler MA Service, the check mark next to AppFlow does not appear enabled. However, the configuration to enable AppFlow is pushed to NetScaler instances. [# 688309]

Networks

  • You cannot upload a command file while creating a configuration job, though Networks > Configuration Jobs > Create Job displays the option to upload a file.
    [# 688967]
  • Agent registration fails if you use title case in customer name. For example, Haroldmas, kimiRKN.
    [#689648]

Known Issues

The following known issues exist in this release:

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 NetScaler MA Service. [# 688617]
  • Application Dashboard in NetScaler MA Service shows incorrect security metrics for custom-defined applications. [# 689041]

Networks

  • If control proxy is not available during agent start up process, the agent is not able to retrieve the SNMP trap settings from NetScaler Management and Analytics Service and all the traps received from NetScaler instances are dropped.
    Workaround: Run "masd restart" on agent when connectivity to NetScaler Management and Analytics Service has been established. [# 687027]
  • When you configure a rule to monitor specific events in NetScaler MA Service, emails are not sent for the events that match the filter criteria. [# 688985]
  • When you configure a rule to monitor specific events in NetScaler MA Service, 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 NetScaler MA Service, events are not suppressed for the configured time period. [# 688988]
  • When you configure a rule to monitor specific events in NetScaler MA Service, SNMP traps are not sent to external trap destinations. [# 689018]
  • Upgrade NetScaler feature in Maintenance Tasks is not supported in NetScaler MA Service. But, you can still view the option in the GUI. [# 689068]

Settings

  • On the Settings > Subscriptions page, the storage data consumption might appear greater than the entitled storage limit of 5 GB. [# 689330]
  • You might get logged out of NetScaler MA Service abruptly.
    Workaround: Log on to NetScaler MA Service again. [# 689012]
  • When you delete the users from Citrix Cloud, the deleted user names continue to appear in NetScaler MA Service in Settings > User Administration > Users. [# 686581]

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

June 30, 2017

This is the first release of NetScaler MA Service. For a list of the features available, see Features and Solutions.

The following known issues exist in this release:

Analytics

  • Exporting reports to PDF/JPEG/PNG is not working in NetScaler MA Service. [# 683778]
  • If you enable Insight from NetScaler MA Service, the check mark next to AppFlow does not appear enabled. However, the configuration to enable AppFlow is pushed to NetScaler instances. [# 688309]

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 NetScaler MA Service. [# 688617]
  • Application Dashboard in NetScaler MA Service shows incorrect security metrics for custom-defined applications. [# 689041]

Networks

  • If control proxy is not available during agent startup process, the agent cannot retrieve the SNMP trap settings from NetScaler MA Service, and all the traps received from NetScaler instances are dropped.
    Workaround: Run "masd restart" on agent when connectivity to NetScaler Management and Analytics Service has been established. [# 687027]
  • You cannot upload a command file while creating a configuration job, though Networks > Configuration Jobs > Create Job displays the option to upload a file. [# 688967]
  • When you configure a rule to monitor specific events in NetScaler MA Service, emails are not sent for the events that match the filter criteria. [# 688985]
  • When you configure a rule to monitor specific events in NetScaler MA Service, the 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 NetScaler MA Service, events are not suppressed for the configured time period. [# 688988]
  • When you configure a rule to monitor specific events in NetScaler MA Service, SNMP traps are not sent to external trap destinations. [# 689018]
  • Upgrade NetScaler feature in Maintenance Tasks is not supported in NetScaler MA Service. But, you can still view the option in the GUI. [# 689068]

Settings

  • On the Settings > Subscriptions page, the storage data consumption might appear greater than the entitled storage limit of 5 GB. [# 689330]
  • You might get logged out of NetScaler MA Service abruptly.
    Workaround: Log on to NetScaler MA Service again. [# 689012]
  • When you delete users from Citrix Cloud, the deleted user names continue to appear in NetScaler MA Service in Settings > User Administration > Users. [# 686581]

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