ヘッダーをスキップ
Oracle Identity Managerアップグレード・ガイド
リリース9.1.0(9.0.3.2アップグレード)
B51495-01
  目次
目次
索引
索引

戻る
戻る
 
次へ
次へ
 

5 Oracle Application Serverでのリリース9.1.0へのアップグレード

この章では、Oracle Application Serverでリリース9.0.3.2からリリース9.1.0にアップグレードする方法を説明します。それ以外のリリースのOracle Identity Managerからリリース9.1.0へのアップグレードは行わないでください。

リリース9.1.0アップグレード・パッケージの内容を、既存のリリース9.0.3.2システムの一時ディレクトリに抽出します。

この章では、次の項目ごとに、Oracle Application Server上でリリース9.0.3.2からリリース9.1.0にアップグレードする方法を説明します。

  1. 既存のデプロイメントのバックアップの作成

  2. Oracle Identity Managerデータベースのアップグレード

  3. Oracle Application Serverパッチの適用

  4. リリース9.0.3.2からリリース9.1.0へのアップグレード準備

    1. Oracle Identity Managerのアップグレード準備

    2. Design Consoleの準備およびアップグレード

    3. Remote Managerのアップグレードの準備およびアップグレード

  5. リリース9.0.3.2からリリース9.1.0へのアップグレード準備

  6. カスタム・コードの移行

  7. アップグレード後の構成

  8. 診断ダッシュボードのアップグレード

5.1 既存のデプロイメントのバックアップの作成

リリース9.1.0にアップグレードするための最初の手順は、既存のOracle Identity Managerインストールのバックアップを作成することです。アップグレードが失敗した場合は、このバックアップを使用して既存のOracle Identity Managerインストールを元の状態にリストアできます。

次のインストールのバックアップを作成します。

5.2 Oracle Identity Managerデータベースのアップグレード

Oracle Identity Managerデータベースのアップグレードの詳細は、第6章「Oracle Identity Managerデータベースのアップグレード」を参照してください。

5.3 Oracle Application Serverパッチの適用

Oracle Identity Managerリリース9.1.0をインストールする前に、Oracle Application Serverに次のパッチを実行する必要があります。


注意:

  • パッチ、およびそのパッチの適用方法の説明は、次のOracle MetaLink Webサイトからダウンロードできます。

    http://metalink.oracle.com

  • Microsoft Windows VistaにOracle Identity Managerをインストールしている場合は、環境変数OPATCH_PLATFORM_IDを207に設定する必要があります。


  1. OPatchパッチ2617419をインストールします。

  2. Oracle Application Serverパッチ6685235をインストールします。

  3. Oracle Application Serverパッチ5389650をインストールします。

  4. Oracle Application Serverパッチ6454278をインストールします。

  5. ORACLE_HOME/j2ee/OAS_INSTANCE/config/rmi.xmlファイルを開きます。次のようにmax-server-sockets="200"を追加します。

    <rmi-server
    ...
    max-server-sockets="200">
    

5.4 リリース9.0.3.2からリリース9.1.0へのアップグレード準備

Oracle Identity Managerリリース9.1.0にアップグレードする前に、次のコンポーネントに対してアップグレード前の構成タスクを実行して、アップグレードの準備を行う必要があります。

5.4.1 Oracle Identity Managerのアップグレード準備

