C Oracle Database Upgrade Assistant (DBUA)を使用したアップグレード

Database Upgrade Assistant (DBUA)では、Oracle Databaseのアップグレードを順を追って説明するためのグラフィカル・ユーザー・インタフェースが提供されています。DBUAは、CDBおよび非CDBのデータベース・システム用に動作します。

ノート:

ユーザー・インタフェースが表示されないサイレント・モードでDBUAを起動できます。サイレント・モードは、大規模なロールアウトやスクリプトで役立つことがあります。

DBUAを使用するための要件

マルチテナント・アーキテクチャおよび非CDB Oracle DatabaseのアップグレードでDatabase Upgrade Assistant (DBUA)を使用するには、このトピックを参照してください。

Oracle Database Vaultが有効になっている場合は、「Oracle Database Vaultを使用しているOracle Databaseのアップグレードの要件」のトピックを参照してください。

DBUAでアップグレード前チェックを実行できるように、最新のAutoUpgradeユーティリティをダウンロードし、インストールする必要があります。

ノート:

Oracle Database 19cは、非CDBアーキテクチャの最終リリースです。

ノート:

ソースおよびターゲットのOracleホームを異なるユーザーが所有している場合は、Database Upgrade Assistant (DBUA)を使用してデータベースをアップグレードできません。これを行うと、エラーPRKH-1014が返されます。ソース・データベースとターゲット・データベースの所有者が同じであることを確認するか、手動アップグレードを実行してください。

DBUAを使用して、マルチテナント・アーキテクチャ・コンテナ・データベース(CDB)、プラガブル・データベース(PDB)および非CDBデータベースをアップグレードできます。手順は同じですが、アップグレードのタイプに応じて、選択する必要のある内容とDBUAの動作は異なります。

  • My Oracle Supportドキュメント884522.1から最新のpreupgrade.jarバージョンをダウンロードします。Oracle_home/rdbms/adminの下のOracle Database 19c Oracleホームにファイルをダウンロードし、その場所にファイルを解凍します。次に、このガイドの「アップグレード前情報ツール(preupgrade.jar)コマンド」の手順に従います
  • 保証付きリストア・ポイントを使用するには、アップグレード中にデータベースのARCHIVE LOGモードおよびFLASHBACKモードがオンであることを確認します。オンであることを確認するには、次のSQLコマンドを入力します。
    SQL> select log_mode,flashback_on from v$database;
  • データベース・インスタンスが実行されていない場合、DBUAはインスタンスを起動しようとします。インスタンスが起動され、実行されている場合、DBUAはそのインスタンスに接続します。

  • DBUAを使用せずに手動でデータベースをリストアする場合は、DBUAを起動する前に ORACLE_HOME/cfgtoollogs/dbua/logs/ディレクトリにあるWelcome_SID.txtファイルを削除します。このファイルが検出されると、DBUAは再実行操作で起動します。

  • リストア・スクリプトでは、一般にデータベース(非CDBのシングル・インスタンス、高可用性、またはOracle RAC)を以前のリリースおよび以前のOracleホームの場所にリストアできます。ただし、データベースをOracle Internet Directory (OID)に登録した場合は、リストア・スクリプトでOracle Internet Directoryを登録解除できません。権限を持つユーザーとしてログインし、新しいリリースのデータベースを手動で登録解除する必要があります。

アップグレード時のDBUAの停止について

DBUAを停止する場合、アップグレードを手動で完了する必要があります。

アップグレードを停止するが、データベースをリストアしない場合、DBUAを使用してアップグレードを継続することはできません。かわりに、手動(コマンドライン)のアップグレード手順を使用してアップグレードを継続する必要があります。データベースをリストアしないかぎり、元のOracle Databaseのサーバーに戻ることはできません。

DBUAによるOracle Databaseのアップグレードの処理方法

DBUAは、データベース・ソフトウェアのインストールの一環として起動することも、ソフトウェアのインストール後に手動で起動することもできます。

新しいOracle Databaseソフトウェアをインストールし、既存のOracle Databaseのアップグレードを指定した場合は、DBUAが自動的に起動されます。インストールの完了後、単独でDBUAを起動することもできます。

アップグレードの実行中、DBUAによって、各コンポーネントのアップグレード処理の進行状況が表示されます。DBUAは、詳細なトレース・ログおよびログ・ファイルを書き込み、後で参照するための完全なHTMLレポートを作成します。セキュリティを強化するために、DBUAは、アップグレード後のデータベースで、新しいユーザー・アカウントを自動的にロックします。その後、DBUAは、新しいOracleホームへの新しい構成ファイル(パラメータ・ファイルおよびリスナー・ファイル)の作成へと進みます。

DBUAは、アップグレード前のすべてのステップが完了するまで、アップグレード処理を開始しません。

