Transition logging

The transition of any database is a complex process. The transition process does provide status and progress messages; in addition, you can activate detailed transition logging.

Progression information similar to the following is presented while the transition is being performed:

Transitioning database /dir/srcdb
---------------------------------------------------------------
13:28:51 Opening database : Succeeded
13:28:51 Setting up transition : Succeeded
13:28:53 Shutting down database : Succeeded
13:29:25 Truncating BI : Succeeded
13:29:28 Starting database in Cur Role : Succeeded
13:29:44 Synchronization in process : Succeeded
13:29:49 Replication Server processing : Succeeded
13:29:54 Preparing to transition Target DB : Succeeded
13:30:05 Shutting down database : Succeeded
13:30:32 Target transition being performed : Succeeded
13:31:14 Switching AI Extents : Succeeded
13:31:20 Switching database role : Succeeded
13:31:20 Updating database master block : Succeeded
13:31:20 Comparing databases : Succeeded
13:31:20 Completing Target transition : Succeeded
13:31:47 Backing up database : Succeeded
13:31:52 Starting database in New Role : Succeeded

The Transition of this database has completed normally.

This information is sent to stdout by the DSRUTIL utility. The information shown in the previous sample is representative of a successful transition.

If transition does not complete normally, information similar to the following will be sent to stdout:

Transitioning database /dir/srcdb
---------------------------------------------------------------
08:12:00 Opening database : Succeeded
08:12:00 Setting up transition : Succeeded
08:12:03 Shutting down database : Succeeded
08:12:37 Truncating BI : Succeeded
08:12:40 Starting database in Cur Role : Succeeded
08:12:56 Synchronization in process : Succeeded
08:13:01 Replication Server processing : Succeeded
08:13:06 Preparing to transition Target DB : Succeeded
08:13:16 Shutting down database : Succeeded
08:13:44 Target transition being performed : Failed with -241

The transition of this database failed. Attempting recovery.

08:14:22 Retrieving prior Recovery Control : Succeeded
08:14:22 Opening database : Succeeded
08:14:22 Restoring prior Recovery Control : Succeeded
08:14:22 Updating Replication Control Info : Succeeded

The Transition of this database failed, but recovery was successful.

In addition, transition will output information to the database log file db-name.lg and, if instructed, to a separate transition log. Transition will perform additional logging to a separate log file named db-name.repl.util.lg when the -logging argument is supplied to DSRUTIL as follows:

dsrutil db-name -C transition [failover] [-logging 2]

This log is formatted as the database log, but it contains much more diagnostic information. (The suggested minimum logging level for diagnosing the problem is 2.)