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.)