DBUAによって起動されるアップグレード・スクリプト

アップグレード中に、DBUAによって、アップグレードを自動化して停止時間を最小化する適切なアップグレード・スクリプトが自動的に実行されます。

前提条件フェーズでは、DBUAは、アップグレード前パラメータ(autoupgrade.jar -preupgrade -mode)を使用してAutoUpgradeを実行します。これにより、データベース・チェックとアップグレード前修正が実行され、アップグレードを開始する前にほとんどの問題が修正されます。

DBUAは、次のロジックを使用して、新しい必須表領域を変更または作成します。

  • データファイルが自動拡張可能で、十分なディスク領域がある場合、DBUAはアップグレードを続行します。
  • データファイルを自動拡張できない場合、ファイルの自動拡張を可能にするようにDBUAから求められます。
  • 表領域が自動拡張可能で、MAXSIZE初期化パラメータに調整が必要な場合、DBUAはこの調整をユーザーに求め、MAXSIZEパラメータを調整します。
  • 拡張できるディスク容量がない場合、DBUAは、別のデータファイルを追加して領域を作成するようユーザーに要求します。DBUAはファイルの作成場所を決定できないため、DBUAによる新しいデータファイルの追加は自動的に行われません。

DBUAは前提条件フェーズで検出された多くの問題に対処します。たとえば、DBUAは正しいタイムゾーン・ファイルが使用されていて、ネットワーク・アクセス制御リストのACLの調整を行うことを確認できます。

アップグレード・フェーズ中に、DBUAは、アップグレード処理をシリアルではなくパラレルに実行するcatctl.plを実行します。パラレル実行によって、CPUリソースの使用率が最適化され、アップグレードの高速化と停止時間の最小化が実現します。

関連トピック

既存のOracleホームからのデータベースの移動

この手順を使用して、Oracle Databaseを別のOracle Database 18c以上のホームに移行します。

Oracle Database 18c以上のリリースでは、Database Upgrade Assistant (DBUA)を使用して、既存のOracleホームから別のOracleホームにOracle Databaseデータベースを移行できます。

  1. DBUAを起動します。

    DBUAで「データベースの選択」ウィンドウが開きます。

    サーバー上のすべてのデータベースがリストされます。DBUAは、データベースのリリースと場所に応じて、データベースごとに実行できる操作のタイプ(アップグレード、移動、インプレース)を示します。

    新しいOracleホームに移動するデータベースを選択します。データベースに対してオペレーティング・システムの認証を有効にしなかった場合は、選択したデータベースのSYSDBAユーザー名とパスワードを指定します。

    「次へ」をクリックします。「データベース・オプションの移動」ウィンドウが表示されます。

  2. 「移動オプションの選択」ウィンドウで、データベースの移動後に実行するカスタムSQLスクリプトと、ファイルを置く場所を指定します。

    「次へ」をクリックします。 「ネットワークの構成」ウィンドウが表示されます。

  3. 単一インスタンス・システムでは、既存のリスナーを選択するか、または新しいリスナーを作成できます。新しいリスナーを作成する場合、リスナー名と、そのリスナーのポート番号を指定する必要があります。

    「次へ」をクリックします。 「データベースの移動サマリー」ウィンドウが表示されます。

  4. 移動操作のサマリーを確認して、「次へ」をクリックします。

  5. 「設定」ウィンドウが表示され、データベースの移動に伴ってDBUAプロセスが示されます。

  6. 移動操作が完了したら、「終了」をクリックします。

  7. 「結果」ウィンドウが表示されます。ソースおよびターゲットのデータベース情報を表示したり、移動ステップを確認したり、ログ・ファイルを確認できます。確認が終了したら、「閉じる」をクリックします。

DBUAを使用したLinux、UnixおよびWindowsシステムでのデータベースのアップグレード

DBUAのグラフィカル・ユーザー・インタフェースを使用してデータベースをアップグレードするには、新しいOracleホーム内からこれらのステップを実行します。

