AutoUpgrade 19c Hands-On Lab – Japanese Version

AutoUpgrade ハンズオンラボ

***** This lab requires a newer version of the lab which is not uploaded yet *****

AutoUpgrade ハンズオンラボへようこそ

スライドが必要な場合、またはご自身でラボをダウンロードする場合は、ブログのアドレスをメモしてください。

ラボの指示に従ってください。いつでもコピー&ペーストできますが、必須ではありません。


1. Inside the lab

Username とPasswords

全てのpasswordsoracle にセットされています。

これはOS ユーザーrootoracle およびdatabase アカウントであるSYSSYSTEM に適用されます。

環境の切り替え

次のように入力して、異なる環境を切り替えることができます。. db12
読み方:ドット<空白>db12

便宜上、追加の環境変数$OH19 が定義されています。これは19c のOracle Home を指し、ラボで数回使用されます。

表記規則

これはラボ全体にとって非常に重要です。

この色の意味:xterm のOS レベルで実行:

example: RED means you’ll type this in an xterm

2番目の色の意味:SQL*Plus で実行:

example: GREY means you’ll type this in SQL*Plus

3番目の色の意味: ジョブコンソールで実行 upg>:

example: BLUE means you’ll type this in the autouopgrade job console

This way you can copy&paste from the instructions if necessary without having trouble with prompts.


2. ハンズオンラボの概要

今日は、新しいAutoUpgrade ユーティリティを使用して、 FTEX および DB12 の2つのデータベースを、Oracle 11.2.0.4 および12.2.0.1 からOracle 19c へアップグレードします。 このラボの目的は、新しいAutoUpgrade とその機能について理解してもらうことです。

ラボでは既にMOS Note: 2485457.1 – AutoUpgrade Tool から最新バージョンを使用しています。
このツールを使用すると、複数のOracleデータベース(最小バージョン:11.2.0.4)を次のようにアップグレードできます。:

  • Oracle 12.2.0.1 with Release Update January 2019 以降
  • Oracle 18.5.0 以降
  • Oracle 19.3.0 以降

3. 始めましょう

3.1. 準備

xtermを開き(ダブルクリック)、以下の指示に従います。

AutoUpgrade 19c Hands-On Lab - Japanese Version

クリーンアップスクリプトの実行 – スペースを解放し、データベースの1つをラボのためにARCHIVELOGモードに切り替えます。

. /home/oracle/scripts/clean.sh

次に、ラボを開始するために環境を設定します。

. db12

cd

.

3.2. 設定ファイルの生成と編集

AutoUpgrade の場合、設定ファイルのみを作成する必要があります。 それ以外はすべてツールによって処理されます。 サンプル設定ファイルの生成を開始します。

java -jar $OH19/rdbms/admin/autoupgrade.jar -create_sample_file config

それを編集する必要があります – それからAutoUpgrade ユーティリティに渡します。

Created sample configuration file /home/oracle/sample_config.cfg

任意のエディター(テキストモード もしくは グラフィカルモード)で、ファイル /home/oracle/sample_config.cfg開きます。

  • テキスト モード:

    vi /home/oracle/sample_config.cfg

  • グラフィカル モード:

    kwrite /home/oracle/sample_config.cfg &

次を調整します:

Generated standard config.cfg Make the following adjustments:
#Global configurations
#Autoupgrade's global directory, ...
#temp files created and other ...
#send here
global.autoupg_log_dir=/default/...

#
# Database number 1 
#
upg1.dbname=employee
upg1.start_time=NOW
upg1.source_home=/u01/...
upg1.target_home=/u01/...
upg1.sid=emp
upg1.log_dir=/scratch/auto
upg1.upgrade_node=hol1.localdomain
upg1.target_version=19
#upg1.run_utlrp=yes
#upg1.timezone_upg=yes

#
# Database number 2
#
#upg2.dbname=database name
#upg2.start_time=17/10/2019 22:09:43
#upg2.source_home=Path to source 
#upg2.target_home=Path to target 
#upg2.sid=Value of Oracle SID
#upg2.log_dir=Path to log dir
#upg2.upgrade_node=hol.localdomain # y
#upg2.target_version=12.2
#upg2.run_utlrp=[yes|no]
#upg2.timezone_upg=[yes|no]
#Global configurations
#Autoupgrade's global directory, ...
#temp files created and other ...
#send here
global.autoupg_log_dir=/home/oracle/upg_logs


#
# Database number 1 
#
upg1.dbname=DB12
upg1.start_time=NOW
upg1.source_home=/u01/app/oracle/product/12.2.0.1
upg1.target_home=/u01/app/oracle/product/19
upg1.sid=DB12
upg1.log_dir=/home/oracle/upg_logs
upg1.upgrade_node=localhost
upg1.target_version=19
#upg1.run_utlrp=yes
upg1.timezone_upg=no

