このトピックでは、サーバー名前変更を使用して、実際の実動データでテスト・ステージング環境をセットアップするためのサンプル・トポロジー・ダイアグラムとマッピング・ファイルを示します。ステージング環境とは、実稼働環境から切り離された実動データのスナップショットが含まれたテスト・サンドボックスです。
テスト・ステージング環境を計画する場合は、実動データに影響を及ぼさないように (またはその逆についても) 特に注意する必要があります。これは、マッピング・ファイルで実動サーバーをマスキングすることによって実現します。実動サーバーに接続されている可能性がある追加 CLM サーバーまたは統合サーバーについても考慮してください。
以下のトポロジー・ダイアグラムは、名前変更前の非分散 CLM デプロイメントを示したものです。この例では、Jazz™ Team Server と 3 つの CLM アプリケーションはすべて同じホスト・システムにあります。

サーバーの名前変更と結果の評価を行うことができるステージング環境に実動デプロイメントをコピーするには、実動データを使用したテスト・ステージング環境のセットアップの指示に従います。以下のダイアグラムに、名前変更後のトポロジーがどのようになるかを示しています。CLM アプリケーションはすべて、同じステージング・サーバー staging.example.org 上にあります。

このシナリオは、簡易マッピング・ファイルの要求を満たします。作成されるマッピング・ファイルに含める必要があるマッピングは 1 つのみです。簡易マッピングはこのトポロジー内のすべての URL をカバーするため、ダミー・マッピングは不要です。詳しくは、『簡易マッピング・ファイルの使用』を参照してください。
# Simplified mapping
source=https://production.example.org:9443
target=https://staging.example.org:9443
以下のように、実動 URL を偽の IP アドレスにリダイレクトするようにホスト・ファイルを編集することをお勧めします。
# 10.10.10.10 refers to an IP address that does not host a clm application.
10.10.10.10 production.example.org
以下のトポロジー・ダイアグラムは、2 つのリンクされた CLM デプロイメントを示しています。各 CLM デプロイメントは分散されており、Jazz Team Server および各アプリケーションは別々のホスト上で実行されています。両方のデプロイメントは Rational Reporting サーバーと統合されており、1 つのデプロイメントは、Rational ClearQuest および Rational ClearCase と統合されています。


マッピング・ファイルを生成して編集した後は、以下のようになります。 ステージング環境と実稼働環境が混合しないようにするために、ステージングされていない実動サーバーの URL について、ダミー・マッピングがマッピング・ファイルに追加されています。
#/jts
source=https://jts1.production.example.org:9443/jts
target=https://jts1.staging.example.org:9443/jts
#Additional Urls included in rename by /jts
#(CLM Help URL)
source=https://jts1.production.example.org:9443/clmhelp
target=https://jts1.staging.example.org:9443/clmhelp
#/admin
source=https://jts1.production.example.org:9443/admin
target=https://jts1.staging.example.org:9443/admin
#/ccm
source=https://ccm1.production.example.org:9443/ccm
target=https://ccm1.staging.example.org:9443/ccm
#/qm
source=https://qm1.production.example.org:9443/qm
target=https://qm1.staging.example.org:9443/qm
#/rm
source=https://rm1.production.example.org:9443/rm
target=https://rm1.staging.example.org:9443/rm
#Additional Urls included in rename by /rm
#(The address of the application used to generate images for graphical artifacts.)
source=https://rm1.production.example.org:9443/converter/htmlgen
target=https://rm1.staging.example.org:9443/converter/htmlgen
# RRDI
source=https://rrdi.production.example.org:9082/reporting
target=https://rrdi.staging.example.org:9082/reporting
# Affected URLs
# https://cqwebhost.production.example.org:9443/cqweb/oslc
# https://cqsynchhost.production.example.org:8444/cqconnector/gateway
# Dummy mappings for affected URLs
source=https://cqwebhost.production.example.org:9443
target=https://dummyhost1.example.org:9443
source=https://cqsynchhost.production.example.org:8444
target=https://dummyhost2.example.org:8444
# Dummy mappings for the second CLM deployment
#/jts
source=https://jts2.production.example.org:9443/jts
target=https://jts2.dummyhost.example.org:9443/jts
#Additional Urls included in rename by /jts
#(CLM Help URL)
source=https://jts2.production.example.org:9443/clmhelp
target=https://jts2.dummyhost.example.org:9443/clmhelp
#/admin
source=https://jts2.production.example.org:9443/admin
target=https://jts2.dummyhost.example.org:9443/admin
#/ccm
source=https://ccm2.production.example.org:9443/ccm
target=https://ccm2.dummyhost.example.org:9443/ccm
#/qm
source=https://qm2.production.example.org:9443/qm
target=https://qm2.dummyhost.example.org:9443/qm
#/rm
source=https://rm2.production.example.org:9443/rm
target=https://rm2.dummyhost.example.org:9443/rm
#Additional Urls included in rename by /rm
#(The address of the application used to generate images for graphical artifacts.)
source=https://rm2.production.example.org:9443/converter/htmlgen
target=https://rm2.dummyhost.example.org:9443/converter/htmlgen
すべての実動 URL を偽の IP アドレスにリダイレクトするようにホスト・ファイルを編集することをお勧めします。
# 10.10.10.10 refers to an IP address that does not host a clm application.
10.10.10.10 cqwebhost.production.example.org
10.10.10.10 cqsynchhost.production.example.org
10.10.10.10 jts2.production.example.org
10.10.10.10 ccm2.production.example.org
10.10.10.10 qm2.production.example.org
10.10.10.10 rm2.production.example.org
サーバーの名前変更と結果の評価を行うことができるステージング環境に実動デプロイメントをコピーするには、実動データを使用したテスト・ステージング環境のセットアップの指示に従います。デプロイメントがリンクされているため、両方のデプロイメントの URL は各データベースに存在します。 この例では、2 つの CLM デプロイメントのそれぞれに、別々のマップ・ファイルを用意しています。importURLMappings コマンドを各 Jazz Team Server で 2 回実行する必要があります。1 回は Jazz Team Server のマッピング・ファイルに対してで、もう 1 回は、生成されたもう 1 つの Jazz Team Server のマッピング・ファイルに対してです。以下のダイアグラムは、ステージング環境で名前変更の後にトポロジーがどのようになるかを示しています。なお、ClearQuest および ClearCase は、ステージング環境ではサポートされません。

