3 Oracle Identity Manager単一ノード環境のアップグレード

Oracle Identity Managerをリリース12c (12.2.1.4.0)からOracle Identity Governance 14c (14.1.2.1.0)にアップグレードできます。

ノート:

このガイドでは、Oracle Identity Manager製品は、Oracle Identity Manager (OIM)およびOracle Identity Governance (OIG)とほぼ同じ意味で使用されます。

アップグレードを実行するために、次に示す各トピックのステップを完了します。

Oracle Identity Manager単一ノードのアップグレード・プロセスについて

Oracle Identity Manager単一ノード・デプロイメントのアップグレード・プロセスの概要に関するロードマップを確認します。

既存のドメインをアップグレードするために実行するステップは、ドメインがどのように構成されているか、およびどのコンポーネントをアップグレードするかによって異なります。各自のデプロイメントに該当するステップにのみ従ってください。

表3-1 Oracle Identity Manager単一ノード環境のアップグレードのためのタスク

タスク 説明

必須

このガイドの概要に関するトピックを再確認して、アップグレード前のタスクを完了します(まだ実行していない場合)。

参照:

必須

12cサーバーを停止します。これには管理サーバー、管理対象サーバー、ノード・マネージャ、およびOracle HTTP Serverなどのシステム・コンポーネントが含まれます。

アップグレード中、データベースが稼働していることを確認してください。

警告: アップグレード中にサーバーを停止しないと、データが破壊される可能性があります。

「サーバーとプロセスの停止」を参照

必須

OIMHOST上の既存の12c (12.2.1.4.0) Middlewareホーム・フォルダのバックアップを作成します

「OIMHOST上の12c (12.2.1.4.0) Oracleホーム・フォルダのバックアップ」を参照してください。

必須

アップグレード開始前に、アップグレード前レポート・ユーティリティを実行し、検出された問題に対処します。

アップグレード前レポート・ユーティリティは、既存のOracle Identity Manager環境を分析し、アップグレードを開始する前に完了する必要がある必須前提条件に関する情報を提供します。

「Oracle Identity Managerのアップグレード前レポートの生成および分析」を参照してください

新しい14c Middlewareホームの場所を作成します。

アップグレードを開始する前に、新しい14c (14.1.2.1.0) Middlewareホームの場所が本番デプロイメントと同じホスト上にある必要があります。

必須

新規に作成した14c (14.1.2.1.0) Middlewareホームに、Fusion Middleware Infrastructure 14c (14.1.2.0.0)、Oracle SOA Suite 14c (14.1.2.0.0)およびOracle Identity Manager14c (14.1.2.1.0)をインストールします。

アップグレードを開始する前に、本番デプロイメントと同じホスト上に準備した14c (14.1.2.1.0) Middlewareホームに次の製品をインストールします。

  • Fusion Middleware Infrastructure 14c (14.1.2.0.0)

  • Oracle SOA Suite14c (14.1.2.0.0)

  • Oracle Identity Manager14c (14.1.2.1.0)

前述の製品のインストールでは、クイック・インストーラを使用する簡易インストール・プロセスを使用することをお薦めします。クイック・インストーラでは、Infrastructure、Oracle SOA SuiteおよびOracle Identity and Access Management 14c (14.1.2.1.0)が一度にインストールされます。『Oracle Identity and Access Managementのインストールおよび構成』クイック・インストーラを使用したOracle Identity Governanceのインストールに関する項を参照してください。

もう1つのオプションとして、各インストーラを使用してこれらの製品を個別にインストールすることもできます。「製品ディストリビューションのインストール」を参照してください。

省略可能

Upgrade Assistantを使用してアップグレード前の準備状況チェックを実行します。

「アップグレード前の準備状況チェックの実行」を参照してください。

必須

アップグレード・アシスタントを起動して12cデータベース・スキーマをアップグレードします。

「製品スキーマのアップグレード」を参照してください。

再構成ウィザードを実行して、ドメイン・コンポーネント構成を14.1.2.1.0に再構成します。

WebLogic Serverドメインを再構成すると、ドメイン内のアプリケーションに応じて、次の項目が自動的に更新されます。
  • WebLogic Serverコア・インフラストラクチャ
  • ドメイン・バージョン

ドメインの再構成を参照してください

ノート:

ドメイン再構成プロセスが開始されると、そこで行われた変更は元に戻せません。再構成ウィザードを実行する前に、アップグレード前チェックリストに示されているようにドメインをバックアップしてあることを確認してください。再構成ウィザードの実行中にエラーまたは他の割込みが発生した場合、バックアップ場所から元のドメイン・ディレクトリにファイルとディレクトリをコピーすることによって、ドメインをリストアする必要があります。これは、再構成前の元の状態にドメインを復元するための唯一の方法です。

必須

Upgrade Assistantを2回実行して、ドメイン・コンポーネントの構成をアップグレードします。

「ドメイン・コンポーネント構成のアップグレード」を参照してください。

ノート:

jceは、無制限強度の暗号化ポリシーを使用する必要があります。
省略可能

oracle.iam.ui.custom-dev-starter-pack.warファイルを14c (14.1.2.1.0) Middlewareホームにコピーします。

ノート:

このステップは、UIのカスタマイズのためにファイルが変更されている場合にのみ必要です。

14c (14.1.2.1.0) Middlewareホームへのoracle.iam.ui.custom-dev-starter-pack.warのコピー」を参照してください。

省略可能

システム依存のデータ・フォルダを14c (14.1.2.1.0) Oracleホームにコピーします。

14c (14.1.2.1.0)にアップグレードする際に、一部のフォルダにファイル・システム依存データがある場合は、それらのフォルダを新しいOracleホームに手動でコピーする必要があります。

必須

サーバーを起動します。

「サーバーとプロセスの起動」を参照してください。

必須

ドメイン固有コンポーネント構成が正常に完了したことを確認します。

「ドメイン固有コンポーネント構成のアップグレードの確認」を参照してください。

省略可能

アップグレード後に必要なタスクを実行します。

「アップグレード後タスク」を参照してください。

Oracle Identity Managerのアップグレード前のタスクの完了

Oracle Identity Managerをアップグレードする前に、この項で説明しているアップグレード前のタスクを完了します。

メモリー設定の確認

Oracle Identity Managerに関するメモリーの問題を回避するため、要件に従ってメモリー設定が更新されていることを確認します。

Linuxで、rootユーザーとして次を実行します:
  1. /etc/security/limits.confまたは/etc/security/limits.dファイルの次のパラメータに対して、指定した値が設定されていることを確認します:
    FUSION_USER_ACCOUNT soft nofile 32767
    FUSION_USER_ACCOUNT hard nofile 327679
  2. /etc/ssh/sshd_configファイルで、UsePAMYesに設定されていることを確認します。
  3. sshdを再起動します。
  4. maxprocの制限を確認し、必要に応じて16384以上に増やします。制限を増やすと、メモリーの問題が発生しなくなります。

    次のコマンドを使用して、制限をチェックします:

    ulimit -u

    16384未満の場合は、次のコマンドを使用して、開いているファイルの制限を増やします:

    ulimit -u 16384

    ノート:

    コマンドulimit -uを再発行すると、制限が正しく設定されたことを確認できます。
    再起動時に設定が保持されるようにするには、/etc/security/limits.confファイルまたは /etc/security/limits.dファイルに次の行を追加します:
    oracle hard nproc 16384

    ここで、oracleはインストール・ユーザーです。

  5. システムをログアウト(または再起動)し、再度ログインします。

SSL有効設定のための非SSLポートのオープン

SSL有効設定と非SSL無効設定がある場合、Oracle Identity Managerのアップグレードを続行する前に、データベースのための非SSLポートをオープンする必要があります。

データベース・リスナーが、Upgrade Assistantにパラメータとして指定したデータベース・サーバーのTCPポートと同じTCPポートでリスニングしていることを確認します。詳細は、「Oracle Identity Governance DBのSSLの有効化」を参照してください。

一時フォルダのクリーニング

すべてのOracle Identity Governanceホスト・マシンの/tmpをクリーニングします。

/tmpディレクトリはJVM java.io.tmpdirプロパティに対して設定されているため、/tmpフォルダ内の不要なファイルがOIGのアップグレード・プロセスに干渉し、結果としてMDSが破損する可能性があります。

metadata.marファイルの手動バックアップ

既存のOracleホームに14c (14.1.2.1.0)バイナリをインストールしたら、アップグレードの前に14c (14.1.2.1.0)_ORACLE_HOME>/idm/server/apps/oim.ear/metadata.marファイルのバックアップを取得します。

サーバーとプロセスの停止

Upgrade Assistantを実行してスキーマと構成をアップグレードする前に、すべてのアップグレード前のプロセスとサーバー(管理サーバー、ノード・マネージャ(ノード・マネージャを構成した場合)および管理対象サーバーを含む)を停止する必要があります。

Oracle Fusion Middleware環境は、Oracle WebLogic Serverドメイン、管理サーバー、複数の管理対象サーバー、Javaコンポーネント、システム・コンポーネント、およびメタデータのリポジトリに使用されるデータベースで構成できます。コンポーネントは相互に依存していることがあるため、適切な順序で停止する必要があります。

ノート:

この項の手順では、WLSTコマンドライン・ユーティリティまたはスクリプトを使用して、既存のアップグレード前のサーバーとプロセスを停止する方法について説明します。Oracle Fusion Middleware ControlおよびOracle WebLogic Serverリモート・コンソールを使用することもできます。「管理サーバー、管理対象サーバーおよびノード・マネージャの起動と停止」を参照してください。

リリース14c (14.1.2.0.0)以降、WebLogic Server管理コンソールは削除されました。同等の機能を使用するには、WebLogicリモート・コンソールを使用する必要があります。詳細は、Oracle WebLogicリモート・コンソールを参照してください。

アップグレード前のFusion Middleware環境を停止するには、アップグレード前のドメインに移動し、次のステップに従います。

ノート:

次のサーバーを正しい順序で停止することが重要です。

ステップ1: 管理対象サーバーを停止する

管理対象サーバーの起動方法に応じて、次のいずれかの方法に従ってWebLogic管理対象サーバーを停止します:

方法1: ノード・マネージャによって管理されていないWebLogic Server管理対象サーバーを停止するには:
  • (UNIX) DOMAIN_HOME/bin/stopManagedWebLogic.sh managed_server_name admin_url

  • (Windows) DOMAIN_HOME\bin\stopManagedWebLogic.cmd managed_server_name admin_url

プロンプトが表示されたらユーザー名とパスワードを入力します。

方法2: Weblogicコンソールを使用してWebLogic Server管理対象サーバーを停止するには:
  • weblogic管理者としてWeblogicコンソールにログインします。
  • 「サーバー」 > 「制御」タブに移動します。
  • 必要な管理対象サーバーを選択します。
  • 「停止」をクリックします。
方法3: ノード・マネージャを使用してWebLogic Server管理対象サーバーを停止するには、次のコマンドを実行します:
wls:/offline>nmConnect('nodemanager_username','nodemanager_password',
            'AdminServerHostName','5556','domain_name',
            'DOMAIN_HOME','nodemanager_type')

wls:/offline>nmKill('ManagedServerName')

ステップ2: 管理サーバーを停止する

管理サーバーを停止するときに、管理サーバーで稼働しているプロセス(WebLogic Server管理コンソールやFusion Middleware Controlなど)も停止します。

次のいずれかの方法に従って、管理サーバーを停止します:

方法1: ノード・マネージャによって管理されていない管理サーバーを停止するには:
  • (UNIX) DOMAIN_HOME/bin/stopWebLogic.sh

  • (Windows) DOMAIN_HOME\bin\stopWebLogic.cmd

プロンプトが表示されたら、管理サーバーのユーザー名とパスワード、およびURLを入力します。

方法2: Weblogicコンソールを使用して管理サーバーを停止するには:
  • weblogic管理者としてWeblogicコンソールにログインします。
  • 「サーバー」 > 「制御」タブに移動します。
  • 必要な管理サーバーを選択します。
  • 「停止」をクリックします。
方法3: ノード・マネージャを使用してWebLogic Server管理対象サーバーを停止するには、次のコマンドを実行します:
wls:/offline>nmConnect('nodemanager_username','nodemanager_password',
            'AdminServerHostName','5556','domain_name',
            'DOMAIN_HOME','nodemanager_type')

wls:/offline>nmKill('AdminServer')

ステップ4: ノード・マネージャを停止する

ノード・マネージャを停止するには、次のコマンドを実行します:

<DOMAIN_HOME>/bin/stopNodeManager.sh