#
# Database number 2
#
upg2.dbname=FTEX
upg2.start_time=NOW
upg2.source_home=/u01/app/oracle/product/11.2.0.4 
upg2.target_home=/u01/app/oracle/product/19
upg2.sid=FTEX
upg2.log_dir=/home/oracle/upg_logs
upg2.upgrade_node=localhost
upg2.target_version=19
upg2.timezone_upg=no
upg2.restoration=no
upg2.target_cdb=CDB2

次にファイルを保存し、/home/oracleUP19.cfg と名前を付けます。

元の名前 sample_config.cfg で保存した場合は、次のように名前を変更します。:

mv /home/oracle/sample_config.cfg /home/oracle/UP19.cfg

ファイルの編集に 問題 がある場合は、 既に次にコピーが保存されています。: /home/oracle/scripts/UP19.cfg. 代わりにこれを使用できます。
1つ上のフォルダーにコピーするだけです。: cp /home/oracle/scripts/UP19.cfg /home/oracle
.

3.3. 分析モード

最初に 分析 モードでAutoUpgrade を実行することをお勧めします。分析 フェーズを問題なくパスすると、データベースを自動的にアップグレードできます。(以下のコマンドは 1行のコマンドです!)

. db12

java -jar $OH19/rdbms/admin/autoupgrade.jar -config /home/oracle/UP19.cfg -mode analyze

この出力が表示されます。:

Autoupgrade tool launched with default options
+--------------------------------+
| Starting AutoUpgrade execution |
+--------------------------------+
2 databases will be analyzed
Type 'help' to list console commands
upg>

You can monitor the analyze phase in the upg> job console with:

lsj

status -job 100

すぐにコンソールが応答します。:

upg> Job 100 completed
Job 101 completed
------------------- Final Summary --------------------
Number of databases            [ 2 ]

Jobs finished successfully     [2]
Jobs failed                    [0]
Jobs pending                   [0]
------------- JOBS FINISHED SUCCESSFULLY -------------
Job 100 FOR FTEX
Job 101 FOR DB12

両方のデータベースを自動的にアップグレードできます。

.

3.4. デプロイモード – Upgrade

-mode deploy を使用してアップグレードを開始すると、ツールは 分析 フェーズを繰り返しますが、 修正アップグレードポストアップグレード のステップを追加します。

java -jar $OH19/rdbms/admin/autoupgrade.jar -config /home/oracle/UP19.cfg -mode deploy

この出力が表示されます。:

Autoupgrade tool launched with default options
+--------------------------------+
| Starting AutoUpgrade execution |
+--------------------------------+
2 databases will be processed
Type 'help' to list console commands
upg>

At this point you can monitor the upgrade now – enlarge the xterm‘s width a bit to see no line wraps.

Type help on the upg> job console to see an overview of available commands.

help

upg> help
exit                          // To close and exit
help                          // Displays help
lsj [(-r|-f|-p|-e) | -n ]     // list jobs by status up to n elements.
	-f Filter by finished jobs.
	-r Filter by running jobs.
	-e Filter by jobs with errors.
	-p Filter by jobs being prepared.
	-n  Display up to n jobs.
lsr                           // Displays the restoration queue
lsa                           // Displays the abort queue
tasks                         // Displays the tasks running
clear                         // Clears the terminal
resume -job                   // Restarts a previous job that was running
status [-job  [-long]]        // Lists all the jobs or a specific job
restore -job                  // Restores the database to its state prior to the upgrade
restore all_failed            // Restores all failed jobs to their previous states prior to the upgrade
logs                          // Displays all the log locations
abort -job                    // Aborts the specified job
h[ist]                        // Displays the command line history
/[]                           // Executes the command specified from the history. The default is the last command

