バージョン 3.0.1 フィックスパック・リリースへのアップグレード

このトピックは、既存の Rational® solution for CLM 製品をバージョン 3.0.1 フィックスパック・リリースにアップグレードするときに使用します。

始める前に

重要:
  • 以下の例では、3.0.1 はバージョン 3.0.1 サーバーがインストールされているディレクトリーを指し、3.0.1.x は新しいバージョンの 3.0.1 フィックスパック (3.0.1.1 以降) サーバーがインストールされているディレクトリーを指します。
  • 例はすべて Linux 用です。 Windows またはその他のオペレーティング・システムでは、それに応じて変更する必要があります。
  • 3.0.1 から 3.0.1 フィックスパック・リリースへのアップグレード・プロセスは、既存の CLM データベースを使用します。 addTables コマンドと createWarehouse コマンドによって、これらのデータベースが 3.0.1.x 形式にアップデートされます。
  • 同じアプリケーション・サーバーにすべての Jazz™ アプリケーションをインストールしている場合、すべてのアプリケーションを同時に 3.0.1 フィックスパックにアップグレードする必要があります。各アプリケーションを別のアプリケーション・サーバーにデプロイしている場合は、アプリケーションを個別にアップグレードすることができます。
  • jts/setup は実行しないでください。すべてセットアップ済みです。セットアップを表示または変更するには、jts/admin を使用します。
  • アップグレード・ラッパー・スクリプトを使用する手順と、手動によるアップグレードを実行する手順の両方を説明します。
親トピック: Jazz Team Server および CLM アプリケーションのアップグレード

バージョン 2 からのアップグレード

このタスクについて

バージョン 2 から 3.0.1 フィックスパック・リリースへのアップグレードの手順は、バージョン 2 から 3.0.1 へのアップグレードの場合と同じです。詳しくは、Rational solution for CLM へのアップグレードを参照してください。

Tomcat を使用している場合のバージョン 3.0.1 からのアップグレード

