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

アップグレード完了後、以下のタスクを実行します。

このタスクについて

以下のアップグレード後のステップを行います。

手順

  1. Rational Change 5.3 以降 のインストール (該当する場合)
  2. アップグレード後の Synergy Distributed 転送を参照する (該当する場合)
  3. 7.0、7.1、または 7.1a サービスの無効化
  4. Windows クライアントのインストール (該当する場合)
  5. Rational Synergy クライアントのテスト
  6. データベースを使用可能にする
  7. クエリー制限とアクセラレーター属性の確認
  8. トラブルシューティング

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

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

手順

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

旧インストール済み環境の保存の説明に従って旧 ptcli 構成ファイルの変更済みコピーを保存している場合、この時点でこのコピーをマージします。ptcli ファイルは以下の場所にあります。

Program Files¥IBM Rational¥IBM Rational Synergy 7.2x¥etc¥ptcli.cfg

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

Rational Synergy 7.2 以降 では、リリース 7.0、7.1、または 7.1a との間での DCM 転送がサポートされています。

手順

DCM の互換性を維持するため、これらのリリースへのパッチが必要です。追加情報については、リリース 7.2 以降Rational Synergy README ファイル、および旧リリースに対するパッチの製品 README ファイルを参照してください。

7.0、7.1、または 7.1a サービスの無効化

このタスクについて

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

7.0、7.1、または 7.1a サービスを無効にするには、以下の手順で実行します。

手順

  1. タスクバーで、「スタート」 > 「コントロール パネル」 > 「管理ツール」 > 「サービス」をクリックして、「サービス」ウィンドウを開きます。
  2. 7.0、7.1、または 7.1a Rational Synergy サービスごとに以下の手順を繰り返します。
    1. サービス項目を右クリックして「プロパティー」を選択します。
    2. 「全般」タブで「スタートアップの種類」を「無効」に変更します。
    注:Rational Synergy のインストール・ディレクトリーを削除しないでください。誤って削除すると、アップグレード後のサーバーのセキュリティーが侵害される可能性があります。

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

必要に応じて、Rational Synergy リリース 7.2 以降 の 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 サポート・サイトでトラブルシューティング情報を参照してください。 このサイトには、よくある質問 (FAQ)、技術記事、およびディスカッション・フォーラムもあります。
  2. それでも解決しない場合、IBM Rational ソフトウェア・サポートに連絡してください。

フィードバック