Oracle Identity Managerデプロイメントのリリース9.1.0へのアップグレードの準備をするには、次の手順を実行して、リリース9.0.3.2のライブラリ、スクリプトおよび構成ファイルを更新する必要があります。

  1. Oracle Identity Managerリリース9.1.0アップグレード・パッケージの内容を、Oracle Identity Managerリリース9.0.3.2がインストールされているコンピュータの一時ディレクトリに抽出します。

  2. OIM_HOMEディレクトリのバックアップを作成します。

  3. 表5-1「コピー元」列の場所にあるディレクトリとファイルを「コピー先」列の場所にコピーします。

    必要であれば、「コピー先」の場所にある既存のファイルを上書きします。

    表5-1 アップグレード前にコピーするOracle Identity Managerのファイル

    コピー元 コピー先

    PATCH/documentation/

    OIM_HOME/documentation/

    PATCH/readme.html

    OIM_HOME/

    PATCH/xellerate/bin/

    OIM_HOME/xellerate/bin/

    PATCH/xellerate/config/

    OIM_HOME/xellerate/config/

    PATCH/xellerate/ConnectorDefaultDirectory/

    OIM_HOME/xellerate/ConnectorDefaultDirectory/

    PATCH/xellerate/DDTemplates/

    OIM_HOME/xellerate/DDTemplates/

    PATCH/xellerate/ext/

    OIM_HOME/xellerate/ext/

    PATCH/xellerate/GTC/

    OIM_HOME/xellerate/GTC/

    PATCH/xellerate/JavaTasks/

    OIM_HOME/xellerate/JavaTasks/

    PATCH/xellerate/lib/

    OIM_HOME/xellerate/lib/

    PATCH/xellerate/SPMLSWS/

    OIM_HOME/xellerate/SPMLWS/

    PATCH/xellerate/webapp/

    OIM_HOME/xellerate/webapp/

    PATCH/xellerate/connectorResources/

    OIM_HOME/xellerate/connectorResources/

    PATCH/xellerate/customResources/

    OIM_HOME/xellerate/customResources/



    注意:

    PATCH/xellerate/lib/ディレクトリをコピーする際には、xlUpgradeAttestation.jarはコピーしないでください。コピーするのは、UpgradeAttestationスクリプトを実行する場合のみです。

  4. PATCH/xellerate/setup/ディレクトリの次のファイルをOIM_HOME/xellerate/setup/ディレクトリにコピーします。

    • setup.xml

    • patch_oc4j.cmd

    • patch_oc4j.sh

    • oc4j-setup.xml

    • spml_oc4j.cmd

    • spml_oc4j.sh

    • UpgradeAttestation.sh

    • UpgradeAttestation.bat

  5. OIM_HOME/xellerate/setup/ディレクトリにあるオペレーティング・システム対応のスクリプトを、表5-2のように編集します。

    表5-2 編集するOracle Application Serverアップグレード・パッチ・スクリプトとパラメータ

    オペレーティング・システム 編集するスクリプト 編集するパラメータ

    Microsoft Windows

    patch_oc4j.cmd

    • @locをOracle Identity Managerのインストール・ディレクトリのパスで置き換えます。

    • @java_locをOracle Application ServerのJavaディレクトリのパスで置き換えます。

    • @oracle_homeをOracle Application Serverディレクトリのパスで置き換えます。


    spml_oc4j.cmd

    • @locをOracle Identity Managerのインストール・ディレクトリのパスで置き換えます。

    • @java_locをOracle Application ServerのJavaディレクトリのパスで置き換えます。

    • @oracle_homeをOracle Application Serverディレクトリのパスで置き換えます。


    UpgradeAttestation.bat

    @java_homeをJavaインストール・ディレクトリのパスで置き換えます。

    UNIX

    patch_oc4j.sh

    • @locをOracle Identity Managerのインストール・ディレクトリのパスで置き換えます。

    • @java_locをOracle Application ServerのJavaディレクトリのパスで置き換えます。

    • @oracle_homeをOracle Application Serverディレクトリのパスで置き換えます。


    spml_oc4j.sh

    • @locをOracle Identity Managerのインストール・ディレクトリのパスで置き換えます。

    • @java_locをOracle Application ServerのJavaディレクトリのパスで置き換えます。

    • @oracle_homeをOracle Application Serverディレクトリのパスで置き換えます。


    UpgradeAttestation.sh

    @java_homeをJavaインストール・ディレクトリのパスで置き換えます。


  6. リリース9.0.3.2 Webアプリケーションで行ったカスタマイズ(たとえばJSPのカスタマイズ)を移行します。

    9.0.3.2のカスタマイズを新しいリリース9.1.0のWebアプリケーション・ファイルxlWebApp.warに適用します。このファイルはOIM_HOME/xellerate/webapp/ディレクトリにあります。


    関連項目:

    カスタマイズの移行の詳細は、「カスタム・コードの移行」を参照してください。

  7. OIM_HOME/xellerate/config/ディレクトリにある既存のリリース9.0.3.2の構成ファイルxlconfig.xmlを、リリース9.1.0の新しいキャッシュ関連設定で更新します。次の手順を実行します。

    1. OIM_HOME/xellerate/config/xlconfig.xmlファイルを開き、<xl-configuration><Cache>パラメータを探します。

    2. </ColumnMetaData>の後に次の行を追加します。

      <!-- API Data -->
      <API>
           <Enable>false</Enable>
           <ExpireTime>14400</ExpireTime>
      </API>
      
    3. </AttestationTaskMessage>の後に次の行を追加します。

      <AttestationTaskDetailMessage>com.thortech.xl.schedule.jms.attestation.processOfflinedAttestationTaskDetails</AttestationTaskDetailMessage>
      

      注意:

      上のコード行は、改行なしの単一行として追加する必要があります。

    4. 次のタグ内で

      <recon_offline_queue>
      

      次の文字列を

      <queueName>queue/xlQueue</queueName>
      

      次に置換します。

      <queueName>queue/xlReconQueue</queueName>
      
    5. 次のタグ内で

      <auditor_offline_queue>
      

      次の文字列を

      <queueName>queue/xlQueue</queueName>
      

      次に置換します。

      <queueName>queue/xlAuditQueue</queueName>
      
    6. 次のタグ内で

      <attestation_request_queue>
      

      次の文字列を

      <queueName>queue/xlQueue</queueName>
      

      次に置換します。

      <queueName>queue/xlAttestationQueue</queueName>
      
    7. 次のタグ内で

      <attestation_task_queue>
      

      次の文字列を

      <queueName>queue/xlQueue</queueName>
      

      次に置換します。

      <queueName>queue/xlAttestationQueue</queueName>
      
    8. 次のタグ内で

      <attestation_workflow_task_queue>
      

      次の文字列を

      <queueName>queue/xlQueue</queueName>
      

      次に置換します。

      <queueName>queue/xlAttestationQueue</queueName>
      
    9. 次のタグ内で

      <process_offline_queue>
      

      次の文字列を

      <queueName>queue/xlQueue</queueName>
      

      次に置換します。

      <queueName>queue/xlProcessQueue</queueName>
      
    10. 次のタグ内で

      <process_task_offline_queue>
      

      次の文字列を

      <queueName>queue/xlQueue</queueName>
      

      次に置換します。

      <queueName>queue/xlProcessQueue</queueName>
      
    11. </attestation_task_queue>の後に次の行を追加します。

      <attestation_task_detail_queue>
      <queueName>queue/xlAttestationQueue</queueName>
      <autoAcknowledge>true</autoAcknowledge>
      <replyTo></replyTo>
      <persistentFlag>true</persistentFlag>
      <disableMessageId>true</disableMessageId>
      <disableTimeStampe>false</disableTimeStampe>
      <messageEncrypt>false</messageEncrypt>
      </attestation_task_detail_queue>
      

