アップグレード後のステップの実行

このセクションでは、アップグレード完了後に行う必要がある作業について詳しく説明します。

このタスクについて

  1. Rational Change 5.3 以降のインストール (該当する場合)
  2. アップグレード後の Rational Synergy Distributed 転送を参照する (該当する場合)
  3. ワークエリアの更新 (必要な場合)。
  4. 7.0、7.1、7.1a、7.2 以降 サービスの無効化 (それが不要である場合)
  5. 旧インストール済み環境の削除 (それが不要である場合)
  6. Windows クライアントのインストール (該当する場合)
  7. Rational Synergy クライアントのテスト
  8. データベースを使用可能にする
  9. クエリー制限とアクセラレーター属性の確認
  10. トラブルシューティング

Rational Change 5.3 以降のインストール

このデータベースと共に Rational Change を 使用する場合、Rational Change5.3 以降を インストールします。旧リリースの Rational Change には リリース 7.2 以降との互換性がありません。詳しい説明については、インストール・ガイドを参照してください。

始める前に

Rational Change をインストールする前に 1 つ以上のデータベースを 作成またはアップグレードする必要があります。 これは、Rational Change が Rational Synergy データベースに アクセスする必要があるためです。

手順

Rational Change を使用しており、旧インストール済み環境の保存の説明に従って旧 ptcli 構成ファイルの変更済みコピーを保存している場合、それをこの時点でマージします。 ptcli ファイルは、C:¥Program Files¥IBM¥Rational¥Synergy¥7.2x¥etc¥ptcli.cfg です。

アップグレード後の Rational Synergy Distributed 転送

Rational Synergy 7.2 以降 では、リリース 7.0、7.1、7.1a、7.2 以降 との間での DCM 転送がサポートされています。 DCM の互換性を維持するため、これらのリリースへのパッチが必要です。

このタスクについて

追加情報については、リリース 7.2 以降Rational Synergy README ファイル、および旧リリースに対するパッチの製品 README ファイルを参照してください。

ワークエリアの更新

アップグレードの一環としてデータベースを (新しいコンピューターなどの) 新しいパスに移動した場合、新しいパスを参照するように既存のワークエリアを更新します。この情報は、コピー・ベースのワークエリアとリンク・ベースのワークエリアの両方に適用されます。

手順

  1. 移動されたデータベースの各ユーザーは、次のコマンドを実行して、各自の作業プロジェクトを更新する必要があります。
    ccm wa /dbpath old_database_path /show project_spec...
    ccm wa /dbpath old_database_path /replace -show project_spec...
    1. ビルド・マネージャーは、各自の prep プロジェクトも更新する必要があります。
  2. 適切な /scope オプションを指定して ccm wa /dbpath コマンドを実行することで、共有プロジェクトまたは静的プロジェクトを更新します。

7.0、7.1、7.1a、7.2 以降 サービスの無効化

アップグレード・プロセスによりアップグレード後のサーバーで旧リリースが停止され、使用不可として示されます。

手順

  1. タスクバーで、「スタート」 > 「コントロール パネル」 > 「管理ツール」 > 「サービス」をクリックして、「サービス」ウィンドウを開きます。
  2. 7.0、7.1、7.1a、7.2 以降 Rational Synergy サービスごとに以下の手順を繰り返します。
    1. サービス項目を右クリックして「プロパティー」を選択します。
    2. 「全般」タブで「スタートアップの種類」を「無効」に変更します。

旧インストール済み環境の削除

旧リリースが不要になったら、アンインストール・コマンドを使用して旧インストール済み環境を削除します。

このタスクについて

注: このコンピューターで『既存のサーバーのアップグレード』の手順を実行した場合、旧 Rational Synergy インストール・ディレクトリーを削除しないでください。誤って削除すると、アップグレード後のサーバーのセキュリティーが侵害される可能性があります。詳しくは、IBM® Rational ソフトウェア・サポートに連絡してください。

Windows クライアントのインストール