Microsoft Windowsシステム(Windows)で、Oracle Database管理ユーザー(オペレーティング・システム割当てのORA_DBAロールを持つユーザー)またはOracleインストール所有者アカウントとしてDBUAを実行します。

  1. 新しいデータベース・ソフトウェアがインストールされたOracleホームからOracle Database Upgrade Assistant (DBUA)を起動します。dbua実行可能ファイルはディレクトリ・パスORACLE_HOME/binにあります。

    • LinuxまたはUnixプラットフォームの場合、SYSDBA権限を持つユーザーとしてログインし、Oracle Database 19cの新しいホームでシステム・プロンプトに次のコマンドを入力します。

      ./dbua
    • Windowsオペレーティング・システムの場合、「スタート」「プログラム」「Oracle HOME_NAME「Configuration and Migration Tools」「Database Upgrade Assistant」を選択します。

  2. 「データベースの選択」ウィンドウが表示されます。以前のリリースのOracle Databaseがインストールされている場合は、これらがアップグレード可能としてリストされます。

    いずれかのDBUAウィンドウのヘルプが必要な場合、またはDBUAの詳細を参照する場合は、「ヘルプ」をクリックしてオンライン・ヘルプを開きます。

    必要に応じて、選択したデータベースのSYSDBAユーザー名とパスワードを入力します。

    SYSDBA権限を所有していないユーザー・アカウントからDBUAを実行する場合、またはソース・データベースにオペレーティング・システム認証がない場合、ユーザー名およびパスワード資格証明を入力して、選択されたデータベースに対するSYSDBA権限を有効にする必要があります。使用するユーザー・アカウントにSYSDBA権限がある場合、またはオペレーティング・システム認証を使用した場合、ユーザー名とパスワードを入力する必要はありません。

    選択を行った後に「次へ」をクリックします。

    ノート:

    • 一度に1つのデータベースのみを選択できます。

    • 単一インスタンスのアップグレードで、データベースがリストに表示されない場合、/etc/oratabにそのデータベース名のエントリが存在するかどうかを確認してください。そのデータベースがそこにリストされていない場合は、DBUAに特定のデータベースをアップグレードするように指示します。

      • 使用している単一インスタンス・データベースが/etc/oratabにリストされておらず、かつ、DBUAがデータベースに接続できる場合は、コマンドライン引数として-sid Oracle_SID-oracleHome Oracle_homeおよびsysDBAPassword passwordを使用してDBUAを起動することにより、そのデータベースをアップグレードするように明示的に指示できます。たとえば:

        dbua -sid Oracle_SID –oracleHome /u01/app/oracle/18.1.0/dbhome1 -sysDBAUserName SYS -sysDBAPassword password
    • アカウントにSYSDBA権限がない場合、またはオペレーティング・システム認証が設定されていない場合は、次の構文を使用して接続できます。mydbはOracle Database SID、usernameはSYSDBA権限を持つユーザー名およびpasswordはユーザー名のパスワードです。
      dbua -sid mydb –oracleHome /u01/app/oracle/18.1.0/dbhome1 -sysDBAUserName - username -sysDBAPassword - password
    • Oracle Real Application Clusters (Oracle RAC)のアップグレードで、データベースがリストに表示されない場合、次のcrsctlコマンドを入力してOracle RACインスタンスを確認してください。

      crsctl status resource -t

      次のコマンドを入力して特定のOracle RACデータベースを確認することもできます(db_nameはOracle RACデータベースの名前)。

      crsctl status resource ora.db_name.db

    • Microsoft Windowsでは、次のセキュリティ変更が認証とユーザー・アカウントに影響します。

      • セキュリティ上の理由から、NTLMプロトコルを使用したWindows NTS認証はサポートされなくなりました。Kerberos認証のみがサポートされている認証です。このリリースでは、NTSは、Windows NTドメインでも、Windows NTコントローラを使用するドメインでも動作しません。

      • Oracleは、Windows LocalSystemアカウントではなく標準のMicrosoft Windowsユーザー・アカウントを使用してOracle Databaseサービスを実行します。Oracleインストール所有者のアカウント・アクセス権限を制限することで、Microsoft Windowsのセキュリティが向上します。

  3. 選択したデータベースがマルチテナント・コンテナ・データベース(CDB)の場合、DBUAによって「プラガブル・データベース」ウィンドウが表示されます。「プラガブル・データベース」ウィンドウにはCDBに含まれているプラガブル・データベースがリストされます。リストされたPDBは、選択されたCDBのアップグレードの一部としてアップグレードされます。

    PDBのアップグレードの優先度を選択できます。各PDBの優先度列をクリックし、アップグレード優先度の数値を入力します(1が最初のアップグレード、2が2番目のアップグレードというように続きます)。

    デフォルトで、CDB$ROOTPDB$SEEDおよびCDBに接続されているすべてのPDBがアップグレードされます。このときに一部のPDBをアップグレードしない場合は、それらのPDBを切断します。

    PDBおよびアップグレード優先度の選択が完了したら、「次へ」をクリックします。

  4. Windowsプラットフォームでのみ、アップグレード・ターゲット・ホームがOracleホーム・ユーザーに関連付けられたセキュアなホームの場合は、「Oracleホームのユーザー・パスワードの指定」ウィンドウが開きます。他のプラットフォームでは、次のステップに進みます。

    Oracleホームのユーザー名と、そのユーザー・アカウントのパスワードを指定して、「次へ」をクリックします。

  5. 「前提条件チェック」ウィンドウが開きます。DBUAによって、データベースの分析およびアップグレード前のチェックが実行され、必要に応じて警告が表示されます。次のリストは、データベースに対するDBUAのチェックおよびDBUAが行う処置の例です。

    • 空のデータベースのごみ箱。

    • 無効なオブジェクトの識別。

    • 非推奨となったかサポートが終了した初期化パラメータの識別。

    • タイムゾーン・データファイルの識別。

    分析完了までには数分かかります。

    DBUAによる分析が終了すると、「前提条件チェック」ウィンドウが再び表示され、チェック結果が示されます。

    「前提条件チェック」ウィンドウには、DBUAが完了したチェックと、検出されたエラーの重大度が表示されます。DBUAによってエラーが検出された場合、エラーが修正可能かどうかと、エラーを修正するために実行できる処置の内容が示されます。

    DBUAで修正できるエラーが表示されている場合、「修正および再チェック」を選択します。

    DBUAで修正できないエラーが検出された場合、エラーの原因を手動で修正し、「再チェック」を選択します。

    DBUAでエラーまたは警告が検出されない場合、このウィンドウは自動的に省略され、次のウィンドウに進みます。

    検出されたエラーを修正したら、「次へ」をクリックします。

  6. 「アップグレード・オプションの選択」ウィンドウが表示されます。

    このウィンドウには次のオプションがあります。

    並列アップグレードの有効化

    アップグレード処理中にパラレル実行を有効にするには、このオプションを選択します。アップグレード処理のパラレル実行は、スクリプトおよび処理の実行を同時に処理するために使用可能なCPUの数に基づいて、アップグレードの実行に必要な時間を短縮します。

    アップグレード後に無効なオブジェクトを再コンパイル

    このオプションは、アップグレード完了後にすべての無効なPL/SQLモジュールを再コンパイルします。アップグレード後フェーズでDBUAによる無効なオブジェクトの再コンパイルを行わない場合は、データベースをアップグレードした後に無効なオブジェクトを手動で再コンパイルする必要があります。

    タイム・ゾーン・データのアップグレード

    このオプションは、このリリースのタイムゾーン・データ・ファイルを更新します。このオプションを選択しない場合は、アップグレード後にタイム・ゾーン構成ファイルを手動で更新する必要があります。

    実行するカスタムSQLスクリプトの指定

    アップグレードの一部としてカスタムSQLスクリプトを実行する場合は、このオプションを選択します。必要に応じて「アップグレード前」または「アップグレード後」入力フィールドの「参照」をクリックします。カスタムSQLスクリプトがある場所に移動します。

    選択が完了したら、「次へ」をクリックします。

  7. リカバリ・オプションの選択ウィンドウが表示されます。アップグレード中にエラーが発生した場合にデータベースをリカバリするには、次のオプションのいずれかを選択します。

    • フラッシュバックおよび保証付きリストア・ポイントの使用

      新しい保証付きリストア・ポイントを作成するか、既存のものを使用できます。既存のリストア・ポイントを使用する場合は、選択フィールドをクリックして使用するリストア・ポイントを選択します。

      ノート:

      アップグレードするデータベースにOracle Data Guardフィジカル・スタンバイが含まれている場合は、最初に各スタンバイに保証付きリストア・ポイントを作成してから、プライマリ・データベースに保証付きリストア・ポイントを作成する必要があります。最初に各スタンバイにリストア・ポイントを作成しない場合は、保証付きリストア・ポイントを使用してプライマリ・データベースをダウングレードした後に、すべてのスタンバイ・データベースをもう一度再作成する必要があります。アップグレードが正常に終了した後、スタンバイ上のすべての保証付きリストア・ポイントを手動で削除する必要があります。

    • RMANバックアップの使用

      次のRMANバックアップ・オプションから選択します。

      • 新規オフラインRMANバックアップの作成:このオプションを選択した場合は、バックアップを配置する場所のパスを指定します。
      • ユーザー表領域をR/Oに設定した新規部分オフラインRMANバックアップの作成:このオプションを選択した場合、アップグレード中にユーザー表領域が読取り専用モードになります。
      • 最新の使用可能な完全RMANバックアップの使用:このオプションを選択した場合は、「リストア・スクリプトの表示/編集」をクリックして、使用するバックアップを選択します。
    • 独自のバックアップおよびリストア計画

      既存のデータベースにサード・パーティのバックアップ・ソリューションが存在する場合のみ、このオプションを選択します。

    選択が完了したら、「次へ」をクリックします。

  8. 単一インスタンス・データベースのインストールの場合は、「ネットワークの構成」ウィンドウが開きます。アップグレードした新しいOracleホームに移行するソースOracleホームから1つ以上のリスナーを選択するか、インストール中に新しいリスナーを作成します。

    「ネットワーク構成」ウィンドウの「リスナーの選択」領域には、次の列がある表が表示されます。

    • 「選択」列。更新するリスナーを選択します。

    • 名前。この列にはリスナーの名前が表示されます。

    • ポート。この列にはリスナーが構成されるポートが表示されます。

    • Oracleホーム。この列にはリスナーが構成されるOracleホームが表示されます。

    • ステータス。この列にはリスナーのステータス(upまたはdown)が表示されます。

    • 移行。この列を選択し、移行するには「はい」を、移行しない場合は「いいえ」を選択します。

    新しいリスナーの作成を選択することもできます。新しいリスナーを作成する場合はリスナー名、リスナーを配置するOracleホーム、およびリスナーがモニターするポートを指定します。

    選択が完了すると、DBUAによって、移行するすべてのリスナーで次のステップが実行されます。

    1. DBUAによって、選択したリスナーがターゲットOracleホームのlistener.oraファイルに追加され、開始されます。

    2. DBUAによって、古い(ソース)listener.oraファイルからアップグレードされたデータベースのエントリが削除されます。

    3. DBUAによって、ソースとターゲット両方のOracle Database環境で、listener.oraファイルが再ロードされます。

    ノート:

    同じリスナーに登録されている他のデータベースがある場合、それらの新規クライアント接続リクエストはリスナーの移行時に影響を受ける可能性があります。

    選択が完了したら、「次へ」をクリックします。

  9. 「管理の構成」ウィンドウが表示されます。管理の構成ウィンドウで、管理オプションを選択します。

    • Enterprise Manager (EM) Database Expressの構成

      Oracle Enterprise Manager Database Expressは、Oracle Databaseに組み込まれているWebベースのデータベース管理アプリケーションです。EM Expressは、以前のリリースで使用可能だったDB Controlコンポーネントを置き換えます。Enterprise Manager Database Expressの構成を選択した場合は、EM Database Expressのポート番号を入力します。たとえば、5500と入力します。また、チェック・ボックスを選択して、Expressのポートをグローバル・ポートとして構成することもできます。

    • Enterprise Manager (EM) Cloud Controlへの登録

      Oracle Enterprise Manager Cloud Controlへの登録では、EM Cloud Controlで管理できるターゲットとして、データベースおよび関連するリスナー、Oracle ASMディスク・グループ、Oracle Clusterwareなどのエンティティを追加します。

      このオプションを選択した場合は、次の各フィールドに情報を入力する必要があります。

      • OMSホスト

      • OMSポート

      • EM管理ユーザー名

      • EM管理パスワード

      • DBSNMPユーザー・パスワード

      • ASMSNMPユーザー・パスワード

    情報の入力が完了したら、「次へ」をクリックします。

  10. 「サマリー」ウィンドウが開きます。「サマリー」ウィンドウに、アップグレードのために指定した情報が表示されます。情報を確認するには、リストを下にスクロールします。サマリーには次のような情報が含まれます。

    • ソース・データベース

    • ターゲット・データベース

    • プラガブル・データベース

    • アップグレード前のチェック

    • 初期化パラメータの変更

    • タイムゾーンのアップグレード

    選択を確認します。それから変更する項目のリンクを選択するか、「戻る」をクリックして前のページに移動するか、または「終了」を選択します。

    • 「サマリー」ウィンドウに修正が必要な情報が表示された場合は、更新する項目のリンクをクリックするか、または、「戻る」をクリックしてDBUA構成ウィザードを逆に移動します。

    • 「サマリー」ウィンドウに表示されている情報が正しい場合、「終了」をクリックします。「終了」をクリックするとアップグレードが開始されます。

    DBUAによるアップグレードが開始されると、「進行状況」ウィンドウにプログレス・バーが表示されます。「進行状況」ウィンドウに、アップグレード中にDBUAが完了したステップを含む表が表示されます。この表には、アップグレードの進行につれて、継続時間とアップグレード・ステップのステータスが表示されます。DBUAでは、この時点でアップグレードを取り消す必要がある場合に備えて、「停止」ボタンが提供されています。

    CDBルートおよび各PDBシードのアップグレードの終了までアップグレードが進行すると、「進行状況」ウィンドウでは、ステータスが「終了」とマークされます。

  11. アップグレードが完了すると、「結果」ウィンドウが開きます。「結果」ウィンドウには元のデータベースとアップグレードしたデータベースに関する情報が表示されます。「アップグレード結果」が表示され、DBUAが初期化パラメータに加えた変更も表示されます。マルチテナント・アーキテクチャ・データベースをアップグレードしている場合は、「結果」ウィンドウには、プラガブル・データベースと、アップグレード後にログ・ファイルが格納されるディレクトリも表示されます。アップグレード前チェックの詳細を表示するには、下にスクロールします。アップグレードが正常に終了した場合は、「アップグレード結果」フィールドに結果が表示され、警告メッセージは表示されません。サンプル画像に示されているように、アップグレードが正常に終了しなかった場合は、表示フィールドの右下隅に「データベースのリストア」ボタンが表示されます。このボタンをクリックしてデータベースの復元を開始できます。

  12. オプション: アップグレード処理の詳細を確認するには、このログ・ファイルを確認します。Oracleベース環境変数が設定されている場合は、DBUAログ・ファイルはパス/ORACLE_BASE/cfgtoollogs/dbua/upgradesession_timestamp/SIDにあります。Oracleベースが設定されていない場合は、DBUAログ・ファイルは、パス/ORACLE_HOME/cfgtoollogs/dbua/upgradesession_timestamp/SIDにあります

    ノート:

    「アップグレード結果」ウィンドウのHTMLバージョンも、ログ・ファイル・ディレクトリに保存されます。このHTMLウィンドウのリンクをクリックすると、ブラウザにログ・ウィンドウが表示されます。

    アップグレード結果に問題がない場合は、「閉じる」をクリックしてDBUAを終了します。

  13. アップグレードが完了したら、このマニュアルに記載されているアップグレード後の手順を実行します。アップグレード後の手順が完了したら、アップグレードしたデータベースをいつでも使用できます。

