4 WebSphereアプリケーション・サーバーでのリリース9.0.2からリリース9.0.3へのアップグレード

この章では、WebSphereアプリケーション・サーバーでのリリース9.0.2からリリース9.0.3へのアップグレードについて説明します。Oracle Identity Managerの他の旧リリースからはリリース9.0.3にアップグレードしないでください。

注意: 新たにOracle Identity Managerを購入し、リリース9.0.3がこの製品の最初のデプロイである場合は、この章を読む必要はありません。リリース9.0.3インストーラ・プログラムを実行してリリース9.0.3をデプロイしてください。

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

注意: このドキュメントではこの一時ディレクトリを<PATCH>と呼びます。

この項では、WebSphereにおいてリリース9.0.2からリリース9.0.3にアップグレードする方法を次の手順で説明します。

1. WebSphere 5.1.1.12へのアップグレード

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

   • 既存データベース・インスタンスのインプレース・アップグレード

   • アップグレード用の新しいデータベース・インスタンスの作成

3. アップグレードの準備

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

   2. 管理およびユーザー・コンソールのアップグレード準備

   3. Design Consoleのアップグレード準備

   4. Remote Managerのアップグレード準備

4. アップグレードの実行

   1. Design Console xlDataObjectBeans.jarの更新

5. リリース9.0.2カスタム・コードの移行

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

WebSphere 5.1.1.12へのアップグレード

リリース9.0.3は、WebSphere 5.1.1.12アプリケーション・サーバーでの動作が保証されています。リリース9.0.3にアップグレードする前にWebSphere 5.1.1.12にアップグレードする必要があります。リリース9.0.3 Design Consoleに関してもWebSphereクライアントを5.1.1.12にアップグレードしてください。

注意: WebSphereクラスタでは、Network Deployment Managerとすべてのノード・マネージャも5.1.1.12にアップグレードする必要があります。

WebSphere 5.1.1.12へのアップグレードの詳細は、WebSphereアプリケーション・サーバーのドキュメントを参照してください。

注意: WebSphere 5.1.1.12アプリケーション・サーバーにアップグレードする際には、米国夏時間の変更に伴って必要になるWebSphereアプリケーション・サーバーの変更に関して、IBMの情報を確認する必要があります。次のIBM Support and downloads Webサイトを参照してください。 http://www.ibm.com/support/us/

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

次のいずれかの方法を選択して、Oracle Identity Managerリリース9.0.2デプロイメントで使用していたデータベースをアップグレードします。

• リリース9.0.2に対して構成されている既存データベースのインプレース・アップグレードを実行します。「既存データベース・インスタンスのインプレース・アップグレード」を参照してください。

• リリース9.0.3用にデータベースの新しいインスタンスを作成し、リリース9.0.2デプロイメントで使用していたデータを新しいデータベースにインポートしてから、アップグレードを実行します。「アップグレード用の新しいデータベース・インスタンスの作成」を参照してください。

データベースをアップグレードする前に次の手順を実行します。

1. Oracle Identity Managerリリース9.0.3アップグレード・パッケージの内容をデータベース・マシンの一時ディレクトリに抽出します。このドキュメントでは、この一時ディレクトリを<PATCH>と呼びます。

2. <PATCH>ディレクトリのスクリプトの実行権限を有効にします。

既存データベース・インスタンスのインプレース・アップグレード

この方法は、データベースはそのままでデータベース・スキーマをアップグレードすることで、既存のリリース9.0.2データベース・インスタンスをアップグレードします。

1. 既存データベースのバックアップを作成します。データベースに応じて、OracleデータベースまたはSQL Server提供のエクスポートまたはバックアップ・ユーティリティを使用して、本番データベースの完全なバックアップを実行します。

   アップグレード・プロセスでデータが損失しないようにするため、本番データベースのバックアップには、少なくともOracle Identity Managerリリース9.0.2データベース・インスタンスの完全なエクスポートまたはバックアップを含めます。アップグレードが失敗した場合は、このバックアップを使用してデータベースを元の状態にリストアすることができます。