最も重要なコマンドは次のとおりです。:

    • lsj – これは、アクティブな各ジョブに関するジョブ番号と概要情報をリストします。
      -mode deploy 実行のジョブ番号が変更されていることに注意してください。
  • lsj

    upg> lsj
    +----+-------+---------+---------+--------+--------------+--------+--------+-------------+
    |Job#|DB_NAME|    STAGE|OPERATION|  STATUS|    START_TIME|END_TIME| UPDATED|      MESSAGE|
    +----+-------+---------+---------+--------+--------------+--------+--------+-------------+
    | 102|   FTEX|PREFIXUPS|EXECUTING| RUNNING|19/10/17 23:15|     N/A|23:15:28|Remaining 3/3|
    | 103|   DB12|    SETUP|PREPARING|FINISHED|19/10/17 23:16|     N/A|23:15:13|    Scheduled|
    +----+-------+---------+---------+--------+--------------+--------+--------+-------------+
    Total jobs 2
    
    
  • status -job <number> – これにより、特定のジョブに関する詳細情報が得られます。
    ログファイル の場所も表示されます。

    • status -job 102

      upg> status -job 103
      Progress
      -----------------------------------
      Start time:      19/10/17 23:16
      Elapsed (min):   1
      End time:        N/A
      Last update:     2019-10-17T23:16:58.468
      Stage:           PREFIXUPS
      Operation:       EXECUTING
      Status:          RUNNING
      Pending stages:  6
      Stage summary: 
          SETUP             <1 min 
          PREUPGRADE        <1 min 
          PRECHECKS         <1 min 
          GRP               <1 min 
          PREFIXUPS         <1 min (IN PROGRESS)
      
      Job Logs Locations
      -----------------------------------
      Logs Base:    /home/oracle/upg_logs/DB12
      Job logs:     /home/oracle/upg_logs/DB12/103
      Stage logs:   /home/oracle/upg_logs/DB12/103/prefixups
      TimeZone:     /home/oracle/upg_logs/DB12/temp
      
      Additional information
      -----------------------------------
      Details:
      +--------+----------------+-------+
      |DATABASE|           FIXUP| STATUS|
      +--------+----------------+-------+
      |    DB12|DICTIONARY_STATS|STARTED|
      +--------+----------------+-------+
      
      Error Details:
      None
      
  • logs – ログフォルダを表示します。
    • logs

      Autoupgrade logs folder [/home/oracle/upg_logs/cfgtoollogs/upgrade/auto/config_files]
      logs folder [FTEX][/home/oracle/upg_logs/FTEX]
      logs folder [DB12][/home/oracle/upg_logs/DB12]
      

      2番目のxterm タブを開いて、ログフォルダに移動してください。

      AutoUpgrade 19c Hands-On Lab - Japanese Version

      cd /home/oracle/upg_logs/FTEX/102

      サブディレクトリ、特に /home/oracle/upg_logs/FTEX/102 以下を調べてください。

    • /home/oracle/upg_logs/FTEX/102/prechecks サブディレクトリを確認します。アップグレード前チェックの概要が記載されたHTMLファイルが含まれています。:

      cd prechecks

      firefox ftex_preupgrade.html &

      同じディレクトリ内のpreupgrade.log も確認してください。:

      more ftex_preupgrade.log

    • ここでディレクトリを変更し、 dbupgrade ディレクトリが作成されているかどうかを確認します。これには、通常、事前チェックと修正が完了するまで最大4分かかります。4つのアップグレード作業者用ログ のログがあります。cd /home/oracle/upg_logs/FTEX/102/dbupgrade.これらの4つのサブディレクトリは、dbupgradeの前に作成されます。:
      prechecks
      prefixups
      preupgrade
      drain
    • 特に主な作業者(0で終わる)のログを tail -f して、アップグレードの進行状況を表示できます。

      cd ../dbupgrade

      tail -f catupgrd*0.log

      CTRL+Cで、tail コマンドを中断します。.

ハードウェアにもよりますが、 アップグレードには25~35分かかります。 待つ必要はありませんが、代わりにAutoUpgrade ツールを使用していくつかの演習を行います。

.

3.5. 自動アップグレード演習

演習を進める前に、データベースDB12アップグレード フェーズに 既に達していることを確認してください。lsj は次のように表示されるはずです。 – DB12 データベースはすでに 8% アップグレード の進行を完了しています。deploy フェーズを開始してから、約6〜7分待つ必要がある場合があります。

upg> lsj
+----+-------+---------+---------+-------+--------------+--------+--------+------------+
|Job#|DB_NAME|    STAGE|OPERATION| STATUS|    START_TIME|END_TIME| UPDATED|     MESSAGE|
+----+-------+---------+---------+-------+--------------+--------+--------+------------+
| 102|   FTEX|DBUPGRADE|EXECUTING|RUNNING|19/10/17 23:15|     N/A|23:22:42|10%Upgraded |
| 103|   DB12|DBUPGRADE|EXECUTING|RUNNING|19/10/17 23:16|     N/A|23:23:45| 8%Upgraded |
+----+-------+---------+---------+-------+--------------+--------+--------+------------+
Total jobs 2

upg> ジョブコンソールでジョブを中止します。:

abort -job 103

この応答は、 upg> コンソールに表示されます。:

upg> abort -job 103
Are you sure you want to abort job [103] ? [y|N] y
Abort job: [103][DB12]
-------------------------------------------------
Errors in database [DB12]
Stage     [DBUPGRADE]
Operation [STOPPED]
Status    [ERROR]
Info    [
Error: UPG-1419
[Unexpected Exception Error]
Cause: This indicates that the upgrade has been killed, by an abort or restore command.
For further details, see the log file located at /home/oracle/upg_logs/DB12/103/autoupgrade_20191017_user.log]

