1. Oracle Access Managerのアップグレード
  2. Oracle Access Managerのインプレース・アップグレード
  3. Oracle Access Manager単一ノード環境のアップグレード

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

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

ノート:

以前のバージョンのOracle Access Managerを使用している場合は、まずOracle Access Manager 12c (12.2.1.3.0)にアップグレードしてから、12c (12.2.1.4.0)にアップグレードする必要があります。

次の各項のステップを完了して、アップグレードを実行します。

親トピック: Oracle Access Managerのインプレース・アップグレード

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

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

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

表3-1 単一ノードのOracle Access Managerデプロイメントをアップグレードするためのタスク

タスク 説明

必須

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

関連項目:

必須

Oracle Access Managerに固有の必要なアップグレード前タスクを完了します。

「Oracle Access Managerのアップグレード前のタスクの完了」を参照してください。

必須

12c環境を停止します(すべての管理サーバーと管理対象サーバーを停止します)。

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

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

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

必須

既存のOracleホームのOracle Fusion Middleware InfrastructureおよびOracle Access Manager 12c (12.2.1.3.0)をアンインストールします。

「ソフトウェアのアンインストール」を参照してください。

必須

Fusion Middleware InfrastructureおよびOracle Access Manager 12c (12.2.1.4.0)を既存のOracleホームにインストールします。

アップグレードを開始する前に、Fusion Middleware InfrastructureおよびOracle Access Managerを12c (12.2.1.3.0)本番デプロイメントと同じホスト上にある同じOracleホームにインストールします。12c (12.2.1.4.0)では、12c Middlewareホームを表現するために、Oracleホームを使用します。

「製品ディストリビューションのインストール」を参照してください。

必須

ノード・マネージャ、管理サーバーおよび管理対象サーバーを起動します。

 「OAMHOSTでのサーバーの起動」を参照してください。

親トピック: Oracle Access Manager単一ノード環境のアップグレード

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

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

親トピック: Oracle Access Manager単一ノード環境のアップグレード

Oracle Access Managerのアップグレードでサポートされている開始ポイントのチェック

アップグレードでサポートされているOracle Access Managerバージョンは、12c (12.2.1.3.0)です。

以前のバージョンのOracle Access Managerを使用している場合は、まずOracle Access Manager 12c (12.2.1.3.0)にアップグレードしてから、12c (12.2.1.4.0)にアップグレードする必要があります。

親トピック: Oracle Access Managerのアップグレード前のタスクの完了

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

構成をアップグレードする前に、すべてのアップグレード前のプロセスと、対象のOAMHOSTで実行されているWeblogic管理サーバー、管理対象サーバーおよびノード・マネージャ・サーバーを含めたすべてのサーバーを停止する必要があります。

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

ノート:

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

アップグレード前の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')

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

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

kill $(ps -ef | grep nodemanager | awk '{print $2}')

ステップ4: WLSコンポーネントが実行されているかどうかを確認する

管理サーバー、管理対象サーバー、ノード・マネージャなどのWLSコンポーネントが実行されているかどうかを確認するには、次のコマンドを実行します: 
$ ps -ef |grep java

出力ではgrepプロセスのみが返されるはずです。

たとえば: 
oracle   14709 14410  0 19:07
pts/0    00:00:00 grep --color=auto java

前述のgrepコマンド以外のjavaプロセスがリストされる場合は、リストされたjavaプロセスを特定して停止します。

親トピック: Oracle Access Manager単一ノード環境のアップグレード

ソフトウェアのアンインストール

この項の手順に従ってアンインストール・ウィザードを起動し、ソフトウェアを削除します。

サイレント(コマンドライン)・モードの製品のアンインストールを実行する場合は、『Oracle Universal Installerによるソフトウェアのインストール』のサイレント・アンインストールのためのOracle Universal Installerの実行に関する項を参照してください。

親トピック: Oracle Access Manager単一ノード環境のアップグレード

「アンインストール・ウィザード」の起動

