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
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
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 address pools (IIP) for a Citrix Gateway appliance
Upgrade and downgrade a Citrix ADC appliance
Troubleshooting
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
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
配置汽车matic 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 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
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!
Troubleshooting issues related to the installation, upgrade, and downgrade processes
If the appliance does not work as expected after you complete the installation, upgrade, or downgrade process, the first thing to do is to check for the most common causes of the problem.
Resources for troubleshooting
For best results, use the following resources to troubleshoot an issue related to installing, upgrading, or downgrading a Citrix ADC:
- The configuration files from the appliance. In case of a High Availability pair, the configuration files from both appliances.
- The following files from the appliance(s):
- The relevant newnslog files.
- The ns.log file.
- The messages file.
- A network topology diagram.
Issues and resolutions
Following are the most common installation, upgrade, and downgrade issues, and tips for resolving them:
Issue
Upgrading a Citrix ADC MPX appliance fails due to hardware and software incompatibility.
Resolution
See theCitrix ADC MPX hardware-software compatibility matrixand check whether the software release is supported on the Citrix ADC MPX hardware.
Issue
Upgrading a Citrix ADC VPX appliance fails due to Citrix ADC VPX appliance and hypervisor incompatibility.
Resolution
See theCitrix ADC VPX appliance and hypervisor compatibility matrixand check whether the Citrix ADC VPX appliance model is supported on the hypervisor.
Issue
Upgrading a Citrix ADC appliance fails due to hardware errors.
Resolution
Validate the integrity of the Citrix ADC appliance. If you have a Citrix ADC hardware appliance, Citrix recommends running
fsck
运行磁盘切ck and validating the integrity of the Citrix ADC hard drive.For more information, seeHow to Verify the File System Integrity of a Citrix ADC appliance.
Issue
Upgrading a Citrix ADC appliance by using the GUI stalls.
Resolution
Refresh the browser to check whether the upgrade is progressing or not.
Issue
Upgrading a Citrix ADC appliance fails due to low Space in /var Directory
Resolution
Free up space on the /var directory. For more information, see Refer toHow to free space on /var directory.
Issue
The Citrix ADC is not accessible after the software downgrade
Cause
During the software downgrade process, if the configuration file of the existing release and build does not match the configuration file of the earlier release and build, the appliance cannot load the configuration, and the default IP address is assigned to the appliance.
Resolution
- 验证the appliance is accessible from the console.
- 验证:NSIP地址和路线iance.
- If the IP address has changed to the default 192.168.100.1 IP address, change the IP address as required.
- 验证the appliance is accessible.
Issue
During an upgrade, if I run the command for synchronizing, the following message appears:
Command failed on the secondary node but succeeded on the primary node.
Resolution
Do not run any dependent commands (set /unset /bind /unbind) when High Availability (HA) synchronization is in progress.
Issue
During an upgrade process, traffic does not pass through the new primary node when you run the force failover command.
Resolution
- Check for problems with the network topology and the switch configurations.
- Run the set L2param -garpreply ENABLED command to enable the GARP reply.
- Try using virtual MAC if not already used.
- Run the sendarp –a command from the primary node.
Issue
After upgrading or downgrading a Citrix ADC appliance, connecting to the appliance fails through SSH.
Resolution
Perform the following operations in the Citrix ADC appliance:
- Remove old or insecure host keys at
/nsconfig/ssh/ssh_host_*
. - Review the custom SSHD configuration at
/nsconfig/sshd_config
and check if it is still relevant and compatible. Rename or remove the custom SSHD configuration accordingly. - Cold reboot the Citrix ADC appliance
- Remove old or insecure host keys at
Issue
In an HA pair, after you run the force HA failover command the devices keep rebooting. The secondary device does not come up after an upgrade.
Resolution
Check to see if the /var directory is full. If so, remove the old installation files. Run the df –h command to show the available disk space.
Issue
After upgrading an HA pair, one of the nodes is listed as state UNKNOWN.
Resolution
- Check to see if both nodes are running the same build. If the builds are not same and HA nodes have a version mismatch, some of the fields are shown as UNKNOWN when you run the show ha node command.
- Check to see if the secondary appliance is reachable.
Issue
After you upgrade the Citrix ADC, the interface shows most of the load balancing virtual servers and services are DOWN.
Resolution
验证the SNIP address is active on the secondary appliance. Also, type the show service command to see if the service is running.
Issue
After performing an upgrade, all virtual servers are down on the secondary appliance.
Resolution
Enable the HA state and HA synchronization by running the following commands:
- set node hastate enable
- set node hasync enable
Disabling HA is not recommended.
Issue
After performing a downgrade, the Citrix ADC does not boot up properly.
Resolution
Check to see if the correct license has been installed.
Issue
In an HA pair, some features do not get synchronized after an upgrade is performed.
Resolution
Run the sync ha file misc command to synchronize the configurations files from the primary node to secondary node.
Issue
During reboot, the following error message appears:
One or more commands in ns.conf failedWhat should I do?
Resolution
Make sure that no command in the ns.conf file exceeds the 255 byte limit. In commands that create policies that are too long for the 255-byte limit, you can use pattern sets to shorten the policies.
Example:
add cs policy p11 -rule 'HTTP.REQ.URL.ENDSWITH_ANY("ctx_file_extensions")' Done
ctx_file_extensions is a default patset that covers a large number of extensions. In addition to the default pattern sets, you can create user-defined pattern sets. Add a patset by running the following command:
add patset
Note: Patsets are supported only in release 9.3 or later.
Issue
When upgrading a Citrix ADC VPX appliance, I am told to free up space in /var. What files do I remove?
Resolution
Remove the old installation files from /var/tmp/ directory. Also remove unwanted files from /flash.
Issue
There is no connectivity to the graphical user interface (GUI) when you run the force HA failover command on the secondary appliance.
Resolution
Log on to the secondary appliance using the command line interface and enable the access to GUI by running the set ns ip
-gui enabled command. Issue
After performing an upgrade, and when I click on any link on the GUI that has to load a java applet (Upgrade Wizard or license Wizard), the following error message appears:GUI version does not match with the kernel version. Please close this instance, clear java plug-in cache and reopen.
Resolution
- Log on to the Citrix ADC using the GUI.
- Navigate to Citrix ADC Gateway > Global Settings.
- Click Change Global Settings under Settings.
- In the details pane, under Client Experience, select Default from the UI theme list.
- Click OK.
Issue
If upgrading a Citrix ADC appliance failed because of any reason, how to restore the appliance using the backed-up files?
Resolution
If the upgrade is unsuccessful then restore the appliance to the previous version of the Citrix ADC appliance using the backed-up files. For more information, seeBackup and restore a Citrix ADC appliance.
For more information on backup and restore of a Citrix ADC cluster setup, seeBackup and restore of a cluster setup.
Issue
If licenses are missing after a failed upgrade of a Citrix ADC appliance, how to resolve the issue?
Resolution
If any license goes missing or if you want to reallocate the licenses, refer to the following topicLicensing overview.
Note
These troubleshooting steps also apply to issues with configuration loss when downgrading the software across multiple releases.
For any other issue, see the release notes, Knowledge Center articles, and FAQs.
Share
Share
This Preview product documentation is Citrix 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.