このトピックでは、generateURLMappings コマンドによって生成されるマッピング・ファイルの構造を示し、ご使用のデプロイメント用にマッピング・ファイルを編集する方法について説明します。
マッピング・ファイルの生成の準備ができたら、マッピング・ファイルの準備の手順に従います。追加の例については、テスト・ステージング環境をセットアップするためのトポロジーおよびマッピング・ファイルおよびパイロットから実動へのシナリオのトポロジーおよびマッピング・ファイルを参照してください。
マッピング・ファイルには、Jazz™ Team Server のソースとターゲットの URL のペア、登録されている CLM アプリケーション、およびアプリケーションによってコントリビュートされたその他の URL が含まれています。URL は以下の 2 つのタイプに分類されます。
名前変更の一部である URL ペアには、Jazz Team Server のドメイン下のすべてが含まれます。 これには、Jazz Team Server のパブリック URL、アプリケーションのパブリック URL、およびアプリケーションによってコントリビュートされたその他の URL が含まれます。
影響を受ける URL には、このトポロジーと対話するが、この Jazz Team Server のドメイン下にはないその他のすべてのシステムが含まれます。別の Jazz Team Server に登録されているが、この Jazz Team Server のフレンドである CLM アプリケーションは、影響を受ける URL になります。Rational ClearQuest などの外部統合も、影響を受ける URL です。
# JTS
source=https://clmhost.example.org:9443/jts
target=https://clmhost2.example.org:9443/jts
#Additional Urls included in rename by clmhost.example.org:9443/jts
# ADMIN
source=https://clmhost.example.org:9443/admin
target=https://clmhost2.example.org:9443/admin
#(CLM Help URL)
source=https://clmhost.example.org:9443/clmhelp
target=https://clmhost2.example.org:9443/clmhelp
# CCM
source=https://clmhost.example.org:9443/ccm
target=https://clmhost2.example.org:9443/ccm
# RM
source=https://clmhost.example.org:9443/rm
target=https://clmhost2.example.org:9443/rm
# ADDITIONAL URLs included in rename by RM
source=https://clmhost.example.org:9443/converter/htmlgen
target=https://clmhost2.example.org:9443/converter/htmlgen
# QM
source=https://clmhost.example.org:9443/qm
target=https://clmhost2.example.org:9443/qm
#The following list of URLs represent external servers that integrate with this Jazz Team Server or with applications registered to it.
# https://friend1.example.org:9443/jts/rootservices (Friend Entry)
# https://cqconnector.example.org:9084/cqconnector/gateway
生成されるマッピング・ファイルは、importURLMappings の実行前に編集する必要があるテンプレートです。トポロジー内のすべてのシステムが正しく名前変更されるようにするためには、マッピング・ファイル内のすべてを理解することが重要です。ファイルの上の方のセクションには、名前変更の一部である URL ペアが含まれます。この例では、Jazz Team Server および登録されているすべてのアプリケーションのパブリック URL の URL ペアがあります。また、アプリケーションによってコントリビュートされた URL ペア (Jazz Team Server によってコントリビュートされた CLM ヘルプ URL や RM アプリケーションによってコントリビュートされたコンバーター URL ペアなど) もあります。
これらの各 URL を確認して、変更されるものを判別します。新しい値を使用して、名前変更されるソース URL のターゲットを更新します。特定のソース URL を名前変更しない場合は、# を使用して、そのペアをコメント化します。
# JTS
#source=https://clmhost.example.org:9443/jts
#target=https://clmhost2.example.org:9443/jts
マッピング・ファイルの下の方には、コメント化された影響を受ける URL のリストが含まれています。これらの URL はこの名前変更の一部ではありませんが、変更される URL によって影響を受けます。これらの URL は単に参照用なので、コメント化されたままにします。また、これらの URL が、サポートされるシナリオの一部であることを確認する必要もあります。ご使用のトポロジーのサーバー名前変更の資料を参照して、これを確認してください。
ステージング環境の場合は、ステージング・サーバーと実動サーバー間のクロス・リンクがないようにするために、影響を受ける URL を必ずマスクアウトする必要があります。詳しくは、下記を参照してください。
ステージング環境をセットアップする場合は、マッピング・ファイル内のすべての影響を受ける URL について、ダミー・マッピングを作成する必要があります。影響を受ける URL には、このデプロイメントまたは外部サーバーのフレンドであるその他の CLM アプリケーションが含まれる可能性があります。フレンド項目について、フレンドのパブリック URL のダミー・マッピングを作成します。
例えば、フレンド項目 URL が https://friendhost.example.org:9443/jts/rootservices の場合は、通常、パブリック URL は https://friendhost.example.org:9443/jts になります。マッピング・ファイルの下部に URL ペアを追加して、ターゲットを偽のホスト名に設定することで、この URL をマスクアウトします。ダミー・ターゲット・ホスト名を選択する前に、そのホストにアクセスできないことを確認してください。
# Friend
source=https://friendhost.example.org:9443/jts
target=https://dummyfriendhost.example.org:9443/jts
同じターゲットを複数回使用することは許可されません。複数のフレンド項目がある場合は、dummyhost2、dummyhost3、…を使用します。Jazz Team Server およびアプリケーションのすべてが同じホストおよびポート上にあるシングル・サーバー・デプロイメントの場合は、以下に示すように、簡易マッピングを使用できます。
フレンド項目ではない、すべての影響を受ける URL について、マッピング・ファイルの下部に、以下の URL ペアを追加します。
source=https://externalserver.example.org:9555/
target=https://dummyhost.example.org:9555/
プロトコル、ホスト、ドメイン、およびポートがすべての URL で共通である単純なトポロジーの場合は、マッピング・ファイルを小さくして、1 つのソースとターゲットの項目のみが含まれるようにすることができます。例えば、clmhost.example.org にオールインワン・デプロイメントがあり、すべてが newhost.example.org を使用するように名前変更する場合は、生成されたマッピング・ファイルを編集して、以下の URL のみが含まれるようにすることができます。
source=https://clmhost.example.org:9443
target=https://newhost.example.org:9443
ソース URL のいずれかがデフォルト・ポートを使用していて、デフォルト・ポート番号が明示的に含まれていない場合は、2 つのマッピング・セット (デフォルト・ポートのものと、デフォルト・ポートがないもの) が必要になります。generateURLMappings コマンドは、追加マッピングを自動的に生成します。デフォルト・ポートは、https では 443 で、http では 80 です。
例えば、https://clmhost.example.org/ccm で実行されている既存の CCM があるとします。この場合、CCM は、デフォルト・ポートを使用して (アプリケーション・サーバーのポートを構成するか、デフォルト・ポートで実行されているリバース・プロキシー http サーバーを使用して)、サーバーにデプロイされています。CLM 内で、ポートが URL に明示的に含まれているリソースへの URL のリンクが保管されている可能性もあります。例えば、以下のようなものです。
https://clmhost.example.org:443/resource/...
URL がどちらの形式でも保管されている可能性があるため、それぞれのマッピングが必要になります。例えば、clmhost.example.org を newhost.example.org に名前変更する場合を考えます。この場合、名前変更を実行するには、以下の両方のマッピングが必要になります。ペアは、generateURLMappings によって自動的に生成されます。
source=https://clmhost.example.org/ccm
target=https://newhost.example.org/ccm
source=https://clmhost.example.org:443/ccm
target=https://newhost.example.org:443/ccm
CLM アプリケーションは、URL の大/小文字を区別します。URL https://clmhost:443/jts は、https://CLMHOST:443/jts とは異なります。必ず、ソース URL の大/小文字を保持してください。そうしないと、マップされません。
必要に応じて、ターゲット URL の大/小文字は変更できます。例えば、以下のマッピングは許可されます。
source=https://CLMHOST:443/jts
target=https://clmhost:443/jts
簡易マッピング・ファイルを使用する場合は、必ず、すべての URL が同じ大/小文字になるようにしてください。以下のソース URL がある場合で、
https://clmhost:443/jts
https://CLMHOST:443/ccm
以下の簡易マッピングを使用する場合を考えます。
source=https://clmhost:443
target=https://clmhost:9443
最初の URL のみがマップされます。2 番目の URL はマップされません。これを修正するには、以下の別のマッピングを追加します。
source=https://CLMHOST:443
target=https://CLMHOST:9443
関係する処理の量が原因で、エラーが発生する可能性があります。エラーの中には、サーバーの始動前にマッピング・ファイルを生成しようとした場合や正しくないログイン資格情報を使用した場合など、明確に示されるものもあります。一方、あまり明らかではないエラーもあります。サーバー名前変更のエラーについて詳しくは、サーバー名前変更のトラブルシューティングを参照してください。
サーバーの名前変更は z/OS® でサポートされており、-generateURLMappings リポジトリー・ツール・コマンドを使用しない点を除き、z/OS でのプロセスは他のオペレーティング・システムの場合と同じです。代わりに、hlq.SBLZSAMP のサンプル JCL メンバー BLZGENMP をカスタマイズします。ここで、hlq は、SMP/E インストール中に指定された高位修飾子です。詳細なカスタマイズ手順については、BLZGENMP のコメント・ヘッダーを参照してください。