OIMHOST上の12c (12.2.1.4.0) Oracleホーム・フォルダのバックアップ

OIMHOST上の12c (12.2.1.4.0) Oracleホームをバックアップします。

バックアップとして、OIMHOST上で12.2.1.4.0 Oracleホーム・フォルダをコピーして名前を変更します。

たとえば:

/u01/app/fmw/ORACLE_HOME/u01/app/fmw/ORACLE_HOME_oldにします

ノート:

カスタム構成は必ずバックアップしてください。これらの構成は、アップグレード後にリストアします。

製品ディストリビューションのインストール

アップグレードの開始前に、Oracle Fusion Middleware Infrastructure、Oracle SOA SuiteおよびOracle Identity Managerのディストリビューションをターゲット・システムにダウンロードし、次の手順を使用してインストールします。

アップグレード前のチェックリストを確認し、Java Development Kit (JDK) jdk17.0.12以降がインストールされていることを確認します。

ノート:

アップグレード準備としてOracle Fusion Middlewareリリース14c ソフトウェアをインストールする際は、既存のアップグレード前のOracle Fusion Middlewareソフトウェアのインストールおよび構成に使用したものと同じユーザー・アカウントを使用する必要があります。UNIXオペレーティング・システムでは、これにより適切な所有者とグループが新しいOracle Fusion Middleware 14cのファイルとディレクトリに確実に適用されます。

ノート:

14cバイナリは、以前の12cバイナリとは異なる場所にインストールされます。14cバイナリは、アップグレードの計画停止時間の前にインストールできます。

前述の製品のインストールでは、クイックスタート・インストーラ(fmw_14.1.2.1.0_idmquickstart.jar)を使用する簡易インストール・プロセスを使用することをお薦めします。クイック・スタート・インストーラでは、Infrastructure、Oracle SOA SuiteおよびOracle Identity Managerが一度にインストールされます。

ノート:

冗長なバイナリの場所を使用している場合は、必ず冗長な場所それぞれにソフトウェアをインストールしてください。

『Oracle Identity and Access Managementのインストールおよび構成』クイックスタート・インストーラを使用したOracle Identity Governanceのインストールに関する項を参照してください。

もう1つのオプションとして、必要な製品ディストリビューション(Infrastructure、Oracle SOA SuiteおよびOracle Identity Manager 14c (14.1.2.1.0))を個別にインストールすることもできます。これを行うには、次のステップを実行します:

  1. ターゲット・システムにサインインします。
  2. Oracle Technology NetworkまたはOracle Software Delivery Cloudから次のものをターゲット・システムにダウンロードします。
    • Oracle Fusion Middleware Infrastructureをまだインストールしていない場合は、Oracle Fusion Middleware Infrastructure (fmw_14.1.2.0.0_infrastructure.jar)をダウンロードします
    • Oracle SOA Suite (fmw_14.1.2.0.0_soa.jar)
    • OTNまたはOracle Software Delivery CloudからのOracle Identity and Access Management 14c (fmw_14.1.2.1.0_idm.jarを含むfmw_14.1.2.1.0_idm_Disk1_1of1.zip)。

    ノート:

    ORACLE_HOMEフォルダが存在し、そこにファイルまたはフォルダが含まれていないことを確認します。ORACLE_HOMEフォルダにファイルまたはフォルダが残っている場合は、それらを削除します。
  3. 14c (14.1.2.1.0)製品のディストリビューションをダウンロードしたディレクトリに移動します。
  4. Oracle Fusion Middleware Infrastructure (fmw_14.1.2.0.0_infrastructure.jar)がすでにインストールされている場合は、ステップ15に進みます。
  5. 新しいJDKを指すOracle Fusion Middleware Infrastructureのインストール・プログラムを起動します。新しいJDKの場所を指すと、アップグレード・プロセスの後半でステップをスキップできます。
    次のコマンドを実行します:
    • (UNIX) NEW_JDK_HOME/bin/java -jar fmw_14.1.2.0.0_infrastructure.jar
    • (Windows) NEW_JDK_HOME\bin\java -jar fmw_14.1.2.0.0_infrastructure.jar

    ノート:

    user_projectsディレクトリおよびdomain-registry.xmlファイルがORACLE_HOMEに残っている場合は、インストールの失敗を回避するために-novalidationフラグを使用する必要があります。

    次に失敗メッセージの例を示します:
    Verifying data......
    [VALIDATION] [ERROR]:INST-07319: Validation of Oracle Home location failed. The location specified already exists and is a nonempty directory and not a valid Oracle Home
    [VALIDATION] [SUGGESTION]:Provide an empty or nonexistent directory location, or a valid existing Oracle Home
    installation Failed. Exiting installation due to data validation failure.
    he Oracle Universal Installer failed. Exiting.
    
    
  6. UNIXオペレーティング・システムでは、このホストにOracle製品を初めてインストールする場合に、「インストール・インベントリの設定」画面が表示されます。
    中央インベントリを作成する場所を指定します。この画面で選択したオペレーティング・システム・グループ名に対して中央インベントリの場所への書込み権限が付与されていることを確認し、「次」をクリックします。

    ノート:

    「インストール・インベントリの設定」画面は、Windowsオペレーティング・システムでは表示されません。
  7. 「ようこそ」画面で、情報をレビューしてすべての前提条件を満たしていることを確認します。「次」をクリックします。
  8. 「自動更新」画面で、オプションを選択します。
    • この時点でソフトウェアの更新をシステムで確認しないようにする場合は、「自動更新をスキップ」を選択します。

    • パッチ・ファイルをダウンロードした場合は、「ディレクトリからパッチを選択」を選択して、ローカル・ディレクトリに移動します。

    • My Oracle Supportアカウントを持っている場合にソフトウェアの更新を自動でダウンロードするには、「My Oracle Supportで更新を検索」を選択します。Oracle Supportの資格証明を入力して、「検索」をクリックします。インストーラがMy Oracle Supportにアクセスするようにプロキシ・サーバーを構成するには、「プロキシ設定」をクリックします。「接続のテスト」をクリックして接続をテストします。

    「次」をクリックします。
  9. 「インストールの場所」画面で既存のOracleホーム・ディレクトリの場所を指定して、「次へ」をクリックします。
    Oracle Fusion Middlewareディレクトリ構造の詳細は、『Oracle Fusion Middleware Oracle Fusion Middlewareのインストールのプランニング』インストールおよび構成のためのディレクトリの理解に関する項を参照してください。
  10. 「インストール・タイプ」画面で、「Fusion Middlewareインフラストラクチャ」を選択します。
    「次」をクリックします。
  11. 「前提条件チェック」画面では、ホスト・コンピュータを分析して、特定のオペレーティング・システムの前提条件を満たしているか確認します。
    確認されたタスクのリストを表示するには、「正常なタスクの表示」を選択します。ログの詳細を表示するには、「ログの表示」を選択します。前提条件のチェックが失敗すると、エラー・メッセージが画面の下方に表示されます。エラーを修正し、「再実行」をクリックして再試行します。エラー・メッセージや警告メッセージを無視してインストールを続けるには、「スキップ」をクリックします(非推奨)。
  12. 「インストールの概要」画面で、選択したインストール・オプションを確認します。
    これらのオプションをレスポンス・ファイルに保存する場合は、「レスポンス・ファイルの保存」をクリックし、レスポンス・ファイルの場所と名前を入力します。レスポンス・ファイルには、入力したすべての情報が収集して格納され、後で(コマンドラインから)サイレント・インストールを実行するために使用できます。

    「インストール」をクリックしてインストールを開始します。

  13. 「インストールの進行状況」画面で、プログレス・バーが100%完了になったら、「終了」をクリックしてインストーラを閉じるか、「次へ」をクリックしてサマリーを表示します。
  14. 「インストール完了」画面に、インストールの場所とインストールされた機能セットが表示されます。情報を確認し、「終了」をクリックしてインストーラを閉じます。
  15. Oracle Fusion Middleware Infrastructureのインストール後に、次のコマンドを入力して、製品ディストリビューションのインストーラを起動し、前述のステップを繰り返してインストーラの各画面を移動します。
    Oracle SOA Suite 14c (14.1.2.0.0)をインストールする場合は、次のインストーラを実行します。

    ノート:

    「インストール・タイプ」画面で、Oracle SOA Suiteの場合は「Oracle SOA Suite」を選択します。
    • (UNIX) NEW_JDK_HOME/bin/java -jar fmw_14.1.2.0.0_soa.jar

    • (Windows) NEW_JDK_HOME\bin\java -jar fmw_14.1.2.0.0_soa.jar

    Oracle Identity Manager 14c (14.1.2.1.0)をインストールする場合は、次のインストーラを実行します:

    ノート:

    「インストール・タイプ」画面で、Oracle Identity Managerの場合は、同じ場所に配置されたOracle Identity and Access Managerを選択します。
    • (UNIX) NEW_JDK_HOME/bin/java -jar fmw_12.2.1.3.0_idm.jar

    • (Windows) NEW_JDK_HOME\bin\java -jar fmw_12.2.1.3.0_idm.jar

Oracle Identity Manager 14c (14.1.2.1.0)のインストールの詳細は、『Oracle Identity and Access Managementのインストールおよび構成』Oracle Identity and Access Managementソフトウェアのインストールに関する項を参照してください。

アップグレード前の準備状況チェックの実行

アップグレードにかかわる潜在的な問題を特定するために、アップグレード・プロセスの開始前に、準備状況チェックの実行をお薦めします。準備状況チェックによって、アップグレードにかかわる潜在的な問題をすべて検出できるわけではない点に注意してください。準備状況チェックのレポートが成功を示していても、アップグレードが失敗することもあります。

アップグレード前の準備状況チェックの実行について

Upgrade Assistantを-readinessモードで実行することで、実際のアップグレードを実行する前に問題を検出できます。Upgrade Assistantを使用すると、準備状況チェックはGUIモードで実行できます。また、レスポンス・ファイルを使用するとサイレント・モードで実行できます。

Upgrade Assistantの準備状況チェックは、サポート対象の開始ポイントにあるFusion MiddlewareのスキーマとWebLogicドメインの構成について、読取り専用のアップグレード前確認を実行します。この確認は、読取り専用の操作です。

準備状況チェックでは、フォーマットされ、タイムスタンプの付けられた準備状況レポートが生成され、実際のアップグレードを試みる前に潜在的な問題に対処できます。問題が検出されない場合は、アップグレード・プロセスを開始できます。アップグレードを実行する前に、このレポートを詳細に確認することをお薦めします。

準備状況チェックは、既存のOracle Fusion Middlewareドメインがオンライン(他のユーザーがアクティブに使用している間)またはオフラインである間に実行できます。

準備状況チェックは、実際のアップグレードの実行前に、何度でも実行できます。ただし、アップグレードの実行後には、準備状況チェックを実行しないでください。これは、レポート結果が、アップグレード前の準備状況チェックと異なることがあるためです。

ノート:

パフォーマンスへの影響を避けるため、準備状況チェックはピーク時以外に実行するようにしてください。

準備状況モードでのUpgrade Assistantの起動

-readinessパラメータを使用して、Upgrade Assistantを準備状況モードで起動します。

Upgrade Assistantを使用して、アップグレード前の環境に対する準備状況チェックを実行するには:
  1. oracle_common/upgrade/binディレクトリに移動します。
    • (UNIX) ORACLE_HOME/oracle_common/upgrade/bin
    • (Windows) ORACLE_HOME\oracle_common\upgrade\bin

    ORACLE_HOMEは、14c (14.1.2.1.0) Oracleホームです。

  2. Upgrade Assistantを起動します。
    • (UNIX) ./ua -readiness
    • (Windows) ua.bat -readiness

    ノート:

    DISPLAY環境変数がGUIモードを有効にするように適切に設定されていないと、次に示すエラーが発生することがあります。
    Xlib: connection to ":1.0" refused by server
    Xlib: No protocol specified 

    この問題を解決するには、DISPLAY変数を、有効なX環境が動作しているホストおよびデスクトップに設定する必要があります。

    たとえば、デスクトップ6のローカル・ホストでVNC内部のX環境を実行している場合は、DISPLAY=:6を設定します。デスクトップ1のリモート・ホストでXを実行している場合は、これをDISPLAY=remoteHost:1に設定します。

    その他のコマンドラインに指定可能なパラメータの詳細は、次の項を参照してください。

Upgrade Assistantのパラメータ

コマンドラインからUpgrade Assistantを起動するときに、追加のパラメータを指定できます。