2. データベース・ベンダーのドキュメントや、該当するアプリケーション・サーバー用のOracle Identity Managerのインストレーションおよびアップグレード・ガイドを参照して、データベースが適切に構成されていることを確認します。

3. データベースとオペレーティング・システムに応じて次のいずれかのスクリプトを使用して、データベース・スキーマをOracle Identity Managerリリース9.0.2からリリース9.0.3にアップグレードします。データベースが存在するマシンでスクリプトを実行してください。

   
   

   注意: oim_db_upg_902_to_903スクリプトでは、Oracleで必要なストアド・プロシージャもアップグレードされます。

   
   

   UNIXおよびLinux上のOracle:

   1. Oracle Identity Managerリリース9.0.2用のデータベースがインストールされているシステムで次のスクリプトを実行し、データベース・スキーマをアップグレードします。

      <PATCH>/db/oracle/Scripts/oim_db_upg_902_to_903.sh
      
      

   2. oim_db_upg_902_to_903.shスクリプトで表示されるプロンプトに従って、Oracleデータベースの適切な情報を入力します。

   Windows上のOracle:

   リリース9.0.2用のデータベースがインストールされているシステムで次のバッチ・スクリプトを実行し、データベース・スキーマをアップグレードします。

   <PATCH>\db\oracle\Scripts\oim_db_upg_902_to_903.bat
   
   

   コマンドラインでは、Oracle oim_db_upg_902_to_903.batスクリプトを次のように使用します。

   oim_db_upg_902_to_903.bat <ORACLE_SID> <ORACLE_HOME> <ORACLE_XELL_USER> <ORACLE_XELL_USER_PWD> <PATCH>
   
   

   SQL Server:

   <PATCH>\db\SQLServer\Scripts\upg_902_to_903.batバッチ・ファイルを実行します。このスクリプトの実行の詳細は、付録A「SQL Serverアップグレード・スクリプトの実行」を参照してください。

4. 次の手順を実行して、データベースのストアド・プロシージャを再コンパイルします。

   
   

   注意: Oracleデータベースを使用している場合は、この手順は省略できます。oim_db_upg_902_to_903スクリプトの実行によりOracleで必要なストアド・プロシージャがすでに作成されているためです。

   
   

   SQL Server:

   1. プレーン・テキスト・エディタを起動して、次のファイルを開きます。

      <PATCH>\db\SQLServer\StoredProcedures\compile_all_XL_SP.bat
      
      

   2. compile_all_XL_SP.batのSequential Listsセクションにリストされているすべてのストアド・プロシージャで、文字列@sysuserをデータベース・ユーザー名で置き換えてください。SQL Serverでは、ストアド・プロシージャから起動されるファンクションをデータベース・ユーザー名（所有者）で修飾する必要があるため、この処理を行います。@記号も含めて@sysuser文字列全体を置き換えてください。

   3. 次のスクリプトを実行します。

      <PATCH>\db\SQLServer\StoredProcedures\compile_all_XL_SP.bat
      
      

      このスクリプトの実行の詳細は、付録A「SQL Serverアップグレード・スクリプトの実行」を参照してください。

5. データベースに応じて次の手順を実行し、Oracle Identity Manager監査およびコンプライアンス・モジュールをアップグレードします。

   Oracle:

   1. Oracle Identity Managerリリース9.0.2データベース・スキーマ所有者の資格証明を使用してSQL*Plusにログインします。

   2. 次のスクリプトを実行します。

      <PATCH>/db/oracle/Scripts/Oracle_Enable_XACM.sql
      
      

   SQL Server:

   次のスクリプトを実行します。

   <PATCH>\db\SQLServer\Scripts\SQLServer_Enable_XACM.bat
   
   

   このスクリプトの実行の詳細は、付録A「SQL Serverアップグレード・スクリプトの実行」を参照してください。

