Validate the Conversion Execution
The conversion progress can be monitored by examining the following log files:
> ../<application-directory>/logs/yab.log
> ../<application directory>/logs/conversion.log
Once the conversion has completed, the following checks should be done.
Review Console Output – Build Successful
Ensure the conversion-pre-ee-upgrade process completed successfully. The output should be similar to the following.
Note: The timings will vary depending on the size of the database and server specification.
host: /dr02/qadapps/ee2017 $ yab conversion-pre-ee-upgrade
conversion-pre-ee-upgrade (84 tasks)
-----------------------------------------------------------------
1/84 conversion-preconv-check OK (0.124 s)
2/84 conversion-stage OK (3.907 s)
3/84 conversion-get-src-db-version OK (0.275 s)
4/84 conversion-create-execution-list OK (0.342 s)
5/84 conversion-src-db-data-dump OK (4.064 s)
6/84 conversion-domain-data-create OK (0.002 s)
...
59/84 conversion-qaddb-index-deactivate OK (1:43 m)
60/84 conversion-src-db-buffercopy OK (1:31 m)
61/84 database-qaddb-index-rebuild OK (1:22 m)
...
80/84 conversion-limited-sync-run OK (6.981 s)
81/84 conversion-pre-ee-qaddb-run OK (10:34 m)
82/84 conversion-qadaim-run OK (0.000 s)
83/84 conversion-qadadm-run OK (12.133 s)
84/84 fin-sync-run OK (2:03 m)
-----------------------------------------------------------
BUILD SUCCESSFUL (26:26 m)
Note: The processes listed above are conversion-specific processes. Examining the output for each of these processes is a good starting point in confirming or troubleshooting the conversion-pre-ee-upgrade process.
Review yab.log Output
You should thoroughly review each process associated with the conversion-pre-ee-upgrade process in the yab.log file. To help navigate the yab.log file, you can use the following text to find each process execution entry “BuildContext - ”.
To locate the log content associated with determining the source database version, search the yab.log file for:
"BuildContext - conversion-get-src-db-version"
To locate the log content associated with buffer copy step, search the yab.log file for:
"BuildContext - conversion-src-db-buffercopy"
To locate the log content associated with qaddb conversion step, search the yab.log file for
"BuildContext - conversion-pre-ee-qaddb-run"
Review conversion.log Output
You should thoroughly review each conversion process in the corresponding
conversion.log file. To help navigate the
conversion.log file, you can use the text in
Conversion.log File Entries to find each process execution entry that involves “Executing step:”.
For example, to locate the log content associated with determining the source database version, search the conversion.log file for:
"Executing step: get-db-version.p"
Conversion.log File Entries lists the relationship between the YAB process and corresponding log entry in the
conversion.log file.
Conversion.log File Entries
|
YAB Process
|
conversion.log Entry
|
|
conversion-get-src-db-version
|
Executing step: get-db-version.p
|
|
conversion-create-execution-list
|
Executing step: create-sel-conv.p
|
|
conversion-src-db-data-dump
|
Executing step: special-dump.p
|
|
conversion-src-db-buffercopy
|
Executing step: run-buffer-copy-src.p
|
|
conversion-pre-ee-qaddb-run
|
Executing step: run-qaddb-conv.p
|
|
conversion-qadadm-run
|
Executing step: run-qadadm-conv.p
|
Review QADDB Conversion Output
You should thoroughly review the qaddb conversion in the conversion.log file. To locate the log content associated with running the qaddb conversions, search the conversion.log file for:
"Executing step: run-qaddb-conv.p"
QADDB Conversion Output contains a list of items to check to ensure that all major areas of the conversion were executed.
QADDB Conversion Output
|
Items to Search in conversion.log File
|
Description
|
|
Target Version Conversion: Starting
|
A sample check to ensure the qaddb conversion were started.
|
|
Processing Table: code_mstr
|
A sample check to ensure an operational conversion was executed.
|
|
Processing Table: YearClosing
|
A sample check to ensure the Financial conversions calling program was executed.
|
|
[Reasons] Conversion started (reason_cv93.p)
|
A sample check to ensure a Financial API conversion was executed.
|
|
[GL Postings] Conversion started (gltr_cv93_DirectDB.p).
|
A sample check to ensure a Financial transaction conversion was executed.
|
|
[Post Conversion Updates] Conversion completed (post_cv93.p).
|
A sample check to ensure the last Financial conversion was executed.
|
|
Target Version Conversion: Complete
|
A sample check to ensure the qaddb conversion was complete.
|
Note: If you encounter errors during the conversion, first analyze and resolve the early errors and then repeat the conversion execution. Often, the early errors lead to data not being created, which then causes subsequent errors. By resolving the earlier errors, you often can resolve those related errors.