表3-2 Upgrade Assistantコマンドライン・パラメータ

パラメータ 必須またはオプション 説明

-readiness

準備状況チェックの場合は必須

ノート: 準備状況チェックはスタンドアロン・インストール上で実行できません(WebLogic Serverの管理対象でありません)。

アップグレードの準備状況チェックを実行します(実際のアップグレードは実行しません)。

スキーマと構成がチェックされます。

-examineパラメータを指定した場合は、このパラメータを指定しないでください。

-threads

オプション

スキーマの同時アップグレードまたはスキーマの準備状況チェックに使用可能なスレッドの数を特定します。

値は、1 - 8の正の整数である必要があります。デフォルトは4です。

-response

サイレント・アップグレードまたはサイレント準備状況チェックの場合は必須

Upgrade AssistantがGUIモードで実行されているときに入力したデータから生成されるレスポンス・ファイルに保存されている入力を使用して、Upgrade Assistantを実行します。このパラメータを使用すると、Upgrade Assistantはサイレント・モード(Upgrade Assistantの画面表示なし)で実行されます。

-examine

オプション

調査フェーズを実行しますが、実際のアップグレードは実行しません。

-readinessパラメータを指定した場合、このパラメータを指定しないでください。

-logLevel attribute

オプション

次のいずれかの属性を指定して、ログイン・レベルを設定します。

  • TRACE

  • NOTIFICATION

  • WARNING

  • ERROR

  • INCIDENT_ERROR

デフォルトのロギング・レベルはNOTIFICATIONです。

-logLevel TRACE属性を設定して、より多くのログが記録されるようにすることを検討してください。これは、アップグレードの失敗をトラブルシューティングする際に役立ちます。-logLevel TRACEが使用されると、Upgrade Assistantのログ・ファイルは非常に大きくなる可能性があります。

-logDir location

オプション

アップグレード・ログ・ファイルと一時ファイルのデフォルトの場所を設定します。Upgrade Assistantによってログ・ファイルおよび一時ファイルが作成される、既存の書込み可能なディレクトリを指定する必要があります。

デフォルトの場所は次のとおりです。

(UNIX)

ORACLE_HOME/oracle_common/upgrade/logs
ORACLE_HOME/oracle_common/upgrade/temp

(Windows)

ORACLE_HOME/oracle_common/upgrade/logs
ORACLE_HOME/oracle_common/upgrade/temp

-help

オプション

すべてのコマンドライン・オプションを表示します。

Upgrade Assistantを使用した準備状況チェックの実行

Upgrade Assistantの各画面を通じて、アップグレード前の準備状況チェックを完了します。

準備状況チェックは、サポートされるアップグレードの開始点にあるスキーマまたはコンポーネント構成に対してのみ実行されます。
準備状況チェックを完了するには:
  1. 「ようこそ」画面で、準備状況チェックに関する情報を確認します。「次」をクリックします。
  2. 「準備状況チェック・タイプ」画面で、「ドメイン・ベース」を選択します。

    「ドメイン・ベース」オプションを使用すると、「ドメイン・ディレクトリ」フィールドで指定されたドメイン内のアップグレード可能なスキーマまたはコンポーネントのすべてを、Upgrade Assistantが検出して選択できます。

    このオプションを選択すると、画面名が「スキーマおよび構成」に変更されます。

    Upgrade Assistantですべてのスキーマとコンポーネント構成をチェックする場合は、デフォルトの選択を変更しないで使用します。それ以外の場合は、次に示す特定のオプションを選択します。

    • 「すべてのスキーマのチェックを含める」: アップグレードに対応したコンポーネントをすべて検出して確認します。

    • 「すべての構成のチェックを含める」: 管理対象WebLogic Serverドメインのコンポーネント構成を確認します。

  3. 「ドメイン・ディレクトリ」フィールドで、14c (14.1.2.1.0)設定マシンにコピーされた12c (12.2.1.4.0)ドメイン・フォルダを選択します。14c (14.1.2.1.0)設定が12cリリースと同じマシン上にある場合、準備状況チェック中に12cドメイン・ホームの場所を指定します。

    「次」をクリックします。

  4. 「コンポーネント・リスト」画面に、スキーマがアップグレードされるコンポーネントのリストが表示されます。

    「次」をクリックします。

  5. スキーマ資格証明画面で、選択した12c (12.2.1.4.0)スキーマに接続するためのデータベース資格証明を指定します(「データベース・タイプ」「DBAユーザー名」および「DBAパスワード」)。アップグレード前の要件の一部として、必要なユーザーをすでに作成しました。「Upgrade Assistantを実行するための非SYSDBAユーザーの作成」を参照してください。

    次に、「接続」をクリックします。

    ノート:

    Oracleデータベースは、デフォルトのデータベース・タイプです。データベース・タイプに間違いがないことを確認してから続行してください。間違ったデータベースを選択していることに気付いた場合でも、正しいタイプに変更するために、この画面に戻らないでください。そのかわりに、Upgrade Assistantを終了してから、正しいデータベース・タイプを選択した状態で準備状況チェックを再開し、すべてのスキーマに正しいデータベース・タイプが適用されるようにします。

    「スキーマ・ユーザー名」オプションを選択して、「スキーマ・パスワード」を指定します。

    ノート:

    Upgrade Assistantでは、デフォルトの資格証明が自動的に有効になります。接続できない場合、スキーマの資格証明を手動で入力し、続行します。

    すべてのスキーマ接続が検証されるまで、「次」をクリックします(選択したスキーマに基づいて画面名が変わります)。

    ノート:

    接続に失敗する場合は、原因を調べ、修正してください。
  6. 「準備状況サマリー」画面で、選択内容に基づいて実行される準備状況チェックのサマリーを確認します。
    選択内容を保存して、今後、レスポンス(サイレンス)モードでUpgrade Assistantを再実行する場合は、「レスポンス・ファイルの保存」をクリックして、レスポンス・ファイルの場所と名前を指定します。サイレント・アップグレードは、Upgrade Assistantとまったく同じ機能を実行しますが、データを手動で再入力する必要はありません。
    詳細レポートを表示するには、「ログの表示」をクリックします。
    「次」をクリックします。
  7. 「準備状況チェック」画面で、準備状況チェックのステータスを確認します。このプロセスには、数分かかることがあります。
    複数のコンポーネントをチェックしている場合、それぞれのコンポーネントの進行状況は、それぞれ専用のプログレス・バーで同時に表示されます。
    準備状況チェックが完了したら、「続行」をクリックします。
    次のコンポーネントはアップグレードされていませんが、アップグレードの準備ができていますとマークされます。次のコンポーネントに対するアップグレードの準備ができていますというメッセージは、無視してください。
    • Oracle JRF
    • 共通インフラストラクチャ・サービス
    • Oracle Web Services Manager
  8. 「準備状況の終了」画面で、準備状況チェックの結果(「準備状況成功」または「準備状況失敗」)を確認します。
    • 準備状況チェックが成功した場合は、「準備状況レポートの表示」をクリックして完全なレポートを確認します。準備状況チェックが成功した場合でも、実際のアップグレードを実行する前に、準備状況レポートを確認するようにしてください。「検索」オプションは、レポート内の特定の語句を検索する際に使用します。また、このレポートには、完成した準備状況チェック・レポート・ファイルが格納されている場所も示されます。

    • 準備状況チェックで問題またはエラーが発生した場合、「ログの表示」をクリックして、ログ・ファイルを確認して問題を特定し、問題を修正してから、準備状況チェックを再開してください。ログ・ファイルは、設定したコマンドライン・オプションにより管理されます。

準備状況レポートの理解

ドメインの準備状況チェックを実行した後、レポートを確認してアップグレードを成功させるためのアクションをとる必要があるかどうかを判断します。

準備状況レポート・ファイルの形式は、次のとおりです。

readiness_timestamp.txt

timestampは、準備状況チェックが実行された日時を示します。

準備状況レポートには、次の情報が含まれています。

表3-3 準備状況レポートの要素

レポートの情報 説明 必要なアクション
全体的な準備状況ステータス: SUCCESSまたはFAILURE レポートの上部に、準備状況チェックが合格したか1つ以上のエラーで完了したかが示されます。 1つ以上のエラーが発生してレポートが完了した場合、アップグレードを試みる前に、FAILを検索し、障害の原因となった問題を修正します。準備状況チェックは、アップグレードする前に必要に応じて何度でも再実行できます。

タイムスタンプ

レポートが生成された日付と時刻です。

必要なアクションはありません。

ログ・ファイルの場所

ORACLE_HOME/oracle_common/upgrade/logs

生成されたログ・ファイルのディレクトリの場所です。

必要なアクションはありません。

準備状況レポートの場所

ORACLE_HOME/oracle_common/upgrade/logs

生成された準備状況レポートのディレクトリの場所です。

必要なアクションはありません。

チェックされたコンポーネントの名前

チェックに含まれるコンポーネントの名前およびバージョンとステータス。

ドメインに、このリリースにアップグレードできないSOAコア拡張機能などのコンポーネントが含まれる場合は、アップグレードを試行しないでください。

チェックされたスキーマの名前

チェックに含まれるスキーマの名前および現在のバージョンとステータス。

スキーマのバージョン番号をレビューします。ドメインに、このリリースにアップグレードできないスキーマが含まれる場合は、アップグレードを試行しないでください。

個別のオブジェクトのテスト・ステータス: FAIL

準備状況チェックのテストで、特定のオブジェクトに問題が検出されています。

失敗した問題がすべて解決されるまではアップグレードしないでください。

個別のオブジェクトのテスト・ステータス: PASS

準備状況チェックのテストでは、特定のオブジェクトに問題が検出されませんでした。

準備状況チェック・レポートに「成功」ステータスのみが表示されている場合は、環境をアップグレードできます。ただし、準備状況チェックでは、ハードウェアやアップグレード時の接続性などの外部環境に関する問題を検出することはできません。アップグレードの進捗を常に監視する必要があります。

<オブジェクト>の準備状況チェックの完了ステータス: FAILURE 準備状況チェックで、スキーマ、索引またはデータ型などの特定のオブジェクトに対して解決する必要がある1つ以上のエラーが検出されました。 失敗した問題がすべて解決されるまではアップグレードしないでください。
<オブジェクト>の準備状況チェックの完了ステータス: SUCCESS 準備状況チェック・テストによって問題が検出されませんでした。 必要なアクションはありません。
準備状況レポート・ファイルのサンプルを次に示します。レポートにはこれらのチェックのすべてが含まれない場合があります。
This readiness check report was created on Wed Dec 02 05:47:33 PST 2020 Log file is located at: 
/oracle/work/middleware_latest/oracle_common/upgrade/logs/ua2020-12-02-05-35-03AM.log
Readiness Check Report File: 
/oracle/work/middleware_latest/oracle_common/upgrade/logs/readiness2020-12-02-05-47-33AM.txt
Domain Directory: 
/oracle/work/middleware_1212/user_projects/domains/oim_domain

Starting readiness check of components.

Oracle Platform Security Services
    Starting readiness check of Oracle Platform Security Services.
      Schema User Name: DEV_OPSS
      Database Type: Oracle Database
      Database Connect String: example.oracle.com:1521:oimdb
      VERSION Schema DEV_OPSS is currently at version 11.1.1.9.0. 