-------------------------------------------------
Logs: [/home/oracle/upg_logs/DB12/103/autoupgrade_20191017_user.log]
-------------------------------------------------

RETURN キーを押して、upg> コンソールに戻ります。

コンソールに表示される内容を確認してください。:

status -job 103

upg> status -job 103
Progress
-----------------------------------
Start time:      19/10/17 23:16
Elapsed (min):   11
End time:        N/A
Last update:     2019-10-17T23:27:10.143
Stage:           DBUPGRADE
Operation:       STOPPED
Status:          ABORTED
Pending stages:  4
Stage summary: 
    SETUP             <1 min 
    PREUPGRADE        <1 min 
    PRECHECKS         <1 min 
    GRP               <1 min 
    PREFIXUPS         2 min 
    DRAIN             <1 min 
    DBUPGRADE         6 min 

Job Logs Locations
-----------------------------------
Logs Base:    /home/oracle/upg_logs/DB12
Job logs:     /home/oracle/upg_logs/DB12/103
Stage logs:   /home/oracle/upg_logs/DB12/103/dbupgrade
TimeZone:     /home/oracle/upg_logs/DB12/temp

Additional information
-----------------------------------
Details:
Job [103][DB12] successfully aborted

Error Details:

Error: UPG-1419
[Unexpected Exception Error]
Cause: This indicates that the upgrade has been killed, by an abort or restore command.
For further details, see the log file located at /home/oracle/upg_logs/DB12/103/autoupgrade_20191017_user.log

中止キューをリストする。:

lsa

upg> lsa
+----+--------+
|Job#|  STATUS|
+----+--------+
| 103|FINISHED|
+----+--------+
Total 1

今再びジョブを再開します。

resume -job 103

upg> resume -job 103
Resuming job: [103][DB12]

このシーケンスにより、何かを修正することができます。またはアップグレードを一時停止することができ、その後それを再開できます。

ラボの演習を進めるまで、さらにx分待ちます。.
ジョブの進行状況を確認します。 (以前: 10% Upgraded – 現在: 21% Upgraded):

lsj

upg> lsj
+----+-------+---------+---------+-------+--------------+--------+--------+------------+
|Job#|DB_NAME|    STAGE|OPERATION| STATUS|    START_TIME|END_TIME| UPDATED|     MESSAGE|
+----+-------+---------+---------+-------+--------------+--------+--------+------------+
| 102|   FTEX|DBUPGRADE|EXECUTING|RUNNING|19/10/17 23:15|     N/A|23:31:49|39%Upgraded |
| 103|   DB12|DBUPGRADE|EXECUTING|RUNNING|19/10/17 23:16|     N/A|23:32:16|21%Upgraded |
+----+-------+---------+---------+-------+--------------+--------+--------+------------+
Total jobs 2

次の演習として、 ジョブを再び停止 します。ただし今は 以前の(アップグレード前の!) 状態 に復元します。

abort -job 103

upg> abort -job 103
Are you sure you want to abort job [103] ? [y|N] y
Abort job: [103][DB12]
upg> 
-------------------------------------------------
Errors in database [DB12]
Stage     [DBUPGRADE]
Operation [STOPPED]
Status    [ERROR]
Info    [
Error: UPG-1419
[Unexpected Exception Error]
Cause: This indicates that the upgrade has been killed, by an abort or restore command.
For further details, see the log file located at /home/oracle/upg_logs/DB12/103/autoupgrade_20191017_user.log]

-------------------------------------------------
Logs: [/home/oracle/upg_logs/DB12/103/autoupgrade_20191017_user.log]
-------------------------------------------------

現在の状況を確認する。

lsj

upg> lsj
+----+-------+---------+---------+-------+--------------+--------+--------+--------------------+
|Job#|DB_NAME|    STAGE|OPERATION| STATUS|    START_TIME|END_TIME| UPDATED|             MESSAGE|
+----+-------+---------+---------+-------+--------------+--------+--------+--------------------+
| 102|   FTEX|DBUPGRADE|EXECUTING|RUNNING|19/10/17 23:15|     N/A|23:31:49|        39%Upgraded |
| 103|   DB12|DBUPGRADE|  STOPPED|ABORTED|19/10/17 23:16|     N/A|23:33:55|Job 103 killed succe|
+----+-------+---------+---------+-------+--------------+--------+--------+--------------------+
Total jobs 2

status -job 103

