z/OS 上の WebSphere Application Server を使用するための Engineering Lifecycle Management 用の Jazz Team Server およびアプリケーションの構成

オンライン編集

このトピックでは、 Jazz ® Team Server および IBM® Engineering Lifecycle Management (ELM) アプリケーションを、 z/OS上の WebSphere Application Server と連携するようにセットアップする方法について説明します。 z/OS での WebSphere Application Server の構成は、他のプラットフォームと似ています。 主な相違点は、セキュリティー・モデルと、ファイル・システム内のファイルの場所です。

始める前に

このタスクを実行する前に、必ず以下のことを確認してください。
  • 構成する前に、 ハードウェア要件およびソフトウェア要件 を参照してください。
  • WebSphere Application Serverがインストールされ、実行されている。
  • Jazz Team Server およびデプロイする予定のすべての ELM アプリケーション用に BLZCP* ジョブをカスタマイズして実行依頼しました。
  • DB2® データベースを作成し、ご使用のデータベース設定で teamserver.properties ファイルを更新します。
  • RACF® セキュリティーを使用している場合は、 「ローカル・オペレーティング・システム」を選択して構成します。
  • RACF セキュリティー設定が確立されました。 RACF セキュリティーについて詳しくは、 RACFを使用した z/OS システムでの RACFSetting up user security を使用した z/OS システムでのユーザー・セキュリティーのセットアップを参照してください。
  • 以下のステップに従って、Java™ 2 セキュリティー・オプションをオフにします。
    1. 「セキュリティー」 > 「グローバル・セキュリティー」をクリックします。
    2. Java 2 セキュリティーで、「Java 2 セキュリティーを使用してアプリケーション・アクセスをローカル・リソースに制限する」チェック・ボックスを選択解除します。
    3. 「管理セキュリティーを有効にする」と「アプリケーション・セキュリティーを有効にする」のチェック・ボックスが選択されていることを確認します。

    WebSphere Application Serverでこのオプションをオンにすると、Web アプリケーションは始動しません。

  • 「無保護の URI にアクセスがあったときは、使用可能な認証データを使用する (Use available authentication data when an unprotected URI is accessed)」を選択している。 サーバーの Integrated Solutions Console を使用している場合は、以下のステップを使用してこの設定を検証します。
    1. 「セキュリティー」 > 「グローバル・セキュリティー」 > 「Web および SIP セキュリティー」 > 「一般設定」をクリックします。
    2. 「無保護の URI にアクセスがあったときは、使用可能な認証データを使用する (Use available authentication data when an unprotected URI is accessed)」のチェック・ボックスを選択します。
  • 「SSL を必要とする」を有効にして、確実に LTPA Cookie がセキュアになるようにしている。 サーバーの Integrated Solutions Console を使用している場合は、以下のステップを使用してこの設定を検証します。
    1. 「セキュリティー」 > 「グローバル・セキュリティー」 > 「Web および SIP セキュリティー」 > 「シングル・サインオン (SSO)」をクリックします。
    2. 「SSL を必要とする」のチェック・ボックスを選択します。
    3. 「OK」をクリックして、設定を保存します。
  • ユーザーがセッションを終了せずにログアウトした場合に SESN0008E エラー・メッセージが出されないようにするため、セッション管理カスタム・プロパティーを追加します。 サーバーの Integrated Solutions Console を使用している場合は、以下のステップを使用してこの設定を検証します。
    1. 「 サーバー > サーバー・タイプ > WebSphere アプリケーション・サーバー > server1」をクリックします。
    2. 「コンテナー設定」セクションで、「セッション管理」をクリックします。
    3. 「追加プロパティー」セクションで、「カスタム・プロパティー」をクリックします。
    4. 「新規」をクリックして、以下の情報を入力します。
      名前:
      InvalidateOnUnauthorizedSessionRequestException
      値
      はい
    5. 「適用」をクリックして、設定を保存します。
  • https://jazz.net/wiki/bin/view/Deployment/DeploymentInstallingUpgradingAndMigratingのシステム要件に基づいて、 WebSphere Application Server レベルを検証または更新しました。