Readiness checks will now be performed.
    Starting schema test:  TEST_DATABASE_VERSION  Test that the database server version number is supported for upgrade
      INFO   Database product version: Oracle Database 11g Enterprise Edition Release 11.2.0.4.0 - 64bit Production With the Partitioning, OLAP, Data Mining and Real Application Testing options
    Completed schema test: TEST_DATABASE_VERSION --> Test that the database server version number is supported for upgrade +++ PASS
    Starting schema test:  TEST_REQUIRED_TABLES  Test that the schema contains all the required tables
    Completed schema test: TEST_REQUIRED_TABLES --> Test that the schema contains all the required tables +++ PASS
    Starting schema test:  Test that the schema does not contain any unexpected tables  TEST_UNEXPECTED_TABLES
    Completed schema test: Test that the schema does not contain any unexpected tables --> TEST_UNEXPECTED_TABLES +++ Test that the schema does not contain any unexpected tables
    Starting schema test:  TEST_ENOUGH_TABLESPACE  Test that the schema tablespaces automatically extend if full
    Completed schema test: TEST_ENOUGH_TABLESPACE --> Test that the schema tablespaces automatically extend if full +++ PASS
    Starting schema test:  TEST_USER_TABLESPACE_QUOTA  Test that tablespace quota for this user is sufficient to perform the upgrade
    Completed schema test: TEST_USER_TABLESPACE_QUOTA --> Test that tablespace quota for this user is sufficient to perform the upgrade +++ PASS
    Starting schema test:  TEST_ONLINE_TABLESPACE  Test that schema tablespaces are online
    Completed schema test: TEST_ONLINE_TABLESPACE --> Test that schema tablespaces are online +++ PASS
    Starting permissions test:  TEST_DBA_TABLE_GRANTS  Test that DBA user has privilege to view all user tables
    Completed permissions test: TEST_DBA_TABLE_GRANTS --> Test that DBA user has privilege to view all user tables +++ PASS
    Starting schema test:  TEST_MISSING_COLUMNS  Test that tables and views are not missing any required columns
    Completed schema test: TEST_MISSING_COLUMNS --> Test that tables and views are not missing any required columns +++ PASS
    Starting schema test:  TEST_UNEXPECTED_COLUMNS  Test that tables and views do not contain any unexpected columns
    Completed schema test: TEST_UNEXPECTED_COLUMNS --> Test that tables and views do not contain any unexpected columns +++ PASS
    Starting datatype test for table CT_29: TEST_COLUMN_DATATYPES_V2 --> Test that all table columns have the proper datatypes
    Completed datatype test for table CT_29: TEST_COLUMN_DATATYPES_V2 
--> Test that all table columns have the proper datatypes +++ PASS
    Starting index test for table JPS_ENTITY_LOCK: TEST_REQUIRED_INDEXES 
--> Test that the table contains all the required indexes
    Completed index test for table JPS_ENTITY_LOCK: 
TEST_REQUIRED_INDEXES --> Test that the table contains all the required indexes +++ PASS
   Starting index test for table CT_9_3:  TEST_UNEXPECTED_INDEXES --> Test that the table does not contain any unexpected indexes
    Completed index test for table CT_9_3: TEST_UNEXPECTED_INDEXES --> Test that the table does not contain any unexpected indexes +++ PASS
    Starting schema test:  UPGRADE_SCRIPT_TEST  Test that the middleware contains the required Oracle Platform Security Services upgrade script
    Completed schema test: UPGRADE_SCRIPT_TEST --> Test that the middleware contains the required Oracle Platform Security Services upgrade script +++ PASS
    Starting schema test:  PRIVILEGES_TEST  Test that the Oracle Platform Security Services schema has appropriate system privileges
    Completed schema test: PRIVILEGES_TEST --> Test that the Oracle Platform Security Services schema has appropriate system privileges +++ PASS
    Starting schema test:  SEQUENCE_TEST  Test that the Oracle Platform Security Services schema sequence and its properties are valid
    Completed schema test: SEQUENCE_TEST --> Test that the Oracle Platform Security Services schema sequence and its properties are valid 
+++ PASS
    Finished readiness check of Oracle Platform Security Services with
status: SUCCESS.

Oracle Metadata Services
    Starting readiness check of Oracle Metadata Services.
      Schema User Name: DEV_MDS
      Database Type: Oracle Database
      Database Connect String: example.oracle.com:1521:oimdb
      VERSION Schema DEV_MDS is currently at version 11.1.1.9.0. 
Readiness checks will now be performed.
    Starting schema test:  TEST_REQUIRED_TABLES  Test that the schema contains all the required tables
    Completed schema test: TEST_REQUIRED_TABLES --> Test that the schema contains all the required tables +++ PASS
    Starting schema test:  TEST_REQUIRED_PROCEDURES  Test that the schema contains all the required stored procedures
    Completed schema test: TEST_REQUIRED_PROCEDURES --> Test that the schema contains all the required stored procedures +++ PASS
    Starting schema test:  TEST_REQUIRED_VIEWS  Test that the schema contains all the required database views
    Completed schema test: TEST_REQUIRED_VIEWS --> Test that the schema contains all the required database views +++ PASS
    Starting index test for table MDS_ATTRIBUTES: TEST_REQUIRED_INDEXES 
--> Test that the table contains all the required indexes
    Starting schema test:  TEST_USER_TABLESPACE_QUOTA  Test that tablespace quota for this user is sufficient to perform the upgrade
    Completed schema test: TEST_USER_TABLESPACE_QUOTA --> Test that tablespace quota for this user is sufficient to perform the upgrade +++ PASS
    Starting schema test:  TEST_ONLINE_TABLESPACE  Test that schema tablespaces are online
    Completed schema test: TEST_ONLINE_TABLESPACE --> Test that schema tablespaces are online +++ PASS
    Starting schema test:  TEST_DATABASE_VERSION  Test that the database server version number is supported for upgrade
      INFO   Database product version: Oracle Database 11g Enterprise Edition Release 11.2.0.4.0 - 64bit Production With the Partitioning, OLAP, Data Mining and Real Application Testing options
    Completed schema test: TEST_DATABASE_VERSION --> Test that the database server version number is supported for upgrade +++ PASS
    Finished readiness check of Oracle Metadata Services with status: 
SUCCESS.

User Messaging Service
    Starting readiness check of User Messaging Service.
      Schema User Name: DEV_ORASDPM
      Database Type: Oracle Database
      Database Connect String: example.oracle.com:1521:oimdb
      VERSION Schema DEV_ORASDPM is currently at version 11.1.1.9.0. Readiness checks will now be performed.
    Starting schema test:  TEST_DATABASE_VERSION  Test that the database server version number is supported for upgrade
      INFO   Database product version: Oracle Database 11g Enterprise Edition Release 11.2.0.4.0 - 64bit Production With the Partitioning, OLAP, Data Mining and Real Application Testing options
    Completed schema test: TEST_DATABASE_VERSION --> Test that the database server version number is supported for upgrade +++ PASS
    Starting column test for table RULE_SET: 
TEST_UNEXPECTED_TABLE_COLUMNS --> Test that the table does not contain any unexpected columns
    Completed column test for table RULE_SET: 
TEST_UNEXPECTED_TABLE_COLUMNS --> Test that the table does not contain any unexpected columns +++ PASS
    Starting column test for table STATUS: TEST_UNEXPECTED_TABLE_COLUMNS 
--> Test that the table does not contain any unexpected columns
    Completed column test for table STATUS: 
TEST_UNEXPECTED_TABLE_COLUMNS --> Test that the table does not contain any unexpected columns +++ PASS
    Starting column test for table STATUS_ORPHAN: 
TEST_UNEXPECTED_TABLE_COLUMNS --> Test that the table does not contain any unexpected columns
    Completed column test for table STATUS_ORPHAN: 
TEST_UNEXPECTED_TABLE_COLUMNS --> Test that the table does not contain any unexpected columns +++ PASS
    Starting column test for table USER_DEVICE: 
TEST_UNEXPECTED_TABLE_COLUMNS --> Test that the table does not contain any unexpected columns
    Completed column test for table USER_DEVICE: 
TEST_UNEXPECTED_TABLE_COLUMNS --> Test that the table does not contain any unexpected columns +++ PASS
    Finished readiness check of User Messaging Service with status: SUCCESS.

Oracle SOA
    Starting readiness check of Oracle SOA.
      Schema User Name: DEV_SOAINFRA
      Database Type: Oracle Database
      Database Connect String: example.oracle.com:1521:oimdb
      VERSION Schema DEV_SOAINFRA is currently at version 11.1.1.9.0. Readiness checks will now be performed.
    Starting schema test:  TEST_DATABASE_VERSION  Test that the database server version number is supported for upgrade
      INFO   Database product version: Oracle Database 11g Enterprise Edition Release 11.2.0.4.0 - 64bit Production With the Partitioning, OLAP, Data Mining and Real Application Testing options
    Completed schema test: TEST_DATABASE_VERSION --> Test that the database server version number is supported for upgrade +++ PASS
    Starting schema test:  TEST_REQUIRED_TABLES  Test that the schema contains all the required tables
    Completed schema test: TEST_REQUIRED_TABLES --> Test that the schema contains all the required tables +++ PASS
    Starting schema test:  TEST_REQUIRED_PROCEDURES  Test that the schema contains all the required stored procedures
    Completed schema test: TEST_REQUIRED_PROCEDURES --> Test that the schema contains all the required stored procedures +++ PASS
    Starting schema test:  TEST_REQUIRED_VIEWS  Test that the schema contains all the required database views
    Completed schema test: TEST_REQUIRED_VIEWS --> Test that the schema contains all the required database views +++ PASS
    Starting schema test:  TEST_ENOUGH_TABLESPACE  Test that the schema tablespaces automatically extend if full
    Completed schema test: TEST_ENOUGH_TABLESPACE --> Test that the schema tablespaces automatically extend if full +++ PASS
    Starting schema test:  TEST_ONLINE_TABLESPACE  Test that schema tablespaces are online
    Completed schema test: TEST_ONLINE_TABLESPACE --> Test that schema tablespaces are online +++ PASS
    Starting schema test:  TEST_USER_TABLESPACE_QUOTA  Test that tablespace quota for this user is sufficient to perform the upgrade
    Completed schema test: TEST_USER_TABLESPACE_QUOTA --> Test that tablespace quota for this user is sufficient to perform the upgrade +++ PASS
    Starting schema test:  SOA_TABLESPACE_VALIDATION  Test SOAINFRA schema for enough default table space and temp table space.
    Completed schema test: SOA_TABLESPACE_VALIDATION --> Test SOAINFRA schema for enough default table space and temp table space. +++ PASS
    Starting schema test:  SOA_INSTANCE_VALIDATION  Test SOAINFRA schema for inconsistencies of instance data.
    Completed schema test: SOA_INSTANCE_VALIDATION --> Test SOAINFRA schema for inconsistencies of instance data. +++ PASS
    Finished readiness check of Oracle SOA with status: SUCCESS.

Oracle Identity Manager
    Starting readiness check of Oracle Identity Manager.
      Schema User Name: DEV_OIM
      Database Type: Oracle Database
      Database Connect String: example.oracle.com:1521:oimdb
    Starting schema test:  examine  Calling examine method
      INFO Examine is successful
    Completed schema test: Examine --> Testing schema version +++ PASS
    Starting schema test:  TEST_MDS_BACKUP  Taking backup of MDS data related to OIM to handle any unseen situation during upgrade.
      INFO MDSBackup passes. Backup of MDS data related to OIM is here: 
/oracle/work/middleware_latest/oracle_common/upgrade/temp/mdsBackup/
    Completed schema test: TEST_MDS_BACKUP --> Taking backup of MDS data related to OIM to handle any unseen situration during upgrade. +++ PASS
    Finished readiness check of Oracle Identity Manager with status: 
SUCCESS.

User Messaging Service
    Starting readiness check of User Messaging Service.
    Starting config test:  TEST_USERMESSAGINGCONFIG  Test that configuration file usermessagingconfig.xml is accessible, in place and valid.
    Completed config test: TEST_USERMESSAGINGCONFIG --> Configuration file usermessagingconfig.xml is accessible, in place and valid. +++ PASS
    Starting config test:  TEST_ALREADY_UPGRADED  Test that configuration is not already upgraded.
    Completed config test: TEST_ALREADY_UPGRADED --> Configuration is not already upgraded. +++ PASS
    Finished readiness check of User Messaging Service with status: SUCCESS.

Oracle Identity Manager
    Starting readiness check of Oracle Identity Manager.
      INFO There are no configuration readiness tests for Oracle Identity Manager.
    Finished readiness check of Oracle Identity Manager with status: 
SUCCESS.

Oracle JRF
    Starting readiness check of Oracle JRF.
    Finished readiness check of Oracle JRF with status: SUCCESS.

System Components Infrastructure
    Starting readiness check of System Components Infrastructure.
    Starting config test:  TEST_SOURCE_CONFIG  Checking the source configuration.
      INFO
/oracle/work/middleware_1212/user_projects/oim_domain/opmn/topology.xml
was not found. No upgrade is needed.
    Completed config test: TEST_SOURCE_CONFIG --> Checking the source configuration. +++ PASS
    Finished readiness check of System Components Infrastructure with
status: ALREADY_UPGRADED.

Common Infrastructure Services
    Starting readiness check of Common Infrastructure Services.
    Starting config test:  CIEConfigPlugin.readiness.test  This tests the readiness of the domain from CIE side.
    Completed config test: CIEConfigPlugin.readiness.test --> This tests the readiness of the domain from CIE side. +++ PASS
    Finished readiness check of Common Infrastructure Services with
status: SUCCESS.

