Release 10.1C: OpenEdge Replication:
User Guide


Transition logging

The transition of any database is a very complicated 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 rprepl[.exe] program. 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 to the information above, transition will output information to the database log file database.lg and, if instructed to do so, to a separate transition log. Transition will perform additional logging to a separate log file named database.repl.util.lg when the -logging argument is supplied to DSRUTIL as follows:

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


Copyright © 2008 Progress Software Corporation
www.progress.com