このタスクについて

このトピックには、SSL で WebSphere Application Server 認証を構成するためのステップはリストされていません。 使用できるさまざまな認証および暗号化のオプションについて詳しくは、 WebSphere Application Server for z/OS 製品資料にアクセスし、実行中のバージョンを選択して、「 アプリケーションとその環境の保護」を検索してください。

手順

WebSphere Application Serverに Jazz Team Server および ELM アプリケーションをデプロイするには、以下のステップを実行します。 各ステップについては、そのタスクで詳述します。

  1. アプリケーション・サーバーの JVM カスタム・プロパティーの定義。
  2. Web アプリケーションのデプロイおよびアプリケーション・サーバーの再始動。
  3. レポート・ビルダー (rs) をインストールする場合は、以下の手順を実行して、Jazz レポート・サービス (JRS) の共有ライブラリーを定義します。 この共有ライブラリーは、レポート・ビルダーを構成するときに参照します。
    1. WebSphere Integrated Solutions Console のナビゲーション・ペインで、 「環境」 を展開し、 「共有ライブラリー」をクリックします。
    2. 「有効範囲」 リストで、 「ノード =yourNode名前、サーバー =yourServer名」 を選択し、 「新規」をクリックします。
    3. 共有ライブラリー名 JRS Shared Library を入力し、説明を追加します。 クラスパスを @workPath@/rs/WAS_SharedLibrary (@workPath@ は rs の作業ディレクトリーの構成に使用したパス) に設定します。 例えば、 /u/jazz702/rs/WAS_SharedLibraryなどです。
    4. 「クラス・ロード」の下で、 「この共有ライブラリーに独立したクラス・ローダーを使用する」を選択し、 「適用」をクリックして、 「保存」をクリックします。

アプリケーション・サーバーの JVM カスタム・プロパティーの定義

オンライン編集

このタスクについて

注:
  • ご使用の WebSphere Application Serverのバージョンによっては、 WebSphere 管理コンソールに若干の違いがある場合があります。
  • @confPath@ を、 ELM アプリケーションの BLZCPJTS およびその他の BLZCP* サンプル・ジョブの実行時に決定された Jazz Team Server 構成ディレクトリーに置き換えます。

手順

  1. WebSphere Application Server 管理コンソールにログインします。
  2. 「サーバー」 > 「アプリケーション・サーバー」を選択します。
  3. server1 またはご使用のサーバー名を選択します。
  4. 「コンテナー・サービス」を展開します。
  5. 「ORB サービス」を選択します。
  6. z/OS 追加設定」を選択します。
  7. 「ワークロード・プロファイル」 を LONGWAITに設定します。 スレッド・プールの使用状況をモニターして、調整が必要かどうかを判断します。
  8. 変更内容を保管するには、 「OK」 をクリックします。
  9. 「サーバー」 > 「アプリケーション・サーバー」を選択します。
  10. server1 またはご使用のサーバー名を選択します。
  11. 「Java およびプロセス管理」 > 「プロセス定義」 > 「サーバント」を選択します。
  12. 「Java 仮想マシン」を選択します。
  13. 「初期ヒープ・サイズ」 の値を 4096 に設定します。
  14. 「最大ヒープ・サイズ」 の値を 4096 に設定します。
    これは推奨値です。 ご使用環境に応じて値を設定してください。 標準的な中規模チームは、4096 の値を使用できます。これにより、64 ビット JVM を使用する Jazz Team Server プロセス用に 4 GB のヒープ・メモリーが提供されます。
  15. 「汎用 JVM 引数」 の値を -Xmn512mに設定します。
  16. 「適用」をクリックします。
  17. 「カスタム・プロパティー」を選択します。
  18. 「新規」をクリックして、以下のプロパティーを追加します。 それぞれを追加した後には、「OK」をクリックします。
    名前: java.awt.headless
    値: true
    名前: org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin
    値: true
    名前: JAZZ_HOME
    値: file:///etc/jazz702 、または初期セットアップ時に @confPath@ に使用した任意の値。
    名前: jazz.auditDir
    値: u/jazz702/audit 、または初期セットアップ時に @workPath@ に設定した値の後に、 /auditが続きます。
    名前: DB2Z_JDBC
    値: /@db2PathPrefix@/db2a10_jdbc/classes または /@db2PathPrefix@/db2b10/jdbc/classes、または /@db2PathPrefix@/db2c10/jdbc/classes
    注: @db2PathPrefix@ を、システム上の Db2 V11.1 または V12.1 JDBC ライセンスおよび JDBC jar ファイルへのパスに置き換えます。 これらのファイルの名前は db2jcc_license_cisuz.jar および db2jcc.jar で、 デフォルトでは /usr/lpp/ にバージョン固有のパスを付加した場所にあります。
    名前: log4j.configuration
    値: file:///etc/jazz702/startup_log4j.properties
    注: startup_log4j.properties に含まれている設定は、始動プロセスの初期段階で WebSphere Application Server SystemOut.log ファイルにメッセージを出力するために使用されます。 初期段階の後、各 Jazz アプリケーションは、 /etc/jazz702/<app context>のアプリケーション固有の設定の使用に切り替えます。 /etc/jazz702以外の構成パスを使用する場合は、それに応じてこのパスを調整してください。
  19. 「マスター構成に直接保存」を選択します。

