How do I perform an auxiliary database switchover?

Purpose
CAUTION 

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 active and standby roles of a geo-redundant auxiliary database.

Steps
 

Log in to a station that has access to the NSP system.


Open a console window.


Issue the following REST API call:

Note: In order to issue a REST API call, you require a REST token; see the My First NSP API Client tutorial on the Network Developer Portal for information.

GET https://address:8545/restconf/data/auxdb:/auxdb-agent

where address is the NSP advertised address

The auxiliary database cluster status is displayed; the copy-cluster operation is complete only when the status reads SUCCESS.


If the cluster status reads RUNNING, return to Step 3.


A copy-cluster operation is invoked every 30 minutes to replicate the recent data from the primary to the standby auxiliary database cluster.

Review the status information to identify the copy-cluster completion time.


To minimize data loss during the switchover, plan the switchover for 31 minutes after the copy-cluster completion time.


At the time planned in Step 6, issue the following REST API call:

POST https://address:8545/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 roles reverse; the former standby cluster assumes the primary role.


Close the console window.

End of steps