アップグレード・スクリプトを使用すると、アプリケーション・データのアップグレード時に手動で実行する必要があるコマンドの数を最小限に抑えることができます。
始める前に
サーバーをアップグレードする前に、Rational Team Concert バージョン 2 リポジトリー・データベースの最新の
有効なバックアップがあることを確認してください。
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 データベースを使用している場合は、Rational Team Concert データベース (<RTC2_install_dir>¥server¥repositoryDB) を 2 から 3.0.1 にコピーします。詳しくは、Derby データベースのバックアップおよびリストアを参照してください。
複数の製品をアップグレードする場合は、アップグレードの順序を参照してどの製品を先にアップグレードするか決めてください。
手順
- 必要に応じて、デプロイメントおよびアップグレードの計画のセクションのトピックをご確認ください。
- 既存のバージョン 2 の teamserver.properties ファイルでパブリック URL プロパティー com.ibm.team.repository.server.webapp.url を調べます。
バージョン 3.0.1 では同一のパブリック URL を使用する必要があります。パブリック URL が未設定である場合は、アップグレード前にバージョン 2 管理 Web インターフェース (「拡張プロパティー」) を使用して、修飾ホスト名 URL (https://hostname.example.com:port) を設定してください。
teamserver.properties のパブリック URL 行は、次のようなものになります。
com.ibm.team.repository.server.webapp.url=https¥://<hostname.example.com>¥:9443/jazz
- バージョン 2 サーバーをシャットダウンします。
- Jazz Team Server および「変更管理と構成管理 (CCM)」アプリケーションがまだインストールされていなければ、これらを新規の場所にインストールします。Jazz Team Server が既にインストール済みで、バージョン 3.0.1 にアップグレード済みである場合は、「変更管理と構成管理」アプリケーションのみをインストールします。
- インストール時に、「Rational Team Concert 2.x コンテキスト・ルートを使用」を選択します。
- インストール終了時に、「どのプログラムを開始しますか?」で「なし」を選択します。
- Jazz Team Server に、v2.x データベースと同じパラメーターを使用して個別のデータベースを作成します。ただしこの場合、v2.x データベースとは異なる名前を指定します。
データベースの作成について詳しくは、データベースのセットアップを参照してください。
注: CCM データベースとは別の Jazz Team Server データベースが必要です。
新規 JTS データベースをまだ作成していない場合は、作成してください。
- <CCM3.0.1_install_dir>/server にナビゲートして以下のコマンドを実行します。
注: このスクリプトは、コマンド行ですべての引数を指定して実行することができます。別の方法として、アップグレード・スクリプトを複数回再実行する場合は、スクリプトのパラメーター・ファイルを編集して簡略化されたコマンド行を実行することもできます。パラメーター・ファイルの説明については、次のオプションのステップを参照してください。
コマンド行のオプションについてより詳細な情報が必要な場合は、ccm_upgradeを参照してください。
重要: このスクリプト・ファイルはアップグレード・ディレクトリー内にありますが、サーバー・ディレクトリーから実行する必要があります。また、パスにスペースが含まれている場合は、必ず二重引用符で囲んでください。
バージョン 3.0.1 の Jazz Team Server を CCM アプリケーションと一緒にインストールしており、これがアップグレードする最初のアプリケーションであるか、このアプリケーションしかアップグレードしない場合は、コマンド構文は以下のようになります。
Windows
upgrade¥ccm_upgrade.bat -oldApplicationHome <RTC2.x_install_dir>¥server¥conf -createJTSTables
UNIX
upgrade/ccm_upgrade.sh -oldApplicationHome <RTC2.x_install_dir>/server/conf -createJTSTables
注: -createJTSTables パラメーターは、Jazz Team Server 3.0.1 を初めてインストールしているインストール済み環境に適用されます。
例えば分散デプロイメントなどで、バージョン 3.0.1 の Jazz Team Server を CCM アプリケーションとは別にインストールした場合、3.0.1 の Jazz Team Server の場所を指定して、CCM 3.0.1 のインストール・ディレクトリーからスクリプトを実行する必要があります。この場合は、-newJTSHome 引数を組み込んでください。
Windows
upgrade¥ccm_upgrade.bat -oldApplicationHome <RTC2.x_install_dir>¥server¥conf -newJTSHome <JTS3.0.1InstallDir>¥server¥conf
UNIX
upgrade/ccm_upgrade.sh -oldApplicationHome <RTC2.x_install_dir>/server/conf -newJTSHome <JTS3.0.1InstallDir>/server/conf
注: 分散デプロイメントを使用しており、Jazz
Team Server を構成していない場合は、-createJTSTables パラメーターを上記のコマンド行の例に追加することができます。
スクリプトは、示されているユーザー対話を使用して、以下のタスクを実行します。
- オプション: 前述のステップとは別の方法として、スクリプトのパラメーター・ファイルを開いてデフォルト値を変更し、簡略化された形式のコマンド行を実行することもできます。
英語版および翻訳版の 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 インストールで提供される jts.war、ccm.war、および clmhelp.war を再デプロイします。
詳しくは、バージョン 3 アップグレードのための WebSphere Application Server のセットアップを参照してください。
- インストールしたサーバーおよび CLM アプリケーションを構成します。
Jazz Team Server を「変更管理と構成管理」アプリケーションまたはいずれかの CLM アプリケーションと共にアップグレードする場合は、サーバー・セットアップ・ウィザードを実行してください。(セットアップ・ウィザードの実行を参照してください。) 設定済みの Jazz Team Server に「変更管理と構成管理」を追加する場合は、管理 Web インターフェースを使用してください。(Jazz Team Server へのアプリケーションの登録を参照してください。)