Tomcat 5.5 への Rational Asset Manager サーバー・アプリケーションのデプロイ

IBM® Rational® Asset Manager は、インストール済み Apache Tomcat に手動でインストールできます。

始める前に

インストール済みで、実行されている Tomcat サーバーへの管理アクセス権限およびファイル・アクセス権限が必要です。

データベース・サーバー用の次の JDBC .jar ファイルの場所を知っておく必要があります。
  • IBM DB2 の場合: db2jcc_license_cu.jar および db2jcc.jar
  • Oracle の場合: ojdbc5.jar。 Oracle 10 を使用している場合は、引き続き Oracle 11 用の ojdbc5.jar ファイルを使用してください。 ファイルは Oracle からダウンロードできます。
  • Microsoft SQL Server の場合: sqljdbc.jar。 ファイルは Microsoft からダウンロードできます。

このタスクについて

Rational Asset Manager のパフォーマンスと安定性を向上させるには、その Web アプリケーションおよび組み込み IBM Rational Team Concert 用のアプリケーション・ファイルを異なる Tomcat サーバーにインストールします。本資料では、Rational Asset Manager 用 Tomcat サーバーのインストール・ディレクトリーは tomcat_install_directory と示されます。 Rational Team Concert 用 Tomcat サーバーのインストール・ディレクトリーは、tomcat_for_rtc_install_directory です。 すべての Web アプリケーションを同じ Tomcat サーバーにインストールする場合、ディレクトリーは同じになります。

注: Rational Asset Manager および組み込み Rational Team Concert を同じマシン上の異なる Tomcat サーバー・アプリケーションにデプロイする場合は、衝突を回避するために、構成で、異なる Tomcat サーバーが使用する保護されたポートと無保護のポートが別のポートになっていることを確認してください。Tomcat 5.5 でのポートについて詳しくは、Apache Tomcat の資料を参照してください。