Oracle Web Services Manager
    Starting readiness check of Oracle Web Services Manager.
    Completed config test: BOOTSTRAP_PROPERTIES_CHECK --> Bootstrap properties check +++ PASS
    Completed config test: CONFIGURATION_PROPERTIES_CHECK --> Configuration properties check +++ PASS
    Completed config test: TOKEN_TRUST_PROPERTIES_CHECK --> Trust issuer properties check +++ PASS
    Completed config test: MDS_REPOSITORY_CONNECTIVITY_CHECK --> MDS repository connectivity check +++ PASS
    Finished readiness check of Oracle Web Services Manager with status: 
SUCCESS.

Finished readiness check of components.

ノート:

準備状況レポートの欠落している索引に関するエラーは無視してもかまいません。これは既知の問題です。欠落している索引に対応するものが、スキーマのアップグレード操作時に追加されます。このエラーは、アップグレードするスキーマがRCUを使用して12cで作成されていた場合は発生しません。

製品スキーマのアップグレード

サーバーとプロセスの停止後に、Upgrade Assistantを使用して、サポートされている製品スキーマをOracle Fusion Middlewareの現在のリリースにアップグレードします。

Upgrade Assistantを使用すると、個別に選択したスキーマまたはドメインに関連付けられているすべてのスキーマをアップグレードできます。選択したオプションによって、表示されるUpgrade Assistantの画面は異なります。

ノート:

12.2 RAC環境でデータポンプ・ワーカー(DW)プロセスの'ライブラリ・キャッシュ・ロック' (サイクル)<='ライブラリ・キャッシュ・ロック'が原因で、長い待機時間およびパフォーマンスの低下が見られる場合があります。この問題を解決するには、次のコマンドを使用してS最適化を無効にする必要があります:
ALTER SYSTEM SET "_lm_share_lock_opt"=FALSE SCOPE=SPFILE SID='*';
前述のコマンドの実行後、すべてのRACインスタンスを再起動します。アップグレードの完了後、次のコマンドを使用してパラメータをリセットできます:
alter system reset "_lm_share_lock_opt" scope=spfile sid='*';

アップグレードに対応可能な既存のスキーマの特定

アップグレード前にこのオプションのステップを使用して、スキーマ・バージョン・レジストリ表を問い合せることができます。この表には、スキーマ所有者、バージョン番号、コンポーネント名とID、作成日と変更日、カスタム接頭辞などのスキーマ情報が含まれています。

Upgrade Assistantでドメイン内のすべてのスキーマをアップグレードすることも、アップグレードするスキーマを個別に選択することもできます。この判断には、次に示すステップを実行して、アップグレードに対応可能なすべてのスキーマのリストを表示することが役立ちます。

  1. Oracleデータベースを使用している場合、Oracle DBA権限を持つアカウントを使用してデータベースに接続し、SQL*Plusから次を実行します。

    SET LINE 120
    COLUMN MRC_NAME FORMAT A14
    COLUMN COMP_ID FORMAT A20
    COLUMN VERSION FORMAT A12
    COLUMN STATUS FORMAT A9
    COLUMN UPGRADED FORMAT A8
    SELECT MRC_NAME, COMP_ID, OWNER, VERSION, STATUS, UPGRADED FROM SCHEMA_VERSION_REGISTRY WHERE OWNER LIKE UPPER('<PREFIX>_%');
    

  2. 生成されたレポートを調査します。

ノート:

  • アップグレード後、レポートを再度生成して、更新されたバージョンのスキーマを表示できます。アップグレードの必要がないスキーマがある場合は、そのスキーマのアップグレード前のバージョンがschema_version_registry表に維持されます。

  • 既存のスキーマが、サポートされているバージョンからのものでない場合、14c (14.1.2.1.0)のアップグレード手順を使用する前に、それらをサポートされているバージョンにアップグレードする必要があります。詳細は、アップグレード前のバージョンのドキュメントを参照してください。

  • 以前のバージョンでOIDベースのポリシー・ストアを使用していた場合、アップグレードを実行する前に新しいOPSSスキーマを必ず作成します。アップグレード後も、OPSSスキーマはLDAPベース・ストアのままです。

  • Oracle Fusion Middlewareリリース14c (14.1.2.1.0)でアップグレード可能な製品のスキーマのみをアップグレードできます。まだ14c (14.1.2.1.0)へのアップグレードが可能になっていないコンポーネントを含むドメインをアップグレードしないでください。

Upgrade Assistantの起動

Upgrade Assistantを実行して、製品のスキーマ、ドメイン・コンポーネント構成、またはスタンドアロンのシステム・コンポーネントを14c (14.1.2.1.0)にアップグレードします。

Upgrade Assistantを起動するには、次の手順に従います。

ノート:

Upgrade Assistantを起動する前に、JVMの文字エンコーディングが、Upgrade Assistantが実行されるプラットフォームでUTF-8に設定されていることを確認してください。文字エンコーディングがUTF-8に設定されていないと、名前にUnicode文字を含むファイルをダウンロードできません。これにより、アップグレードに失敗する可能性があります。文字エンコーディングを設定するには、次を実行します。

UNIXオペレーティング・システムの場合:

export UA_PROPERTIES="-Dfile.encoding=UTF-8 ${UA_PROPERTIES}"

Windowsオペレーティング・システムの場合:

set UA_PROPERTIES=-Dfile.encoding=UTF-8 %UA_PROPERTIES%
  1. oracle_common/upgrade/binディレクトリに移動します。
    • (UNIX) ORACLE_HOME/oracle_common/upgrade/bin
    • (Windows) ORACLE_HOME\oracle_common\upgrade\bin
  2. Upgrade Assistantを起動します。
    • (UNIX) ./ua
    • (Windows) ua.bat

コマンドラインに指定可能なその他のパラメータ(ロギングのパラメータなど)の詳細は、次を参照してください。

Upgrade Assistantのパラメータ

コマンドラインからUpgrade Assistantを起動するときに、追加のパラメータを指定できます。

表3-4 アップグレード・アシスタントのコマンドライン・パラメータ

パラメータ 必須またはオプション 説明

-readiness

準備状況チェックの場合は必須

ノート: 準備状況チェックはスタンドアロン・インストール上で実行できません(WebLogic Serverの管理対象でありません)。

アップグレードの準備状況チェックを実行します(実際のアップグレードは実行しません)。

スキーマと構成がチェックされます。

-examineパラメータを指定した場合は、このパラメータを指定しないでください。

-threads

オプション

スキーマの同時アップグレードまたはスキーマの準備状況チェックに使用可能なスレッドの数を特定します。

値は、1 - 8の正の整数である必要があります。デフォルトは4です。

-response

サイレント・アップグレードまたはサイレント準備状況チェックの場合は必須

Upgrade AssistantがGUIモードで実行されているときに入力したデータから生成されるレスポンス・ファイルに保存されている入力を使用して、Upgrade Assistantを実行します。このパラメータを使用すると、Upgrade Assistantはサイレント・モード(Upgrade Assistantの画面表示なし)で実行されます。

-examine

オプション

調査フェーズを実行しますが、実際のアップグレードは実行しません。

-readinessパラメータを指定した場合、このパラメータを指定しないでください。

-logLevel attribute

オプション

次のいずれかの属性を指定して、ログイン・レベルを設定します。

  • TRACE

  • NOTIFICATION

  • WARNING

  • ERROR

  • INCIDENT_ERROR

デフォルトのロギング・レベルはNOTIFICATIONです。

-logLevel TRACE属性を設定して、より多くのログが記録されるようにすることを検討してください。これは、アップグレードの失敗をトラブルシューティングする際に役立ちます。-logLevel TRACEが使用されると、Upgrade Assistantのログ・ファイルは非常に大きくなる可能性があります。

-logDir location

オプション

アップグレード・ログ・ファイルと一時ファイルのデフォルトの場所を設定します。Upgrade Assistantによってログ・ファイルおよび一時ファイルが作成される、既存の書込み可能なディレクトリを指定する必要があります。

デフォルトの場所は次のとおりです。

(UNIX)

ORACLE_HOME/oracle_common/upgrade/logs
ORACLE_HOME/oracle_common/upgrade/temp

(Windows)

ORACLE_HOME/oracle_common/upgrade/logs
ORACLE_HOME/oracle_common/upgrade/temp

-help

オプション

すべてのコマンドライン・オプションを表示します。

Upgrade Assistantを使用したOracle Identity Managerスキーマのアップグレード

Upgrade Assistantの各画面を通じて、製品スキーマをアップグレードします。

Upgrade Assistantを使用して、製品スキーマをアップグレードするには:
  1. 「ようこそ」画面には、Upgrade Assistantの概要と、アップグレード前のいくつかの重要なタスクについての情報が表示されます。「次」をクリックします。

    ノート:

    Upgrade Assistantの画面の詳細は、画面上の「ヘルプ」をクリックしてください。
  2. 「アップグレード・タイプ」画面で、実行するスキーマ・アップグレード操作を選択します:
    • 「個別に選択されたスキーマ」: ドメインで使用されるスキーマをすべてアップグレードするのではなく、アップグレードするスキーマを個別に選択する場合のオプションです。

      注意:

      14c (14.1.2.1.0)コンポーネントをサポートするために使用されるスキーマのみをアップグレードしてください。Oracle Fusion Middleware 14c (14.1.2.1.0)に含まれていないコンポーネントをサポートするために現在使用されているスキーマをアップグレードしないでください。
    • 「ドメインで使用されるすべてのスキーマ」を使用すると、Upgrade Assistantは、ドメイン内でアップグレードに対応可能な「ドメイン・ディレクトリ」フィールドで指定されたスキーマを持つコンポーネントをすべて検出して選択します。これは、ドメイン支援のスキーマ・アップグレードとも呼ばれています。さらに、Upgrade Assistantはスキーマの入力画面に接続情報を事前に移入します。

      ノート:

      ほとんどのアップグレードでは、「ドメインで使用されるすべてのスキーマ」を選択して、必要なすべてのスキーマがアップグレードに含まれるようにすることをお薦めします。

    ノート:

    SSL有効Oracle Identity Manager設定をアップグレードする場合は、「個別に選択されたスキーマ」オプションを選択し、Oracle Identity Managerスキーマのみを選択します。これにより、依存スキーマが自動的に選択されます。SSL有効設定をアップグレードする場合は、「スキーマ資格証明」画面で非SSLデータベース接続の詳細を入力する必要があります。

  3. 「個別に選択されたスキーマ」を選択した場合: 「使用可能なコンポーネント」画面で、スキーマをアップグレードするコンポーネントを選択します。コンポーネントを選択すると、スキーマとすべての依存関係が自動的に選択されます。

    ノート:

    • 個別のスキーマ・オプションの場合、ドメイン構成はアクセスされないため、パスワード値は前の画面からのものがそのまま使用されます。接続に失敗する場合は、原因を調べ、修正してください。

    • Upgrade Assistantユーティリティで正しいUMSスキーマを使用するには、_UMSを接尾辞として追加して、UMSスキーマを手動で編集します。たとえば、SOAアップグレードを成功させるには、DEVDEV_UMSに編集します。
  4. 「画面」名で、ドメイン・フォルダを選択します。

    「次」をクリックします。

  5. 「コンポーネント・リスト」画面に、スキーマがアップグレードされるコンポーネントのリストが表示されます。

    「次」をクリックします。

  6. 「前提条件」画面で、すべてのチェック・ボックスを選択して、前提条件を満たしていることを確認します。「次」をクリックします。

    ノート:

    Upgrade Assistantでは前提条件が満たされているかどうかを確認できません。
  7. スキーマ資格証明の画面で、アップグレードするスキーマごとにデータベース接続の詳細を指定します(この画面名は、選択したスキーマに応じて変化します)。
    • 「データベース・タイプ」ドロップダウン・メニューからデータベース・タイプを選択します。

    • データベース接続の詳細を入力して、「接続」をクリックします。

    • 「スキーマ・ユーザー名」ドロップダウン・メニューからアップグレードするスキーマを選択し、スキーマのパスワードを入力します。アップグレードするスキーマに対して正しいスキーマ接頭辞を使用してください。

    「次」をクリックします。

  8. 「調査」画面で、各スキーマを調査したUpgrade Assistantのステータスを確認して、スキーマのアップグレードの準備が整っていることを検証します。ステータスが「調査が終了しました。」になっている場合は、「次」をクリックします。
    調査フェーズが失敗した場合は、「調査失敗」ダイアログで「いいえ」をクリックして、アップグレードを取り消すことをお薦めします。「ログの表示」をクリックしてエラーの原因を確認し、一般的なアップグレード・エラーの解決の詳細をUpgrade Assistantによるアップグレードアップグレードのトラブルシューティングで参照してください。

    ノート:

    • 確認フェーズ中に検出された問題を、アップグレードを進めずに解決した場合は、バックアップからリストアを再び行わずにUpgrade Assistantを開始できます。ただし、「調査失敗」ダイアログ・ボックスで「はい」をクリックしてアップグレードを続行していた場合は、Upgrade Assistantを再開する前に、バックアップからアップグレード前の環境をリストアする必要があります。

    • 調査プロセスを取り消してもスキーマまたは構成データに影響はありませんが、将来のアップグレード・セッションでは、Upgrade Assistantが収集した情報を再収集する必要があります。

  9. 「アップグレード・サマリー」画面で、スキーマのアップグレードに選択したオプションのサマリーを確認します。
    アップグレード対象のスキーマごとに、正しいソース・バージョンとターゲット・バージョンがリストされていることを確認します。
    これらのオプションを保存して、今後、レスポンス(サイレンス)モードでUpgrade Assistantを再実行する場合は、「レスポンス・ファイルの保存」をクリックして、レスポンス・ファイルの場所と名前を指定します。サイレント・アップグレードは、Upgrade Assistantとまったく同じ機能を実行しますが、データを手動で再入力する必要はありません。
    「アップグレード」をクリックして、アップグレード・プロセスを開始します。
  10. 「アップグレードの進行状況」画面で、アップグレードのステータスを監視します。

    注意:

    Upgrade Assistantにはアップグレードを実行するための十分な時間を与えてください。やむを得ない場合を除き、アップグレード操作は取り消さないでください。これを行うと、環境が不安定になる可能性があります。
    正しくアップグレードされていないスキーマがある場合は、Upgrade Assistantのログ・ファイルで情報を確認します。

    ノート:

    この画面のプログレス・バーには、現在のアップグレード手順の進行状況が表示されます。アップグレードの残り時間を示すものではありません。

    「次」をクリックします。

  11. アップグレードが正常に完了すると、Upgrade Assistantによりアップグレード・ステータスが示され、アップグレード・プロセスの後続のステップがリストされます。Upgrade Assistantの「アップグレード成功」画面に示された情報を基にして、次に実行するステップを判断してください。ウィザードには次の情報が表示されます:
    Upgrade Succeeded.
    
    Log File: /u01/oracle/products/12c/identity/oracle_common/upgrade/logs/ua2020-09-15-18-27-29PM.txt
    Post Upgrade Text file: /u01/oracle/products/12c/identity/oracle_common/upgrade/logs/postupgrade2020-09-15-18-27-29PM.txt
    Next Steps
    
    Oracle SOA
    1. The Upgrade Assistant has successfully upgraded all active instances. You can now close the Upgrade Assistant.
    2. The automated upgrade of closed instances will continue in the background after the Upgrade Assistant is exited and until the SOA server is started,at which point the upgrade will stop. You can schedule the upgrade of any remaining closed instances for a time when the SOA server is less busy.
       Close the Upgrade Assistant and use the instance data administration scripts to administer and monitor the overall progress of this automated upgrade. For more information see "Administering and Monitoring the Upgrade of SOA Instance Data" in Upgrading SOA Suite and Business Process Management.

    「閉じる」をクリックすると、アップグレードが完了しウィザードが終了します。

    アップグレードが失敗した場合: 「アップグレード失敗」画面で「ログの表示」をクリックして、エラーを確認し、トラブルシューティングします。ログは、ORACLE_HOME/oracle_common/upgrade/logsにあります。

    ノート:

    アップグレードが失敗した場合は、バックアップからアップグレード前の環境をリストアし、問題を修正してから、Upgrade Assistantを再起動する必要があります。