注意:

データベースの不正な使用を防止するために、データベースをアップグレードした直後にすべてのユーザー・パスワードを変更することをお薦めします。

Oracle Database 12c以上のリリースにデフォルトのセキュリティ設定が設定されている場合、パスワードの文字数は8文字以上である必要があります。welcomeoracleなどのパスワードは使用できません。

サイレント・モードのDBUAを使用したOracle Databaseのアップグレード

DBUAを-silentコマンドライン・オプションとともに使用すると、非対話型(「サイレント」)アップグレードを実行できます。

サイレント・モードでは、DBUAのユーザー・インタフェースは表示されません。DBUAは、メッセージ(情報、エラーおよび警告を含む)をORACLE_HOME/cfgtools/dbua/upgradesession_timestampのログ・ファイルに書き込みます(session_timestampはDBUAが実行したアップグレードのタイムスタンプを表します)。確実にアップグレードを行うために、DBUAによって生成されたログ・ファイルを確認することを強くお薦めします。

サイレント・モードでのDBUAの実行

この手順を使用して、DBUAを非対話(サイレント)モードで起動します。

  1. サイレント・モードでDBUAを起動するには、dbua -silent -sidコマンドを入力します。このコマンドによってDBUAがサイレント・モードで起動され、アップグレードするデータベースが識別されます。

    たとえば、データベース名がORCLの場合、次のコマンドを入力します。

    dbua -silent -sid ORCL &
    