6. ユーザー・プロファイル監査機能とレポート機能では、特定のメタデータがデータベースにロードされていることが必要です。Oracle Identity Managerサーバーのホスト・マシンのオペレーティング・システムに応じて次のいずれかのコマンドを実行して、Oracle Identity Managerメタデータをデータベースにロードします。

   Windows:

   次の.batファイルを実行します。

   <PATCH>\db\Utilities\LoadXML.bat
   
   

   UNIXおよびLinux:

   次のスクリプトを実行します。

   <PATCH>/db/Utilities/LoadXML.sh
   
   

   このスクリプトの実行の詳細は、付録B「データベースへのメタデータのロード」を参照してください。

アップグレード用の新しいデータベース・インスタンスの作成

この方法では、リリース9.0.3用に新しいデータベース・インスタンスを作成し、リリース9.0.2デプロイメントで使用していたデータを新しいデータベースにインポートしてから、アップグレードを実行します。ロールバックが必要な場合は、この方法によって、現在作業中のデータベースを引き続き利用できるようになります。新しいアップグレード済データベース・インスタンスを作成するには、次の手順を実行します。

1. 既存データベースのバックアップを作成します。データベースに応じて、OracleデータベースまたはSQL Server提供のエクスポートまたはバックアップ・ユーティリティを使用して、本番データベースの完全なバックアップを実行します。

   アップグレード・プロセスでデータが損失しないようにするため、本番データベースのバックアップには、少なくともOracle Identity Managerリリース9.0.2データベース・インスタンスの完全なエクスポートまたはバックアップを含めます。アップグレードが失敗した場合は、このバックアップを使用してデータベースを元の状態にリストアすることができます。

2. データベース・ベンダーのドキュメントや、該当するアプリケーション・サーバー用のOracle Identity Managerのインストレーションおよびアップグレード・ガイドを参照して、新しいデータベースを作成します。

   
   

   注意: 新しいデータベースを作成する場合は、元のデータベース・インスタンスで使用していたユーザー名とパスワードを新しいデータベースの資格証明として指定してください。

   
   

3. 該当のデータベースで提供されるインポート・ユーティリティを使用して、リリース9.0.2データベースからエクスポートしたデータを、新たに作成したリリース9.0.3データベースにインポートします。これによって、元のデータベース・インスタンスと同一のコピーが作成されます。

4. データベースとオペレーティング・システムに応じて次のいずれかのスクリプトを使用して、データベース・スキーマをOracle Identity Managerリリース9.0.2からリリース9.0.3にアップグレードします。データベースが存在するマシンでスクリプトを実行してください。

   UNIXおよびLinux上のOracle:

   新しいリリース9.0.3データベース・システムで次のスクリプトを実行し、プロンプトに従って適切な情報を入力して、データベース・スキーマをアップグレードします。

   <PATCH>/db/oracle/Scripts/oim_db_upg_902_to_903.sh
   

   
   

   注意: oim_db_upg_902_to_903スクリプトでは、Oracleで必要なストアド・プロシージャもアップグレードされます。

   
   

   Windows上のOracle:

   新しいリリース9.0.3データベース・システムで次のバッチ・スクリプトを実行し、データベース・スキーマをアップグレードします。

   <PATCH>\db\oracle\Scripts\oim_db_upg_902_to_903.bat
   
   

   コマンドラインでは、Oracle oim_db_upg_902_to_903.batスクリプトを次のように使用します。

   oim_db_upg_902_to_903.bat <ORACLE_SID> <ORACLE_HOME> <ORACLE_XELL_USER> <ORACLE_XELL_USER_PWD> <PATCH>
   
   

   SQL Server:

   次のスクリプトを実行します。

   <PATCH>\db\SQLServer\Scripts\upg_902_to_903.bat
   
   

   このスクリプトの実行の詳細は、付録A「SQL Serverアップグレード・スクリプトの実行」を参照してください。