アンインストール・ウィザードを起動します。

  1. 次のディレクトリに変更します。
    (UNIX) ORACLE_HOME/oui/bin
    (Windows) ORACLE_HOME\oui\bin
  2. 次のコマンドを入力します。
    (UNIX) ./deinstall.sh
    (Windows) deinstall.cmd

親トピック: ソフトウェアのアンインストール

アンインストールする製品の選択

Oracleホームには複数の製品が存在するため、適切な製品をアンインストールするようにしてください。

「アンインストール・ウィザード」を実行した後、「アンインストールする配布」画面が表示されます。

ドロップダウン・メニューからOracle Fusion Middleware 12c (12.2.1.3.0) Identity and Access Management製品を選択し、「アンインストール」をクリックします。

ノート:

アンインストール・ウィザードに「アンインストールする配布」画面が表示されるのは、ウィザードを開始したOracleホームで複数の製品ディストリビューションが検出された場合のみです。Oracle Fusion Middleware 12c (12.2.1.3.0) Identity and Access Management製品ディストリビューションのみが使用可能な場合、アンインストール・ウィザードには「アンインストール・サマリー」画面が表示されます。

ノート:

「Weblogic Server for FMW 12.2.1.3.0」を選択しないでください。

アンインストール・プログラムには、「アンインストール・ウィザード画面のナビゲート」に示されている画面が表示されます。

ノート:

OIMまたはOAMソフトウェアをアンインストールした後、アンインストール・ウィザードを再度実行することにより、Oracle Fusion Middleware Infrastructureをアンインストールできます。Infrastructureが削除されると、Infrastructureを使用する他の製品が機能しなくなるため、削除する前に、そのような製品がないことを確認してください。Oracle Fusion Middleware Infrastructureに依存するソフトウェアが他にない場合は、「アンインストールする配布」画面は表示されません。『Oracle Fusion Middleware Infrastructureのインストールと構成』のOracle Fusion Middleware Infrastructureのアンインストールに関する項を参照してください

親トピック: ソフトウェアのアンインストール

アンインストール・ウィザード画面のナビゲート

アンインストール・ウィザードには、ソフトウェアの削除を確認する一連の画面が表示されます。

次の表に示した画面についてのヘルプが必要な場合には、画面上の「ヘルプ」をクリックしてください。

表 3-2 アンインストール・ウィザード画面および説明

画面 説明

ようこそ

製品のアンインストール・ウィザードに案内します。

アンインストールのサマリー

アンインストールされるOracleホーム・ディレクトリとその内容を示します。これが正しいディレクトリであることを確認してください。

これらのオプションをレスポンス・ファイルに保存する場合は、「レスポンス・ファイルの保存」をクリックし、レスポンス・ファイルの場所と名前を入力します。後でレスポンス・ファイルを使用して、製品をサイレント(コマンドライン)・モードでアンインストールできます。『Oracle Universal Installerによるソフトウェアのインストール』のサイレント・アンインストールのためのOracle Universal Installerの実行に関する項を参照してください。

「アンインストール」, をクリックしてソフトウェアの削除を開始します。

アンインストールの進行状況

アンインストールの進行状況を表示します。

アンインストール完了

アンインストールが完了すると表示されます。この画面の情報を確認してから、「終了」をクリックしてアンインストール・ウィザードを閉じます。

ノート:

  • FMW 12.2.1.3.0のWeblogic Serverをアンインストールするには、これらのステップを繰り返します。

    Oracleバイナリを同じORACLE_HOMEの場所に再インストールすることになります。

  • 製品をアンインストールした後、ORACLE_HOMEフォルダが存在することを確認します。最初の12.2.1.3.0インストール時にデフォルトの場所がORACLE_HOME (/user_projects)であった場合、domain-registry.xmlファイルはORACLE_HOMEにあります。
このディレクトリをクリーニングするには、次のステップを実行します:
  1. OAMとWLSの両方をアンインストールした後、次のコマンドを実行します:
    $ ls -al
    次に出力の例を示します:
    total 28
