このセクションでは、サーバー名前変更の実行後に行う確認ステップについて説明します。
障害がレポートされた場合は、サーバー名前変更のトラブルシューティングでリカバリー手順を確認します。
一般的な Jazz Team Server の管理
- Jazz™ Team Server 管理 UI (例えば、https://clmhost.production.example.org:9443/jts/admin) にログインします。
- ホーム・ページを確認し、明らかなエラーがないか、目を通します。
- 各種リンクの上にマウス・カーソルを移動し、ブラウザーのステータス・バーで、URL が、マップされた新規 URL を示しているかを確認します。
- ホーム・メニューを確認します。
- ホーム・メニューをプルダウンし、エラーが表示されていないか、および欠落している項目がないかを確認します。
- 各メニュー項目の上にマウス・カーソルを移動し、ブラウザーのステータス・バーの URL を確認します。
- ホーム・メニュー項目の一部にナビゲートし、ナビゲート先のページを検証します。
- Jazz Team Server、「変更管理と構成管理 (CCM)」、および「品質管理 (QM)」の各管理ページを確認します。Jazz Team Server の場合は、server/jts/admin にアクセスして、「サーバーの管理」をクリックします。アプリケーションの場合は、server/ccm/admin および server/qm/admin にアクセスします。
- 「状況の要約」ページで、Jazz Team Server およびフローティング・ライセンス・クライアントのパブリック URL のテキストおよび URL リンクを確認します。
- ステージング環境を名前変更しており、ステージング環境外のサーバーがある場合は、「診断」ページで、「アプリケーションおよびフレンド」診断にエラーが表示されます。
- 「登録済みアプリケーション」ページ (Jazz Team Server のみ) で、ディスカバリー URL およびアプリケーションの状況を確認します。アプリケーションの状況では、緑のチェックおよび「インストール済み」状況が表示されます。
- 「拡張プロパティー」ページで、url、http:、または https:// を検索します。実動システムを指している URL がないことを確認します。
- 「フレンド (アウトバウンド)」ページで、各フレンドのルート・サービス URI を確認します。
- 「ホワイトリスト (アウトバウンド)」ページで、ホワイトリスト URL を確認します。
- Web UI テーマがインストールされている場合は、それが引き続き正しく表示されているかを確認します。
要求管理
- - fronting.properties 内の以下の項目に、正しく名前変更された URL が含まれていることを検証します。
- com.ibm.rdm.fronting.server.serverBaseUrl (新規 JTS URL)
- com.ibm.rdm.fronting.server.ConverterURL (新規 RM URL)
- com.ibm.rdm.fronting.server.RDMFrontsideURL (別の新規 RM URL)
- friendsconfig.rdf "jfs:oauthDomain" に、正しく名前変更された JTS URL が含まれていることを検証します。
- /rm/web を使用して RM Web アプリケーションにナビゲートし、ダッシュボードおよび最新のフィードがエラーなくロードされることを検証します。最新フィードの成果物 URL が新しいサーバー URL を指していることと、リッチ・ホバー・テキストが機能していることを検証します。
- 既存プロジェクトで、プロジェクトの隣にある「成果物の表示」リンクをクリックします。プロジェクト・ビュー (「ビュー」、「フィルター条件」セクション、「最近の成果物」の各ビュー) が正しく表示されるかを検証します。これらのビューの成果物 URL に、名前変更された URL が含まれていることを検証します。フォルダー・ツリーが存在し、エラーなくナビゲートできるかを検証します。
- 既存プロジェクトで成果物の内容を作成および編集できるかを検証します。
- 既存 LPA プロジェクトで、テキスト成果物を開きます。リンク・サイドバーの CCM または QM へのリンクを検証します。新しいサーバー URL が含まれていることと、リッチ・ホバー・テキストが表示されることを確認します。リッチ・テキスト内のすべての CLM リンクが、新規 URL を反映するように更新されているかを検証します。新規 CLM リンクを作成できるかを検証します。
- RRCx 成果物 (スケッチやユースケース・ダイアグラムなど) を開きます。
ダイアグラムのイメージが読み取り専用モードで表示されるかを検証します。「編集」ボタンをクリックして、これらの成果物を編集できるかを検証します。
- レポート作成を検証します。RM ETL (データ収集ジョブ) がエラーなく実行されるかを確認します。
レポート
- サーバー名前変更後に、Jazz Team Server でレポート管理ページの「すべてのアプリケーションのすべてのデータウェアハウス収集ジョブの実行」をクリックして、ETL (データ収集ジョブ) を開始します。
- 「共有レポート」のいくつかの出来合いのレポートを実行し、引き続き機能しているかを確認します。
- RRDI がインストールされている場合は、いくつかの RRDI レポートを実行し、引き続き機能しているかを確認します。RRDI およびダッシュボードからレポートを実行します。名前変更の前後でレポートを実行して、サーバー名前変更が障害を引き起こしていないことを確認します。
- QM および JTS のレポーティング・サーバーの URL を確認します。
- https://host:port/qm/admin または https://host:port/jts/admin と入力します。
- 「レポート」をクリックします。
- 「構成」で「カスタム・レポートの接続」をクリックします。
- レポーティング・サーバーの URL を表示します。
Rational Team Concert Eclipse クライアント
- 以下のように、リポジトリー接続を更新します。
- 「チーム成果物」ビューで「リポジトリー接続」を展開し、特定のリポジトリー接続を選択します。
- コンテキスト・メニューから「プロパティー」を選択します。
- 「Jazz リポジトリー接続」ページで、URI を新しい Rational Team Concert サーバーの URI (例えば、https://newserver:9443/ccm) に変更します。
サーバーの状態が変更されたこと、およびクライアントを再始動する必要があることを警告するダイアログが表示されます。
- プロンプトを受け入れて終了します。
- 終了後に、クライアントを再始動します。
- 接続で自動ログインが選択されていない場合は、接続のコンテキスト・メニューから「ログイン」を選択します。
- 接続で新規サーバーに正常にログインしたかを確認します。
- 以下のように、フィードのリンクを確認します。
- 「チーム成果物」ビューで「フィード」を展開し、フィードを選択します。
- コンテキスト・メニューから「プロパティー」を選択します。
- 「リンク」フィールドを確認します。
- 分散 SCM を使用している場合は、以下のようにします。
- Eclipse クライアントを開始します。ワークスペース・エディターで、名前変更されたサーバーを指す 1 つ以上のフロー・ターゲットを持つワークスペースまたはストリームを開きます。ワークスペース・エディターでフロー・ターゲットが正しく表示されるかを確認します。正しく表示されない場合は、「アクセス不可」と表示されます。
- また、名前変更されたサーバー上のターゲットとの間でこのワークスペースの変更の受け入れおよび提出が可能かを確認します。
- 変更セットにリンクされたワークアイテムおよび変更依頼を開くことができることを確認します。
- サーバー名前変更およびマッピングが適用された後に、分散 SCM に関係したワークスペースおよびストリームで期待されるとおりに受け入れおよび提出が可能かを確認します。
- 名前変更されるサーバーに、SCM 分散ワークフローが使用される RTC フレンドがある場合は、マッピングを各フレンド・サーバーに確実に適用してください。
これにより、ワークスペースおよびストリーム内の変更セットおよびフロー表にリンクされた変更依頼に、正しいマッピングが適用されるようになります。
SCM コマンド行インターフェース (CLI) クライアント
- 名前変更されたリポジトリーのリポジトリー・レジストリー項目が、新規サーバー URL で更新されているかを確認します。この URL は、ユーザーが新規サーバー URL に対して lscm login を実行した場合にのみマップされます。リポジトリー・レジストリー項目は、lscm ls cred を使用してリストできます。
- 新規サーバー URL に対して lscm login を実行した後に、サーバー名前変更前の別名を引き続き使用できるかを確認します。
- 古いサーバー URL が CLI 出力に表示されないことを確認します。
- 名前変更後のサーバーからロードされたワークスペースで変更の受け入れおよび提出が可能かを確認します。
- サーバー名前変更およびマッピングが適用された後に、分散 SCM に関係したワークスペースおよびストリームで期待されるとおりに受け入れおよび提出が可能かを確認します。
ワークアイテム
- ワークアイテムの要約、説明、コメント、およびカスタム・ストリング属性に埋め込まれたすべてのリンクが、新規サーバー URL を指していることを確認します。
- ワークアイテムのリンク (CLM リンクなど)、関連成果物、および言及リンクが新規サーバー URL を指していることを確認します。
- 名前変更後の CLM サーバーへの新規リンクを追加および削除できるか、およびリッチ・ホバー・テキストが機能するかを確認します。
- URL 名に一致するワークアイテムのリンク・ラベルも、新規サーバー URL に更新されていることを確認します。
Jazz Team Build
- ビルド結果の外部リンクを確認します。
- ビルド結果内のリンクされたダウンロードおよびログ (つまり、Rational Team Concert にアップロードされていない、外部システムへのリンクとして公開されたもの) を確認します。
- Build Forge、Build Agent、Hudson ビルド・エンジンを確認し、意図された名前変更後の使用に対して、参照先の外部サーバーが正しいかを確認します。これらは、自動的にはマップされません。実動からステージング環境への名前変更の場合、これらのエンジンを非アクティブ化するか削除して、ステージング環境が実動ビルド・サーバーでビルドを実行しないようにする必要があります。
- ビルド・エンジンおよびビルド定義のビルド・プロパティーで URL プロパティー (ホスト名やポートなど) を確認します。これらは、自動的にはマップされず、手動で更新する必要が生じる可能性があります。同様に、ビルド・スクリプトの URL を更新する必要が生じる場合があります。
ダッシュボード
- ダッシュボードにナビゲートし、名前変更されたその他のサーバーからのすべてのウィジェットも含め、ダッシュボードが正常にロードされるかを確認します。
- JTS 上の個人用ダッシュボード、ミニダッシュボード、CCM/QM/RM 内のプロジェクト・ダッシュボードおよびチーム・ダッシュボードを含め、各種タイプのダッシュボードが正常にロードされるかを確認します。
- ホーム・ボタンのドロップダウン・メニューに個人用ダッシュボードのリストが表示されるかを確認します。
- URL 設定のあるウィジェットで、設定を開くと、更新された URL が表示されるかを確認します。
- (外部 RSS/Atom フィードの) ニュース・フィードおよび (その他の組み込みページの) 外部コンテンツ・ウィジェットを確認します。
- ウィジェットのリンクで URL、ブックマーク、HTML、およびヘッドラインのウィジェットが更新されていることを確認します。
- (オプション) ウィジェットをプロジェクト・ダッシュボードまたはチーム・ダッシュボードに追加し、「保存」をクリックします。
次に、ブラウザーを最新表示し、変更が記憶されていて正常にロードされるかを確認します。
ライフサイクル・プロジェクト管理 (LPA)
- JazzAdmins リポジトリーのアクセス権を備えたユーザーとして、ライフサイクル・プロジェクト管理アプリケーションにログオンします。詳しくは、ライフサイクル・プロジェクト管理アプリケーションへのログインを参照してください。
- 既存のライフサイクル・プロジェクトについて、成果物コンテナーおよびそのアソシエーションのハイパーリンクの URL で新規サーバー URL が使用されているかを確認します。
- 既存のライフサイクル・プロジェクトをクリックして編集します。「推奨役割の割り当て」リソースをダウンロードし、URL が期待どおりになっているかを確認します。
- テンプレートが「テンプレート」タブにリストされているかを確認します。
Web UI におけるプロセスおよびプロセス・オーサリング
- すべてのプロジェクト・エリア・エディターの「概要」タブの「アソシエーション」セクションですべてのプロジェクト・エリア・リンクを確認します。
- 「プロセス記述」タブのプロセス記述内のすべてのハイパーリンクを確認します。
- プロセスの共有を使用している場合は、利用プロジェクト・エリアで、共有プロセスを提供するプロジェクト・エリアへのリンクを確認します。
計画 (Planning)
- 計画項目ワークアイテムが新規サーバー URL を指していることを確認します。
- 「計画項目」タブで、既存のリンク (「子」、「要求の実装」、「テスト・ケース」などの「参照」列) を確認します。
- 「計画項目」タブで、RM、QM、および CCM への新規リンクを作成します。
- 「計画リンク」タブの既存のすべてのリンクを確認します。
- 新規の計画のトラッキング/コントリビュート・リンクを計画に追加します。
Rational ClearQuest Bridge
以下のステップを任意の順序で実行して、サーバー名前変更を検証します。
- CLM アプリケーションから統合 ClearQuest ユーザー・データベースへの新規リンクを作成できるかを確認します。
- CLM アプリケーションから ClearQuest レコードへの既存のリンクを辿れるかを確認します。
- ClearQuest ユーザー・データベースから統合 CLM アプリケーションへの新規リンクを作成できるかを確認します。
この確認ステップが失敗した場合は、ClearQuest Web サーバーの構成ファイルに問題があることを示しています。-remapconfigfiles オプションを指定して ClearQuest CLM 再マップ・ツールを実行し、ClearQuest Web サーバーの構成ファイルに保管された URL を更新してください。再マップ・ツールについて詳しくは、『CLM サーバー名前変更後の URI の再マップ (Remapping URIs after renaming a CLM server)』を参照してください。また、ツールの実行後に、必ず、ClearQuest Web サーバーを再始動してください。
- ClearQuest Web から CLM 成果物への既存のリンクを辿れるかを確認します。
この確認ステップが失敗した場合は、ClearQuest ユーザー・データベースに失効した URL が存在することを示しています。-update オプションを指定して ClearQuest CLM 再マップ・ツールを実行し、ClearQuest ユーザー・データベースに保管された URL を更新する必要があります。
Rational ClearCase 統合 (Synchronizer および Bridge)
ClearCase Synchronizer
- 同期ビルド・エンジンが「ClearCase 同期ストリーム」ビューから再始動された後に、名前変更後のサーバーに接続されているかを確認します。ビルド・エンジン・コンソールに、「リポジトリー接続に失敗しました」ではなく、「要求の待機中」と表示されます。
ClearCase Bridge
- Eclipse CTE/RTC クライアントで UCM アクティビティーまたはベース ClearCase バージョンから、関連付けられたワークアイテムを開くことができることを確認します。
- VOB スキーマが 80 でフィーチャー・レベルが 7 以上の場合は、cleartool describe コマンドを使用して、関連付けられたベース ClearCase バージョンのワークアイテム URL が更新されていることを確認します。条件に当てはまらない場合は、ワークアイテム URL を確認する必要はありません。
Enterprise Extensions
- Rational Team Concert Eclipse クライアントの「チーム成果物」ビューで、すべての Enterprise Extensions システム定義が引き続き表示されていて、開くことができるかを確認します。
- 既存の依存関係ビルド結果を開きます。ビルド・レポートに引き続きアクセスでき、新規サーバー URL が使用されているかを確認します。
- 名前変更後に依存関係ビルドを実行します。ビルドが正常に完了可能であるか、およびビルドで使用されるすべてのシステム定義が解決されるかを確認します。
- チーム成果物ナビゲーターで、既存のすべてのソース・コード・データ照会が表示されていて、正常に実行できるかを確認します。