スキーマのアップグレードの確認

すべてのアップグレード・ステップを完了したら、schema_version_registryのスキーマ・バージョンが適切に更新されていることをチェックして、アップグレードの成功を検証します。

Oracle Databaseを使用する場合、Oracle DBAを持つユーザーとしてデータベースに接続し、SQL*Plusから次を実行して現行のバージョン番号を取得します。必ず<PREFIX>をスキーマ接頭辞に置き換えてください。

SET LINE 120
COLUMN MRC_NAME FORMAT A14
COLUMN COMP_ID FORMAT A20
COLUMN VERSION FORMAT A12
COLUMN STATUS FORMAT A9
COLUMN UPGRADED FORMAT A8
SELECT MRC_NAME, COMP_ID, OWNER, EDITION NAME, VERSION, STATUS, UPGRADED FROM SCHEMA_VERSION_REGISTRY where owner like '<PREFIX>_%';

問合せ結果について:

  • EDITION NAME列がORA$BASEとして表示されることを確認します。
  • VERSION列の数値が、そのスキーマの最新のバージョン番号に一致していることを確認します。たとえば、スキーマ・バージョン番号が14.1.2.1.0であることを確認します。

    ノート:

    すべてのスキーマ・バージョンが更新されるわけではありません。一部のスキーマではこのリリースへのアップグレードが必要なく、アップグレード前のバージョン番号が保持されます。

  • STATUSフィールドは、スキーマのパッチ適用操作中はUPGRADINGまたはUPGRADEDのどちらかになり、パッチ適用操作が完了するとVALIDになります。

  • ステータスが「INVALID」と表示された場合は、ステータスの更新が失敗しています。ログ・ファイルを調べて、失敗した理由を判定する必要があります。

  • IAU_APPENDIAU_VIEWERが所有するシノニム・オブジェクトは、INVALIDと表示されますが、失敗を意味するものではありません。

    これらは、シノニムの作成後にターゲット・オブジェクトが変更されるため無効になります。シノニム・オブジェクトは、アクセスされるときに有効になります。これに該当するINVALIDオブジェクトは、無視しても問題ありません。

ドメインの再構成

再構成ウィザードを実行して、ドメイン・コンポーネント構成を14c (14.1.2.1.0)にあわせて再構成します。

WebLogic Serverドメインを再構成すると、ドメイン内のアプリケーションに応じて、次の項目が自動的に更新されます。

  • WebLogic Serverコア・インフラストラクチャ

  • ドメイン・バージョン

ノート:

ドメインの再構成を開始する前に、次の制限事項に注意してください。

  • 元のMiddlewareホームに、エラーを引き起こす可能性のあるデプロイメントが含まれていないことを確認します。
  • 再構成ウィザードでは、ドメインに含まれる独自のアプリケーションは更新されません。

  • アップグレード・プロセス中に、非動的クラスタ・ドメインを動的クラスタ・ドメインに変換することはサポートされていません。

    動的クラスタ機能は、再構成ウィザードの実行中に使用できますが、サポートされているアップグレードは非動的クラスタのアップグレードのみで、その後で動的クラスタを追加することになります。アップグレード・プロセス中に動的クラスタを追加することはできません。

具体的には、ドメインを再構成する場合、次のことが発生します。
  • ドメインのconfig.xmlファイルのドメイン・バージョン番号は、管理サーバーのインストール済WebLogic Serverバージョンに更新されます。

  • すべてのインストール済Oracle製品の再構成テンプレートは、自動的に選択されてドメインに適用されます。これらのテンプレートは、WebLogicドメインが現在のWebLogic Serverバージョンと互換性を持つために必要な再構成タスクを定義します。

  • 起動スクリプトが更新されます。

    変更済の起動スクリプトを維持する場合は、そのスクリプトをバックアップしてから、再構成ウィザードを開始してください。

ノート:

ドメイン再構成プロセスが開始されると、そこで行われた変更は元に戻せません。再構成ウィザードの実行前には、アップグレード前チェックリストで説明しているように、ドメインのバックアップが作成されていることを確認してください。再構成ウィザードの実行中にエラーまたは他の割込みが発生した場合、バックアップ場所から元のドメイン・ディレクトリにファイルとディレクトリをコピーすることによって、ドメインをリストアする必要があります。これは、再構成前の元の状態にドメインを復元するための唯一の方法です。

ドメインのバックアップ

再構成ウィザードの実行前に、ドメイン・ディレクトリのバックアップ・コピーを作成します。

  1. ドメイン・ディレクトリのバックアップを作成します。
  2. 各リモート管理対象サーバーのドメインを更新する前に、各リモート・マシンのドメイン・ディレクトリのバックアップ・コピーを作成します。
  3. ドメインのバックアップしたバージョンが完全であることを確認します。
なんらかの理由でドメインの再構成が失敗した場合は、すべてのファイルおよびディレクトリをバックアップ・ディレクトリから元のドメイン・ディレクトリにコピーしてドメインを完全に再構成前の元の状態に戻す必要があります。

再構成ウィザードの起動

ノート:

  • 再構成プロセスを開始する前に管理サーバーおよびすべての管理対象サーバーを停止します。「サーバーとプロセスの停止」を参照
  • ソースがクラスタ環境である場合は、再構成ウィザードをプライマリ・ノードでのみ実行します(ここで、プライマリ・ノードは管理サーバーです)。Pack/Unpackユーティリティを使用して、ドメイン内の他のクラスタ・メンバーに変更を適用します。

再構成ウィザードをグラフィカル・モードで起動するには:

  1. コマンド・シェル(UNIXオペレーティング・システムの場合)またはコマンド・プロンプト・ウィンドウ(Windowsオペレーティング・システムの場合)を開きます。
  2. 次の環境変数を設定します。
    • WLS_ALTERNATIVE_TYPES_DIR - 次のコマンドを使用します:

      (Bash以外): setenv WLS_ALTERNATIVE_TYPES_DIR ORACLE_HOME/idm/server/loginmodule/wls

      (Bash):export WLS_ALTERNATIVE_TYPES_DIR=ORACLE_HOME/idm/server/loginmodule/wls

      ORACLE_HOMEは、12c Oracleホームです。

    • CONFIG_JVM_ARGS - ./reconfig.shコマンドによって、デフォルトのキャッシュ・ディレクトリが有効でないことを示す次のエラーが表示される場合があります:
      *sys-package-mgr*: can't create package cache dir
      

      エラーを回避するには、CONFIG_JVM_ARGSを設定してキャッシュ・ディレクトリを変更します。

      たとえば: CONFIG_JVM_ARGS=-Dpython.cachedir=any_writable_directory

  3. oracle_common/common/binディレクトリに移動します。
    • (UNIX) ORACLE_HOME/oracle_common/common/bin
    • (Windows) ORACLE_HOME\oracle_common\commom\bin

    ORACLE_HOMEは、12c Oracleホームです。

  4. 次に示すロギングオプションを指定して、再構成ウィザードを開始します。
    • (UNIX) ./reconfig.sh -log=log_file -log_priority=ALL
    • (Windows) reconfig.cmd -log=log_file -log_priority=ALL

    ここで、log_fileは、ドメイン再構成セッション用に作成するログ・ファイルの絶対パスです。これは、再構成処理をトラブルシューティングする必要がある場合に役立つことがあります。

    パラメータ-log_priority=ALLは、ログを詳細モードで出力します。

Oracle Identity Managerドメインの再構成

再構成ウィザードの各画面を通じて、既存のドメインを再構成します。