drwxr-x---. 6 <USER> <GROUP> 4096 Apr  2 20:27 .
drwxr-x---. 6 <USER> <GROUP> 4096 Jul  9  2019 ..
drwxr-x---. 5 <USER> <GROUP> 4096 Mar 23 17:48 cfgtoollogs
-rw-r-----. 1 <USER> <GROUP>  225 Jul  9  2019 domain-registry.xml
drwxr-x---. 7 <USER> <GROUP> 4096 Mar 26 17:12 .patch_storage
drwxr-x---. 4 <USER> <GROUP> 4096 Jul  9  2019 user_projects
drwxr-x---. 3 <USER> <GROUP> 4096 Apr  2 20:26 wlserver
  2. ORACLE_HOMEの場所に移動します。user_projectsディレクトリおよびdomain-registry.xmlファイルが存在する場合は、そのバックアップを作成します。アップグレードの完了後にこれらをリストアする必要があります。バックアップを作成した後、ORACLE_HOME内のすべてのファイルを削除します。

親トピック: ソフトウェアのアンインストール

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

ノート:

アップグレードにInfrastructureが必要な場合は、その他のFusion Middleware製品をインストールする前に、まずOracle Fusion Middlewareディストリビューションをインストールする必要があります。
12c (12.2.1.4.0)ディストリビューションをインストールするには:
  1. ターゲットのシステムにサインインします。
  2. Oracle Technology NetworkまたはOracle Software Delivery Cloudから次のものをターゲット・システムにダウンロードします。
    • Oracle Fusion Middleware Infrastructureをまだインストールしていない場合は、Oracle Fusion Middleware Infrastructure (fmw_12.2.1.4.0_infrastructure.jar)をダウンロードします
    • OTNから、またはOracle Software Delivery CloudのOracle Fusion Middleware 12c (12.2.1.4.0) Identity and Access Managementからの、Oracle Identity and Access Management 12cPS4 (fmw_12.2.1.4.0_idm.jarが含まれるfmw_12.2.1.4.0_idm_Disk1_1of1.zip)。
    • アップグレード前の環境用の追加のディストリビューション
  3. 12c (12.2.1.4.0)製品のディストリビューションをダウンロードしたディレクトリに移動します。
  4. Oracle Fusion Middleware Infrastructure (fmw_12.2.1.4.0_infrastructure.jar)がすでにインストールされている場合は、ステップ15に進みます。
  5. Oracle Fusion Middleware Infrastructureのインストール・プログラムを起動します。
    次のコマンドを実行します:
    • (UNIX) JDK_HOME/bin/java -jar fmw_12.2.1.4.0_infrastructure.jar
    • (Windows) JDK_HOME\bin\java -jar fmw_12.2.1.4.0_infrastructure.jar

    ノート:

    12c (12.2.1.3.0) OAMのアンインストール・プロセスの一部として、Oracle_Homeディレクトリのクリーン・アップ中に作成されたバックアップからuser_projectsディレクトリおよびdomain-registry.xmlファイルをリストアします。
  6. 既存の12c (12.2.1.3.0) DOMAIN_HOMEが12c (12.2.1.3.0)のOracleホーム・ディレクトリ内に存在する場合は、次のようにします:
    1. 12c (12.2.1.3.0)のOracleホームのバックアップ場所に移動します。

      たとえば: /u01/app/fmw/ORACLE_HOME_old/

    2. user_projectsフォルダをコピーします。
    3. 新しくインストールされた12c (12.2.1.4.0)のOracleホームの場所に移動します。

      たとえば: /u01/app/fmw/ORACLE_HOME/

    4. コピーしたuser_projectsフォルダを貼り付けます。
  7. UNIXオペレーティング・システムでは、このホストにOracle製品を初めてインストールする場合に、「インストール・インベントリの設定」画面が表示されます。
    中央インベントリを作成する場所を指定します。この画面で選択したオペレーティング・システム・グループ名に中央インベントリの場所への書込み権限があることを確認し、「次へ」をクリックします。

    ノート:

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

    • この時点でソフトウェアの更新をシステムで確認しないようにする場合は、「自動更新をスキップ」を選択します。

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

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

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

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

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

    ノート:

    「インストール・タイプ」画面で、Oracle Access Managerの場合は、同じ場所に配置されたOracle Identity and Access Managerを選択します。

    • (UNIX) JDK_HOME/bin/java -jar fmw_12.2.1.4.0_idm.jar

    • (Windows) JDK_HOME\bin\java -jar fmw_12.2.1.4.0_idm.jar

    ノート:

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