手順

  1. CLM 3.0.1.x をインストールします。セットアップは実行しないでください。 分散構成の場合は、既にインストールしている 3.0.1 アプリケーションに対応する CLM 3.0.1.x アプリケーションをインストールします。
    注: 必ず Jazz Team Server を最初にアップグレードする必要があります。
  2. 3.0.1 サーバーを停止します。
  3. Derby を使用している場合は、Derby DB を 3.0.1 から 3.0.1.x に移行します。
    cp -R <3.0.1_install_dir>/server/conf/jts/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/jts/derby
    cp -R <3.0.1_install_dir>/server/conf/ccm/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/ccm/derby
    cp -R <3.0.1_install_dir>/server/conf/qm/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/qm/derby
  4. DB2®、Oracle、または SQL Server を使用している場合は、データベースをバックアップします。
  5. アップグレード・ラッパー・スクリプトを使用する場合は、手順 11 にスキップします。
  6. 3.0.1 のユーザー・レジストリー・ファイルを保存します。
    1. Tomcat のユーザー・レジストリーを使用している場合は、3.0.1 の tomcat-users.xml および server.xml ファイルを保存します。
      cp <3.0.1_install_dir>/server/tomcat/conf/tomcat-users.xml  <3.0.1.x_install_dir>/server/tomcat/conf/tomcat-users.xml
      cp <3.0.1_install_dir>/server/tomcat/conf/server.xml <3.0.1.x_install_dir>/server/tomcat/conf/server.xml
    2. LDAP ユーザー・レジストリーを使用している場合は、3.0.1 の server.xml ファイルと web.xml ファイルを適切なアプリケーション・サーバーに保存します。
      cp <3.0.1_install_dir>/server/tomcat/conf/server.xml <3.0.1.x_install_dir>/server/tomcat/conf/server.xml
      cp <3.0.1_install_dir>/server/tomcat/webapps/admin/WEB-INF/web.xml <3.0.1.x_install_dir>/server/tomcat/webapps/admin/WEB-INF/web.xml
      cp <3.0.1_install_dir>/server/tomcat/webapps/jts/WEB-INF/web.xml <3.0.1.x_install_dir>/server/tomcat/webapps/jts/WEB-INF/web.xml
      cp <3.0.1_install_dir>/server/tomcat/webapps/ccm/WEB-INF/web.xml <3.0.1.x_install_dir>/server/tomcat/webapps/ccm/WEB-INF/web.xml
      cp <3.0.1_install_dir>/server/tomcat/webapps/qm/WEB-INF/web.xml <3.0.1.x_install_dir>/server/tomcat/webapps/qm/WEB-INF/web.xml
      cp <3.0.1_install_dir>/server/tomcat/webapps/rm/WEB-INF/web.xml <3.0.1.x_install_dir>/server/tomcat/webapps/rm/WEB-INF/web.xml
  7. JFS/text の索引を 3.0.1 から 3.0.1.x にコピーします (分散システムの場合は、該当するサーバーに移動してファイルをコピーします)。
    cp -R <3.0.1_install_dir>/server/conf/jts/indices <3.0.1.x_install_dir>/server/conf/jts
    cp -R <3.0.1_install_dir>/server/conf/ccm/indices <3.0.1.x_install_dir>/server/conf/ccm
    cp -R <3.0.1_install_dir>/server/conf/qm/indices <3.0.1.x_install_dir>/server/conf/qm
  8. アプリケーションの構成ファイルを 3.0.1 から 3.0.1.x にコピーします (分散システムの場合は、該当するサーバーに移動してファイルをコピーします)。
    cp <3.0.1_install_dir>/server/conf/jts/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/jts
    cp <3.0.1_install_dir>/server/conf/ccm/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/ccm
    cp <3.0.1_install_dir>/server/conf/qm/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/qm
    cp <3.0.1_install_dir>/server/conf/admin/admin.properties*  <3.0.1.x_install_dir>/server/conf/admin
    cp <3.0.1_install_dir>/server/conf/admin/friends.rdf*  <3.0.1.x_install_dir>/server/conf/admin
    cp <3.0.1_install_dir>/server/conf/rm/fronting.properties  <3.0.1.x_install_dir>/server/conf/rm
    cp <3.0.1_install_dir>/server/conf/rm/friendsconfig.rdf  <3.0.1.x_install_dir>/server/conf/rm
  9. repotools -addTables コマンドを実行して、データベースが適切な表を持つようにします。(分散システムの場合は、該当するサーバーに移動して repotools コマンドを実行します。)
    cd <3.0.1.x_install_dir>/server
    ./repotools-jts.sh -addTables noPrompt
    ./repotools-ccm.sh -addTables noPrompt
    ./repotools-qm.sh -addTables noPrompt
  10. データウェアハウスを構成している場合は、repotools-jts -createWarehouse コマンドを実行して、データウェアハウスのスキーマを 3.0.1.x にアップデートします。
    cd <3.0.1.x_install_dir>/server
    ./reportools-jts.sh -createWarehouse
  11. アップグレード・ラッパー・スクリプトを使用している場合は、<3.0.1.x_install_dir>/server ディレクトリーに移動します。
    upgrade/jts_upgrade.sh -oldJTSHome <3.0.1_install_dir>/server/conf
    upgrade/ccm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf
    upgrade/qm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf
    upgrade/rm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf
  12. サーバーを開始します。
  13. 必要な場合は、3.0.1.x ライセンスをアクティブにします。例えば、マイルストーン・リリースでは、マイルストーンに同梱されている早期アクセス・ライセンスをアクティブにする必要があります。3.0.1.x の最終リリースでは、3.0.1 のライセンスを継続して使用できます。
    1. 管理者として 3.0.1.x Jazz Team Server にログインします。
    2. 「サーバー管理」 > 「ライセンス・キーの管理」ページにナビゲートして、ライセンスをアクティブにします。
    注: すべてセットアップ済みであるため、3.0.1.x システムでセットアップを実行する必要はありません。

WebSphere Application Server を使用している場合のバージョン 3.0.1 からのアップグレード

手順