アクティブ・モードおよびサイレント・モードでのDBUAのコマンドライン構文

この構文を使用して、対話形式または-silentオプション付きでDatabase Upgrade Assistant (DBUA)を実行します。

目的

コマンドライン・オプションを使用してDBUAを実行する場合、スクリプト形式ですべての有効なDBUAオプションを指定できます。スクリプト形式を使用すれば、グラフィック・ユーザー・インタフェース・ダイアログで構成情報の入力をしないで指定できます。

ファイル・パス

$ORACLE_HOME/directory_name

構文

使用方法: dbua [flag] [option]

フラグ

-createPartialBackup  ユーザー表領域を読取り専用モードで設定して、新しいオフライン部分RMANバックアップを作成するフラグ。
        -backupLocation  RMANバックアップのパスを識別するフラグ。
        -disableParallelUpgrade  データベース・アップグレードのパラレル実行を無効にするフラグ。
        -executePreReqs  指定されたデータベースに対してアップグレード前チェックのみを実行するフラグ。
                -sid | -dbName
                -sid
                -dbName
        -help - この使用方法のヘルプを表示します。
        -ignorePreReqs アップグレード前チェックでエラー条件を無視します。
        -silent 構成をサイレント・モードで実行します。
                -sid | -dbName
                -sid
                -dbName
        -skipListenersMigration データベースのアップグレードの一部としてリスナー移行プロセスをバイパスするフラグ。