5. 次の手順を実行して、データベースのストアド・プロシージャを再コンパイルします。

   
   

   注意: Oracleデータベースを使用している場合は、この手順は省略できます。oim_db_upg_902_to_903スクリプトの実行によりOracleで必要なストアド・プロシージャがすでに作成されているためです。

   
   

   SQL Server:

   1. プレーン・テキスト・エディタを起動して、次のスクリプトを開きます。

      <PATCH>\db\SQLServer\StoredProcedures\compile_all_XL_SP.bat
      
      

   2. compile_all_XL_SP.batのSequential Listsセクションにリストされているすべてのストアド・プロシージャで、文字列@sysuserをデータベース・ユーザー名で置き換えてください。SQL Serverでは、ストアド・プロシージャから起動されるファンクションをデータベース・ユーザー名（所有者）で修飾する必要があるため、この処理を行います。@記号も含めて@sysuser文字列全体を置き換えてください。

   3. 次のスクリプトを実行します。

      <PATCH>\db\SQLServer\StoredProcedures\compile_all_XL_SP.bat
      
      

      このスクリプトの実行の詳細は、付録A「SQL Serverアップグレード・スクリプトの実行」を参照してください。

6. データベースに応じて次の手順を実行し、Oracle Identity Manager監査およびコンプライアンス・モジュールをアップグレードします。

   Oracle:

   1. Oracle Identity Managerリリース9.0.2データベース・スキーマ所有者の資格証明を使用してSQL*Plusにログインします。

   2. 次のスクリプトを実行します。

      <PATCH>/db/oracle/Scripts/Oracle_Enable_XACM.sql
      
      

   SQL Server:

   次のスクリプトを実行します。

   <PATCH>\db\SQLServer\Scripts\SQLServer_Enable_XACM.bat
   
   

   このスクリプトの実行の詳細は、付録A「SQL Serverアップグレード・スクリプトの実行」を参照してください。

7. ユーザー・プロファイル監査機能とレポート機能では、特定のメタデータがデータベースにロードされていることが必要です。Oracle Identity Managerサーバーのホスト・マシンのオペレーティング・システムに応じて次のいずれかのコマンドを実行して、Oracle Identity Managerメタデータをデータベースにロードします。

   Windows:

   次のスクリプトを実行します。

   <PATCH>\db\Utilities\LoadXML.bat
   
   

   UNIXおよびLinux:

   次のスクリプトを実行します。

   <PATCH>/db/Utilities/LoadXML.sh
   
   

   このスクリプトの実行の詳細は、付録B「データベースへのメタデータのロード」を参照してください。

アップグレードの準備

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

• Oracle Identity Managerサーバー

• 管理およびユーザー・コンソール

• Design Console

• Remote Manager

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

Oracle Identity Managerサーバーのリリース9.0.3へのアップグレードを準備します。この項の説明に従って、リリース9.0.2のライブラリ、スクリプトおよび構成ファイルを更新します。

注意: WebSphereクラスタでリリース9.0.3にアップグレードする場合は、NDMホスト・マシンでこの項の手順を実行します。

1. Oracle Identity Managerリリース9.0.3アップグレード・パッケージの内容を、Oracle Identity Managerリリース9.0.2サーバーがインストールされているマシンの一時ディレクトリに抽出します。このドキュメントでは、この一時ディレクトリを<PATCH>と呼びます。

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

   • <XL_HOME>\xellerate\config

   • <XL_HOME>\xellerate\DDTemplates

   • <XL_HOME>\xellerate\lib

   • <XL_HOME>\xellerate\setup

   • <XL_HOME>\xellerate\webapp

   • <XL_HOME>\xellerate\ext

   • <XL_HOME>\xellerate\connectorResources

   • <XL_HOME>\documentation

3. 次の表の「コピー元」列の場所にあるディレクトリとファイルを「コピー先」列の場所にコピーします。必要であれば、「コピー先」の場所にある既存のファイルを上書きします。

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

   コピー元	コピー先
   <PATCH>\xellerate\DDTemplates\	<XL_HOME>\xellerate\DDTemplates\
   <PATCH>\xellerate\lib\	<XL_HOME>\xellerate\lib\
   <PATCH>\xellerate\webapp\	<XL_HOME>\xellerate\webapp\
   <PATCH>\documentation\	<XL_HOME>\documentation
   <PATCH>\xellerate\config\	<XL_HOME>\xellerate\config\
   <PATCH>\xellerate\ext\	<XL_HOME>\xellerate\ext\
   <PATCH>\xellerate\GTC\	<XL_HOME>\xellerate\GTC\
   <PATCH>\xellerate\connectorResources\	<XL_HOME>\xellerate\connectorResources\

   
   

