Tekelec EAGLE 5 - Page 112

active fails with the DB_MAINT_REQD return code until the problem is corrected. At that point, one
PDB would have to be recreated from the other PDB, and the RTDB processes connected to the PDBA
with the recreated PDB must reload (causing the cards on the EAGLE 5 ISSs also to reload).The PDBA
that receives the switchover request attempts to change the state of the remote PDBA first and then
change its own state. In the unlikely event that one of the PDBAs terminates during the handling of
the switchover request, it is theoretically possible for the two PDBAs to be set to the same state. If this
were to happen, the PDBAs automatically fix the situation when the software is restarted.This command
can be issued only by client that have WRITE permission. It cannot be issued from inside a transaction,
nor can any other PDBI clients (on either PDBA) have thewrite transaction open.
Switchover Request
Parameters :
(Optional) Specifies whether the receiving side is to be set to: Active or Standby. Without
this parameter, the switchover command works like a toggle switch.
side
active – Set receiving side to Active.
Values:
standby – Set receiving side to Standby.
(Optional) Specifies how long to wait for an existing write transaction to complete.
timeout
0 (return immediately if not available; default)
Values:
1 –3600 seconds
(Optional) Forces the switch on the receiving side. This is useful when the two PDBA
processes are unable to communicate (due to network problems or remote PDBA down)
force
and you need to make the local PDBA Active anyway. By default, the local PDBA rejects
a switchover request if it cannot communicate with the remote PDBA.
yes and no (default)
Values:
Request syntax :
switchover([iid XXXXX,] [side <active/standby>],
[timeout <0-3600>], [force <yes/no>])
Switchover Response
The return codes listed in Table 16: Switchover Response Return Codes indicate the result of the Switchover
request. See PDBI Message Error Codes for the recommended actions to help resolve the error related
return codes.
112
910-6022-001 Revision A, March 2011
PDBI Request/Response MessagesProvisioning Database Interface Manual