オプション

DBUAのコマンドライン・オプションは次のとおりです。

[-asmsnmpPassword - ASMSNMP user password]
        [-backupLocation - Directory-where-you-want-to-back-up-your-database-before-starting-upgrade
       [-createGRP - [True | false] データベースがアーカイブ・ログおよびフラッシュバック・モードになっている場合に、保証付きリストア・ポイントを作成します。
        [-createListener - [true [listenrName:lsnrPort] | false]] 以降のリリースのOracleホームにリスナーを作成します。trueの場合は、listenerName:lsnrPortを追加します
        [-dbName - database-name]
                [-oracleHome - Oracle-home-path-of-database]
                [-sysDBAUserName - User-name-with-SYSDBA-privileges]
                        [-sysDBAPassword - Password-for-sysDBAUserName-user-name]
       [-dbsnmpPassword - DBSNMP-user-password]
        [-disableUpgradeScriptLogging - [true | false]] このコマンドはアップグレード処理中のSQLスクリプトの実行での詳細なログの生成を無効にします。デフォルトでは、これは有効になります。ログ生成を有効にするには、このコマンドを指定しないでください。
        [-emConfiguration - [DBEXPRESS | CENTRAL | BOTH | NONE] Enterprise Managerの情報を指定します。
                [-dbsnmpPassword - DBSNMP-user password]
                [-emPassword - Enterprise-Manager-administration-user-password]
                [-emUser - Enterprise-Manager-Administration-username-to-add-or-modify-targets]
                [-emExpressPort - port-for-EM-Express]
                [-omsHost - Enterprise-Manager-management-server-host-name]
               [-omsPort - Enterprise-Manager-management-server-port-number]
                [-asmsnmpPassword - ASMSNMP-user-password]
        [-ignoreScriptErrors - [true | false]] カスタム・スクリプトでORAエラーを無視する場合にこのフラグを指定します。
        [-initParam - name=value,name=value,...] name=value,name=valueという形式の
初期化パラメータ値のカンマ区切りリストを指定します。
                [-initParamsEscapeChar - [escape character] 特定のinitParamに複数の値がある場合のカンマのエスケープ文字。エスケープ文字が指定されていない場合は、バックスラッシュ(\)がデフォルトのエスケープです
        [-excludeInitParams - comma-delimited-list-of-initialization-parameters-to-exclude]
        [-keepDeprecatedParams - [true | false]] データベースのアップグレード中に非推奨のパラメータが維持されます(または維持されません)。
        [-localListenerWithoutAlias] TNS別名を使用せずにLOCAL_LISTENERを設定します。
        [-listeners listenerName:Oracle Home, listenerName:Oracle Home, …] 既存のリスナーにデータベースを登録します。listenerName:Oracle Homeという形式のカンマ区切りリストを使用してリスナーを指定します。以前のリリースのOracleホームからのリスナーは、newer release,lsnrName2または-listeners lsnrName1:Oracle home path、-listeners lsnrName2:Oracle home pathに移行されます。DBUAは、指定されたリスナーを、Grid Infrastructureホーム(構成されている場合)、ターゲット・ホームおよびソース・ホームから検索します。
        [-localRacSid - local-System-Identifier-of-cluster-database] クラスタ・データベースがOracle Cluster Registry (OCR)に登録されていない場合に使用します。
        [-logDir - Path-to-a-custom-log-directory]
       [-newGlobalDbName - New Global Database Name] このオプションは、Oracle Express Editionのアップグレードにのみ使用できます
        [-newSid - New System Identifier] このオプションは、Oracle Express Editionのアップグレードにのみ使用できます
        [-newInitParam - name=value,name=value,...] name=value,name=valueという形式の初期化パラメータ値のカンマ区切りリストを指定します。このオプションは、ターゲットのOracleホームでのみ許可されるパラメータを指定するために使用します。
                [-initParamsEscapeChar - escape character] 特定のinitParamに複数の値がある場合のカンマのエスケープ文字を指定します。エスケープ文字を指定しない場合は、バックスラッシュ(\)がデフォルトのエスケープです。
        [-oracleHomeUserPassword - Oracle-Home-user-password]
        [-pdbs - [All | NONE | pdb, pdb,…]] すべてのPDBを選択する場合はALL、PDBを選択しない場合はNONE、またはアップグレードする
                       プラガブル・データベース(PDB)の名前のカンマ区切りリストを指定します。
                -sid | -dbName
                -sid - System Identifier
                        [-oracleHome - データベースのOracleホームのパス]
                        [-sysDBAUserName - User-name-with-SYSDBA-privileges]
                                [-sysDBAPassword - Password-for-sysDBAUserName-user-name]
                -dbName - Database-Name
                        [-oracleHome - Oracle-home-path-of-database]
                        [-sysDBAUserName - User-name-with-SYSDBA-privileges]
                                [-sysDBAPassword - Password-for-sysDBAUserName-user-name]
        [-pdbsWithPriority - pdb:priority, pdb:priority, pdb:priority,...] アップグレードするプラガブル・データベース(PDB)のカンマ区切りリスト(対応する優先度(1が最優先)を含む)を指定します。
                -sid | -dbName
                -sid - system-identifier
                        [-oracleHome - Oracle-home-path-of-database
                        [-sysDBAUserName - User-name-with-SYSDBA-privileges]
                                [-sysDBAPassword - Password-for-sysDBAUserName-user-name]
                -dbName - database-name
                        [-oracleHome - Oracle-home-path-of-the-database]
                        [-sysDBAUserName - User-name-with-SYSDBA-privileges]
                                [-sysDBAPassword - Password-for-sysDBAUserName-user-name]
        [-performFixUp - [true | false] サイレント・アップグレード・モードで修正を有効または無効にします。
       [-postUpgradeScripts - SQLscript, SQLscript,…] SQLスクリプトのカンマ区切りリストを完全なパス名で指定します。アップグレードが完了すると、これらのSQLスクリプトが実行されます。
        [-preUpgradeScripts - SQLscript, SQLscript,…]SQLスクリプトのカンマ区切りリストを完全なパス名で指定します。アップグレードが開始される前に、これらのSQLスクリプトが実行されます。
        [-recompile_invalid_objects - [true | false]] trueの場合は、アップグレードの一部として、無効なオブジェクトが再コンパイルされます。
        [-upgrade_parallelism - number] パラレル・アップグレードに使用するCPU数の数値。
        [-upgradeTimezone - [true | false]] trueの場合は、アップグレード中にデータベースのタイムゾーン・ファイルがアップグレードされます。
        [-upgradeXML - Path-to-existing-preupgrade-XML-file] このオプションは、インプレース・データベース・アップグレードにのみ適用されます。
        [-useExistingBackup - [true | false]] 既存のRMANバックアップを使用したデータベースのリストアを有効にする場合に使用します。
        [-useGRP - Name-of-existing-guaranteed-restore-point] 指定された保証付きリストア・ポイントを使用したデータベースのリストアを有効にする場合に使用します。

例C-1 DBUAを使用するアップグレードのデータベースの選択

次のコマンドでは、アップグレードのためにデータベースorclを選択します。

dbua -sid orcl

ノート:

DBUAコマンドを使用してパスワードを設定できます。Oracle Databaseのデフォルトのセキュリティ設定が適用されている場合、パスワードは8文字以上にする必要があり、welcomeoracleなどのパスワードは使用できません。

例C-2 非対話型(サイレント)オプションを使用したDBUAによるアップグレードのデータベースの選択

次のコマンドでは、非対話(サイレント)オプションを使用してアップグレードのためにデータベースorclを選択します。

dbua -silent -sid orcl

例C-3 非対話(「サイレント」)モードでのDBUAの実行のユース・ケース

後続の例では、DBUAを非対話型(「サイレント」)オプションととも使用して、様々なアップグレード・シナリオを実行する方法を説明しています。

dbua -silent -sid sidb112 -backupLocation /u01/sidb1123/backup -sysDBAUserName sys -sysDBAPassword r3aDy2upg -oracleHome /u01/app/product/11.2.0/dbhome_1 -upgradeTimezone true dbua -silent -sid sidb1123 -backupLocation /u01/sidb1123/backup -sysDBAUserName sys -sysDBAPassword r3aDy2upg -oracleHome /u01/app/product/11.2.0/dbhome_1 -upgrade_parallelism 1 -upgradeTimezone true 
dbua -silent -sid db1124 -backupLocation /u01/sidb1123/backup -sysDBAUserName sys -sysDBAPassword r3aDy2upg -performFixUp true -upgradeTimezone true 
dbua -silent -dbName rdbcdb -oracleHome /u01/app/product/11.2.0/dbhome_1 -sysDBAUserName sys -sysDBAPassword r3aDy2upg -backupLocation /u01/sidb1123/backup -recompile_invalid_objects true -upgradeTimezone true 
dbua -silent -dbName amdb -oracleHome /u01/app/product/11.2.0/dbhome_1 -sysDBAUserName sys -sysDBAPassword r3aDy2upg -recompile_invalid_objects true -useGRP GRP_20170620bfupgrade -upgradeTimezone true 
dbua -silent -dbName rdb12 -oracleHome /u01/app/product/12.2.0/dbhome_2 -sysDBAUserName sys -sysDBAPassword r3aDy2upg -backupLocation /u01/sidb12/backup -recompile_invalid_objects true -upgradeTimezone true 
dbua -silent -dbName ronedb -oracleHome /u01/app/product/12.2.0/dbhome_2 -sysDBAUserName sys -sysDBAPassword r3aDy2upg -recompile_invalid_objects true -upgradeTimezone true -createGRP true

ノート:

セキュリティのベスト・プラクティスの詳細は、『Oracle Databaseセキュリティ・ガイド』を参照してください。