upg> status -job 103
Progress
-----------------------------------
Start time:      19/10/17 23:16
Elapsed (min):   19
End time:        N/A
Last update:     2019-10-17T23:33:55.292
Stage:           DBUPGRADE
Operation:       STOPPED
Status:          ABORTED
Pending stages:  4
Stage summary: 
    SETUP             <1 min 
    PREUPGRADE        <1 min 
    PRECHECKS         <1 min 
    GRP               <1 min 
    PREFIXUPS         2 min 
    DRAIN             <1 min 
    DBUPGRADE         4 min 

Job Logs Locations
-----------------------------------
Logs Base:    /home/oracle/upg_logs/DB12
Job logs:     /home/oracle/upg_logs/DB12/103
Stage logs:   /home/oracle/upg_logs/DB12/103/dbupgrade
TimeZone:     /home/oracle/upg_logs/DB12/temp

Additional information
-----------------------------------
Details:
Job [103][DB12] successfully aborted

Error Details:

Error: UPG-1419
[Unexpected Exception Error]
Cause: This indicates that the upgrade has been killed, by an abort or restore command.
For further details, see the log file located at /home/oracle/upg_logs/DB12/103/autoupgrade_20191017_user.log

データベースを以前の(アップグレード前の)状態に復元します。

restore -job 103

upg> restore -job 103
The job 103[DB12] on stage [DBUPGRADE] has the status [ABORTED]
Are you sure you want to restore? all progress will be lost [y/N] y

何が起こっているかを監視する。

lsj

upg> lsj
+----+-------+----------+---------+-------+--------------+--------+--------+----------------+
|Job#|DB_NAME|     STAGE|OPERATION| STATUS|    START_TIME|END_TIME| UPDATED|         MESSAGE|
+----+-------+----------+---------+-------+--------------+--------+--------+----------------+
| 102|   FTEX| DBUPGRADE|EXECUTING|RUNNING|19/10/17 23:15|     N/A|23:34:51|    52%Upgraded |
| 103|   DB12|GRPRESTORE|EXECUTING|RUNNING|19/10/17 23:16|     N/A|23:36:27|Restore Phase[5]|
+----+-------+----------+---------+-------+--------------+--------+--------+----------------+
Total jobs 2

status -job 103

upg> status -job 103
Progress
-----------------------------------
Start time:      19/10/17 23:16
Elapsed (min):   20
End time:        N/A
Last update:     2019-10-17T23:36:34.114
Stage:           SETUP
Operation:       STOPPED
Status:          FINISHED
Pending stages:  10
Stage summary: 
    SETUP             -19 min 
    PREUPGRADE        <1 min 
    PRECHECKS         <1 min 
    GRP               <1 min 
    PREFIXUPS         2 min 
    DRAIN             <1 min 
    DBUPGRADE         7 min 
    GRPRESTORE        <1 min 

Job Logs Locations
-----------------------------------
Logs Base:    /home/oracle/upg_logs/DB12
Job logs:     /home/oracle/upg_logs/DB12/103
Stage logs:   /home/oracle/upg_logs/DB12/103
TimeZone:     /home/oracle/upg_logs/DB12/temp

Additional information
-----------------------------------
Details:
This database was restored and left in its original state.  Check the log files for further details about the incident that caused the restoration   

Error Details:
None

データベース DB12 は、AutoUpgrade ツールによってデフォルトで自動的に作成される保証付きリストアポイントにフラッシュバックされています。

注:
FTEXのアップグレードはまだ実行中です!

1分後にもう一度監視します。

lsj

upg> lsj
+----+-------+---------+---------+--------+--------------+--------+--------+------------+
|Job#|DB_NAME|    STAGE|OPERATION|  STATUS|    START_TIME|END_TIME| UPDATED|     MESSAGE|
+----+-------+---------+---------+--------+--------------+--------+--------+------------+
| 102|   FTEX|DBUPGRADE|EXECUTING| RUNNING|19/10/17 23:15|     N/A|23:34:51|52%Upgraded |
| 103|   DB12|    SETUP|  STOPPED|FINISHED|19/10/17 23:16|     N/A|23:36:34| DB Restored|
+----+-------+---------+---------+--------+--------------+--------+--------+------------+
Total jobs 2

FTEXデータベースは、まもなくデータベースのアップグレードを完了します。

lsj

upg> lsj
+----+-------+---------+---------+--------+--------------+--------+--------+------------+
|Job#|DB_NAME|    STAGE|OPERATION|  STATUS|    START_TIME|END_TIME| UPDATED|     MESSAGE|
+----+-------+---------+---------+--------+--------------+--------+--------+------------+
| 102|   FTEX|DBUPGRADE|EXECUTING| RUNNING|19/10/17 23:15|     N/A|23:37:53|91%Upgraded |
| 103|   DB12|    SETUP|  STOPPED|FINISHED|19/10/17 23:16|     N/A|23:36:34| DB Restored|
+----+-------+---------+---------+--------+--------------+--------+--------+------------+
Total jobs 2

