名前変更された統合サーバーに対する参照の更新

Rational® Change が他のサーバーに対する OSLC プロバイダーまたは OSLC コンシューマーとして構成されていると、Rational Change は OSLC リンクを変更要求 (CR) 属性に格納します。同期サーバーの統合を使用して、Rational Change は統合サーバーの成果物へのリンクを CR 属性に格納します。 OSLC 統合または同期サーバー統合内のサーバーの名前が変更された場合、CR 属性に格納されているリンクが引き続き機能するように、サーバー URL の参照を更新する必要があります。

このタスクについて

Rational Synergy CLI コマンドを使用し、ccm_admin ロールに属している必要があります。

古い URL を含む CR 属性は、Web タイプ OSLC_LINK、テキスト属性、ストリング属性、またはユーザーがカスタマイズした属性である可能性があります。

手順

  1. DCM をオフにし、保留中の受信をすべて処理して、DCM がクリーンで安定した状態になるようにします。

    参照の更新に関係するいずれかのデータベースで、DCM 転送が発生することはお勧めしません。

  2. サーバーの名前変更の実行中にユーザーがシステムを使用できないように、Rational Change サーバーを停止します。
  3. Rational Synergy CLI で、古いサーバーを参照する属性を含むデータベースに対する単一ユーザー・モード・セッションを開始します。
  4. ロールを ccm_admin に設定します。

    この更新操作を実行するには、ccm_admin ロールに属している必要があります。

  5. ccm update_urls コマンドを実行します。
    古いサーバー URL および新規サーバー URL の基本部分を指定します。 また、値が古い URL を参照する可能性がある属性名のリストも指定してください。update_urls コマンドは、指定されたすべての CR 属性にある URL で、名前変更された部分のみを更新します。 詳しくは、Rational Synergy インフォメーション・センターの該当するトピックを参照してください。
  6. Synergy CLI セッションを停止します。
  7. Rational Change サーバーを再始動します。
  8. クラスター内にあり、古いサーバーを参照する属性を持つすべての Rational Change サーバーのすべてのデータベースで、ステップ 1 から 7 を繰り返します。
  9. DCM をオンにします。
  10. セントラル・サーバー構成を使用しており、更新された属性のいずれかがゴースト CR 属性である場合は、CR を再同期する必要があります。

Rational Change が Rational Team Concert™ と統合され、同期サーバーを使用しているとします。また、Rational Change の CR 属性 url_mappings が、Rational Team Concert の作業項目へのリンクを含むように構成されているとします。

例として、2 つの CR には以下の url_mappings があります。

CR 1: https://rtchost-test:1234/ccm/resource/itemName/WorkItem/68

CR 2: https://rtchost-test:1234/ccm/resource/itemName/WorkItem/69

次に、update_urls コマンドは、以下のようになる可能性があります。

ccm update_urls -change -old_url "https://rtchost-test:1234/ccm" -new_url "https://rtchost-prod:1234/ccm" url_mapping

CR の更新された url_mappings 属性は、以下のようになります。

CR 1: https://rtchost-prod:1234/ccm/resource/itemName/WorkItem/68

CR 2: https://rtchost-prod:1234/ccm/resource/itemName/WorkItem/69

スクリプトの例:
script_to_update_urls.sh
!/bin/sh
if test $# -ne 3; then
echo "Usage: script_to_update_urls old_url new_url database"
exit 1
fi

CCM_ADDR=`ccm start -d $3 -nogui -m –q –pw xxxxxx -single “Rename servers”`; export CCM_ADDR
ccm set role ccm_admin
ccm update_urls -change -old_url $1 -new_url $2 problem_description 
problem_synopsis relatedChangeRequests
ccm stop

フィードバック