SPML Webサービスの再デプロイ

既存のOracle Identity Managerの設定でSPML Webサービスを使用している場合は、設定をアップグレードするたびに、その設定用のSPML Webサービスを再デプロイする必要があります。


関連項目:

『Oracle Identity Manager Toolsリファレンス』の第12章「SPML Webサービス」を参照してください。

5.4.2 Design Consoleの準備およびアップグレード

Oracle Identity Manager Design Consoleのリリース9.1.0へのアップグレードを準備します。次の手順を実行して、リリース9.0.3.2のDesign Consoleのライブラリ、スクリプトおよび構成ファイルを更新します。

  1. OIM_DC_HOMEディレクトリのバックアップを作成します。

  2. 表5-3「コピー元」列の場所にあるディレクトリとファイルを「コピー先」列の場所にコピーします。

    必要であれば、「コピー先」の場所にある既存のファイルを上書きします。


    注意:

    PATCH/documentation/ディレクトリからリリース9.1.0のファイルをコピーする前に、OIM_DC_HOME/documentation/ディレクトリにあるリリース9.0.3.2のファイルを削除してください。

    表5-3 アップグレード前にコピーするOracle Identity Manager Design Consoleのファイル

    コピー元 コピー先

    PATCH/xlclient/XLDesktopClient.ear

    OIM_DC_HOME/xlclient/

    PATCH/xellerate/readme.htm

    OIM_DC_HOME/xlclient/

    PATCH/xlclient/CustomClient.zip

    OIM_DC_HOME/xlclient/

    PATCH/xlclient/xlFvcUtil.ear

    OIM_DC_HOME/xlclient/

    PATCH/xlclient/lib/

    OIM_DC_HOME/xlclient/lib/

    PATCH/documentation/

    OIM_DC_HOME/documentation/

    PATCH/xellerate/ext/

    OIM_DC_HOME/ext/


  3. OIM_DC_HOME/xlclient/classpath.batファイルを編集し、CLASSPATHの最後に;.\ext\oscache.jar;.\ext\commons-logging.jar;.\ext\javagroups-all.jarという文字列を追加します。

  4. 次のようにして、Design Consoleのxlconfig.xmlファイルにマルチキャスト・アドレスを指定します。

    1. テキスト・エディタで、OIM_DC_HOME/xlclient/Config/xlconfig.xmlファイルを開きます。

    2. </xl-configuration>タグの前に次の行を追加します。

      <!--  Value of MultiCastAddress must be the same as that of Oracle Identity Manager -->
      <Cache>
        <XLCacheProvider>
          <MultiCastAddress>MULTICASTADDRESS_VALUE</MultiCastAddress>
        </XLCacheProvider>
      </Cache>
      
    3. MULTICASTADDRESS_VALUEをOracle Identity Managerのマルチキャスト・アドレスの値に変更します。


    注意:

    Oracle Identity ManagerおよびDesign Consoleをアップグレードしたら、Design Consoleのアダプタ・マネージャに移動して、すべてのアダプタを再コンパイルします。