Web アプリケーションのデプロイと WebSphere Application Server の再始動

オンライン編集

手順

  1. WebSphere Application Server 管理コンソールから、 「アプリケーション」 > 「新規アプリケーションのインストール」 (または 「アプリケーション」 > 新規アプリケーション > 「新規エンタープライズ・アプリケーション」) を選択します。
  2. 「新規アプリケーションへのパス」の下で、 「リモート・ファイル・システム」を選択します。
  3. 「絶対パス」の下で、 @pathPrefix@/usr/lpp/jazz/v7.0.2/server/jts.warを参照します。ここで、 @pathPrefix@ は、SMP/E のインストール時に指定した任意の接頭部です。
  4. コンテキスト・ルートを /jtsに設定します。
  5. 「次へ」をクリックして、そのエディターからプロンプトが出された残りの 「新規アプリケーションのインストール」 ステップに進みます。
    注: ライフサイクル照会エンジン (LQE) およびリンク索引プロバイダー (LDX) の場合のみ: 「デフォルト・バインディングおよびマッピングの生成の選択 (Choose to generate default bindings and mappings)」を展開し、 「デフォルト・バインディングの生成 (Generate Default Bindings)」を選択します。
  6. 「終了」をクリックします。
  7. 「マスター構成に直接保存」を選択します。
  8. コンテキストが root/clmhelpの clmhelp.war について、上記のステップを繰り返します。
  9. CCM アプリケーションをインストールする場合は、コンテキスト・ルート /ccmを使用して ccm.war に対して前のステップを繰り返します。
  10. QM アプリケーションをインストールする場合は、コンテキスト・ルート /qmを使用して qm.war に対して前のステップを繰り返します。
  11. RM アプリケーションをインストールする場合は、コンテキスト・ルート /rmを使用して rm.war に対して上記のステップを繰り返します。
  12. LQE アプリケーションをインストールする場合は、コンテキスト・ルート /lqeを使用して lqe.war に対して上記のステップを繰り返します。
    ライフサイクル照会エンジン (LQE) アプリケーションの構成 の手順に進みます。
  13. DCC アプリケーションをインストールする場合は、コンテキスト・ルート /dccを使用して dcc.war に対して前のステップを繰り返します。
  14. GC アプリケーションをインストールする場合は、コンテキスト・ルート /gcを使用して gc.war に対して前のステップを繰り返します。
  15. LDX アプリケーションをインストールする場合は、コンテキスト・ルート /ldxを使用して ldx.war に対して前のステップを繰り返します。
    リンク索引プロバイダー (LDX) アプリケーションの構成 の手順に進みます。
  16. RS アプリケーションをインストールする場合は、コンテキスト・ルート /rsを使用して rs.war に対して上記のステップを繰り返します。
    レポート・ビルダー (RS) アプリケーションの構成 の手順に進みます。
  17. IBM Engineering Lifecycle Optimization - Engineering Insights (ENI) アプリケーションをインストールする場合は、コンテキスト・ルート /relmを使用して relm.war に対して上記のステップを繰り返します。
  18. アプリケーション・サーバーを再始動します。
  19. エラーがないか、サーバントのログとシステム・コンソールを確認します。