再構成ウィザードを使用してドメインを再構成するには:
  1. 「ドメインの選択」画面で、アップグレードするドメインの場所を指定するか、「参照」をクリックしてナビゲートし、ドメインのディレクトリを選択します。「次」をクリックします。
  2. 「再構成セットアップの進行状況」画面で、セットアップ・プロセスの進行状況を確認します。完了したら、「次へ」をクリックします。
    このプロセスでは次の処理が行われます。
    • Fusion Middleware製品を含む、インストール済製品の再構成テンプレートが自動的に適用されます。これにより、config.xmlconfig-groups.xmlsecurity.xmlなどの様々なドメイン構成ファイルが更新されます。

    • Fusion Middleware製品をサポートするスキーマ、スクリプトおよび他のファイルが更新されます。

    • ドメイン・アップグレードが検証されます。

  3. 「ドメイン・モードおよびJDK」画面で、ドメインで使用するJDKを選択するか、「参照」をクリックして、使用するJDKにナビゲートします。14c (14.1.2.1.0)でサポートされているJDKバージョンは、17.0.12以降です。「次へ」をクリックします。

    ノート:

    このステージでは、「ドメイン・モード」を変更することはできません。
    特定のプラットフォームでサポートされているJDKのリストは、Oracle Fusion Middlewareでサポートされているシステム構成の説明を参照してください。
  4. 「データベース構成タイプ」画面で、「RCUデータ」を選択して、サーバー表(_STB)スキーマに接続します。
    RCUサービス表(_STB)スキーマ資格証明を使用してデータベース接続の詳細を入力して、「RCU構成の取得」をクリックします。
    再構成ウィザードは、この接続を使用して、ドメインのコンポーネントに必要なデータソースを自動的に構成します。

    ノート:

    デフォルトでは、Oracleのサービス接続用ドライバ(Thin)、バージョン: 任意のドライバが選択されています。接続の詳細で、サービス名ではなくインスタンス名を指定した場合は、Oracleのプール済インスタンス接続用ドライバ(Thin)、バージョン: 任意を選択する必要があります。ドライバ・タイプを変更しないと、接続に失敗します。

    ノート:

    既存の12c (12.2.1.4.0)データ・ソースの場合、再構成では既存の値が保存されます。RCUで14c (14.1.2.1.0)用にスキーマが作成された新しいデータ・ソースの場合、デフォルトの接続データは_STBスキーマから取得されます。特定のスキーマの接続データが_STBスキーマにない場合は、デフォルトの接続データが使用されます。
    チェックが成功した場合は、「次へ」をクリックします。チェックが失敗した場合は、接続の正しい詳細を再入力し、再試行します。

    ノート:

    12c (12.2.1.4.0)からアップグレードし、データベースに_OPSSまたは_IAU 12c (12.2.1.4.0)データベース・スキーマが含まれる場合、それらのスキーマのデータベース接続の詳細を手動で入力する必要があります。これらのスキーマは12cで不要であり、手動で作成する必要がありました。これらのスキーマに任意の名前が割り当てられている可能性があるため、再構成ウィザードではそれらを認識しません。_IAUに対する接続情報を指定する場合は、IAU_APPENDユーザー情報を使用します。
  5. 「JDBCコンポーネント・スキーマ」画面で、各コンポーネント・スキーマのDBMS/サービスおよびホスト名が正しいことを確認し、「次へ」をクリックします。

    ノート:

    • OPSS以外のすべてのスキーマについて、ホスト、ポートおよびサービスの詳細が自動移入されます。OPSSスキーマ資格証明は手動で入力する必要があります。
    • RACデータベースを使用している場合は、「JDBCコンポーネント・スキーマ」画面で、すべてのデータソースを選択し、グリッド・リンクに変換を選択します。
  6. グリッド・リンク画面で、サービス名、スキーマ・パスワード、ONSホストおよびポート、SCANホスト名およびポートを指定し、「FAN」および「SCAN」チェック・ボックスを適切に選択します。また、各スキーマ所有者の接頭辞が環境を反映していることを確認します。RACコンポーネント・スキーマごとにこのステップを実行します。

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

    ノート:

    グリッド・リンク画面は、ステップ6でグリッド・リンクに変換を選択した場合にのみ表示されます。
  7. 「JDBCコンポーネント・スキーマ・テスト」画面では、コンポーネント・スキーマの接続がテストされます。テストの結果は、「ステータス」列に表示されます。

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

  8. 「ノード・マネージャ」画面で、要件に応じてノード・マネージャの構成でデフォルトのオプションを使用するか、または「新規構成の作成」を選択します。いずれの場合でも、ノード・マネージャの詳細に対してWebLogic管理ユーザー資格証明を指定します。
  9. 「資格証明」画面の「weblogicAdminnKey」に、11gで使用されているWeblogic管理ユーザー名およびパスワードを移入し、「次」をクリックします。
  10. デフォルトの選択を変更せずに「次」をクリックします。
  11. 「拡張構成」画面で、拡張構成を実行するすべてのカテゴリを選択できます。選択したカテゴリごとに、詳細構成を行うことができる適切な構成画面が表示されます。

    ノート:

    「拡張構成」画面にリストされるカテゴリは、ドメインに選択したテンプレートに定義されているリソースによって異なります。
    このアップグレードではオプションを選択せずに、「次へ」をクリックします。
  12. 「構成のサマリー」画面で、ドメインの詳細な構成設定を確認してから続行します。
    「表示」ドロップダウン・リストからフィルタ・オプションを選択すると、右側のパネルに表示される項目を制限できます。
    構成を変更するには、「戻る」をクリックして適切な画面に戻ります。ドメインを再構成するには、「再構成」をクリックします。

    ノート:

    ドメインを再構成しても、その場所は変更されません。
  13. 「再構成の進行状況」画面には、再構成プロセスの進行状況が表示されます。
    このプロセスでは次の処理が行われます。
    • ドメイン情報が抽出、保存および更新されます。

    • Fusion Middleware製品をサポートするスキーマ、スクリプトおよび他のファイルが更新されます。

    進捗バーが100%になったら、「次へ」をクリックします。
  14. 「構成の終了」画面に、再構成プロセスが成功して完了したか、または失敗したかどうかが表示されます。管理サーバーURL(リスニング・ポートを含む)とともに再構成されたドメインの場所も表示します。再構成が成功した場合は、「Oracle Weblogic Serverの再構成に成功しました」と表示されます。
    再構成プロセスが正常に完了しなかった場合は、その理由を示すエラー・メッセージが表示されます。問題を解決するための適切な措置を講じます。問題を解決できない場合は、My Oracle Supportに連絡してください。
    以後の操作のためにドメインの場所と管理サーバーURLをノートにとります。

ドメイン・コンポーネント構成のアップグレード

Upgrade Assistantを使用して、ドメイン内のドメイン・コンポーネント構成を、更新されたドメイン構成に一致するようにアップグレードします。

Upgrade Assistantの起動

Upgrade Assistantを実行して、製品のスキーマ、ドメイン・コンポーネント構成、またはスタンドアロンのシステム・コンポーネントを14c (14.1.2.1.0)にアップグレードします。

Upgrade Assistantを起動するには、次の手順に従います。

ノート:

Upgrade Assistantを起動する前に、JVMの文字エンコーディングが、Upgrade Assistantが実行されるプラットフォームでUTF-8に設定されていることを確認してください。文字エンコーディングがUTF-8に設定されていないと、名前にUnicode文字を含むファイルをダウンロードできません。これにより、アップグレードに失敗する可能性があります。文字エンコーディングを設定するには、次を実行します。

UNIXオペレーティング・システムの場合:

export UA_PROPERTIES="-Dfile.encoding=UTF-8 ${UA_PROPERTIES}"

Windowsオペレーティング・システムの場合:

set UA_PROPERTIES=-Dfile.encoding=UTF-8 %UA_PROPERTIES%
  1. oracle_common/upgrade/binディレクトリに移動します。
    • (UNIX) ORACLE_HOME/oracle_common/upgrade/bin
    • (Windows) ORACLE_HOME\oracle_common\upgrade\bin
  2. Upgrade Assistantを起動します。
    • (UNIX) ./ua
    • (Windows) ua.bat

コマンドラインに指定可能なその他のパラメータ(ロギングのパラメータなど)の詳細は、次を参照してください。

Oracle Identity Managerドメイン・コンポーネント構成のアップグレード

Upgrade Assistantの各画面を通じて、WebLogicドメインのコンポーネント構成をアップグレードします。

Upgrade Assistantを実行して、ドメイン・コンポーネント構成を、更新されたドメイン構成に一致するようにアップグレードします。

Upgrade Assistantを使用して、ドメイン・コンポーネント構成をアップグレードするには:
  1. 「ようこそ」画面には、Upgrade Assistantの概要と、アップグレード前のいくつかの重要なタスクについての情報が表示されます。「次」をクリックします。

    ノート:

    Upgrade Assistantの画面の詳細は、画面上の「ヘルプ」をクリックしてください。
  2. 次の画面で、次を実行します。
    • 「ドメインによって使用されるすべての構成」を選択します。画面名が「WebLogicコンポーネント」に変更されます。

    • 「ドメイン・ディレクトリ」フィールドで、OIMドメイン・ディレクトリを指定します。

      「ドメイン・ディレクトリ」は、管理サーバー・ドメイン・ディレクトリです。

    「次」をクリックします。

  3. 「コンポーネント・リスト」画面で、構成をアップグレードするコンポーネントがリストにすべて含まれていることを確認し、「次」をクリックします。
    アップグレードするコンポーネントが表示されない場合は、「戻る」をクリックして前の画面に移動し、異なるドメインを指定します。
  4. 「前提条件」画面で、すべてのチェック・ボックスを選択して、前提条件を満たしていることを確認します。「次」をクリックします。

    ノート:

    Upgrade Assistantでは前提条件が満たされているかどうかを確認できません。
  5. 「調査」画面で、各コンポーネントを調査したUpgrade Assistantのステータスを確認して、コンポーネント構成のアップグレードの準備が整っていることを検証します。ステータスが「調査が終了しました。」になっている場合は、「次」をクリックします。
    調査フェーズが失敗した場合は、「調査失敗」ダイアログで「いいえ」をクリックして、アップグレードを取り消すことをお薦めします。「ログの表示」をクリックしてエラーの原因を確認し、一般的なアップグレード・エラーの解決の詳細をUpgrade Assistantによるアップグレードアップグレードのトラブルシューティングで参照してください。

    ノート:

    • 確認フェーズ中に検出された問題を、アップグレードを進めずに解決した場合は、バックアップからリストアを再び行わずにUpgrade Assistantを開始できます。ただし、「調査失敗」ダイアログ・ボックスで「はい」をクリックしてアップグレードを続行していた場合は、Upgrade Assistantを再開する前に、バックアップからアップグレード前の環境をリストアする必要があります。

    • 調査プロセスを取り消しても構成データに影響はありませんが、将来のアップグレード・セッションでは、Upgrade Assistantが収集した情報の再収集が必要になります。

  6. 「アップグレード・サマリー」画面で、コンポーネント構成のアップグレードに選択したオプションのサマリーを確認します。
    レスポンス・ファイルには、入力したすべての情報が収集および格納されます。このファイルにより、その後のサイレント・アップグレードの実行が可能になります。サイレント・アップグレードは、Upgrade Assistantとまったく同じ機能を実行しますが、データを手動で再入力する必要はありません。これらのオプションをレスポンス・ファイルに保存する場合は、「レスポンス・ファイルの保存」をクリックし、レスポンス・ファイルの場所と名前を指定します。
    「アップグレード」をクリックして、アップグレード・プロセスを開始します。
  7. 「アップグレードの進行状況」画面で、アップグレードのステータスを監視します。

    注意:

    Upgrade Assistantにはアップグレードを実行するための十分な時間を与えてください。やむを得ない場合を除き、アップグレード操作は取り消さないでください。これを行うと、環境が不安定になる可能性があります。
    正しくアップグレードされていないコンポーネントがある場合は、Upgrade Assistantのログ・ファイルで情報を確認します。

    ノート:

    この画面のプログレス・バーには、現在のアップグレード手順の進行状況が表示されます。アップグレードの残り時間を示すものではありません。

    「次」をクリックします。

  8. アップグレードが成功した場合: 「アップグレード成功」画面で、「閉じる」をクリックし、アップグレードを完了してウィザードを閉じます。新規インストールでコンポーネントを機能させるために手動で実行する必要のあるタスクが、アップグレード後のアクションのウィンドウに表示されます。このウィンドウは、コンポーネントにアップグレード後のステップがある場合にのみ表示されます。
    アップグレードが失敗した場合: 「アップグレード失敗」画面で「ログの表示」をクリックして、エラーを確認し、トラブルシューティングします。ログは、ORACLE_HOME/oracle_common/upgrade/logsにあります。

    ノート:

    アップグレードが失敗した場合は、アップグレード前の環境をバックアップからリストアし、問題を修正してから、Upgrade Assistantを再起動する必要があります。

ユーザー・インタフェースに対するアプリケーション・モジュールのチューニング

Oracle Identity Manager中間層のアップグレードに成功したら、アプリケーション・モジュール(AM)をチューニングします。

パラメータjbo.ampool.maxavailablesizeは、OIMにアクセスすると予想される同時ユーザーの数をOIMに知らせるために使用されます。デフォルト値を確認するには、$DOMAIN_HOME/setDomainEnv.shに移動し、パラメータjbo.ampool.maxavailablesizeを検索します。

設定されている値が予想される同時ユーザーの数と一致しない場合は、setUserOverridesLate.shファイルでその値を更新する必要があります。setDomainEnv.shファイルは直接変更しないでください。将来の更新時に変更が失われる可能性があります。setUserOverridesLate.shに対する変更はアップグレード後も保持されるため、ユーザーが定義する値はすべてこのファイルで設定する必要があります。

パラメータjbo.ampool.maxavailablesizeの推奨値は、予想される同時ユーザー数+ 20%です。