FTEXの動作を確認してください。

status -job 102

upg> status -job 102
Progress
-----------------------------------
Start time:      19/10/17 23:15
Elapsed (min):   27
End time:        N/A
Last update:     2019-10-17T23:41:17.960
Stage:           DBUPGRADE
Operation:       EXECUTING
Status:          RUNNING
Pending stages:  5
Stage summary: 
    SETUP             <1 min 
    PREUPGRADE        <1 min 
    PRECHECKS         <1 min 
    PREFIXUPS         <1 min 
    DRAIN             <1 min 
    DBUPGRADE         26 min (IN PROGRESS)

Job Logs Locations
-----------------------------------
Logs Base:    /home/oracle/upg_logs/FTEX
Job logs:     /home/oracle/upg_logs/FTEX/102
Stage logs:   /home/oracle/upg_logs/FTEX/102/dbupgrade
TimeZone:     /home/oracle/upg_logs/FTEX/temp

Additional information
-----------------------------------
Details:
[Compiling] is [0%] completed for [ftex] objects remaining is [5716]
                 +---------+------------+
                 |CONTAINER|  PERCENTAGE|
                 +---------+------------+
                 |     FTEX|COMPILE [0%]|
                 +---------+------------+

Error Details:
None

FTEXデータベースは再コンパイルフェーズに入りました。 コンソールは180秒ごとに更新されるため、進行状況が表示されるまで少し時間がかかります。

lsj

upg> lsj   
+----+-------+---------+---------+--------+--------------+--------+--------+------------+
|Job#|DB_NAME|    STAGE|OPERATION|  STATUS|    START_TIME|END_TIME| UPDATED|     MESSAGE|
+----+-------+---------+---------+--------+--------------+--------+--------+------------+
| 102|   FTEX|DBUPGRADE|EXECUTING| RUNNING|19/10/17 23:15|     N/A|23:44:20|92%Compiled |
| 103|   DB12|    SETUP|  STOPPED|FINISHED|19/10/17 23:16|     N/A|23:36:34| DB Restored|
+----+-------+---------+---------+--------+--------------+--------+--------+------------+
Total jobs 2

その後すぐに、FTEXデータベースが再起動され、アップグレード後修正プログラムが適用され、ディクショナリ統計が更新されます。

lsj

upg> lsj
+----+-------+---------+---------+--------+--------------+--------+--------+-------------------+
|Job#|DB_NAME|    STAGE|OPERATION|  STATUS|    START_TIME|END_TIME| UPDATED|            MESSAGE|
+----+-------+---------+---------+--------+--------------+--------+--------+-------------------+
| 102|   FTEX|DBUPGRADE|EXECUTING|FINISHED|19/10/17 23:15|     N/A|23:46:16|Restarting Database|
| 103|   DB12|    SETUP|  STOPPED|FINISHED|19/10/17 23:16|     N/A|23:36:34|        DB Restored|
+----+-------+---------+---------+--------+--------------+--------+--------+-------------------+
Total jobs 2

lsj

upg> lsj
+----+-------+----------+---------+--------+--------------+--------+--------+-------------+
|Job#|DB_NAME|     STAGE|OPERATION|  STATUS|    START_TIME|END_TIME| UPDATED|      MESSAGE|
+----+-------+----------+---------+--------+--------------+--------+--------+-------------+
| 102|   FTEX|POSTCHECKS|PREPARING| RUNNING|19/10/17 23:15|     N/A|23:47:55|Remaining 0/9|
| 103|   DB12|     SETUP|  STOPPED|FINISHED|19/10/17 23:16|     N/A|23:36:34|  DB Restored|
+----+-------+----------+---------+--------+--------------+--------+--------+-------------+
Total jobs 2

しかし、これはハンズオンラボの終わりではありません。

3.5. CDB への接続

UP19.cfg ファイルでは、トークで説明しなかった1つのパラメーターを使用しました。

  • upg2.target_cdb=CDB2

コンテナデータベース CDB2 は既に開始されています。 – そして FTEXNOCOPY オプションを使用してCDB2 にプラグインされます。データファイルはそのまま残ります。

lsj

upg> lsj
+----+-------+-----------+---------+--------+--------------+--------+--------+--------------------+
|Job#|DB_NAME|      STAGE|OPERATION|  STATUS|    START_TIME|END_TIME| UPDATED|             MESSAGE|
+----+-------+-----------+---------+--------+--------------+--------+--------+--------------------+
| 102|   FTEX|NONCDBTOPDB|EXECUTING| RUNNING|19/10/17 23:15|     N/A|23:50:43|Changing database co|
| 103|   DB12|      SETUP|  STOPPED|FINISHED|19/10/17 23:16|     N/A|23:36:34|         DB Restored|
+----+-------+-----------+---------+--------+--------------+--------+--------+--------------------+
Total jobs 2

