6.2 WebSphere環境の環境設定

6.2.1 データソースの作成

データベースをWebSphereで使用するように設定するには、JDBCプロバイダとデータソースを作成する必要があります。このセクションでは、プロバイダとデータソースを作成する方法について説明します。

JDBCプロバイダを作成するには

  1. [Integrated Solutions Console]ページの左側にある[リソース]を展開します。

  2. [JDBC]を展開します。

  3. [JDBCプロバイダ]をクリックします。

  4. [有効範囲]を展開します。

  5. [ノード=IDMDBGMCSL11Node01, サーバー=server1]を選択します。

  6. [新規作成]ボタンをクリックします。

  7. [データベースタイプ]を選択します(たとえば、DB2など)。

  8. [次へ]をクリックします。

  9. JDBCのクラスパス情報を入力します。

  10. [次へ]をクリックします。

  11. [完了]をクリックします。

  12. [保存]リンクをクリックします。

データソースを作成するには

  1. ページの左側にある[リソース]を展開します。

  2. [JDBC]を展開します。

  3. [データソース]をクリックします。

  4. [有効範囲]を展開します。

  5. [ノード=IDMDBGMCSL11Node01, サーバー=server1]を選択します。

  6. [新規]ボタンをクリックします。

  7. データソース名とJNDI名を入力します(たとえば、両方に「IDMUADataSource」と入力します)。

  8. [次へ]をクリックします。

  9. [既存JDBCプロバイダを選択]をクリックします。

  10. 上で作成したJDBCプロバイダを選択します。

  11. [次へ]をクリックします。

  12. データソースに必要なデータベース情報(データソース名、サーバ名、ポート、ユーザ名、およびパスワード)を入力します。

  13. [次へ]をクリックします。

  14. セキュリティエイリアス情報を入力するか、デフォルトのままにします。

  15. [次へ]をクリックします。

  16. [完了]をクリックします。

  17. [保存]をクリックします。

  18. 名前の左側にあるチェックボックスをオンにして新しいデータソースを選択します。

  19. [テスト接続]ボタンをクリックし、[成功]という結果が返されるのを確認します。

6.2.2 WARファイルの展開

WebSphere展開ツールを使用して、WARファイルを展開します。

6.2.3 ユーザアプリケーション環境設定ファイルとJVMシステムプロパティの追加

WebSphereを正常にインストールするには、次の手順が必要です。

  1. ユーザアプリケーションのインストールディレクトリから、sys-configuration-xmldata.xmlファイルを、WebSphereサーバをホストしているマシン上のディレクトリ(例: /UserAppConfigFiles)にコピーします。

    ユーザアプリケーションのインストールディレクトリとは、ユーザアプリケーションをインストールしたディレクトリです。

    重要:Configupdate.shを実行すると、このファイルのローカルバージョンがアップデートされます。今後、configupdate.shを実行する場合は、もう一度ファイルをコピーして、WebSphereに付属するバージョンのこのファイルをアップデートする必要があります。予防策として、このファイルの全バージョンのバックアップを作成することもお勧めします。

  2. JVMシステムプロパティで、sys-configuration-xmldata.xmlファイルのパスを設定します。これを行うには、WebSphere管理コンソールに管理者ユーザとしてログインしてください。

  3. 左側のパネルから、[サーバ]>[アプリケーションサーバ]の順に移動します。

  4. サーバリストでサーバ名(例: server1)をクリックします。

  5. 右側の設定リストで、[Server Infrastructure]の下にある[Java and Process Management]に移動します。

  6. リンクを展開して、[Process Definition]を選択します。

  7. [Additional Properties]リストの下にある[Java Virtual Machine]を選択します。

  8. [JVM]ページの[Additional Properties]という見出しの下にある[Custom Properties]を選択します。

  9. [新規]をクリックして、新しいJVMシステムプロパティを追加します。

    1. [名前]には、「extend.local.config.dir」を指定します。

    2. [値]には、インストール時に指定したインストールフォルダ(ディレクトリ)の名前を入力します。

      インストーラはこのフォルダにsys-configuration-xmldata.xmlファイルを書き込みます。

    3. [説明]には、プロパティの説明(「sys-configuration-xmldata.xmへのパス」など)を指定します。

    4. [OK]をクリックしてプロパティを保存します。

  10. [新規]をクリックして、別の新しいJVMシステムプロパティを追加します。

    1. [名前]には、「idmuserapp.logging.config.dir」を指定します。

    2. [値]には、インストール時に指定したインストールフォルダ(ディレクトリ)の名前を入力します。

    3. [説明]には、プロパティの説明(「idmuserapp_logging.xmlへのパス」など)を指定します。

    4. [OK]をクリックしてプロパティを保存します。

      idmuserapp-logging.xmlファイルは[ユーザアプリケーション]>[管理]>[アプリケーション環境設定]>[ログ]を使用して変更を保持するまでは存在しません。

