Provides instructions for manually failing over a Data Gateway instance during planned maintenance, including prerequisites, permission requirements, UI steps, maintenance mode options, and IPv6 considerations during standby takeover.
When you have a planned maintenance schedule, you can initiate a failover from an instance to a standby instance residing within the same pool.
Before you begin
Before initiating a failover in a Data Gateway pool, ensure that you are aware of the considerations:
-
Manual failover cannot be attempted on a Data Gateway for which the autofailover is in-progress.
-
Crosswork allows only one failover request at a time. It does not support multiple failover requests simultaneously.
-
Confirm that at least one instance has the operational state as NOT_READY. Crosswork considers this instance as the standby on which the failover happens.
-
At least one spare Data Gateway should be present in both the standby and active cluster, with the status of NOT_READY.
-
A Data Gateway in maintenance mode cannot be used as a spare for future failover procedures until its administration state is UP.
-
Ensure that you have the READ and WRITE permissions for the Data Gateway Manager APIs, Platform APIs, and Inventory APIs in Global API permissions. Without them, the corresponding actions will not be available in the Crosswork UI. For information about the permissions, see Global API Permissions.
Alternatively, you can assign the Provisioning permission in Task permissions, and enable both the Data Gateway Manager APIs and Platform APIs in Global API permissions. This action automatically enables the Inventory APIs with READ and WRITE access. These permissions are required to perform device operations such as attach, detach, add, move, and initiate failover. For information about assigning task permissions, see Assign Task permissions.
Use these steps to initiate a manual failover of the Data Gateway instance.
Procedure
| 1. | Navigate to the Administration> Data Gateway Management > Data gateways tab. |
|
| 2. | Select the Data Gateway you want to fail over. |
|
| 3. | Choose Initiate failover from Actions. |
|
| 4. | (Optional) If prompted, select to move the Data Gateway to maintenance mode after failover completes. |
|
| 5. | Confirm and continue. |
During failover, the secondary Data Gateway takes over the primary’s southbound IPv6 address. Crosswork may log a temporary Duplicate Address Detection (DAD) failure until the operating system clears the DAD flag, after which the Data Gateway shifts to the UP state. If the DAD status is not cleared, investigate IPv6 address conflicts and operating system-level DAD handling on the secondary Data Gateway. If the failover is unsuccessful due to an error, see Handle DAD error in Data Gateway failover process.