推奨アプリケーション・モジュール設定を追加するには、次を実行します:

  1. テキスト・エディタでファイル$DOMAIN_HOME/bin/setUserOverridesLate.shを開きます。
  2. setUserOverridesLate.shファイルを編集して、次の行を追加します:
    JAVA_OPTIONS="${JAVA_OPTIONS} -Djbo.ampool.maxavailablesize = <# of concurrent users + 20%>
  3. setUserOverridesLate.shファイルを保存して閉じます。

ノート:

setUserOverridesLate.shファイルが存在しない場合は、作成する必要があります。

12c Oracleホームからのoracle.iam.ui.custom-dev-starter-pack.warのコピー

oracle.iam.ui.custom-dev-starter-pack.warファイルを、12c (12.2.1.4.0) Oracleホームのバックアップから、14c (14.1.2.1.0) Oracleホーム(ORACLE_HOME/idm/server/apps/)に手動でコピーする必要があります。

14c (14.1.2.1.0) Oracleホームへのフォルダのコピー

14cにアップグレードする際に、一部のフォルダにファイル・システム依存データがある場合は、それらのフォルダを新しいOracleホームに手動でコピーする必要があります。

たとえば、pluginsScheduleTaskXLIntegrationsJavaTasksconnectorResourcesなどです。

次のコマンドを実行します。

cp -r 12c_MW_HOME/<product_idm>/server/plugins/* ORACLE_HOME/<product_idm>/server/plugins/

ORACLE_HOMEは、14c Oracleホームです。

サーバーとプロセスの起動

アップグレードが成功した後、管理サーバーおよび管理対象サーバーを含め、すべてのプロセスおよびサーバーを起動します。

コンポーネントは相互に依存していることがあるため、適切な順序で起動する必要があります。

ノート:

この項の手順では、WLSTコマンドライン・ユーティリティまたはスクリプトを使用してサーバーおよびプロセスを起動する方法について説明します。Oracle Fusion Middleware ControlおよびOracle WebLogic Serverリモート・コンソールを使用することもできます。「管理サーバー、管理対象サーバーおよびノード・マネージャの起動と停止」を参照してください。

リリース14c (14.1.2.0.0)以降、WebLogic Server管理コンソールは削除されました。同等の機能を使用するには、WebLogicリモート・コンソールを使用する必要があります。詳細は、Oracle WebLogicリモート・コンソールを参照してください。

Fusion Middleware環境を起動するには、次のステップに従います。

ノート:

既存のセキュリティ設定によっては、保護された本番モードが有効なドメインを管理するために、追加の構成が必要な場合があります。詳細は、WebLogicリモート・コンソールを使用した管理サーバーへの接続に関する項を参照してください

.

ステップ1: ノード・マネージャを起動する

ノード・マネージャを起動するには、startNodeManagerスクリプトを使用します。

  • (UNIX) NEW_DOMAIN_HOME/bin/startNodeManager.sh

  • (Windows) NEW_DOMAIN_HOME\bin\startNodeManager.cmd

ステップ2: 管理サーバーの起動

管理サーバーを起動するには、startWebLogicスクリプトを使用します。

  • (UNIX) NEW_DOMAIN_HOME/bin/startWebLogic.sh

  • (Windows) NEW_DOMAIN_HOME\bin\startWebLogic.cmd

    ノート:

    保護された本番モードを使用する場合は、管理サーバーを起動するための追加パラメータを指定する必要があります。『Oracle WebLogic Serverセキュリティの管理』WLSTを使用した管理サーバーへの接続に関する項を参照してください。

プロンプトが表示されたら、管理サーバーのユーザー名とパスワード、およびURLを入力します。

ステップ3: 管理対象サーバーを起動する

WebLogic Server管理対象サーバーを起動するには、startManagedWebLogicスクリプトを使用します。

  • (UNIX) NEW_DOMAIN_HOME/bin/startManagedWebLogic.sh managed_server_name admin_url

  • (Windows) NEW_DOMAIN_HOME\bin\startManagedWebLogic.cmd managed_server_name admin_url

    ノート:

    保護された本番モードを使用する場合は、管理対象サーバーを起動するための追加パラメータを指定する必要があります。Oracle WebLogic Serverセキュリティの管理起動スクリプトを使用した管理対象サーバーの起動に関する項を参照してください。

ノート:

通常、管理対象サーバーを起動すると、そのサーバーにデプロイされているアプリケーションが開始されます。したがって、管理対象サーバーの起動後にアプリケーションを手動で開始する必要はありません。

ステップ4: システム・コンポーネントを起動する

Oracle HTTP Serverなどのシステム・コンポーネントを起動するには、startComponentスクリプトを使用します。

  • (UNIX) NEW_DOMAIN_HOME/bin/startComponent.sh component_name

  • (Windows) NEW_DOMAIN_HOME\bin\startComponent.cmd component_name

システム・コンポーネントは任意の順序で起動できます。

ドメイン固有コンポーネント構成のアップグレードの確認

ドメイン固有コンポーネント構成のアップグレードが成功したことを確認するには、リモート・コンソールにサインインし、アップグレードされた各コンポーネントのバージョン番号が14.1.2.1.0になっていることを確認します。

ノート:

ホストされたWebLogicリモート・コンソールにアクセスする前に、ホストされたWebLogicリモート・コンソールをデプロイする必要があります。詳細は、Remote Consoleオンライン・ヘルプを参照してください。

リモート・コンソールにサインインするには、http://hostname:port/rconsole、またはHTTPSの場合は https://hostname:port/rconsoleに移動します。

ノート:

アップグレードに成功したら、管理ツールは、前のOracleホーム・ディレクトリではなく新しい14c (14.1.2.1.0)のOracleホーム・ディレクトリから必ず実行してください。

アップグレード・プロセス時に、一部のOWSMドキュメント(ポリシー・セット、ポリシーおよびアサーション・テンプレートなどの事前定義ドキュメント)のアップグレードが必要な場合があります。ポリシー・セットまたは事前定義ドキュメントがアップグレードされると、バージョン番号が1増分されます。

Upgrade Assistantを実行するためにFMWユーザーを作成した場合は、アップグレードが成功したことを確認してからアカウントを削除してください。

setDomainEnv.shファイルの更新

Oracle Identity Governance (OIG)を12c (12.2.1.4.0)から14c (14.1.2.1.0)にアップグレードするためには、setDomainEnv.shファイル内のプロパティを削除する必要があります。

次のステップを実行します。

  1. Oracle_Home/domains/<domain name>/bin/にあるsetDomainEnv.shファイルを開きます。
  2. 次のように開始する行から次のパラメータを削除します:
    EXTRA_JAVA_PROPERTIES="-Djavax.net.ssl.trustStore=${WL_HOME}/server/lib/DemoTrust.jks

    パラメータは次のとおりです:

    -Doracle.xdkjava.compatibility.version=11.1.1
  3. setDomainEnv.shファイルを保存して閉じます。

ノート:

  • SOAの場合、EXTRA_JAVA_PROPERTIES="${EXTRA_JAVA_PROPERTIES}で始まる行のsetSOADomainEnv.shファイルに、引数として次のエントリを追加する必要があります。
    -Doracle.xdkjava.compatibility.version=11.1.1
  • すべてのOIMホスト・マシンで、これらのステップを繰り返します。

Oracle Identity Manager Design Consoleのアップグレード

Oracle Identity Manager (OIM)ドメイン・コンポーネント構成をアップグレードした後、Oracle Identity Manager Design Consoleをアップグレードします。

Oracle Identity Manager Design Consoleをアップグレードするには、次のステップを完了します。
  1. 14c (14.1.2.1.0) designconsole/config/xlconfig.xml12c (12.2.1.4.0) designconsole/config/xlconfig.xmlファイルで置換します。
  2. 以前のバージョンでDesign Consoleが構成されていない場合、Design Consoleを起動すると、OIM管理対象サーバーのホスト名とポート値がデフォルト変数に変更されます。デザイン・コンソールの起動ウィンドウで、URLをインストールに適した値に更新します。

アップグレード後タスク

Oracle Access Managerを14c (14.1.2.1.0)にアップグレードした後、必要に応じてこの項にまとめられたタスクを完了する必要があります。

この項には次のトピックが含まれます:

カスタム構成のコピー

12c (12.2.1.4.0) Oracleホーム内にカスタム構成を設定した場合は、12c (12.2.1.4.0) Oracleホームのバックアップに存在するカスタム構成を14c (14.1.2.1.0) Oracleホームにコピーする必要があります。

例: 12c (12.2.1.4.0) Oracleホームのバックアップにある標準ディレクトリ(XLIntegrationsconnectorResourcesなど)のすべての内容を、14c (14.1.2.1.0) Oracleホームの対応するディレクトリにコピーします。

同様に、スケジュール・ジョブ・パラメータが12c (12.2.1.4.0) Oracleホームのものを参照している場合、それを12c (12.2.1.4.0) Oracleホームのバックアップから14c (14.1.2.1.0) Oracleホームの対応するディレクトリにコピーします。

ノート:

「OIMHOST上の12c (12.2.1.4.0) Oracleホーム・フォルダのバックアップ」で作成したカスタム構成のバックアップは、このステップでリストアされます。

カスタム・アプリケーションの処理

Oracle Identity Governance (OIG) 12c (12.2.1.4.0)のデプロイメントにカスタム・アプリケーションおよびライブラリが存在する場合は、Oracle Identity Governance (OIG) 14c (14.1.2.1.0)へのアップグレード後に手動で更新することをお薦めします。

ADF DI Excelプラグインの再インストール

Oracle Identity Managerを14c (14.1.2.1.0)にアップグレードした後、ADF DI Excelプラグインをアンインストールした後再インストールしてから、Excelを再ダウンロードします。

レガシー・コネクタのシステム・プロパティの定義

アップグレード後のタスクの一環として、tcITResourceInstanceOperationsBean.getITResourceInstanceParametersメソッドを使用するリソース・アクセス制御ファシリティ(RACF)などのレガシー・コネクタの場合、次の2つのシステム・プロパティを作成し、その値をTrueに更新する必要があります:
  • サービス・アカウント暗号化パラメータ値
  • サービス・アカウント・パラメータ値ストア

これらのシステム・プロパティの詳細は、『Oracle Identity Governanceの管理』Oracle Identity Governanceのデフォルト以外のシステム・プロパティに関する項の表18-2を参照してください。

レガシー・コネクタまたは古いカスタム・コードにレガシー動作が必要な場合にのみ、これらのシステム・プロパティを作成することをお薦めします。

WebLogic Serverセッション・レプリケーションの最大メッセージ・サイズの増加

最大メッセージ・サイズをデフォルト値の10MBから100MBに変更することをお薦めします。この値は、ノード間でセッション・データをレプリケートするために使用されます。すべての管理対象サーバーおよび管理サーバーに対してこのステップを実行する必要があります。

  1. WebLogic Server管理コンソールにログインします。
  2. 「サーバー」に移動し、「プロトコル」を選択して、「一般」をクリックします。
  3. 「最大メッセージ・サイズ」の値を100MBに設定します。

setDomainEnv.shのmaxdepth値を増やす

maxdepthパラメータの推奨値は250です。この値を更新するには:
  1. テキスト・エディタで$DOMAIN_HOME/bin/setDomainEnv.shファイルを開きます。
  2. 次のコード・ブロックを探します。
    ALT_TYPES_DIR="${OIM_ORACLE_HOME}/server/loginmodule/wls,${OAM_ORACLE_HOME}/a
    gent/modules/oracle.oam.wlsagent_11.1.1,${ALT_TYPES_DIR}"
    export ALT_TYPES_DIR
    CLASS_CACHE="true"
    export CLASS_CACHE
  3. 前述のコード・ブロックの最後に次の行を追加します。
    JAVA_OPTIONS="${JAVA_OPTIONS} -Dweblogic.oif.serialFilter=maxdepth=250"
    export JAVA_OPTIONS
  4. setDomainEnv.shファイルを保存して閉じます。

アップグレード後のJMSおよびTLOG永続ストアの変更

JMSおよびTLOG永続ストアは、Oracle Identity Manager 14c (14.1.2.1.0)へのアップグレード後も同じままです。つまり、永続ストアがアップグレード前にファイルベースである場合は、アップグレード後もファイルベースになります。

永続ストアをファイルベースのシステムからデータベースベースのシステムに変更する場合は、ステップを手動で実行する必要があります。「エンタープライズ・デプロイメントでのTLOGおよびJMSに対する永続ストアの使用」を参照してください。