メモ:クラスタ環境を設定する予定の場合は、JVMシステムプロパティとしてワークフローエンジンIDを明示的に指定する必要もあります。エンジンIDを指定するには、com.novell.afw.wf.engine-idという名前のシステムプロパティを追加し(その他のJVMシステムプロパティを定義する際に使用したステップに従います)、IDに設定したい任意の値を指定します。

6.2.4 共有ライブラリの設定

RBPMのバージョン4.0.2でWebSphere 7.0を使用している場合、RBPMのこのリリースでは、いくつかのJARファイルが、入手可能な最新バージョンにアップグレードされていることに注意する必要があります。共有ライブラリをRBPM用に設定しないと、WebSphereに付属するJARファイルでクラスのロードに問題が発生します。共有ライブラリを設定して、WebSphereがこれらのJARファイルのRBPMバージョンを使用するようにします。

WebSphereでクラスのロードに問題がある場合、次の種類の例外として明らかになります。

  • ClassCastException

  • ClassNotFoundException

  • NoClassDefFoundException

  • UnsatisfiedLinkError

  • LinkageError

共有ライブラリを設定するには

  1. 左側のナビゲーションメニューで[環境]をクリックします。

  2. [共用ライブラリ]をクリックします。

  3. [新規作成]ボタンをクリックします。

  4. 名前を入力します(「IDMUAクラスパス」など)。

  5. [クラスパス]フィールドに必要なJARファイルのリストを入力します。

    • antlr.jar

    • log4j.jar

    • commons-logging.jar

      メモ:ApacheのサイトからこのJARファイルをダウンロードする必要があります。

    • xalan.jar

    • xercesImpl.jar

    • xsltc.jar

    • jaxb-impl.jar

    • IDMselector.jar

  6. Use an isolated class loader for this shared library]を選択します。

  7. [OK]をクリックします。

  8. [保存]リンクをクリックします。

6.2.5 新しいクラスローダへの共有ライブラリの適用

共有ライブラリを新しいクラスローダに適用する必要があります。

共有ライブラリを新しいクラスローダに適用するには

  1. セクション 6.2.4, 共有ライブラリの設定の説明に従って、共有ライブラリを作成します。

  2. Application servers]>[サーバ名]>[Class loader]の順に選択します。

    メモ:デフォルトでは、このオプションは[Java and Process Management]セクションの下で縮小されています。

  3. New]をクリックして新しいクラスローダを作成し、[Classes loaded with local class loader first (parent last)]を選択します。

  4. 適用]をクリックします。

  5. Shared library references]を選択します。

  6. Add]をクリックして、先ほど作成した共有ライブラリを選択します。

  7. 適用]をクリックします。

  8. [OK]をクリックします。

  9. 保存]をクリックしてマスタ環境設定に変更を保存します。

