Rational® Engineering
Lifecycle Manager をアップグレードするには、新しい製品バージョンをインストールして、構成ファイルを更新し、既存のデータベース・リポジトリー内の表を追加または更新し、
既存のデータをバージョン 5.0.1 にマイグレーションします。
始める前に
- Rational Engineering
Lifecycle Manager と統合された製品を更新する場合は、
『Rational Engineering Lifecycle Manager 製品スタックのアップグレードのためのチェックリスト』内の手順に従ってください。
- バージョン 4.x からアップグレードする場合は、バージョン 5.x アプリケーション用の新しいライセンスを取得してください。バージョン 5.x アプリケーションは、バージョン 4.x ライセンスでは機能しません。しかし、バージョン 4.x アプリケーションは、バージョン 5.x ライセンスで機能します。ライセンスについて詳しくは、
『ライセンスの管理』を参照してください。
- バージョン 4.x からアップグレードする場合は、Rational Engineering
Lifecycle Manager データ・ソースを Lifecycle
Query Engine から削除します。
- Lifecycle
Query Engineの管理ページ (https://lqe_host_name:port/lqe/web) を開きます。
- をクリックします。Rational Engineering
Lifecycle Manager データ・ソースを選択します。
- 「データ・ソース」ペインで「削除」をクリックして保存します。
手順
- Rational Engineering Lifecycle
Manager をインストールします。
この手順では、以下がインストールされます。
- Rational Engineering
Lifecycle Manager 5.0.1
- Jazz™ Team Server 5.0.1
- 「構成管理」アプリケーション 5.0.1
- 古い Tomcat サーバーを停止します。
- データベースをマイグレーションまたはバックアップします。
Oracle JDBC ドライバー ojdbc.jar が、
$newRELMHome/JazzTeamServer/server/oracle ディレクトリー内で使用可能であることを確認してください。
- 構成管理アプリケーションをアップグレードします。
vvc_upgrade スクリプトを実行して、構成とデータベース・ファイルをアップグレードし、テキスト索引を再作成します。以下はパラメーターの例です。
cd $newRELMHome/server/
upgrade/vvc/vvc_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
ヒント: 構成管理アプリケーションは、Rhapsody® Design Manager と一緒にインストールすることもできます。Rational Engineering Lifecycle
Manager のインストールには、「構成管理」アプリケーションをインストールするためのオプションがあります。 このオプションは、「構成管理」アプリケーションを Rhapsody Design Manager とは別のサーバーにインストールする場合に役立ちます。Rational Engineering Lifecycle
Manager と統合する構成管理アプリケーションは 1 つのみにしてください。コンポーネントを複数のサーバーにインストールすることを選択する場合は、インストールおよびアップグレードの対象として正しいコンポーネントが選択されていることを確認してください。
- Rational Engineering Lifecycle
Manager をアップグレードします。
relm_upgrade.sh コマンドを実行して、構成ファイルとデータベース・ファイルをアップグレードし、テキスト索引を再作成します。
$newRELMHome/server/upgrade/relm/relm_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
- Lifecycle
Query Engine と、既存の Jazz
Reporting Service、または SPARQL ゲートウェイの構成情報を、新しい製品バージョンに移植します。
古いインストール場所にある
SPARQL_Gateway ディレクトリーのコンテンツを新規の
SPARQL_Gateway ディレクトリーにコピーします。
cp -R $oldRELMHome/server/conf/SPARQL_Gateway/* $newRELMHome/server/conf/SPARQL_Gateway
バージョン 5.0 から 5.0.1 にアップグレードする場合は、手順 7 に進みます。
バージョン 4.x から 5.0.1 にアップグレードする場合は、テキスト・エディターを使用して次のプロパティーを
$newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties に追加します。
- support.query.editing=false
- support.db.derby=false
- support.dwse=false
- query.results.limit=3000
- query.results.cache.timeout=300
- user.account.cache.timeout=480
SPARQL_Gateway から
app.properties を削除します
rm $newRELMHome/server/conf/SPARQL_Gateway/app.properties
SPARQL_Gateway.properties を
app.properties という名前に変更します。
mv $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties $newRELMHome/server/conf/SPARQL_Gateway/app.properties
SPARQL_Gateway_runtime.properties を
app_runtime.properties という名前に変更します。
(デフォルトでは、
SPARQL_Gateway_runtime.properties は存在しませんが、
接続タイムアウト設定の構成が必要な場合は当該ファイルを作成できます。)
mv $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway_runtime.properties $newRELMHome/server/conf/SPARQL_Gateway/app_runtime.properties
- Apache Tomcat サーバーを始動します。
- バージョン 4.x からアップグレードする場合は、
Lifecycle
Query Engine をアップグレードします。
Lifecycle
Query Engine 管理ページ (https://relm_host_name:port/lqe/web/admin) を開きます。Lifecycle
Query Engineのアップグレードが進行中であること、および、そのアプリケーションが使用不可であることを伝えるメッセージが表示されます。「アップグレードの開始」をクリックします。アップグレードのプロセスが完了すると、データ・ソースが使用可能になります。
- 構成管理アプリケーションをアップグレードします。
- credentials.txt ファイルが存在していて、adminUserId、adminPassword、repositoryURL、smartCard、certificateFile を含んでいることを確認します。
ファイルが存在しない場合は、それを作成します。資格情報ファイルの例は以下のようになります。
adminUserId=yourAdminUserId
adminPassword=yourAdminPassword
repositoryURL=https://yourserver.com:9443/vvc
smartCard=<none>
certificateFile=<none>
- Configuration_Application_install_dir/server ディレクトリーから repotools-vvc コマンドを実行します。
./repotools-vvc.sh -vvc_online_migrationCommand
credentialsFile=credentials.txt fromVersion=<previous_version>
logPort=52000 logLevel=DEBUG
repotools-vvc.bat -vvc_online_migrationCommand
credentialsFile=credentials.txt fromVersion=<previous_version>
logPort=52000 logLevel=DEBUG
- Jazz Team Server を再始動します。
構成管理アプリケーションの repotools コマンドは、実行中の構成管理アプリケーションに要求を送信し、応答を待機します。repotools-vvc コマンドが許可エラーにより即時停止した場合は、サーバーが実行中であることと、資格情報ファイル内のユーザー ID とパスワードが正しいことを確認してください。
- Tomcat サーバーを再始動します。
- Rational Engineering Lifecycle
Manager サーバーを再始動して、マイグレーション済みのデータを、新しいアプリケーション・バージョンで必要なフォーマットに自動的にアップグレードします。この処理は、オンライン・アップグレードと呼ばれます。アップグレード状況のページを表示する場合にはログオンします。
タスクの結果
オンライン・アップグレードが成功すると、Web ブラウザーが最新表示され、
Rational Engineering
Lifecycle Manager のウェルカム・ページが開きます。アップグレードのステップが失敗した場合は、
relm.log ファイルを調べて、失敗の原因を判別してください。
Rational Engineering
Lifecycle Manager で定義された製品が多数ある場合、オンライン・アップグレードが完了するのに長時間 (最大で数時間) を要します。