1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

@TDM26587

AutoUpgradeユーティリティによるRU適用

1
Last updated at Posted at 2026-08-21

はじめに

Oracle Database におけるアップグレード時の推奨ツールである AutoUpgrade でパッチを適用できることは、あまり知られていないかも知れません。
RACローリングやData Guardのスタンバイ・ファーストパッチ適用のような環境への対応ではなく、あくまでも計画停止時における手順の簡素化ではありますが重要なツールになると思われます。ここでは、AutoUpgrade ユーティリティで Oracle Database 19c (19.30) に対し p39472050 (19.32) を適用する手順を追ってみます。

AutoUpgrade ユーティリティとは

AutoUpgrade とは 19c (19.3) から標準で実装されたユーティリティで現在、Oracle では推奨のツールになります。18c以前は DBUA で行われていた機能を置き換える形になります。
Oracle AutoUpgradeユーティリティについて
現状、19cのマニュアルにおいては、パッチ適用についてもガイドされています。
AutoUpgradeパッチ適用
AutoUpgrade については Oracle Database Technology Night (#90) でも紹介されていますので参考になると思います。
Oracle Database Technology Night #90
Oracle Database Technology Night #90 Youtube

検証環境と手順

OCI上にインスタンスを準備します。ここに Oracle Database 19c (19.30) をインストールし、CDBを作成しました。
詳細に少し触れると、19.3のベース・イメージと、19.30 の RUを runInstaller 実行時に　-applyRU オプションを使用してバイナリをインストール後、通常どおり DBCAで Database を作成しています。

./runInstaller -applyRU RU19.30のディレクトリを指定する

Oracle Database 19c Enterprise Edition Release 19.0.0.0.0 - Production
Version 19.30.0.0.0 👈
に接続されました。
SQL> show pdbs

    CON_ID CON_NAME                       OPEN MODE  RESTRICTED
---------- ------------------------------ ---------- ----------
         2 PDB$SEED                       READ ONLY  NO
         3 ORCL1930PDB1                   READ WRITE NO
  • 必要となるコンポーネントを集める
    次に必要となるコンポーネントを集めます。具体的には 19.3 のベース・イメージ、19.32 RU、最新のOPatch、最新の AutoUpgrade ユーティリティです。
[oracle@instance-20260806-1440 ~]$ ls -l /u01/app/stage/
合計 5519620
-rw-r--r--. 1 oracle oinstall 2455930079  8月  5 04:21 p39472050_190000_Linux-x86-64.zip (19.32 RU)
-rw-r--r--. 1 oracle oinstall 3059705302  8月  6 03:09 LINUX.X64_193000_db_home.zip (19.3)
-rw-r--r--. 1 oracle oinstall  136447705  8月  7 05:22 p6880880_190000_Linux-x86-64.zip

※ 各コンポーネントのファイル名は Download した時のままにすること
最新のAutoUpgradeユーティリティはこちら
AutoUpgarde ユーティリティ

補足として最新版の確認手順は以下

[oracle@instance-20260806-1440 stage]$ java -jar autoupgrade.jar -version
build.version 26.4.260701　👈
build.date 2026/07/01 21:57:45 +0000
build.hash 211bf76de
build.hash_date 2026/06/27 01:28:23 +0000
build.supported_target_versions 12.2,18,19,21,23,26
build.type production
build.label (HEAD, tag: v26.4, origin/stable_devel, stable_devel) 
build.MOS_NOTE KB123450
build.MOS_LINK https://support.oracle.com/support/?anchorId=&kmContentId=2485457&page=sptemplate&sptemplate=km-article
mos/faces/DocumentDisplay?id=2485457.1

※ 現時点(2026年8月) で autoupgarde.jar はJava 26に対応していないことに注意

  • AutoUpgrade用のコンフィグファイルの作成
    Config ファイル (config32.cfgとした) を作成します。(あくまでサンプルです)
[oracle@instance-20260806-1440 stage]$ cat config32.cfg

global.global_log_dir=/u01/app/stage/autoupgrade_logs

db1932.sid=orcl1930
db1932.source_home=/u01/app/oracle/product/19.0.0/dbhome_1
db1932.target_home=/u01/app/oracle/product/19.32.0/dbhome_1
db1932.folder=/u01/app/stage
db1932.patch=RU:19.32,OPATCH 👈
db1932.method=outofplace

db1932.home_settings.ru_apply=yes

db1932.home_settings.oracle_base=/u01/app/oracle
db1932.home_settings.inventory_location=/u01/app/oraInventory
db1932.home_settings.inventory_group=oinstall
db1932.home_settings.osdba_group=dba
db1932.home_settings.osbackupdba_group=backupdba
db1932.home_settings.osdgdba_group=dgdba
db1932.home_settings.oskmdba_group=kmdba
db1932.home_settings.osracdba_group=racdba

db1932.download=NO

※ 19.32 のRUおよびOPATCHの最新版も適用する指定になっています。

  • 新しい ORACLE_HOME作成 (out-of-place パッチ適用)
    現在、推奨されている out-of-place によるパッチ適用手順確認のため、新しい ORACLE_HOMEとなるディレクトリを作成し、空の状態 にします。
    Autoupgrade.jar が zip を展開し、最新RU適用までを実行します。

  • AutoUpgradeパッチ適用　analyze モード

java -jar /u01/app/stage/autoupgrade.jar -config /u01/app/stage/config32.cfg -patch -mode analyze

==========================================
   AutoUpgrade Patching Summary Report
==========================================
[Date]           Wed Aug 12 05:47:47 GMT 2026
[Number of Jobs] 1
==========================================
[Job ID] 103
==========================================
[DB Name]                orcl1930
[Version Before AutoUpgrade Patching] 19.30.0.0.0
[Version After AutoUpgrade Patching]  19.32.0.0.260721
------------------------------------------
[Stage Name]    PENDING
[Status]        SUCCESS
[Start Time]    2026-08-12 05:46:28
[Duration]      0:00:00
[Log Directory] /u01/app/stage/autoupgrade_logs/orcl1930/103/pending
------------------------------------------
[Stage Name]    PRECHECKS
[Status]        SUCCESS
[Start Time]    2026-08-12 05:46:28
[Duration]      0:01:19
[Log Directory] /u01/app/stage/autoupgrade_logs/orcl1930/103/prechecks
[Detail]        /u01/app/stage/autoupgrade_logs/orcl1930/103/prechecks/orcl1930_preupgrade.log
                Check passed and no manual intervention needed

ジョブ 103 の内容確認
image.png

ただし、対象となる Database の設定に依存して警告がでる事に注意

  1. Archive Log Mode の設定
  2. FRA (Fast_Recovery_Area) の設定を行う必要があった
    ALTER SYSTEM SET DB_RECOVERY_FILE_DEST_SIZE = 100G SCOPE=BOTH;
    ALTER SYSTEM SET DB_RECOVERY_FILE_DEST = '/u01/app/oracle/fast_recovery_area/ORCL1930' SCOPE=BOTH;
  • AutoUpgradeパッチ適用　deploy モード
java -jar /u01/app/stage/autoupgrade.jar -config /u01/app/stage/config32.cfg -patch -mode deploy
AutoUpgrade Patching 26.4.260701はデフォルト内部オプションで起動されました
構成ファイルの処理中 ...
+-----------------------------------------+
| AutoUpgradeのパッチ適用の実行を開始しています |
+-----------------------------------------+
1 CDBと2 PDBが処理されます
コンソール・コマンドを一覧するには'help'と入力します
patch>

コマンドが実行されると、一度制御が戻りコマンドの入力が可能な CLI (patch>) になり、ここでステータスを確認するためのコマンド実行が可能になる。

  • 実行中のジョブをリスト
patch> lsj
+----+--------+-------+---------+-------+----------+-------+-----------------------+
|ジョブ#| DB_NAME|  STAGE|OPERATION| STATUS|START_TIME|UPDATED|                MESSAGE|
+----+--------+-------+---------+-------+----------+-------+-----------------------+
| 105|orcl1930|INSTALL|EXECUTING|RUNNING|  04:17:19|   29秒前|ORACLE_HOMEをインストールしています|
+----+--------+-------+---------+-------+----------+-------+-----------------------+
ジョブの合計 1
  • ステータスの確認
patch> status

構成
       ユーザー構成ファイル    [/u01/app/stage/config32.cfg]
       一般ログの場所      [/u01/app/stage/autoupgrade_logs/cfgtoollogs/patch/auto]
       モード                       [DEPLOY]
ジョブのサマリー
       構成ファイル[3]のデータベース合計
       処理中の非CDB合計         [0]
       処理中のコンテナ合計      [3]

       正常に終了したジョブ            [0]
       終了/停止したジョブ                 [0]
       進行中のジョブ                      [1]

進行
       +---+---------------------------------------------------------+
       |ジョブ|                                                       進行|
       +---+---------------------------------------------------------+
       |105|[||||||||||||||||                                  ] 31 %|
       +---+---------------------------------------------------------+
  • 実行中のジョブ105について詳細をリストする
patch> status -job 105
詳細

       ジョブ番号           105
       Oracle SID       orcl1930
       開始時間       26/08/13 04:17:19
       経過時間(分):   6
       終了時間:        N/A

ログ・ファイル

       ログ・ベース:    /u01/app/stage/autoupgrade_logs/orcl1930
       ジョブ・ログ:     /u01/app/stage/autoupgrade_logs/orcl1930/105
       ステージ・ログ:   /u01/app/stage/autoupgrade_logs/orcl1930/105/install
       タイムゾーン:     /u01/app/stage/autoupgrade_logs/orcl1930/temp
       リモート・ディレクトリ:

ステージ
       PENDING          <1 min
       GRP              <1 min
       PREACTIONS       <1 min
       PRECHECKS        1 min
       PREFIXUPS        1 min
       EXTRACT          1 min
       DBTOOLS          <1 min
       INSTALL          ~1 min (RUNNING)
       OH_PATCHING
       OPTIONS
       ROOTSH
       DB_PATCHING
       POSTCHECKS
       POSTFIXUPS
       POSTACTIONS

コンテナごとのステージ進行状況

       ステージINSTALLには表示するデータがありません

全てのステージが完了すると以下が表示され、プロンプトが返る

patch> Job 105 completed
------------------- 最終サマリー --------------------
データベースの数            [ 1 ]
 
終了したジョブ                  [1]
失敗したジョブ                    [0]
リストアしたジョブ                  [0]
保留中のジョブ                   [0]
 
# Run the root.sh script as root for the following jobs:
対象 orcl1930 -> /u01/app/oracle/product/19.32.0/dbhome_1/root.sh
 
---- 不要になったと判断したら、都合のよいときにGRPを削除してくだい ----
orcl1930からGRPを削除します: リストア・ポイントAU_PATCHING_9212_ORCL19301930000を削除します
 
次の場所にあるサマリー・レポートを確認してください:
/u01/app/stage/autoupgrade_logs/cfgtoollogs/patch/auto/status/status.html
/u01/app/stage/autoupgrade_logs/cfgtoollogs/patch/auto/status/status.log
[oracle@instance-20260806-1440 bin]$
  • RU適用時の各ステージの解説
RU適用ステージ アクション
PENDING 情報メッセージ
GRP 保証付きリストア・ポイント(GRP)
PREACTIONS before_actionパラメータで定義されたアクション
PRECHECKS 要件を満たしているかどうかを判定
PREFIXUPS ディクショナリ統計を収集するステージ
EXTRACT Oracleホームの作成時に使用される必要なファイルを抽出
DBTOOLS 新しいバージョンのOPatchをターゲットOracleホームにインストール
INSTALL runInstallerをサイレント・モードで実行
OH_PATCHING 必要な各パッチをOracleホームにインストール
OPTIONS バイナリ・オプションを、新しく作成されたターゲットORACLE_HOMEと同期
ROOTSH orainstRoot.shスクリプトを実行
DB_PATCHING データベースをソースOracleホームからターゲットOracleホームに移動
POSTCHECKS パッチ適用後チェックを実行
POSTFIXUPS 事後チェックに対して、修正を実行
POSTACTIONS after_actionパラメータで定義されたアクション

image.png

  • status.log の内容を確認
[oracle@instance-20260806-1440 bin]$cat /u01/app/stage/autoupgrade_logs/cfgtoollogs/patch/auto/status/status.log

==========================================
   AutoUpgrade Patching Summary Report
==========================================
[Date]           Thu Aug 13 04:36:27 GMT 2026
[Number of Jobs] 1
==========================================
[Job ID] 105
==========================================
[DB Name]                orcl1930
[Version Before AutoUpgrade Patching] 19.30.0.0.0
[Version After AutoUpgrade Patching]  19.32.0.0.260721
------------------------------------------
[Stage Name]    PENDING
[Status]        SUCCESS
[Start Time]    2026-08-13 04:17:20
[Duration]      0:00:00
[Log Directory] /u01/app/stage/autoupgrade_logs/orcl1930/105/pending
------------------------------------------
[Stage Name]    GRP
[Status]        SUCCESS
[Start Time]    2026-08-13 04:17:20
[Duration]      0:00:00
[Log Directory] /u01/app/stage/autoupgrade_logs/orcl1930/105/grp
[Detail]        Please drop the following GRPs after {0} completes:
                 AU_PATCHING_9212_ORCL19301930000
------------------------------------------
[Stage Name]    PREACTIONS
[Status]        SUCCESS
[Start Time]    2026-08-13 04:17:20
[Duration]      0:00:00
[Log Directory] /u01/app/stage/autoupgrade_logs/orcl1930/105/preaction
------------------------------------------
[Stage Name]    PRECHECKS
[Status]        SUCCESS
[Start Time]    2026-08-13 04:17:21
[Duration]      0:01:16
[Log Directory] /u01/app/stage/autoupgrade_logs/orcl1930/105/prechecks
[Detail]        /u01/app/stage/autoupgrade_logs/orcl1930/105/prechecks/orcl1930_preupgrade.log
                Check passed and no manual intervention needed
------------------------------------------
[Stage Name]    PREFIXUPS
[Status]        SUCCESS
[Start Time]    2026-08-13 04:18:37
[Duration]      0:01:54
[Log Directory] /u01/app/stage/autoupgrade_logs/orcl1930/105/prefixups
[Detail]        /u01/app/stage/autoupgrade_logs/orcl1930/105/prefixups/prefixups.html
------------------------------------------
[Stage Name]    EXTRACT
[Status]        SUCCESS
[Start Time]    2026-08-13 04:20:31
[Duration]      0:01:21
[Log Directory] /u01/app/stage/autoupgrade_logs/orcl1930/105/extract
------------------------------------------
[Stage Name]    DBTOOLS
[Status]        SUCCESS
[Start Time]    2026-08-13 04:21:53
[Duration]      0:00:03
[Log Directory] /u01/app/stage/autoupgrade_logs/orcl1930/105/dbtools
------------------------------------------
[Stage Name]    INSTALL
[Status]        SUCCESS
[Start Time]    2026-08-13 04:21:57
[Duration]      0:08:11
[Log Directory] /u01/app/stage/autoupgrade_logs/orcl1930/105/install
------------------------------------------
[Stage Name]    OH_PATCHING
[Status]        SUCCESS
[Start Time]    2026-08-13 04:30:08
[Duration]      0:00:00
[Log Directory] /u01/app/stage/autoupgrade_logs/orcl1930/105/opatch
------------------------------------------
[Stage Name]    OPTIONS
[Status]        SUCCESS
[Start Time]    2026-08-13 04:30:08
[Duration]      0:00:00
[Log Directory] /u01/app/stage/autoupgrade_logs/orcl1930/105/options
------------------------------------------
[Stage Name]    ROOTSH
[Status]        SUCCESS
[Start Time]    2026-08-13 04:30:08
[Duration]      0:00:00
[Log Directory] /u01/app/stage/autoupgrade_logs/orcl1930/105/rootsh
------------------------------------------
[Stage Name]    DISPATCH
[Status]        SUCCESS
[Start Time]    2026-08-13 04:30:08
[Duration]      0:00:00
[Log Directory] /u01/app/stage/autoupgrade_logs/orcl1930/105/dispatch
------------------------------------------
[Stage Name]    DB_PATCHING
[Status]        SUCCESS
[Start Time]    2026-08-13 04:30:08
[Duration]      0:06:07
[Log Directory] /u01/app/stage/autoupgrade_logs/orcl1930/105/db_patching
------------------------------------------
[Stage Name]    POSTCHECKS
[Status]        SUCCESS
[Start Time]    2026-08-13 04:36:16
[Duration]      0:00:01
[Log Directory] /u01/app/stage/autoupgrade_logs/orcl1930/105/postchecks
[Detail]        /u01/app/stage/autoupgrade_logs/orcl1930/105/postchecks/orcl1930_postupgrade.log
                Check passed and no manual intervention needed
------------------------------------------
[Stage Name]    POSTFIXUPS
[Status]        SUCCESS
[Start Time]    2026-08-13 04:36:18
[Duration]      0:00:08
[Log Directory] /u01/app/stage/autoupgrade_logs/orcl1930/105/postfixups
[Detail]        /u01/app/stage/autoupgrade_logs/orcl1930/105/postfixups/postfixups.html
------------------------------------------
[Stage Name]    POSTACTIONS
[Status]        SUCCESS
[Start Time]    2026-08-13 04:36:27
[Duration]      0:00:00
[Log Directory] /u01/app/stage/autoupgrade_logs/orcl1930/105/postaction
------------------------------------------
Summary:/u01/app/stage/autoupgrade_logs/orcl1930/105/db_patching/orcl1930/105/dbupgrade/datapatch_summary.log not found
  • Database の状態を確認
[oracle@instance-20260806-1440 ~]$ sqlplus / as sysdba
 
SQL*Plus: Release 19.0.0.0.0 - Production on 木 8月 13 04:41:55 2026
Version 19.32.0.0.0 👈
 
Copyright (c) 1982, 2026, Oracle.  All rights reserved.
 
アイドル・インスタンスに接続しました。
 
SQL> startup
ORACLEインスタンスが起動しました。
 
Total System Global Area 1.3120E+10 bytes
Fixed Size                 13925968 bytes
Variable Size            2046820352 bytes
Database Buffers         1.1039E+10 bytes
Redo Buffers               19628032 bytes
データベースがマウントされました。
データベースがオープンされました。
SQL> show pdbs
 
    CON_ID CON_NAME                       OPEN MODE  RESTRICTED
---------- ------------------------------ ---------- ----------
         2 PDB$SEED                       READ ONLY  NO
         3 ORCL1930PDB1                   READ WRITE NO
 
 
SQL> SELECT patch_id,
       patch_type,
       action,
       status,
       description,
       act  2    3    4    5    6  ion_time
FROM   dba_registry_sqlpatch
ORDER BY action_time DESC;  7    8


  PATCH_ID PATCH_TYPE ACTION          STATUS
---------- ---------- --------------- -------------------------
DESCRIPTION
--------------------------------------------------------------------------------
ACTION_TIME
---------------------------------------------------------------------------
  39472050 RU         APPLY           SUCCESS
Database Release Update : 19.32.0.0.260721 (39472050)
26-08-13 04:33:34.139050　👈
 
  38632161 RU         APPLY           SUCCESS
Database Release Update : 19.30.0.0.260120(REL-JAN260130) (38632161)
26-08-07 07:09:12.505819
 
  PATCH_ID PATCH_TYPE ACTION          STATUS
---------- ---------- --------------- -------------------------
DESCRIPTION
--------------------------------------------------------------------------------
ACTION_TIME
---------------------------------------------------------------------------

SQL Developer からも確認してみる

image.png

oraInventry による確認も行ってみる。

[oracle@instance-20260806-1440 ~]$ $ORACLE_HOME/OPatch/opatch lspatches
39472050;Database Release Update : 19.32.0.0.260721 (39472050)
29585399;OCW RELEASE UPDATE 19.3.0.0.0 (29585399)
 
OPatch succeeded.
 
[oracle@instance-20260806-1440 ~]$ $ORACLE_HOME/OPatch/opatch lsinventory
Oracle Interim Patch Installerバージョン12.2.0.1.52
Copyright (c) 2026, Oracle Corporation.  All rights reserved。
 
 
Oracleホーム       : /u01/app/oracle/product/19.32.0/dbhome_1
中央インベントリ : /u01/app/oraInventory
   元           : /u01/app/oracle/product/19.32.0/dbhome_1/oraInst.loc
OPatchのバージョン    : 12.2.0.1.52
OUIのバージョン       : 12.2.0.7.0
ログ・ファイルの場所 : /u01/app/oracle/product/19.32.0/dbhome_1/cfgtoollogs/opatch/opatch2026-08-13_05-01-36午前_1.log
 
Lsinventory Output file location : /u01/app/oracle/product/19.32.0/dbhome_1/cfgtoollogs/opatch/lsinv/lsinventory2026-08-13_05-01-36午前.txt
--------------------------------------------------------------------------------
Local Machine Information::
Hostname: instance-20260806-1440.sub02050642320.mc3vcn.oraclevcn.com
ARU platform id: 226
ARU platform description:: Linux x86-64
 
インストールされた最上位製品(1):
 
Oracle Database 19c                                                  19.0.0.0.0
このOracleホームには1の製品がインストールされています。
 
 
個別パッチ(2) :
 
Patch  39472050     : applied on Thu Aug 13 04:26:18 GMT 2026
Unique Patch ID:  28919163
Patch description:  "Database Release Update : 19.32.0.0.260721 (39472050)"
   Created on 13 Jul 2026, 14:51:25 hrs UTC
   Bugs fixed:
     10121473, 10123661, 12608302, 1297945, 13087312, 13801211, 14570574
     14735102, 15878434, 15931756, 15959416, 16662822, 16664572, 16750494
     17275499, 17395507, 17428816, 17468475, 17562236, 17777718, 18534283
     18697534, 18792392, 18943905, 19080742, 19138896, 19147630, 19226753
     19247024, 19630878, 19697993, 19884953, 19958239, 20007421, 20044584
     20083476, 20289608, 20313356, 20319830, 20351180, 20479545, 20661314
     20721183, 20867658, 20922160, 21119541, 21217621, 21232786, 21245711
     21374587, 21528318, 21533734, 21629064, 21639146, 21888352, 21965541
     22066547, 22212642, 22252368, 22325312, 22387320, 22553815, 22580355
     22599382, 22669262, 22725871, 22729345, 22748979, 22813401, 22901337
     23020668, 23066463, 23094775, 23125587, 23220873, 23294761, 23296836

…… 以下、省略

最後に

AutoUpgrade ユーティリティによる RU適用は、コンフィグ・ファイルの作成が中心であり、操作もシンプルです。今回は設定しませんでしたが、必要なパッチをMOSから Download する設定も可能です。
多くのDatabaseを管理している場合や、長期的にOracle Database の運用を念頭にRU適用からアップグレードまでを定型化したい場合には有益なツールに思えます。
Out-of-place であればパッチの競合回避や、パッチを含め、環境のロールバックも可能であるため作業者の負担も大きく削減できると思います。

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?