4. 次のファイルを<PATCH>\xellerate\setupディレクトリから<XL_HOME>\xellerate\setupディレクトリにコピーします。

   • setup.xml

   • patch_websphere.cmd

   • patch_websphere.sh

   • websphere-setup.xml

5. <XL_HOME>/xellerate/setup/ディレクトリにあるオペレーティング・システム対応のパッチ・スクリプトを、次の表のように編集します。

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

   オペレーティング・システム	編集するスクリプト	編集するパラメータ
   Windows	patch_websphere.cmd	@java_homeをJavaインストール・ディレクトリのパスで置き換えます。 @wasHomeをWebSphereインストール・ディレクトリのパスで置き換えます。 @locをOracle Identity Managerサーバーのインストール・ディレクトリのパスで置き換えます。
   UNIXおよびLinux	patch_websphere.sh	@java_homeをJDKを含むディレクトリのパスで置き換えます。 @locをOracle Identity Managerサーバーのインストール・ディレクトリのパスで置き換えます。

   
   

6. <XL_HOME>/xellerate/config/ディレクトリにある、既存のリリース9.0.2 Oracle Identity Managerサーバーのxlconfig.xml構成ファイルを、リリース9.0.3の新しいキャッシュ関連設定で更新します。次の手順を実行します。

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

   2. 次のXMLエントリを</Cache>パラメータの前に追加します。

      <LinguisticSort>
               <Enable>true</Enable>
               <ExpireTime>-1</ExpireTime>
      </LinguisticSort>
      
      

管理およびユーザー・コンソールのアップグレード準備

管理およびユーザー・コンソールの一部のファイルはリリース9.0.3で変更されています。リリース9.0.2の管理およびユーザー・コンソールをカスタマイズしている場合、つまりリリース9.0.2管理およびユーザー・コンソールの出荷時のデフォルトを変更している場合は、リリース9.0.3の新しい管理およびユーザー・コンソールのファイルにカスタマイズ内容を追加する必要があります。

リリース9.0.2の管理およびユーザー・コンソールをカスタマイズした場合は、付録C「カスタマイズした管理およびユーザー・コンソールのアップグレード」を参照してください。

リリース9.0.2の管理およびユーザー・コンソールをカスタマイズしていない場合は、この項をスキップし、「Design Consoleのアップグレード準備」を参照してアップグレード・プロセスを進めます。

Design Consoleのアップグレード準備

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

1. 次のファイルとディレクトリのバックアップを作成します。

   • <XL_DC_HOME>\xlclient\XLDesktopClient.ear

   • <XL_DC_HOME>\xlclient\CustomClient.zip

   • <XL_DC_HOME>\xlclient\xlFvcUtil.ear

   • <XL_DC_HOME>\xlclient\lib

   • <XL_DC_HOME>\xlclient\ext

   • <XL_DC_HOME>\xlclient\fvcutil_websphere.cmd

   • <XL_DC_HOME>\documentation

2. 次の表の「コピー元」列の場所にあるディレクトリとファイルを「コピー先」列の場所にコピーします。必要であれば、「コピー先」の場所にある既存のファイルを上書きします。

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

   コピー元	コピー先
   <PATCH>\xlclient\XLDesktopClient.ear	<XL_DC_HOME>\xlclient\
   <PATCH>\xlclient\CustomClient.zip	<XL_DC_HOME>\xlclient\
   <PATCH>\xlclient\xlFvcUtil.ear	<XL_DC_HOME>\xlclient\
   <PATCH>\xlclient\lib\	<XL_DC_HOME>\xlclient\lib\
   <PATCH>\xlclient\ext\	<XL_DC_HOME>\xlclient\ext\
   <PATCH>\xlclient\fvcutil_websphere.cmd	<XL_DC_HOME>\xlclient\
   <PATCH>\documentation\	<XL_DC_HOME>\documentation\

   
   