親トピック: Oracle Access Manager単一ノード環境のアップグレード

WebLogicドメインの再構成

再構成ウィザードを使用してドメインを再構成するには、まずDOSコマンド・プロンプトまたはUNIXシェルからこれを起動し、表示される一連の画面に必要なアップグレードの詳細を入力します。

Windowsコマンド・プロンプトまたはUNIXシステムから、再構成ウィザードをグラフィカル・モードで起動するには:

  1. ドメインが存在するシステムにログインします。
  2. MS-DOSコマンド・プロンプト・ウィンドウ(Windows)またはコマンド・シェル(UNIX)を開きます。
  3. 次のディレクトリに移動します。ここでORACLE_HOMEは、Oracleホーム・ディレクトリです。

    Windowsの場合: ORACLE_HOME\oracle_common\common\bin

    UNIX:の場合: ORACLE_HOME/oracle_common/common/bin

  4. 次のコマンドを実行します:

    Windowsの場合: reconfig.cmd

    UNIXの場合: sh reconfig.sh

「再構成セットアップの進行状況」画面が表示されます。進捗バーが100%になったら、「取消」をクリックします。この時点で、「終了」ボタンは有効になっていませんが、config.xmlファイルは更新されています。

親トピック: Oracle Access Manager単一ノード環境のアップグレード

OAMHOSTでのサーバーの起動

OAMHOSTでOracle Access Managerをアップグレードした後、サーバーを起動します。

サーバーは次の順序で起動してください。

ノート:

管理サーバーを起動する前に、My Oracle Supportからパッチ30729380をダウンロードし、OPatchを使用してOAMノードおよびクラスタ内の他のWLSノードに適用します。

  1. 必要なOAMHOSTでノード・マネージャを起動します。

  2. 必要なOAMHOSTで管理サーバーを起動します。

  3. 必要なOAMHOSTでOracle Access Manager管理対象サーバーを起動します。

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

親トピック: Oracle Access Manager単一ノード環境のアップグレード

サーバーおよびプロセスの起動

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

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

ノート:

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

Fusion Middleware環境を起動するには、次に示すステップを実行します。

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

管理サーバー・ドメイン・ホームでのノード・マネージャの起動:

  • (UNIX) nohup ./startNodeManager.sh > DOMAIN_HOME/nodemanager/nodemanager.out 2>&1 &

  • (Windows) nohup .\startNodeManager.sh > DOMAIN_HOME\nodemanager\nodemanager.out 2>&1 &

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

管理サーバーを起動する場合、管理サーバーで稼働しているWebLogic Server管理コンソールやFusion Middleware Controlなどのプロセスも起動します。

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

  • (UNIX) DOMAIN_HOME/bin/startWebLogic.sh

  • (Windows) DOMAIN_HOME\bin\startWebLogic.cmd

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

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

方法1: Weblogicコンソールを使用して、WebLogic Server管理対象サーバーを起動します:
  • weblogic管理者としてWeblogicコンソールにログインします。
  • 「サーバー」 > 「制御」タブに移動します。
  • 必要な管理対象サーバーを選択します。
  • 「起動」をクリックします。

方法2: startManagedWebLogicスクリプトを使用して、WebLogic Server管理対象サーバーを起動します:

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

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

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

ノート:

  • 通常、管理対象サーバーを起動すると、そのサーバーにデプロイされているアプリケーションが開始されます。したがって、管理対象サーバーの起動後にアプリケーションを手動で開始する必要はありません。
  • 12cでは、モバイル・セキュリティ・マネージャ(MSM)サーバーはサポートされていません。サーバーの再起動後に、MSMサーバーの11g構成(omsm_server1やWLS_MSM1など)が残る場合があります。これらの構成は無視してください。MSMサーバーを再起動しないでください。

親トピック: OAMHOSTでのサーバーの起動