-
Getting Started with Citrix ADC
-
Deploy a Citrix ADC VPX instance
-
Optimize Citrix ADC VPX performance on VMware ESX, Linux KVM, and Citrix Hypervisors
-
Apply Citrix ADC VPX configurations at the first boot of the Citrix ADC appliance in cloud
-
Install a Citrix ADC VPX instance on Microsoft Hyper-V servers
-
Install a Citrix ADC VPX instance on Linux-KVM platform
-
Prerequisites for installing Citrix ADC VPX virtual appliances on Linux-KVM platform
-
Provisioning the Citrix ADC virtual appliance by using OpenStack
-
Provisioning the Citrix ADC virtual appliance by using the Virtual Machine Manager
-
Configuring Citrix ADC virtual appliances to use SR-IOV network interface
-
Configuring Citrix ADC virtual appliances to use PCI Passthrough network interface
-
Provisioning the Citrix ADC virtual appliance by using the virsh Program
-
Provisioning the Citrix ADC virtual appliance with SR-IOV on OpenStack
-
Configuring a Citrix ADC VPX instance on KVM to use OVS DPDK-Based host interfaces
-
-
Deploy a Citrix ADC VPX instance on AWS
-
Deploy a VPX high-availability pair with elastic IP addresses across different AWS zones
-
Deploy a VPX high-availability pair with private IP addresses across different AWS zones
-
Protect AWS API Gateway using the Citrix Web Application Firewall
-
Configure a Citrix ADC VPX instance to use SR-IOV network interface
-
Configure a Citrix ADC VPX instance to use Enhanced Networking with AWS ENA
-
Deploy a Citrix ADC VPX instance on Microsoft Azure
-
Network architecture for Citrix ADC VPX instances on Microsoft Azure
-
Configure multiple IP addresses for a Citrix ADC VPX standalone instance
-
Configure a high-availability setup with multiple IP addresses and NICs
-
Configure a high-availability setup with multiple IP addresses and NICs by using PowerShell commands
-
Deploy a Citrix ADC high-availability pair on Azure with ALB in the floating IP-disabled mode
-
Configure a Citrix ADC VPX instance to use Azure accelerated networking
-
Configure HA-INC nodes by using the Citrix high availability template with Azure ILB
-
Configure a high-availability setup with Azure external and internal load balancers simultaneously
-
Configure a Citrix ADC VPX standalone instance on Azure VMware solution
-
Configure a Citrix ADC VPX high availability setup on Azure VMware solution
-
Deploy Citrix ADC GSLB and domain-based services back-end autoscale with cloud load balancer
-
Configure address pools (IIP) for a Citrix Gateway appliance
-
Deploy a Citrix ADC VPX instance on Google Cloud Platform
-
Deploy a VPX high-availability pair on Google Cloud Platform
-
Deploy a VPX high-availability pair with external static IP address on Google Cloud Platform
-
Deploy a single NIC VPX high-availability pair with private IP address on Google Cloud Platform
-
Deploy a VPX high-availability pair with private IP addresses on Google Cloud Platform
-
Install a Citrix ADC VPX instance on Google Cloud VMware Engine
-
-
Upgrade and downgrade a Citrix ADC appliance
-
Solutions for Telecom Service Providers
-
Load Balance Control-Plane Traffic that is based on Diameter, SIP, and SMPP Protocols
-
Provide Subscriber Load Distribution Using GSLB Across Core-Networks of a Telecom Service Provider
-
Authentication, authorization, and auditing application traffic
-
Basic components of authentication, authorization, and auditing configuration
-
On-premises Citrix Gateway as an identity provider to Citrix Cloud
-
Authentication, authorization, and auditing configuration for commonly used protocols
-
Troubleshoot authentication and authorization related issues
-
-
-
-
-
-
Persistence and persistent connections
-
Advanced load balancing settings
-
Gradually stepping up the load on a new service with virtual server–level slow start
-
Protect applications on protected servers against traffic surges
-
Retrieve location details from user IP address using geolocation database
-
Use source IP address of the client when connecting to the server
-
Use client source IP address for backend communication in a v4-v6 load balancing configuration
-
Set a limit on number of requests per connection to the server
-
Configure automatic state transition based on percentage health of bound services
-
-
Use case 2: Configure rule based persistence based on a name-value pair in a TCP byte stream
-
Use case 3: Configure load balancing in direct server return mode
-
Use case 6: Configure load balancing in DSR mode for IPv6 networks by using the TOS field
-
Use case 7: Configure load balancing in DSR mode by using IP Over IP
-
Use case 10: Load balancing of intrusion detection system servers
-
Use case 11: Isolating network traffic using listen policies
-
Use case 12: Configure Citrix Virtual Desktops for load balancing
-
Use case 13: Configure Citrix Virtual Apps and Desktops for load balancing
-
Use case 14: ShareFile wizard for load balancing Citrix ShareFile
-
Use case 15: Configure layer 4 load balancing on the Citrix ADC appliance
-
-
-
Authentication and authorization for System Users
-
-
Configuring a CloudBridge Connector Tunnel between two Datacenters
-
Configuring CloudBridge Connector between Datacenter and AWS Cloud
-
Configuring a CloudBridge Connector Tunnel Between a Datacenter and Azure Cloud
-
Configuring CloudBridge Connector Tunnel between Datacenter and SoftLayer Enterprise Cloud
-
Configuring a CloudBridge Connector Tunnel Between a Citrix ADC Appliance and Cisco IOS Device
-
CloudBridge Connector Tunnel Diagnostics and Troubleshooting
-
-
Synchronizing Configuration Files in a High Availability Setup
-
Restricting High-Availability Synchronization Traffic to a VLAN
-
Understanding the High Availability Health Check Computation
-
Managing High Availability Heartbeat Messages on a Citrix ADC Appliance
-
Remove and Replace a Citrix ADC in a High Availability Setup
This content has been machine translated dynamically.
Dieser Inhalt ist eine maschinelle Übersetzung, die dynamisch erstellt wurde. (Haftungsausschluss)
Cet article a été traduit automatiquement de manière dynamique. (Clause de non responsabilité)
Este artículo lo ha traducido una máquina de forma dinámica. (Aviso legal)
此内容已经过机器动态翻译。 放弃
このコンテンツは動的に機械翻訳されています。免責事項
이 콘텐츠는 동적으로 기계 번역되었습니다. 책임 부인
Este texto foi traduzido automaticamente. (Aviso legal)
Questo contenuto è stato tradotto dinamicamente con traduzione automatica.(Esclusione di responsabilità))
This article has been machine translated.
Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)
Ce article a été traduit automatiquement. (Clause de non responsabilité)
Este artículo ha sido traducido automáticamente. (Aviso legal)
この記事は機械翻訳されています.免責事項
이 기사는 기계 번역되었습니다.책임 부인
Este artigo foi traduzido automaticamente.(Aviso legal)
这篇文章已经过机器翻译.放弃
Questo articolo è stato tradotto automaticamente.(Esclusione di responsabilità))
Translation failed!
Release Notes for Citrix ADC 13.1–30.52 Release
This release notes document describes the enhancements and changes, fixed and known issues that exist for the Citrix ADC release Build 13.1–30.52.
Notes
This release notes document does not include security-related fixes. For a list of security-related fixes and advisories, see the Citrix security bulletin.
What’s New
The enhancements and changes that are available in Build 13.1–30.52.
Networking
Asdot format support for 4-byte BGP ASN
The Citrix ADC appliance now supports configuring and displaying 4-byte BGP autonomous system numbers (ASN) in the asdot format as defined in RFC 5396. The Citrix ADC appliance overall supports the following two formats for BGP ASNs:
-
asplain - Decimal value notation where both 2-byte and 4-byte ASNs are represented by their decimal value. For example, 65527 is a 2-byte ASN and 234567 is a 4-byte ASN.
-
asdot - Autonomous system dot notation where 2-byte ASNs are represented by their decimal value (same as in asplain), and 4-byte ASNs are represented by a dot notation. For example, 65527 is a 2-byte ASN and 3.37959 is a 4-byte ASN. (3.37959 is asdot format for the 234567 decimal number).
[ NSNET-26101 ]
Amazon Linux 2 on AWS cloud support for Citrix ADC BLX appliances
The Citrix ADC BLX appliance is now supported on Amazon Linux 2 on the AWS cloud. The Citrix ADC BLX supports running with AWS Elastic Network Adapters (ENA) as DPDK ports on Amazon Linux 2.
[ NSNET-25802 ]
Even distribution of monitor probes on available routes
From 13.1-30.x, the Citrix ADC appliance uses the hashing algorithm based on the following five tuples to select a route for a load balancing monitor probe.
- Source IP address
- Source Port
- Destination IP address
- Destination Port
- Protocol number
The selection of routes based on five tuples information ensures even distribution of monitor probes on the available routes. This even distribution prevents the overloading of traffic in a route.
For more information, see https://docs.citrix.com/en-us/citrix-adc/current-release/networking/ip-routing/route-selection-based-on-five-tuples.html.
[ NSNET-24646 ]
SSL
Support for OCSP multi-stapling solution
When TLS 1.3 protocol is used, all the intermediate certificates now include the OCSP response extension in the response to the status request from the client. Earlier, only the server certificate included this extension in the response to the status request from the client.
[ NSSSL-9281 ]
User Interface
Optimized the show ns licenseserverpool
command to fetch licenses in lesser time
When you run the show ns licenseserverpool
command, it takes lesser time in fetching the licenses. A new parameter licensemode
is added to the add ns licenseserver
command to specify the license mode. So, the show ns licenseserverpool
command displays only licenses based on the specified license mode. If you want an inventory of all the licenses, use the show ns licenseserverpool -get alllicenses
command.
Earlier, the show ns licenseserverpool
command used to display all the licenses irrespective of license mode that is configured. As a result, the command was taking more time in fetching all the licenses.
For more information, see https://docs.citrix.com/en-us/citrix-adc/current-release/licensing.html#citrix-adc-self-managed-pool-license
[ NSCONFIG-6961 ]
Support for Self Managed Pool license
The Citrix ADC appliance now supports the Self Managed Pool license, which simplifies and automates license file uploads to license server after the purchase. You can use Citrix ADM to create a licensing framework that comprises of a common bandwidth or vCPU and the instance pool.
For more information, see https://docs.citrix.com/en-us/citrix-adc/current-release/licensing.html#citrix-adc-self-managed-pool-license
[ NSCONFIG-6592 ]
Support for Citrix ADC CPX license aggregator
Now, you can use Citrix ADC CPX license aggregator, a new Kubernetes micro service provided by Citrix, to obtain licenses for Citrix ADC CPX. When you start Citrix ADC CPX, you should configure the environment variable CLA with the IP address or domain name of the Citrix ADC CPX license aggregator. If the environment variable is configured, Citrix ADC CPX license aggregator checks out the aggregate licenses for all the connected Citrix ADC CPXs.
[ NSCONFIG-6394 ]
Fixed Issues
The issues that are addressed in Build 13.1–30.52.
Authentication, authorization, and auditing
The Citrix ADC appliance might crash if the SAML metadata URL in the configuration does not end with or contains backslash ( / ).
[ NSHELP-31937 ]
If you have configured a syslog server, you see a single SAML-related log in two lines.
[ NSHELP-31750 ]
There might be issues with application rewrite while applying rewrite policies for content security policy (CSP) on an authentication-virtual server.
[ NSHELP-31583 ]
Non-ASCII characters are recorded in nsvpn.log when LDAP action is configured to an FQDN instead of an IP address.
[ NSHELP-27281 ]
The Citrix ADC GUI does not display the default cache policies bound to a VPN virtual server.
[ NSHELP-26874 ]
Citrix ADC SDX Appliance
In a Citrix ADC SDX appliance, creating or editing the system groups fail.
[ NSHELP-32359 ]
The Citrix ADC SDX appliance does not send SNMP traps for hypervisor disk usage to Citrix ADM.
[ NSHELP-32323 ]
In a Citrix ADC SDX appliance, the VLAN whitelist is not updated with the correct value for the Mellanox interfaces assigned to a Citrix ADC VPX instance.
[ NSHELP-31849 ]
When you upgrade a Citrix SDX appliance, even though the hypervisor version is same for both the current and the upgraded SDX versions, the following incorrect event is notified in the Management Service GUI:
SVM and Hypervisor version mismatch
[ NSHELP-31769 ]
Installing an SSL certificate on a Citrix ADC SDX appliance fails if the certificate name or key name contains any space.
[ NSHELP-31711 ]
Sometimes, upload of the post-install script file (postinst.sh) to Citrix Hypervisor fails during platform upgrade, when you upgrade the Citrix ADC SDX appliance from 13.0 to 13.1 firmware.
[ NSHELP-31125 ]
Citrix Gateway
In a cluster setup, the Citrix ADC appliance crashes while sending the CGP_FINISH_REQUEST request to the client.
[ NSHELP-32029 ]
Sometimes, a Citrix ADC appliance might crash while assigning an Intranet IP address to a client.
[ NSHELP-31712 ]
The policy-based routing (PBR) policies do not take effect for DNS traffic over VPN.
[ NSHELP-31123 ]
When classic EPA policy and nFactor auth are configured, the Gateway Insight events for successful authentication are not sent to Citrix Application Delivery Management.
[ NSHELP-30901 ]
You might see an extra line for NS_AUDITLOG_STR* logs in the ns_aaa_json.c file.
[ NSHELP-28160 ]
You cannot unbind a classic authorization policy by using the GUI. However, you can use the CLI to unbind the Authentication, authorization, and auditing authorization policy.
With this fix, you can now unbind the authorization policy by using the GUI.
[ NSHELP-27064 ]
The Gateway Insight does not display accurate information on the VPN users.
[ NSHELP-23937 ]
The logs flagging vulnerability do not capture the source IP address of the client. These logs are:
- Dropping HTTP request with invalid header/version
- Path traversal detected
- Found ‘/vpns/’ in unwanted place
- Dropping invalid HTTP request
[ CGOP-18190 ]
Citrix Web App Firewall
On a Citrix ADC appliance, the console might be flooded with log messages and the appliance might send DNS queries to the Webroot public cloud service provider. This happens because the IP Reputation feature, when disabled, is running every five minutes instead of once every 24 hours.
[ NSWAF-9299 ]
Load Balancing
A Citrix ADC appliance might crash and dump core if the user monitor script returns a response with more than 1024 bytes.
[ NSHELP-32097 ]
In rare cases, a Citrix ADC appliance might crash and dump core if DNSSEC processing is enabled and DNS zone configuration is present.
[ NSHELP-31993 ]
Due to a rare race condition, there might be inconsistencies between the local site and the remote site. This inconsistency might be due to the remote site not learning the dynamic member from the local site.
The removal of dynamic members on the remote site might be unsuccessful due to an issue while communicating between packet engines.
[ NSHELP-31982 ]
SNMP WALK requests corresponding to the vserverAdvanceSslConfigTable OID result in a core dump when the priority order of virtual servers is configured.
[ NSHELP-31704 ]
Networking
A Citrix ADC BLX appliance with DPDK might fail to restart if the following condition is met:
- The Citrix ADC BLX appliance is allocated with a high number of
hugepages
. For example, 16 GB.
The issue is logged as an error message in /var/log/ns.log
:
EAL: rte_mem_virt2phy(): cannot open /proc/self/pagemap: Too many open files
[ NSNET-24727 ]
With ECMP configured on a Citrix ADC appliance, the following issue might be observed for an SSH load balancing connection:
- The Citrix ADC appliance sends the first packet through a different route than for the rest of the packets of the same flow.
[ NSHELP-32089 ]
The Citrix ADC appliance might crash in some scenarios when the following conditions are met:
- The Citrix ADC appliance receives multiple first fragments with different offsets.
- The Citrix ADC appliance does not reassemble the fragments.
[ NSHELP-32084 ]
In a load balancing configuration with sessionless
option enabled on the virtual server and ECMP on the server side, the following issue might be observed:
- The Citrix ADC appliance sends the packets to a server always through the same route.
[ NSHELP-32061 ]
In a large scale NAT44 setup, the Citrix ADC appliance might crash while receiving SIP traffic because of the following reason:
- Because of stale filtering entry.
[ NSHELP-28895 ]
Platform
On a Citrix ADC SDX appliance, the ring size is increased from 1024 to 2048 entries for the Mellanox interfaces.
[ NSPLAT-24539 ]
The log rotation fails for files stored in the /var/log/waagent folder and takes up more disk space. This failure is seen when you apply a backup configuration taken from a Citrix ADC VPX instance on another ADC VPX instance hosted on the Azure cloud using the restore functionality.
[ NSHELP-31599 ]
From Citrix ADC release 13.1 onwards, the Citrix ADC appliance fails to boot up in an ESXi hypervisor with more than 8 VMXNET3 network interfaces.
[ NSHELP-31266 ]
Policies
In a Citrix ADC appliance, following is observed.
- Issues related to memory accounting in some unusual cases.
- Issues related to memory allocation/deallocation of certain entities.
Also tracking of allocation/deallocation of certain entities was added/improved.
[ NSHELP-29215 ]
SSL
When both RSA and ECDSA certificate-key pairs are bound to a virtual server and the peer supports a compatible signature algorithm, the TLS 1.3 server selects the ECDSA certificate-key pair. Previously, the TLS 1.3 server selected the RSA certificate-key pair. With this change, the TLS 1.3 server now behaves the same as the TLS 1.2 server.
[ NSSSL-11650 ]
The TLS 1.3 server returns a decode_error
alert when it encounters a TLS 1.3 handshake message that is split (fragmented) across multiple TLS records. This may have an impact on successful handshake completion if the client is authenticating with a certificate and the client’s certificate is larger than the maximum TLS record size (approx. 16 KB).
[ NSSSL-2940 ]
An SSL handshake might fail if the following sequence of conditions is met:
- Hello Verify Request (HVR) is enabled on DTLS.
- The Citrix ADC appliance sends an HVR to the client.
- The client does not receive the HVR.
- The client tries to retransmit the first client hello instead of responding to the HVR with a session cookie.Note: In response to the retransmitted client hello message, the ADC appliance sends the HVR to the client a maximum of three times. If a proper response is not received, the appliance fails the handshake.
[ NSHELP-31808 ]
A Citrix ADC appliance configured to process SSL traffic might crash if the memory utilization exceeds 80%.
[ NSHELP-29996 ]
System
A Citrix ADC appliance crashes in the syslog action configuration flow. This crash is observed during High Availability synchronization on the secondary node.
[ NSHELP-32254, NSHELP-32397 ]
In a Citrix ADC appliance, the default value of the maxHeaderFieldLen
parameter in the HTTP profile causes the following issue.
- Traffic failure after upgrading to 13.0 build.
[ NSHELP-32079 ]
A Citrix ADC appliance might crash when AppFlow is enabled only on the client side.
[ NSHELP-31892 ]
A Citrix ADC appliance might crash when the following condition is met:
- Both analytics profile and AppFlow policy are bound, and the profile has the
httpAllHdrs
option enabled.
[ NSHELP-30628 ]
In a Citrix ADC appliance, the following issue is observed when enabling the HTTP/2 configuration for a content switching or load balancing virtual IP(VIP).
- An increase in latency of up to 100 ms while forwarding the HTTP/2 header and data frames to the website through the Citrix ADC appliance.
[ NSHELP-30094 ]
User Interface
In a High Availability (HA) setup, while fetching the local IP address for the nsconf tool, the following issue is observed.
- Local host connection login failure. This failure happens if the RPC node password is different for primary and secondary nodes in the HA setup.
[ NSHELP-32083 ]
The following exception is seen in the Python API SDK while trying to delete an SSL virtual server and certificate-key pair binding. TypeError: cannot concatenate ‘str’ and ‘bool’ objects
[ NSHELP-31746 ]
Load balancing server statistics details are misaligned in the Citrix ADC GUI dashboard.
[ NSHELP-20752 ]
Known Issues
The issues that exist in release 13.1–30.52.
AppFlow
HDX Insight does not report an application launch failure caused by a user trying to launch an application or desktop to which the user does not have access.
[ NSINSIGHT-943 ]
Authentication, authorization, and auditing
A Citrix ADC appliance does not authenticate duplicate password login attempts and prevents account lockouts.
[ NSHELP-563 ]
The DualAuthPushOrOTP.xml LoginSchema is not appearing properly in the login schema editor screen of Citrix ADC GUI.
[ NSAUTH-6106 ]
ADFS proxy profile can be configured in a cluster deployment. The status for a proxy profile is incorrectly displayed as blank upon issuing the following command.
show adfsproxyprofile <profile name>
Workaround:
Connect to the primary active Citrix ADC in the cluster and run the show adfsproxyprofile <profile name>
command. It would display the proxy profile status.
[ NSAUTH-5916 ]
The Configure Authentication LDAP Server page on the Citrix ADC GUI becomes unresponsive if you pursue the following steps:
- The Test LDAP Reachability option is opened.
- Invalid login credentials are populated and submitted.
- Valid login credentials are populated and submitted.
Workaround:
Close and open the Test LDAP Reachability option.
[ NSAUTH-2147 ]
Citrix ADC SDX Appliance
On a Citrix ADC SDX appliance, if the CLAG is created on a Mellanox NIC, the CLAG MAC is changed when the VPX instance is restarted. Traffic to the VPX instance stops after restart because the MAC table has the old CLAG MAC entry.
[ NSSVM-4333 ]
Citrix Gateway
On a MAC device using Chrome, the VPN extension crashes while accessing two FQDNs.
[ NSHELP-32144 ]
Direct connections to the resources outside of the tunnel established by Citrix Secure Access might fail if there is a significant delay or congestion.
[ NSHELP-31598 ]
When Always on is configured, the user tunnel fails because of the incorrect version number (1.1.1.1) in the aoservice.exe file.
[ NSHELP-30662 ]
Users cannot connect to the Citrix Gateway appliance after changing the ‘networkAccessOnVPNFailure’ always on profile parameter from ‘fullAccess’ to ‘onlyToGateway`.
[ NSHELP-30236 ]
The gateway home page is not displayed immediately after the gateway plug-in establishes the VPN tunnel successfully. To fix this issue, the following registry value is introduced.
\HKLM\Software\Citrix\Secure Access Client\SecureChannelResetTimeoutSeconds Type: DWORD
By default, this registry value is not set or added. When the value of SecureChannelResetTimeoutSeconds
is 0 or not added, the fix to handle the delay does not work, which is the default behavior. Admin has to set this registry on the client to enable the fix (that is to display the home page immediately after the gateway plug-in establishes the VPN tunnel successfully).
[ NSHELP-30189 ]
The Windows VPN client does not honor the ‘SSL close notify’ alert from the server and sends the transfer login request on the same connection.
[ NSHELP-29675 ]
Sometimes, the server validation code fails when the server certificate is trusted. As a result, end users cannot access the gateway.
[ NSHELP-28942 ]
You might notice some Citrix internal IP addresses in the rdx.js file.
[ NSHELP-28682 ]
Client certificate authentication fails for Citrix SSO for macOS if there are no client certificates in the macOS Keychain.
[ NSHELP-28551 ]
Sometimes, a user is logged out of Citrix Gateway within a few seconds when the client idle timeout is set.
[ NSHELP-28404 ]
EPA plug-in for Windows does not use local machine’s configured proxy and connects directly to the gateway server.
[ NSHELP-24848 ]
VPN plug-in doesn’t establish tunnel after Windows Logon, if the following conditions are met:
- Citrix Gateway appliance is configured for Always On feature
- The appliance is configured for certificate-based authentication with two factor authentication
off
[ NSHELP-23584 ]
Sometimes while browsing through schemas, the error message Cannot read property 'type' of undefined
appears.
[ NSHELP-21897 ]
If you would like to use Always On VPN before Windows Logon functionality, it is recommended to upgrade to Citrix Gateway 13.0 or later. This enables you to use the additional enhancements introduced in release 13.0 that are not available in the 12.1 release.
[ CGOP-19355 ]
Application launch failure due to invalid STA ticket is not reported in Gateway Insight.
[ CGOP-13621 ]
The Gateway Insight report incorrectly displays the value Local
instead of SAML
in the Authentication Type field for SAML error failures.
[ CGOP-13584 ]
In a high availability setup, during Citrix ADC failover, SR count increments instead of the failover count in Citrix ADM.
[ CGOP-13511 ]
When an ICA connection is launched from a MAC receiver version 19.6.0.32 or Citrix Virtual Apps and Desktops version 7.18, HDX Insight feature is disabled.
[ CGOP-13494 ]
When EDT Insight feature is enabled, sometimes audio channels might fail during network discrepancy.
[ CGOP-13493 ]
While accepting local host connections from the browser, the Accept Connection dialog box for macOS displays content in the English language irrespective of the language selected.
[ CGOP-13050 ]
The text Home Page
in the Citrix SSO app > Home page is truncated for some languages.
[ CGOP-13049 ]
An error message appears when you add or edit a session policy from the Citrix ADC GUI.
[ CGOP-11830 ]
In Outlook Web App (OWA) 2013, clicking Options under the Setting menu displays a Critical error dialog box. Also, the page becomes unresponsive.
[ CGOP-7269 ]
Load Balancing
In a high-availability setup, subscriber sessions of the primary node might not be synchronized to the secondary node. This is a rare case.
[ NSLB-7679 ]
In a High Availability (HA) setup, routes are dropped on the new primary node and not learned again when the following condition is met.
- Dynamic Route deletion and HA failover happens at the same time because of critical interface failure.
[ NSHELP-32264 ]
The serviceGroupName format in the entityofs
trap for the service group is as follows:
<service(group)name>?<ip/DBS>?<port>
In the trap format, the service group is identified by an IP address or a DBS name and port. The question mark (?
) is used as a separator. The Citrix ADC sends the trap with the question mark (?
). The format appears the same in the Citrix ADM GUI. This is the expected behavior.
[ NSHELP-28080 ]
In certain scenarios, servers bound to a service group display an invalid cookie value. You can see the correct cookie value in the trace logs.
[ NSHELP-21196 ]
Miscellaneous
When a forced synchronization takes place in a high availability setup, the appliance runs the set urlfiltering parameter
command in the secondary node.
As a result, the secondary node skips any scheduled update until the next scheduled time mentioned in the TimeOfDayToUpdateDB
parameter.
[ NSSWG-849 ]
AlwaysOnAllow list registry does not work as expected if the registry value is greater than 2000 bytes.
[ NSHELP-31836 ]
A Citrix ADC appliance might restart because of management CPU stagnation if connectivity issue occurs with the URL Filtering third party vendor.
[ NSHELP-22409 ]
Networking
In a Citrix ADC BLX appliance with DPDK support, tagged VLANs are not supported for DPDK Intel i350 NIC ports. This is observed as it is a known issue present on the DPDK driver.
[ NSNET-25299 ]
A Citrix ADC BLX appliance with DPDK might fail to restart if all of the following conditions are met:
- The Citrix ADC BLX appliance is allocated with a low number of
hugepages
. For example, 1G. - The Citrix ADC BLX appliance is allocated with a high number of worker-process. For example, 28.
The issue is logged as an error message in /var/log/ns.log
:
BLX-DPDK:DPDK Mempool could Not be Initialized for PE-x
Note: x is a number <= number of worker-processes.
Workaround:
Allocate a high number of hugepages
and then restart the appliance.
[ NSNET-25173 ]
A Citrix ADC BLX appliance in DPDK mode might take a little longer to restart because of the DPDK easiness functionality.
[ NSNET-24449 ]
The following interface operations are not supported for Intel X710 10G (i40e)
interfaces on a Citrix ADC BLX appliance with DPDK:
- Disable
- Enable
- Reset
[ NSNET-16559 ]
Installation of a Citrix ADC BLX appliance might fail on a Debian based Linux host (Ubuntu version 18 and later) with the following dependency error:
The following packages have unmet dependencies: blx-core-libs:i386 : PreDepends: libc6:i386 (>= 2.19) but it is not installable
Workaround:
Run the following commands in the Linux host CLI before installing a Citrix ADC BLX appliance:
- dpkg –add-architecture i386
- apt-get update
- apt-get dist-upgrade
- apt-get install libc6:i386
[ NSNET-14602 ]
In some cases of FTP data connections, the Citrix ADC appliance performs only NAT operation and not TCP processing on the packets for TCP MSS negotiation. As a result, the optimal interface MTU is not set for the connection. This incorrect MTU setting results in fragmentation of packets and impacts CPU performance.
[ NSNET-5233 ]
When an admin partition memory limit is changed in Citrix ADC appliance, the TCP buffering memory limit gets automatically set to admin partition new memory limit.
[ NSHELP-21082 ]
Platform
When you upgrade from 13.0/12.1/11.1 builds to a 13.1 build or downgrade from a 13.1 build to 13.0/12.1/11.1 builds, some python packages are not installed on the Citrix ADC appliances. This issue is fixed for the following Citrix ADC versions:
- 13.1-4.x
- 13.0–82.31 and later
- 12.1–62.21 and later
The python packages are not installed, when you downgrade the Citrix ADC versions from 13.1-4.x to any of the following versions:
- Any 11.1 build
- 12.1–62.21 and earlier
- 13.0-81.x and earlier
[ NSPLAT-21691 ]
In a cluster setup on a Citrix ADC SDX appliance, there is a CLAG MAC mismatch on the second node and CLIP if the following conditions are met:
- The CLAG is created on a Mellanox NIC.
- You add another VPX instance to the cluster and CLAG setup.
As a result, traffic to the VPX instance stops.
[ NSPLAT-21049 ]
In a cluster setup on a Citrix ADC SDX appliance, the first node goes DOWN because of a MAC address mismatch on CLIP and MAC table, if the following conditions are met:
- The CLAG is created on a Mellanox NIC.
- You remove the second node from the cluster.
[ NSPLAT-21042 ]
When you delete an autoscale setting or a VM scale set from an Azure resource group, delete the corresponding cloud profile configuration from the Citrix ADC instance. Use the rm cloudprofile
command to delete the profile.
[ NSPLAT-4520 ]
In a high availability setup on Azure, upon logon to the secondary node through GUI, the first-time user (FTU) screen for autoscale cloud profile configuration appears. Workaround: Skip the screen, and log on to the primary node to create the cloud profile. The cloud profile must be always configured on the primary node.
[ NSPLAT-4451 ]
Policies
Connections might hang if the size of processing data is more than the configured default TCP buffer size.Workaround: Set the TCP buffer size to maximum size of data that needs to be processed.
[ NSPOLICY-1267 ]
SSL
On a heterogeneous cluster of Citrix ADC SDX 22000 and Citrix ADC SDX 26000 appliances, there is a config loss of SSL entities if the SDX 26000 appliance is restarted.
Workaround:
- On the CLIP, disable SSLv3 on all the existing and new SSL entities, such as virtual server, service, service group, and internal services. For example,
set ssl vserver <name> -SSL3 DISABLED
. - Save the configuration.
[ NSSSL-9572 ]
You cannot add an Azure Key Vault object if an authentication Azure Key Vault object is already added.
[ NSSSL-6478 ]
You can create multiple Azure Application entities with the same client ID and client secret. The Citrix ADC appliance does not return an error.
[ NSSSL-6213 ]
The following incorrect error message appears when you remove an HSM key without specifying Key Vault as the HSM type. ERROR: crl refresh disabled
[ NSSSL-6106 ]
Session Key Auto Refresh incorrectly appears as disabled on a cluster IP address. (This option cannot be disabled.)
[ NSSSL-4427 ]
An incorrect warning message, Warning: No usable ciphers configured on the SSL vserver/service,
appears if you try to change the SSL protocol or cipher in the SSL profile.
[ NSSSL-4001 ]
An expired session ticket is honored on a non-CCO node and on an HA node after an HA failover. [ NSSSL-3184, NSSSL-1379, NSSSL-1394 ]
After upgrading a Citrix ADC SDX appliance to release 13.1 build 21.50 or later, SSL decryption and MAC comparison might fail. As a result, you might see SSL handshake failures, VPX status flapping, unavailability of the VPX instance GUI, and virtual servers and application going down.
Note: This issue is observed on the SDX 8900, SDX 15000, SDX 15000-50G, SDX 26000, and SDX 26000-50S platforms.
[ NSHELP-31672 ]
System
The MAX_CONCURRENT_STREAMS value is set to 100 by default if the appliance does not receive the max_concurrent_stream settings frame from the client.
[ NSHELP-21240 ]
The mptcp_cur_session_without_subflow counters incorrectly decrement to a negative value instead of zero.
[ NSHELP-10972 ]
In a cluster deployment, if you run force cluster sync
command on a non-CCO node, the ns.log file contains duplicate log entries. [ NSBASE-16304, NSGI-1293 ]
When you install Citrix ADM on a Kubernetes cluster, it does not work as expected because the required processes might not come up.
Workaround: Reboot the Management pod.
[ NSBASE-15556 ]
Client IP and Server IP are inverted in HDX Insight SkipFlow record when LogStream transport type is configured for Insight.
[ NSBASE-8506 ]
The Citrix ADC appliance configured with an SSL service crashes when the appliance receives a TCP FIN control packet followed by a TCP RESET control packet.
[ NSHELP-31656 ]
User Interface
For the MQTT Rewrite feature, you cannot delete an expression using the Expression Editor in the GUI.
Workaround:
Use the add or edit action command of type MQTT through the CLI.
[ NSUI-18049 ]
In Citrix ADC GUI, the Help
link present under the Dashboard
tab is broken.
[ NSUI-14752 ]
Create/Monitor CloudBridge Connector wizard might become unresponsive or fails to configure a cloudbridge connector.
Workaround:
Configure cloudbridge connectors by adding IPsec profiles, IP tunnels, and PBR rules by using the Citrix ADC GUI or CLI.
[ NSUI-13024 ]
If you create an ECDSA key by using the GUI, the type of curve is not displayed.
[ NSUI-6838 ]
In a high availability setup, VPN user sessions get disconnected if the following condition is met:
- If two or more successive manual HA failover operations are performed when HA synchronization is in progress.
Workaround:
Perform successive manual HA failover only after the HA synchronization is completed (Both the nodes are in Sync success state).
[ NSHELP-25598 ]
In a high availability setup of Citrix ADC BLX appliances, the primary node might become unresponsive blocking any CLI or API request.
Workaround:
Restart the primary node.
[ NSCONFIG-6601 ]
If you (system administrator) perform all the following steps on a Citrix ADC appliance, the system users might fail to log in to the downgraded Citrix ADC appliance.
-
Upgrade the Citrix ADC appliance to one of the builds:
- 13.0 52.24 build
- 12.1 57.18 build
- 11.1 65.10 build
- Add a system user, or change the password of an existing system user, and save the configuration.
- Downgrade the Citrix ADC appliance to any older build.
To display the list of these system users by using the CLI:
At the command prompt, type:
query ns config -changedpassword [-config <full path of the configuration file (ns.conf)>]
Workaround:
To fix this issue, use one of the following independent options:
- If the Citrix ADC appliance is not yet downgraded (step 3 in above mentioned steps), downgrade the Citrix ADC appliance using a previously backed up configuration file (ns.conf) of the same release build.
- Any system administrator whose password was not changed on the upgraded build, can log in to the downgraded build, and update the passwords for other system users.
- If none of the above options work, a system administrator can reset the system user passwords.
For more information, see https://docs.citrix.com/en-us/citrix-adc/13/system/ns-ag-aa-intro-wrapper-con/ns-ag-aa-reset-default-amin-pass-tsk.html
[ NSCONFIG-3188 ]
Share
Share
In this article
This Preview product documentation is Citrix Confidential.
You agree to hold this documentation confidential pursuant to the terms of your Citrix Beta/Tech Preview Agreement.
The development, release and timing of any features or functionality described in the Preview documentation remains at our sole discretion and are subject to change without notice or consultation.
The documentation is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making Citrix product purchase decisions.
If you do not agree, select Do Not Agree to exit.