手順

  1. すべてのリポジトリー・サーバーが、同じ現在日付、時刻、およびタイム・ゾーンに設定されていることを確認します。
  2. Tomcat およびご使用のオペレーティング・システムに適切なアーカイブ上で、アプリケーション・ファイルを取得します。アプリケーション・ファイルは、archive_extract_location/apps/tomcat/ フォルダーにあります。
  3. 共用ライブラリー・ファイルを tomcat_install_directory¥shared¥lib フォルダーに解凍します。
    1. archive_extract_location¥apps¥tomcat¥sharedLib.zip ファイルを見つけて解凍します。
    2. 解凍された sharedLib.zip ファイルのすべてのコンテンツを tomcat_install_directory¥shared¥lib ディレクトリーにコピーします。
    3. Rational Team Concert を異なる Tomcat サーバーにインストールする場合は、sharedLib.zip ファイルの解凍されたコンテンツを、他の Tomcat サーバーの tomcat_for_rtc_install_directory¥shared¥lib ディレクトリーにコピーします。
  4. Windows の場合: Linux の場合:AIX の場合: Rational Licensing Key Server V8.1.2 のライブラリー・ファイルを tomcat_install_directory¥shared¥lib フォルダーに解凍します。
    重要: Linux for zSeries® にインストールする場合は、このステップは実行しないでください。
    1. archive_extract_location¥sharedLibs¥rlsclients_rlsibmratl_812.zip ファイルを見つけて解凍します。
    2. 解凍された .zip ファイルから、ご使用のオペレーティング・システムおよびアーキテクチャー用のファイル rlsibmratl812.zip を見つけます。例えば、32 ビット Windows 用のファイルは、win32 ディレクトリーにあります。
    3. 該当する rlsibmratl812.zip ファイルの内容を解凍します。
    4. 解凍された rlsibmratl812.zip ファイルのすべての内容を tomcat_install_directory¥shared¥lib ディレクトリーにコピーします。
  5. Windows の場合: Linux の場合:AIX の場合: Rational Asset Manager 用の Tomcat サーバーのスタートアップ・スクリプトを変更します。
    重要: Linux for zSeries にインストールする場合は、このステップは実行しないでください。
    1. Tomcat スタートアップ・ファイルを見つけて、テキスト・エディターで開きます。Windows では、このファイルは tomcat_install_directory¥bin¥startup.bat です。 Linux、AIX®、または Linux for zSeries では、tomcat_install_directory/bin/startup.sh です。
    2. スタートアップ・ファイルに、次のテキストを入力します。
      • Windows の場合:
        set JAVA_OPTS=-Djava.library.path="tomcat_install_directory¥shared¥lib"
      • Linux の場合:AIX の場合:
        export JAVA_OPTS="-Djava.library.path=tomcat_install_directory/shared/lib"
  6. archive_extract_location/apps/tomcat/ ディレクトリーから、次のファイルを tomcat_install_directory/webapps/ ディレクトリーにコピーします。
    • com.ibm.ram.repository.web.tomcat_runtime.war
    • com.ibm.ram.repository.web.ws.tomcat_runtime.war
    • ramhelp.war
    • rmcabdgovernprocess.war
  7. アプリケーションのコンテキスト・パスを変更するには、WAR アプリケーション・ファイルの名前を変更します。 次の名前を使用します。
    表 1. Rational Asset Manager Web アプリケーション・ファイルのコンテキスト・パス
    元のファイル名 新規ファイル名 変更後のコンテキスト・パス ファイルの内容
    com.ibm.ram.repository.web.tomcat_runtime.war ram.war ram Tomcat 用 Rational Asset Manager 基本 Web アプリケーション
    com.ibm.ram.repository.web.ws.tomcat_runtime.war ram.ws.war ram.ws Tomcat 用 Rational Asset Manager Web サービス・アプリケーション
    ramhelp.war ram.help.war ram.help Rational Asset Manager ヘルプおよびユーザー支援アプリケーション
    rmcabdgovernprocess.war ram.process.war ram.process アセット・ベースの開発および統轄管理プロセス用文書アプリケーション
  8. Rational Asset Manager がご使用のデータベースにアクセスできるように Tomcat サーバーを構成します。
    1. テキスト・エディターで、tomcat_install_directory¥conf¥server.xml ファイルを開きます。
    2. server.xml 内で、先頭が <Connector で、port="8080" または port="8009" を含む行をすべて見つけます。 この行の先頭を <Connector URIEncoding="UTF-8" に変更します。
    3. グローバル JNDI リソースのオープン・タグとクローズ・タグの間 (<GlobalNamingResources></GlobalNamingResources> の間) に、ご使用のバージョンの Tomcat に応じて以下のテキストを入力します。
      注:your_username および your_password には、データベースへの完全な管理アクセス権限を持つユーザー ID およびパスワードを使用します。例えば、「url」属性は jdbc:db2://localhost:50000/RAMDB のようになります。
    ご使用のデータベース・サーバーに応じた以下のテキストを、変数を次のように置き換えて入力します。
    • username 属性および password 属性で、your_usernameyour_password を、データベース・サーバーへの完全な管理アクセス権限を持つユーザー ID とパスワードで置き換えます。
    • url 属性で、fully_qualified_database_server_namedatabase_port_number をご使用のデータベースのサーバー・アドレスとポート番号で置き換え、Rational_Asset_Manager_database_name をアセット用データベースの名前で置き換えます。例えば、DB2 では url 属性は jdbc:db2://localhost:50000/RAMDB のようになります。
    • maxWaitmaxActive、および maxIdle の各属性に表示される値は、サンプル値であり、パフォーマンス上の必要に応じて調整できます。
    • IBM DB2 の場合:
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="com.ibm.db2.jcc.DB2Driver"
      username="your_username"
      password="your_password"
      url="jdbc:db2://fully_qualified_database_server_name:database_port_number/Rational_Asset_Manager_database_name"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
    • Oracle の場合:
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="oracle.jdbc.driver.OracleDriver"
      username="your_username"
      password="your_password"
      url="jdbc:oracle:thin:@fully_qualified_database_server_name:database_port_number:Rational_Asset_Manager_database_name"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
    • Microsoft SQL Server の場合:
      <Resource name="jdbc/RAM_Con"
      type="javax.sql.DataSource"
      driverClassName="com.microsoft.jdbc.sqlserver.SQLServerDriver"
      username="your_username"
      password="your_password"
      url="jdbc:microsoft:sqlserver://fully_qualified_database_server_name:database_port_number:Rational_Asset_Manager_database_name"
      poolPreparedStatements="true"
      maxWait="5000"
      maxActive="4"
      maxIdle="2"/>
  9. すべてのアプリケーションへのシングル・サインオン用に Tomcat サーバーを構成します。
    1. テキスト・エディターで、tomcat_install_directory¥conf¥server.xml ファイルを開きます。
    2. 次のテキストを検索します。
      <!--
      <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
      -->
    3. <Valve> エレメントのコメントを外します。
      <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
  10. 次の JAR ファイルを tomcat_install_directory¥common¥lib フォルダーにコピーします。
    • IBM DB2 の場合:
      • db2jcc_license_cu.jar
      • db2jcc.jar
    • Oracle の場合:
      • ojdbc5.jar (このファイルは Oracle からダウンロードできます。 Oracle 10 を使用している場合は、Oracle 11 用のパッケージをダウンロードして、ojdbc5.jar ファイルを探してください。)
    • Microsoft SQL Server の場合:
      • sqljdbc.jar (このファイルは Microsoft からダウンロードできます。)
    以上のファイルはデータベース・プロバイダーから提供され、通常はインストールされたデータベースの /java/ フォルダーにあります。
  11. ユーザー・セキュリティー用に Tomcat サーバーを構成します。LDAP セキュリティーを使用する場合は、最初にファイル・ベースのセキュリティーを使用してアプリケーションを構成し、アプリケーションを構成した後に LDAP 認証に切り替えます。詳しくは、Tomcat 用の LDAP 認証の構成を参照してください。
    1. テキスト・エディターで、tomcat_install_directory¥conf¥tomcat-users.xml ファイルを開きます。
    2. admin という名前のユーザーを追加し、そのユーザーに admin ロールおよび manager ロールを割り当てます。 このユーザーを追加するには、<tomcat-users> タグの間に次のテキストをコピーして貼り付けます。
      <user username="admin" password="" roles="admin,manager" />

      このユーザーの名前は admin にする必要があります

  12. セットアップに応じて、Rational Team Concert をデプロイまたは構成します。

フィードバック