NetScaler Console service

Force a failover to the secondary NetScaler instance

January 8, 2024

Contributed by:

You might want to force a failover if, for example, you need to replace or upgrade the primary Citrix Application Delivery Controller (NetScaler) instance. You can force failover from either the primary instance or the secondary instance. When you force a failover on the primary instance, the primary becomes the secondary and the secondary becomes the primary. Forced failover is only possible when the primary instance can determine that the secondary instance is UP.

A forced failover is not propagated or synchronized. To view the synchronization status after a forced failover, you can view the status of the instance.

A forced failover fails in any of the following circumstances:

You force failover on a standalone system.
The secondary instance is disabled or inactive. If the secondary instance is in an inactive state, you must wait for its state to be UP to force a failover.
The secondary instance is configured to remain secondary.

The NetScaler instance displays a warning message if it detects a potential issue when you run the force failover command. The message includes the information that triggered the warning, and requests confirmation before proceeding.

You can force a failover on a primary instance or on a secondary instance.

To force a failover to the secondary NetScaler instance using NetScaler Console:

In NetScaler Console, navigate to Infrastructure > Instances. Go to VPX tab and select an instance.
Select instances in an HA setup from the instances listed under the selected instance type.
From the Action box, select Force Failover.
Click Yes to confirm the force failover action.

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group 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 Cloud Software Group 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 Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this helpful

Force a failover to the secondary NetScaler instance

January 8, 2024

Contributed by:

January 8, 2024

Contributed by:

Force a failover to the secondary NetScaler instance

In this article