最初のデプロイメントのマッピング・ファイルを生成して編集した後は、以下のようになります。 ステージング環境と実稼働環境が混合しないようにするために、ダミー・マッピングがマッピング・ファイルに追加されています。
#/jts
source=https://jts1.production.example.org:9443/jts
target=https://jts1.staging.example.org:9443/jts
#Additional Urls included in rename by /jts
#(CLM Help URL)
source=https://jts1.production.example.org:9443/clmhelp
target=https://jts1.staging.example.org:9443/clmhelp
#/admin
source=https://jts1.production.example.org:9443/admin
target=https://jts1.staging.example.org:9443/admin
#/ccm
source=https://ccm1.production.example.org:9443/ccm
target=https://ccm1.staging.example.org:9443/ccm
#/qm
source=https://qm1.production.example.org:9443/qm
target=https://qm1.staging.example.org:9443/qm
#/rm
source=https://rm1.production.example.org:9443/rm
target=https://rm1.staging.example.org:9443/rm
#Additional Urls included in rename by /rm
#(The address of the application used to generate images for graphical artifacts.)
source=https://rm1.production.example.org:9443/converter/htmlgen
target=https://rm1.staging.example.org:9443/converter/htmlgen
# RRDI
source=https://rrdi.production.example.org:9082/reporting
target=https://rrdi.staging.example.org:9082/reporting
# Affected URLs
# https://cqwebhost.production.example.org:9443/cqweb/oslc
# https://cqsynchhost.production.example.org:8444/cqconnector/gateway
# Dummy mappings
source=https://cqwebhost.example.org:9443
target=https://dummyhost1.example.org:9443
source=https://cqsynchhost.production.example.org:8444
target=https://dummyhost2.example.org:9443
2 番目のデプロイメントのマッピング・ファイルを生成して編集した後は、以下のようになります。 ステージング環境と実稼働環境が混合しないようにするために、ダミー・マッピングがマッピング・ファイルに追加されています。なお、最初のマッピング・ファイルと 2 番目のマッピング・ファイルには、同じ RRDI マッピングが含まれています。importURLMappings コマンドは、これが同じであることを検出し、2 回目はノーオペレーションになります。
#/jts
source=https://jts2.production.example.org:9443/jts
target=https://jts2.staging.example.org:9443/jts
#Additional Urls included in rename by /jts
#(CLM Help URL)
source=https://jts2.production.example.org:9443/clmhelp
target=https://jts2.staging.example.org:9443/clmhelp
#/admin
source=https://jts2.production.example.org:9443/admin
target=https://jts2.staging.example.org:9443/admin
#/ccm
source=https://ccm2.production.example.org:9443/ccm
target=https://ccm2.staging.example.org:9443/ccm
#/qm
source=https://qm2.production.example.org:9443/qm
target=https://qm2.staging.example.org:9443/qm
#/rm
source=https://rm2.production.example.org:9443/rm
target=https://rm2.staging.example.org:9443/rm
#Additional Urls included in rename by /rm
#(The address of the application used to generate images for graphical artifacts.)
source=https://rm2.production.example.org:9443/converter/htmlgen
target=https://rm2.staging.example.org:9443/converter/htmlgen
# RRDI
source=https://rrdi.production.example.org:9082/reporting
target=https://rrdi.staging.example.org:9082/reporting
# Dummy mappings
source=https://cqwebhost.production.example.org:9443
target=https://dummyhost1.example.org:9443
source=https://cqsynchhost.production.example.org:8444
target=https://dummyhost2.example.org:9443
実動 URL を偽の IP アドレスにリダイレクトするようにホスト・ファイルを編集することをお勧めします。
# 10.10.10.10 refers to an IP address that does not host a clm application.
10.10.10.10 cqwebhost.production.example.org
10.10.10.10 cqsynchhost.production.example.org