本書では、Rational Team Concert 3.0、または Collaborative Lifecycle Management (CLM) バージョン 3.0.1 のサーバー・アプリケーションを CLM バージョン 4.0 にアップグレードする方法について説明します。
メモ: バージョン 2 からバージョン 4 へのアップグレードは、2 ステップからなるプロセスです。まずサーバーをバージョン 3.0.1 にアップグレードしてから、バージョン 4.0 にアップグレードする必要があります。バージョン 2 からバージョン 3.0.1 へのアップグレード手順については、3.0.1 インフォメーション・センターを参照してください。
z/OS での CLM アプリケーションのアップグレードについては、z/OS 上でのアップグレードに関する特別な手順を参照してください。
前のページで行った以下の構成に基づき、このガイドはご使用の製品をアップグレードする詳しい手順を生成します。
メモ: アップグレード・プロセスを開始する前に、CLM 3.0.1 teamserver.properties ファイル内の Derby データベースおよびデータウェアハウスの DB への接続が絶対パスを含んでいることを確認してください。
メモ: Rational solution for CLM 4.0 は既存のデータベースを使用しますが、JRE 5.0 はサポートされなくなりました。サポートされる JRE は 6.0 と 7.0 です。ojdbc6.jar クラス・ライブラリーには JRE 6.0 以降が必要です。ojdbc6.jar を使用する必要があります。詳しくは、Oracle データベースのセットアップを参照してください。
メモ: Rational solution for CLM 4.0 は既存のデータベースを使用しますが、JRE 5.0 はサポートされなくなりました。サポートされる JRE は 6.0 と 7.0 です。sqljdbc4.jar クラス・ライブラリーには JRE 6.0 以降が必要です。sqljdbc4.jar を使用する必要があります。詳しくは、SQL Server データベースのセットアップを参照してください。
Rational solution for Collaborative Lifecycle Management 製品をアップグレードする前に、以下の計画チェックリストの情報を必ず検討してください。
| 計画タスク | 詳細情報 | |
|---|---|---|
| アップグレード・データ・シートを使用する: アップグレード・データ・シートは、アップグレード・プロセス中に必要な特定のデータを収集および記録するのに使用できます。これらには、URL、ユーザー ID、そしてデプロイメントのアップグレードおよび構成に必要なその他の要素などの項目が含まれています。 | データ・シートのアップグレード | |
| ハードウェアとソフトウェアが最小システム要件を満たしていることを確認する: バージョン 4.0 には、64 ビット・サーバーのオペレーティング・システムのみがサポートされるなどの新しい要件がいくつかあります。右側のリンクをクリックしてこれらの新しい要件を調べ、現行システムが最小システム要件を満たしていることを確認してください。 | システム要件 | |
| 製品のインストール・メディアを取得する: ローカル・リポジトリー・ダウンロードの場合、製品インストール・メディアをダウンロードして解凍するために、約 5 ギガバイト (5 GB) のハード・ディスク・スペースが必要です。 | サーバー・インストール・ファイルは、jazz.net からダウンロードできます。 | |
| アップグレード・トポロジーの例を検討する | 分散エンタープライズ・トポロジーの例 | |
| すべてのマシンのクロックを同期化する: 分散環境では、Network Time Protocol (NTP) を使用してすべてのマシンのクロックを確実に同期してください。 | NTP について詳しくは、ntp.org を参照してください。 | |
| デプロイメントおよびアップグレード・プロセスについて理解する: このトピックを読んでアップグレード・プロセスを理解し、制約と考慮事項や各アプリケーションのアップグレードにかかる見積もり時間を確認してください。 | デプロイメントおよびアップグレード・プロセスについての理解 | |
| ご使用のアプリケーションを使用不可にするための計画を立てる: すべてをバックアップし、アプリケーションをバージョン 4.0 に更新する間の短時間、ご使用のアプリケーションを使用不可にするための計画を立てる。Jazz Team Server がオフラインの間、Jazz Team Server に接続されているすべてのアプリケーションはオフラインになります。また、既存アプリケーションの完全なバックアップを作成するための時間も用意してください。 | ||
データベースの前提条件を知る。
|
||
| ライセンス交付に関する学習。バージョン 4 用の新規ライセンスを購入する必要があります。バージョン 4 ライセンスはバージョン 3 アプリケーションと互換性がありますが、バージョン 4 アプリケーションはバージョン 3 ライセンスでは作動しません。 | ライセンスの管理 | |
ブラウザーの互換性を確認する:
|
実稼働環境をアップグレードする前に、問題を回避するためにテスト環境をセットアップすることができます。詳しくは、『アップグレード・プロセスのためのテスト環境のステージング』を参照してください。
3.0.1 Jazz Team Server の管理者サイト https://qualified.host.name:port/jts/admin?internal#action=com.ibm.team.repository.admin.serverReset にアクセスし、サーバーの再設定の要求をクリックします。
3.0.1 変更管理と構成管理の管理者サイト https://qualified.host.name:port/ccm/admin?internal#action=com.ibm.team.repository.admin.serverReset にアクセスし、サーバーの再設定の要求をクリックします。
3.0.1 品質管理の管理者サイト https://qualified.host.name:port/qm/admin?internal#action=com.ibm.team.repository.admin.serverReset にアクセスし、サーバーの再設定の要求をクリックします。
メモ: Rational solution for Collaborative Lifecycle Management をアップグレードする前に、Rational Reporting for Development Intelligence をアップグレードする必要があります。データウェアハウスを Rational Reporting for Development Intelligence と共にアップグレードする必要はありません。Rational solution for CLM のアップグレード中にアップグレード中にアップグレードされます。
Rational Reporting for Development Intelligence バージョン 1.0.2 を持っていてバージョン 2.0 にアップグレードしたい場合は、以下のステップに従ってください。
Rational solution for CLM 4.0 にアップグレードした後で、最新のレポート・サンプルとリソースをダウンロードし、それらをレポート・サーバーにロードします。詳しい手順については、『レポート成果物のアップグレード (Upgrading reporting artifacts)』を参照してください。
CLM 4.0 アプリケーションをインストールします。ただし、セットアップ・ウィザードは実行しないでください。分散構成の場合は、既にインストールしている 3.0.1 アプリケーションに対応する CLM 4.0 アプリケーションをインストールします。 サーバーのインストールについて詳しくは、IBM Installation Manager を使用したインストールを参照してください。
CLM 4.0 アプリケーションをインストールします。ただし、セットアップ・ウィザードは実行しないでください。分散構成の場合は、既にインストールしている 3.0.1 アプリケーションに対応する CLM 4.0 アプリケーションをインストールします。 サーバーのインストールについて詳しくは、ライセンス・プログラムを使用した IBM i へのインストール を参照してください。
メモ: 必ず Jazz Team Server を最初にアップグレードする必要があります。分散環境では、他の CLM アプリケーションをインストールする前に、バージョン 4 ライセンスを必ずインストールしてください。詳しくは『評価版のアクティブ化またはバージョン 4 ライセンスのインストール』のステップを参照してください。
backupConfig.bat Path to a new compressed file to create backup of profile WAS primary administrative user name WAS administrative password (for example, backupConfig.bat C:\WAS_backup\clm_301_profile.zip -username WAS admin -password WAS admin password)
メモ: このディレクトリーは、事前に存在している必要があります。
ヒント: バックアップ・プロファイルは、必要な場合、restoreConfig.bat コマンドを実行して復元することができます。例えば、 restoreConfig.bat C:\WAS_backup\clm_301_profile.zip と入力します。
./backupConfig.sh Path to a new compressed file to create backup of profile WAS primary administrative user name WAS administrative password (for example, ./backupConfig.sh /root/WAS_backup/clm_301_profile.zip -username WAS admin -password WAS admin password)
メモ: このディレクトリーと .zip ファイルは、事前に存在している必要があります。
ヒント: バックアップ・プロファイルは、必要な場合、./restoreConfig.sh コマンドを実行して復元できます。例えば、 ./restoreConfig.sh /root/WAS_backup/clm_301_profile.zip と入力します。
./backupConfig.sh Path to a new compressed file to create backup of profile WAS primary administrative user name WAS administrative password (for example, ./backupConfig.sh /root/WAS_backup/clm_301_profile.zip -username WAS admin -password WAS admin password)
メモ: このディレクトリーと .zip ファイルは、事前に存在している必要があります。
ヒント: バックアップ・プロファイルは、必要な場合、./restoreConfig.sh コマンドを実行して復元できます。例えば、 ./restoreConfig.sh /root/WAS_backup/clm_301_profile.zip と入力します。
メモ: 詳細情報については、WebSphere Application Server のセットアップを参照してください。
stopServer.bat server1 -user admin_userid -password admin_password
./stopServer.sh server1 -user admin_userid -password admin_password
WAS_profile_root\wscache (例: C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
WAS_profile_root\temp (例: C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)
WAS_profile_root/wscache (例: opt/IBM/WebSphere/AppServer/profiles/AppSrv01/wscache)
WAS_profile_root/temp (例: opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)
WAS_profile_root/wscache (例: usr/IBM/WebSphere/AppServer/profiles/AppSrv01/wscache)
WAS_profile_root/temp (例: usr/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)
WAS_profile_root\logs (例: C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\logs)
WAS_profile_root/logs (例: opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs)
WAS_profile_root/logs (例: usr/IBM/WebSphere/AppServer/profiles/AppSrv01/logs)
すべての 3.0.1 アプリケーション・サーバーを停止します。
server.shutdown.bat
./server.shutdown.sh
コマンド・プロンプトを開き、以下のコマンドを入力して、デフォルトの 4.0 Derby repositoryDB ディレクトリーをクリーンアップします。
コマンド・プロンプトを開き、以下のコマンドを入力して、Derby DB を 3.0.1 から 4.0 にコピーします。
メモ: 以下のコマンドでは、パッケージされた製品に含まれている Derby DB を使用していることが前提となっています。Derby DB のロケーションを変更した場合は、既存の 3.0.1 DB のロケーションを代わりに使用するようにコマンドを更新する必要があります。
データウェアハウス・データベースを含めて、DB2 データベースをバックアップします。DB2 データベースのバックアップについては、DB2 データベースのバックアップおよびリストアを参照してください。
データウェアハウス・データベースを含めて、Oracle データベースをバックアップします。データベースのバックアップ手順については、Oracle の資料を参照してください。
データウェアハウス・データベースを含めて、SQL Server データベースをバックアップします。データベースのバックアップ手順については、SQL Server の資料を参照してください。
アップグレードの開始前に、以下のステップに従って、アプリケーションのプロパティー・ファイル内の索引ロケーションが相対パスではなく、ファイル・システムの絶対パスを示していることを確認します。
Jazz Team Server の構成ファイルをアップグレードするには、4.0JTS_install_dir/server に移動し、以下のコマンドを実行します。
repotools-jts.bat -migration_jts_updateConfigurationFiles oldJTSHome=3.0.1JTS_install_dir/server/conf
repotools-jts.bat -addTables
repotools-jts.bat -upgradeWarehouse
repotools-jts.bat -migration_jts_updateConfigurationFiles oldJTSHome=3.0.1JTS_install_dir/server/conf updateTomcatFiles=no
repotools-jts.bat -addTables
repotools-jts.bat -upgradeWarehouse
./repotools-jts.sh -migration_jts_updateConfigurationFiles oldJTSHome=3.0.1JTS_install_dir/server/conf
./repotools-jts.sh -addTables
./repotools-jts.sh -upgradeWarehouse
./repotools-jts.sh -migration_jts_updateConfigurationFiles oldJTSHome=3.0.1JTS_install_dir/server/conf updateTomcatFiles=no
./repotools-jts.sh -addTables
./repotools-jts.sh -upgradeWarehouse
「変更管理と構成管理」アプリケーションの構成ファイルをアップグレードするには、4.0CCM_install_dir/server に移動し、以下のコマンドを実行します。
デフォルトのアプリケーション・コンテキスト・ルートは jazz です。アップグレード・パスがバージョン 3.x からの場合、コマンドで applicationContextRoot=ccm 切り替えを使用します。
repotools-ccm.bat -migration_ccm_updateConfigurationFiles oldApplicationHome=3.0.1CCM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=ccm
repotools-ccm.bat -addTables
repotools-ccm.bat -migration_ccm_updateConfigurationFiles oldApplicationHome=3.0.1CCM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=ccm updateTomcatFiles=no
repotools-ccm.bat -addTables
./repotools-ccm.sh -migration_ccm_updateConfigurationFiles oldApplicationHome=3.0.1CCM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=ccm
./repotools-ccm.sh -addTables
./repotools-ccm.sh -migration_ccm_updateConfigurationFiles oldApplicationHome=3.0.1CCM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=ccm updateTomcatFiles=no
./repotools-ccm.sh -addTables
「品質管理」アプリケーションの構成ファイルをアップグレードするには、4.0QM_install_dir/server に移動し、以下のコマンドを実行します。
デフォルトのアプリケーション・コンテキスト・ルートは jazz です。アップグレード・パスがバージョン 3.x からの場合、コマンドで applicationContextRoot=qm 切り替えを使用します。
repotools-qm.bat -migration_qm_updateConfigurationFiles oldApplicationHome=3.0.1QM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=qm
repotools-qm.bat -addTables
repotools-qm.bat -migration_qm_updateConfigurationFiles oldApplicationHome=3.0.1QM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=qm updateTomcatFiles=no
repotools-qm.bat -addTables
./repotools-qm.sh -migration_qm_updateConfigurationFiles oldApplicationHome=3.0.1QM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=qm
./repotools-qm.sh -addTables
./repotools-qm.sh -migration_qm_updateConfigurationFiles oldApplicationHome=3.0.1QM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=qm updateTomcatFiles=no
./repotools-qm.sh -addTables
「要求管理」アプリケーションの構成ファイルをアップグレードするには、以下のステップを実行します。
upgrade\rm\rm_upgrade.bat -oldApplicationHome C:\Temp\RM3.0.1\server\conf -oldJTSHome 3.0.1JTS_install_dir\server\conf -newJTSHome 4.0JTS_install_dir\server\conf applicationContextRoot=rm
デフォルトのアプリケーション・コンテキスト・ルートは rdm です。アップグレード・パスがバージョン 3.x からの場合、コマンドで applicationContextRoot=rm 切り替えを使用します。
upgrade\rm\rm_upgrade.bat -oldApplicationHome C:\Temp\RM3.0.1\server\conf -oldJTSHome 3.0.1JTS_install_dir\server\conf -newJTSHome 4.0JTS_install_dir\server\conf -updateTomcatFiles=no applicationContextRoot=rm
デフォルトのアプリケーション・コンテキスト・ルートは rdm です。アップグレード・パスがバージョン 3.x からの場合、コマンドで applicationContextRoot=rm 切り替えを使用します。
upgrade/rm/rm_upgrade.sh -oldApplicationHome opt/tmp/rm3.0.1/server/conf -oldJTSHome 3.0.1JTS_install_dir/server/conf -newJTSHome 4.0JTS_install_dir/server/conf applicationContextRoot=rm
デフォルトのアプリケーション・コンテキスト・ルートは rdm です。アップグレード・パスがバージョン 3.x からの場合、コマンドで applicationContextRoot=rm 切り替えを使用します。
upgrade/rm/rm_upgrade.sh -oldApplicationHome opt/tmp/rm3.0.1/server/conf -oldJTSHome 3.0.1JTS_install_dir/server/conf -newJTSHome 4.0JTS_install_dir/server/conf -updateTomcatFiles=no applicationContextRoot=rm
デフォルトのアプリケーション・コンテキスト・ルートは rdm です。アップグレード・パスがバージョン 3.x からの場合、コマンドで applicationContextRoot=rm 切り替えを使用します。
上記のコマンドは、以下のタスクを実行します。
留意事項: Tomcat ユーザー・データベースの場合のみ。tomcat-users.xml ファイルはコピーされます (既存のファイルにマージされません)。共通の JTS と共に複数の CLM アプリケーションをアップグレードしている場合は、ユーザーおよびグループの情報を tomcat-users.xml ファイルに手動でマージする必要があります。ユーザーが異なるアプリケーションの異なるグループに属している場合、ユーザーおよびグループの情報は異なります。例えば、userA が CCM では JazzAdmins 役割を持ち、QM では JazzUsers 役割を持つことがあります。さらに、一方のアプリケーションでは何人かのユーザーが存在し、もう一方のアプリケーションには存在しない場合 (あるいはその逆)、それらのユーザーを手動で tomcat-users.xml ファイルに追加する必要があります。
これらのリポジトリー・ツール・コマンドについて詳しくは、以下を参照してください。
重要: このスクリプト・ファイルは upgrade/application context root ディレクトリーにありますが、サーバー・ディレクトリーから実行する必要があります。また、パスにスペースが含まれている場合は、パス名を二重引用符で囲んでください。
メモ: Jazz Team Server とは別に CLM アプリケーションをインストールした分散環境でアップグレード・スクリプトを使用するためには、そのアップグレード・スクリプトが、アプリケーションがインストールされているドライブまたはファイル・システムにアクセスできる必要があります。例えば、Windows では、マウントは mounted drive letter:\server\conf の形式で実行する必要があります。\\machine name\JTS40InstallDir\server\conf などの絶対パスは機能しません。マウントされたドライブは、管理者アカウント用の読み取り、書き込み、および実行の特権で構成する必要があります。
Jazz Team Server をアップグレードするには、コマンド・プロンプトを開き、JTS_4.0_install_dir\server ディレクトリーに移動し、以下のコマンドを実行します。
upgrade\jts\jts_upgrade.bat
upgrade\jts\jts_upgrade.bat -oldJTSHome JTS_3.0.1_install_dir\server\conf
アップグレード中に、構成ファイルがマージされた後で、メモ帳ウィンドウが開かれ、ここで Jazz Team Server の teamserver.properties ファイルを確認できます。 com.ibm.team.fulltext.indexlocation プロパティーのロケーションが相対パスの場合は、パスを変更する必要はありません。ロケーションが絶対パスの場合は、そのディレクトリーが安定していて、アンインストールの結果削除されることがないことを確認してください。安定した絶対ロケーションとは、例えば、 com.ibm.team.fulltext.indexLocation=JTS_4.0_install_dir/server/conf/jts/indices/workitemindex (ここで JTS_4.0_install_dir は Jazz Team Server 4.0 がインストールされているロケーション) のようになります。
「変更管理と構成管理」アプリケーションをアップグレードするには、コマンド・プロンプトを開き、CCM_4.0_install_dir\server ディレクトリーに移動し、以下のコマンドを実行します。
upgrade\ccm\ccm_upgrade.bat -oldApplicationHome CCM_3.0.1_install_dir\server\conf
upgrade\ccm\ccm_upgrade.bat -oldApplicationHome CCM_3.0.1_install_dir\server\conf -newJTSHome JTS_4.0_install_dir\server\conf
アップグレード中に、構成ファイルがマージされた後で、メモ帳ウィンドウが開かれ、ここで変更管理と構成管理の teamserver.properties ファイルを確認できます。ロケーションが絶対パスの場合は、そのディレクトリーが安定していて、アンインストールの結果削除されることがないことを確認してください。安定した絶対ロケーションとは、例えば、com.ibm.team.fulltext.indexLocation=CCM_4.0_install_dir/server/conf/ccm/indices/workitemindex (ここで CCM_4.0_install_dir は「変更管理と構成管理」アプリケーション 4.0 がインストールされているロケーション) のようになります。
「品質管理」アプリケーションをアップグレードするには、コマンド・プロンプトを開き、 QM_4.0_install_dir\server ディレクトリーに移動し、以下のコマンドを実行します。
upgrade\qm\qm_upgrade.bat -oldApplicationHome QM_3.0.1_install_dir\server\conf
upgrade\qm\qm_upgrade.bat -oldApplicationHome QM_3.0.1_install_dir\server\conf -newJTSHome JTS_4.0_install_dir\server\conf
アップグレード中に、構成ファイルがマージされた後で、メモ帳ウィンドウが開かれ、ここで品質管理の teamserver.properties ファイルを確認できます。ロケーションが絶対パスの場合は、そのディレクトリーが安定していて、アンインストールの結果削除されることがないことを確認してください。安定した絶対ロケーションとは、例えば、com.ibm.team.fulltext.indexLocation=QM_4.0_install_dir/server/conf/qm/indices/workitemindex (ここで QM_4.0_install_dir は「品質管理」アプリケーション 4.0 がインストールされているロケーション) のようになります。
「要求管理」アプリケーションをアップグレードするには、コマンド・プロンプトを開き、RM_4.0_install_dir\server ディレクトリーに移動し、以下のコマンドを実行します。
upgrade\rm\rm_upgrade.bat -oldApplicationHome RM_3.0.1_install_dir\server\conf
upgrade\rm\rm_upgrade.bat -oldApplicationHome RM_3.0.1_install_dir\server\conf -newJTSHome JTS_4.0_install_dir\server\conf -oldJTSHome JTS_3.0.1_install_dir\server\conf
Jazz Team Server をアップグレードするには、コマンド・シェルを開き、JTS_4.0_install_dir/server ディレクトリーに移動し、以下のコマンドを実行します。
upgrade/jts/jts_upgrade.sh
upgrade/jts/jts_upgrade.sh -oldJTSHome JTS_3.0.1_install_dir/server/conf
アップグレード中に、構成ファイルがマージされた後で、vi エディターが開かれ、ここで Jazz Team Server の teamserver.properties ファイルを確認できます。ロケーションが絶対パスの場合は、そのディレクトリーが安定していて、アンインストールの結果削除されることがないことを確認してください。安定した絶対ロケーションとは、例えば、 com.ibm.team.fulltext.indexLocation=JTS_4.0_install_dir/server/conf/jts/indices/workitemindex (ここで JTS_4.0_install_dir は Jazz Team Server 4.0 がインストールされているロケーション) のようになります。
「変更管理と構成管理」アプリケーションをアップグレードするには、コマンド・シェルを開き、CCM_4.0_install_dir/server ディレクトリーに移動し、以下のコマンドを実行します。
upgrade/ccm/ccm_upgrade.sh -oldApplicationHome CCM_3.0.1_install_dir/server/conf
upgrade/ccm/ccm_upgrade.sh -oldApplicationHome CCM_3.0.1_install_dir/server/conf -newJTSHome 4.0JTS_install_dir/server/conf
アップグレード中に、構成ファイルがマージされた後で、vi エディターが開かれ、ここで「変更管理と構成管理」の teamserver.properties ファイルを確認できます。ロケーションが絶対パスの場合は、そのディレクトリーが安定していて、アンインストールの結果削除されることがないことを確認してください。安定した絶対ロケーションとは、例えば、com.ibm.team.fulltext.indexLocation=CCM_4.0_install_dir/server/conf/ccm/indices/workitemindex (ここで CCM_4.0_install_dir は「変更管理と構成管理」アプリケーション 4.0 がインストールされているロケーション) のようになります。
「品質管理」アプリケーションをアップグレードするには、コマンド・シェルを開き、 QM_4.0_install_dir/server ディレクトリーに移動し、以下のコマンドを実行します。
upgrade/qm/qm_upgrade.sh -oldApplicationHome QM_3.0.1_install_dir/server/conf
upgrade/qm/qm_upgrade.sh -oldApplicationHome QM_3.0.1_install_dir/server/conf -newJTSHome JTS_4.0_install_dir/server/conf
アップグレード中に、構成ファイルがマージされた後で、vi エディターが開かれ、ここで品質管理の teamserver.properties ファイルを確認できます。ロケーションが絶対パスの場合は、そのディレクトリーが安定していて、アンインストールの結果削除されることがないことを確認してください。安定した絶対ロケーションとは、例えば、com.ibm.team.fulltext.indexLocation=QM_4.0_install_dir/server/conf/qm/indices/workitemindex (ここで QM_4.0_install_dir は「品質管理」アプリケーション 4.0 がインストールされているロケーション) のようになります。
「要求管理」アプリケーションをアップグレードするには、コマンド・シェルを開き、RM_4.0_install_dir/server ディレクトリーに移動し、以下のコマンドを実行します。
upgrade/rm/rm_upgrade.sh -oldApplicationHome RM_3.0.1_install_dir/server/conf
upgrade/rm/rm_upgrade.sh -oldApplicationHome RM_3.0.1_install_dir/server/conf -newJTSHome JTS_4.0_install_dir/server/conf -oldJTSHome JTS_3.0.1_install_dir/server/conf
Jazz Team Server をアップグレードするには、コマンド・プロンプトを開き、JTS_4.0_install_dir\server ディレクトリーに移動し、以下のコマンドを実行します。
upgrade\jts\jts_upgrade.bat -updateTomcatFiles=no
upgrade\jts\jts_upgrade.bat -oldJTSHome JTS_3.0.1_install_dir\server\conf -updateTomcatFiles=no
アップグレード中に、構成ファイルがマージされた後で、メモ帳ウィンドウが開かれ、ここで Jazz Team Server の teamserver.properties ファイルを確認できます。com.ibm.team.fulltext.indexlocation プロパティーのロケーションがこのファイル内の相対パスの場合は、絶対パスに変更する必要があり、その特定ディレクトリーは安定していて、アンインストールの結果削除されることがないことを確認してください。不安定なディレクトリーの例は、3.0.1_install_dir などで、このようなディレクトリーはアンインストールされる可能性があり、索引ファイルを失うことになります。安定した絶対ロケーションとは、例えば、 com.ibm.team.fulltext.indexLocation=JTS_4.0_install_dir/server/conf/jts/indices/workitemindex (ここで JTS_4.0_install_dir は Jazz Team Server 4.0 がインストールされているロケーション) のようになります。
「変更管理と構成管理」アプリケーションをアップグレードするには、コマンド・プロンプトを開き、CCM_4.0_install_dir\server ディレクトリーに移動し、以下のコマンドを実行します。
upgrade\ccm\ccm_upgrade.bat -oldApplicationHome CCM_3.0.1_install_dir\server\conf -updateTomcatFiles=no
upgrade\ccm\ccm_upgrade.bat -oldApplicationHome CCM_3.0.1_install_dir\server\conf -newJTSHome JTS_4.0_install_dir\server\conf -updateTomcatFiles=no
アップグレード中に、構成ファイルがマージされた後で、メモ帳ウィンドウが開かれ、ここで「変更管理と構成管理」アプリケーションの teamserver.properties ファイルを確認できます。com.ibm.team.fulltext.indexlocation プロパティーのロケーションがこのファイル内の相対パスの場合は、絶対パスに変更する必要があり、その特定ディレクトリーは安定していて、アンインストールの結果削除されることがないことを確認してください。不安定なディレクトリーの例は、3.0.1_install_dir などで、このようなディレクトリーはアンインストールされる可能性があり、索引ファイルを失うことになります。安定した絶対ロケーションとは、例えば、com.ibm.team.fulltext.indexLocation=CCM_4.0_install_dir/server/conf/ccm/indices/workitemindex (ここで CCM_4.0_install_dir は「変更管理と構成管理」アプリケーション 4.0 がインストールされているロケーション) のようになります。
「品質管理」アプリケーションをアップグレードするには、コマンド・プロンプトを開き、 QM_4.0_install_dir\server ディレクトリーに移動し、以下のコマンドを実行します。
upgrade\qm\qm_upgrade.bat -oldApplicationHome QM_3.0.1_install_dir\server\conf -updateTomcatFiles=no
upgrade\qm\qm_upgrade.bat -oldApplicationHome QM_3.0.1_install_dir\server\conf -newJTSHome 4.0JTS_install_dir\server\conf -updateTomcatFiles=no
アップグレード中に、構成ファイルがマージされた後で、メモ帳ウィンドウが開かれ、ここで「品質管理」アプリケーションの teamserver.properties ファイルを確認できます。com.ibm.team.fulltext.indexlocation プロパティーのロケーションがこのファイル内の相対パスの場合は、絶対パスに変更する必要があり、その特定ディレクトリーは安定していて、アンインストールの結果削除されることがないことを確認してください。不安定なディレクトリーの例は、3.0.1_install_dir などで、このようなディレクトリーはアンインストールされる可能性があり、索引ファイルを失うことになります。安定した絶対ロケーションとは、例えば、com.ibm.team.fulltext.indexLocation=QM_4.0_install_dir/server/conf/qm/indices/workitemindex (ここで QM_4.0_install_dir は「品質管理」アプリケーション 4.0 がインストールされているロケーション) のようになります。
「要求管理」アプリケーションをアップグレードするには、コマンド・プロンプトを開き、4.0RM_install_dir\server ディレクトリーに移動し、以下のコマンドを実行します。
upgrade\rm\rm_upgrade.bat -oldApplicationHome RM_3.0.1_install_dir\server\conf -updateTomcatFiles=no
upgrade\rm\rm_upgrade.bat -oldApplicationHome RM_3.0.1_install_dir\server\conf -newJTSHome JTS_4.0_install_dir\server\conf -oldJTSHome JTS_3.0.1_install_dir\server\conf -updateTomcatFiles=no
Jazz Team Server をアップグレードするには、コマンド・シェルを開き、JTS_4.0_install_dir/server ディレクトリーに移動し、以下のコマンドを実行します。
upgrade/jts/jts_upgrade.sh -updateTomcatFiles=no
upgrade/jts/jts_upgrade.sh -oldJTSHome JTS_3.0.1_install_dir/server/conf -updateTomcatFiles=no
アップグレード中に、構成ファイルがマージされた後で、vi エディターが開かれ、ここで Jazz Team Server の teamserver.properties ファイルを確認できます。com.ibm.team.fulltext.indexlocation プロパティーのロケーションがこのファイル内の相対パスの場合は、絶対パスに変更する必要があり、その特定ディレクトリーは安定していて、アンインストールの結果削除されることがないことを確認してください。不安定なディレクトリーの例は、3.0.1_install_dir などで、このようなディレクトリーはアンインストールされる可能性があり、索引ファイルを失うことになります。安定した絶対ロケーションとは、例えば、 com.ibm.team.fulltext.indexLocation=JTS_4.0_install_dir/server/conf/jts/indices/workitemindex (ここで JTS_4.0_install_dir は Jazz Team Server 4.0 がインストールされているロケーション) のようになります。
「変更管理と構成管理」アプリケーションをアップグレードするには、コマンド・シェルを開き、4.0CCM_install_dir/server ディレクトリーに移動し、以下のコマンドを実行します。
upgrade/ccm/ccm_upgrade.sh -oldApplicationHome CCM_3.0.1_install_dir/server/conf -updateTomcatFiles=no
upgrade/ccm/ccm_upgrade.sh -oldApplicationHome CCM_3.0.1_install_dir/server/conf -newJTSHome JTS_4.0_install_dir/server/conf -updateTomcatFiles=no
アップグレード中に、構成ファイルがマージされた後で、vi エディターが開かれ、ここで「変更管理と構成管理」アプリケーションの teamserver.properties ファイルを確認できます。com.ibm.team.fulltext.indexlocation プロパティーのロケーションがこのファイル内の相対パスの場合は、絶対パスに変更する必要があり、その特定ディレクトリーは安定していて、アンインストールの結果削除されることがないことを確認してください。不安定なディレクトリーの例は、3.0.1_install_dir などで、このようなディレクトリーはアンインストールされる可能性があり、索引ファイルを失うことになります。安定した絶対ロケーションとは、例えば、com.ibm.team.fulltext.indexLocation=CCM_4.0_install_dir/server/conf/ccm/indices/workitemindex (ここで CCM_4.0_install_dir は「変更管理と構成管理」アプリケーション 4.0 がインストールされているロケーション) のようになります。
「品質管理」アプリケーションをアップグレードするには、コマンド・シェルを開き、 QM_4.0_install_dir/server ディレクトリーに移動し、以下のコマンドを実行します。
upgrade/qm/qm_upgrade.sh -oldApplicationHome QM_3.0.1_install_dir/server/conf -updateTomcatFiles=no
upgrade/qm/qm_upgrade.sh -oldApplicationHome QM_3.0.1_install_dir/server/conf -newJTSHome JTS_4.0_install_dir/server/conf -updateTomcatFiles=no
アップグレード中に、構成ファイルがマージされた後で、vi エディターが開かれ、ここで「品質管理」アプリケーションの teamserver.properties ファイルを確認できます。com.ibm.team.fulltext.indexlocation プロパティーのロケーションがこのファイル内の相対パスの場合は、絶対パスに変更する必要があり、その特定ディレクトリーは安定していて、アンインストールの結果削除されることがないことを確認してください。不安定なディレクトリーの例は、3.0.1_install_dir などで、このようなディレクトリーはアンインストールされる可能性があり、索引ファイルを失うことになります。安定した絶対ロケーションとは、例えば、com.ibm.team.fulltext.indexLocation=QM_4.0_install_dir/server/conf/qm/indices/workitemindex (ここで QM_4.0_install_dir は「品質管理」アプリケーション 4.0 がインストールされているロケーション) のようになります。
「要求管理」アプリケーションをアップグレードするには、コマンド・シェルを開き、RM_4.0_install_dir/server ディレクトリーに移動し、以下のコマンドを実行します。
upgrade/rm/rm_upgrade.sh -oldApplicationHome RM_3.0.1_install_dir/server/conf -updateTomcatFiles=no
upgrade/rm/rm_upgrade.sh -oldApplicationHome RM_3.0.1_install_dir/server/conf -newJTSHome JTS_4.0_install_dir/server/conf -oldJTSHome JTS_3.0.1_install_dir/server/conf -updateTomcatFiles=no
上記のスクリプトはリポジトリー・ツール・コマンドを使用して、構成ファイルの更新や、データベースおよびデータウェアハウス・スキーマのバージョン 4.0 への更新を行います。詳しくは、スクリプト・ファイルのアップグレード (Upgrade script files) を参照してください。
upgrade/jts/jts_upgrade.sh -oldJTSHome /QIBM/UserData/JazzTeamServer301/server/conf -oldJTSVersion 3.0.1
upgrade/ccm/ccm_upgrade.sh -oldApplicationHome /QIBM/UserData/JazzTeamServer301/server/conf -oldApplicationVersion 3.0.1 -ignoreJTSVersionCheck
upgrade/qm/qm_upgrade.sh -oldApplicationHome /QIBM/UserData/JazzTeamServer301/server/conf -oldApplicationVersion 3.0.1 -ignoreJTSVersionCheck
upgrade/rm/rm_upgrade.sh -oldApplicationHome /QIBM/UserData/JazzTeamServer301/server/conf -oldApplicationVersion 3.0.1 -ignoreJTSVersionCheck
upgrade/was_upgrade.sh profileName serverName nodeName wasVersion wasOption maxHeapSize adminId adminPwd jvmVersion jazzAppName jtsAppName clmHelpAppName qmAppName rmAppName adminAppName
ここで:
重要: これらのステップは、teamserver.properties ファイル内の索引ファイルのロケーションが相対パスである場合、または絶対パスであるが不安定なディレクトリーにある場合にのみ、実行してください。不安定なディレクトリーの例は、3.0.1_install_dir などで、このようなディレクトリーはアンインストールされる可能性があり、索引ファイルを失うことになります。
JFS/text 索引を 3.0.1 から 4.0 にコピーします。分散システムの場合は、該当するサーバーに移動して以下のファイルをコピーします。
JFS/text 索引を 3.0.1 から 4.0 にコピーするには、以下のステップに従ってください。分散システムの場合は、該当するサーバーに移動して以下のファイルをコピーします。
メモ: JRE6 JDBC ドライバーを指すように JDBC 環境変数を切り替えたことを確認してください。 詳しくは、Oracle データベースのセットアップを参照してください。
メモ: JRE6 JDBC ドライバーを指すように JDBC 環境変数を切り替えたことを確認してください。 詳しくは、SQL Server データベースのセットアップを参照してください。
startServer.bat server1 -user admin_userid -password admin_password
./startServer.sh server1 -user admin_userid -password admin_password
メモ: IBM Installation Manager を使用して CLM アプリケーションをインストールし、インストール中に Tomcat 7 Application Server のチェック・ボックスをクリアした場合は、デフォルトで、Web アプリケーション・ファイル (.war) は JazzInstallDir/server/webapps ディレクトリーにコピーされます。インストール中に Tomcat 7 Application Server を選択した場合、Web アプリケーション・ファイル (.war) が JazzInstallDir/server/tomcat/webapps ディレクトリーにコピーされます。
詳細情報については、WebSphere Application Server での CLM アプリケーションのデプロイを参照してください。
重要: ご使用環境でコンバーターがサポートされていない場合 (AIX や Solaris など) は、専用コンバーターに converter.war の 4.0 バージョンをインストールする必要があります。詳しくは、Rational Requirements Composer converter application installation を参照してください。
メモ: JRE6 JDBC ドライバーを指すように JDBC 環境変数を切り替えたことを確認してください。 詳しくは、Oracle データベースのセットアップを参照してください。
メモ: JRE6 JDBC ドライバーを指すように JDBC 環境変数を切り替えたことを確認してください。 詳しくは、SQL Server データベースのセットアップを参照してください。
すべての 4.0 アプリケーション・サーバーを開始します。
server.startup.bat
./server.startup.sh
バージョン 4.0 用の新規ライセンスを購入する必要があります。バージョン 4 ライセンスはバージョン 3 アプリケーションと互換性がありますが、バージョン 4 アプリケーションはバージョン 3 ライセンスでは作動しません。バージョン 3 用のフローティング、トークン、または許可ユーザーのシングル・インストールのライセンスが使用されていた場合には、バージョン 4.0 の該当ライセンスをインストールします。既存のバージョン 3 ユーザー・ライセンス割り当ては、バージョン 4 ライセンスのインストール中に保持されます。
バージョン 4 ライセンスをまだ購入していない場合、評価版ライセンスをアクティブ化して、限られた期間使用することができます。評価版ライセンスをアクティブにするには、以下のステップを実行してください。
メモ: 評価版ライセンスを使用している場合、次のステップ「Rational Requirements Composer のマイグレーション」を実行する前に、RRC のアップグレードを実行する管理者ユーザーに評価版ライセンスを割り当てる必要があります。
ライセンスについて詳しくは、ライセンスの管理を参照してください。
メモ: Requirements Composer のバージョン 4.0 へのアップグレード・プロセスでは、Requirements Composer アプリケーションを再始動してからオンライン・マイグレーション・ウィザードを完了するまで、Jazz Team Server は読み取り専用モードになります。
重要: アップグレードの開始後は、アップグレードが完了するまでこの操作は取り消すことができません。
CLM 3.0.1 のインストールでデータウェアハウスの構成をスキップしており、4.0 で構成する場合は、以下のステップに従ってください。
メモ: セットアップ・ウィザードの実行は、4.0 サーバーのセットアップには必要ではなく、CLM 3.0.1 でデータウェアハウスの構成をスキップした場合に、それを行うためにのみ使用されます。
アップグレード・プロセスが完了した後で、以下のチェックリストを使用してすべてがうまくいったかどうか確認します。
| 検証タスク | 詳細情報 | |
|---|---|---|
以下のアプリケーションの構成ファイルが V3.0.1 から V4.0 にコピーされたことを確認します。
|
||
各 teamserver.properties ファイルに以下の情報が含まれていることを確認してください。
|
||
以下のようにアプリケーション・サーバーを確認します。
|
サーバーのデプロイおよび始動 | |
サーバー・ログの検証: 次のサーバー・ログを調べて、
アップグレード後情報があることを確認します。
|
||
| パブリック URL の検証: Jazz Team Server、「変更管理と構成管理」アプリケーション、または「品質管理」アプリケーションをアップグレードした場合、アプリケーションの状況要約ページのパブリック URL が、前のバージョンで使用していたものと同じであることを確認します。 | ||
| Jazz Team Server 管理 Web インターフェースのリンクの検証: Web ブラウザーを開いて Jazz Team Server の「管理」ページ (https://[hostname.example.com]:9443/jts/admin) に移動します。そして、エラーが表示されていないことを確認します。 | Jazz Team Server 管理 Web インターフェース | |
| アプリケーション管理 Web インターフェースのリンクの検証: Web ブラウザーを開いてアプリケーションの「管理」ページ (https://[hostname.example.com]:9443/[application context root]/admin) に移動します。そして、エラーが表示されていないことを確認します。 | アプリケーション管理 Web インターフェース | |
ユーザー、ライセンス、およびリンク成果物の検証:
|
ユーザー、ライセンス、およびリンク成果物の検証 |
Rational Developer for System z
Rational Developer for System z は Rational Team Concert on System z と統合することにより、統合された協調アプリケーション開発環境を z/OS 開発者に提供します。この統合ソリューションにより、Rational Developer for System z の個々の開発環境のバリューに Rational Team Concert のチーム・コラボレーションの機能が付加されます。詳細については、Rational Team Concert および Rational Developer for System z を参照してください。
Rational ClearQuest
Rational Team Concert には、ユーザーの作業を Rational ClearQuest に統合するために役立ついくつかのツールが含まれています。これらのツールとは、Rational ClearQuest Synchronizer、Rational ClearQuest Bridge、および Rational ClearQuest Importer です。詳細については、Rational Team Concert および Rational ClearQuest を参照してください。
ClearQuest Synchronizer (以前、Connector と呼ばれていた) を使用して、Rational Quality Manager を Rational ClearQuest 障害トラッキング・システムに統合することができます。詳細については、Rational Quality Manager および Rational ClearQuest を参照してください。
Rational Requirements Composer を Rational ClearQuest に統合し、要求を障害、タスク、拡張要求、およびその他のレコード・タイプに関連付けるようにアプリケーションを構成することができます。詳細については、Rational Requirements Composer および Rational ClearQuest を参照してください。
Rational ClearCase
Rational Team Concert には、Rational Team Concert と Rational ClearCase の間の操作をサポートする ClearCase Connector が組み込まれています。詳細については、Rational Team Concert および Rational ClearCase を参照してください。
Rational Build Forge
Rational Team Concert と Rational Build Forge 間の統合により、Rational Build Forge ビルド・エンジンおよび定義を作成して、Build Forge プロジェクトに統合することができます。詳細については、Rational Team Concert および Rational Build Forge を参照してください。
Hudson
Rational Team Concert と Hudson 間の統合により、Hudson ビルド・エンジンおよび定義を作成して、Hudson プロジェクトに統合することができます。詳細については、Rational Team Concert および Hudson を参照してください。
Subversion
Rational Team Concert では、Subversion と Rational Team Concert ソース管理の両方を使用するチームが共同作業を行うためのいくつかの方法が提供されています。詳細については、Rational Team Concert および Subversion を参照してください。
Rational DOORS
Rational DOORS を使用して要求を管理し、Rational Team Concert ワークアイテム機能を使用してそれらの要求を変更管理の制御下に置くことができます。詳細については、Rational Team Concert および Rational DOORS を参照してください。
Rational Quality Manager を Rational DOORS に統合することにより、Rational DOORS からの要求をテスト計画またはテスト・ケースに関連付けてトラッキングすることができます。詳細については、Rational Quality Manager および Rational DOORS を参照してください。
Rational Focal Point
Rational Focal Point を使用することにより、ビジネス・ニーズを取り込んで優先順位付けし、それらを Rational Team Concert にプロジェクトとしてエクスポートすることができます。詳細については、Rational Team Concert および Rational Focal Point を参照してください。
Lotus Connections
Rational Team Concert は、Lotus Connections への統合を提供します。これにより、変更管理と構成管理のリソースと成果物が Lotus Connections コミュニティーのリソースと成果物に関連付けられます。詳細については、Rational Team Concert および Lotus Connections を参照してください。
Rational Developer for Power Systems Software
Rational Team Concert は Rational Developer for Power Systems Software と統合することにより、IBM i 開発者に、統合された協調アプリケーション開発環境を提供します。この統合ソリューションにより、Rational Team Concert のチーム・コラボレーションの機能のバリューに、Rational Developer for Power Systems Software の個々の開発環境が付加されます。詳細については、Rational Team Concert および Rational Developer for Power Systems Software を参照してください。
Rational RequisitePro
Rational Quality Manager と Rational RequisitePro の統合により、要求ビューとパッケージを Rational RequisitePro から「品質管理」アプリケーション内のテスト計画に追加することができます。詳細については、Rational Quality Manager および Rational RequisitePro を参照してください。
Rational Change
IBM Rational Change Open Services for Lifecycle Collaboration Change Management (OSLC-CM) API を使用して新規変更依頼を実行依頼し、実行結果を「品質管理」Web インターフェースから直接それらにリンクすることができます。詳細については、Rational Quality Manager および Rational Change を参照してください。
Rational テスト・ツール
Rational Quality Manager を使用して、テスト Lab マシンまたは共有ネットワーク・ロケーションにある自動化されたテストを実行することができます。詳細については、Rational Quality Manager および Rational テスト・ツールを参照してください。
Selenium
Selenium との統合は、JUnit Selenium アダプターを使用して実装できます。これにより、Selenium バージョン 2.0 WebDriver JUnit4 テストを「品質管理」アプリケーションで実行することができます。詳細については、Rational Quality Manager および Selenium を参照してください。
ソフトウェア・インベントリーおよび自動化ツール
Rational Quality Manager を、Rational Build Forge および Software Testing Automation Framework (STAF) Software Testing Automation Framework Execution Engine (STAX) などのソフトウェア・インベントリーおよび自動化ツールと統合することができます。詳細については、Rational Quality Manager およびソフトウェア・インベントリーと自動化ツールを参照してください。
Rational Software Architect Design Manager
重要: 設計管理はベータ機能と見なされており、評価目的でのみ使用されます。詳しくは、Jazz.net の設計管理プロジェクトを参照してください。
IBM Rational Software Architect Design Manager を、Rational solution for Collaborative Lifecycle Management (CLM) 内の要求管理 (RM) アプリケーションおよび「変更管理と構成管理」アプリケーションと統合することができます。この統合を使用して、設計モデルとモデル・リソースを、要求、要求に関連する成果物、ワークアイテム、およびその他の開発成果物にリンクすることができます。詳細については、Rational Requirements Composer および Rational Software Architect Design Manager を参照してください。