Netscaler Notice of Status Change Announcement for Classic Policy Based Features and Functionalities
Article ID: CTX296948
Updated On:
Description
Citrix Systems, Inc. announces a Notice of Status Change (NSC) for Citrix ADC Classic policy-based features and functionalities. The dates and milestones provided are in accordance with stated End of Life/End of Support policies for Citrix Systems, Inc.
Citrix ADC Features & Functionalities Affected
The features & functionalities affected by this announcement and their replacements are listed in Table 1 & 2 (below). The features & functionalities listed in the Feature Replacement column represent the migration path for these discontinued/deprecated features/functionalities.
Table 1. To convert classic policies to advanced policies for the following features and functionalities, reach out to NetScaler customer support
| Feature Description | Feature Replacement |
Citrix ADC features and its functionalities: -
| AppQoE |
| SPDY | HTTP/2 |
| HTMLInjection | AppFlow with Client-Side Measurements |
Table 2. Features & functionalities to be converted to advanced policies using NSPEPI tool
| Feature Description | Feature Replacement |
| Filter | Responder (for ERRORCODE, or DROP or RESET on the request side), Rewrite (for ADD or CORRUPT, or DROP or RESET on the response side), or Content Switching (for FORWARD). |
| Q and S prefixes in Advanced expressions Example - add responder action ract respondwith "Q URL + Q.HEADER(\"abcd\")" | HTTP.REQ and HTTP.RES |
| Application Firewall Classic policy | Application Firewall Advanced policy |
| Compression Classic policy | Compression Advanced policy |
| Classic Cache Redirection policy | Advanced Cache Redirection policy |
| Content Switching Classic policy | Content Switching Advanced policy |
| SSL Classic policy | SSL Advanced policy |
| Pattern function in Rewrite action | -Search Rewrite action parameter |
| SYS.EVAL_CLASSIC_EXPR Classic function | Converting function to Advanced, replacing SYS.EVAL_CLASSIC_EXPR |
| Patclass | Patset |
| BypassSafetyCheck parameter in rewrite action | This parameter is no longer needed in 13.1+ version |
| HTTP.REQ.BODY expression with no arguments | Provide the required body length needs to examine as argument |
| PolicyType Parameter in "set cmp parameter" | Change policytype to Advanced |
| Classic expression in LB rule | Advanced expression in LB rule |
| URL and Domain parameters in Content Switching policy | Content Switching Advanced policy |
Table 3. Features & functionalities that continue to function for classic policies in 13.1 or later releases
| Feature Description |
| Classic Named (policy) expression |
| Classic Audit SYSLOG policy |
| Classic Audit NSLOG policy |
| Classic AAA Pre-authentication policy |
| Authentication Local policy RADIUS Authentication policy LDAP Authentication policy Authentication Negotiate policy SAML Authentication policy Delegation Forms Authentication (DFA) policy Web Authentication policy |
| Classic Authorization policy |
| Classic Traffic Management Session policy |
| Classic Tunnel Traffic policy |
| Classic VPN Traffic policy |
| Classic VPN Session policy |
| Trace Classic expression |
| Client Security expression |
Recommendations for Customers
Citrix recommends that all Citrix ADC customers take steps to switch from the deprecated features & functionalities to the corresponding replacements suggested in Table 1 & 2 above. Customers can convert Classic policy expressions to Advanced policy expressions using nspepi tool.
You can download the NSPEPI and preconfig check tool from the public GitHub. For more information, see GitHub NEPEPI page and README page for detailed instructions to download, install, and use the tools. We recommend customers to use the tools available in GitHub for the most complete and up-to-date version.
Issue/Introduction
Additional Information
- For more information about the change, visit: https://docs.citrix.com/en-us/citrix-adc/current-release/appexpert/policies-and-expressions/introduction-to-policies-and-exp/classic-policy-deprecation-faq.html
- For converting Classic policy expressions to Advanced policy expressions, visit: https://docs.citrix.com/en-us/citrix-adc/current-release/appexpert/policies-and-expressions/introduction-to-policies-and-exp/converting-policy-expressions-nspepi-tool.html
-
Upgrade considerations for configurations with classic policies
-
The above link will help you with the information on how to convert it when upgrading
-
Using -M option while upgrading, the NSPEPI tool is run as part of the installation and converts classic policies to advanced policies.
-
For further information, contact your local Citrix sales representative or authorized Citrix business partner.