DBMS_PDB.DESCRIBE を使用してプラグインのXML マニフェストファイルを生成します。FTEX読み取り専用 で開始されます。

lsj

upg> lsj
+----+-------+-----------+---------+--------+--------------+--------+--------+-------------------+
|Job#|DB_NAME|      STAGE|OPERATION|  STATUS|    START_TIME|END_TIME| UPDATED|            MESSAGE|
+----+-------+-----------+---------+--------+--------------+--------+--------+-------------------+
| 102|   FTEX|NONCDBTOPDB|EXECUTING| RUNNING|19/10/17 23:15|     N/A|23:51:26|Executing describe.|
| 103|   DB12|      SETUP|  STOPPED|FINISHED|19/10/17 23:16|     N/A|23:36:34|        DB Restored|
+----+-------+-----------+---------+--------+--------------+--------+--------+-------------------+
Total jobs 2

プラグイン操作を完了するには、autoupgrade.jarによって健全性スクリプトnoncdb_to_pdb.sqlを実行する必要があります。完了するまで、約10分のランタイムが必要です。

lsj

upg> lsj
+----+-------+-----------+---------+--------+--------------+--------+--------+--------------------+
|Job#|DB_NAME|      STAGE|OPERATION|  STATUS|    START_TIME|END_TIME| UPDATED|             MESSAGE|
+----+-------+-----------+---------+--------+--------------+--------+--------+--------------------+
| 102|   FTEX|NONCDBTOPDB|EXECUTING| RUNNING|19/10/17 23:15|     N/A|23:52:58|Executing noncdb_to_|
| 103|   DB12|      SETUP|  STOPPED|FINISHED|19/10/17 23:16|     N/A|23:36:34|         DB Restored|
+----+-------+-----------+---------+--------+--------------+--------+--------+--------------------+
Total jobs 2

“job 102 completed”というメッセージが表示されたら、プラグインは終了しています。

lsj

upg> lsj
+----+-------+-----------+---------+--------+--------------+--------+--------+--------------------+
|Job#|DB_NAME|      STAGE|OPERATION|  STATUS|    START_TIME|END_TIME| UPDATED|             MESSAGE|
+----+-------+-----------+---------+--------+--------------+--------+--------+--------------------+
| 102|   FTEX|NONCDBTOPDB|EXECUTING| RUNNING|19/10/17 23:15|     N/A|23:52:58|Executing noncdb_to_|
| 103|   DB12|      SETUP|  STOPPED|FINISHED|19/10/17 23:16|     N/A|23:36:34|         DB Restored|
+----+-------+-----------+---------+--------+--------------+--------+--------+--------------------+
Total jobs 2
upg> Job 102 completed

別の lsj コマンドを繰り返します。

lsj

upg> lsj
+----+-------+-----------+---------+--------+--------------+--------------+--------+-----------------+
|Job#|DB_NAME|      STAGE|OPERATION|  STATUS|    START_TIME|      END_TIME| UPDATED|          MESSAGE|
+----+-------+-----------+---------+--------+--------------+--------------+--------+-----------------+
| 102|   FTEX|NONCDBTOPDB|  STOPPED|FINISHED|19/10/17 23:15|19/10/18 00:00|00:00:17|Completed job 102|
| 103|   DB12|      SETUP|  STOPPED|FINISHED|19/10/17 23:16|           N/A|23:36:34|      DB Restored|
+----+-------+-----------+---------+--------+--------------+--------------+--------+-----------------+
Total jobs 2

現在、 END_TIME もあることが分かります。しかし、中止して復元したジョブ103はまだアクティブです。すぐにクリーンアップします。しかし、前に FTEX が実際に正しく接続され、使用する準備ができているかどうかを確認しましょう。

最初にツールを 終了 し、 y で確認します。

exit

upg> exit
There is 1 job in progress. if you exit it will stop
Are you sure you wish to leave? [y|N] y
------------------- Final Summary --------------------
Number of databases            [ 2 ]

Jobs finished successfully     [1]
Jobs failed                    [0]
Jobs pending                   [1]
------------- JOBS FINISHED SUCCESSFULLY -------------
Job 102 FOR FTEX
-------------------- JOBS PENDING --------------------
Job 103 FOR DB12

Exiting

FTEX プラがブル データベースのステータスを確認してください。

. cdb2
sqlplus / as sysdba

show pdbs

次の出力が表示されます。 – FTEX はPDB になり、READ/WRITE モードでオープンします。

SQL*Plus: Release 19.0.0.0.0 - Production on Fri Oct 18 00:07:24 2019
Version 19.5.0.0.0

Copyright (c) 1982, 2019, Oracle.  All rights reserved.


