Instructs an online OpenEdge Replication source database to switch roles with an online target database.

Syntax

dsrutil source-db-name -C transition failover [ -Passphrase ] [-Pin] [ -logging [ 1 | 2 ]]

Parameters

source-db-name

The name of the database, currently in the role of the source replica to perform the action on.

-C transition failover

Causes the Replication source to start the process of switching roles.

-Passphrase

The transition of a database from one role to another requires that many different operations be performed, which could include adding after-image extents, backing up the database, or starting up or shutting down the database. The passphrase is required when these operations are performed for a manual startup database that you have enabled with transparent data encryption.

-Pin

After you enable HSM as a secondary authentication requirement for a TDE-enabled database, both passphrase and PIN are required to authenticate the keystore during transition.

-logging

Turns on transition logging.

1

Produces summary logging.

2

Produces detailed logging.

If online-transition is set to 1, database brokers stay online during the transition. (The online-transition default to 1 in Release 12.2 and higher.) If online-transition is not available, or is explicitly set to 0, the database brokers perform multiple shutdowns and restarts during the failover transition. The new source or target database(s) are also online after transition, unless the restart-after-transition property is set to 0.

Failover transition reverses the roles of a source and target database. For details of the steps involved in failover transition, see Failback processing using transition failover.