このトピックでは、Jazz Team Server および「変更管理と構成管理」をバージョン 3.0 から 3.0.1 にアップグレードするために必要な手順を説明します。
始める前に
サーバーをアップグレードする前に、Rational Team Concert および Jazz
Team Server v3.0 のリポジトリー・データベースの完全に最新の有効なバックアップが作成されていることを確認してください。
さらに、Network Time Protocol (NTP) を使用してすべてのマシンのクロックが同期されるようにしてください。時刻は、あるネットワーク・ノード上のイベントを別のネットワーク・ノード上の対応するイベントにマップできるようにするための不可欠な要素です。問題の発生を防ぐため、NTP サービスを企業全体でデプロイすることで、この課題に対応できます。NTP について詳しくは、http://www.ntp.org/ を参照してください。また、すべてのサーバーで使用されるユーザーの認証方式が同一でなければなりません。
複数の製品をアップグレードする場合は、アップグレードの順序を参照してどの製品を先にアップグレードするか決めてください。
重要: Jazz Team Server とは別に「変更管理と構成管理」アプリケーションをインストールしている分散環境でアップグレード・スクリプトを使用するには、そのアップグレード・スクリプトが、Jazz
Team Server のインストールされているドライブまたはファイル・システムにアクセスできる必要があります。Windows では、マッピングは例えば <mapped drive letter>:¥server¥conf という形式である必要があります。
絶対パス (¥¥<machine name>¥<installdir>server¥conf) は機能しません。マウントされたドライブは、管理者アカウント用の読み取り、書き込み、および実行の特権で構成する必要があります。
Derby データベースを使用している場合は、JTS および CCM データベースを 3.0 から 3.0.1 にコピーします。詳しくは、
Derby データベースのバックアップおよびリストアを参照してください。
注: 同一のデータベースを使用している場合は、データ・マイグレーションは不要です。ただし、アップグレード中にデータベースを切り替える場合は、以前のデータベースからデータをエクスポートして、それを新規データベースにインポートする必要があります。
Jazz Team Server (JTS) のアップグレード
- 必要に応じて、デプロイメントおよびアップグレードの計画のセクションのトピックをご確認ください。
- JTS 3.0 サーバーをシャットダウンします。
- CLM インストールの一環として Jazz Team Server がまだインストールされていなければ、Jazz Team Server をディスク上の新規のロケーションにインストールします。Jazz Team Server が既にインストール済みで、バージョン 3.0.1 にアップグレード済みであり、「変更管理と構成管理」アプリケーションをインストールしてアップグレードする場合は、「変更管理と構成管理 (CCM)」のアップグレードに進んでください。
- インストール時に、「デフォルト 3.x アプリケーション・コンテキスト・ルートを使用する (Use default 3.x application context roots)」を選択します。
- インストール終了時に、「どのプログラムを開始しますか?」で「なし」を選択します。
- <3.0.1JTS_install_dir>/server にナビゲートして以下のコマンドを実行します。
注: このスクリプトは、コマンド行ですべての引数を指定して実行することができます。別の方法として、アップグレード・スクリプトを複数回再実行する場合は、スクリプトのパラメーター・ファイルを編集して簡略化されたコマンド行を実行することもできます。パラメーター・ファイルの説明については、次のオプションのステップを参照してください。
重要: このスクリプト・ファイルはアップグレード・ディレクトリー内にありますが、サーバー・ディレクトリーから実行する必要があります。また、パスにスペースが含まれている場合は、必ず二重引用符で囲んでください。
Windows
upgrade¥jts_upgrade.bat -oldJTSHome <3.0JTS_install_dir>¥server¥conf
UNIX
upgrade/jts_upgrade.sh -oldJTSHome <3.0JTS_install_dir>/server/conf
コマンド行のオプションについてより詳細な情報が必要な場合は、jts_upgradeを参照してください。
スクリプトは、示されているユーザー対話を使用して、以下のタスクを実行します。
- オプション: 前述のステップとは別の方法として、スクリプトのパラメーター・ファイルを開いてデフォルト値を変更し、簡略化された形式のコマンド行を実行することもできます。
英語版および翻訳版の jts_params ファイルは、<3.0.1JTS_install_dir>/server/upgrade/params ディレクトリーにあります。
- ご使用の言語のパラメーター・ファイルの正確な名前を取得するには、<3.0.1JTS_install_dir>¥server¥upgrade ディレクトリーから、Windows の場合は locale.bat -jts -showParamFileName コマンドを、UNIX システムの場合は locale.sh -jts -showParamFileName コマンドを実行します。
- jts_params もしくはその翻訳版のファイルを開いて、各パラメーターの値を編集および指定します。設定が必要なパラメーターの 1 つは、OLD_JTS_HOME ディレクトリーへのパスです。
- Apache Tomcat を使用している場合は、Apache Tomcat のセットアップを参照してください。
- WebSphere Application Server を使用している場合は、以前にインストールした Web アプリケーションをアンインストールし、3.0.1 インストールで提供される jts.war、および clmhelp.war を再デプロイします。
詳しくは、バージョン 3 アップグレードのための WebSphere Application Server のセットアップを参照してください。
- JTS サーバーを開始します。
- セットアップ・ウィザードの実行を継続して、サーバーを構成します。
「変更管理と構成管理 (CCM)」のアップグレード
- 必要に応じて、デプロイメントおよびアップグレードの計画のセクションのトピックをご確認ください。
- CCM 3.0 サーバーをシャットダウンします。
- CCM アプリケーションをディスク上の新規の場所にインストールします。
- インストール時に、「デフォルト 3.x アプリケーション・コンテキスト・ルートを使用する (Use default 3.x application context roots)」を選択します。
重要: Rational Team Concert をバージョン 2 からバージョン 3.0 にアップグレードした場合は、/jazz コンテキスト・ルートを維持するため、「Rational Team Concert 2.x コンテキスト・ルートを使用」を選択します。
- インストール終了時に、「どのプログラムを開始しますか?」で「なし」を選択します。
- <3.0.1CCM_install_dir>/server にナビゲートして以下のコマンドを実行します。
注: このスクリプトは、コマンド行ですべての引数を指定して実行することができます。別の方法として、アップグレード・スクリプトを複数回再実行する場合は、スクリプトのパラメーター・ファイルを編集して簡略化されたコマンド行を実行することもできます。パラメーター・ファイルの説明については、次のオプションのステップを参照してください。
重要: このスクリプト・ファイルはアップグレード・ディレクトリー内にありますが、サーバー・ディレクトリーから実行する必要があります。また、パスにスペースが含まれている場合は、必ず二重引用符で囲んでください。さらに、必ず applicationContextRoot パラメーターを指定し、これを ccm と設定してください。デフォルトでは、applicationContextRoot は jazz です。
Windows
upgrade¥ccm_upgrade.bat -oldApplicationHome <3.0CCM_install_dir>¥server¥conf -applicationContextRoot ccm
UNIX
upgrade/ccm_upgrade.sh -oldApplicationHome <3.0CCM_install_dir>/server/conf -applicationContextRoot ccm
コマンド行のオプションについてより詳細な情報が必要な場合は、ccm_upgradeを参照してください。
スクリプトは、示されているユーザー対話を使用して、以下のタスクを実行します。
- -migration_ccm_updateConfigurationFiles コマンドを実行し、構成ファイルと Tomcat ファイルを更新します。コマンドを実行するには [E] を、このステップをスキップするには [S] を入力し、スクリプトの実行を取り消すには Enter キーを押してください。
- 構成ファイルが正常にマージされたら、[C] を入力して続行してください。メモ帳ウィンドウ (あるいは UNIX システムの場合は vi エディター) が開かれ、ここで CCM の teamserver.properties ファイルを確認できます。
com.ibm.team.repository.server.webapp.url プロパティーで示されるパブリック URI ルートが正しいことを確認します。また、データベース・プロパティーが正しいことも確認します。データベース・ロケーションは、JTS データベース・ロケーションとは異なる必要があります。完了したら、変更がある場合は保存し、エディターを閉じてスクリプトの実行を続けます。構成ファイルの確認について詳しくは、アップグレード中の構成ファイルの確認を参照してください。
- CCM のアップグレードが成功した旨のメッセージが表示されるまで、スクリプトの実行を続けます。
- オプション: 前述のステップとは別の方法として、スクリプトのパラメーター・ファイルを開いてデフォルト値を変更し、簡略化された形式のコマンド行を実行することもできます。
英語版および翻訳版の ccm_params ファイルは、<3.0.1CCM_install_dir>/server/upgrade/params ディレクトリーにあります。
- ご使用の言語のパラメーター・ファイルの正確な名前を取得するには、<3.0.1CCM_install_dir>¥server¥upgrade ディレクトリーから、Windows の場合は locale.bat -ccm -showParamFileName コマンドを、UNIX システムの場合は locale.sh -ccm -showParamFileName コマンドを実行します。
- ccm_params ファイル、またはその翻訳版のファイルを編集用に開いて、各パラメーターの値を指定します。設定が必要なパラメーターの 1 つは、OLD_AAPLICATION_HOME ディレクトリーへのパスです。このパスにはスペースを含めないようにしてください。
- Apache Tomcat を使用している場合は、Apache Tomcat のセットアップを参照してください。
- WebSphere Application Server を使用している場合は、以前にインストールした Web アプリケーションをアンインストールし、3.0.1 インストールで提供される ccm.war を再デプロイします。詳しくは、バージョン 3 アップグレードのための WebSphere Application Server のセットアップを参照してください。
- CCM サーバーを開始します。
- 設定済みの Jazz Team Server に「変更管理と構成管理」を追加する場合は、管理 Web インターフェースをご使用ください。Jazz Team Server へのアプリケーションの登録を参照してください。