Connected to:
Oracle Database 19c Enterprise Edition Release 19.0.0.0.0 - Production
Version 19.5.0.0.0

SQL> show pdbs

    CON_ID CON_NAME			  OPEN MODE  RESTRICTED
---------- ------------------------------ ---------- ----------
	 2 PDB$SEED			  READ ONLY  NO
	 3 FTEX 			  READ WRITE NO

SQL*Plus を終了します。

exit

AutoUpgrade は FTEX データベースをOracle 11.2.0.4 からOracle 19.5.0 へアップグレードするだけでなく、既存のCDBにもプラグインし、PDBに変換しました。

3.6. クリーンアップ

中断された DB12 のアップグレードから残った情報をクリーンアップしましょう。 – その後、再起動できます。

“クリーンアップ” とは、AutoUpgradeツールの内部状態をクリーンアップすることを意味します。これにより、 ログが保持されます。 – ただし、アップグレードを再度実行できます。あなたが削除する以前の実行からログをみたい場合は、手動でログディレクトリツリーを削除してください。

ただし FTEX データベースはすでに CDB2 にプラグインされているため、 upg2 のすべてのエントリを構成ファイルから削除する必要があります。そうしないと FTEX データベースが稼働していると予想されるため、AutoUpgrade がエラーになります。

任意のエディター (テキストモードもしくはグラフィカルモード)で /home/oracle/UP19.cfg ファイルを開きます。

  • テキスト モード:

    vi /home/oracle/UP19.cfg

  • グラフィカル モード:

    kwrite /home/oracle/UP19.cfg &

次のことを調整します。

UP19.cfg – でマークされた全ての行を削除します。: これは、ファイルがどのように見えるかです。
#Global configurations
#Autoupgrade's global directory, ...
#temp files created and other ...
#send here
global.autoupg_log_dir=/home/oracle/upg_logs


#
# Database number 1 
#
upg1.dbname=DB12
upg1.start_time=NOW
upg1.source_home=/u01/app/oracle/product/12.2.0.1
upg1.target_home=/u01/app/oracle/product/19
upg1.sid=DB12
upg1.log_dir=/home/oracle/upg_logs
upg1.upgrade_node=localhost
upg1.target_version=19
#upg1.run_utlrp=yes
upg1.timezone_upg=no

#
# Database number 2
#
upg2.dbname=FTEX
upg2.start_time=NOW
upg2.source_home=/u01/app/oracle/product/11.2.0.4 
upg2.target_home=/u01/app/oracle/product/19
upg2.sid=FTEX
upg2.log_dir=/home/oracle/upg_logs
upg2.upgrade_node=localhost
upg2.target_version=19
upg2.timezone_upg=no
upg2.restoration=no
upg2.target_cdb=CDB2
#Global configurations
#Autoupgrade's global directory, ...
#temp files created and other ...
#send here
global.autoupg_log_dir=/home/oracle/upg_logs


#
# Database number 1 
#
upg1.dbname=DB12
upg1.start_time=NOW
upg1.source_home=/u01/app/oracle/product/12.2.0.1
upg1.target_home=/u01/app/oracle/product/19
upg1.sid=DB12
upg1.log_dir=/home/oracle/upg_logs
upg1.upgrade_node=localhost
upg1.target_version=19
#upg1.run_utlrp=yes
upg1.timezone_upg=no

次にファイルを保存し、再度 /home/oracleUP19.cfg という名前を付けます。

AutoUpgradeツールは状態をリセットします.

java -jar $OH19/rdbms/admin/autoupgrade.jar -config /home/oracle/UP19.cfg -mode analyze -clear_recovery_data

$ java -jar $OH19/rdbms/admin/autoupgrade.jar -config /home/oracle/UP19.cfg -mode analyze -clear_recovery_data
The recovery data was removed, now you can start from scratch the AutoUpgrade

-mode analyze での実行を再度起動し、ジョブ番号を確認します。.

java -jar $OH19/rdbms/admin/autoupgrade.jar -config /home/oracle/UP19.cfg -mode analyze

lsj

upg> lsj
+----+-------+---------+---------+-------+--------------+--------+--------+---------------+
|Job#|DB_NAME|    STAGE|OPERATION| STATUS|    START_TIME|END_TIME| UPDATED|        MESSAGE|
+----+-------+---------+---------+-------+--------------+--------+--------+---------------+
| 104|   DB12|PRECHECKS|PREPARING|RUNNING|19/10/18 08:11|     N/A|08:11:27|Loading DB info|
+----+-------+---------+---------+-------+--------------+--------+--------+---------------+
Total jobs 1

別のアップグレードを起動することができます 🙂

おめでとうございます。 – Oracle 19cハンズオンラボの自動アップグレードを正常に完了しました!


Share this: