AutoUpgrade構成ファイルのローカル・パラメータ

AutoUpgradeユーティリティのアップグレード用に特定のOracle Databaseの情報を構成するには、AutoUpgradeローカル・パラメータに情報を指定します。

使用上のノート

ローカル・パラメータは、AutoUpgrade構成ファイルで設定されたグローバル・パラメータよりも優先されます。ローカルで設定する必要があるか、ローカルで変更可能なグローバル・パラメータとして設定する必要があるローカル・パラメータは(「必須」)で示されます。すべてのローカル・パラメータは接頭辞を使用します(例: 特定のデータベースまたはアップグレードを識別するために定義する値で識別)。接頭辞は、構成ファイルでパラメータが適用される特定のアップグレード・ジョブを識別します。

例: 構成ファイルの最初のアップグレードのパラメータのセットでは、接頭辞salesが使用され、構成ファイル内の次のアップグレードのパラメータのセットでは、接頭辞employeesが使用されます。

sales.source_home=/u01/app/oracle/12.2/dbhome1
.
.
.
employees.sid=salescdb
employees.source_home-/03/app/oracle/21/dbhome1

• add_after_upgrade_pfile
  (オプション)アップグレード後にパラメータを追加するPFILEのパスおよびファイル名を指定します。
• add_during_upgrade_pfile
  (オプション)アップグレード中にパラメータを追加するPFILEのパスおよびファイル名を指定します。
• after_action
  (オプション)deployモードでは、接頭辞アドレスで識別されるデータベースのデプロイ・ジョブの完了後に実行するカスタム・アクションを指定します。
• before_action
  (オプション) deployモードでは、接頭辞で指定された特定のデータベース・ジョブのアップグレード・ジョブの起動前に実行するカスタム・アクションを指定します。すべてのアップグレード・ジョブの前にスクリプトを実行する場合は、ローカル・パラメータ (global.before_action)を使用してそのスクリプトを指定します
• catctl_options
  (オプション) AutoUpgradeがcatctl.plに送信してデフォルトの動作をオーバーライドするために選択できるcatctl.plオプションのセットを1つ以上指定します。
• checklist
  (オプション)ポリシーまたはセキュリティ上の問題のために自動的に実装しない修正など、AutoUpgradeによって実行される修正のデフォルト・リストをオーバーライドするために使用できるチェックリストへのパスを指定します。
• del_after_upgrade_pfile
  (オプション)アップグレード後にパラメータを削除するPFILEのパスおよびファイル名を指定します。
• del_during_upgrade_pfile
  (オプション)アップグレード中にパラメータを削除するPFILEのパスおよびファイル名を指定します。
• drop_win_src_service
  (オプション) Microsoft Windowsでのアップグレードの場合、アップグレード後にソースOracle DatabaseのWindowsオペレーティング・システム・サービスを削除するかどうかを指定します。
• env
  (オプション) ORACLE_SID、ORACLE_HOME、ORACLE_BASEおよびTNS_ADMINを除く、オペレーティング・システムに設定されているカスタム・オペレーティング・システム環境変数を指定します。
• exclusion_list
  (オプション) AutoUpgrade実行から除外するPDBのリストを設定します。このパラメータは、マルチテナント・アーキテクチャ(CDB)データベースにのみ適用されます。非CDBデータベースを接続およびアップグレードしている場合、このパラメータは無視されます。
• ignore_errors
  (オプション)アップグレードまたはパッチ適用プロセス中にAutoUpgradeで無視する特定のOracleエラーのカンマ区切りリストを指定できます。
• keep_source_pdb
  (オプション)切断/接続アップグレード操作のソースPDBが、ソースCDBから削除されるのではなく、閉じた状態に保持されるかどうかを指定します。
• log_dir
  (オプション)パラメータの接頭辞で識別されるアップグレード・ジョブに含まれるデータベース・セットにあるデータベース・アップグレード用に生成されるログ・ファイルの場所を設定します。
• manage_standbys_clause
  (オプション) DB_UNIQUE_NAMEで特定したスタンバイOracle Data Guardスタンバイ・データベースをAutoUpgradeプラグイン・アップグレードから除外して、スタンバイ・データベース・ファイルを再利用できるかどうかを指定します。
• pdbs
  (オプション)アップグレードを実行するPDBのリストを設定します。このパラメータは、マルチテナント・アーキテクチャ(CDB)データベースのアップグレードにのみ適用されます。非CDBデータベースを接続およびアップグレードしている場合、このパラメータは無視されます。
• raise_compatible
  (オプション)アップグレードが正常に完了した後、Oracle DatabaseのCOMPATIBLE初期化パラメータをターゲット・リリースのデフォルト値まで増やします。
• remove_rac_config
  (オプション)ターゲットCDBホームへの正常な変換後にソースOracleホームのクラスタウェアから非CDB Oracle RACデータベースを削除するか、ソース・データベースを変更せずに残すかを指定します。
• remove_underscore_parameters
  (オプション)構成ファイル内のすべてのOracle Databaseについて、アップグレード中およびアップグレード後にPFILEファイルからアンダースコア(非表示)パラメータを削除します。
• replay
  (オプション)リプレイを使用してデータベースをアップグレードするかどうかを指定します。
• restoration
  (オプション)データベースのリストアに保証付きリストア・ポイント(GRP)を生成します。
• revert_after_action
  (オプション)接頭辞によって指定された特定のデータベース・ジョブに対してシステムのリストアが完了し、データベースが稼働した後にオペレーティング・システムで実行するカスタム・アクションを指定します。
• revert_before_action
  (オプション)接頭辞によって指定された特定のデータベース・ジョブに対してシステムのリストアが完了し、データベースが稼働する前にオペレーティング・システムで実行するカスタム・アクションを指定します。
• run_hcheck
  (オプション)アップグレード前のチェックの一部としてOracle Dictionary Health Checksを実行して、データベース・ディクショナリの不整合を特定するかどうかを指定します。
• run_utlrp
  (オプション)アップグレードの一環としてutlrpを有効または無効にします。
• sid
  (必須)アップグレードするデータベースのOracleシステム識別子(SID)を示します。
• skip_tde_key_import
  (オプション) yesに設定すると、アップグレードは実行されますが、ソース・データベースKeyStoreのターゲット・データベースへのインポートはスキップされ、エラーは発生しません。
• source_base
  (オプション)ソースOracleホームのソースORACLE_BASEパスを指定します。
• source_dblink
  (オプション)切断/接続再配置(ホット・クローン)アップグレード用に設定されたデータベース・リンクを指定します。
• source_home
  (分析モード、修正モードおよびデプロイ・モードの場合は必須です。アップグレード・モードの場合はオプションです。)アップグレードするデータベースの現在のOracleホーム(ORACLE_HOME)。
• source_ldap_admin_dir
  (オプション)ソース・データベース・ホームのLDAP_ADMINディレクトリへのパスを指定します。
• source_tns_admin_dir
  (オプション)ソース・データベース・ホームのTNS_ADMINディレクトリへのパスを指定します。
• start_time
  (オプション)アップグレード・ジョブを実行する将来の起動時間を設定します。このパラメータは、アップグレード・ジョブをスケジュールしてサーバーの負荷を分散し、複数のジョブが即時に起動されないようにするために使用します。
• target_base
  (オプション)ターゲットOracleホームのターゲットORACLE_BASEパスを指定します。
• target_cdb
  (オプション)非CDB Oracleデータベースが接続されるターゲットCDBのSIDを指定します。このパラメータは、非CDBのOracleデータベースをアップグレードおよび変換する場合に必須です。
• target_pdb_copy_option=file_name_convert
  (オプション)非CDBデータベースをPDBに変換する場合、または別のソースCDBの既存のPDBを指定のターゲットCDBのPDBに変換する場合にAutoUpgradeが実行する、プラガブル・データベースを作成する文で使用されるfile_name_convertオプションを指定します。
• target_pdb_name
  (オプション)ターゲットCDBに接続された後に、非CDBのソースOracleデータベースに割り当てる名前を指定します。
• target_ldap_admin_dir
  (オプション)ターゲット・データベース・ホームのLDAP_ADMINディレクトリへのパスを指定します。
• target_tns_admin_dir
  (オプション)ターゲット・データベース・ホームのTNS_ADMINディレクトリへのパスを指定します。
• timezone_upg
  (オプション) AutoUpgradeプロセスの一環としてタイムゾーンのアップグレードの実行を有効または無効にします。
• tune_setting
  (オプション)指定したワークフロー・オプションに応じて、実行時にAutoUpgradeの動作を変更する特別なワークフローを有効にします。
• upgrade_node
  (オプション)現在のユーザー構成が有効なノードを指定します。デフォルト値はlocalhostです。

add_after_upgrade_pfile

(オプション)アップグレード後にパラメータを追加するPFILEのパスおよびファイル名を指定します。

例

sales3.add_after_upgrade_pfile=/path/to/my/pfile_add.ora

add_during_upgrade_pfile

(オプション)アップグレード時にパラメータを追加するPFILEのパスおよびファイル名を指定します。

例

sales3.add_during_upgrade_pfile=/path/to/my/newpfile.ora

after_action

(オプション) deployモードでは、接頭辞アドレスで識別されるデータベースのデプロイ・ジョブの完了後に実行するカスタム・アクションを指定します。

使用上のノート

使用するスクリプトはname.ext (たとえば、myscript.sh)の形式である必要があります。これにより、AutoUpgradeは実行するスクリプトのタイプを識別できます。許可される拡張子オプションは、次のとおりです。

• UNIXシェル(.sh)

• Microsoft Windowsバッチ(.bat、.cmd)

• Microsoft Windows PowerShell (.ps1)

• Oracle SQLファイル(.sql)。接頭辞によって指定されたローカル操作のみ。

デフォルトでは、スクリプトが失敗すると、AutoUpgradeが引き続き実行されます。オペレーティング・システムがスクリプトの失敗を検出した場合、Yフラグを使用してAutoUpgradeが停止するように指定します。スクリプトが0とは異なるステータスで終了すると、失敗して完了したとみなされます。

グローバルのafter_actionパラメータとは対照的に、ローカルのafter_actionパラメータはSQLスクリプトを指定でき、非CDBのOracleホーム上のターゲットOracleデータベース・バイナリまたはCDB$ROOTを使用してデータベースで実行されます。追加のコンテナ固有のアクションを実行する場合、コード内でこれらを設定する必要があります。より複雑なシナリオでは、シェルでコンテナ固有のアクションを実行できます。

スクリプトの出力が取得され、ファイルに格納されます。stdoutとstderrの両方が取得されます。ファイルは、特定のデータベースまたはジョブに一致するディレクトリのpostupgradeサブディレクトリに格納されます。

次の環境変数はスクリプトを実行するシェルに設定されます。

• ORACLE_SID
• ORACLE_UNQNAME
• ORACLE_BASE
• ORACLE_HOME
• TNS_ADMIN

例

AutoUpgradeが処理を開始した後に、指定したスクリプトを実行します。スクリプトが失敗した場合にAutoUpgradeを停止するには、次のようにYフラグを設定します。

sales2.after_action=/user/path/script.sh Y 

AutoUpgradeがデプロイ・オプションの処理を開始した後、指定したスクリプトを実行します。スクリプトが失敗した場合に実行を継続するには、次のようにAutoUpgradeを設定します。

sales3.after_action=/user/path/script.sh 

before_action

(オプション) deployモードでは、接頭辞で指定された特定のデータベース・ジョブのアップグレード・ジョブの起動前に実行するカスタム・アクションを指定します。すべてのアップグレード・ジョブの前にスクリプトを実行する場合は、ローカル・パラメータ (global.before_action)を使用してそのスクリプトを指定します

使用上のノート

使用するスクリプトはname.ext (たとえば、myscript.sh)の形式である必要があります。これにより、AutoUpgradeは実行するスクリプトのタイプを識別できます。許可される拡張子オプションは、次のとおりです。

• UNIXシェル(.sh)

• Microsoft Windowsバッチ(.bat、.cmd)

• Microsoft Windows PowerShell (.ps1)

• Oracle SQLファイル(.sql)。接頭辞によって指定されたローカル操作の場合のみ。

デフォルトでは、スクリプトが失敗すると、AutoUpgradeが引き続き実行されます。オペレーティング・システムがスクリプトの失敗を検出した場合、Yフラグを使用してAutoUpgradeが停止するように指定します。スクリプトが0とは異なるステータスで終了すると、失敗して完了したとみなされます。

グローバルbefore_actionパラメータとは対照的に、ローカルbefore_actionパラメータはSQLスクリプトを指定でき、これは前のリリースのOracle Databaseバイナリを使用して、ソース・データベースのOracleホームのデータベースで実行されます。スクリプトは非CDBのOracleホームまたはCDB$ROOTで実行されます。追加のコンテナ固有のアクションを実行する場合、コード内でこれらを設定する必要があります。より複雑なシナリオでは、シェルでコンテナ固有のアクションを実行できます。

スクリプトの出力が取得され、ファイルに格納されます。stdoutとstderrの両方が取得されます。ファイルは、特定のデータベースまたはジョブに一致するディレクトリのpreupgradeサブディレクトリに格納されます。

次の環境変数はスクリプトを実行するシェルに設定されます。

• ORACLE_SID
• ORACLE_UNQNAME
• ORACLE_BASE
• ORACLE_HOME
• TNS_ADMIN

例

AutoUpgradeがdeployモードの処理を開始する前に、指定したスクリプトを実行します。スクリプトが失敗した場合にAutoUpgradeを停止するには、次のようにYフラグを設定します。

sales.before_action=/user/path/script.sh Y 

AutoUpgradeが処理を開始する前に、指定したスクリプトを実行します。スクリプトが失敗した場合実行を継続するには、次のようにAutoUpgradeを設定します。

sales4.before_action=/user/path/script.sh 

catctl_options

(オプション) AutoUpgradeがcatctl.plに送信してデフォルトの動作をオーバーライドするために選択できるcatctl.plオプションのセットを1つ以上指定します。

使用上のノート

使用可能なcatctl.plオプション:

• -n パラレル操作に使用するプロセス数。リプレイ・アップグレードの場合、アップグレードに使用されるパラレル・プロセスの数は、CPU_COUNTを4で割った値にデフォルト設定されます。クラシック・アップグレードの場合、CDB$ROOTのデフォルトは8です。
• -N PDBのアップグレード時に使用するプロセッサの数。リプレイ・アップグレードの場合、アップグレードに使用されるパラレル・プロセスの数は、CPU_COUNTを4で割った値にデフォルト設定されます。クラシック・アップグレードの場合、デフォルトは2です
• -T オフラインのユーザー・スキーマベースの表領域を取得します。
• -z catcon.plの本番デバッグ情報を有効にします。

例

sales4.catctl_options=-n 24 -N 4

checklist

(オプション)ポリシーまたはセキュリティ上の問題のために自動的に実装しない修正など、AutoUpgradeによって実行される修正のデフォルト・リストをオーバーライドするために使用できるチェックリストへのパスを指定します。

使用上のノート

他のAutoUpgradeモードでこのパラメータを使用するには、analyzeモードでAutoUpgradeを実行する必要があります。AutoUpgradeで分析が終了すると、事前チェック・ディレクトリ(dbname_checklist.cfg)の下のデータベース名によって識別されるチェックリスト・ファイルを検索できます。ファイルを手動で更新して、AutoUpgradeでバイパスする修正を除外し、ファイルを新しい名前で保存します。AutoUpgradeを再度実行すると、作成したチェックリスト・ファイルを指すパラメータを指定し、個々のデータベースに対して実行された修正を変更できます。チェックリスト・ファイル・パスを指定しない場合、アップグレード時に実行される修正のセットは、指定したデプロイ・モードで作成される最新バージョンのチェックリスト・ファイルです。

例

sales.checklist=/u01/app/oracle/upgrade-jobs/salesdb_checklist.cfg

前述の例では、salesdb_checklist.cfgはデータベースsalesdbのチェックリスト構成ファイルです。

del_after_upgrade_pfile

(オプション)アップグレード後にパラメータを削除するPFILEのパスおよびファイル名を指定します。

例

sales3.del_after_upgrade_pfile=/path/to/my/pfile_del.ora

del_during_upgrade_pfile

(オプション)アップグレード時にパラメータを削除するPFILEのパスおよびファイル名を指定します。

例

sales3.del_during_upgrade_pfile=/path/to/my/oldpfile.ora

drop_win_src_service

(オプション) Microsoft Windowsでのアップグレードの場合、アップグレード後にソースOracle DatabaseのWindowsオペレーティング・システム・サービスを削除するかどうかを指定します。

使用上のノート

デフォルトでは、Microsoft Windowsオペレーティング・システムでのOracle Databaseアップグレードの場合、AutoUpgradeによってWindows Oracle Databaseサービスが停止され、アップグレードが完了すると、サービスはそのまま残ります。サービスを停止したままにしておくと、データベースのMicrosoft Windowsサービスを再作成しなくても、データベースをソースOracleホームにリストアできます。ただし、アップグレードが正常に完了した後、ソース・データベースのMicrosoft Windowsサービスを自動的に削除することを選択できます。noが指定されているか、値が指定されていない場合、サービスはソース上で停止されますが、アップグレード後にそのまま残されます。

オプション

[yes | no]

デフォルト値はnoです。

例

upg1.drop_win_src_service=yes 

env

(オプション) ORACLE_SID、ORACLE_HOME、ORACLE_BASEおよびTNS_ADMINを除く、オペレーティング・システムに設定されているカスタム・オペレーティング・システム環境変数を指定します。

使用上のノート

このパラメータを使用して、データベースsqlnet.oraファイルに示されている環境設定(Oracleウォレットに使用されるセキュア・ソケット・レイヤー暗号スイートなど)を指定します。複数設定するには、カンマで区切ります。

構文:

prefix=VARIABLE1=value1 [, VARIABLE2=value2, ...]

例

PDB sales2の場合、WALLET_LOCATIONの値はカスタム環境変数を使用して設定されるとします。

WALLET_LOCATION=
  (SOURCE=
    (METHOD=file)
    (METHOD_DATA=(DIRECTORY=/databases/wallets/$CUSTOM_ENV1/$CUSTOM_ENV2))

その場合、AutoUpgradeでそれらのカスタム環境変数の値を認識するには、envパラメータ(dir1は環境変数CUSTOM_ENV1によって指定されるパス、dir2はCUSTOM_ENV2によって指定されるパス)を使用して指定する必要があります。

sales2.env=CUSTOM_ENV1=dir1,CUSTOM_ENV2=dir2

exclusion_list

(オプション)AutoUpgrade実行から除外するPDBのリストを設定します。このパラメータは、マルチテナント・アーキテクチャ(CDB)データベースにのみ適用されます。非CDBデータベースを接続およびアップグレードしている場合、このパラメータは無視されます。

使用上のノート

このパラメータを使用して、AutoUpgrade実行から除外するPDBのリストを指定します。PDBリストはカンマで区切ります。PDB名のリストまたはアスタリスク(*)のいずれかを含めることができます。これは、AutoUpgradeの実行時にCDBでオープンしているすべてのPDBを除外することを示します。

構文:

prefix.exclusion_list=[pdb-name|*][,pdb-name,...]

例

PDB pdb1およびpdb2をcdb sales1のアップグレードから除外するとします。構成ファイルの次のエントリは、pdb1およびpdb2をAutoUpgradeの実行中の処理から除外します。

sales1.exclusion_list=pdb1,pdb2

構成ファイルのこのエントリは、CDB sales2からオープンしているすべてのPDBを除外します。

sales2.exclusion_list=*

ignore_errors

(オプション)アップグレードまたはパッチ適用プロセス中にAutoUpgradeで無視する特定のOracleエラーのカンマ区切りリストを指定できます。

使用上のノート

このパラメータを構成ファイルに追加すると、指定したアップグレード接頭辞のアップグレード中に、指定したエラー番号は無視されます。

例

sales3.ignore_errors=ORA-48181,ORA-00001

keep_source_pdb

(オプション)切断/接続アップグレード操作のソースPDBが、ソースCDBから削除されるのではなく、閉じた状態に保持されるかどうかを指定します。

使用上のノート

デフォルトでは、ソースPDBはアップグレード・プロセス中にソースCDBから削除されます。keep_source_pdbがYESに設定されている場合、ソースPDBは以前のリリース・システムから削除されません。パラメータtarget_pdb_copy_optionでコピー・オプションが指定されている場合のみ、パラメータをYESに設定できます。コピー・オプションを使用しない場合、PDBを削除する必要があるため、このパラメータは無視されます。コピーがない場合、既存のデータファイルは単一のCDBでのみ使用できます。

オプション

[yes | no]

デフォルト値はnoです。

例

sales1.keep_source_pdb=yes

log_dir

(オプション)パラメータの接頭辞で識別されるアップグレード・ジョブに含まれるデータベース・セットにあるデータベース・アップグレード用に生成されるログ・ファイルの場所を設定します。

使用上のノート

設定すると、AutoUpgradeは、指定したローカル・ログ・ファイル・パスに基づいて階層ディレクトリを作成します。たとえば、ジョブ識別子の接頭辞はsalesで、log_dirはupgrade-jobsとして識別され、stage1、stage2およびstagenはアップグレードのステージを表します。

/u01/app/oracle/upgrade-jobs
                                      /temp/
                                      /sales/
                                      /sales/stage1
                                      /sales/stage2
                                      /sales/stagen

チルダ(~)など、パスにワイルド・カードを使用することはできません。完全なパスを使用する必要があります。

例

salesdb.log_dir=/u01/app/oracle/upgrade-jobs

デフォルトでは、グローバル構成ファイル・パラメータglobal.autoupg_log_dirが指定され、log_dirを指定しない場合、global.autoupg_log_dirで指定されたパスがデフォルトになります。

global.autoupg_log_dirもlog_dirも指定されていない場合、デフォルトでは、ログ・ファイルは構成ファイルに含めるデータベースのorabaseユーティリティで示される場所に配置されます。その場合、デフォルトのログ・ディレクトリはパスORACLE_BASE/cfgtoollogs/autoupgradeにあります。

構成ファイルに含まれるすべてのデータベースについてorabaseユーティリティが失敗した場合、ログ・ファイルの場所は、AutoUpgradeを実行しているユーザーのtempディレクトリに基づきます。

manage_standbys_clause

(オプション) DB_UNIQUE_NAMEで特定したスタンバイOracle Data Guardスタンバイ・データベースをAutoUpgradeプラグインのアップグレードから除外して、スタンバイ・データベース・ファイルを再利用できるようにするかどうかを指定します。

使用上のノート

スタンバイ・データベースを使用してデータベース構成をアップグレードする前に、潜在的な問題を削減するために、スタンバイ・データベースでAutoUpgradeを分析モードで実行することをお薦めします。

オプション

次の構文では、pdb-nameは、切断/接続アップグレードでターゲットCDBにアップグレードするソースPDBのDB_UNIQUE_NAMEです。

manage_standbys_clause=STANDBYS=[STANDBYS=NONE|STANDBYS=ALL|STANDBYS=ALL EXCEPT ('pdb-name', 'pdb-name', ...)|STANDBYS=('pdb-name', 'pdb-name', ...)]

デフォルト値はNONEです。

例

次の例では、Oracle Data Guardスタンバイのメンバーである非CDBまたはプラガブル・データベースはAutoUpgradeプラグインのアップデートから除外されません。

upg2.sid=cdb1 
upg2.pdbs=* 
upg2.target_cdb=cdb21x 
upg2.source_home=/source/18x 
upg2.target_home=/target/21x
upg2.manage_standbys_clause=standbys=none

次の例では、すべてのスタンバイ・データベースでのデータ・ファイルへのREDOの適用が、すべてのAutoUpgradeプラグイン・アップグレードで遅延されます。

upg3.sid=cdb2 
upg3.pdbs=* 
upg3.target_cdb=cdb21x 
upg3.source_home=/source/18x 
upg3.target_home=/target/21x
upg3.manage_standbys_clause=standbys=all

次の例では、AutoUpgradeプラグインのアップグレード中に、PDB cdb3_stby_1およびcdb3_stby_2を除くすべてのスタンバイPDBでデータ・ファイルへのREDOの適用が遅延されます。

upg4.sid=cdb3 
upg4.pdbs=* 
upg4.target_cdb=cdb21x 
upg4.source_home=/source/12.2x 
upg4.target_home=/target/21x
upg4.manage_standbys_clause=standbys=all except ('cdb3_stby_1','cdb3_stby_2')

次の例では、AutoUpgradeプラグインのアップグレード中に、データ・ファイルへのREDOの適用がスタンバイPDB cdb4_stby1でのみ遅延されます。

upg4.sid=cdb4 
upg4.pdbs=* 
upg4.target_cdb=cdb21x 
upg4.source_home=/source/12.2x 
upg4.target_home=/target/21x
upg4.manage_standbys_clause=standbys=('cdb4_stby_1')

pdbs

(オプション)アップグレードを実行するPDBのリストを設定します。このパラメータは、マルチテナント・アーキテクチャ(CDB)データベースのアップグレードにのみ適用されます。非CDBデータベースを接続およびアップグレードしている場合、このパラメータは無視されます。

使用上のノート

PDBリストはカンマ区切りです。リストには、PDB名またはアスタリスク(*)のいずれかを含めることができます。これは、AutoUpgradeの実行時にCDBでオープンしているすべてのPDBをアップグレードすることを示します。パラメータが指定されていない場合、デフォルト値は*です。

ANALYZEモードで実行している場合、AutoUpgradeはマウント状態のPDBを無視します。

FIXUPS、DEPLOYまたはUPGRADEモードで実行している場合、AutoUpgradeは実行モードに応じて、マウント状態のPDBを読取り/書込みモード、アップグレード・モードまたはその両方で開きます。

例

sales1.pdbs=pdb1, pdb2, pdbn
   upgr1.pdbs=*

raise_compatible

(オプション)アップグレードが正常に完了した後、Oracle DatabaseのCOMPATIBLE初期化パラメータをターゲット・リリースのデフォルト値まで増やします。

使用上のノート

オプション:

• Y: COMPATIBLEパラメータ設定をターゲット・リリースまで増やします
• N: COMPATIBLEパラメータ設定をターゲット・リリースまで増やしません

デフォルトはNです。

注意:

• COMPATIBLEパラメータを増やした後、データベースのダウングレードはできません。
• COMPATIBLEパラメータを現在のリリース・レベルに設定するのは、アップグレードしたデータベースを完全にテストした後にのみ行うことをお薦めします。
• autoupgradeコマンドライン・パラメータrestoreに使用する値に関係なく、構成ファイル・パラメータraise_compatibleの値をyesに設定した場合は、アップグレードを開始する前に、作成した保証付きリストア・ポイントを手動で削除する必要があります。アップグレードが正常に完了すると、アップグレードを開始する前にAutoUpgradeによって作成された保証付きリストア・ポイントは自動的に削除されます。AutoUpgradeによってPOSTUPGRADEステージが開始されると、データベースをリストアする方法はありません。

例

sales1.raise_compatible=yes

remove_rac_config

(オプション)ターゲットCDBホームへの正常な変換後にソースOracleホームのクラスタウェアから非CDB Oracle RACデータベースを削除するか、ソース・データベースを変更せずに残すかを指定します。

使用上のノート

デフォルトでは、非CDBのソースOracle RACデータベース構成は、アップグレード・プロセス中にCDBに移行されると、ソースOracle Grid Infrastructureから削除されます。remove_rac_configがnoに設定されている場合、ソースOracle RACデータベースは以前のリリースの非CDBシステムから削除されません。

オプション

[yes | no]

デフォルト値はyes。

例

upg1.remove_rac_config=no

remove_underscore_parameters

(オプション)構成ファイル内のすべてのOracle Databaseについて、アップグレード中およびアップグレード後にPFILEファイルからアンダースコア(非表示)パラメータを削除します。

使用上のノート

アンダースコアのパラメータは、Oracleサポートの指示がある場合のみ使用できます。

オプション

[yes | no]

デフォルト値はnoです。

例

sales1.remove_underscore_parameters=yes

replay

(オプション)リプレイを使用してデータベースをアップグレードするかどうかを指定します。

使用上のノート

デフォルトでは、AutoUpgradeはクラシック・アップグレードを実行してデータベースをアップグレードします。

オプション

[yes | no]

デフォルト値はnoです。

例

upg1.replay=yes

restoration

(オプション)データベースのリストアに保証付きリストア・ポイント(GRP)を生成します。

使用上のノート

restoration=noを設定する場合は、データベースのバックアップおよびリストアを手動で実行する必要があります。このオプションは、NOARCHIVELOGモードで動作するデータベース、およびOracle Flashback Technology機能のフラッシュバック・データベースをサポートしていないStandard EditionおよびStandard Edition 2データベースに使用します。パラメータを指定しない場合、デフォルト値(yes)が使用され、保証付きリストア・ポイントが作成されます。

オプション

[yes | no]

デフォルト値はyes。

例

sales1.restoration=no

revert_after_action

(オプション)接頭辞によって指定された特定のデータベース・ジョブに対してシステムのリストアが完了し、データベースが稼働した後にオペレーティング・システムで実行するカスタム・アクションを指定します。

使用上のノート

revert_after_actionで指定するアクションは、リストア・プロセスが完了し、データベースが稼働した後、ターゲットのOracleホーム・バイナリで実行されます。

実行するように指定するスクリプトはname.ext (例: myscript.sh)の形式である必要があります。これにより、AutoUpgradeは実行するスクリプトのタイプを識別できます。許可される拡張子オプションは、次のとおりです。

• UNIXシェル(.sh)
• Microsoft Windowsバッチ(.bat、.cmd)
• Microsoft Windows PowerShell (.ps1)
• Oracle SQLスクリプト(.sql)。revert_before_actionパラメータ接頭辞で指定されたデータベースのローカル操作の場合。

オプション

失敗時に停止します: [Y|N]。デフォルトはNです。

デフォルトでは、指定したスクリプトが失敗すると、AutoUpgradeは引き続き実行されます(N)。スクリプトが失敗した場合にAutoUpgradeが停止するように指定するには、Yフラグを使用します。スクリプトが0以外のステータスでオペレーティング・システムで実行を終了した場合、AutoUpgradeはスクリプトを失敗として識別します。

例

AutoUpgradeがリストアの処理を完了した後に、オペレーティング・システムで指定したスクリプトを実行します。スクリプトが失敗した場合にAutoUpgradeを停止するには、Yフラグを設定します。

sales3.revert_after_action =/user/path/script.sh Y

AutoUpgradeがリストアの処理を完了した後に、オペレーティング・システムで指定したスクリプトを実行します。フラグを指定しないと、デフォルトの失敗時に停止するオプションはNであるため、スクリプトが失敗した場合、AutoUpgradeは引き続き実行されます。

sales3.revert_after_action =/user/path/script.sh

revert_before_action

(オプション)接頭辞によって指定された特定のデータベース・ジョブに対してシステムのリストアが完了し、データベースが稼働する前にオペレーティング・システムで実行するカスタム・アクションを指定します。

使用上のノート

revert_before_actionで指定するアクションは、データベースのリストアが開始されてデータベースが稼働する前に、ターゲットのOracleホーム・バイナリで実行されます。

実行するように指定するスクリプトはname.ext (例: myscript.sh)の形式である必要があります。これにより、AutoUpgradeは実行するスクリプトのタイプを識別できます。許可される拡張子オプションは、次のとおりです。

• UNIXシェル(.sh)
• Microsoft Windowsバッチ(.bat、.cmd)
• Microsoft Windows PowerShell (.ps1)
• Oracle SQLスクリプト(.sql)。revert_before_actionパラメータ接頭辞で指定されたデータベースのローカル操作の場合。

オプション

失敗時に停止します: [Y|N]。デフォルトはNです。

デフォルトでは、指定したスクリプトが失敗すると、AutoUpgradeは引き続き実行されます(N)。スクリプトが失敗した場合にAutoUpgradeが停止するように指定するには、Yフラグを使用します。スクリプトが0以外のステータスでオペレーティング・システムで実行を終了した場合、AutoUpgradeはスクリプトを失敗として識別します。

例

AutoUpgradeがリストアを開始する前に、オペレーティング・システムで指定するスクリプトを実行します。スクリプトが失敗した場合にAutoUpgradeを停止するには、Yフラグを設定します。

sales3.revert_before_action =/user/path/script.sh Y

AutoUpgradeがリストアを開始する前に、オペレーティング・システムで指定したスクリプトを実行します。フラグを指定しないと、デフォルトの失敗時に停止するオプションはNであるため、スクリプトが失敗した場合、AutoUpgradeは引き続き実行されます。

sales3.revert_before_action =/user/path/script.sh

run_hcheck

(オプション)アップグレード前のチェックの一部としてOracle Dictionary Health Checksを実行して、データベース・ディクショナリの不整合を特定するかどうかを指定します。

使用上のノート

データベース・ディクショナリの不整合を特定しやすくするために、AutoUpgradeがアップグレード前のチェックの一部として、ソース・データベースでDBMS_HCHECK PL/SQLパッケージを実行するように指定できます。設定した場合、AutoUpgrade run_hcheckパラメータにより、AutoUpgradeがデータベース・ディクショナリでOracle Dictionary Health Checksの配列全体を実行するか、または最もクリティカルなチェック・セットのみを実行するかを、アップグレード・ソース・データベースごとに指定できます。チェックによってデータベース・ディクショナリの潜在的またはクリティカルな問題が検出された場合、アップグレードの開始が回避されます。

Oracle Dictionary Health Checkの結果は、AutoUpgrade事前チェック・ディレクトリの下にdbname_healthcheck_result.logという形式で格納されます。dbnameは、チェックが実行されたデータベースの名前です。Oracle Dictionary Health Checkの詳細は、『Oracle Database PL/SQLパッケージおよびタイプ・リファレンス』のDBMS_HCHECKパッケージ・ドキュメントを参照してください。

オプション

[full| critical]

パラメータが設定されていない場合、デフォルトではDBMS_HCHECKを実行しません。

例

sales1.run_hcheck=full
sales2.run_hcheck=critical

run_utlrp

(オプション)アップグレードの一部としてutlrpを有効または無効にします。

使用上のノート

utlrpユーティリティは、データベース・アップグレード時に無効になるすべてのデータ・ディクショナリ・オブジェクトを再コンパイルします。Oracle Databaseのすべてのアップグレード後にこのユーティリティを実行することをお薦めします。

オプション

[yes | no]

デフォルト値はyes。

例

prefix.run_utlrp=yes

sid

(必須)アップグレードするデータベースのOracleシステム識別子(SID)を示します。

例

sales1.sid=salesdb

skip_tde_key_import

(オプション) yesに設定すると、アップグレードは実行されますが、ソース・データベースKeyStoreのターゲット・データベースへのインポートはスキップされ、エラーは発生しません。

使用上のノート

ノート:

このパラメータは不要になったため、非推奨です。今後のリリースのAutoUpgradeで削除される可能性があります。このパラメータを使用するかわりに、-load_passwordコマンドライン・オプションを使用して、AutoUpgradeのキーストアにTDEパスワードを追加するか、セキュアな外部パスワード・ストア(SEPS)にTDEパスワードを追加することをお薦めします。

このオプションは、非CDBからPDBへの操作および切断/接続操作に使用できます。ソース・データベースKeyStoreをターゲット・データベースへのインポートをスキップする場合、AutoUpgradeではPDBをアップグレード・モードでオープンしたままにするため、キーを手動でインポートできます。キーをインポートした後、通常モードでデータベースを再起動する必要があります。

オプション

[yes | no]

デフォルト値はnoです。

例

sales1.skip_tde_key_import=yes

source_base

(オプション)ソースOracleホームのソースORACLE_BASEパスを指定します。

例

source_base=/u01/app/oracle
sales4.source_base=/u04/app/oracle4

source_dblink

(オプション)切断/接続再配置(ホット・クローン)アップグレード用に設定されたデータベース・リンクを指定します。

使用上のノート

非CDBまたはPDBに対して切断/接続再配置アップグレードを設定するには、まずソース・データベースとターゲット・データベースの場所間にデータベース・リンクを設定する必要があります。次に、source_dblinkパラメータを使用して、そのデータベース・リンクをAutoUpgradeに渡します。データベース・リンクに関連付けられているソース・データベース名は、source_dblink.パラメータの接尾辞として識別します。データベースがデータベース・リンクからリフレッシュされる時間値を秒単位で指定することもできます。

ノート:

このオプションは、Oracle Database 12.1.0.2以降のソース・データベース・リリースで使用できます。

target_pdb_copy_optionパラメータを使用すると、source_dblinkパラメータがアクティブになります。source_dblinkを使用する場合は、file_name_convertパラメータの値も指定して、ファイル名を変換するように指定するか、ファイル名を変換しないように指定する必要があります。file_name_convertがnoneに設定されている場合、データベース・ファイルを配置する場所を指定するためにdb_create_file_destも設定する必要があります。

また、ソース・データベースのデータベース・リンクでターゲット・データベースが更新される頻度を指定するリフレッシュ間隔を秒単位で設定することもできます。start_timeパラメータとともにリフレッシュ間隔を使用すると、ターゲットの場所に対してソース・データベースをリフレッシュするように維持できます。リフレッシュ率が指定されていない場合、ソース・データベースは1回のみクローニングされ、リフレッシュは行われません。リフレッシュ率が指定されているが、start_timeパラメータを使用して将来の開始時間を指定しない場合、リフレッシュ間隔値は無視され、データベースは1回のみクローニングされます。

オプション

• (必須)接尾辞として指定されたソース・データベース名。
• (必須)作成したデータベース・リンクの名前。
• (オプション)ソース・データベースからのターゲット・データベースへのリフレッシュ率(秒)。リフレッシュ率を指定する場合は、通常、start_timeパラメータを使用して将来の開始時間も指定します。
• (オプション) CLONE_ONLY。このオプションを追加すると、作成されるPDBはリフレッシュされないクローンになり、クローン操作が完了した直後にアップグレードが開始するように指定されます。このオプションは、ソースがOracle Database 12.1 (リリース12.1.0.2)の場合に必要です。

例

次の例では、2つのデータベース・リンクが作成されます。

• pdbxcdb18x_link。pdbxという名前のPDBソース・データベースに作成されます。

  CREATE DATABASE LINK pdbxcdb18x_link CONNECT TO remote-user IDENTIFIED BY password  
  USING'(DESCRIPTION =(ADDRESS = (PROTOCOL = TCP)(HOST
  GRANT CREATE SESSION, CREATE PLUGGABLE DATABASE, SELECT_CATALOG_ROLE TO remote-user;
  GRANT READ ON sys.enc$ TO remote-user;

• db18x_link。db18xという名前の非CDBソース・データベースに作成されます。

  CREATE DATABASE LINK db18x_link CONNECT TO remote-user IDENTIFIED BY password 
  USING'(DESCRIPTION =(ADDRESS = (PROTOCOL = TCP)(HOST = db-node1)(PORT = 1521))
  (CONNECT_DATA = (SERVICE_NAME = db18x)))';

AutoUpgrade構成ファイルでは、データベース・リンクに関連付けられたデータベース名は、その名前をsource_dblinkの接尾辞として使用して指定します(PDBソース・データベースの場合、接尾辞はpdbxで、非CDBソース・データベースの場合、接尾辞はdb18x)。

次の例では、source_dblinkを使用して、ソース・データベースpdbxのdblinkを指定します。時間間隔が指定されていないため、AutoUpgradeの起動直後にPDBアップグレード・デプロイメントが開始されます。

upg1.source_dblink.pdbx=pdbxcdb18x

同じ構成ファイルを使用して、AutoUpgradeは、AutoUpgradeがコマンドラインから起動された1時間40分後に、db18xという名前のデータベースのアップグレードを開始します。AutoUpgradeが起動されてからstart_timeで指定されたデプロイメント時間までの間、クローニングされたターゲット・データベースはソースから20秒ごとにリフレッシュされます。

upg1.source_dblink.db18x=db18x_link 20 
upg1.start_time=+1h40m

次の例では、ソース・データベースdb18xがターゲットPDB db18x_linkにクローニングされ、そのソース・データベースが正常にクローニングされた直後にアップグレードが開始されます。

upg1.source_dblink.db18x=db18x_link CLONE_ONLY

source_home

(分析モード、修正モードおよびデプロイ・モードの場合は必須です。アップグレード・モードの場合はオプションです。)アップグレードするデータベースの現在のOracleホーム(ORACLE_HOME)。

使用上のノート

upgradeモードの場合、ソース・ホームとターゲット・ホームの値は同じパスにできます。

例

sales2.source_home=/path/to/my/source/oracle/home

source_ldap_admin_dir

(オプション)ソース・データベース・ホームのLDAP_ADMINディレクトリへのパスを指定します。

使用上のノート

WindowsではLDAP_ADMIN環境変数がレジストリ内で設定されているため、このパラメータはMicrosoft Windowsには影響しません。

例

sales1.source_ldap_admin_dir=/u01/app/oracle/12.2/dbhome01/ldap/admin

source_tns_admin_dir

(オプション)ソース・データベース・ホームのTNS_ADMINディレクトリへのパスを指定します。

使用上のノート

WindowsではTNS_ADMIN環境変数がレジストリ内で設定されているため、このパラメータはMicrosoft Windowsには影響しません。

例

sales1.source_tns_admin_dir=/u01/app/oracle/12.2/dbhome01/network/admin

start_time

(オプション)アップグレード・ジョブを実行する将来の起動時間を設定します。このパラメータは、アップグレード・ジョブをスケジュールしてサーバーの負荷を分散し、複数のジョブが即時に起動されないようにするために使用します。

使用上のノート

値は、now (すぐに開始)の形式にするか、英語日付書式の形式DD/MM/YYYYまたはMM/DD/YYYYにする必要があります。ここで、MMは月、DDは日、YYYYは年です。値を設定しない場合、デフォルトはnowです。

設定できる値:

now
30/12/2019 15:30:00
01/11/2020 01:30:15
2/5/2020 3:30:50

start_time値をnowに設定して複数のジョブが起動されると、AutoUpgradeではシステムで使用可能なリソースに基づいて起動時間をスケジュールします。ジョブの起動時間は数分単位でずれる場合があります。

日付要素または時刻要素に間違ったデリミネータを使用している値、または次のような間違った日付書式または時間書式を使用している値は無効です。

30-12-2019 15:30:00
01/11/2020 3:30:15pm
2020/06/01 01:30:15   

例

sales1.start_time=now
sales2.start_time=07/11/2020 01:30:15

target_base

(オプション)ターゲットOracleホームのターゲットORACLE_BASEパスを指定します。

例

target_base=/u01/app/oracle
sales4.target_base=/u04/app/oracle4

