WebSphere Application Server で実行される Rational Engineering Lifecycle Manager のアップグレード

Rational® Engineering Lifecycle Manager をアップグレードするには、新しい製品バージョンをインストールして、構成ファイルを更新し、既存のデータベース・リポジトリー内の表を追加または更新し、 データをバージョン 5.0.1 にマイグレーションします。

始める前に

手順

  1. Rational Engineering Lifecycle Manager をインストールします。
    この手順では、以下がインストールされます。
    • Rational Engineering Lifecycle Manager 5.0.1
    • Jazz™ Team Server 5.0.1
    • 「構成管理」アプリケーション 5.0.1
    重要:
    • 元のインストール済み環境とは異なるパッケージ・グループとディレクトリーを選択してください。
    • 前のインストール済み環境と同じコンテキスト・ルートを選択してください。

      Rational Engineering Lifecycle Manager バージョン 5.0 またはそれより古いバージョンからアップグレードする場合、既存の Jazz Reporting Serviceまたは SPARQL Gateway のコンテキスト・ルートは /SPARQL_Gateway、アプリケーション・ファイル名は SPARQL_Gateway.war です。 Rational Engineering Lifecycle Manager 5.0.1 をインストールするときに、 カスタム・コンテキスト・ルート・オプションを選択し、「アプリケーション・コンテキスト・ルート値」フィールドに SPARQL_Gateway を入力します。

  2. アプリケーション・サーバーを構成します。
    1. 古いサーバーが稼働していることを確認します。
    2. WebSphere® Application Server のプロファイルをバックアップします。
      1. コマンド・プロンプトを開き、WebSphere Application Server インストール・ディレクトリーの bin ディレクトリーに移動します。
      2. 次のコマンドを実行します。WebSphere Application Server のセキュリティーがオンになっている場合は、ユーザー名とパスワードを指定してください。
        ヒント: バックアップ処理を始める前に、圧縮ファイルへのディレクトリー・パスが存在している必要があります。
        • Linux
          backupConfig.sh <Path_to_a_new_compressed_file_to_create_backup_of_profile> -username <WAS_primary_administrative_user_name> -password <WAS_administrative_password>
          以下に例を示します。
          backupConfig.sh /root/WAS_backup/relm_50_profile.zip -username <WAS_admin> -password <WAS_admin_password>
        • Windows
          backupConfig.bat <Path_to_a_new_compressed_file_to_create_backup_of_profile> -username <WAS_primary_administrative_user_name> -password <WAS_administrative_password>
          以下に例を示します。
          backupConfig.bat C:\WAS_backup\relm_50_profile.zip -username <WAS_admin> -password <WAS_admin_password>
      このコマンドは、バックアップ処理を開始する前に、サーバーをシャットダウンします。
    3. WebSphere Application Server から既存のアプリケーションをアンインストールします。
      1. サーバーを始動します。
      2. https://host_name:9043/ibm/console/logon.jsp の WebSphere Application Server Integrated Solutions Console にログオンします。
      3. 「アプリケーション」 > 「アプリケーション・タイプ」 > 「WebSphere エンタープライズ・アプリケーション」をクリックします。
      4. 次のアプリケーションを停止してアンインストールします: relm.war, relmhelp.war, vvc.war, lqe.war, SPARQL_Gateway.war
      5. プロンプトが表示されたら、変更内容をマスター構成に保存します。
    4. JAZZ_HOMElog4j.configuration のカスタム・プロパティーを更新します。
      1. https://host_name:9043/ibm/console/logon.jsp の WebSphere Application Server Integrated Solutions Console にログオンします。
      2. 「サーバー」 > 「サーバー・タイプ」 > 「WebSphere Application Server」をクリックします。
      3. サーバー名をクリックして開きます。デフォルトのサーバー名は server1 です。
      4. 「サーバー・インフラストラクチャー」セクションで、 「Java およびプロセス管理」 > 「プロセス定義」をクリックします。
      5. 「追加プロパティー」の下の「Java 仮想マシン」 をクリックします。
      6. Lifecycle Query EngineJazz Reporting Serviceのパスを新しいロケーションに変更します。
      7. 「汎用 JVM 引数」テキスト・フィールドを見つけ、次の環境変数を JVM 始動プロセスに追加します。

        -Dlqe.config.location=file://drive:/lqe_installation_dir/server/conf/lqe

      8. 「追加プロパティー」の下の「カスタム・プロパティー」をクリックします。
      9. 「JAZZ_HOME」をクリックして、その値を file:///<new_version_install_dir>/server/conf に更新します。

        例えば、file:///C:/PROGRA~2/IBM/JazzTeamServer_5.0.1/server/conf のようになります。

      10. 「log4j.configuration」をクリックして、その値を file:///<new_version_install_dir>/server/conf/startup_log4j.properties に更新します。

        例えば、file:///C:/PROGRA~2/IBM/JazzTeamServer_5.0.1/server/conf/startup.log4j.properties のようになります。

      11. Oracle データベースに接続する場合は、ORACLE_JDBC_DRIVER_FILE が正しい JDBC ドライバー・ファイルを指していることを確認してください。
      12. プロンプトが表示されたら、変更内容をマスター構成に保存します。
    5. Jazz Reporting Serviceの共有ライブラリーを設定します。
      1. 管理コンソールで、「環境」 > 「共有ライブラリー」を選択します。
      2. リストで、「JRS 共有ライブラリー」をクリックします。
      3. クラス・パスを既存の Jazz Reporting Service インストールのロケーションから新しいものに変更します。

        例えば 5.0.1_install_dir/server/conf/SPARQL_Gateway/SharedLibrary にします。

      4. 「クラス・ロード」の下で、「共有ライブラリーに対して単独のクラス・ローダーを使用 (Use an isolated class loader for the shared library)」が選択されていることを確認します。 「適用」、そして「保存」をクリックします。
    6. WebSphere Application Server を停止します。
      • Linux stopServer.sh コマンドを実行します。
      • Windows stopServer.bat コマンドを実行します。
    7. WebSphere Application Server の temp ディレクトリーをクリーンアップします。

      プロファイル内の wscache ディレクトリーと temp ディレクトリーから Rational Engineering Lifecycle Manager に関連する内容を削除します。以前にインストールされていたアプリケーションによっては、relm_warlqe_warsparql、および「構成管理」アプリケーションに関連するデータのディレクトリーがプロファイル内にある場合がありますが、これらは削除できます。

      • Linux
        WAS_profile_root/wscache (for example: opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp/wscache)
        WAS_profile_root/temp (for example: opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)
      • Windows
        WAS_profile_root\wscache (for example: C:\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
        WAS_profile_root\temp (for example: C:\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)
    8. WebSphere Application Server の logs ディレクトリーをクリーンアップします。
      各アプリケーション・サーバーに移動し、プロファイルの logs ディレクトリーから、Rational Engineering Lifecycle Manager に関連するログを削除します。標準的なログのディレクトリーは以下のようになります。
      • Linux opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs
      • Windows C:\IBM\WebSphere\AppServer\profiles\AppSrv01\logs
    9. WebSphere Application Server を始動します。
      • Linux startServer.sh コマンドを実行します。
      • Windows startServer.bat コマンドを実行します。
  3. データベースをマイグレーションまたはバックアップします。
    オプション 説明
    Derby アップグレードでインストールされた Derby データベースを削除して、元のインストール済み環境の Derby ファイルに置き換えます。
    rm -rf $newRELMHome/server/conf/jts/derby/repositoryDB
    rm -rf $newRELMHome/server/conf/jts/indices
    rm -rf $newRELMHome/server/conf/relm/derby/repositoryDB
    rm -rf $newRELMHome/server/conf/vvc/derby/repositoryDB
    cp -R $oldRELMHome/server/conf/jts/derby/repositoryDB $newRELMHome/server/conf/jts/derby
    cp -R $oldRELMHome/server/conf/jts/indices $newRELMHome/server/conf/jts
    cp -R $oldRELMHome/server/conf/relm/derby/repositoryDB $newRELMHome/server/conf/relm/derby
    cp -R $oldRELMHome/server/conf/relm/indices $newRELMHome/server/conf/relm
    cp -R $oldRELMHome/server/conf/vvc/derby/repositoryDB $newRELMHome/server/conf/vvc/derby
    cp -R $oldRELMHome/server/conf/vvc/indices $newRELMHome/server/conf/vvc
    DB2 または Oracle 詳細な説明については、データベース・ベンダーにより提供される資料を参照してください。
    以下は、DB2® のデータベース・バックアップ・プロセスの例で、ガイドラインとして使用できます。
    1. 古い Jazz Team Server が停止されたことを確認します。
    2. DB2 で、Jazz Team Server アプリケーションの前のインストール済み環境によって使用されているデータベースを検索します。
    3. Jazz Team Server アプリケーションで使用されている各データベースをバックアップします。
    4. 変更を保存します。
    データベースのバックアップと復元についての詳細は、Rational solution for Collaborative Lifecycle Management の資料をお読みください。
    SQL Server

    以下は、SQL Server のデータベース・バックアップ・プロセスの例で、ガイドラインとして使用できます。

    • 正しいユーザー名とパスワードを持っていることを確認します。
    • アップグレード・プロセスを始める前に、データベースをバックアップしてあることを確認します。
    • Java Database Connectivity (JDBC) ドライバーがインストール済みであり、sqljdbc4.jar を使用していることを確認します。バージョン 5.0.1 では、 JRE バージョン 5.0 はサポートされなくなりました。JRE バージョン 6.0 および 7.0 のみがサポートされています。
    • SQL サービスが開始されていることを確認します。
    詳細な説明については、データベース・ベンダーにより提供される資料を参照してください。
    Oracle Oracle JDBC ドライバー ojdbc.jar が、 $newRELMHome/JazzTeamServer/server/oracle ディレクトリー内で使用可能であることを確認してください。
  4. 構成管理アプリケーションをアップグレードします。

    vvc_upgrade スクリプトを実行して、構成とデータベース・ファイルをアップグレードし、テキスト索引を再作成します。

    以下はパラメーターの例です。
    cd $newRELMHome/server/
    upgrade/vvc/vvc_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
    • 分散 (複数サーバー) インストール・トポロジーをアップグレードする場合は、 vvc_upgrade スクリプトを使用する際に以下のパラメーターを併用してください。
      -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck
    • Tomcat のアップグレードをスキップするには、vvc_upgrade スクリプトに以下のパラメーターを追加してください。
      -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck -updateTomcatFiles=no
    ヒント: 構成管理アプリケーションは、Rhapsody® Design Manager と一緒にインストールすることもできます。Rational Engineering Lifecycle Manager のインストール時に、コンポーネントを Rhapsody Design Manager システムとは別のマシンにインストールしたい場合には、「構成管理」アプリケーションを選択します。Rational Engineering Lifecycle Manager と統合する構成管理アプリケーションは 1 つのみにしてください。コンポーネントを複数のサーバーにインストールすることを選択する場合は、インストールおよびアップグレードの対象として正しいコンポーネントが選択されていることを確認してください。
  5. Rational Engineering Lifecycle Manager をアップグレードします。
    relm_upgrade.sh コマンドを実行して、構成ファイルとデータベース・ファイルをアップグレードし、テキスト索引を再作成します。
    $newRELMHome/server/upgrade/relm/relm_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
  6. Lifecycle Query Engine と、既存の Jazz Reporting Service、または SPARQL ゲートウェイの構成情報を、新しい製品バージョンに移植します。
    古いインストール場所にある SPARQL_Gateway ディレクトリーのコンテンツを新規の SPARQL_Gateway ディレクトリーにコピーします。
    cp -R $oldRELMHome/server/conf/SPARQL_Gateway/* $newRELMHome/server/conf/SPARQL_Gateway
    バージョン 5.0 から 5.0.1 にアップグレードする場合は、手順 7 に進みます。
    バージョン 4.x から 5.0.1 にアップグレードする場合は、テキスト・エディターを使用して次のプロパティーを $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties に追加します。
    • support.query.editing=false
    • support.db.derby=false
    • support.dwse=false
    • query.results.limit=3000
    • query.results.cache.timeout=300
    • user.account.cache.timeout=480
    SPARQL_Gateway から app.properties を削除します
    rm $newRELMHome/server/conf/SPARQL_Gateway/app.properties
    SPARQL_Gateway.propertiesapp.properties という名前に変更します。
    mv $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties $newRELMHome/server/conf/SPARQL_Gateway/app.properties
    SPARQL_Gateway_runtime.propertiesapp_runtime.properties という名前に変更します。 (デフォルトでは、SPARQL_Gateway_runtime.properties は存在しませんが、 接続タイムアウト設定の構成が必要な場合は当該ファイルを作成できます。)
    mv $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway_runtime.properties $newRELMHome/server/conf/SPARQL_Gateway/app_runtime.properties
  7. relm.warrelmhelp.warvvc.warlqe.war、 および SPARQL_Gateway.war ファイルをデプロイします。
    1. WebSphere Application Server 管理コンソールから、「アプリケーション」 > 「アプリケーション・タイプ」 > 「WebSphere エンタープライズ・アプリケーション」を選択します。
    2. 「エンタープライズ・アプリケーション」ページで、 「インストール」をクリックします。
    3. 「新規アプリケーションのパス (Path to the new application)」で、 $newRELMHome/server/webapps/relm.war を選択し、 「開く」をクリックします。
    4. 「ファスト・パス」を選択し、次に「次へ」を選択します。
    5. デフォルト値を受諾し、セットアップ・ウィザード内の「次へ」をクリックします。「Web モジュールのコンテキスト・ルートのマップ (Map context roots for Web modules)」ページで、 コンテキスト・ルート /relm を入力します。次に、「終了」をクリックします。
    6. relm.war が正常にインストールされたことを伝えるメッセージが表示されます。「マスター構成に直接保存」をクリックします。
    7. Rational Engineering Lifecycle Manager 資料 relmhelp.war をインストールします。 上記のステップ a からステップ f までを使用します。パスには $newRELMHome/server/webapps/relmhelp.war を使用し、コンテキスト・ルートには /relmhelp を使用します。
    8. 「構成管理」アプリケーション vvc.war をインストールします。 上記のステップ a からステップ f までを使用します。パスには $newRELMHome/server/webapps/vvc.war を使用し、 コンテキスト・ルートには /vvc を使用します。
    9. Lifecycle Query Engine の WebSphere Application Server を設定し、lqe.war ファイルをデプロイします。
    10. Jazz Reporting Service・アプリケーション SPARQL_Gateway.war をインストールします。上記のステップ a からステップ f までを使用します。パスには、$newRELMHome/server/webapps/SPARQL_Gateway.war を使用します。コンテキスト・ルートとして SPARQL_Gateway を使用します。
    11. Jazz Reporting Serviceのライブラリー参照を追加します。
      1. 「アプリケーション」 > 「アプリケーション・タイプ」 > 「WebSphere エンタープライズ・アプリケーション」へ移動し、アプリケーション・リスト内の SPARQL_Gateway_war をクリックします。
      2. 「参照」セクションで、「共有ライブラリー参照 (Shared library references)」をクリックします。
      3. SPARQL_Gateway_war の隣にあるチェック・ボックスを選択し、 「共有ライブラリーを参照する (Reference shared libraries)」をクリックします。
      4. JRS 共有ライブラリーを選択し、右矢印をクリックします。
      5. 「OK」をクリックします。次に、再度「OK」をクリックして、設定をマスター構成に保存します。
    12. Jazz Reporting Serviceのクラス・ロード順序が正しく構成されていることを確認します。
      1. 「アプリケーション」 > 「アプリケーション・タイプ」 > 「WebSphere エンタープライズ・アプリケーション」へ移動し、アプリケーション・リスト内の SPARQL_Gateway_war をクリックします。
      2. 「詳細プロパティー (Detail Properties)」セクションで、「クラス・ロードおよび更新の検出 and update detection)」をクリックします。
      3. 「クラス・ローダー順序」セクションで、「最初にローカル・クラス・ローダーを使用してロードされたクラス (親は最後) 」を選択します。
      4. 「OK」をクリックし、「マスター構成に保存」をクリックします。
    13. WebSphere Application Server を再始動します。
  8. バージョン 4.x からアップグレードする場合は、 Lifecycle Query Engine をアップグレードします。

    Lifecycle Query Engine 管理ページ (https://relm_host_name:port/lqe/web/admin) を開きます。Lifecycle Query Engineのアップグレードが進行中であること、および、そのアプリケーションが使用不可であることを伝えるメッセージが表示されます。「アップグレードの開始」をクリックします。アップグレードのプロセスが完了すると、データ・ソースが使用可能になります。

  9. 構成管理アプリケーションをアップグレードします。
    1. credentials.txt ファイルが存在していて、adminUserId、adminPassword、repositoryURL、smartCard、certificateFile を含んでいることを確認します。

      ファイルが存在しない場合は、それを作成します。資格情報ファイルの例は以下のようになります。

      adminUserId=yourAdminUserId
      adminPassword=yourAdminPassword 
      repositoryURL=https://yourserver.com:9443/vvc 
      smartCard=<none>
      certificateFile=<none>
    2. Configuration_Application_install_dir/server ディレクトリーから repotools-vvc コマンドを実行します。
      • Linux./repotools-vvc.sh -vvc_online_migrationCommand credentialsFile=credentials.txt fromVersion=<previous_version> logPort=52000 logLevel=DEBUG
      • Windowsrepotools-vvc.bat -vvc_online_migrationCommand credentialsFile=credentials.txt fromVersion=<previous_version> logPort=52000 logLevel=DEBUG
    3. Jazz Team Server を再始動します。
    構成管理アプリケーションの repotools コマンドは、実行中の構成管理アプリケーションに要求を送信し、応答を待機します。repotools-vvc コマンドが許可エラーにより即時停止した場合は、サーバーが実行中であることと、資格情報ファイル内のユーザー ID とパスワードが正しいことを確認してください。
  10. アプリケーション・サーバーを再始動します。
    • Linux stopServer.sh および startServer.sh コマンドを実行します。
    • Windows stopServer.bat および startServer.bat コマンドを実行します。
  11. Rational Engineering Lifecycle Manager サーバーを再始動して、マイグレーション済みのデータを、新しいアプリケーション・バージョンで必要なフォーマットに自動的にアップグレードします。この処理は、オンライン・アップグレードと呼ばれます。アップグレード状況のページを表示する場合にはログオンします。

タスクの結果

オンライン・アップグレードが成功すると、Web ブラウザーが最新表示され、Rational Engineering Lifecycle Manager のウェルカム・ページが開きます。アップグレードのステップが失敗した場合は、relm.log ファイルを調べて、失敗の原因を判別してください。Rational Engineering Lifecycle Manager で定義された製品が多数ある場合、オンライン・アップグレードが完了するのに長時間 (最大で数時間) を要します。

次のタスク


フィードバック