Remote Managerのアップグレード準備

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

1. <XL_RM_HOME>\xlremote\lib\ディレクトリのバックアップを作成します。

2. <PATCH>\xlremote\lib\ディレクトリの内容を<XL_RM_HOME>\xlremote\lib\ディレクトリにコピーします。必要であれば上書きします。

アップグレードの実行

既存のOracle Identity Managerリリース9.0.2デプロイメントからOracle Identity Managerリリース9.0.3へのアップグレードでは、最新ライブラリから新しいEAR（Enterprise Application Archive）ファイルがアセンブルされ、そのEARが再デプロイされます。

単一のWebSphereアプリケーション・サーバーおよびWebSphereクラスタでのリリース9.0.3へのアップグレードを行うには、次の手順を実行します。

1. パッチ・ユーティリティに関してNDM/WASへのSOAP通信を有効にします。<NDM|WAS_INSTALL_DIR>\properties\soap.client.propsを編集して、次のプロパティでセキュリティを有効にします。

   com.ibm.SOAP.securityEnabled=true
   com.ibm.SOAP.loginUserid=xelsysadm
   com.ibm.SOAP.loginPassword=xelsysadm
   
   

2. 次のファイルを<PATCH>\xellerate\ext\ディレクトリから<WEBSPHERE_HOME>\AppServer\lib\ext\ディレクトリにコピーします。必要であれば既存のファイルを上書きします。

   WebSphereクラスタの場合、次のファイルを<PATCH>\xellerate\ext\ディレクトリから、すべてのクラスタ参加者の<WEBSPHERE_HOME>\AppServer\lib\ext\ディレクトリにコピーします。必要であれば既存のファイルを上書きします。

   • ojdbc14.jar

   • Uix2.jar

   • Uix2-dbg.jar

3. 単一のWebSphereアプリケーション・サーバーの場合、WebSphereアプリケーション・サーバーが実行していることを確認して、次のいずれかのpatch_websphereスクリプトを実行します。

   WebSphereクラスタの場合、クラスタのすべてのノードでWebSphereアプリケーション・サーバーが実行しており、Deployment ManagerがNDMホストで実行していることを確認します。NDMホストで次のいずれかのpatch_websphereスクリプトを実行します。

   
   

   注意: patch_websphereスクリプトの実行が正常に終了した後で、patch_websphereスクリプトを実行したコンソールまたは端末に予期しない出力が表示されることがあります。この出力は無視しても問題ありません。

   
   

   Windows:

   • WebSphere管理者のパスワードとOracle Identity Managerデータベース・ユーザーのパスワードをコマンド引数として使用して、<XL_HOME>\xellerate\setup\patch_websphere.cmdを実行します。次に例を示します。

     <XL_HOME>\xellerate\setup\patch_websphere.cmd <WebSphere_admin_password> <database_user_password>
     
     

   UNIXおよびLinux:

   • WebSphere管理者のパスワードとOracle Identity Managerデータベース・ユーザーのパスワードをコマンド引数として使用して、<XL_HOME>/xellerate/setup/patch_websphere.shを実行します。次に例を示します。

     $ <XL_HOME>/xellerate/setup/patch_websphere.sh -<WebSphere_admin_password> -<database_user_password>
     
     

4. 単一のWebSphereアプリケーション・サーバーの場合、patch_websphereスクリプトを実行した後でアプリケーション・サーバーを停止して再起動し、リリース9.0.3へのアップグレードを完了します。

   WebSphereクラスタの場合、次の順序でクラスタ・コンポーネントを停止し、次の手順に進みます。

   1. 管理コンソールを使用してクラスタを停止します。

   2. 管理コンソールを使用してJMSサーバーを停止します。

   3. NDMを停止します。