target_cdb

(オプション)非CDB Oracle Databaseが接続されるターゲットCDBのSIDを指定します。このパラメータは、非CDBのOracleデータベースをアップグレードおよび変換する場合に必須です。

例

emp.target_cdb=salescdb

target_pdb_copy_option=file_name_convert

(オプション)非CDBデータベースをPDBに変換する場合、または別のソースCDBの既存のPDBを指定のターゲットCDBのPDBに変換する場合にAutoUpgradeが実行する、プラガブル・データベースを作成する文で使用されるfile_name_convertオプションを指定します。

使用上のノート

注意:

target_pdb_copy_optionを指定すると、AutoUpgradeは必要に応じてリカバリを管理できます。target_pdb_copy_optionが設定されておらず、デフォルトのnocopyオプションが使用されている場合、デフォルトのPDBはリカバリされません。必ず、ソースPDBをバックアップしてください。

このオプションは、ターゲットCDB内にプラガブル・データベースを作成する場合にのみ使用します。このパラメータを指定しない場合、パラメータのデフォルト値はNOCOPYであり、ソース・データベースの既存のデータ・ファイルが再利用されます。このパラメータを指定する場合は、ソース・データベース名またはPDB名を指定するパラメータに接尾辞を追加し(target_pdb_copy_option.suffix)、file_name_convert=を次のいずれかのオプションとともに指定する必要があります。