5.4.3 Remote Managerのアップグレードの準備およびアップグレード

リリース9.0.3.2のRemote Managerのライブラリ、スクリプトおよび構成ファイルを更新して、Oracle Identity Manager Remote Managerのリリース9.1.0へのアップグレードを準備します。手順は次のとおりです。

  1. OIM_RM_HOME/xlremote/lib/ディレクトリのバックアップを作成します。

  2. PATCH/xlremote/lib/ディレクトリの内容をOIM_RM_HOME/xlremote/lib/ディレクトリにコピーします。その際、必要に応じてファイルを上書きします。

5.4.4 複数のJMSキュー

これまで、Oracle Identity Managerでは、すべての非同期操作(リクエスト、リコンシリエーション、アテステーションおよびオフラインのタスクなど)に対してxlQueueという単一のJMSキューが使用されていました。Oracle Identity Managerリリース9.1.0ではデフォルトで、JMSキューの処理を最適化するために、特定の操作に対して別々のJMSキューが使用されます。デフォルトのJMSキューの構成および関連する操作を次に示します。

  • xlQueue(リクエスト操作)

  • xlReconQueue(リコンシリエーション操作)

  • xlAuditQueue(監査操作)

  • xlAttestationQueue(アテステーション操作)

  • xlProcessQueue(Oracle Identity Managerの今後のリリースでの使用)

ここでは、追加のJMSキューの作成に役立つ情報を示します。

JMSサーバー用JMSキューの作成