5. 次の手順を実行して、WebSphereクラスタでのリリース9.0.3へのアップグレードを完了します。

   1. NDMホストの<XL_HOME>ディレクトリを、ディレクトリ階層構造を維持したまま、JMSホストを含むすべてのクラスタ参加者にコピーします。

   2. NDMホスト、JMSホストおよびすべてのクラスタ参加者でsetupWebSphereCustomRegistry.cmdスクリプトを実行します。setupWebSphereCustomRegistry.cmdスクリプトは<XL_HOME>/xellerate/setup/ディレクトリにあります。setupWebSphereCustomRegistry.cmdスクリプトを次のように実行します。<WEBSPHERE_HOME>はWebSphereのホーム・ディレクトリです。

      setupWebSphereCustomRegistry.cmd <WEBSPHERE_HOME>
      
      

   3. 管理コンソールを使用してNDMおよびJMSサーバーを起動し、クラスタを起動して、リリース9.0.3へのクラスタのアップグレードを完了します。

Design Console xlDataObjectBeans.jarの更新

リリース9.0.3へのアップグレードを実行したら、次の手順を使用してDesign Console xlDataObjectBeans.jarファイルを更新する必要があります。

1. WebSphere管理コンソールにログインします。

2. 「Applications」をクリックし、「Enterprise Applications」をクリックします。

3. 「Xellerate」アプリケーション・オプションを選択し、「Export」をクリックします。

4. 生成されたxellerate.earを保存します。

5. xellerate.earからxlDataObjectBeans.jarを抽出します。

6. xlDataObjectBeans.jarを<XL_DC_HOME>\xlclient\lib\ディレクトリにコピーします。

リリース9.0.2カスタム・コードの移行

リリース9.0.2環境で使用していたカスタム・コードは、新たにアップグレードしたリリース9.0.3環境で再利用できます。

注意: リリース9.0.2環境からカスタム・コードを移行する前に、Oracle Identity Managerリリース9.0.3のライブラリを使用してカスタム・コードを再コンパイルする必要があります。

次に、リリース9.0.3ライブラリを使用して再コンパイルした後に、リリース9.0.2環境から移行してリリース9.0.3で再利用できるカスタム・コードのリストを示します。

注意: クラスタ環境では、リリース9.0.3ライブラリを使用して次のカスタム・コードを再コンパイルしてから、再コンパイル済のコードをクラスタの他の参加者にコピーします。

• カスタムjavaコード（統合開発環境、すなわちEclipse、JDeveloper、WASDまたはコマンドラインjavac、およびリリース9.0.3ライブラリを使用して再コンパイルしたもの）。

• 機能するOracle Identity Managerリリース9.0.2アダプタにバインドされているカスタムjavaライブラリ（リリース9.0.3ライブラリを使用して再コンパイルしたもの）。アダプタは再コンパイルする必要はありません。

• カスタム・スケジュール済タスク（リリース9.0.3ライブラリを使用して再コンパイルしたもの）。

• カスタム・イベント・ハンドラ（リリース9.0.3ライブラリを使用して再コンパイルしたもの）。

• Oracle Identity Managerリリース9.0.2 APIを使用して構築されたカスタム・クライアント。Oracle Identity Managerリリース9.0.3 APIとの互換性を持つように更新する必要があります。

  たとえば、廃止されて新たに置き換えられたAPIもあります。Oracle Identity Managerリリース9.0.2からリリース9.0.3へのAPIの変更の詳細は、リリース9.0.3の『Oracle Identity Managerリリース・ノート』を参照してください。

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

WebSphereでリリース9.0.3診断ダッシュボードにアップグレードする前に、既存のリリース9.0.2診断ダッシュボードXIMDDアプリケーションを削除する必要があります。次の手順を使用します。

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

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

   アプリケーション・サーバーに診断ダッシュボードをインストールする詳細な手順は、『Oracle Identity Manager管理およびユーザー・コンソール・ガイド』の「診断ダッシュボードの使用」、診断ダッシュボードのインストールに関する項を参照してください。