• ソース・ファイル名(f)およびターゲット置換ファイル名(r)を指定するか('f', 'r')、NONEを指定します
• リフレッシュ可能クローン・データベースを作成する場合は、ソース・データベース名またはPDB名を指定するパラメータに接尾辞を追加します(target_pdb_copy_option.suffix

ターゲットCDBで、ASMを使用している場合、またはパラメータDB_CREATE_FILE_DESTまたはPDB_FILE_NAME_CONVERTを設定し、ターゲットCDBでこれらのパラメータを置換ファイル名に対して有効にする場合は、値prefix.target_pdb_copy_option.source-db-name-or-pdb=file_name_convert=NONEを設定します。

ターゲットCDBでの変換時に1つ以上のデータ・ファイル名を変更する場合、構文prefix.target_pdb_copy_option.source-db-name-or-pdb=('f1', 'r1', 'f2', 'r2', . . .)を使用してパラメータの値を入力し、ソース・データベース名またはPDBを接尾辞として、そして変更するソース・ファイル名および既存のファイルのコピー先となるターゲット・ファイル名を指定します(f1は、ソースの最初のファイル名パターン、r1はターゲットCDBの最初の置換ファイル名パターン、f2はソースの2番目のファイル名パターン、r2はターゲットCDBの2番目の置換ファイル名パターン、となっていきます)。

構文

prefix.target_pdb_copy_option.source-db-name-or-pdb=file_name_convert=('f1', 'r1', 'f2', 'r2', 'f3', 'r3'...)

例

この例では、AutoUpgradeは、接頭辞文字列upg1および接尾辞salesを付けて、指定されたデータベースの変換時に既存のデータファイルをコピーし、ファイルパス文字列およびファイル名/old/path/pdb_2をファイルパス文字列およびファイル名/new/path/depsalesで置換します。

upg1.target_pdb_copy_option.sales=file_name_convert=('/old/path/pdb_2', '/new/path/depsales') 

target_pdb_copy_optionsource-db-name-or-pdb=file_name_convertを使用してOMFファイルを変換するには、ターゲットOracleホームがOracle Database 19cリリース更新6以降(19.6.0)またはOracle Database 18cリリース更新10以降(18.10.0)である必要があります。

この例では、Oracle ASMに格納されているデータ・ファイルの内、Oracle管理ファイルとして格納されていないデータ・ファイルを+DATA/dbname/salesから+DATA/dbname/depsalesにコピーするように、パラメータが構成されています。

upg1.target_pdb_copy_option.sales=file_name_convert=('+DATA/dbname/sales', '+DATA/dbname/depsales')

target_pdb_name

(オプション)ターゲットCDBに接続された後に、非CDBのソースOracle Databaseに割り当てる名前を指定します。

使用上のノート

このパラメータは省略可能です。これは、非CDBのOracle DatabaseをPDBにアップグレードして変換する場合、またはPDBをソース・リリースCDBから切断し、ターゲット・リリースCDBにアップグレードするために接続する場合に使用されます。

既存の非CDBデータベースをアップグレードしてターゲットCDBのPDBに変換する場合、target_cdbパラメータはターゲットCDBを指定するため必須です。ターゲットCDBでのPDBの作成方法を決定する場合は、オプションのパラメータtarget_pdb_nameおよびtarget_pdb_copy_optionを使用して、ターゲットCDBでのPDBの作成方法を指定できます。ただし、いずれのオプション・パラメータも使用しない場合は、ソースCDBの完全アップグレードが実行されます。

非CDBをPDBに変換する場合のターゲットPDBのデフォルト名は、非CDB Oracle Databaseのデータベースの一意の名前を使用します。CDBへの接続時に非CDBの既存の名前とは異なる名前を指定するには、target_pdb_nameを使用して新しい名前を設定します。さらに、リフレッシュ可能クローン・データベースを作成する場合は、ソース・データベース名またはPDB名を指定する接尾辞をパラメータに追加します(target_name.suffix)

例

次の例では、ソース非CDBデータベースはemp19です。target_pdb_nameパラメータを使用して、ターゲットCDBデータベースの名前をemp23pdbに変更します。

upg.target_pdb_name=emp23pdb

リフレッシュ可能クローンの場合は、クローンのソース・データベースを示す接頭辞を追加します。この例では、ソース・コンテナ・データベースはdb122bで、pdb1をdb122bからターゲット・コンテナ・データベースdb19にクローニングしています。接尾辞pdb1は、target_pdb_nameとsource_dblinkの両方の識別子として使用されます。pdb1接尾辞識別子は、ソースpdb1からターゲットPDB PLUG122にデータを移動するために使用されるターゲットPDB名とdblinkの両方を関連付けます。

global.autoupg_log_dir=/tmp/logs
upg1.source_home=/u01/app/oracle/122
upg1.target_home=/u01/app/oracle/19
upg1.sid=db122b
upg1.target_cdb=db19
upg1.pdbs=pdb1
upg1.target_pdb_name.pdb1=PLUG122
upg1.target_pdb_copy_option.pdb1=file_name_convert=('/u01/app/oracle/oradata/db122b/pdb1', '/u01/app/oracle/plug/pdb122b')
upg1.source_dblink.pdb1=pdbxcdb122x_link

target_ldap_admin_dir

(オプション)ターゲット・データベース・ホームのLDAP_ADMINディレクトリへのパスを指定します。

例

sales1.target_ldap_admin_dir=/u01/app/oracle/19/dbhome01/ldap/admin

target_tns_admin_dir

(オプション)ターゲット・データベース・ホームのTNS_ADMINディレクトリへのパスを指定します。

例

sales1.target_tns_admin_dir=/u01/app/oracle/19/dbhome01/network/admin

timezone_upg

(オプション)AutoUpgradeプロセスの一部としてタイムゾーンのアップグレードの実行を有効または無効にします。

使用上のノート

データ整合性を維持するには、データベースのアップグレード時にタイムゾーン・ファイル(DST)の設定をアップグレードすることをお薦めします。特に、timestamp with time zone表の列など、タイムゾーンに依存するデータがある場合、タイムゾーンをアップグレードします。この設定は、チェックリスト・ファイルで修正を上書きすることで無効にできることに注意してください。

AutoUpgrade構成ファイルでタイムゾーン・ファイルのアップグレードを明示的に無効にする場合は、このタスクをアップグレード計画の一環として実行するか、後で実行することをお薦めします。

オプション

[yes | no]

デフォルト値は、アップグレードの場合はyes、パッチ適用の場合はnoです。

例

sales1.timezone_upg=no

ノート:

RU 19.18以降のパッチをデータベースに適用すると、更新済のタイムゾーン・ファイルがデフォルトでOracleホームにインストールされます。パッチが適用されたOracleホームのDatabase Configuration Assistant (DBCA)で作成される新しいデータベースは最新のタイム・ゾーン・ファイルを使用して作成されます。

tune_setting

(オプション)指定したワークフロー・オプションに応じて、実行時にAutoUpgradeの動作を変更する特別なワークフローを有効にします。

使用上のノート

tune_settingパラメータを使用すると、アップグレード・ステップ、またはAutoUpgrade構成ファイルのパラメータ接頭辞で指定されたコンテナ・データベースまたはプラガブル・データベース(CDBまたはPDB)によって指定されたアップグレードの処理に割り当てられたリソースを微調整できます。この機能は、デフォルトのAutoUpgrade値がシステム要件に十分でないか、デフォルト以外のAutoUpgradeオプションを有効にする場合に、一部のアップグレードに役立ちます。

構文

prefix.tune_setting=option[, option, option, ...]

次のリストから、必要なAutoUpgradeランタイム・チューニングを提供するtune_settingオプションを選択します。複数のチューニング・オプションをtune_settingパラメータと組み合せるには、カンマ区切りを使用します。例:

sales3.tune_setting=proactive_fixups=true,query_hint_parallel=8,utlrp_threads_per_pdb=8

ノート:

1つのtune_settingエントリに複数のパラメータを連結できます

オプション	説明
active_nodes_limit	Oracle Real Application Clustersデータベースの分散アップグレード中に使用するアクティブなクラスタ・メンバー・ノードの新しい合計を設定します。デフォルトは2です。指定した数がクラスタ・メンバー・ノードの最大数以上である場合、すべてのノードが取得されます。 sales3.tune_setting=active_nodes_limit=4
distributed_upgrade	AutoUpgradeが分散アップグレードを実行することを指定します。分散アップグレードでは、Oracle Clusterwareクラスタ・メンバー・ノードのリソースを利用して、クラスタ上のPDBのアップグレードをより迅速に実行します。2つ以上のノードのOracle RACクラスタ内のCDBをアップグレードする場合、このオプションを使用します。このオプションを選択すると、proactive_fixupsオプションもデフォルトで有効になります。例: sales3.tune_setting=proactive_fixups=true,distributed_upgrade=true
make_pdbs_available	事前修正モードを使用するときに、事後修正の完了後、接頭辞で指定されたPDBを読取り/書込みモードおよび非制限モードでオープンします。このオプションを使用すると、アップグレードの完了直後に接頭辞で指定されたPDBがサービスで使用可能になり、他のPDBが引き続きアップグレードされます。これは大規模なフリート・アップグレード・デプロイメントに役立ちます。 注意: このオプションを選択すると、指定したPDBはユーザーからのサービス・リクエストを受け入れ、他のPDBは引き続きアップグレードされます。サービス・リクエストに対するPDBのレスポンス時間、および進行中のPDBアップグレードに必要な時間は、それぞれ影響を受ける可能性があります。 例: sales3.tune_setting=make_pdbs_available=true
proactive_fixups	アップグレードの最後のステージとしてPDBがアップグレードされる、事前修正モードを有効にします。PDBの数がデータベースで定義されているCPU数を2で割った数より多い場合、このチューニング・オプションを選択すると、アップグレードが速くなります。例: sales3.tune_setting=proactive_fixups=true 注意: CPUの数がPDBの数より多い場合、この設定を変更すると、パフォーマンスが向上しない可能性があります。
query_hint_parallel	接頭辞で指定されたPDBの問合せ中に表領域からデータを収集するコードにパラレル・スレッド指定を指定します。これにより、接頭辞で指定されたPDBにパラレル・スレッド数を増減して割り当てることができます。例: sales3.tune_setting=query_hint_parallel=8 このオプションを選択すると、AutoUpgradeによってシステム・リソースの消費量が増える可能性があります。
utlrp_threads_per_pdb	CDB内の無効なオブジェクトの再コンパイルによって生成されるデフォルトの最大スレッド数を上書きし、指定したスレッド数を使用します。例: sales3.tune_setting=utlrp_threads_per_pdb=8 注意: 指定されたスレッド数がシステムで使用可能なスレッド数を超えると、パフォーマンスが低下する可能性があります。
utlrp_pdb_in_parallel	デフォルトの最大同時再コンパイル・スレッド数を、指定した数に上書きします。このオプションを使用して、無効なオブジェクトの再コンパイルのデフォルトの最大同時プロセス数を上書きします。例: sales3.tune_setting=utlrp_pdbs_in_parallel=2 注意: 各PDBプロセスでは、utlrp_threads_per_pdbで指定された数と同じ数のスレッドがシステムで必要です。

例

次の例では、接頭辞sales3で指定されたデータベースのアップグレードは、Oracle Real Application ClustersのOracle Databaseインスタンスです。tune_settingパラメータを使用して、Oracle Grid Infrastructureクラスタ内の複数のCDB間でアップグレード・ロードを分散する設定distributed_upgradeを使用するように、これらのデータベース・インスタンスを設定します。

sales3.tune_setting=proactive_fixups=true,distributed_upgrade=true

次の例では、接頭辞sales3で指定されたデータベースのアップグレードは、複数のtune_settingパラメータ・オプションでチューニングされます。

sales3.tune_setting=proactive_fixups=true,query_hint_parallel=8,utlrp_threads_per_pdb=8

upgrade_node

(オプション)現在のユーザー構成が有効なノードを指定します。デフォルト値はlocalhostです。

使用上のノート

このパラメータの目的は、AutoUpgradeで使用する構成ファイルにリストされているデータベースがAutoUpgradeで処理されないようにすることです。ここで、upgrade_nodeパラメータの値は現在のホスト名に対応していません。AutoUpgradeをリモートで実行することはできません。キーワードlocalhostをワイルド・カードとして使用して、ローカル・ホストのデータベースを処理するように指定できます。

ユースケース:

構成ファイルconfig.cfgには、10個のデータベースが含まれています。そのデータベースのうちの5つは、upgrade_nodeの値がdenver01に設定されています。残りの5つは、upgrade_nodeの値がdenver02に設定されています。AutoUpgradeが構成ファイルconfig.cfgを使用してサーバーdenver01で実行される場合、AutoUpgradeはupgrade_nodeがdenver01に設定されているデータベースのみを処理します。upgrade_nodeがdenver02に設定されているデータベースは無視されます。hostnameユーティリティは、アップグレード・ノードを解決するために使用される値を識別します

例

hostname
denver02
sales1.upgrade_node=denver01