relm_upgrade スクリプト参照

relm_upgrade スクリプトは、Rational® Engineering Lifecycle Manager の旧バージョンからの更新時に使用されます。

目的

Rational Engineering Lifecycle Manager の詳細なアップグレード・プロセスは、Rational Engineering Lifecycle Manager のアップグレードに記載されています。アップグレード・スクリプト内のパラメーターは、 デフォルト以外の値を使用する場合、変更が必要になることがあります。

relm_upgrade スクリプトは、 Rational Engineering Lifecycle Manager 1.0、1.0.0.1、4.0.3 または 4.0.4 を 4.0.6 にアップグレードします。このスクリプト・ファイルは、 upgrade/relm ディレクトリーにありますが、 RELM_4.0.6_install_dir/server ディレクトリーから実行する必要があります。 また、パスにスペースが含まれている場合は、パス名を二重引用符で囲んでください。

このスクリプトとそのすべてのコマンド行引数を実行する代わりに、スクリプトのパラメーター・ファイルを開き、デフォルト値を変更し、このコマンド行の短縮形を実行することができます。

英語版および翻訳版の relm_params ファイルが、 RELM_4.0.6_install_dir/server/upgrade/relm/params ディレクトリーにあります。 relm_params もしくはその翻訳版のファイルを開いて、 各パラメーターの値を編集および指定します。設定が必要なパラメーターの 1 つは、OLD_APPLICATION_HOME ディレクトリーへのパスです。これは、server/conf で終わる既存のディレクトリーでなければなりません。

このスクリプトは以下のタスクを実行します。
  • 構成ファイルと Tomcat ファイルを更新する -migration_relm_updateConfigurationFiles コマンドを実行します (updateTomcatFiles が No に設定されていない場合)。コマンドを実行するには [E] を、このステップをスキップするには [S] を入力し、スクリプトの実行を取り消すには Enter キーを押してください。
  • 前のバージョンの情報に基づいて teamserver.proprties ファイルを更新します。構成ファイルが正常にマージされたら、[C] を入力して続行してください。エディターが開くので、そこで「変更管理と構成管理」アプリケーションの teamserver.properties ファイルを確認できます。 com.ibm.team.repository.server.webapp.url プロパティーで示されるパブリック URI ルートが正しいことを確認します。また、データベース・プロパティーが正しいことも確認します。完了したら、変更がある場合は保存し、エディターを閉じてスクリプトの実行を続けます。
  • Tomcat 環境で、server.xml ファイルと web.xml ファイルのコンテンツを新規バージョンにマージし、旧バージョンの tomcat-users.xml ファイルをコピーします。
  • Rational Engineering Lifecycle Manager リポジトリー・データベースに表を追加します。

パラメーター

属性 説明 必須 デフォルト
oldApplicationHome 古い Rational Engineering Lifecycle Manager 構成ディレクトリーへの絶対パス。このパスには、スペースを含めないでください。標準的なインストールでは、 このパスは old_relm_install_dir/server/conf です。 はい none
applicationContextRoot Rational Engineering Lifecycle Manager のコンテキスト・ルート。 いいえ relm
oldApplicationVersion アップグレード対象の Rational Engineering Lifecycle Manager のバージョン。 いいえ 4.0.4
newApplicationHome 4.0.6 インストール済み環境の Rational Engineering Lifecycle Manager アプリケーション構成ディレクトリーへのパス。 いいえ relm_4.0.6_install_dir/server/conf
updateTomcatFiles Tomcat 構成ファイルを更新するかどうか。WebSphere® Application Server を使用している場合は、 この値を「いいえ」に設定してください。 いいえ はい
oldApplicationTomcatHome 旧バージョンのインストール済み環境の Tomcat ホーム・ディレクトリーへの絶対パス。デフォルトで、oldTomcatHome パラメーターは、oldApplicationHome パラメーターの値から派生します。 いいえ none
newApplicationTomcatHome 4.0.6 インストール済み環境の Rational Engineering Lifecycle Manager アプリケーションの Tomcat ホーム・ディレクトリーへのパス。 デフォルトで、newApplicationTomcatHome パラメーター値は、newApplicationHome パラメーター値から派生します。 いいえ none
newJTSHome 4.0.6 インストール済み環境の Jazz™ Team Server 構成ディレクトリーへのパス。デフォルトで、newJTSHome パラメーター値は、newApplicationHome パラメーター値から派生します。 いいえ none
jtsContextRoot 4.0.6 の Jazz Team Server のコンテキスト・ルート。 いいえ jts
noPrompt 表を作成または変更する前にプロンプトを出しません。 いいえ none
noVerify teamserver.properties ファイル検証を実行しません。 いいえ none
overwrite 既存のファイルを上書きするかどうか。 いいえ いいえ
noStepPrompt ステップを実行する前にプロンプトを出しません。 いいえ none
Windows:
cd C:¥Program Files¥IBM¥JazzTeamServer¥Server¥
upgrade¥relm¥relm_upgrade.bat -oldApplicationHome old_relm_install_dir¥server¥conf
Linux:
cd opt/IBM/JazzTeamServer/Server/
./upgrade/relm/relm_upgrade.sh -oldApplicationHome old_relm_install_dir/server/conf

フィードバック