20.10 移行前アドバイザ・ツールのログ・ファイル構造
移行前アドバイザ・ツールでは、ジョブ・ステータスや構成ファイルを含む、ログ・ファイル構造が生成されます。
移行前ログ・ファイルのベース・パス
移行前アドバイザ・ツールのログ・ファイル・パスは、グローバル・パラメータpremigration_log_dir
を使用して設定します。
/cfgtoollogs/premigrate/auto
自動構成ツールのログ・ディレクトリ(/cfgtoollogs/premigration/auto
)には、移行前ジョブ・マネージャで処理される各ジョブについて特定の情報を提供する次の3つのトレース・ログ・ファイルが含まれています。
premigration.log
: ジョブの実行中に発生した問題を識別する、ジョブの詳細ログを提供します。premigration_usr.log
: 読みやすいように書式設定されたジョブ情報。premigration_err.log
: ジョブの実行時に発生した想定されていない例外のレポート。
ジョブの開始または停止時に問題が発生した場合、これらのログ・ファイルの情報を使用して、問題の原因を特定できます。
/config_files
config_files
ディレクトリには、移行前アドバイザ・ツールの内部ランタイム構成およびグローバル一時ファイルが含まれています。
/status
/status
ディレクトリには、JSONジョブ・ステータス・ファイルが含まれています。これには2つのディレクトリがあります。
status.json
: このディレクトリには、JSONファイル形式で完了したすべてのジョブの最終ジョブ・ステータスが含まれています。progress.json
: このディレクトリには、JSONファイル形式で現在実行中のすべてのジョブの進行状況が含まれています。
ディレクトリ内の各モジュールには、実行された操作のステータス・ファイルが含まれています。モジュールの形式は次のようになります。接頭辞dbname
はデータベース名、operation
は実行されたアップグレード操作、接尾辞status
はその操作の完了ステータスです。
dbname_operation-name.status
その操作の成功または失敗は、接尾辞によって示されます。その操作の実行が成功したことを示す.success
か、その操作が失敗したことを示す.failure
のいずれかです。たとえば、次のモジュール名は、データベースsales
での事前チェック操作が正常に実行されたことを示します。
sales_prechecks.success
操作モジュール名には、次のいずれかを指定できます。
preupgrade
: カスタム・スクリプトを実行できるアップグレード前のステージ。prechecks
: アップグレードの開始前に完了したアップグレード・チェック。grp
: 保証付きリストア・ポイント(Oracle Flashback Technologyを使用)prefixups
: アップグレードを開始する前にアップグレード前の修正を実行しますdrain
: アップグレードを開始する前に既存のジョブが完了または移行されるステージ。dbupgrade
: アップグレードが実行されるステージ。postchecks
: アップグレードの完了後にアップグレード後のチェックが実行されるステージ。postfixups
: アップグレード後の修正が実行されるステージ。postupgrade
: カスタムのアップグレード後スクリプトを実行できるステージ。
個々のジョブおよびデータベース・ログ・ファイル・ディレクトリ
移行前ディスパッチャによって起動される各ジョブには、そのジョブ識別子の接頭辞が付いたディレクトリが与えられます。ジョブ・ディレクトリの内部では、ジョブ内の各データベースにパス/database/logs/sid
にログ・ディレクトリが提供されます。ここで、sid
はデータベースのシステム識別子です。たとえば、構成ファイルで識別されたジョブがsales1
で、データベース・システム識別子がsales
の場合、データベースsalesのログ・ファイルのパスは次のようになります。
sales.log_dir=/database/logs/sales1
ログ・ディレクトリには、そのデータベースに対して実行されたすべてのタスクに関するすべての関連ログ・ファイルが含まれています。デフォルトでは、SIDで識別されるディレクトリが/database/logs
ディレクトリの下に作成されます。この方法で構成ファイルを設定することを選択した場合、各データベース・ジョブに個別のログ・ディレクトリを設定できます。
/####
(ジョブ番号)
個々のジョブ実行は、/####
という形式の実行番号で識別されるサブディレクトリに配置されます。ここで、####
は実行番号を表します。たとえば、0004
となります。ジョブ実行番号ディレクトリには、次のログ・ファイルが含まれます。
premigration_err.log
: ジョブの実行中に発生した想定されていない例外をレポートします。premigrationYYYYMMDD.log
: 移行前トレース・ログ・ファイル。ジョブの実行中に発生した問題を識別するジョブの詳細なログを提供します。変数YYYYMMDD
は、ジョブの年、月および日を表します。premigration_YYYYMMDD_user.log
: 移行前ジョブのステータス・ファイルであり、読みやすいように書式設定されています。変数YYYYYYMMDD
は、ジョブの年、月および日を表します。
/premigration
移行前ディレクトリ(/premigration
)には、次のファイルとログ・ファイルが含まれています。
prechecks_databasename.log
: トレース・ログ・ファイル。このファイルは、アップグレード前のジョブ・ステージ中に発生した問題の識別に役立つ詳細なログを提供します。変数databasename
は、チェックされたデータベースの名前です。databasename_preupgrade.html
: データベースのステータスに関するHTMLレポート。変数databasename
は、チェックされたデータベースの名前です。databasename_preupgrade.html
: データベースのステータスに関するテキスト・レポート。変数databasename
は、チェックされたデータベースの名前です。
/premigration
データベース移行前ディレクトリ(/premigration
)には、データベース・アップグレードに関連付けられているすべてのログ・ファイルが含まれています。
premigrationYYYYMMDDHHMISCdbname.log
: 並列性を示す、アップグレードが実行された日付やデータベース名によって識別される、ソース・データベースのログ・ファイル。書式:YYYY
: 年MM
: 月DD
: 日HH
: 時MI
: 分SC
: 秒dbname
: データベース名。dbname
はデータベース名です。
-
premigrationYYYYMMDDHHMISCdbnameN.log
: 移行前チェックが実行された日付で識別される、ソース・データベースのログ・ファイル。書式:
YYYY
: 年MM
: 月DD
: 日HH
: 時MI
: 分SC
: 秒dbnameN
: データベース名。dbname
はデータベース名で、N
は並列度を示します。CDB ROOTおよび非CDBデータベースの場合は0...3で、PDBの場合は0...1です。
/temp
移行前一時ファイル(/temp
)。このディレクトリには、アップグレード時に使用されるPFILE
などのファイルを含めることができます。
親トピック: クラウド移行前アドバイザ・ツール