「ライフサイクル照会エンジン (LQE)」アプリケーションの構成

オンライン編集

手順

  1. WebSphere Integrated Solutions Console で、 「アプリケーション」 > 「アプリケーション・タイプ」 > WebSphere エンタープライズ・アプリケーション」をクリックします。
  2. lqe_war をクリックして開き、 「モジュールの管理」をクリックします。
  3. lqeをクリックし、 「クラス・ローダー順序」 フィールドを見つけて、 「最初にローカル・クラス・ローダーをロードしたクラス (親が最後)」を選択します。
  4. 変更内容を保管するには、 「OK」 をクリックします。
  5. lqe_war アプリケーションで、 「クラス・ロードおよび更新の検出」をクリックします。
  6. 「クラス・ローダー」ページで、 「最初にローカル・クラス・ローダーをロードしたクラス (親が最後)」を選択します。
  7. 「適用」 をクリックし、 「マスター構成に直接保存」をクリックします。

「リンク索引プロバイダー (LDX)」アプリケーションの構成

オンライン編集

手順

  1. WebSphere Integrated Solutions Console で、 「アプリケーション」 > 「アプリケーション・タイプ」 > WebSphere エンタープライズ・アプリケーション」をクリックします。
  2. ldx_war をクリックして開き、 「モジュールの管理」をクリックします。
  3. ldxをクリックし、 「クラス・ローダー順序」 フィールドを見つけて、 「最初にローカル・クラス・ローダーをロードしたクラス (親が最後)」を選択します。
  4. 変更内容を保管するには、 「OK」 をクリックします。
  5. ldx_war アプリケーションで、 「クラス・ロードおよび更新の検出」をクリックします。
  6. 「クラス・ローダー」ページで、 「最初にローカル・クラス・ローダーをロードしたクラス (親が最後)」を選択します。
  7. 「適用」 をクリックし、 「マスター構成に直接保存」をクリックします。

「レポート・ビルダー (RS)」アプリケーションの構成

オンライン編集

手順

  1. WebSphere Integrated Solutions Console で、 「アプリケーション」 > 「アプリケーション・タイプ」 > WebSphere エンタープライズ・アプリケーション」をクリックします。
  2. 「エンタープライズ・アプリケーション」ページのリソース・リストで、 rs_warをクリックします。
  3. 「構成」ページの「参照」セクションで、 「共有ライブラリー参照」をクリックします。
  4. 「rs_war」 チェック・ボックスを選択し、 「参照共有ライブラリー」をクリックします。
  5. 「使用可能」 リストで JRS 「共有ライブラリー」 を選択し、右矢印をクリックします。 JRS 共有ライブラリーのセットアップについては、 WebSphere Application Serverのセットアップ を参照してください。
  6. 「OK」をクリックします。
  7. 再度 「OK」 をクリックし、 「保存」をクリックします。
  8. リソースのリストで、 rs_warをクリックします。
  9. 「構成」ページの 「詳細プロパティー」で、 「クラス・ロードおよび更新の検出」をクリックします。
  10. 「クラス・ローダー順序」グループで、 「最初にローカル・クラス・ローダーをロードしたクラス (親が最後)」 が選択されていることを確認します。
  11. 「適用」 をクリックし、 「保存」をクリックします。

次の作業

サーバーを始動した後、「 セットアップ・ウィザードでのカスタム・セットアップの使用によるセットアップの実行」のトピックを参照してください。