6.2.6 WebSphereキーストアへのeDirectoryルート認証局のインポート

  1. WebSphereサーバをホストするマシンに、eDirectoryルート認証局の証明書をコピーします。

    ユーザアプリケーションのインストール手順では、ユーザアプリケーションをインストールするディレクトリに証明書がエクスポートされます。

  2. 証明書をWebSphereのキーストアにインポートします。この作業は、WebSphereの管理者コンソール(WebSphere管理者コンソールを使用した証明書のインポート)またはコマンドライン(コマンドラインを使用した証明書のインポート)を使用して実行できます。

WebSphere管理者コンソールを使用した証明書のインポート

  1. WebSphere管理者コンソールに管理者ユーザとしてログインします。

  2. 左側のパネルから、[セキュリティ]>[SSL Certificate and Key Management]の順に移動します。

  3. 右側の設定リストで、[関連項目]の下にある[キーストアと証明書]に移動します。

  4. NodeDefaultTrustStore](または使用している認証ストア)を選択します。

  5. 右側の[Signer Certificates]の下にある[Additional Properties]を選択します。

  6. 追加]をクリックします。

  7. エイリアス名と証明書ファイルへのフルパスを入力します。

  8. ドロップダウンリストでデータタイプを[Binary DER data]に変更します。

  9. [OK]をクリックします。これで、署名者証明書リストに証明書が表示されます。

  10. 画面の一番上にある[保存]リンクをクリックします。

コマンドラインを使用した証明書のインポート

WebSphereサーバをホストするマシンのコマンドラインから鍵ツールを実行して、WebSphereキーストアに証明書をインポートします。

メモ:WebSphereの鍵ツールを使用しないと、この手順は有効ではありません。また、ストアタイプがPKCS12であることを確認してください。

WebSphereの鍵ツールは/IBM/WebSphere/AppServer/java/binにあります。

次に鍵ツールコマンドの例を示します。

keytool -import -trustcacerts -file servercert.der -alias myserveralias -keystore trust.p12 -storetype PKCS12

システム上に複数のtrust.p12ファイルがある場合は、ファイルへのフルパスを指定しなければならないことがあります。

6.2.7 IBM JDKへの無制限ポリシーファイルの適用

WebSphereへのRBPMのインストールについて説明したセクション 6.1, ユーザアプリケーションWARのインストールおよび環境設定で、インストーラのIBM JDKにはIBM JDKポリシーファイルが適用されました。RBPMが実行される各WebSphere IBM JDKにも、これらの無制限ポリシーファイルを適用する必要があります。

各WebSphereサーバのIBM JDKを見直して、無制限ポリシーファイルが適用されていることを確認します。これらの無制限ポリシーファイルがない場合、RBPMの起動中に「Illegal key size」というエラーが発生します。

6.2.8 preferIPv4StackプロパティをJVMに渡す

ユーザアプリケーションは、キャッシュを実装するのにJGroupsを使用します。環境設定によっては、mcast_addrのバインディングが確実に成功するように、preferIPv4Stackプロパティをtrueに設定するようにJGroupsが要求します。

このオプションが設定されていない場合、次のエラーが発生することがあります。

[10/1/09 16:11:22:147 EDT] 0000000d UDP           W org.jgroups.util.Util
createMulticastSocket could not bind to /228.8.8.8 (IPv4 address); make sure
your mcast_addr is of the same type as the IP stack (IPv4 or IPv6).

または、次のエラーも発生する可能性があります。

[3/21/12 10:04:32:470 EDT] 00000024 UDP      E org.jgroups.protocols.TP down
failed sending message to null (131 bytes)
        java.lang.Exception: dest=/228.8.8.8:45654 (134 bytes)
    at org.jgroups.protocols.UDP._send(UDP.java:353)

パラメータjava.net.preferIPv4Stack=trueは、たとえばextend.local.config.dirのようなその他のシステムプロパティと同じ方法で設定できるシステムプロパティです。システム設定プロパティの設定についてはセクション 6.2.3, ユーザアプリケーション環境設定ファイルとJVMシステムプロパティの追加、を参照してください。