How do I perform an auxiliary database switchover?
Purpose
![]() |
CAUTION Data Loss |
Performing an auxiliary database switchover may result in an data-collection interruption of up to 30 minutes.
Ensure that you perform the switchover directly after the completion of the most recent copy-cluster operation, as described in the procedure.
Perform this procedure to switch the primary and standby roles of a geo-redundant auxiliary database.
The switchover operation can be performed only when all standby nodes are up and the copy-cluster operation is successful; the copy cluster status is not copy failed, copying, or unavailable.
If the auxiliary database backup is running, the switchover operation must not be performed until the backup is complete.
Steps
Steps
Perform an auxiliary database switchover in a CLI | |
1 |
Log in to a station that has access to the NSP system. |
2 |
Open a console window. |
3 |
A copy-cluster operation is invoked every 30 minutes to replicate the recent data from the primary to the standby auxiliary database cluster. You must identify the status of the most recent copy-cluster operation in order to determine when to perform the switchover. Issue the following RESTCONF API call: Note: In order to issue a RESTCONF API call, you require a token; see the My First NSP API Client tutorial on the Network Developer Portal for information. GET https://address/restconf/data/auxdb:/auxdb-agent where address is the NSP advertised address The auxiliary database cluster status is displayed; a copy-cluster operation is in progress when the status is RUNNING, and is complete when the status is SUCCESS. |
4 |
Review the status information; if a copy-cluster operation is in progress, return to Step 3; otherwise, identify the most recent copy-cluster completion time. Note: To minimize data loss during a switchover, you must perform the switchover as soon as possible after the completion of a copy-cluster operation. |
5 |
Issue the following RESTCONF API call: GET https://address/restconf/data/auxdb:/clusters where address is the NSP advertised address The auxiliary database cluster node status is displayed; a standby cluster node is reachable when the node status is READY, and is unreachable when the node status is DOWN. |
6 |
Review the status information to confirm all standby cluster nodes statuses are ready. |
7 |
Plan to perform the auxiliary database switchover as soon as possible after the completion of a copy-cluster operation. |
8 |
At the time planned in Step 7, perform the switchover by issuing the following RESTCONF API call: POST https://address/restconf/data/auxdb:/clusters/cluster=cluster_ID/activate where address is the NSP advertised address cluster_ID is the target-cluster value in the Step 3 command output The request body is required to send the call to switch over now: { "auxdb:input" : { } } End of steps |