必要に応じて、Rational Synergy リリース 7.2 以降 の Windows クライアントをインストールします。 旧リリースのクライアントをアンインストールする必要はありません。ただし、旧リリースを使用するデータベースにアクセスする必要がない場合にはアンインストールできます。

このタスクについて

詳しい説明については、インストール・ガイドを参照してください。

Rational Synergy クライアントのテスト

アップグレード後のデータベースを使用して Rational Synergy クライアントをテストします。

手順

  1. ccm monitor コマンドを実行し、適切な CCM サーバーが稼働しているかどうかを確認します。稼働していない場合、ccm_server コマンドを使用して開始します。ccm monitor コマンド実行後に出力に示されるサーバー URL を書き留めます。
  2. ブラウザーに protocol://server:port/admin と入力します。プロトコル (http または https)、server、および port は、サーバー URL に示されているものです。
  3. プロンプトが出されたら、管理者パスワードを入力します。
  4. 「データベース」タブで、テスト対象のデータベースがこのサーバーに接続していることがリストで示されているかどうかを確認します。別のサーバーに接続していることが示されている場合、その別のサーバーを使用するか、または Web ページからデータベースのサーバーを変更します。
  5. 確認したサーバー URL を使用して Rational Synergy セッションを開始します。

    cmsynergy /d database_path [/s server_url]

    注: サーバー URL を指定する s オプションは任意指定です。ほとんどの場合は不要であり、サーバー URL は Rational Synergy ルーターによって自動的に判別されます。

データベースを使用可能にする

アップグレードを完了し、結果をテストし、必要なアップグレード後のアクションを実行したら、アップグレードは完了です。

手順

  1. アップグレード、テスト、またはアップグレード後のプロセスにおいてデータベースを保護していた場合、この時点でデータベースの保護を解除します。
  2. データベースが使用可能であることをユーザーに通知します。
  3. ユーザーのクライアント・ソフトウェアをアップグレードします。

クエリー制限とアクセラレーター属性の確認

Rational Synergy 7.0 および 7.1 では、ストリング属性とテキスト属性が Windows CP1252 (シングル・バイト・エンコード) でエンコードされており、ストリング属性またはテキスト属性に対するクエリーでは各ストリングの先頭 64 文字 (バイト) のみが検査されていました。Rational Synergy 7.2 以降 では、テキスト属性のエンコードが UTF-8 (可変長エンコード) になりました。クエリーの制限が 64 バイトから 72 バイトに拡大されました。ただし、CP1252 文字エンコードでは 64 文字 (バイト) 以下で表現されていたストリングが、UTF-8 では 72 バイトより多くのバイト数を必要とすることがあります。ユーザーは各自のクエリーを検討し、この問題が生じているかどうか確認する必要があります。

始める前に

Rational Synergy 7.1a からアップグレードするユーザーはこのタスクをスキップできます。

手順

  1. 適切にエンコードされていなかったストリングに対するクエリーを確認します。
  2. この問題を解決するため、属性をアクセラレーター属性にします。アクセラレーター属性では、クエリーの制限が 700 バイトになります。

ストリング「ééééééééééééééééééééééééééééééééééééé」(揚音アクセントが付いた Latin-1 の e 文字が 37 個あるストリング) は、Rational Synergy 7.0 および 7.1 で使用されている CP1252 エンコードでは 37 バイトになります。Rational Synergy 7.2 以降 で使用されている UTF-8 エンコードでは、同じストリングが 74 バイトになります。その結果、これと同じ値を持つ属性が含まれているオブジェクトに対するクエリーは、7.0 と 7.1 では正常に完了しますが、7.2 では失敗します。

アップグレード後の問題のトラブルシューティング

コマンドまたはプロセスで問題が発生した場合、あるいは受け取ったエラー・メッセージの内容が理解できない場合、以下のトラブルシューティング・ステップを実行してください。

手順

  1. IBM Rational サポート・サイトにあるトラブルシューティング情報を参照します。
  2. それでも解決しない場合、IBM Rational ソフトウェア・サポートに連絡してください。

フィードバック