注: ご使用の環境でコンバーターがサポートされていない場合 (AIX や Solaris など)、専用コンバーターに 3.0.1.x バージョンの converter.war をインストールする必要があります。 詳しくは、Rational Requirements Composer converter application installation を参照してください。

  1. CLM 3.0.1.x をインストールします。セットアップは実行しないでください。 分散構成の場合は、既にインストールしている 3.0.1 アプリケーションに対応する CLM 3.0.1.x アプリケーションをインストールします。
    注: 必ず Jazz Team Server を最初にアップグレードする必要があります。
  2. WebSphere® Application Server のプロファイルをバックアップします。
    1. コマンド・プロンプトを開き、<WAS_Install>/bin ディレクトリーに移動します。 例: /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin
    2. 次のコマンドを実行します。
      ./backupConfig <path to a new compressed file to create back up of profile> (for example ./backupConfig /root/was_backups/clm_301_profile.zip)
      注: 必要に応じて、./restoreConfig コマンドを実行して、バックアップ・プロファイルを復元できます。 例えば、./restoreConfig /root/was_backups/clm_301_profile.zip のようになります。
  3. 3.0.1 アプリケーションを WebSphere Application Server からアンインストールします。
    1. https://<host name>:9043/ibm/console/logon.jsp の WebSphere Application Server Integrated Solutions Console にログオンします。
    2. 「アプリケーション」 > 「アプリケーション・タイプ」 > 「WebSphere エンタープライズ・アプリケーション」をクリックします。
    3. jts_war、ccm_war、および qm_war の各 3.0.1 アプリケーションのセキュリティー・ロールのマッピングを書き留めて、ステップ 16 でそれぞれ 3.0.1.x 用に再マップするときに利用できるようにしておきます。
    4. 次の 3.0.1 アプリケーションを停止してアンインストールします。jts_war、admin_war、ccm_war、qm_war、rm_war、clmhelp_war、converter_war。
    5. プロンプトが表示されたら、変更内容をマスター構成に保存します。
  4. JAZZ_HOME と log4j.configuration のカスタム・プロパティーを更新します。
    1. https://<host name>:9043/ibm/console/logon.jsp の WebSphere Application Server Integrated Solutions Console にログオンします。
    2. 「サーバー」 > 「サーバー・タイプ」 > 「WebSphere Application Servers」をクリックします。
    3. サーバー名をクリックして開きます。デフォルトのサーバー名は server1 です。
    4. 「サーバー・インフラストラクチャー」セクションの下で、「Java およびプロセス管理 (Java and Process Management)」 > 「プロセス定義」をクリックします。
    5. 「追加プロパティー」の下で、「Java 仮想マシン」をクリックします。
    6. 「追加プロパティー」で「カスタム・プロパティー」をクリックします。
    7. JAZZ_HOME をクリックして、値を file:///<3.0.1.x_install_dir>/server/conf に更新します。 例えば、file:///opt/IBM/JazzTeamServer_3.0.1.x/server/conf など。
    8. log4j.configuration をクリックして、値を file:///<3.0.1.x_install_dir>/server/conf/startup_log4j.properties に更新します。 例えば、file:///opt/IBM/JazzTeamServer_3.0.1.x/server/conf/log4j.properties など。
    9. Oracle データベースまたは SQL Server データベースに接続している場合は、ORACLE_JDBC_DRIVER_FILE または SQLSERVER_JDBC_DRIVER_FILE が適切な JDBC ドライブ・ファイルを指していることを確認します。
    10. プロンプトが表示されたら、変更内容をマスター構成に保存します。
      注: 詳しくは、WebSphere Application Server のセットアップを参照してください。
  5. WebSphere Application Server を停止します。
  6. プロファイルの wstemp ディレクトリーと temp ディレクトリーから CLM 関連の内容を削除します。以前インストールしたアプリケーションに応じて、プロファイルの下に次のディレクトリーが存在しており、これらを削除できます。jts_war、admin_war、ccm_war、qm_war、rm_war、clmhelp_war、converter_war。
    <profile directory>/wstemp (for example /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/wstemp)
    <profile directory>/temp (for example /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)
  7. プロファイルのログ・ディレクトリーから、CLM 関連のログを削除します。
    <profile directory>/logs (for example /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs)
  8. CLM 3.0.1.x アプリケーション用にデータベースを準備します。
    1. Derby を使用している場合は、Derby DB を 3.0.1 から 3.0.1.x に移行します。
      cp -R <3.0.1_install_dir>/server/conf/jts/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/jts/derby
      cp -R <3.0.1_install_dir>/server/conf/ccm/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/ccm/derby
      cp -R <3.0.1_install_dir>/server/conf/qm/derby/repositoryDB  <3.0.1.x_install_dir>/server/conf/qm/derby
    2. DB2、Oracle、または SQL Server を使用している場合は、データベースをバックアップします。
  9. アップグレード・ラッパー・スクリプトを使用する場合は、手順 14 にスキップします。
  10. JFS/text の索引を 3.0.1 から 3.0.1.x にコピーします (分散システムの場合は、該当するサーバーに移動してファイルをコピーします)。
    cp -R <3.0.1_install_dir>/server/conf/jts/indices <3.0.1.x_install_dir>/server/conf/jts
    cp -R <3.0.1_install_dir>/server/conf/ccm/indices <3.0.1.x_install_dir>/server/conf/ccm
    cp -R <3.0.1_install_dir>/server/conf/qm/indices <3.0.1.x_install_dir>/server/conf/qm
  11. アプリケーション構成ファイルを 3.0.1 から 3.0.1.1 にコピーします。(分散システムの場合は、該当するサーバーに移動してファイルをコピーします。)
    cp <3.0.1_install_dir>/server/conf/jts/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/jts
    cp <3.0.1_install_dir>/server/conf/ccm/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/ccm
    cp <3.0.1_install_dir>/server/conf/qm/teamserver*.properties  <3.0.1.x_install_dir>/server/conf/qm
    cp <3.0.1_install_dir>/server/conf/admin/admin.properties*  <3.0.1.x_install_dir>/server/conf/admin
    cp <3.0.1_install_dir>/server/conf/admin/friends.rdf*  <3.0.1.x_install_dir>/server/conf/admin
    cp <3.0.1_install_dir>/server/conf/rm/fronting.properties  <3.0.1.x_install_dir>/server/conf/rm
    cp <3.0.1_install_dir>/server/conf/rm/friendsconfig.rdf  <3.0.1.x_install_dir>/server/conf/rm
  12. repotools -addTables コマンドを実行して、データベースが適切な表を持つようにします。(分散システムの場合は、該当するサーバーに移動して repotools コマンドを実行します。)
    cd <3.0.1.x_install_dir>/server
    ./repotools-jts.sh -addTables noPrompt
    ./repotools-ccm.sh -addTables noPrompt
    ./repotools-qm.sh -addTables noPrompt
  13. データウェアハウスを構成している場合は、repotools-jts -createWarehouse コマンドを実行して、データウェアハウスのスキーマを 3.0.1.x にアップデートします。
    cd <3.0.1.x_install_dir>/server
    ./reportools-jts.sh -createWarehouse
  14. アップグレード・ラッパー・スクリプトを使用している場合は、<3.0.1.x_install_dir>/server ディレクトリーに移動します。
    upgrade/jts_upgrade.sh -oldJTSHome <3.0.1_install_dir>/server/conf
    upgrade/ccm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf
    upgrade/qm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf)
    upgrade/rm_upgrade.sh -oldApplicationHome <3.0.1_install_dir>/server/conf
  15. WebSphere Application Server を開始します。
  16. WebSphere Application Server に 3.0.1.x war ファイルをデプロイします。
    1. https://<host name>:9043/ibm/console/logon.jsp の WebSphere Application Server Integrated Solutions Console にログオンします。
    2. 「アプリケーション」 > 「アプリケーション・タイプ」 > 「WebSphere エンタープライズ・アプリケーション」をクリックします。
    3. jts_war、admin_war、ccm_war、qm_war、rm_war、clmhelp_war、converter_war の各ファイルをインストールします。
    4. 次のアプリケーションに対してセキュリティー・ロールを適切にマップします。jts_war、ccm_war、qm_war。
      注: 詳しくは、WebSphere Application Server での CLM アプリケーションのデプロイを参照してください。
  17. 「エンタープライズ・アプリケーション」ページで、次のアプリケーションを開始します。jts_war、admin_war、ccm_war、qm_war、rm_war、clmhelp_war、converter_war。
  18. JTS、CCM、および QM でサーバーをリセットします。
    https://jts_server.mydomain.com:9443/jts/admin#action=com.ibm.team.repository.admin.serverReset
    https://ccm_server.mydomain.com:9443/ccm/admin#action=com.ibm.team.repository.admin.serverReset
    https://rqm_server.mydomain.com:9443/qm/admin#action=com.ibm.team.repository.admin.serverReset
    注: サーバーのリセットを有効にするには、サーバーを再始動する必要があります。
  19. 必要な場合は、3.0.1.x ライセンスをアクティブにします。例えば、マイルストーン・リリースでは、マイルストーンに同梱されている早期アクセス・ライセンスをアクティブにする必要があります。3.0.1.x の最終リリースでは、3.0.1 のライセンスを継続して使用できます。
    1. 管理者として 3.0.1.x Jazz Team Server にログインします。
    2. 「サーバー管理」 > 「ライセンス・キーの管理」ページにナビゲートして、ライセンスをアクティブにします。
    注: すべてセットアップ済みであるため、3.0.1.x システムでセットアップを実行する必要はありません。
    注: アップグレード・プロセスの最新情報については、CLM アップグレードのナレッジ・コレクションを参照してください。

フィードバック