JMSサーバー用JMSキューを作成するには、次のようにします。

  1. Oracle Enterprise Managerにログインします。

  2. ホームページの「グループ」タブで、Oracle Identity Managerインスタンスが属するグループ名(デフォルトではdefault_group)をクリックします。

  3. 「管理」タブをクリックします。

  4. 管理タスク「サービス」「エンタープライズ・メッセージ・サービス」を開き、「JMS宛先」をクリックします。 9.0.3.2に存在したOracle Identity Managerの2つのキューxlQueueおよびxlErrorQueueが表示されます。

  5. 新しいキューを作成するには、「新規作成」をクリックします。

  6. 「宛先タイプ」リストから、「キュー」を選択し、「宛先名」の値としてxlReconQueueを入力します。

  7. 「ファイルベースの永続性」リストから、「永続性」を選択して次の値を入力します。

    • JNDIロケーション: queue/xlReconQueue

    • 永続性ファイル: xlReconQueueJMSStore

  8. 「OK」をクリックしてキューを作成します。

  9. 「宛先名」、「JNDIロケーション」および「永続性ファイル」に次の値を使用して、手順5〜8を繰り返します。

    • 宛先名: xlAuditQueue

      JNDIロケーション: queue/xlAuditQueue

      永続性ファイル: xlAuditQueueJMSStore

    • 宛先名: xlAttestationQueue

      JNDIロケーション: queue/xlAttestationQueue

      永続性ファイル: xlAttestationQueueJMSStore

    • 宛先名: xlProcessQueue

      JNDIロケーション: queue/xlProcessQueue

      永続性ファイル: xlProcessQueueJMSStore


    注意:

    Oracle Identity Managerのクラスタ・インストールの場合は、クラスタに存在する各サーバーに4つのキューすべてを作成します。

5.5 リリース9.0.3.2からリリース9.1.0へのアップグレード準備

Oracle Application Serverの単一のインストールで、リリース9.0.3.2からリリース9.1.0にアップグレードするには、次の手順を実行します。

  1. Oracle Application Serverが稼働していないことを確認します。


    注意:

    Oracle Application Serverが稼働している場合は、Oracle Identity Managerデプロイメイントのホスト・コンピュータのORACLE_HOME/opmn/binディレクトリから、次のコマンドを実行して停止してください。
    ./opmnctl stopall
    

  2. OIM_HOME/xellerate/webapp/precompiled/ディレクトリを削除します。

  3. 次のようにして、Oracle Application Serverを起動します。

    1. ORACLE_HOME/opmn/binディレクトリに移動します。

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

      ./opmnctl startall
      
  4. アテステーションのアップグレードの詳細は、付録H「アテステーション・アップグレード・ユーティリティ」を参照してください。この手順は必須です。

  5. OIM_HOME/xellerate/Profiles/oc4j.profileファイルで、次の行を探します。

    # database type is either oracle or sqlserver
    database.type=oracle
    

    次の行を追加します。

    # Reporting data source
    datasource.report=jdbc/xlXADS
    
  6. patch_oc4jスクリプトを実行します。

    Microsoft Windowsの場合は、次のスクリプトを実行します。

    OIM_HOME\xellerate\setup\patch_oc4j.cmd OAS_ADMIN_PASSWORD DATASOURCE_PASSWORD
    

    UNIXの場合は、次のスクリプトを実行します。

    OIM_HOME/xellerate/setup/patch_oc4j.sh OAS_ADMIN_PASSWORD DATASOURCE_PASSWORD
    

    patch_oc4jスクリプトのパラメータは次のとおりです。

    • OAS_ADMIN_PASSWORDは、Oracle Application Serverの管理者パスワードです。

    • DATASOURCE_PASSWORDは、Oracle Identity Managerインストールのデータベース・パスワードです。

  7. 必要な場合は、既存のファイルを上書きして、PATCH/xellerate/ext/ojdbc14.jarファイルをOAS_HOME/jlib/ディレクトリにコピーします。

  8. Oracle Application Serverを再起動します。

  9. Re-Issue Audit Message Taskスケジュール済タスクを実行して、aud_jms表にあるすべての保留中の監査メッセージが処理されるようにします。


    注意:

    Re-Issue Audit Message Taskスケジュール済タスクを実行する際は、データベースおよびOracle Identity Managerがアップグレードされていることを確認してください。Design Consoleを使用してスケジュール済タスクを実行している場合は、Design Consoleがアップグレードされていることも確認してください。

5.6 カスタム・コードの移行

カスタムJavaコードを、リリース9.0.3.2環境から新しいリリース9.1.0環境に移行できます。リリース9.0.3.2環境からカスタムJavaコードを移行する前に、OIM_HOME/xellerate/lib/ディレクトリにあるリリース9.1.0のライブラリを使用してカスタムJavaコードを再コンパイルする必要があります。

リリース9.0.3.2のカスタムJavaコードを最初にコンパイルした統合開発環境(Eclipse、JDeveloper、WASDまたはコマンドラインjavac)で、すべてのカスタムJavaコードをリリース9.1.0のライブラリを使用して再コンパイルします。

リリース9.0.3.2から移行して、再コンパイル後にリリース9.1.0で再利用できるカスタム・アイテムのリストを次に示します。


注意:

クラスタ環境では、リリース9.1.0ライブラリを使用してカスタマイズされた次のアイテムを再コンパイルしてから、クラスタの各メンバー・ノードに再コンパイル済のコードをコピーします。

5.7 アップグレード後の構成

次に示す、アップグレード後の構成手順を実行する必要があります。

5.7.1 ユーザー・プロファイル監査レベルの設定

監査レベルを変更する場合は、次の手順を実行します。

  1. 必要に応じて、レポート用セカンダリ・データソースを定義します。


    関連項目:

    セカンダリ・データソースの定義の詳細は、『Oracle Identity Manager Audit Report開発者ガイド』を参照してください。

  2. Oracle Identity Managerインストールが稼働しているアプリケーション・サーバーを起動します。

  3. 監査レベルを設定します。設定できる値は次のとおりです。レベルの高い順に示します。

    • Process Task

    • Resource Form

    • Resource

    • Membership

    • Core

    • None

  4. 監査レベルを指定するには、次のようにします。

    1. Design Consoleに管理者としてログインします。

    2. 「System Configuration」フォームに移動します。

    3. XL.UserProfileAuditDataCollectionを探し、値をResource Form、またはこの手順の手順3にリストされている適切な監査レベルに設定します。

  5. セカンダリ・レポート・データ・ストアにユーザー・プロファイル監査データを収集するには、次のようにします。

    1. Design Consoleに管理者としてログインします。

    2. 「System Configuration」フォームに移動します。

    3. XL.UserProfileAuditInSecondaryDSを探し、値をTRUEに設定します。

5.7.2 ユーザー・スナップショットの生成

ユーザー・スナップショット生成の詳細は、付録E「ユーザー・スナップショットの生成」を参照してください。

5.7.3 GPAスナップショットの生成

GPAスナップショット生成の詳細は、付録G「GPAスナップショットの生成」を参照してください。

5.7.4 例外ベースのレポートへのデータのロード

例外ベースのレポートにデータをロードするには、UPAフォーム・データ・アップグレード・ユーティリティを実行します。UPAフォーム・データ・アップグレード・ユーティリティの詳細は、付録F「UPAフォーム・データ・アップグレード・ユーティリティ」を参照してください。

5.8 診断ダッシュボードのアップグレード

Oracle Application Serverで、リリース9.0.3.2の診断ダッシュボードXIMDDアプリケーションをリリース9.1.0の診断ダッシュボードにアップグレードするには、次のようにします。

  1. Oracle Application Server管理コンソールを使用して既存のXIMDDアプリケーションを削除します。

  2. PATCH/DiagnosticDashboard/ディレクトリにあるリリース9.1.0のXIMDD.warファイルを使用して、XIMDDアプリケーションの新しいインスタンスをインストールします。


    関連項目:

    診断ダッシュボードの詳細は、『Oracle Identity Manager管理およびユーザー・コンソール・ガイド』の「診断ダッシュボード」を参照してください。