Tealeaf トラブルシューティング・ガイド

IBM Tealeaf CX
バージョン 9 リリース 0.2
2015 年 6 月 18 日
Tealeaf トラブルシューティン
グ・ガイド
注記
本書および本書で紹介する製品をご使用になる前に、 161 ページの『特記事項』に記載されている情報をお読みください。
本書は、IBM Tealeaf CX バージョン 9 リリース 0 モディフィケーション 2 および新しい版で明記されていない限
り、以降のすべてのリリースおよびモディフィケーションに適用されます。
お客様の環境によっては、資料中の円記号がバックスラッシュと表示されたり、バックスラッシュが円記号と表示さ
れたりする場合があります。
原典：
IBM Tealeaf CX
Version 9 Release 0.2
June 18, 2015
Tealeaf Troubleshooting Guide
発行：
日本アイ・ビー・エム株式会社
担当：
トランスレーション・サービス・センター
© Copyright IBM Corporation 1999, 2015.
目次
Tealeaf トラブルシューティング・ガイド vii
トラブルシューティングが必要な状況または時期の
判断 . . . . . . . . . . . . . . . . . vii
エラー・メッセージの発生時刻 . . . . . . . vii
検索サーバー・サービス . . . . . . . . . vii
Tealeaf CX 問題診断 . . . . . . . . . . . viii
トラブルシューティング・ストラテジー: 開始点、タ
ーゲット . . . . . . . . . . . . . . . ix
Tealeaf システム・コンポーネント間のデータ・フロ
ー・パス . . . . . . . . . . . . . . . ix
ツール . . . . . . . . . . . . . . . . x
診断ユーティリティー . . . . . . . . . . x
テスト・ツール . . . . . . . . . . . . xi
構成ポイント . . . . . . . . . . . . . . xi
構成ファイル . . . . . . . . . . . . . xi
GUI 構成ユーティリティー . . . . . . . . xi
ポータル構成 . . . . . . . . . . . . . xi
構成設定および値 . . . . . . . . . . . . xii
ユーザー名とパスワード . . . . . . . . . xii
第 1 章データの保存と再作成 . . . . . 1
データ・バックアップの推奨および考慮事項. . . . 1
環境の保存または CX 設定のマイグレーションのた
めのバックアップの推奨 . . . . . . . . . . 1
環境を保存するためのミラー・サーバーの作成 . . . 2
データベースからのデータのクリア. . . . . . . 2
データベースからの段階的なデータのクリア. . . 2
キャニスターからのデータの即時クリア . . . . 2
SQL Server からのデータのクリア . . . . . . 4
Tealeaf サーバー間の時刻の同期 . . . . . . . . 5
Tealeaf サーバー . . . . . . . . . . . . 5
Tealeaf タイム・ゾーン . . . . . . . . . . 5
PCA サーバーの時刻とトランスポート・サービス
の時刻の同期 . . . . . . . . . . . . . 6
IBM TealeafCX RealiTea Viewer のタイム・ゾーン
の構成 . . . . . . . . . . . . . . . 6
Passive Capture Application サーバー (PCA サーバー)
のトラブルシューティング. . . . . . . . . . 6
PCA メッセージ・ロギングの管理 . . . . . . . 8
ReqCancelled=Client ヒットの問題への対処. . . . 8
データ・ダンプの記録による ReqCancelled=Client
ヒットの根本原因の特定 . . . . . . . . . 9
Tealeaf キューの開始に失敗し、キャプチャーが無効
になった場合の対応方法 . . . . . . . . . . 10
「client_random missing」メッセージへの対処 . . . 11
PCA Capture ログに「Max SYN/WAIT limit
reached」が含まれている . . . . . . . . . . 11
PCA 上で有効期限が切れた SSL 証明書の置換 . . 12
© Copyright IBM Corp. 1999, 2015
PCA キャプチャー・ログ・エラー・メッセージ
「reassd:SSL セッション・キャッシュ・エントリー
が見つかりません...(reassd: Couldn't find SSL session
cache entry . . .)」 . . . . . . . . . . . .
PCA が reveal オブジェクトを作成できなかった . .
PCA のリブート後に ReqCancelled ページが大幅に
増加する . . . . . . . . . . . . . . .
特定タイプのファイルをドロップするための PCA
の構成 . . . . . . . . . . . . . . . .
非標準ファイル拡張子をキャプチャーするための
PCA の構成 . . . . . . . . . . . . .
非標準 MIME タイプをキャプチャーするための
PCA の構成 . . . . . . . . . . . . .
特定の拡張子を持つヒットの応答をドロップする
ための PCA の構成 . . . . . . . . . .
PCA ディスク・スペースを解放する . . . . . .
フェイルオーバーのトラブルシューティング . . .
フェイルオーバーの開始、停止、および再始動の
正しい順序 . . . . . . . . . . . . .
フェイルオーバー状態の判別 . . . . . . .
ulimit コア・ファイル・サイズ・エラーへの対処
ネットワーク・インターフェース・カードの追加後
に PCA の開始が失敗する場合の対応方法 . . . .
エラー System.Web.HttpRequestValidationException . .
PSIO_SIGCAUGHT エラーの原因の調査 . . . . . .
crond(pam_unix)session closed for user root メ
ッセージの大量発生への対処 . . . . . . . .
crond メッセージ・ロギングの抑止 . . . . .
異なるログ・ファイルへの cron メッセージのリ
ダイレクト . . . . . . . . . . . . .
「Invalid Deflate Data」エラー・メッセージへの
対処 . . . . . . . . . . . . . . . . .
PCA の問題が解決しない場合にお客様サポートに提
供する情報 . . . . . . . . . . . . . .
追加 tcpdump コマンド . . . . . . . . . .
追加トピック . . . . . . . . . . . . . .
ライセンス・キーの検索および更新 . . . . . .
Windows レジストリーでのライセンス・キーの適
用 . . . . . . . . . . . . . . . .
IIS 権限のデフォルトへのリセット . . . . . .
グラフの開始日付に 1970 年の日付が表示される理
由 . . . . . . . . . . . . . . . . .
NT 認証済みユーザーがポータルにログインできない
一部のユーザーはポータルにログインできるが、400
- 不正要求エラーを受け取るユーザーもいる . . .
参照先 . . . . . . . . . . . . . . .
ポータルでの合計セッション数のカウントとアーカ
イブされたセッション数のカウントの差 . . . . .
Internet Explorer での表示の問題 . . . . . . .
信頼済みサイトとしての Tealeaf コンポーネント
の登録 . . . . . . . . . . . . . . .
13
13
15
16
16
16
17
17
18
18
20
22
23
24
25
25
26
27
27
28
28
31
31
31
31
32
32
33
33
34
34
34
iii
Windows でのセキュリティー強化の削除または無
効化 . . . . . . . . . . . . . . . .
IE8 を使用してローカル・マシンでポータルにロ
グインしようとしたときのスタック・オーバーフ
ロー・エラー . . . . . . . . . . . . .
Tealeaf ポータルのすべてのメニュー項目へのアクセ
スの有効化 . . . . . . . . . . . . . .
Internet Explorer でメニュー・バーの下にポータル・
コンテンツが表示されない . . . . . . . . .
ポータルの時刻が数時間ずれている . . . . . .
検索サーバーに接続できない問題のデバッグ . . .
Excel への XML エクスポートを表示するための正
しいファイル関連付けの確認 . . . . . . . .
トラブルシューティング・トピックのプレリリース
5.0 . . . . . . . . . . . . . . . . .
データベースからの誤った日付のパージ . . . .
グラフ作成時の「Event Description Not Found」
メッセージへの対処 . . . . . . . . . .
一般的なポータル・ホーム・ページのエラーへの
対処 . . . . . . . . . . . . . . . .
ポータルのログオン画面を取得できない . . . .
「Error - 593 - Non ADMIN user blocked from
logon」への対処 . . . . . . . . . . . .
どのユーザー ID を使用してもポータルにログイ
ンできないエラーへの対処 . . . . . . . .
ポータルのライブ・セッション・ページで 500 エ
ラーが出される . . . . . . . . . . . .
IIS エラー・メッセージ . . . . . . . . . .
役に立つ他の Microsoft 知識ベースの記事 . . .
完了したセッションの検索を実行できない . . . .
ステータス・コード 400 エラー . . . . . .
検索パフォーマンス問題の診断 . . . . . . . .
要求および応答を検査する「すべてのテキスト」検
索の使用 . . . . . . . . . . . . . . .
検索に単語 NOT を含めることができない . . . .
フィールド名に ~ または他の句読文字が含まれたフ
ィールドで検索できない . . . . . . . . . .
セッション・フラグメントが検索結果に影響する理
由 . . . . . . . . . . . . . . . . .
ポータルとビューアー (またはデータ抽出/cxConnect)
でレポートされるセッション・カウントの差 . . .
検索構成に関する追加情報 . . . . . . . . .
ディスクの入出力が制限されているかどうかの判別
方法 . . . . . . . . . . . . . . . . .
dtSearch のハング後に繰り返される再始動の問題へ
の対処 . . . . . . . . . . . . . . . .
キャニスター・スペーサー・ファイルが存在しない
サービスの開始時に DecoupleEx 警告が発生する . .
TeaLeaf Technology Error: Data length メッセー
ジへの対処 . . . . . . . . . . . . . .
FetchNSAT で WriteInteraction に失敗した . . . .
FetchNSAT failed in WriteInteraction とコード
-160 への対処 . . . . . . . . . . . .
FetchNSAT failed in WriteInteraction とコード
-127 への対処 . . . . . . . . . . . .
サービスの構成に関する追加情報 . . . . . . .
iv
Tealeaf トラブルシューティング・ガイド
35
38
39
39
39
40
41
42
42
43
44
44
45
45
46
46
51
52
53
54
54
55
55
56
57
57
57
58
59
60
61
61
61
62
62
第 2 章 Tealeaf データベースのトラブル
シューティング . . . . . . . . . . . 63
SQL Server 構成. . . . . . . . . . . . .
SQL Server に接続できない . . . . . . . .
モデル・データベース・サイズの不一致が原因で
インストールに失敗する . . . . . . . . .
SQL Server 動的ポートの使用の構成 . . . . .
新しい SQL Server へのマイグレーション . . .
64 ビット・オペレーティング・システムにおける
SQL Server のパフォーマンスが悪い . . . . .
SuperSocket 情報: (SpnRegister): Windows アプリ
ケーション・イベント・ログ内のエラー 1355 . .
SQL Server がプロシージャー
sys.sp_OAGetProperty へのアクセスをブロックす
る . . . . . . . . . . . . . . . .
Tealeaf データベース構成. . . . . . . . . .
接続できない . . . . . . . . . . . . .
アップグレード時に Tealeaf データベース・マネ
ージャーで結果セット抽出のアップグレードに失
敗する . . . . . . . . . . . . . . .
クラスター化サーバー環境でデータベースの作成
に失敗する . . . . . . . . . . . . .
Tealeaf データベース・パフォーマンス . . . .
システム・データベースのアップグレード時に
Tealeaf データベース・マネージャーがハングする
さまざまな Tealeaf データベースでの問題の対処 . .
cxResults の訪問者データベース . . . . . .
cxResults の結果セット抽出データベース . . .
cxReveal データベースのインストールで照合設定
が強制される . . . . . . . . . . . . .
構成の問題 . . . . . . . . . . . . . .
データ収集のパフォーマンスが低い . . . . .
データ収集時間が長い . . . . . . . . . .
データベース接続タイムアウト . . . . . . .
複数のキャニスターからのデータ収集パフォーマ
ンス . . . . . . . . . . . . . . . .
データベースが大きくなりすぎる . . . . . .
エラー - 既存の接続がリモート・ホストによって
強制的に閉じられた . . . . . . . . . .
訪問者データベース抽出 . . . . . . . . . .
訪問者を検索できません . . . . . . . . .
エラー・コード 12029 がレポートされる断続的な
検索サーバー接続エラーの対処 . . . . . . .
データベース・アップグレードのトラブルシューテ
ィング . . . . . . . . . . . . . . . .
データベースのアップグレード時における無効な
ファイル・グループ指定エラー . . . . . . .
チェックリスト . . . . . . . . . . . . .
キャニスター・パフォーマンスの調整 . . . . .
キャニスター・ステータスのモニター . . . .
キャニスター・スプーリング . . . . . . .
Tealeaf サイジング計算のためのメトリック. . .
セッション・タイムアウトの設定 . . . . . .
セッションのフラグメント化の原因 . . . . . .
63
63
64
64
65
66
67
67
68
68
68
69
69
70
71
71
71
72
73
73
73
73
74
74
74
75
75
75
76
77
77
78
78
80
82
84
84
Tealeaf サービスが TLUSER または ADMIN として
キャニスターに接続するための基本キャニスター・
ファイルの再作成 . . . . . . . . . . . . 85
キャニスター・サービスが再始動され続ける . . . 85
キャニスター・ストレージ割り振りの評価 . . . . 85
キャニスター・セッション・エージェント・パフォ
ーマンスの評価 . . . . . . . . . . . . . 86
アーカイブ・サーバーなしでのキャニスター・ファ
イルのバックアップ . . . . . . . . . . . 87
キャニスターの移動 . . . . . . . . . . . 88
キャニスター検索インデックス・データの移動 . 88
キャニスター・セッション・データの移動 . . . 89
キャニスター移動の完了 . . . . . . . . . 89
ctree エラー . . . . . . . . . . . . . . 89
NextLssnRec() のエラー 160(0) . . . . . . . 90
Error 69(0) への対処 . . . . . . . . . . 92
キャニスターを構成するための追加リソース . . . 92
例外をトラブルシューティングするためのログ・レ
ベルの変更 . . . . . . . . . . . . . . 92
「インデックス付け待ちのセッション数 (Sessions
waiting to be indexed)」がしきい値を超えたことの確
認 . . . . . . . . . . . . . . . . . 93
欠落セッションをインデックスに追加するための
「検査と修正」機能の使用 . . . . . . . . . 94
キャニスターからのインデックス付けセッション数
の取得に失敗した . . . . . . . . . . . . 94
インデックス・エラー・リカバリー . . . . . . 95
インデックスの再作成 . . . . . . . . . . . 95
インデックス付けの構成のための追加リソース . . 95
RSE サービスの障害の問題への対処 . . . . . . 95
照会サーバーを正しくシャットダウンおよび再始動
できない . . . . . . . . . . . . . . . 96
トラブルシューティング - データ収集プログラム . 97
無視できるデータ収集プログラム・メッセージ . 97
データ収集プログラムのパフォーマンス問題への
対処 . . . . . . . . . . . . . . . . 97
データ収集プログラム・サービスまたはレポー
ト・データベースがダウンした場合、統計データ
はどうなるか? . . . . . . . . . . . . 98
イベント・グラフのカウントとドリルダウン検索
のカウントの不一致 . . . . . . . . . . 99
データ収集プログラムがキャニスターに接続でき
ない場合の対応方法 . . . . . . . . . . 100
イベント・ログ内の SQL 例外「接続はピアによ
ってリセットされました: ソケット書き込みエラ
ー」 . . . . . . . . . . . . . . . 101
データベース表にデータがあるにもかかわらずデ
ータベース・ファイル・グループ・レポートにデ
ータが表示されない場合の対応方法 . . . . . 101
トラブルシューティング - データ・サービス. . . 102
Failed to write ReportQueryLogEntity エラ
ー・メッセージへの対応方法 . . . . . . . 102
トラブルシューティング - レポート・ビルダー . . 102
レポート・ビルダーからのドリルダウン時の
「There are no matches for your search」 . . . 102
トラブルシューティング - トップ・ムーバー. . . 104
トップ・ムーバー・データが収集されていない場
合の対応方法 . . . . . . . . . . . .
ログのレポート. . . . . . . . . . . . .
データ収集プログラムの構成のための追加リソース
検索サーバー・ログの「Auth failed, no
Authorization header on cmd」エラーへの対処 . .
検索サーバー構成で Active Directory グループを追
加できない . . . . . . . . . . . . . .
104
106
106
107
107
第 3 章トラブルシューティング - 再生
サーバー. . . . . . . . . . . . . . 109
トラブルシューティング - レンダリング問題. . .
BBR の再生ビューにエンコードされた文字で応答
が表示される問題への対処 . . . . . . . . .
再生サーバーを構成するための追加リソース . . .
再生サーバーでのプロキシー・エラーが原因で
BBR セッションが BBR で再生されない . . . .
再生サーバーでのプロキシー・エラーが原因でセ
ッションが BBR で再生されない場合の問題の
診断 . . . . . . . . . . . . . . .
再生サーバーでのプロキシー・エラーが原因でセ
ッションが BBR で再生されない場合の問題の
修正 . . . . . . . . . . . . . . .
BBR でのイベントまたはヒット属性の作成時にポ
ータルが含まれているブラウザー・ウィンドウが開
かない. . . . . . . . . . . . . . . .
ページがレンダリングされない . . . . . . .
109
110
110
110
111
111
112
113
第 4 章トラブルシューティング RealiTea Viewer . . . . . . . . . . 115
RealiTea Viewer のインストールの問題のトラブル
シューティング. . . . . . . . . . . . .
「TeaLeaf RealiTea Viewer requires Microsoft IE
V5.0 or greater」エラーへの対処 . . . . . .
RTV のアンインストール後にもかかわらず「削
除しますか (Would you like to remove)」が表示
され続ける . . . . . . . . . . . . .
RTV パフォーマンスの改善 . . . . . . . .
RTV 拡張オプションの設定 . . . . . . .
外部ファイル・データベースの作成 . . . . .
RealiTea Viewer にイメージが表示されない問題へ
の対処. . . . . . . . . . . . . . . .
RealiTea Viewer でスクリプトが再生されない . .
CallJS:JavaScript 関数が見つかりません:
TeaLeaf_Client_tlGetNodeFromXPath エラーの原
因の調査 . . . . . . . . . . . . . .
RTV でのセッションの取得中における「結果セッ
トからセッションをロードできません」 . . . .
アーカイブされたセッションの再生時におけるエラ
ー . . . . . . . . . . . . . . . . .
ステータス・コード 0 の原因 . . . . . . . .
いくつかのページで「戻る」ボタンが押されたとビ
ューアーで誤って表示される . . . . . . . .
再生ビューに HTTP ヘッダーが表示される問題へ
の対処. . . . . . . . . . . . . . . .
目次
115
115
116
116
116
117
117
118
118
119
120
120
121
121
v
セッションの再生時にページが欠落する考えられる
原因 . . . . . . . . . . . . . . . .
HTTP ステータス・コード 304 およびキャッシュ
に入れられたオブジェクト . . . . . . . . .
セッションで .css ファイルが欠落している理由
静的 HTML ページの再生時におけるエラー . . .
Internet Explorer の最新バージョン用に作成された
アプリケーションでの再生の問題. . . . . . .
IE6 のプロキシー問題 . . . . . . . . . .
IndexWizard.dll is incompatible メッセージへの
対処 . . . . . . . . . . . . . . . .
埋め込みの .pdf 文書が別ウィンドウで開く問題へ
の対処. . . . . . . . . . . . . . . .
イベント・アイコンが使用不可になる問題への対処
オールインワン Tealeaf またはスタンドアロン・
ポータル・サーバー・デプロイメントで使用でき
ないイベント・アイコンへの対処. . . . . .
マルチサーバー・デプロイメントでイベント・ア
イコンが使用できない問題への対処 . . . . .
再生ルールの問題のトラブルシューティング . . .
IgnoreURL ルールがイベント・リストをページ・
リストとマージしてしまう問題への対処 . . .
長時間の使用後に RealiTea Viewer (RTV) が異常終
了する問題への対処 . . . . . . . . . . .
DWR POST の POST データの突き合わせが失敗す
る . . . . . . . . . . . . . . . . .
複数のバージョンの IBM Tealeaf cxImpact にアク
セスするための RTV の構成 . . . . . . . .
トラブルシューティング - 再生の説明 . . . . .
再生の概要 . . . . . . . . . . . . . .
チェック 1. 必要なものがすべてセッション内にあ
ることを確認する . . . . . . . . . . . .
チェック 2. 必要なデータがプライバシーによって
ブロックされていないことを確認する . . . . .
チェック 3. Client UI Capture for Ajax が使用中
で、そのイベントがキャプチャーされる . . . .
vi
Tealeaf トラブルシューティング・ガイド
121
123
124
125
125
126
126
127
127
127
127
128
128
128
129
チェック 4. ナビゲーション・リストの各ページに
対して要求されているメインページが 1 つのみで
あることを確認する . . . . . . . . . . . 134
チェック 5. フレーム・コンテンツが正しく構成さ
れていることを確認する. . . . . . . . . . 135
次のステップ . . . . . . . . . . . . . 136
第 5 章再生の問題のテーブル . . . . 137
cxReveal エラー「スレッドは中止されつつありま
した。(Thread was being aborted.)」 . . . . . . 150
cxReveal データベースにあるセッションを再生でき
ない . . . . . . . . . . . . . . . . 151
第 6 章 Tealeaf 管理システムのトラブ
ルシューティング . . . . . . . . . . 153
TMS 始動のトラブルシューティング . . . . .
TMS マスターのサーバー・リストに TMS スレ
ーブ・サーバーが表示されない . . . . . .
始動時に、イベント・ログオン TMS スレーブ
で、TMS マスターとして実行されていると示さ
れる . . . . . . . . . . . . . . .
自己署名 TMS 証明書の有効期限が切れた. . .
TMS サービスに対して非 SSL モードを構成し
ている場合は、Tealeaf 管理システム (TMS) に
アクセスしようとするとエラーが発生します。 .
不明なマスターからの要求 . . . . . . . . .
153
153
153
154
155
156
129
129
130
第 7 章 IBM Tealeaf の資料およびヘル
プ . . . . . . . . . . . . . . . . 157
130
商標 . . . . . . . . . . . . .
プライバシー・ポリシーに関する考慮事項.
132
133
特記事項. . . . . . . . . . . . . . 161
.
.
.
.
. 163
. 163
Tealeaf トラブルシューティング・ガイド
「Tealeaf® トラブルシューティング・ガイド」は、Tealeaf システムでの一般的な問
題に対処するための技法を示します。本書内の特定のトピックにアクセスするに
は、以下で示すそれぞれのリンクを使用してください。
トラブルシューティングが必要な状況または時期の判断
エラー・メッセージの発生時刻
毎日スケジュールされている Tealeaf サービスの再始動と同じ時刻にエラー・メッ
セージが発生しますか? これが当てはまる場合、サービスの停止および開始中には
Tealeaf システムのコンポーネントへのアクセスが使用不可になるため、恐らく、エ
ラー・メッセージは無視できます。
検索サーバー・サービス
Tealeaf ユーザーに問題が生じておらず、サービスが停止時に自動的に再始動されて
いる場合、通常、これらの問題は無視できます。
TeaLeaf Search Server - 許可エラー: NetGroupGetUsers() また
は NetLocalGroupGetMembers()
適用対象バージョン:
4.x; 5.x; 6.x
解決方法の詳細
以下のエラーを受け取る場合があります。TeaLeaf Search Server Authorization error:
NetGroupGetUsers() error (group: ): The RPC server is unavailable.
(または、NetLocalGroupGetMembers() 関数呼び出しについて述べた同じメッセージ)
NetGroupGetUsers または NetLocalGroupGetMembers 関数呼び出しに関連した断続的
なメッセージは、Tealeaf サーバーがそのときにドメイン・コントローラーに接続し
て Active Directory グループ情報を取得できないことを示しています。NT/AD 管理
者に相談して、これが発生する理由を調査してください。
この動作が断続的かつ短期間である場合、検索サーバーが最新のリフレッシュから
取得したユーザー・グループ・メンバーシップ情報のキャッシュ・コピーを保持し
ているため、重大なエラーではなく、小さな問題です。ドメイン・コントローラー
で新規ユーザーをグループに追加し、このエラーが発生し、その新規ユーザーが検
索 (またはビューアーの検索およびポータルへのログインとポータルの使用の両方
である、認証が必要なシステムの一部を使用) しようとしたのではない限り、
Tealeaf システムの使用に影響することはありません。ただし、検索サーバーが実行
するユーザー・グループ定義の次回の正常なリフレッシュの後に、すべてが期待ど
おりに機能する必要があります。
© Copyright IBM Corp. 1999, 2015
vii
TeaLeaf Search Server バージョン: 6.2.0.6241 - メインスレッ
ド・プロシージャーが cmd/COMMAND で異常終了した。
TLSrchSrv ログを調べてください。
Tealeaf CX 問題診断
Tealeaf システムでの問題を正しく診断するには、まずエラーの原因となっている
Tealeaf コンポーネントを切り分ける必要があります。以下のステップを使用して、
提供されている診断ツールを実行し、ディスク・スペースやログ・ファイルなどの
標準的な問題を検査します。
診断を開始するには、以下のようにします。
1. Tealeaf を実行します。Tealeaf ステータス・ツールは、問題の識別に役立つよう
に、各 Tealeaf サーバーに対して一連のテストを実行します。Tealeaf ステータ
スは、IBM Tealeaf CX システムから独立したレポート作成メカニズムです。シ
ステムの正常性に対するダッシュボード・ビューを提供します。
v ほとんどのインストール済み環境で、Tealeaf ステータスは、スケジュールさ
れたタスクとして実行されるように構成されます。このタスクは、手動でトリ
ガーすることもできます。「IBM Tealeaf cxImpact 管理マニュアル」の
『Tealeaf ジョブのスケジュール』を参照してください。
2. ディスク・スペースを検査します。Tealeaf コンポーネントによるディスク使用
量も Tealeaf ステータス・レポートのしきい値です。
3. アプリケーション・ログおよびイベント・ログのメッセージを表示します。
Tealeaf は、すべてのコンポーネント、イベント、およびサービスに関する広範
囲に及ぶログを生成します。定期的に、また緊急の問題をトリアージするため
に、これらのログを確認する必要があります。
v Tealeaf は、ログ・ファイルを以下の場所に保管します。
<Tealeaf_Install_Directory>¥Logs
4. 検索サーバーを実行します。検索サーバーでは、インデックスの問題を検査およ
び修正できます。検査および修正操作により、キャニスターは TLC ファイルを
FilesToIndex ディレクトリーに書き込むことができます。そこで、それらのフ
ァイルは、Index Multiprocessor によって再インデックス付けされます。検索サ
ーバーでインデックスの検査および修正を実行するには、以下のようにします。
a. ブラウザーを開いて次の URL を入力します。
http://<machinename>:19000
b. 「検索サーバー」ページの下部にある「キャニスター・インデックス・チェ
ッカーの実行 (Run Canister Index Checker)」をクリックします。
c. 合計セッション数に対するインデックス付けされたセッション数が表示され
ます。これらのインデックスは、インデックス処理をより効率化するため
に、100 単位のバッチで処理されます。
v インデックス付けされた数の方が少ない場合、インデックス付けされてい
ないセッションがページの下部にリストされます。
viii
Tealeaf トラブルシューティング・ガイド
トラブルシューティング・ストラテジー: 開始点、ターゲット
システムのコンポーネントの機能およびコンポーネント間のデータ・フロー・パス
を理解しておくと、問題の考えられる原因またはその近傍でのトラブルシューティ
ングに役立ちます。少なくともこの知識は、整理された方法で他の考えられる原因
を除去し、データ・フロー・パスを通常の方向または逆方向に辿ることで、問題の
原因に向かう見込みのある方向性を示すガイドラインとなります。
Tealeaf システム・コンポーネント間のデータ・フロー・パス
以下の図では、Tealeaf システムのコンポーネント間でデータがフローする方向を示
します。矢印上の「プル」ラベルは、宛先コンポーネントがソース・コンポーネン
トからデータをアクティブにプルすることを示しています。このラベルがない場
合、宛先は、ソース・コンポーネントからプッシュされたデータをパッシブに受信
します。
v キャプチャー: Tealeaf データ・キャプチャーは、IBM Tealeaf CX Passive
Capture Application サーバー (PCA サーバー) または IIS キャプチャー・フィル
ターを介して行われます。
v パイプライン: パイプラインは、PCAサーバー上または Tealeaf トランスポー
ト・サービス (または場合によっては IIS キャプチャー、IIS キャプチャーを使
用した場合、パイプラインは最小限) で実行されます。
v STC: 短期キャニスターは、ヒットのセッション化、統計の組み立て、およびイ
ベント検出を実行するメモリー内データ・ストアです。また、セッションが構成
済みのセッション・アイドル・タイムアウト期間を超過するか、セッション終了
イベントをトリガーした場合に、そのセッションを閉じます。
v LTC: 長期キャニスターは、Tealeaf ユーザーが再生できるセッションのディス
ク・ベースのストレージを提供します。
v インデックス付け: LTC に保管されているセッションの検索をサポートするため
に、セッションは検索エンジンによってインデックス付けされます。
v レポート作成: ヒット、ページ、セッション、バイトなど、イベントおよび基本
的な値に関する統計が STC から収集されて、SQL データベース内で時間に沿っ
て集計されます。
v アーカイブ: オプションの Tealeaf アーカイブ・サービスは、ストレージ・キャ
ニスターとは異なるマシンにインストールした場合、LTC よりも長期のストレー
ジおよび高速な検索を提供します。また、アーカイブでは、サード・パーティー
のツールを使用して、キャニスターを実行するよりも簡単にバックアップできま
す。
Tealeaf トラブルシューティング・ガイド
ix
v 検索: Tealeaf システムでの検索は、この図では示されていない検索サーバー・サ
ービスによって実行されます。以下の図において、「検索」と「再生」のデー
タ・フローは、このサービスによって仲介されます。検索サーバーは、STC およ
び LTC の検索機能を提供します。
以下の図では、Tealeaf クライアント (ポータルおよび IBM Tealeaf CX RealiTea
Viewer) とキャニスター・サーバー・サイド・コンポーネントの間のデータ・フロー
を示します。これらのフローは、クライアントによって開始されるプルです。「S」
は検索を表し、「R」はセッション再生を表しています。
v ポータルによるセッション再生は、IBM Tealeaf cxImpact、IBM Tealeaf cxView
6.0 以降、および IBM Tealeaf cxResults 7.0 以降で Web ブラウザー・ベースの
再生によって、または任意の Tealeaf バージョンで IBM Tealeaf CX RealiTea
Viewer によって実行できます。
ツール
診断ユーティリティー
v PCA Web UI
– 「サマリー」ページ
– 「SSL 鍵 (SSL Keys)」ページ
– 「バックアップ/ログ (Backups/Logs)」ページ
– 「統計」ページ
v Tealeaf ソケット・ステータス
v Tealeaf パイプライン・ステータス
x
Tealeaf トラブルシューティング・ガイド
テスト・ツール
v TealeafArchiveReader
v イベント・テスター
構成ポイント
構成ファイル
v TealeafCaptureSocket.cfg
v RTA.ini
v Privacy.cfg
v RTASplit.ini
v HitRouter_PipelineN.cfg
v TealeafIIS[6].cfg
v TealeafCaptureSocket.cfg またはその内容によって参照される他のファイル
GUI 構成ユーティリティー
Tealeaf コンポーネントのほとんどの構成は、Tealeaf 管理システムを使用して管理
するようになっています。「IBM Tealeaf cxImpact 管理マニュアル」の『Tealeaf 管
理システム』を参照してください。
v TMS のトラブルシューティングについては、 153 ページの『第 6 章 Tealeaf 管
理システムのトラブルシューティング』を参照してください。
イベントは、Tealeaf イベント・マネージャーを使用して作成および編集できます。
v 「IBM Tealeaf CX イベント・マネージャー・マニュアル」の『Tealeaf イベン
ト・マネージャー』を参照してください。
ポータル構成
v 管理ツール (RealiTea 4.6 以前)
v 「ツール」 > 「管理」 (IBM Tealeaf cxImpact 5.x および 6.x、IBM Tealeaf
cxView 6.x 以降)
v 「検索」 > 「テンプレートの構成 (Configure Templates)」 (IBM
TealeafcxImpact および IBM Tealeaf cxView 6.x)
v 「Tealeaf」 > 「ポータル管理」 (IBM Tealeaf cxImpact、IBM Tealeaf
cxView、IBM Tealeaf cxResults 7.0 以降)
v 「構成」 (IBM Tealeaf cxImpact、IBM Tealeaf cxView、IBM Tealeaf cxResults
7.0 以降)
Tealeaf トラブルシューティング・ガイド
xi
構成設定および値
ユーザー名とパスワード
TLADMIN および TLUSER アカウントは、SQL Server データベースにアクセスするた
めに使用します。これらの 2 つのアカウントのパスワードは、SQL Server 自体で
変更できます。また、変更した場合は、TMS のレポート・サーバー構成で同じ値を
入力する必要があります。
v 「IBM Tealeaf CX 構成マニュアル」の『レポート・サーバーの構成』を参照して
ください。
人間のユーザーは、ポータル Web アプリケーションの UI 内で作成されたポータ
ル・アカウントを所有している必要があります。
v Windows NT 認証統合機能を使用している場合でも、ポータルを使用してユーザ
ー・アカウントを作成する必要があります。ただし、TMS の検索構成で認証用に
指定された NT/AD グループに属している許可ユーザーに対してアカウントを自
動作成するようにポータルを構成できます。
– 「IBM Tealeaf CX 構成マニュアル」の『検索サーバーの構成』を参照してく
ださい。
また、キャニスター・データ・ストア内の TLADMIN および TLUSER (TM のキャ
ニスター構成およびインデックス構成で表示される) は、人間のユーザーが直接使
用するのではなく、Tealeaf ソフトウェアのみが使用します。デフォルト・パスワー
ドは、ユーザー名と同じであり、変更してはなりません。ただし、必要であれば、
以下の 2 つのユーティリティーのいずれかを使用して変更できます。
v 「IBM Tealeaf CX 構成マニュアル」の『CX キャニスターの構成』を参照してく
ださい。
v 「IBM Tealeaf CX 構成マニュアル」の『CX インデックス付けの構成』を参照し
てください。
SQL Server とキャニスター・データ・ストア・ユーザー名およびパスワードは互い
に無関係です。たまたま同じ名前になっているだけです。
xii
Tealeaf トラブルシューティング・ガイド
第 1 章データの保存と再作成
重要なデータを保存して、システム障害が発生した場合に Tealeaf 構成を再作成で
きるようにしておく必要があります。
以下のセクションには、システム障害の発生時にシステムを迅速にリストアまたは
マイグレーションできるように、重要な Tealeaf 構成およびデータをバックアップ
するための手順が記載されています。
データ・バックアップの推奨および考慮事項
Tealeaf では、推奨ストラテジーの 1 つを使用して、すべての Tealeaf データベー
スの定期的なバックアップを実行することをお勧めします。
キャプチャーされるトラフィックのサイズおよび毎日のボリュームに応じて、それ
らのストラテジーの中でも、より適切なものがある場合があります。
キャニスターまたは SQL Server データベースからデータをクリアする前に、デー
タのバックアップを実行することをお勧めします。
注: インデックスが含まれているすべてのテーブルは、レポート・データベースに
保管されます。これにより、この単一のデータベースのバックアップを実行するこ
とで、正確な「ポイント・イン・タイム」のスナップショットを作成できます。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『TLBackup および TLRestore』を参
照してください。
v 「IBM Tealeaf CX データベース・ガイド」の『データベース・バックアップ・ス
トラテジー』を参照してください。
環境の保存または CX 設定のマイグレーションのためのバックアップの推
奨
マシン全体が失われる完全な破損に備えて、インストール済み環境を再カスタマイ
ズせずにインストール済み環境を再作成できるように、以下の IBM Tealeaf CX サ
ーバー項目のコピーを作成する必要があります。
v バックアップの長期キャニスターおよびインデックス
v Tealeaf レポート定義 (TL_SYSTEM データベース)
v システム・フォルダーの内容
v すべての構成ファイル (*.cfg)
v ルール・スクリプト・ディレクトリー (分割パイプラインの場合は特に)
v レジストリー・ハイブ:
1. HKEY_LOCAL_MACHINE¥SOFTWARE¥TeaLeaf Technology
2. HKEY_CURRENT_USER¥Software¥TeaLeaf Technology
3. HKEY_CURRENT_USER¥Software¥TeaLeaf
© Copyright IBM Corp. 1999, 2015
1
環境を保存するためのミラー・サーバーの作成
問題が発生しているのと同じインストール済み環境および設定が含まれたミラー・
サーバーを作成して、環境を保存することができます。
これを行うには、Norton Ghost のようなツールを使用して、サーバーのディスクの
イメージを作成します。
データベースからのデータのクリア
Tealeaf データベースからデータをクリアするいくつかの方法があります。
データベースからの段階的なデータのクリア
キャニスター、データ収集、およびデータ保存の各設定を調整して、Tealeaf システ
ムによって処理されていないデータを失わずにデータが削除されるようにすること
で、データベースから段階的にデータを削除できます。
例えば、データ保存期間を 1 日に構成して、データベースをトリムする毎日の時刻
の少し前にデータ収集が行われることを確認すれば、データをより正しく削除でき
ます。
注: トリムされたデータは以前にアーカイブされていない限り、検索および取得で
きなくなります。
v 「IBM Tealeaf CX 構成マニュアル」の『CX キャニスターの構成』を参照してく
ださい。
データの収集と集計のプロセスについて詳しくは、「IBM Tealeaf cxImpact 管理マ
ニュアル」の『データの集計および保存』を参照してください。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『CX 設定』を参照してください。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『CX 設定』を参照してください。
システム・パラメーターを変更することで、段階的なデータのクリアを操作できま
す。
v IBM Tealeaf CX データベース:「IBM Tealeaf cxImpact 管理マニュアル」の
『CX 設定』を参照してください。
v IBM Tealeaf cxResults データベース:「IBM Tealeaf cxImpact 管理マニュアル」
の『cxResults 設定』を参照してください。
以下のセクションでは、キャニスター・データベースおよび SQL Server データベ
ースからデータを強制的にクリアする方法に関する詳細情報を示します。
キャニスターからのデータの即時クリア
CanRebuild ユーティリティーを使用してキャニスターを再作成することで、キャニ
スターから即時にデータをクリアできます。
CanRebuild を使用して問題のあるデータを即時に削除できますが、デフォルトで
は、Tealeaf キャニスターおよびデータベースでは、構成設定に基づいて古いデータ
がトリムされます。
2
Tealeaf トラブルシューティング・ガイド
注: キャニスターからクリアされたデータをリカバリーすることはできません。
Tealeaf では、安全のため、キャニスターのバックアップを実行することをお勧めし
ます。「IBM Tealeaf cxImpact 管理マニュアル」の『TLBackup および TLRestore』
を参照してください。
キャニスターの再作成
必要であれば、短期キャニスター、長期アーカイブ、および対応する dtSearch イン
デックスを再作成できます。
CanRebuild ユーティリティーは、すべてのセッション・データの削除も行います。
すべてのデータを削除した後に、短期キャニスター・テーブルを再作成し、イベン
ト定義を読み取ります。
注: CanRebuild は、IBM Tealeaf CX データ・ストアからすべてのセッション・デ
ータを消去します。このユーティリティーは、IBM Tealeaf CX サーバーが応答せ
ず、データ・ストアを修復するための他の試行がすべて失敗した場合の最後の手段
としてのみ使用してください。
CanRebuild ユーティリティーを実行する前に、以下のようにします。
v TLBackup.exe ユーティリティーを使用して、セッション・データをバックアップ
します。
v キャプチャー・ソースがキャニスターへのヒットの送信を停止したことを確認し
ます。キャプチャー・フィルターを停止するか、拡張デカプラーでトランスポー
ト・サービス・パイプライン内のヒットをキューに入れる必要があります。
注: CanRebuild ユーティリティーは、ローカル・ファイル・システムでのみ機能
します。リモート・データベース上のファイルは存在しないため、削除しようと
しないでください。リモート SQL データベースの再作成について詳しくは、 4
ページの『リモート MS SQL データベースの再作成』を参照してください。
IBM TealeafCX データ・ストアを再作成するには、以下のようにします。
1. 「コマンドプロンプト」を開きます。Tealeaf インストール・ディレクトリーに
ナビゲートします。
2. コマンド・ライン・プロンプトで、以下のコマンドを入力します。
CanRebuild
インストールされている Tealeaf のバージョンに応じて、以下のオプションが使
用可能です。
注: 「セッション・データの保持 (Preserve Session Data)」を選択しなかった
場合は、既存のすべてのキャニスター・データが破棄されます。
オプション
説明
完全なキャニスターの再作成 (Rebuild Full Canister)
IBM Tealeaf CX サーバー・マシンおよびインデックス付けマシン (デュ
アル・インストール済み環境の場合) でサービスを停止します。キャニ
スターからすべてのセッション・データを削除し、キャニスター・テー
第 1 章データの保存と再作成
3
ブルを再作成します。「完全なキャニスターの再作成 (Rebuild Full
Canister)」オプションでは、セッションの対応するインデックスも削除さ
れます。
スプール・ファイルの削除 (Delete Spool Files)
このオプションが選択された場合、キャニスター・ハード・ディスクに
保管されているスプールされたヒットが含まれているすべてのファイル
が削除されます。このオプションを使用するのは、スプールされたデー
タが破損状態であることが分かっている場合か、削除する必要がある場
合のみにしてください。
セッション・データの保持 (Preserve Session Data)
このオプションは、サーバー上の長期キャニスターに保管されたセッシ
ョン・データを保持する場合に選択します。
注: このオプションが有効になっていない場合、サーバー上のすべての
セッション・データ (インデックス・ファイルを含む) は、再作成の一環
として削除されます。
3. キャニスターの再作成を実行するために、「再作成 (Rebuild)」をクリックしま
す。
v 再作成せずにユーティリティーを終了する場合は、「キャンセル」をクリック
します。
SQL Server からのデータのクリア
SQL Server データベースは、以下に説明する場合を除いて、ドロップおよび再作成
することでクリアできます。
注: Tealeaf システムを再インストールする場合を除いて、TL_SYSTEM データベース
をドロップおよび再作成しないでください。
以下の IBM Tealeaf CX データベースを単独でドロップおよび再作成できます。
v TL_REPORTS
v TL_STATISTICS
v TL_RSEXTRACTOR
IBM Tealeaf cxResults データベースはリンクされているため、単独でドロップする
ことはできません。
注: IBM Tealeaf cxResults データベースのいずれかをドロップおよび再作成する必
要がある場合は、両方 (TL_VISSTAGE と TL_VISREPORT) をドロップおよび再作成す
る必要があります。
リモート MS SQL データベースの再作成
Tealeaf データベース・マネージャーを使用して、データベースのドロップおよび再
作成を実行できます。
このプロセスには、SQL Server でのシステム管理者特権が必要です。
リモート MS SQL データベースを再作成するには、以下のようにします。
4
Tealeaf トラブルシューティング・ガイド
1. データをリストアする必要が生じた場合に備えて、再作成する既存のデータベー
スをバックアップします。
2. ポータル・サーバーで、Tealeaf データベース・マネージャーを開始します。次
の実行可能ファイルをダブルクリックします。
¥<Tealeaf_install_directory>¥Reporting¥TealeafDatabaseManager.exe
v 「IBM Tealeaf CX データベース・ガイド」の『Tealeaf データベースのインス
トール』を参照してください。
v Tealeaf データベース・マネージャーについて詳しくは、「IBM Tealeaf CX デ
ータベース・ガイド」の『Tealeaf データベース・マネージャーの使用』を参
照してください。
v 「IBM Tealeaf CX データベース・ガイド」の『Tealeaf データベース・マネー
ジャー・リファレンス』を参照してください。
Tealeaf サーバー間の時刻の同期
すべての Tealeaf サーバー上の時刻が厳密に同期されていることが重要です。
信頼できるマスター・クロックにそれ自体が同期されている共通ソースに対して、
すべてのサーバーが同期されている必要があります。
システム・タイムの構成について詳しくは、「IBM Tealeaf CX 構成マニュアル」の
『システム・タイム・ゾーンの構成』を参照してください。
Tealeaf サーバー
Tealeaf ソフトウェアは通常、Windows 2003 または Windows 2008 サーバーで実行
されます。各サーバーの「コントロールパネル」で、「日付と時刻」アプレットを
使用して、タイム・ゾーン、日付、および時刻が正しく設定されていることを確認
します。
サーバーは自動的に、サーバーの接続先のドメイン・コントローラー上のクロック
に自身のクロックが同期された状態を保ちます。Tealeaf システムがドメインに属し
ていない場合、http://support.tealeaf.com/ でサポート・ケースを開いて、スクリプ
ト・ソリューションまたはサード・パーティーの時刻同期ソリューションの構成の
支援を依頼してください。
Tealeaf タイム・ゾーン
リリース 8.0 では、ユニバーサル・タイム・ゾーン設定がすべての Tealeaf サーバ
ーに適用されます。
すべての Tealeaf ソフトウェアは、夏時間調整時刻に必要な変更を認識していま
す。すべてのタイム・ゾーンの選択は、標準時からのオフセットを使用して行われ
ます。例えば、夏時間調整時刻が有効になっている場合でも、米国の東海岸にある
すべてのシステムに対して、「GMT-5:00 東部標準時 (米国およびカナダ)」を選択
する必要があります。
v 「IBM Tealeaf CX 構成マニュアル」の『システム・タイム・ゾーンの構成』を参
照してください。
第 1 章データの保存と再作成
5
PCA サーバーの時刻とトランスポート・サービスの時刻の同期
PCA サーバーは企業のマスター・クロックにアクセスできない可能性があるため、
接続先のメイン Tealeaf トランスポート・サービスに時刻を同期するように構成す
る必要があります。
PCA サーバー時間は、時間設定で最も重要です。すべての PCA サーバーは、互い
に数秒以内の差になっていなければなりません。PCA サーバーは、要求ごとに
[timestamp] セクションを作成します。ここに記録された日時は、GMT 時間です。
v 各タイム・スタンプの末尾に追加された Z に注意してください。
PCA サーバー時間を同期するには、以下のようにします。
1. SSH と root ユーザー ID を使用して PCA サーバーにログインします。
a. データ・センター内のメイン Tealeaf トランスポート・サービスをホストし
ている Tealeaf サーバーにインストールされていることが多い、PuTTY プロ
グラムを使用できます。
2. コマンド date を実行します。これにより、日付、時刻、および PCA サーバー
で構成されているタイム・ゾーンが表示されます。
v 「IBM Tealeaf Passive Capture Application マニュアル」の『PCA Web コンソ
ール -「配信 (Delivery)」タブ』を参照してください。
v タイム・ゾーンの変更について詳しくは、「IBM Tealeaf CX 構成マニュア
ル」の『システム・タイム・ゾーンの構成』を参照してください。
IBM TealeafCX RealiTea Viewer のタイム・ゾーンの構成
IBM TealeafCX RealiTea Viewer のタイム・ゾーンを構成できます。
このトピックでは、IBM TealeafCX RealiTea Viewer のタイム・ゾーンで使用され
るタイム・ゾーンの構成方法を説明します。通常は、タイム・ゾーンは RTV ユー
ザーのタイム・ゾーンと一致します。
1. RTV を起動します。
2. メニュー・バーから「ツール」 > 「オプション」を選択します。
3. 結果のダイアログで「再生」タブを選択します。
4. 「タイム・ゾーン」ドロップダウンから正しいタイム・ゾーンを選択します。
Passive Capture Application サーバー (PCA サーバー) のトラブルシュ
ーティング
TMS の「パイプライン・ステータス」タブを確認することで、Tealeaf 処理サーバ
ーが、PCA からキャプチャーされたデータを受け取っているかどうかを判別できま
す。
PCA のトラブルシューティングを開始する前に、以下の構成ステップを正常に完了
したことを検討および確認する必要があります。
v PCA のインストール後に、必要なすべてのデータ型を効果的にキャプチャーし、
ご使用の環境内でのキャプチャー用に PCA を調整するために、追加構成が必要
になることがあります。「IBM Tealeaf Passive Capture Application マニュアル」
の『インストール』を参照してください。
6
Tealeaf トラブルシューティング・ガイド
v また、PCA が初期インストール時に正しく構成されたことを検討および確認する
必要もあります。「IBM Tealeaf Passive Capture Application マニュアル」の『初
期 PCA 構成』を参照してください。
Tealeaf 処理サーバーが PCA からキャプチャー・データを受信しているかどうかを
判別するには、以下を実行します。
1. Tealeaf ポータルに管理者としてログインします。
2. メニューから、「Tealeaf」 > 「TMS」を選択します。
3. 「パイプライン・ステータス」タブをクリックします。「IBM Tealeaf cxImpact
管理マニュアル」の『TMS の「パイプライン・ステータス」タブ』を参照して
ください。
4. ページ・ビューおよび受信データ・バイト数がゼロではないことを示している、
PCA として名前または IP アドレスのラベルが付いた接続を検索します。接続
が見つかった場合は、処理サーバーは PCA からデータをキャプチャーしていま
す。
それ以外の場合は、この解決方法の残りの部分に進んでください。
5. PCA の Web UI の「サマリー」(ホーム) ページで最新の統計を確認します。
a. 自動的に最新表示されて過去約 15 秒間のアクティビティーが表示されてい
る場合、ゼロでない数値のヒット数およびパケット数があるかどうかを確認
します。
b. ヒット数がゼロの場合、この解決方法の次の部分に進みます。
6. PCA のコマンド・ラインから以下の TCPDump コマンドを実行します。
a. 十分な間隔でコマンドを実行し、ご使用の Web サーバーの IP アドレスが、
出力行の > 文字の左側と右側の両方に表示されるかを判別します。そうなっ
ていない場合は、> 記号のどちら側で Web サーバーの IP アドレスが表示さ
れないのかをネットワーク・チームに知らせます。
b. Web サーバーが標準 IP ポート番号 80 で動作していると仮定すると、コマ
ンドは以下のようになります。
tcpdump -n -i <NIC> port 80
7. 1 つ以上の PCA のネットワーク・インターフェースで、ご使用の Web サーバ
ーからの双方向のポート 80 トラフィックが確認された場合、トラフィックをさ
らに診断する必要があります。
a. TCPDump を使用して、以下のコマンドで一部のネットワーク・トラフィック
をファイルに書き込みます。これにより、バイナリー・フォーマット・デー
タが output_file_name に書き込まれます。
tcpdump -n -i <NIC> -s0 -w output_file_name port 80
8.
output_file_name
オープン・ソースの Wireshark プロトコル・アナライザー (http://wireshark.org/)
またはこれに相当するツールを使用して、これを開き、パケットの欠落などの異
常について分析する必要があります。
第 1 章データの保存と再作成
7
a. 表示されている内容が分からない場合、Tealeaf は、ライブ・ミーティング・
セッションによって、またはお客様からダンプ・ファイルを取得して (ユーザ
ーの個人情報が含まれていない場合)、この診断の支援を行うことができま
す。
PCA メッセージ・ロギングの管理
PCA メッセージ・ロギングを管理して、Red Hat Linux 上の「messages」ファイル
が Passive Capture メッセージを受け取らないようにすることができます。
デフォルトの syslog.conf では、/var/log/messages がすべてのログ通知メッセージ
(Passive Capture からのものを含む) を受け取ります。
以下の手順では、syslog.conf を変更して、Red Hat Linux 上の「messages」ファイ
ルが Passive Capture メッセージを受け取らないようにする方法を示しています。
syslog.conf を変更するには、以下を実行します。
v /etc/syslog.conf ファイル内の /var/log/messages の行を以下のように編集しま
す。
*.info;mail.none;authpriv.none;cron.none;local0.none /var/log/messages
v local0.none 設定を組み込んで、Passive Capture ログ・メッセージが
/var/log/messages に書き込まれないようにします。
これらのメッセージは引き続き、Tealeaf 固有の capture.log ファイルに書き込ま
れます。
突き詰めると、これらのログ・ファイルのいずれかにおいて Passive Capture からの
多数のメッセージが存在する場合、IBM Tealeaf CX Passive Capture Application サ
ーバー (PCA サーバー) キャプチャー NIC に入ってきている入力データで問題が
発生していることを示しています。上記の手順は、Passive Capture メッセージの冗
長なロギングを除去する手段に過ぎません。引き続き、PCA への入力データ・スト
リームに対する修正アクションが恐らく必要です。
ReqCancelled=Client ヒットの問題への対処
Tealeaf システムに大量の ReqCancelled=Client 要求が記録される場合、5% 以上
の ReqCancelled=Client のヒットがセッション全体にランダムに散在しているか、
集中的な数の ReqCancelled=Client ヒットが密接して発生していることがありま
す。
この問題をトラブルシューティングするには、tcpdump コマンドを使用する必要が
あります。
1 つのファイルに tcpdump を実行すると、大きなファイルがすぐに生成されます。
tcpdump および http://support.tealeaf.com/ リソースを最大限に利用してデータを分析
するには、多数の ReqCancelled=Client ヒットが含まれているセッションを再現で
きることが重要になります。分析用のダンプ・ファイルの記録を開始する前に、問
題の動作を効果的に作成可能である必要があります。そのため、最初のステップと
して、ReqCancelled ヒットを確実に再現する方法を調査します。
8
Tealeaf トラブルシューティング・ガイド
注: この解決方法は、標準インデックス付けを使用している Tealeaf バージョン 4.5
SP0 以降に適用されます。
v Tealeaf データ抽出または IBM Tealeaf cxConnect for Data Analysis が配置されて
いる場合は、Tealeaf データに対して照会を実行して以下を判別するように BI 分
析チームに依頼してください。
– ReqCancelled が発生している、合計ヒットのパーセントの上位 10 件の URL
– 上位 10 件のセッション内のヒット番号 (特に、セッションの開始で、より頻
繁に発生している場合)
– ReqCancelled が発生している、上位 3 件の時刻
– ReqCancelled が GET または POST 操作のどちらで、より多く発生している
か
– 非常に頻繁に発生している特定のサーバーまたはデータ・ファームはあるか
– これらの原因となっている特定のプロキシーまたはロード・バランサーはある
か (HTTP VIA® REQ フィールドの分析)
v データ抽出がない場合、分析はより複雑になり、以下の手順が必要になります。
1. インデックス付けする追加フィールドを指定する RTA.ini ルールに以下のフ
ィールドを追加します (リストにまだ存在しない場合)。
– ReqCancelled
– HTTP VIA (Tealeaf によってキャプチャーされる REQ で提供されている場
合)。一部のネットワークではこのフィールドはありませんが、物理ロー
ド・バランサーまたはプロキシーに関係するネットワークにはあります。
2. 少なくとも 1 営業日、通常どおりにデータ収集を実行します。
3. 検索を手動で使用して、上記のケース 1 で指定したのと同じ情報を取得しま
す。
分析により、多数の ReqCancelled=Client が含まれたセッションの原因であ
る可能性が最も高い特定の状態が導き出されたら、次にデータ・ダンプを記録
します。
これでデータ・ダンプを記録する準備ができました。
データ・ダンプの記録による ReqCancelled=Client ヒットの根本
原因の特定
データ・ダンプを記録して、ReqCancelled=Client ヒットの根本原因を特定できま
す。
1. ReqCancelled=Client ヒットを引き起こした可能性が最も高いと分かっている状
態をできる限り綿密に複製する必要があります。いずれかの特定のページにアク
セスでき、またいずれかの特定の Web サーバーまたはプロキシーに要求を送信
できることを確認する必要があります。数回テスト実行を完了し、特定のテス
ト・セッションを行い、Tealeaf でキャプチャーされたデータを使用して、テス
ト・セッションに多数の ReqCancelled=Client ページがまだ含まれていること
を確認します。
2. 実際の tcpdump レコードを作成するための時間を用意します。
a. 可能であれば、1 日の静かな時間にスケジュールします。
第 1 章データの保存と再作成
9
b. tcpdump データに数件のセッションのみが含まれている場合、問題の発見が
はるかに簡単になります。
c. 短期間 (可能であれば、5 分以下)、tcpdump を実行します。これで、動作を
迅速に生じさせることが保証された反復可能なテスト・ケースが作成されて
おり、長期間 tcpdump を実行する必要がなくなります。
3. SSH を使用して PCA にログインし、できる限り多くの制限条件を指定して、
tcpdump コマンドをセットアップします。例えば、テスト・ケースが特定の
Web サーバーに違反することが分かっている場合、その IP アドレスのみを
listen するように tcpdump に指定します。
4. tcpdump コマンドを開始します。
5. テストを実行します。
6. Ctrl-C を使用して、TCPDump コマンドを停止します。
7. Tealeaf キャニスターでセッションを検索します。
a. セッションに ReqCancelled=Client ヒットがあることを確認します。
b. セッションを .tls ファイルとして保存します。必ず、イメージの取得を最
初に実行してください。
8. tcpdump でユーザーの機密情報が含まれていないことが保証できる場合、
http://support.tealeaf.com/ で相談して、FTP で tcpdump ファイルを Tealeaf に分
析用に送信できます。
a. tcpdump ファイルに実動データが含まれていて、機密情報または個人情報が
含まれている可能性がある場合は、http://support.tealeaf.com/ に問い合わせ
て、データのリモート分析用の時間を設けてください。
9. キャプチャーされたセッション、およびセッションがキャプチャーされたのと同
じ期間における未加工トラフィックの対応する tcpdump が用意できたら、
Tealeaf エンジニアリングが、ReqCancelled=Client ヒットの根本原因の特定を
支援できます。
Tealeaf キューの開始に失敗し、キャプチャーが無効になった場合の対応方
法
Tealeaf キューの開始に失敗し、キャプチャーが無効になった場合、いくつかの手順
を実行します。
キャプチャーを正しく初期化できなかった場合は、PCA capture.log で以下のよう
な行がないかを確認します。
Sep 3 15:33:51 tealeaf-dev reassd[15921]: TL Queue system failed to
create (-10).
上記の行が capture.log 内にある場合は、リストされているコマンドを使用して、
以下の設定を確認します。コマンドの下に、予期される応答をリストしています。
v net.core.rmem_max:
sysctl -n net.core.rmem_max
50000000
v net.core.rmem_default:
sysctl -n net.core.rmem_default
50000000
10
Tealeaf トラブルシューティング・ガイド
v kernel.shmmax:
sysctl -n kernel.shmmax
209715200
画面上に表示されている数字が、予期される値に一致していない場合は、以下のリ
ストしているコマンドを使用して、その設定を再構成できます。
sysctl -w net.core.rmem_max=50000000
sysctl -w net.core.rmem_default=50000000
sysctl -w kernel.shmmax=209715200
touch /usr/local/ctccap/var/startup
chown ctccap:ctccap /usr/local/ctccap/var/startup
chmod 644 /usr/local/ctccap/var/startup
PCA を再始動すると、TL キューが初期化され、PCA Capture が開始されます。
「client_random missing」メッセージへの対処
capture.log にメッセージ「client_random missing」が表示されている場合、PCA
により SSL トラフィックが破壊されたことを示しています。
原因としては、多くの問題が考えられます。PCA が使用している SSL 鍵が重複し
ている可能性があります。
使用している鍵について詳しくは、「IBM Tealeaf Passive Capture Application マニ
ュアル」の『PCA Web コンソール -「SSL 鍵 (SSL Keys)」タブ』を参照してくだ
さい。
「IBM Tealeaf Passive Capture Application マニュアル」の『SSL 鍵』を参照してく
ださい。
PCA Capture ログに「Max SYN/WAIT limit reached」が含まれている
PCA は、未加工 TCP/IP データを処理した結果としてこのメッセージをログに記録
します。
TCP 接続を開始するには、以下のように、3 つのハンドシェーク・パケットが必要
です。
v ソース・ホストが同期パケット (SYN) を送信する
v 次に、宛先ホストが自身の同期パケット (SYN+ACK) で応答する
v ソース・ホストが確認応答パケット (ACK) を送信する
PCA は、上記の 3 つすべてのパケットを確認した場合にのみ、HTTP ヒット・デ
ータへの TCP 接続を再組み立てしようとします。PCA は、3 つすべてのハンドシ
ェークが確認されるまで TCP 接続のパケットをキャッシュに入れるための有限の
バッファーを保持しています。バッファーがいっぱいになる前に PCA が 3 つすべ
てを確認しなかった場合、当該パケットはバッファーからフラッシュされ、上記の
メッセージがログに記録されます。
3 つのハンドシェークが確認されない理由として、以下のことが考えられます。
v パケットがネットワーク上で失われた
v パケットが破損した
第 1 章データの保存と再作成
11
v パケットが、PCA にフィードされたデータ・ストリームで欠落している
v パケットの到着順序があまりにもバラバラであった
v 悪意のある SYN アタック
このメッセージがたびたび表示されている場合、TCP 接続キャッシュが十分に大き
くないことを意味している可能性があるため、キャッシュのサイズを大きくするこ
とができます。ただし、長い期間では、このメッセージはどの Tealeaf システムで
も表示される可能性があります。散発的な頻度でのみこのメッセージが発生する場
合は、キャッシュのサイズは適切に設定されており、問題は単純なネットワークの
「ノイズ」である可能性があります。
不完全な TCP 接続は、影響を及ぼすことなく、ネットワーク・スイッチの SPAN
モニター・セッションで導入された可能性があります。また、破損した接続があ
り、SPAN セッションがそれを送信されたとおりに渡している可能性もあります。
パッシブ・オブザーバーの観点から、これらのいずれが発生したのかを簡単に判別
する方法はありません。ただし、ブラウズに関する限り、訪問者は恐らく影響を受
けていません。接続が失われた (ACK パケットを受信しなかった) 場合、ブラウザ
ーは自動的に必要なデータを求める別の要求を Web サーバーに送信し、最悪の場
合でも何も起こりません。これは、HTTP 500 エラーの原因になりません。
このエラーの他の一般的な原因は、アクティブではない IP アドレスに対する要求
です。例えば、IP ポート 8080 を listen するように PCA が構成されていて、ポー
ト 8080 で 8 つの Web サーバーのそれぞれからページを取得しようとするキープ
アライブ・サービスがあるものとします。現在、6 つの Web サーバーのみがイン
ストールされている場合、残りの 2 つのサーバーが応答しないため、「SYN/WAIT
limit reached」メッセージが表示される可能性があります。
関連する問題をデバッグする際に、PCA の最大 SynWait 制限を大きくすることが
できます。多数の高トラフィック・スパイクがあるサイトでは、インストール/構成
時に、この制限を大きくする必要が生じることがあります。最大制限を大きくした
後に、キャプチャー・ログをモニターします。
v Syn/Wait バッファーがすぐにいっぱいになり、毎分、多数の接続がドロップされ
ている場合、恐らく、問題は SPAN ポート構成にあります。
v 1 時間に数個の Syn/Wait パケットが欠落しているだけの場合は、恐らく、正常
なネットワーク動作です。
PCA 上で有効期限が切れた SSL 証明書の置換
PCA 上の有効期限が切れた SSL 証明書を置換できます。
Web コンソールを暗号化するために SSL 証明書が PCA に追加されている場合、
その証明書は最終的に有効期限が切れます。有効期限が切れた場合、PCA に新規証
明書を追加する必要があります。
PCA に新規 SSL 証明書を追加するには、以下の手順を実行します。
1. http://support.tealeaf.com/ の『How to encrypt the PCA Console』の手順に従いま
す。
12
Tealeaf トラブルシューティング・ガイド
2. PortalStatus を Windows スケジュール済みタスクとして実行しているユーザーの
セキュリティー・コンテキストで、PortalStatus サーバー上に証明書ストアを追
加します。
証明書がアップグレードされていない場合、または証明書ストアに追加されてい
ない場合、PortalStatus レポート E メールに「Passive Capture サーバーに接続で
きません。サーバーがダウンしているか、証明書がインストールされていませ
ん。(Unable to connect to the Passive Capture server, server may be down or
certificate is not installed.)」というメッセージが含まれています。
PCA キャプチャー・ログ・エラー・メッセージ「reassd:SSL セッショ
ン・キャッシュ・エントリーが見つかりません...(reassd: Couldn't find
SSL session cache entry . . .)」
各 SSL セッションは固有であり、セッションが完全にネゴシエーションされた後
に、長期セッションで再使用するために、そのセッション・キーがキャッシュに入
れられます。「reassd:SSL セッション・キャッシュ・エントリーが見つかりません
(reassd: Couldn’t find SSL session cache entry)」メッセージは、以下の 2 つ
の場合に発生する可能性があります。
v (恐らく) SSL セッション・キャッシュ・テーブル・サイズが小さすぎます。デフ
ォルトは、10,000 です。PCA の統計ページに、使用されている項目の最大数が示
されます。それが構成済みの最大サイズに達していて、このメッセージを受け取
っている場合、恐らく、特定の期間に多くの SSL アクティビティーが発生した
ことが原因で、新規項目用にスペースを用意するために、まだ必要なセッショ
ン・キーがドロップされました。
– この問題を修正するには、PCA Web コンソール・インターフェースの「イン
ターフェース」ページの項目「キャッシュする最大 SSL セッション数 (Max
SSL sessions to cache)」で最大 SSL セッション制限を 20,000 に増やしてみま
す。「IBM Tealeaf Passive Capture Application マニュアル」の『Web コンソ
ールによる構成』を参照してください。
注: 制限を 20,000 に設定した後でも問題が解決しない場合は、恐らく、別の
問題が原因であり、調査する必要があります。セッション・キャッシュ制限を
継続的に最大 20,000 より大きくしないでください。
v (可能性は高くない) PCA 再始動が発生したことが原因で、SSL セッション項目
キャッシュ・テーブルがクリアされました。PCA ソフトウェアの再初期化後に、
進行中だった SSL トランザクションにより、「not found」メッセージが生成さ
れます。再始動が発生するのは、Web コンソール構成変更を保存した場合、また
は正常性/保守スクリプトが、PCA の正常性の評価に基づいて再始動命令を発行
した場合です。
PCA が reveal オブジェクトを作成できなかった
古い PCA ビルドによって生成された秘密鍵を新しいビルドで検証できないことに
あります。
第 1 章データの保存と再作成
13
ビルド 3324 以降にアップグレードした後に、PCA Capture ログに以下のようなエ
ラー・メッセージが見つかることがあります。 PCA を開始できない可能性があり
ます。
Oct 12 12:05:03 sh005 reassd[4763]: Couldn’t create reveal object: 1
基本的な解決方法としては、現在の PTL ファイルを該当するディレクトリーから削
除し、PCA を開始して問題の原因が PTL ファイルにあると突き止めてから、その
ファイルをソースから再生成します。
1. PCA サーバーにログインします。
2. 以下のディレクトリーにナビゲートします。
/usr/local/ctccap/etc/capturekeys
3. ディレクトリー内の .ptl ファイルを、PCA インストール済み環境の外部にあ
る場所に移動します。
4. ctc-conf.xml にリストされているキャプチャー・キーをすべてコメント化しま
す。
a. テキスト・エディターで /usr/local/ctccap/etc/ctc-conf.xml を開き、す
べての <CaptureKey> ノードとその子をコメント化します。これらのノード
は、CaptureKeys ノードの子であり、ファイル内で有効のままになっている
必要があります。
v ctc-conf.xml ファイルのセクションをコメント化するには、HTML スタ
イルのコメント (<!- ->) を使用します。
b. 変更前の例:
<CaptureKeys>
<CaptureKey>
<Label>mykey</Label>
<PrivateKeyFile>/usr/local/ctccap/etc/mykey.ptl
</PrivateKeyFile>
</CaptureKey>
</CaptureKeys>
c. 変更後の例:
<CaptureKeys>

</CaptureKeys>
5. PCA を再始動します。
tealeaf restart
6. PCA の再始動後に、Web コンソールを使用して、すべての PCA プロセスが機
能していること、およびデータが適切なターゲットに渡されていることを確認
します。
v 「IBM Tealeaf Passive Capture Application マニュアル」の『PCA Web コン
ソール -「サマリー」タブ』を参照してください。
v 「IBM Tealeaf Passive Capture Application マニュアル」の『PCA Web コン
ソール -「配信 (Delivery)」タブ』を参照してください。
7. PCA 操作が確認された場合、問題は、問題のある .ptl 鍵に特定されていま
す。
14
Tealeaf トラブルシューティング・ガイド
v PCA の開始がまだ失敗する場合は、問題は他の場所にある可能性がありま
す。問題を完全にトラブルシューティングできるまで、移動した .ptl ファ
イルを保持してください。 6 ページの『Passive Capture Application サーバー
(PCA サーバー) のトラブルシューティング』を参照してください。
8. PEM ファイルおよび PTL ファイルの再生成について詳しくは、「IBM Tealeaf
Passive Capture Application マニュアル」の『SSL 秘密鍵のエクスポート』を参
照してください。
9. PTL 鍵を再生成した後に、上記にリストしたディレクトリーにその鍵を保管し
ます。
v PTL 鍵を元のものと同じ名前で同じ場所に保存した場合は、ctc-conf.xml
ファイルの CaptureKey ノードのコメントを外します。
v 新しい場所/ファイル名を使用した場合は、.ptl ファイルは、PCA Web コン
ソールを使用して追加するか、自動的にロードされる capturekeys ディレク
トリーに配置することができます。
– コンソールを使用したロードについて詳しくは、「IBM Tealeaf Passive
Capture Application マニュアル」の『PCA Web コンソール -「SSL 鍵
(SSL Keys)」タブ』を参照してください。
10. PCA を再始動します。
11. PCA が SSL トラフィックを暗号化解除できた場合、古いビルドによって生成
され、ディレクトリーから移動した PTL ファイルを削除できます。
PCA のリブート後に ReqCancelled ページが大幅に増加する
リブート後に、ReqCancelled ページの数が大幅に増加することがあります。
注: 以下の解決方法は、2058 より前の TeaLeaf Passive Capture バージョンにのみ
適用されます。
Linux カーネルは、リブート後に 2 つのメモリー・パラメーターをデフォルト値に
リセットします。この動作を修正するには、以下のステップが必要です。
v 以下のように、実行中の値を変更します。
1. PCA に SSH で接続し、root にログイン (または su を実行) します。
2. 以下のコマンドを使用して、Tealeaf キャプチャー・ソフトウェアを停止しま
す。
service tealeaf-pca stop
3. 以下の 2 つのコマンドを発行します。
sysctl -w net.core.rmem max=50000000
sysctl -w net.core.rmem default=50000000
4. 以下のコマンドを使用して、Tealeaf キャプチャー・ソフトウェアを開始しま
す。
service tealeaf-pca start
v sysctl.conf ファイルを編集して、リブート後に正しい値がロードされるように
します。/etc/sysctl.conf を編集し、以下を追加します。
net.core.rmem max=50000000
net.core.rmem default=50000000
v リブート時に、Linux は、/etc/sysctl.conf の新規設定をロードします。
第 1 章データの保存と再作成
15
注: PCA Capture SW 2058 以降のバージョンでは、開始時にこれらの値が自動的に
検査されて構成されます。該当するバージョンのいずれかを実行している場合は、
ここに示している回避策を適用する必要はありません。
また、sysctl.conf ファイルの変更を今行い、後で 2058 以降にアップグレードす
ることもできます。アップグレード時に sysctl.conf ファイルの変更を削除する必
要はありません。
特定タイプのファイルをドロップするための PCA の構成
特定のタイプのファイルであるヒットをドロップするように PCA を構成できま
す。これは、.PDF などの大きなバイナリー・ファイル・タイプが Tealeaf によって
キャプチャーおよび処理されないようにする場合に役に立ちます。
以下のセクションのステップでは、特定の拡張子を持つ応答ファイルがキャプチャ
ーから削除される一方で、そのファイルが照会されている要求は、キャプチャー・
ストリーム内に入ったままになっています。
非標準ファイル拡張子をキャプチャーするための PCA の構成
非標準ファイル拡張子をキャプチャーするように PCA を構成できます。
非標準ファイル拡張子をキャプチャーするように PCA を構成するには、以下を実
行します。
1. PCA Web コンソールを開きます。
2. 「パイプライン」タブをクリックします。
3. 必要な拡張子を「包含されるファイル拡張子 (Included File Extensions)」リスト
に追加します。
a. 必要な拡張子を「包含されるファイル拡張子 (Included File Extensions)」テ
キスト・フィールドに入力します。
b. 「追加」をクリックします。
c. 「変更の保存」をクリックします。
非標準 MIME タイプをキャプチャーするための PCA の構成
非標準 MIME タイプをキャプチャーするように PCA を構成できます。
非標準 MIME タイプをキャプチャーするように PCA を構成するには、以下を実行
します。
1. PCA Web コンソールを開きます。
2. 「パイプライン」タブをクリックします。
3. 必要な拡張子を「以下の MIME タイプをすべてキャプチャー (Capture All
Mimetypes)」リストに追加します。
a. 必要な MIME タイプを「以下の MIME タイプをすべてキャプチャー
(Capture All Mimetypes)」テキスト・フィールドに入力します。
b. 「追加」をクリックします。
c. 「変更の保存」をクリックします。
16
Tealeaf トラブルシューティング・ガイド
特定の拡張子を持つヒットの応答をドロップするための PCA の構
成
特定の拡張子を持つヒットの応答をドロップするように PCA を構成できます。
特定の拡張子を持つヒットの応答をドロップするように PCA を構成するには、以
下を実行します。
1. PCA Web コンソールを開きます。
2. 「ルール」タブをクリックします。
3. 以下のように、応答ドロップ・アクションを作成します。
a. 「アクション」セクションで、「追加」をクリックします。
b. アクションの名前を入力します。
c. アクションを DropResponse に設定します。
d. 「変更の保存」をクリックします。
4. 以下のように、作成したアクションを使用するルールを作成します。
a. 「ルール 1 の挿入 (Insert Rule 1)」ボタンをクリックします。
b. ReqField を TL_URLEXT に設定します。
c. ReqOp を = に設定します。
d. ReqVal を必要な拡張子に設定します。
e. 応答ドロップ・アクションをルールに追加するために、アクションを選択
し、「追加」をクリックします。
f. 「変更の保存」をクリックします。
PCA ディスク・スペースを解放する
/usr パーティションがいっぱいになり、PCA ディスク・スペースの解放が必要に
なる場合があります。
デフォルトでは、IBM Tealeaf CX Passive Capture Application は、/usr パーティシ
ョンにインストールされます。さまざまなメッセージによって、パーティションが
いっぱいになっていることを示す内容を受け取ることがあります。
以下の手順を実行して、パーティションがいっぱいであることを確認し、ディス
ク・スペースを解放するための対策を実行します。
1. /usr がスペース不足になっていることを確認します。
使用可能なすべてのパーティションのディスク・スペースを確認するには、PCA
をホストしている Linux サーバーで以下のコマンドを実行します。
df -h
v /usr パーティションで使用可能なディスク・スペースを確認します。
2. サーバー上で、/usr/local/ctccap/bin-debug にナビゲートします。名前が
core で始まるファイルを検索します。これらのコア・ダンプ・ファイルは大き
くなる可能性があるため、問題解決のために、削除するか、別の場所に移動する
必要があります。
v すべてのコア・ダンプ・ファイルを検索するために、ctccap ディレクトリー
にナビゲートし、以下のコマンドを実行します。
第 1 章データの保存と再作成
17
find /usr/local/ctccap/ -name "core*" -print
v 可能であれば、これらのファイルを削除して、ディスク・スペースを解放しま
す。
フェイルオーバーのトラブルシューティング
PCA は、マスター IBM Tealeaf CX Passive Capture Application からスレーブ・マ
シンにフェイルオーバーするように構成できます。ネットワーク障害、システム・
フェイルオーバー、またはマスター・マシンでの他の中断が発生した場合、スレー
ブ・マシンがアクティブ・マシンになり、トラフィックのキャプチャーを開始しま
す。
v 「IBM Tealeaf Passive Capture Application マニュアル」の『PCA Web コンソー
ル -「フェイルオーバー (Failover)」タブ』を参照してください。
フェイルオーバーを構成し、問題が発生している場合は、このセクションでトラブ
ルシューティングのヒントおよびステップを見つけて、問題の解決に役立てること
ができます。
PCA フェイルオーバー・モードには、2 つの PCA (指定されたマスターおよびスレ
ーブ) が必要です。通常、PCA Web コンソールの「フェイルオーバー (Failover)」
タブでは、マスター/スレーブ PCA の IP/ポート・アドレスを定義できます。
注: ホスト名ではなく、それぞれの物理 IP アドレスを使用してください。
注: マスターとスレーブの両 PCA は、同じ PCA ビルドを実行している必要があり
ます。
どちらがマスターまたはスレーブかを適切に識別するために、PCA は、/etc/hosts
ファイルを調べて、ローカル・ホスト名に基づいて IP アドレスを見つけます。そ
の後、割り当て用のフェイルオーバー・マスター/スレーブ IP 項目に対してその IP
アドレスを突き合わせます。
Linux コマンドの hostname を実行することでリストされたホスト名は、対応する
IP アドレスとともに /etc/hosts ファイル内に存在している必要があります。例え
ば、hostname の実行で pca01machine が返された場合、以下のような項目が hosts
ファイル内に存在している必要があります。
10.10.100.1
pca01machine
注: 求められる hosts ファイル項目は、ファイル内の最初の項目でなければなりま
せん。
hosts ファイルで一致が見つからなかった場合、フェイルオーバー・モードの開始に
失敗します。capture.log ファイルに以下のエラー・メッセージが表示されます。
Both MasterAddress and SlaveAddress must be specified in configuration file.
フェイルオーバーの開始、停止、および再始動の正しい順序
マスター/スレーブ・フェイルオーバー PCA に対する正しい順序があります。
マスター/スレーブ・フェイルオーバー PCA の正しい開始順序は、以下のとおりで
す。
18
Tealeaf トラブルシューティング・ガイド
v 最初にマスター PCA を開始します。
v マスター PCA が正常に開始された後に、スレーブ PCA を開始します。
注: 正しいフェイルオーバー操作で問題が発生している場合、常にコマンド・ラ
インを使用して手動で停止および開始する必要があります。
注: サービスが複数回有効または無効にされた場合、PCA はフェイルオーバー・ア
クティブ状態を正しく示さないことがあります。これは、すべての PCA ビルドに
影響する既知の問題です。
Web コンソールを通じたフェイルオーバーの再開
フェイルオーバー・サービスは、CX PCA Web コンソールの「フェイルオーバー
(Failover)」タブを使用して開始および停止できます。
CX PCA Web コンソールの「フェイルオーバー (Failover)」タブでフェイルオーバ
ー・サービスを開始および停止するには、以下を実行します。
1. スレーブ CX PCA サーバーで CX PCA Web コンソールを開きます。詳しく
は、「IBM Tealeaf Passive Capture Application マニュアル」の『PCA Web コン
ソールのオープン』を参照してください。
2. 「フェイルオーバー (Failover)」タブをクリックします。
3. 「フェイルオーバーの再開 (Restart failover)」をクリックします。
4. 「変更の保存」をクリックして変更を適用します。
5. マスター CX PCA サーバーでこの手順を繰り返します。
フェイルオーバー・ステータスがリセットされると、CX PCA Web コンソールに新
しいフェイルオーバー・ステータスが表示されます。例えば、マスター CX PCA
がステータスを「フェイルオーバーはアクティブです (マスター) (Failover is
active (master))」と報告し、スレーブ CX PCA がステータスを「フェイルオー
バーはアクティブです (スレーブ) (Failover is active (slave))」と報告しま
す。
フェイルオーバー・サービスのコマンド・ラインからの停止および開
始
古いバージョンの PCA Web コンソールは、フェイルオーバーに対する変更を正し
く受け入れません。疑わしいときは、コマンド・ラインからフェイルオーバー・サ
ービスを手動で停止および開始する必要があります。
フェイルオーバー・サービスをコマンド・ラインから停止および開始するには、以
下を実行します。
1. フェイルオーバーしたサービスを停止します。
tealeaf stop failoverd
2. 以下のコマンドを実行して、フェイルオーバーしたサービスが停止されていて削
除されていることを確認します。
tealeaf ps
3. 詳しくは capture.log メッセージを調べてください。
4. 必要に応じて変更を行います。
5. フェイルオーバーしたサービスを開始するには、以下のようにします。
第 1 章データの保存と再作成
19
tealeaf start failoverd
フェイルオーバー状態の判別
PCA は、さまざまな状態のマスター・フェイルオーバー・サーバーとスレーブ・フ
ェイルオーバー・サーバーの統計を公開します。
統計をレビューしてフェイルオーバー状態を確認し、フェイルオーバーの問題の原
因を判別できます。
マスター PCA 統計
各種フェイルオーバー状態のマスター・フェイルオーバー・サーバーについて PCA
によって公開される統計を確認できます。
これらの統計は、「統計」タブのフェイルオーバー・セクションで公開されます。
「ノードの状態 (Node state)」統計が「アクティブ」に設定されている場合、サー
バーはヒットを他の Tealeaf サーバーに配信しています。
「IBM Tealeaf Passive Capture Application マニュアル」の『PCA Web コンソール
-「統計」タブ』を参照してください。
ノードの状態がアクティブであり、ヒットを配信していることを意味します。この
場合、以下のようになります。
値
統計
マスター
ノードの役割
アクティブ
ノードの状態
実行中
キャプチャー状態
はい
フェイルオーバー・アクティブ (Failover active)
マスターがスレーブに強制的にフェイルオーバーされました。マスターは停止され
ました。この場合、以下のようになります。
値
統計
マスター
ノードの役割
消極的
ノードの状態
停止済み
キャプチャー状態
はい
フェイルオーバー・アクティブ (Failover active)
「IBM Tealeaf Passive Capture Application マニュアル」の『PCA Web コンソール
-「統計」タブ』を参照してください。
マスター PCA フェイルオーバー・ログ・メッセージ
以下で、ファイルオーバー・マスター PCA サーバーの各種フェイルオーバー状態
に関するログ・メッセージを確認できます。
v これらのログ・メッセージは、capture.log に表示されます。
20
Tealeaf トラブルシューティング・ガイド
v peer と記載されている capture.log メッセージはすべて、ローカルの PCA で
はなく、他の PCA について述べています。
フェイルオーバーが使用不可になります。
TLAPI: Failover is disabled. Delivery is always enabled.
フェイルオーバー・マスターがアクティブ配信状態の場合、以下のようになりま
す。
TLAPI: Failover is enabled. Delivery is currently enabled.
フェイルオーバー・サービスが PCA スレーブ・マシンにフォールオーバーした場
合、以下のようになります。
failoverd:
failoverd:
failoverd:
failoverd:
Peer node is down (connection refused).
Peer node is alive.
Capture has stopped. Initiating failover to peer.
Delivery stopped.
フェイルオーバーが PCAマスター・マシンにフェイルバックした場合、以下のよう
になります。
failoverd: Requesting failback from peer.
failoverd: Delivery started.
スレーブ PCA の統計
各種フェイルオーバー状態のスレーブ・フェイルオーバー・サーバーについて PCA
によって公開される統計を確認できます。これらの統計は、「統計」タブのフェイ
ルオーバー・セクションで公開されます。
「ノードの状態 (Node state)」統計が「アクティブ」に設定されている場合、サー
バーはヒットを他の Tealeaf サーバーに配信しています。
「IBM Tealeaf Passive Capture Application マニュアル」の『PCA Web コンソール
-「統計」タブ』を参照してください。
マスターがアクティブ・ノード状態で実行中です。スレーブはパッシブ状態 (非配
信) です。この場合、以下のようになります。
値
統計
スレーブ (slave)
ノードの役割
消極的
ノードの状態
実行中
キャプチャー状態
はい
フェイルオーバー・アクティブ (Failover active)
スレーブ PCA は実行中で、マスター PCA は停止されているか存在しません (スレ
ーブ PCA にフェイルオーバーしました)。この場合、以下のようになります。
値
統計
スレーブ (slave)
ノードの役割
消極的
ノードの状態
実行中
キャプチャー状態
第 1 章データの保存と再作成
21
値
統計
はい
フェイルオーバー・アクティブ (Failover active)
スレーブがマスターにフェイルバックしたときに、ノード状態は再びパッシブに戻
ります。
「IBM Tealeaf Passive Capture Application マニュアル」の『PCA Web コンソール
-「統計」タブ』を参照してください。
スレーブ PCA フェイルオーバー・ログ・メッセージ
以下で、ファイルオーバー・マスター PCA サーバーの各種フェイルオーバー状態
に関するログ・メッセージを確認できます。
v これらのログ・メッセージは、capture.log に表示されます。
v peer と記載されている capture.log メッセージはすべて、ローカルの PCA で
はなく、他の PCA について述べています。
フェイルオーバーが使用不可になります。
TLAPI: Failover is disabled. Delivery is always enabled.
フェイルオーバー・スレーブがパッシブ・ノード状態の場合、以下のようになりま
す。
TLAPI: Failover is enabled. Delivery is currently disabled.
フェイルオーバー・スレーブが制御を取った場合、以下のようになります。
failoverd: Received TakeControl request from peer. Taking control.
failoverd: Delivery started.
スレーブがマスター・サーバーにフェイルバックした場合、以下のようになりま
す。
failoverd: Received ReleaseControl request from peer. Releasing control.
failoverd: Delivery stopped.
ulimit コア・ファイル・サイズ・エラーへの対処
Web コンソールの再始動時に、ulimit コア・ファイル・サイズ制限のエラーが発生
する場合があります。
PCA Web コンソールの開始または再始動時に、PCA ログ・ファイルに以下のエラ
ーが表示されることがあります。
tealeaf/bin/tealeaf: line 323: ulimit: core file size: cannit modify limit:
operation not permitted.
ulimit コマンドは、Linux システム・ユーティリティーです。ほとんどの場合、この
ユーティリティーは、PCA Tealeaf スクリプトの初回実行時に、root ユーザーによ
って実行されます。その後、PCA ユーザー (デフォルトでは、ctccap ユーザー) を
使用して PCA が再始動されます。
非 root ユーザーを使用して PCA が開始されると、(特に無制限のコア・ファイ
ル・サイズを可能にするために) ulimit を使用してデフォルトのシステム・レベル設
22
Tealeaf トラブルシューティング・ガイド
定が定義されます。PCA の異常終了の発生時に、PCA はこのユーティリティーを
使用して、アクティビティーをトラブルシューティングするためにコア・ファイル
を提供します。セキュリティー、インストール済みの Linux OS で使用されている
システム・ポリシー、およびプラットフォームとバージョンの依存関係に応じて、
非 root ユーザーの PCA の観点からは、ulimit が期待どおりに機能しないことがあ
ります。
以下により、非 root ユーザーとして実行されているときのデフォルト設定を確認で
きます。
su ctccap
ulimit -c
確認する必要がある行は、以下のものです。
core file size (blocks, -c) unlimited
一部の Linux 環境では、ulimit ユーティリティーの動作が、始動時に使用される
PCA Tealeaf スクリプトが期待するものから変更されており、コア・ファイル・サ
イズを無制限のサイズに設定する機能がブロックされます。
この問題を修正するには、以下のステップを実行します。
1. 以下の構成ファイルを編集します。このファイルは、特定のユーザーのデフォル
ト ulimit コア制限 (-c オプション) を設定するために使用されます。
注: ファイルの変更を実行するために、PCA ユーザーを使用する必要がありま
す。デフォルトでは、このユーザーは ctccap です。
/etc/security/limits.conf
2. ハード制限とソフト制限の両方に対してユーザーのコア設定を無制限に設定する
ために、以下の 2 行を追加します。
ctccap hard core unlimited
ctccap soft core unlimited
ここで、
v ctccap は PCA ユーザーに対応します。
3. すべてのユーザー (*) に対するコア設定を指定している行がファイル内にないこ
とを確認します。
4. ファイルを保存します。
5. PCA を再始動します。
6. ログ・ファイルを確認して、問題が解決されたことを確認します。
ネットワーク・インターフェース・カードの追加後に PCA の開始が失敗す
る場合の対応方法
ネットワーク・インターフェース・カード (NIC) を追加した後に、PCA の開始に
失敗する場合があります。
これが発生した場合、以下のようなメッセージが表示されている場合があります。
Apr 13 10:27:09 tealeaf2 deliverd[5757]: Ending main loop with 0.
Apr 13 10:27:09 tealeaf2 deliverd[5757]: main(), Exiting with 0
Apr 13 10:27:09 tealeaf2 captured[5740]: Restarting too rapidly (0 seconds).
第 1 章データの保存と再作成
23
Shutting down.
Apr 13 10:28:23 tealeaf2 tealeaf: info: Starting:
/usr/local/ctccap/bin-debug/failoverd -q
Apr 13 10:28:23 tealeaf2 tealeaf: pem2ptl: error: Please specify the name
of one or more PEM files to encrypt.
Apr 13 10:28:23 tealeaf2 tealeaf: info: Starting:
/usr/local/ctccap/bin-debug/captured -P
Apr 13 10:28:23 tealeaf2 captured[6173]: Captured starting:
revision 1277489920
Apr 13 10:28:23 tealeaf2 reassd[6182]: OpenSSL hw engine(0): None
Apr 13 10:28:23 tealeaf2 reassd[6182]: Couldn’t create reveal object: 1
Apr 13 10:28:23 tealeaf2 reassd[6182]: Exiting
Apr 13 10:28:23 tealeaf2 captured[6174]: Caught signal (17). Restarting.
Apr 13 10:28:23 tealeaf2 reassd[6176]: OpenSSL hw engine(0): None
Apr 13 10:28:23 tealeaf2 deliverd[6184]: Ending main loop with 0.
Apr 13 10:28:23 tealeaf2 deliverd[6184]: main(), Exiting with 0
Apr 13 10:28:23 tealeaf2 reassd[6178]: OpenSSL hw engine(0): None
Apr 13 10:28:23 tealeaf2 reassd[6176]: Couldn’t create reveal object: 1
Apr 13 10:28:23 tealeaf2 reassd[6176]: Exiting
Apr 13 10:28:23 tealeaf2 reassd[6178]: Couldn’t create reveal object: 1
Apr 13 10:28:23 tealeaf2 reassd[6178]: Exiting
Apr 13 10:28:24 tealeaf2 captured[6174]: Restarting too rapidly (0 seconds).
Shutting down.
Apr 13 10:34:32 tealeaf2 tealeaf: info: Stopped httpd(5760).
Apr 13 10:34:32 tealeaf2 tealeaf: info: captured is not running.
Apr 13 10:34:32 tealeaf2 tealeaf: info:
Starting: /usr/local/ctccap/bin-debug/failoverd -q
Apr 13 10:34:32 tealeaf2 tealeaf: pem2ptl: error: Please specify the name
of one or more PEM files to encrypt.
Apr 13 10:34:32 tealeaf2 tealeaf: info: Starting:
/usr/local/ctccap/bin-debug/captured -P
Apr 13 10:34:32 tealeaf2 captured[9446]: Captured starting:
revision 1277489920
Apr 13 10:34:32 tealeaf2 tealeaf: info: Starting: /usr/local/ctccap/bin/httpd
Apr 13 10:34:32 tealeaf2 reassd[9449]: OpenSSL hw engine(0): None
Apr 13 10:34:32 tealeaf2 reassd[9449]: Couldn’t create reveal object: 1
Apr 13 10:34:32 tealeaf2 reassd[9449]: Exiting
Apr 13 10:34:32 tealeaf2 captured[9447]: Caught signal (17). Restarting.
Apr 13 10:34:32 tealeaf2 deliverd[9458]: Ending main loop with 0.
Apr 13 10:34:32 tealeaf2 deliverd[9458]: main(), Exiting with 0
Apr 13 10:34:32 tealeaf2 captured[9447]: Restarting too rapidly (0 seconds).
Shutting down.
この問題の原因は、PCA にインストールされている PTL 鍵である可能性がありま
す。場合によっては、これらの鍵は、NIC カードのアドレスの側面を使用して暗号
化されていることがあります。
解決方法としては、PEM 平文バージョンから PTL 鍵を再作成します。PCA はこの
再作成を自動的に実行できます。
v 「IBM Tealeaf Passive Capture Application マニュアル」の『暗号鍵のセットアッ
プ』を参照してください。
エラー System.Web.HttpRequestValidationException
Error System.Web.HttpRequestValidationException メッセージが表示される場合
があります。
Symptom:
ErrorSystem.Web.HttpRequestValidationException: A potentially dangerous
Request.Cookies value was detected from the client (ErrorId=
Resolution:
24
Tealeaf トラブルシューティング・ガイド
IIS Manager で、TeaLeaf IIS キャプチャー・フィルターが、特定の Web サイトで
はなくグローバル Web サイト・レベルでインストールされていることを確認しま
す。
PSIO_SIGCAUGHT エラーの原因の調査
PSIO_SIGCAUGHT エラーが表示された場合は常に、本当の原因について、キャプチャ
ー・ログ・ファイル内の前の部分を調べる必要があります。
この PSIO_SIGCAUGHT エラーは、pipelined が delivered と通信しようとしたが、そ
の通信がシグナルによって中断したことによるものです。
ほとんどの場合、このシグナルは、captured が pipelined にシャットダウンするよう
に指示したことによるものです。captured は、以下のようなさまざまな理由で
pipelined にシャットダウンするように指示します。
v captured の別の子プロセスが異常終了したか終了した。
v captured がシャットダウンする。
v Web コンソールの構成変更により、captured がその子プロセスを再始動するよう
に指示された。
capture.log からの以下のサンプル・スニペットでは、ヒット処理用の共有メモリ
ー・キュー (TLQueue) の作成に失敗したことを示す reassd からのメッセージを確
認できます。
Jul 24 17:08:10 abc reassd: TL Queue system failed to create (28).
Jul 24 17:08:10 abc reassd: Exiting
Jul 24 17:08:10 abc captured: Caught signal (17). Restarting.
Jul 24 17:08:11 abc pipelined: Evaluation of tltHeartbeatCallback returned
ERROR(1): tltSocketWrite: Failed to write socket command(3): PSIO_SIGCAUGHT
ビルド 3101 では、この誤解を招くメッセージの公開を最小限に抑えるために、
PSIO_SIGCAUGHT メッセージが変更されました。
crond(pam_unix)session closed for user root メッセージの大量発生への
対処
メッセージ・ディレクトリーが crond(pam_unix) session closed for user root
メッセージでいっぱいになる場合があります。
例えば、/var/log/messages ディレクトリーが以下のようなメッセージでいっぱい
になることがあります。
crond(pam_unix) ... session closed for user root
Red Hat Enterprise Linux 4 を実行している IBM Tealeaf CX Passive Capture
Application サーバーで、/var/log/messages 内に以下のタイプのメッセージがよく見
られます。
# fgrep crond /var/log/messages | tail -5
Sep 6 16:23:02 ganymede crond(pam_unix)[23922]: session closed for user root
Sep 6 16:24:01 ganymede crond(pam_unix)[23971]: session opened for user root
by (uid=0)
Sep 6 16:24:03 ganymede crond(pam_unix)[23971]: session closed for user root
第 1 章データの保存と再作成
25
Sep 6 16:25:01 ganymede crond(pam_unix)[24020]: session opened for user root
by (uid=0)
Sep 6 16:25:02 ganymede crond(pam_unix)[24020]: session closed for user root
マシン ganymede について、すべてのメッセージが、これらの crond(pam_unix) メ
ッセージです。以下のような、これらのメッセージの行数のカウントを検討しま
す。
# fgrep crond /var/log/messages | wc -l
13233
# wc -l /var/log/messages
13241 /var/log/messages
pam_unix テキストが含まれているので、このメッセージがマシンの PAM 構成から
のものであることが示唆されます。 /etc/pam.d を見ると、内容に「The PAM
configuration file for the cron daemon.」と記述された crond ファイルが示されま
す。
以下のように、この構成ファイルが何らかの RPM パッケージによって所有されて
いるかどうかを確認します。
# rpm -qf /etc/pam.d/crond
vixie-cron-4.1-36.EL4
# rpm -ql vixie-cron | fgrep pam
/etc/pam.d/crond
この同じ /etc/pam.d/crond ファイルは、RHEL 3 Update 5 マシンでは存在しませ
ん。
# rpm -q vixie-cron
vixie-cron-3.0.1-76_EL3
# rpm -ql vixie-cron | fgrep pam
#
恐らく、より新しい vixie-cron パッケージで導入された変更が原因で、これらの
crond(pam_unix) メッセージが RHEL 4 で出現するようになったようです。
以下のように、RHEL 4 での crond のマニュアル・ページでも、この関係が記述さ
れています (「man crond」より)。
PAM Access Control
On Red Hat systems, crond now supports access control with PAM - see
pam(8).
A PAM configuration file for crond is
installed in
/etc/pam.d/crond. crond loads the PAM environment from the pam_env
module, but these can be overriden by settings in the crontab file.
インターネットで crond(pam_unix) messages /etc/pam.d/crond と検索すると、
vixie-cron の PAM 構成が /var/log/messages でのメッセージをトリガーしている
この状態に多くのユーザーが直面していることが分かります。以下の 2 つの解決方
法があります。
crond メッセージ・ロギングの抑止
セッション・スタックに pam_unix を入れる唯一の目的は、このレベルのロギング
を提供することです。
このロギングを抑止するには、システム認証セッション・スタックで開始される
pam モジュールは、pam_unix と pam_limits のみであるため、/etc/pam.d/crond
26
Tealeaf トラブルシューティング・ガイド
でシステム認証セッション・スタッキングを開始する行をコメント化し、セッショ
ン pam_limits 行のコメントを外します。
RedHat ES4 システムでは、/etc/pam.d/crond ファイル内の記述は、以下のように
する必要があります。
#
# The PAM configuration file for the cron daemon
#
#
auth
sufficient pam_rootok.so
auth
required
pam_stack.so service=system-auth
auth
required
pam_env.so
account
required
pam_stack.so service=system-auth
account
required
pam_access.so
#session
required
pam_stack.so service=system-auth
session
required
pam_loginuid.so
# To enable PAM user limits for cron jobs,
# configure /etc/security/limits.conf and
# uncomment this line:
session required
pam_limits.so
#
Restart crond daemon:
service crond restart
異なるログ・ファイルへの cron メッセージのリダイレクト
cron の大量発生に対するもう 1 つの解決方法は、メッセージを異なるログ・ファ
イルへリダイレクトすることです。
異なるログ・ファイルへ cron メッセージをリダイレクトするには、以下を実行し
ます。
1. 以下のように /etc/syslog.conf を編集します。
# Log anything (except mail) of level info or higher.
# Don’t log private authentication messages.
*.info;mail.none;local5.none;authpriv.none;cron.none;auth.!=info
/var/log/messages
注: 構成行で、上記のように auth.!=info が追加されています。
2. 別のファイルに cron 認証メッセージのログを記録します。以下の行を追加しま
す。
auth.info
/var/log/cron.auth
3. service syslog restart の後に、cron によって引き起こされた syslog メッセ
ージが /var/log/cron.auth にのみ表示されます。
「Invalid Deflate Data」エラー・メッセージへの対処
Siebel アプリケーション用の IIS 6 キャプチャー・フィルターで正しくキャプチャ
ーされない場合があります。
IBM Tealeaf CX RealiTea Viewer によって表示されるエラーは、「Invalid Deflate
Data」です。
第 1 章データの保存と再作成
27
Siebel ISAPI フィルターが圧縮を実行しています。IIS キャプチャー・フィルターが
この圧縮を処理するようにするには、Tealeaf IIS キャプチャー・フィルターがイン
ストールされているすべての Siebel Web サーバー上の TeaLeafIIS6.cfg ファイル
の [Globals] セクションに以下の 2 行を追加します。
IgnoreChunked=False
IgnoreGZip=False
この変更を行った後に、当該 Web サーバーで IIS を再始動する必要があります。
PCA の問題が解決しない場合にお客様サポートに提供する情報
IBM Tealeaf CX Passive Capture Application またはそのホスト・サーバーでの問題
が解決しない場合、Tealeaf カスタマー・サポートに問い合わせる前に、以下の情報
を見つけて確認する必要があります。
v 実行されている PCA のバージョンは何ですか?
v listen 対象はどのような NIC ですか?
v 問題が新規インストールまたはアップグレードの一部として発生しましたか? こ
れがアップグレード時に発生した場合、同じ問題がアップグレード前にも発生し
ましたか?
v tcpdump を実行します。メモリー・ダンプで何かでフィルターに掛けましたか、
それとも、NIC を listen しただけですか?
v Tealeaf PCA への root 権限または root 権限を備えたユーザーを提供します。
追加 tcpdump コマンド
PCA 処理に関する追加情報を収集するために使用できるいくつかの tcpdump コマ
ンドがあります。
拡張 tcpdump の詳細
tcpdump の拡張詳細を取得するには、PCA サーバーで man tcpdump を実行する
か、http://www.tcpdump.org/ Web サイトから取得します。簡易形式は、以下のとお
りです。
tcpdump -ni NIC -s0 -w dumpfile filter_string
ここで、
v NIC は、スニファー/キャプチャー NIC のデバイス名です。 NIC デバイス名の
リストを表示するには、ifconfig コマンドを使用するか、PCA の Web UI の
「インターフェース (Interface)」ページ (デフォルトでは、http://<PCA>:8080/
interface.php または https://<PCA>:8443/interface) を使用します。<PCA>
は、PCA のホスト名または IP アドレスです。
v dumpfile は、ダンプが書き込まれるファイルの名前です。
v filter_string は、キャプチャーする IP/ポートの式です。
検証テストを実行する場合は、-w オプションおよびその引数を削除します。その場
合、出力はコンソールに表示されます。
28
Tealeaf トラブルシューティング・ガイド
キャプチャー・スニファー・ポートでのトラフィックのテスト
tcpdump を使用して、キャプチャー・スニファー・ポートがトラフィックを受信し
ているかどうかを判別するには、以下のようにします。
tcpdump -ni eth1 | more
特定のトラフィックを検索するには、以下のようにします。
tcpdump -ni bge0 host <IP address> and port <IP port number> | more
ここで、例えば、<IP アドレス> と <IP ポート番号> をそれぞれ 10.10.10.2 と 80
にします。
ファイルへの tcpdump の手動キャプチャー
tcpdump を使用して HTTP(S) トラフィックをダンプ・ファイルにキャプチャーする
手動方式は、以下のとおりです。
tcpdump -ni bge0 -s0 -w dumpfile host ipAddr and port ¥(80 or 443¥)
tcpdump -ni bge0 -s0 -w dumpfile host ipAddr and port ’(’80 or 443’)’
tcpdump -ni bge0 -s0 -w dumpfile net xxx.xxx.xxx.0/24 and port 80
既存の tcpdump ファイルを使用して、特定のトラフィックを別のダンプ・ファイル
に抽出するには、以下のようにします。
tcpdump -nr <dumpfile> -s0 -w <new_file_name> host <ip address> and ¥
port <port number>
tcpdump の追加ヘッダーの表示
フィルターなしで tcpdump を実行してトラフィックが表示されているのにもかかわ
らず、tcpdump がトラフィックをフィルターに掛けることができない場合、その問
題の原因は、追加された追加の Ethernet ヘッダー (通常は VLAN ヘッダーの
802.1Q VLAN) である可能性があります。tcpdump -e オプションを使用して、この
追加ヘッダーの情報を表示します。これは、以下のようなものです。
. . . ethertype 802.1Q, length 64: vlan 128, p 0, ethertype IPv4,
IP 192.168.128.42.8001 > 192.168.128.90.20700:
ポートのフィルタリング
tcpdump を使用したフィルター試行が失敗します。例えば、以下のように、既知の
ポート番号でフィルターに掛ける場合です。
tcpdump -ni eth2 port 8001
tcpdump がフィルターに掛けられた出力を提供できない場合、Passive Capture ソフ
トウェアもフィルターに掛けることができません。
VLAN タイプのトラフィックである場合は、以下のように、フィルター式の一部と
して vlan 式演算子を使用します。
tcpdump -ni eth2 vlan and port 8001
VLAN パケットを使用したフィルターの他の例を以下に示します。
tcpdump -nr tst.dmp ’ether[12:2] = 0x8100’
tcpdump -nr tst.dmp vlan and ip and port 8001
第 1 章データの保存と再作成
29
両方のタイプのトラフィックを表示するには、以下のようにします。
tcpdump -nr tst.dmp ip or vlan
特定の IP アドレスのみのクライアント・サイド・トラフィックの表
示
以下のコマンドでは、クライアント・サイドからのトラフィックのみが表示されま
す。このトラフィックは、ブラウザーから Web サーバーに対して、指定した IP ア
ドレスから行われた要求です。
tcpdump -nieth1 src host ipAddr and port #nmbr
すべてのクライアント・サイド・トラフィックの表示
以下のコマンドでは、指定したポート番号で接続を試行しているすべてのクライア
ント・サイド・トラフィックが表示されます。指定したポートでのすべてのクライ
アントからの要求がすべてレポートされます。
tcpdump -nieth1 dst port #nmbr
SYN パケットおよび FIN パケットのみの表示
以下のコマンドでは、tst.dmp ファイル内の SYN パケットおよび FIN パケットの
みが表示されます。このコマンドを使用して、両方向のトラフィックの有無に加
え、PCA で TCP 接続の開始と停止が正常に行われているかも確認できます。
各接続に期待される有効な出力では、接続の開始時に各方向の SYN パケットがあ
り、接続の終了時に各方向の FIN パケットがあります。
tcpdump -nr tst.dmp ’tcp[tcpflags] & (tcp-syn|tcp-fin) != 0’
tcpdump を使用したトラフィックが双方向でないかの判別
以下のような tcpdump コマンドを実行します。
tcpdump -ni <NIC> -s0 host 192.168.149.201 and port 443
ここで、
v -s0 - 大きなパケットを切り捨てません。このオプションを指定しなかった場
合、単一方向トラフィックが記録されません。
v <NIC> - PCA のいずれかのキャプチャー NIC のデバイス名。
このコマンドにより、以下のような出力が生成されます。
16:10:37.271214 IP 12.130.155.248.4863 > 192.168.149.201.https:
S 4007169894:4007169894(0) win 64512 <mss 1460,nop,nop,sackOK>
各行に以下のパケットを表す列があります。
v タイム・スタンプ
v ネットワーク・プロトコル
v ソース IP アドレス.IP ポート
v 宛先 IP アドレス.IP ポート
v TCPフラグ
v パケットに関する、選択した情報
30
Tealeaf トラブルシューティング・ガイド
上記の例は、クライアントからサーバーへの初期 SYN ハンドシェークを示してい
る TCP/IP 接続ハンドシェーク・パケットです。
サーバーからクライアントへの SYN ハンドシェーク・パケットを示す、2 つの IP.
ポート列が逆になっている 2 番目のパケットがなければなりません。2 番目のパケ
ットがない場合は、SPAN ポートが、PCA のキャプチャー NICへの双方向トラフィ
ックを提供していません。
追加トピック
IBM® Tealeaf CX Passive Capture Application トピックについて詳しくは、「IBM
Tealeaf Passive Capture Application マニュアル」の『付録 - 追加の Passive Capture
トピック』を参照してください。
ライセンス・キーの検索および更新
ライセンス・キーにより、Tealeaf ポータルから使用可能な機能が決定されます。
新規インストールおよびアップグレードの場合、Tealeaf はライセンス・キーを提供
します。インストールまたはアップグレード・プロセス時に、このライセンス・キ
ーを入力する必要があります。
1. Tealeaf カスタマー・サポートにサブミットするためにライセンス・キーを取得
し、それを変更する必要がない場合は、「ポータル」メニューで「ヘルプ」 >
「IBM Tealeaf CX Portal について」を選択します。
2. ライセンス・キーの隣にある値をコピーします。詳しくは、Tealeaf
http://suppor.tealeaf.com を参照してください。
TMS を使用してライセンス・キーを適用する方法について詳しくは、「IBM
Tealeaf cxImpact 管理マニュアル」の『Tealeaf ライセンス・キーの管理』を参照し
てください。
Windows レジストリーでのライセンス・キーの適用
ポータルおよび TMS が使用可能でない場合、Windows レジストリーで Tealeaf 製
品ライセンス・キーを適用できます。
Windows レジストリーでライセンス・キーを適用する方法について詳しくは、
「IBM Tealeaf cxImpact 管理マニュアル」の『Tealeaf ライセンス・キーの管理』を
参照してください。
IIS 権限のデフォルトへのリセット
ポータル・アプリケーションまたはポータル API で使用する IIS 権限が変更され
ていると思われる場合は、TLIISUtility を再実行して権限をリセットできます。
Tealeaf のインストールまたはアップグレード時に、IIS に必要な権限は自動的に構
成されます。企業の理由で権限を変更した場合は、ポータル機能が損なわれる可能
性があります。動作はさまざまです。
TLIISUtility を実行するには、以下のようにします。
第 1 章データの保存と再作成
31
注: このユーティリティーを再実行すると、必要なフォルダーの権限が上記の設定
に変更されます。それ以外に、再実行はポータルに影響しません。
1. ポータル・サーバーでコマンド・ラインを開きます。
2. 以下のディレクトリーにナビゲートします。
<Tealeaf_install_directory>¥Tools¥Install
3. TLIISUtility.exe を起動します。
4. 以下の要件に従って、権限を構成します。
a. IIS6 に必要な権限:
v http://support.microsoft.com/kb/812614/
b. IIS7 に必要な権限:
v http://support.microsoft.com/kb/981949/
5. IIS を再始動します。
グラフの開始日付に 1970 年の日付が表示される理由
グラフの開始日付に 1970 年の日付が表示される場合があります。
恐らく、キャプチャーされて処理されたヒットのタイム・スタンプのいずれかに 0
が含まれていました。0 のタイム・スタンプは、1/1/1970 に該当します。このヒッ
トがイベントをトリガーした場合、イベントのタイム・スタンプも 1/1/1970 になり
ます。
NT 認証済みユーザーがポータルにログインできない
場合によっては、NT 資格情報を使用してポータルにアクセスしようとしている
Tealeaf ユーザーがログインできないことがあります。
注: この問題は、Safari ブラウザー 5.1 でのみ観察されました。Safari は、Tealeaf
ではサポートされません。サポートされるブラウザーについて詳しくは、「IBM
Tealeaf cxImpact ユーザー・マニュアル」の『Tealeaf ポータルへのログイン』を参
照してください。
Safari ブラウザー (および、場合によっては他のブラウザー) で、ネゴシエーション
(Kerberos) 認証プロバイダーでの問題が発生することがあります。
回避策としては、IIS で提供されている NT 認証プロバイダー・リストからネゴシ
エーション認証プロバイダーを削除します。以下のステップを完了すると、IIS はネ
ゴシエーション認証プロバイダーを使用しなくなり、代わりに IIS リスト上の次の
ものを使用するようになります。
注: 以下のステップは、IIS7 にのみ適用されます。IIS6 のステップは、異なる場合
があります。IIS6 で提供されている資料を参照してください。
1. プロバイダー・リストからネゴシエーションを削除するために、管理者としてポ
ータル・サーバーにログインします。
2. コマンド・シェルで以下のコマンドを実行します。
%systemroot%¥system32¥inetsrv¥appcmd set
config /section:windowsAuthentication /-providers.[value=’Negotiate’]
32
Tealeaf トラブルシューティング・ガイド
3. このコマンドを初めて実行した場合、出力は以下のようなものになります。
Applied configuration changes to section"
"system.webServer/security/authentication/windowsAuthentication" for
"MACHINE/WEBROOT/APPHOST" at configuration commitpath
"MACHINE/WEBROOT/APPHOST"
4. コマンドを再度実行した場合、ネゴシエーション項目が既に削除されているた
め、出力は以下のように変わります。
ERROR ( message:Cannot find requested collection element. )
5. IIS リセットを実行します。
6. Safari を使用してポータルにログインします。
7. 追加テストとして、BBR を使用した再生を検証する必要があります。
v 「IBM Tealeaf cxImpact ユーザー・マニュアル」の『CX のブラウザー・ベー
スの再生』を参照してください。
一部のユーザーはポータルにログインできるが、400 - 不正要求エラーを受
け取るユーザーもいる
Tealeaf が NT 認証を使用するように構成されていて、IIS で統合認証が有効になっ
ている場合、一部のユーザーは、DNS 名を使用して Tealeaf ポータルにアクセスし
ようとすると、400® 不正要求エラーを受け取ります。
HTTPSYS エラー・ログ (HTTPERRx.log) 内のエラーは、以下のとおりです。
400 - RequestLength
IIS で統合認証が有効になっていて、Kerberos がネゴシエーションされる場合、一
部のユーザーで、要求ヘッダーの制限を超える、非常に大きな Kerberos チケットが
生じる可能性があります。
v 多数のグループ・メンバーシップのため、ユーザーがポータルにアクセスできな
いことがあった。
修正するには、次のようにします。
1. レポート・サーバーでレジストリー・キーを追加して、最大フィールド長および
最大要求バイト数を大きくし、大きな Kerberos チケットに対応できるようにし
ます。
HKEY_LOCAL_MACHINE¥System¥CurrentControlSet¥Services¥HTTP¥Parameters¥
MaxFieldLength = 32768 (default = 16384)
HKEY_LOCAL_MACHINE¥System¥CurrentControlSet¥Services¥HTTP¥Parameters¥
MaxRequestBytes = 32768 (default = 16384)
2. IIS を再始動します。
参照先
v IIS の Http.sys レジストリー設定 (Microsoft KB 820129) (http://
support.microsoft.com/?kbid=820129)
v Active Directory での Kerberos 認証の問題 (http://blogs.technet.com/surama/archive/
2009/04/06/kerberos-authentication-problem-with-active-directory.aspx)
v HTTP 400 不正要求に関する説明 (http://www.issociate.de/board/post/314237/
HTTP_400_Bad_Request.html)
第 1 章データの保存と再作成
33
ポータルでの合計セッション数のカウントとアーカイブされたセッション数
のカウントの差
ポータルの「アクティビティーの合計」レポートで、左上のセッション・カウント
が、右下のアーカイブされたセッション・カウントに一致していないことがありま
す。環境によって、いずれかのカウントが多くなることがあります。
合計セッション数のカウントは、新規 Web サイト・セッションが開始されるたび
に増分されます。アーカイブされたセッション数のカウントは、セッションが保存
用にマークされると増分されます。この定義の違いにより、カウントの差が生じる
ことがあります。
午前 0 時頃には、一部のアクティブ・セッションがまだ長期キャニスターに保存さ
れていないため、合計セッション数がアーカイブされたセッション数よりも多くな
ることがあります。
同様に、ある日に、午前 0 時より前に開始され、午前 0 時より後に終了して保存
されたセッションのバーストがあった場合、合計セッション数よりもアーカイブさ
れたセッション数が多くなることがあります。
Internet Explorer での表示の問題
Windows Server 2003 および Windows Server 2008 では、デフォルトで、Internet
Explorer でセキュリティー強化機能が有効になります。IE でセキュリティー強化が
有効になっている場合、以下に示すような表示の問題が発生する可能性がありま
す。
Internet Explorer で表示の問題が発生している場合、セキュリティー強化機能を無効
にするか、Tealeaf コンポーネントを信頼済みサイトとして追加することができま
す。
注: セキュリティー強化の有効化が RTC に影響するかどうかは不明です。
Tealeaf ポータルでの表示の問題
IE でセキュリティー強化が有効になっている場合、以下の問題が Tealeaf ポータル
で発生する場合があります。
v ポータル・メニューが表示されない。
v JavaScript エラー「getElementByID is null or not an object」
PCA での表示の問題
IE でセキュリティー強化が有効になっている場合、以下の問題が PCA で発生する
場合があります。
v Web コンソールでボタンのクリックが機能しない。
信頼済みサイトとしての Tealeaf コンポーネントの登録
パフォーマンスを改善するために、Internet Explorer で信頼済みサイトとして
Tealeaf コンポーネントの URL を登録できます。
34
Tealeaf トラブルシューティング・ガイド
1. 「Internet Explorer」メニューで、「ツール」 > 「オプション...」を選択しま
す。
2. 「セキュリティー」タブをクリックします。
3. 「信頼済みサイト」をクリックします。
4. 「サイト...」をクリックします。
5. Tealeaf インストール済み環境に関連した以下の各 URL を入力します。ここ
で、<host_name> は、コンポーネントのホスト・マシンです。
v Tealeaf ポータル:
http://<host_name>/portal/
v PCA Web コンソール:
https://<host_name>:8443
注: ポータルまたは PCA が非デフォルト・ポートを介して通信している場合
は、URL の一部としてポート番号を指定する必要があります。
6. 「追加」をクリックします。
7. 関連したすべての URL の追加が完了したら、「閉じる」をクリックします。次
に、「OK」をクリックします。
Windows でのセキュリティー強化の削除または無効化
Windows Server 2003 では「Internet Explorer セキュリティー強化の構成」を削除で
き、Windows Server 2008 では「Internet Explorer セキュリティー強化の構成」を無
効にできます。
Windows Server 2003 の場合の削除
Windows Server 2003 から「Internet Explorer セキュリティー強化の構成」を削除で
きます。
「Internet Explorer セキュリティー強化の構成」を削除するには、以下を実行しま
す。
1. Windows の「スタート」メニューから、「設定」>「コントロールパネル」>
「プログラムの追加と削除」を選択します。
2. 「Windows コンポーネントの追加と削除」をクリックします。
3. 「Internet Explorer セキュリティ強化の構成」を選択してオフにします。
第 1 章データの保存と再作成
35
4. 「次へ」をクリックします。
5. これで、コンポーネントが削除されます。
Windows Server 2008 用の無効化
Windows Server 2008 から「Internet Explorer セキュリティー強化の構成」を無効に
できます。
Windows Server 2008 内で「Internet Explorer セキュリティー強化の構成」を無効に
するには、以下を実行します。
1. Windows の「スタート」メニューから、「設定」 > 「コントロールパネル」
> 「管理ツール」 > 「サーバーマネージャー」を選択します。
2. 以下のように、「サーバーマネージャー」が表示されます。
36
Tealeaf トラブルシューティング・ガイド
Windows サーバーマネージャー
3. 「IE ESC の構成」リンクをクリックします。
第 1 章データの保存と再作成
37
Internet Explorer セキュリティー強化の構成
4. 管理者およびユーザーの ESC 設定を無効にします。
5. 「OK」をクリックします。
6. 機能が無効になります。
IE8 を使用してローカル・マシンでポータルにログインしようとし
たときのスタック・オーバーフロー・エラー
Windows Server 2003 および SQL Server 2005 のローカル・インスタンスを使用し
てローカル・マシンに Tealeaf ポータルおよび Tealeaf データベースをインストー
ルした場合、Internet Explorer 8 を使用してポータルをブラウズしようとすると、以
下のエラー・メッセージを受け取ることがあります。
Stack overflow at line: 183
以下の更新が完了したことを確認します。
v システムが .NET 3.5 SP1 に更新されている。
v 必要なすべての Windows 更新が実行されている。
v 必要なすべての推奨 IE8 更新が実行されている。
38
Tealeaf トラブルシューティング・ガイド
Tealeaf ポータルのすべてのメニュー項目へのアクセスの有効化
管理ユーザー・グループに対して Tealeaf ポータルのすべてのメニュー項目へのア
クセスを有効にできます。
注: この SQL によって有効になるアクセスは、メニュー項目に対してのみです。ポ
ータル内の一部のページには、ページ・レベルの権限の制限があり、それらはこの
SQL では有効になりません。
注: 以下のステップを実行するには、IIS をリセットする必要があり、ポータル内に
現在いるすべてのユーザーがブートされます。以下のステップは、オフピーク時に
実行してください。
1. TLADMIN または TLUSER アカウントを使用して、TL_SYSTEM データベースに対し
て以下の SQL を実行します。
USE TL_SYSTEM
DELETE FROM RS_PROFILE_ITEM WHERE PROFILE_ID = 1 AND OBJ_ID = 100
GO
INSERT INTO RS_PROFILE_ITEM
SELECT 1, 100, NODE_ID FROM RS_MENU
GO
2. 上記の実行後に IIS リセットを実行します。
3. これで管理グループのメンバーであるユーザーが、「ポータル」メニューで使用
可能なすべてのページにアクセスできるようになりました。
Internet Explorer でメニュー・バーの下にポータル・コンテンツが表示さ
れない
IBM Tealeaf cxImpact または IBM Tealeaf cxView を使用しているときに、Internet
Explorer でメニュー・バーの下にポータル・コンテンツが表示されないという問題
が発生する場合があります。
この問題が発生した場合、Internet Explorer の「詳細設定」タブの「マルチメディ
ア」で以下の 2 項目が選択されていることを確認してください。
v 自動的にイメージのサイズを変更する
v Web ページのアニメーションを再生する
ポータルの時刻が数時間ずれている
デフォルト・ポータル・タイム・ゾーンは GMT ベースであり、ご使用の Tealeaf
実装で期待されるものとは異なることがあります。
タイム・ゾーンを設定するステップは、以下のとおりです。
1. ポータルにポータル管理者としてログインします。
2. 「Tealeaf」 > 「ポータル管理」を選択します。
3. 管理するアカウントのタイプを選択します。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『CX ユーザー管理』を参照して
ください。
第 1 章データの保存と再作成
39
v 「IBM Tealeaf cxImpact 管理マニュアル」の『cxView ユーザー管理』を参照
してください。
v 「IBM Tealeaf cxReveal ユーザー管理マニュアル」の『cxReveal ユーザー管
理』を参照してください。
4. 時刻の違いが発生しているユーザーを選択します。
5. 「タイム・ゾーン」ドロップダウンから、ユーザーの正しいタイム・ゾーンを選
択します。
6. 変更を完了するには、「保存」をクリックします。
7. 時刻の変更が結果として適用されたことを確認するために、「アクティブ」 >
「セッション」を選択し、アクティブ・セッションのタイム・スタンプを確認し
ます。
検索サーバーに接続できない問題のデバッグ
ポータルで IP アドレスまたは完全修飾ドメイン・ネームを使用して宛先サーバー
を指定しても、ポータルが検索サーバーと通信できない場合は、以下の説明に従っ
て問題をデバッグできます。
ポータルが検索サーバーと通信できない問題をデバッグするには、
問題をデバッグするために、以下のようにログ・レベルを 9 に設定する必要があり
ます。
以下のように、ログ・レベルを 9 に設定します。リリース 7.2 より前の場合:
「スタート」 > 「プログラム」 > 「TeaLeaf Technology」 > 「TeaLeaf RealiTea
レポート・サーバー (TeaLeaf RealiTea Report Server)」 > 「RealiTea レポート・
サーバー構成 (RealiTea Report Server Configuration)」を選択して、TeaLeaf
ReportConfig.exe ユーティリティーを開き、変更を行います。
World Wide Web Publishing Service を再始動します。
リリース 7.2 以降の場合: TMS で変更を行います。Tealeaf ポータルで、
「Tealeaf」 > 「TMS」を選択します。
TMS について詳しくは、「IBM Tealeaf cxImpact 管理マニュアル」の『Tealeaf 管
理システム』を参照してください。
「IBM Tealeaf CX 構成マニュアル」の『レポート・サーバーの構成』を参照してく
ださい。
ログ・レベルが 9 に設定されている場合、ポータル・ログに以下のエラーが表示さ
れることがあります。
Error creating the Web Proxy specified in the ’system.net/defaultProxy’
configuration section. ---> System.DllNotFoundException: Unable to load
DLL ’rasapi32.dll’: A dynamic link library (DLL) initialization
routine failed. (Exception from HRESULT: 0x8007045A)
上記のエラーが表示された場合、.NET/ASP .NET が、ポータルで指定されているも
のとは異なるプロキシー設定セットを継承している可能性があります。この問題を
修正するには、これらの設定を継承しないようにポータルを構成する必要がありま
す。
注: この変更が企業の要件に違反していないことを確認してください。
40
Tealeaf トラブルシューティング・ガイド
解決方法としては、以下の XML をポータルの Web.Config ファイルに追加しま
す。
<system.net>
<defaultProxy>
<proxy usesystemdefault="false"/>
</defaultProxy>
</system.net>
Web.Config ファイルは、以下のロケーションに保管されます。
<Tealeaf_install_directory>¥Portal¥WebApp
注: 問題の修正後に、必ず、ログ・レベルを前の値にリセットしてください。
Excel への XML エクスポートを表示するための正しいファイル関連付けの
確認
XML 文書を開くためのデフォルトのファイル関連付けが MSOXMLED.EXE 以外のもの
に変更されている場合、Tealeaf は Excel への XML エクスポートを表示できない
場合があります。
Microsoft Office がインストールされているシステムでは、デフォルトで、Windows
は MSOXMLED.EXE を使用してすべての XML 文書を開こうとします。このアプリケ
ーションは、XML 文書を開くために使用する Office アプリケーションを識別する
mso-application タグを文書でスキャンします。
この関連付けが、例えば Notepad.exe を使用するように変更されている場合、
Windows は Office XML 文書を正しく開くことができません。
適切なマッピングを確認するには、以下のようにします。
1. Windows エクスプローラーを開いて、ローカル・コンピューター上の任意のフ
ォルダーを表示します。
2. 「Windows エクスプローラ」メニューで、「ツール」 > 「フォルダオプショ
ン...」を選択します。
3. 「ファイルの種類」タブをクリックします。
4. 「XML/XML ドキュメント」項目を選択します。
5. 「拡張」をクリックします。
6. 「編集」および「開く」の 2 つのアクションがリストされているはずです。
第 1 章データの保存と再作成
41
7. それぞれのアクションについて、「編集」をクリックし、「アクションを実行す
るアプリケーション」の値を確認します。64 ビットの Windows の場合、以下
のようなパスになっているはずです。
"C:¥Program Files (x86)¥Common Files¥Microsoft Shared¥OFFICE12¥MSOXMLED.EXE"
/verb edit "%1"
"C:¥Program Files (x86)¥Common Files¥Microsoft Shared¥OFFICE12¥MSOXMLED.EXE"
/verb open "%1"
上記のパスが MSOXMLED.EXE アプリケーションを指していない場合は、Excel で
XML 文書を正しく開くことができません。この問題を修正するには、適切なアプリ
ケーションを指すようにパスを変更します。
トラブルシューティング・トピックのプレリリース 5.0
Tealeaf リリース 4.x 以前を使用している場合、このセクションのトピックを使用し
てトラブルシューティングを行います。
データベースからの誤った日付のパージ
レポート・データベースから誤った日付のレコードをパージできます。
注: バージョン 4.5 以上では、グラフの日付を選択するためにデータベースからデ
ータが取り込まれていたドロップダウン・メニューにデータが取り込まれなくなり
ます。カレンダー・ポップアップが、サポートされる唯一の日付入力方式です。
注: この解決方法の残りの部分は、4.0 以前のシステムにのみ適用されます。
42
Tealeaf トラブルシューティング・ガイド
誤った日付のレコードをレポート・データベースから削除するには、以下のよう
に、イベントの固有 ID を見つけてから、レコードをテーブル MC DTS LOG から
削除します。
1. イベントの固有 ID を見つけるには、以下のいずれかを実行します。
a. ポータルの「グラフ」ウィザードで、イベントのグラフを作成するためのリ
ンクの上にカーソルを移動します。イベントの固有 ID は、照会ストリン
グ・パラメーター内にあります。
b. イベント・エディターからイベント ID 値を取得します。
c. ビューアーを使用して、「基本検索」タブで検索するイベントを選択してか
ら、検索を「拡張検索」タブにコピーします。「拡張検索」タブで、検索ス
トリングにイベントの固有 ID が表示されます。
2. データを表示するには、SQL Server のクエリー・アナライザー・ツールを使用
する必要があります。クエリー・アナライザーは、ライセンス交付を受けた
SQL Server インストール済み環境の一部であり、MSDE には付属していませ
ん。システムで MSDE を使用している場合は、以下のように、SQL Server がイ
ンストールされている任意のワークステーションを使用して、SQL クエリー・
アナライザーを実行し、Tealeaf レポート・データベースに接続できます。
a. クエリー・アナライザーを開始します。
b. 以下の照会を発行します。1 を正しい固有 ID 値に置き換えてください。
select dts from mc dts log where {{UniqueID}} = 1 order by dts
c. 「1/1/1970」のレコードが表示された場合、以下の照会でそのレコードを削除
できます。1 を正しい固有 ID に置き換えてください。
delete from mc dts log where {{UniqueID}} = 1 and dts < ’1/1/1999’
グラフ作成時の「Event Description Not Found」メッセージへの
対処
イベントのポータル・グラフを作成しようとしたときに、「Event Description Not
Found」メッセージを受け取る場合があります。
注: この解決方法は、Tealeaf のリリース 4.x 以前のバージョンに適用されます。
イベントのポータルのグラフを、イベント・エディターで作成した直後に作成しよ
うとすると、以下のメッセージを受け取ることがあります。
Event Description Not Found
グラフを作成するには、5 分から 30 分待機する必要が生じることがあります。待
機する必要がある時間の長さは、レポート・データ収集プログラム・サービスのデ
ータ収集時間によって異なります。
v システムがビジーである場合、処理サーバーからデータを収集するためにかかる
時間の長さが原因で、レポート・データ収集プログラムが新規サイクルを開始す
るのに、デフォルトの間隔の 5 分より長い時間がかかります。
v 正しくサイズ変更されたシステムでは、新規イベントの説明を表示するのに、5
分から 10 分より長い遅延は生じません。
第 1 章データの保存と再作成
43
新規に定義したイベントのイベントの説明が存在するようになる前にグラフを調べ
た場合、次のデータ収集実行が完了してイベントの説明が取得されるまで、グラフ
にデータは表示されません。
一般的なポータル・ホーム・ページのエラーへの対処
リリース 4.x 以前のバージョンの Tealeaf を使用している場合に、一般的なポータ
ル・ホーム・ページのエラーを受け取る場合があります。
例えば、ポータル・ホーム・ページで以下のエラーが発生する場合があります。
Portal Error
TeaLeaf Portal Version: 4.6.0.4655
An error has occurred in the TeaLeaf Portal Application.
Please contact the system administrator.
このメッセージが表示された場合、詳細について以下を確認します。
v Windows イベント・ログ
v 以下のように、ログ・レベルを 9 に設定します。
1. リリース 7.2 より前: 「スタート」 > 「プログラム」 > 「TeaLeaf
Technology」 > 「TeaLeaf RealiTea レポート・サーバー (TeaLeaf RealiTea
Report Server)」 > 「RealiTea レポート・サーバー構成 (RealiTea Report
Server Configuration)」を選択して、TeaLeaf ReportConfig.exe ユーティリテ
ィーを開き、変更を行います。次に、World Wide Web Publishing Service を
再始動します。
2. リリース 7.2 以降: TMS で変更を行います。Tealeaf ポータルで、
「Tealeaf」 > 「ポータル管理」を選択します。TMS について詳しくは、
「IBM Tealeaf cxImpact 管理マニュアル」の『Tealeaf 管理システム』を参照
してください。
– 「IBM Tealeaf CX 構成マニュアル」の『レポート・サーバーの構成』を参
照してください。
問題を診断できない場合は、以下を実行し、情報を確認します。
v TLAspUtil.dll および TLPrivacy.dll ファイルにすべてのユーザーに対する読み
取りおよび実行権限が設定されているかどうかを確認します。
v TeaLeaf の NT 認証機能を使用している場合は、認証で使用するために検索サー
バー構成ユーティリティーで指定された Active Directory グループを検索しま
す。
ポータルのログオン画面を取得できない
注: この解決方法は、Tealeaf のリリース 4.x 以前のバージョンに適用されます。
ポータルで以下のエラー・メッセージが表示される場合:
TeaLeaf Portal Version: 4.5.0.4574
Error Number: -2147467259
Source:
File: /LM/W3svc/1/Root/Portal/global.asa
Description: .
Line: 34
44
Tealeaf トラブルシューティング・ガイド
TLAspUtil.dll と TLPrivacy.dll の両方に、IUSR <ポータル・サーバー名> ユー
ザーまたは関連する Windows NT/Active Directory グループ (NT 認証統合機能を使
用している場合) に対する読み取り権限および読み取りと実行権限が設定されてい
ることを確認します。
「Error - 593 - Non ADMIN user blocked from logon」への
対処
リリース 4.x 以前のバージョンの Tealeaf を使用している場合に、「Error - 593 Non ADMIN user blocked from logon」が発生する場合があります。
このエラーは、TLTMaint.exe がデータ検証またはリカバリーのためにキャニスター
をロックした場合に発生します。
このエラーをクリアするには、以下のようにします。
1. 「開始」メニューのショートカットを使用して、すべての Tealeaf サービスを停
止します。トランスポート・サービスは実行したままでも構いません。
2. 「コマンドプロンプト」ウィンドウを使用して、Tealeaf インストール・ディレ
クトリーにナビゲートします。
3. コマンド・ラインで次のコマンドを入力します。
TLTMaint -NoServer
4. TLTMaint の実行が完了するまで待機します。Windows イベント・ログにリカバ
リー不能エラーがレポートされた場合は、http://support.tealeaf.com/ にお問い合わ
せください。
5. TLTMaint の完了後に、「開始」メニューから「Tealeaf サービスの開始 (Start
Tealeaf Services)」ショートカットを使用します。
6. サービスの再始動後に、ポータル・ログインが正しく機能していることを確認し
ます。
どのユーザー ID を使用してもポータルにログインできないエラー
への対処
Tealeaf リリース 4.x 以前のバージョンを使用している場合、どのユーザー ID を
使用してもポータルにログインできない場合があります。
例えば、ポータルにログインしようとすると、次のエラー・メッセージが表示され
る場合があります。
Database Error The web server experienced an error with the database.
Error Number: -2147467259
Error Description: The Portal cannot connect to the Report Server.
SQL Statement: SELECT PASSWORD FROM MC USER WHERE MC USER NAME = ’<username>’
このメッセージは、レポート・データベースが稼働していないことを示していま
す。MSSQLServer サービスが稼働していることを確認してください。確かではない
場合は、「開始」メニューから「Tealeaf サービスの開始 (Start Tealeaf Services)」
ショートカットを選択します。
第 1 章データの保存と再作成
45
ポータルのライブ・セッション・ページで 500 エラーが出される
Tealeaf リリース 4 以前のバージョンを使用している場合に、ライブ・セッショ
ン・ページでタイプ 500 エラーを受け取る場合があります。
...¥TeaLeaf¥Portal¥Web Application¥temp chart ディレクトリーは、NT 認証を
使用していない場合、TeaLeaf Active Directory ユーザー・グループまたはポータ
ル・マシンの IUSR * ユーザーによって書き込み可能でなければなりません。
IIS エラー・メッセージ
このトピックでは、IIS により生成される一般的なエラー・メッセージと、そのメッ
セージが表示される理由およびエラーに対処するために実行できるアクションにつ
いて説明します。
IIS ステータス・コードについて詳しくは、http://support.microsoft.com/kb/
318380 を参照してください。
表 1. IIS エラー・メッセージ
エラー
説明
アプリケーションプール
’DefaultAppPool’ の ID が
無効です
「ユーザーはパスワードを変更できない」を true に設定し
ます。パスワードを有効期限なしに設定しても、効果がない
ように思われます。
v ユーザーは IIS_WPG のメンバーです。
– http://geekswithblogs.net/EltonStoneman/archive/
2008/05/26/the-identity-of-application-poolesbapppool-is-invalid.aspx
– http://www.microsoft.com/technet/prodtechnol/
WindowsServer2003/Library/IIS/f05a7c2b-36b0-4b6eac7c-662700081f25.mspx?mfr=true
App-Domain が作成されなか AppDomain の ID に適切な権限が設定されていません。デフ
ったため、要求を実行できまォルトについて IIS 権限の資料を確認してください。
せんでした 0x80004005 未定
義のエラー
ディレクトリー変更のモニタ IIS/ASP.NET のディレクトリー権限に問題がある可能性があ
リングを開始できませんでしります。詳しくは、http://support.microsoft.com/kb/
317955を参照してください。
た (Failed to start
monitoring directory
changes)
46
Tealeaf トラブルシューティング・ガイド
表 1. IIS エラー・メッセージ (続き)
エラー
説明
以下を実行します。
現在の ID (NT
AUTHORITY¥NETWORK SERVICE) 1. コマンド・シェルを開き (「スタート」 > 「ファイル名
は
を指定して実行」 > 「cmd」)、ご使用の OS ビルドによ
C:¥WINDOWS¥Microsoft.NET¥
って、50727 が含まれた以下のいずれかのディレクトリー
Framework¥ v2.0.50727¥
にナビゲートします。
Temporary ASP.NET ファイル
v 64 ビット O/S の場合:
への書き込みアクセス権があ
C:¥WINDOWS¥Microsoft.NET¥Framework64¥v2.0.50727¥
りません
2. 以下のコマンドを実行します。
aspnet_regiis -ga "NT AUTHORITY¥NETWORK SERVICE"
3. 以下のコマンドを実行します。
aspnet_regiis -ga IUSR_<machinename>
ASP.NET はドメインコント構成ファイルの processModel セクションで指定されているユ
ローラー上の ASPNET アカウーザー名/パスワードが無効であるため、aspnet_wp.exe を開
始できませんでした。
ントでは動作しません
v 詳しくは、http://support.microsoft.com/kb/315158を参
照してください。
CS0016: 出力ファイル
c:¥WINDOWS¥Microsoft.NET¥
Framework64¥v2.0.50727
¥Temporary ASP.NET Files
¥portal¥d71063af¥5e3121f8¥
App_global.asax.j8jlnnti
.dll
に書き込めませんでしたアクセスは拒否されました
TEMP システム環境変数で以下を確認します。
v フォルダーが存在している。
v Network Service および他の ASP.NET アカウント (当ては
まる場合) がそのフォルダーに対する全権限を備えてい
る。
詳しくは、http://support.microsoft.com/kb/825791を参照
してください。
401.2 「サーバー構成により「ディレクトリセキュリティ」>「認証とアクセス制御」ウ
ログオンに失敗しました」
ィンドウで有効になっている認証方式がありませんでした。
共通 IIS 404 問題
http://support.microsoft.com/kb/248033/en-usを参照して
ください。
301 ステータス・コード
以下を再実行します。
aspnet_regiis -i
Windows/System32/LogFiles/ IIS は失敗しました。必要なユーザー・アカウント権限を確認
W3SVC の中にログ・エントリします。権限の問題が見つからない場合は、IIS を再インスト
ールします。
ーがない
サービス利用不可メッセージ Network Service ユーザーのアプリケーション・プール権限
の問題が発生している可能性があります。詳しくは、
http://support.microsoft.com/?kbid=842493を参照してくだ
さい。
第 1 章データの保存と再作成
47
表 1. IIS エラー・メッセージ (続き)
エラー
説明
一部の NT ユーザーは以下
の 400 メッセージを受け取
ります。ポータルへのアクセ
ス時に Request Length
error メッセージを受け取り
ますが、受け取らないユーザ
ーもいます
ユーザーがあまりにも多くの NT グループのメンバーである
場合、IIS でユーザーの大きな要求の取得中に問題が生じるこ
とがあります。
v IIS で統合認証が有効になっていて、Kerberos がネゴシエ
ーションされる場合、一部のユーザーで、要求ヘッダー制
限に達する大きな Kerberos チケットが生じる可能性があり
ます。
修正するには、次のようにします。
1. レポート・サーバーでレジストリー・キーを追加して、最
大フィールド長および最大要求バイト数を大きくし、大き
な Kerberos チケットに対応できるようにします。
HKEY_LOCAL_MACHINE¥System¥CurrentControlSet
¥Services¥HTTP¥Parameters¥
MaxFieldLength = 32768 (default = 16384)
HKEY_LOCAL_MACHINE¥System¥CurrentControlSet
¥Services¥HTTP¥Parameters¥
MaxRequestBytes = 32768 (default = 16384)
2. IIS を再始動します。
v IIS の Http.sys レジストリー設定について詳しくは、
http://support.microsoft.com/?kbid=820129 を参照して
ください。
v Active Directory での Kerberos 認証の問題について詳しく
は、http://blogs.technet.com/surama/archive/2009/04/
06/kerberos-authentication-problem-with-activedirectory.aspx を参照してください。
ログインしようとしても
Default.aspx から離れられ
ない
Cookie の問題の可能性があります。
v SimpleTest.aspx を実行して、Cookie が機能していること
を確認します。
v Cookie が機能している場合、クライアント・マシン上の日
付が正しいことを確認します。
– 日付があまりにもずれている場合、ポータルの Cookie
の有効期限が既に切れていると判断されていて、結果と
してユーザーが「ログイン」ページ上に留まっている可
能性があります。
セッションが 29 時間 (1740 ポータルのアプリケーション・プールの「リサイクル設定
分、つまり 1 日と 5 時間) (Recycling settings)」タブで「ワーカー処理をリサイクルする
(分) (Recycle worker processing (in minutes))」設定を無
で存続しなくなる
効にします。
NT ログイン/DB ログインと ASP.NET は適切に機能していません。
新しいユーザーのダイアログ
がすべて Default.aspx ペー次のコマンドを再実行します。
aspnet_regiis -i
ジに表示されます
48
Tealeaf トラブルシューティング・ガイド
表 1. IIS エラー・メッセージ (続き)
エラー
説明
Internet Explorer でも NT 以下を確認します。
資格情報ダイアログがポップ v ユーザーのマシンとポータル・マシンはともに同じドメイ
アップする
ン内になければなりません。
v Internet Explorer で、「ツール」 > 「インターネットオ
プション」 > 「拡張」 > 「セキュリティー」を選択しま
す。「統合 Windows 認証を使用する」チェック・ボック
スを選択します。
v Internet Explorer で、「ツール」 > 「インターネットオ
プション」 > 「セキュリティゾーン」を選択します。以
下のいずれかが満たされていることを確認してください。
– 「ユーザー認証」 > 「ログオン」が正しく構成されて
いる
– ポータルが正しい信頼済みゾーンにある
v web.config debug=true が機能しない場合、machine.config
で deployment retail=true になっていることを確認します。
v インストール直後に 500 コンパイル・エラーを受け取った
場合、/Portal/WebApp の Web.config ファイルに
customErrors=Off を設定します。この設定により、カスタ
ム・エラー・ページが無効になり、問題の絞り込みに役立
ちます。問題が Web.config ファイル内にある場合、
ASP.NET 2.0 ではなく 1.1 に対してポータルを実行してい
る可能性があります。
1. .NET 2.0 がインストールされていることを確認しま
す。
2. ASP.NET 2.0 が登録されたことを確認します (実行:
aspnet_regiis.exe /i)。
3. ポータル仮想ディレクトリー・プロパティーの
ASP.NET タブで ASP.NET 2.0 が選択されていること
を確認します。
– ASP.NET タブが存在しない場合は、aspnet_regiis
に当該仮想ディレクトリーを手動で登録する必要が
生じることがあります。
BBRFilter.dll の開始中のエ Microsoft Visual C++ 2005 再頒布可能パッケージ (x86) が欠
ラー
落しているか、破損しています。詳しくは、
http://www.microsoft.com/downloads/
details.aspx?familyid=32bc1bee-a3f9-4c13-9c99220b62a191ee&displaylang=enを参照してください。
ロケール・エラー
ポータルのロケール指定に以下を記述します。
<system.web>
<globalization fileEncoding="utf-8"
requestEncoding="utf-8"
responseEncoding="utf-8"
culture="en-US" uiCulture="en-US" />
</system.web>
第 1 章データの保存と再作成
49
表 1. IIS エラー・メッセージ (続き)
エラー
説明
「system.net/
defaultProxy」構成セクショ
ンで指定された Web プロキ
シーの作成中にエラーが発生
する。
System.Configuration.ConfigurationErrorsException:
Error creating the Web
Proxy specified in the ’system.net/defaultProxy’
configuration section. --->
System.DllNotFoundException: Unable to load DLL
’rasapi32.dll’:
A dynamic link
library (DLL) initialization routine failed.
(Exception from HRESULT:
0x8007045A)
atSystem.Net.UnsafeNclNativeMethods.RasHelper.
RasEnumConnections(RASCONN[]
lprasconn, UInt32& lpcb, UInt32& lpcConnections)
atSystem.Net.
UnsafeNclNativeMethods.RasHelper.GetCurrentConnectoid()
atSystem.
Net.AutoWebProxyScriptEngine.AutoDetector.Initialize()
atSystem.
Net.AutoWebProxyScriptEngine.AutoDetector.get
_CurrentAutoDetector()
at System.Net.AutoWebProxyScriptEngine..ctor
(WebProxy proxy,Boolean useRegistry)
at System.Net.WebProxy.UnsafeUpdateFromRegistry()
at System.Net.WebProxy..ctor(Boolean
enableAutoproxy) at
System.Net.Configuration.
DefaultProxySectionInternal..ctor DefaultProxySection
section)
at System.Net.Configuration.
DefaultProxySectionInternal.GetSection()
--- End of inner exception stack trace --atSystem.
Net.Configuration.DefaultProxySectionInternal
.GetSection()
atSystem.
Net.WebRequest.get_InternalDefaultWebProxy() at
System.Net.HttpWebRequest..ctor(Uri uri,
ServicePoint servicePoint) at
System.Net.HttpRequestCreator.Create(Uri Uri)at
System.Net.WebRequest.Create(Uri requestUri,
Boolean useUriBase)
atSystem.Net.WebRequest.Create
(String requestUriString) at
TeaLeaf.SearchServer.RealSearchServer.RealCommunicate
(String command,
ArrayList args, Int32 timeout)
Web.Config では、以下が必要です。
<system.net>
<defaultProxy>
<proxy usesystemdefault="false"/>
</defaultProxy>
</system.net>
IIS7 を使用していて 401.2
が表示される
50
Tealeaf トラブルシューティング・ガイド
401.2 エラーが表示されている場合、匿名認証とフォーム認
証が有効になっていることを確認します。匿名のアカウント
が IUSR であるか、または適切な権限を備えた他のアカウン
トであることを確認します。
役に立つ他の Microsoft 知識ベースの記事
IIS に関する役に立つ情報については、このトピックの知識ベースの記事を使用して
ください。
IIS 6.0 での既定のアクセス許可とユーザー権利
http://support.microsoft.com/kb/812614/
IIS 5.0 Web サーバーに必要な NTFS アクセス許可とユーザー権利
の設定方法
http://support.microsoft.com/kb/271071
アプリケーションイベントログでの "W3wp.exe could not be
started" エラーメッセージ
http://support.microsoft.com/default.aspx?scid=kb;en-us;833444
ASP.NET ページを表示するときに "Aspnet_wp.exe Could Not Be
Started" というエラーメッセージが表示される
http://support.microsoft.com/default.aspx?kbid=811320
"403.1 (実行) アクセスが拒否されました"
ASP.NET スクリプト・マッピングが破損しています
"この実装は Windows プラットフォーム FIPS 検証暗号化アルゴリ
ズムの一部ではありません。"
http://blogs.msdn.com/shawnfa/archive/2005/05/16/417975.aspx
"パス '/App_GlobalResources' を割り当てられませんでした。"
http://forums.microsoft.com/MSDN/ShowPost.aspx?PostID=117013&SiteID=1
"403.18 - 現在のアプリケーションプールから指定された要求を実行
することはできません"
http://blogs.msdn.com/rakkimk/archive/2006/09/01/735684.aspx
この問題を回避するには、
「HKLM¥SYSTEM¥CurrentControlSet¥Services¥W3SVC¥Parameters¥」フォルダーで名
前「IgnoreAppPoolForCustomErrors」、タイプ「DWORD」、および値 1 を使用して
レジストリー・キーを作成する必要があります。
ASP.NET 2.0 をユーザーアカウントで実行されるように構成すると
エラーメッセージ "一時クラスを生成できません" が表示される
http://support.microsoft.com/kb/908158
詳細:
[InvalidOperationException: 一時クラスを生成できません (result=1)。
エラー CS2001: ソースファイル 'D:¥WINDOWS¥TEMP¥d0lurtzx.0.cs' が見つかりま
せんでした。
第 1 章データの保存と再作成
51
エラー CS2008: 入力が指定されていません
既定の Web サイトが削除された
http://www.ssw.com.au/ssw/KB/KB.aspx?KBID=Q889546
完了したセッションの検索を実行できない
完了したセッションの検索をポータルから実行している場合、検索するインデック
スがないことを示すエラーが返されることがあります。
以下のステップを実行して、問題をトラブルシューティングできます。
1. RTV を使用して検索を試行します。RTV を使用して検索できた場合、検索サー
バーは作動可能です。
2. 検索サーバーの個別インデックスの状態を調べることをお勧めします。これを行
うには、同じ検索サーバーを使用するように RTV を構成する必要があります。
検索サーバーへの接続について詳しくは、「IBM Tealeaf RealiTea Viewer ユーザ
ー・マニュアル」の『RTV の検索のセットアップ』を参照してください。
a. 同じ検索サーバーに正常に接続できた場合、「検索のセットアップ」ウィン
ドウのサーバー・ノードの下に使用可能なインデックスのリストが表示され
ます。
b. 検索サーバーのインデックスのサマリーを確認するために、サーバー・ノー
ドを選択し、「サマリー...」をクリックします。
c. ブラウザーに生成された「サマリー」ページで、検索サーバーによって管理
されている各インデックスのステータスを確認できます。「開始」および
「終了」の各タイム・スタンプと、「インデックス」、「サイズ」、および
「セッション・インデックス」の各値を確認します。これらのフィールドに
意味のある値が含まれている場合、「開始」日付から「終了」日付までのセ
ッション・データを検索できるはずです。
3. RTV で検索サーバーが正しく動作しているように思われる場合、データ・サー
ビスの問題である可能性があります。ポータルは、Tealeaf データ・サービスか
ら使用可能なインデックス・セットを取得します。以下のステップを実行して、
データ・サービスが作動可能であることを確認します。
a. ポータルで、「Tealeaf」 > 「ポータル管理」を選択します。
b. 「サーバーの管理」リンクをクリックします。
c. 「データ・サービス・サーバー」を選択します。
v データ・サービス・サーバーがサーバーのリストに存在しない場合は、
「非アクティブの表示」チェック・ボックスをクリックします。これでサ
ーバーが表示された場合、サーバーをアクティブ化する必要があります。
v それでもデータ・サービス・サーバーが表示されない場合、その項目を作
成する必要があります。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『Tealeaf サーバーの管理』を
参照してください。
52
Tealeaf トラブルシューティング・ガイド
d. データ・サービス・サーバーを選択したら、サーバーのリストの上にあるツ
ールバーの「Ping」ツールをクリックします。サーバーのリストの下にある
「データ・サービス・サーバーのステータス」パネルにバージョンおよび要
求情報が表示されます。
4. データ・サービス・サーバーが応答しない場合、データ・サービスを再始動して
みます。
注: データ・サービスの再始動中は、ポータルは他の検索サーバーおよび
Tealeaf データベースに接続できません。通常、再始動には数秒しかかかりませ
ん。
a. ポータルで、「Tealeaf」 > 「TMS」を選択します。
b. Tealeaf 管理システムで、「全体ビュー」タブを選択します。
c. 「ビュー」ドロップダウンから「サーバー」を選択します。
d. 「データ・サービス」ノードをクリックします。
e. サーバー・アクションで、「再始動」をクリックします。
5. 再始動で問題が解決しない場合は、問題は、以下のいずれかに関連している可能
性があります。
a. 不十分な権限。
b. 検索サーバーに接続するために必要な、IIS または ASP.NET でのポータル用
の特殊構成をデータ・サービスにも適用する必要があります。
c. 「ポータル管理」ページのサーバー・アドレスでの生 IP アドレスの使用。
代わりにサーバー名を使用してください。
d. クライアント・ブラウザーとポータルの間のプロキシー・サーバー。プロキ
シーを無効にするか (可能な場合)、検索サーバーに手動で接続するように構
成します。
ステータス・コード 400 エラー
完了した検索がステータス・コード 400 エラーで失敗している場合、検索サーバー
構成でパス値が正しく指定されていない可能性があります。
一時パスは完全修飾パスである必要があります。パスは、完全修飾パスでない場
合、相対パスとして処理され、結果の動作は、現行ドライブ・ディレクトリーによ
って異なります。
v 検索サーバーの始動が拒否されることがあり、イベント・ログ・エラーで一時パ
スの問題が示されることがあります。
v 検索サーバーが、インデックスのリストの検索や取得など、一時ドライブを使用
するコマンドに対してステータス・コード 400 エラーを返すことがあります。
修正するには、検索サーバー構成の値として絶対パス名を使用します。
注: 検索サーバー構成で、すべてのパスに完全修飾パス値を使用してください。
v 「IBM Tealeaf CX 構成マニュアル」の『検索サーバーの構成』を参照してくださ
い。
第 1 章データの保存と再作成
53
検索パフォーマンス問題の診断
長い検索時間、検索タイムアウト、または検索時間の増加が発生している場合、以
下のテストを試行して、検索を加速できるかどうかを確認します。
1. ディスク入出力ベンチマーキング・ユーティリティーを入手します。
v Microsoft SQLIO は有用なユーティリティーです。詳しくは、
www.microsoft.com で「SQLIO Disk Subsystem Benchmark Tool」を検索して
ください。
2. すべての Tealeaf サービスを停止します。
3. Tealeaf ディスクに対して SQLIO を実行します。
4. 7 メガバイト/秒より速い転送速度が観察される必要があります。転送速度がこれ
よりも遅い場合は、ストレージ・デバイスの問題が存在します。該当する管理者
に問い合わせて、詳細および追加診断を求めてください。
5. 確認する必要がある別の領域は、長期キャニスター内の LSSN ファイルと比較
したインデックスのサイズです。Tealeaf ポータルで、「Tealeaf」 > 「システ
ム・ステータス」 > 「ストレージ」を選択します。IBM Tealeaf CX ドロップ
ダウンから個別サーバーを選択します。
a. インデックス・サイズが LTC ファイルのサイズより大きい場合、Tealeaf は
不要なデータをインデックス付けしている可能性があります。
b. キャプチャーされたいくつかのヒットで、要求および応答のコンテンツを調
べて、インデックス付けされているデータがすべて必要であるかを確認しま
す。不要なデータをインデックス付けから削除します。
v 不要なコンテンツを除去してインデックス付けされないようにするプライ
バシー・ルールを作成できます。詳しくは、「IBM Tealeaf CX インストー
ル・マニュアル」の『Tealeaf CX でのデータ・プライバシーの管理』の
「ルール」タブを参照してください。
要求および応答を検査する「すべてのテキスト」検索の使用
「すべてのテキスト」検索は、インデックス付けされたすべての用語を要求および
応答で調べます。
応答の「すべてのテキスト」検索には、「意味がある」と見なされるすべての単語
が含まれています。
v インデックスのディスク・スペース所要量を削減するために、ノイズ語、単一文
字、HTML タグ、および JavaScript コードは、インデックス付けから除外されて
います。
1. 応答でインデックス付けされている (そのため、検索可能な) 内容の概要を確認
するには、IBM Tealeaf CX RealiTea Viewer を開き、標準的なページの応答ビ
ューを調べます。
a. 応答ビューを右クリックします。
b. 「インデックス付けされたビュー (Indexed view)」を選択するか、ツールバ
ーの「応答」ボタンの右側にあるドロップダウン・メニューを使用します。
2. このビューは、特定のページを見つけるために応答で検索できる単語を示しま
す。
54
Tealeaf トラブルシューティング・ガイド
要求では、デフォルトで特定の項目が含まれます。「IBM Tealeaf CX 構成マニュア
ル」の『CX インデックス付けの構成』を参照してください。
検索に単語 NOT を含めることができない
dtSearch インデックス付けエンジンで、単語 NOT は、複合検索語を構成するために
使用される、ブール式の予約済み演算子です。
Tealeaf は、以下の 2 つの異なる検索エンジンを使用します。
v dtSearch インデクサーは、より強力なものであり、RTV またはポータルで完了
したセッションを検索する際に呼び出されます。
v ストリング比較機能は、単純なストリング比較検索機能であり、アクティブ・セ
ッションの検索時に呼び出されます。
この単語 NOT はインデックス付けされません。つまり、この単語は検索できませ
ん。
v 同様に、ハイフンおよび他の句読文字も、単語セパレーターと見なされるため、
インデックス付けされません。
例: URL slp-system-not-available.html を検索する場合を考えます。このストリ
ングを入力した場合、一致するものがあったとしても、ほとんど一致は返されませ
ん。代わりに、ポータル検索から、二重引用符を含む "slp system available" を
検索してください。
v 最初の検索では網を広げるために、検索の末尾で単語 html が削除されていま
す。3 単語の検索で正しくないヒットが返されていると思われる場合は、4 番目
の単語 html を句に追加して、結果セットを絞り込むことができます。
検索構文について詳しくは、以下を参照してください。
v 「IBM Tealeaf RealiTea Viewer ユーザー・マニュアル」の『RealiTea Viewer - 検
索構文』
v 「IBM Tealeaf cxImpact 管理マニュアル」の『キャラクターのインデックス付
け』
フィールド名に ~ または他の句読文字が含まれたフィールドで検索できな
い
セッション・インデクサー・サービスは、alphabet.dat で定義されている特殊文字
で単語を切り分けます。ただし、name=value フィールドに特殊文字が含まれた名前
が入っている場合、そのフィールドは分解され、名前で検索できなくなってしまい
ます。
この状態を回避するために、インデクサーは、名前 (= 符号の左辺) に含まれている
特殊句読文字をアンダースコアー (_) に置き換えます。例えば、~cc_num を検索す
る場合は、フィールド名として _cc_num と入力します。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『キャラクターのインデックス付
け』を参照してください。
第 1 章データの保存と再作成
55
セッション・フラグメントが検索結果に影響する理由
セッションは、複数の条件下でフラグメント化することがあります。フラグメント
化は、検索および一部のイベント・トリガーに影響します。
例えば、ビジネス・プロセスの Web ページが、「アイテムの追加」、「チェック
アウトの開始」、および「チェックアウトの完了」の各イベントで構成されている
ものとします。Web サイトで長いアプリケーション・タイムアウトが許可され、
Tealeaf STC セッション・タイムアウトがアプリケーション・タイムアウトより短
く構成されているものと想定します。
v 短期キャニスターの使用は Tealeaf サーバーでの RAM の消費に直接影響するた
め、多くの場合、この不一致は必要です。
サイトへの訪問者はアイテムを追加し、チェックアウトを開始し、夕食を食べてか
ら、1 時間後に戻ってチェックアウトを完了することもあります。この動作の結
果、最初の 2 つのイベントが含まれた 1 つのセッション・フラグメントと、最後
の「チェックアウトの完了」イベントが含まれた、2 つ目となる、後半部分のセッ
ション・フラグメントが生成されます。
Tealeaf 検索は、セッション・フラグメントを検索します。「イベント 1 and イベ
ント 2 and not イベント 3」の検索では、セッション・フラグメント 2 は見つか
らず、セッション・フラグメント 1 が見つかります。セッション・フラグメント 1
の再生時に、ユーザーは、「このセッションのすべてのフラグメントを検出 (Find
all fragments of this session)」を選択できます。これにより、両方のセッショ
ン・フラグメントのコンテンツで構成された、単一の論理セッションが再生されま
す。マージされたセッションには、3 つすべてのイベントが含まれており、これ
は、元の検索が要求したものではありません。
ほとんどのサイトで、フラグメント化を完全に回避することは困難です。フラグメ
ント化を削減するために、STC タイムアウトの期間を長くすることができますが、
これは STC RAM の消費に影響する可能性があります。STC RAM の過剰消費はス
プーリングにつながり、フラグメント化が発生する可能性があります。スプーリン
グは、できる限り避ける必要があります。フラグメント化が、スプーリングを増や
すことなしに許容できるレベルに削減されるところまで、STC タイムアウトを徐々
に長くしてみることができます。
別のアプローチとしては、フラグメント化したセッションの代表的サンプルを見つ
け、対象のすべてのイベントが含まれる期間についてそのサンプルを分析し、対象
のイベントについてユーザー・セッションの 95% (または他の望ましい割合) がフ
ラグメント化されない STC タイムアウトを設定します。
v セッション・タイムアウトの構成について詳しくは、「IBM Tealeaf CX 構成マニ
ュアル」の『CX キャニスターの構成』を参照してください。
v RTV でのフラグメント化の管理について詳しくは、「IBM Tealeaf RealiTea
Viewer ユーザー・マニュアル」の『RealiTea Viewer - 注釈、検出、およびマー
ジ』を参照してください。
v BBR 用にセッション・フラグメントがどのようにマージされるかの構成について
詳しくは、「IBM Tealeaf cxImpact 管理マニュアル」の『Tealeaf サーバーの管
理』を参照してください。
56
Tealeaf トラブルシューティング・ガイド
v BBR でのフラグメント化の管理について詳しくは、「IBM Tealeaf cxImpact ユー
ザー・マニュアル」の『BBR のオプション』を参照してください。
ポータルとビューアー (またはデータ抽出/cxConnect) でレポートされるセ
ッション・カウントの差
アーカイブには、セッションがタイムアウトになるまで評価できないセッション・
レベルの複合イベントが含まれている必要があるため、セッションは、最後のヒッ
トのタイム・スタンプに従って、長期キャニスターに保管されます。セッションの
最後のヒットのタイム・スタンプは、これらのイベントおよびセッションのセッシ
ョン時間属性に適用されます。
ビューアーのアーカイブ検索とデータ抽出/IBM TealeafcxConnect for Data Analysis
検索ではともに、インデックスを使用し、日時フィルターがセッションの最後のタ
イム・スタンプに対して突き合わされます。ポータルのアクティビティーの合計レ
ポートでレポートされる 1 日のセッション数と、ビューアーまたはデータ抽出ツー
ルによって返される 1 日のセッション数には、少しの差が生じることがあります。
検索構成に関する追加情報
検索テンプレート、検索サーバーの構成方法、検索用の CX 設定などの検索構成に
関する追加情報を IBM Tealeaf の資料とヘルプで参照できます。
構成について詳しくは、以下を参照してください。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『検索テンプレートの構成』
v 「IBM Tealeaf CX 構成マニュアル」の『検索サーバーの構成』
v 「IBM Tealeaf cxImpact 管理マニュアル」の『CX 設定』
ディスクの入出力が制限されているかどうかの判別方法
ディスク・レイアウトおよび割り振りが最適化されていない場合、Tealeaf コンポー
ネントのパフォーマンスが低下することがあります。このトピックの情報を使用し
て、ディスクがパフォーマンス・ボトルネックを生成しているかどうかを判別しま
す。
http://support.tealeaf.com/ の解決方法 65『Configuring the RAID Hard Disk Drive
(HDD) Array』に、物理ディスクをアレイに構成する最適な方法に関する詳細が示さ
れており、また推奨の理由が説明されています。サーバーがこの手法に従ってレイ
アウトされていない場合、Tealeaf システム・パフォーマンスで、ディスク入出力制
約を受ける可能性があります。
以下の解決方法では、ディスクがパフォーマンス・ボトルネックを生成しているか
どうかを判別する方法について説明します。
v Windows PerfMon ユーティリティーを実行します。
v 「ディスクキューの平均の長さ」カウンターがまだ表示されていない場合、右の
ペインを右クリックし、「カウンタの追加」を選択します。
v 「パフォーマンスオブジェクト」ドロップダウンで「物理ディスク」を選択しま
す。
第 1 章データの保存と再作成
57
v 右端のラジオ・ボタン・セットで「すべてのインスタンス」を選択します。
v ラジオ・ボタンの左のペアで「一覧からカウンタを選ぶ」を選択します。
v リスト・ボックスから以下の 3 つのカウンターを複数選択します。
– 平均ディスク・キュー長
– 平均ディスク読み取りキュー長
– 平均ディスク書き込みキュー長
v 「追加」をクリックします。
v perfmon 右ペインの結果を確認します。
v CANISTER、dbs ディレクトリー、および Indexes ディレクトリーが含まれてい
るディスクに注目します。
– 平均キュー長は、1 未満でなければなりません。
– 4 以上のキュー長は、ディスクが入出力制約を受けていることを意味します。
4 以上の平均キュー長は、解決方法 65 のガイドラインに従って、システムのディ
スク・ドライブを再パーティション化する必要があることを強く示しています。
システムが解決方法 65 の標準に従って構成されていて、RAID を使用していない
が、平均キュー長が大きい場合、解決方法としては、より高速なディスク・サブシ
ステムに移動するか、さらに Tealeaf サーバーを追加します。現在のシステムに
は、提供されるデータ処理ロードを処理するためのディスク入出力処理能力があり
ません。
dtSearch のハング後に繰り返される再始動の問題への対処
検索の実行時に、アプリケーション・イベント・ログ内の複数の再始動を示す項目
を受信することがあります。
例えば、アプリケーション・イベント・ログ内の以下の項目を受信する場合があり
ます。
(18:49 Search Server) - TeaLeaf Search Server Ver: 6.2.0.6250 RestartOnDtSearchHang
(18:01 Search Server) - TeaLeaf Search Server Ver: 6.2.0.6250 RestartOnDtSearchHang
(16:21 Search Server) - TeaLeaf Search Server Ver: 6.2.0.6250 RestartOnDtSearchHang
検索サーバーは、ディスク・パフォーマンスの問題または検索を完了するのに十分
な時間がないため、要求された検索を完了できません。
ディスク・パフォーマンスの改善
この問題の原因は、ディスク・ハードウェアのパフォーマンスの問題の可能性があ
ります。以下の確認を実行します。
v
57 ページの『ディスクの入出力が制限されているかどうかの判別方法』で説明さ
れている方法で、Windows PerfMon ユーティリティーを実行します。
1. Tealeaf インデックス・ディレクトリーが存在するディスクの平均ディスク・
キュー長を確認します。通常、この値が 1 より大きい場合、ディスクは入出
力要求に対応できません。
58
Tealeaf トラブルシューティング・ガイド
2. PerfMon.exe を閉じます。
v Microsoft の SQLIO ベンチマーク・ユーティリティーを使用して、ディスク速度
を評価できます。このユーティリティーは、以下から入手できます。
http://www.microsoft.com/downloads/details.aspx?familyid=9a8b005b-84e44f24-8d65-cb53442d9e19&displaylang=en
v ディスクのスループットが 50 メガバイト/秒未満の場合は、Tealeaf サーバーで
必要とされる処理ボリュームに十分な速さではありません。
v ディスク入出力パフォーマンスを改善するための方法について、IT 部門と話し合
ってください。
検索サーバーのウォッチドッグ・タイムアウト設定の編集
ディスク・ハードウェア・パフォーマンスを改善できない場合は、以下のように、
検索サーバーのウォッチドッグ・タイムアウト設定を変更します。
v リリース 7.2 以降:
1. ポータルで、「Tealeaf」 > 「TMS」を選択します。Tealeaf 管理システムが
表示されます。
2. 「ビュー」ドロップダウンから「サーバー」を選択します。
3. 「検索サーバー」ノードをクリックします。
4. 「検索サーバー構成」をクリックします。
5. 「表示/編集 (未加工)」をクリックします。
6. ウィンドウで、デフォルト・グループをクリックします。
7. WatchDogIndexSearchSeconds の値を変更し、現在の値の 2 倍または 4 倍に
します。
8. 「保存」をクリックします。
9. 構成を割り当ててプッシュします。「IBM Tealeaf cxImpact 管理マニュアル」
の『TMS の「全体ビュー」タブ』を参照してください。
v リリース 7.1 以前: Windows アプリケーション・イベント・ログにエラー・メッ
セージが表示されている Tealeaf サーバーで、以下の Windows レジストリーの
値を編集します。
注: この設定の推奨値は 300 秒です。
– 64 ビットの Windows の場合:
HKEY_LOCAL_MACHINE¥Software¥(Wow6432Node)¥TealeafTechnology¥DataStore¥
SearchServer¥WatchDogIndexSearchSeconds
v 上記のキーの現在の値を 2 倍または 4 倍します。
– 必要な場合は、値を 0 に設定してこの機能を完全に無効にすることができま
す。
v 新しい値を適用するために、検索サーバーを再始動します。
キャニスター・スペーサー・ファイルが存在しない
Windows アプリケーション・イベント・ログに、キャニスター・スペーサー・ファ
イルが存在しないことを示す TeaLeaf パイプラインからの警告メッセージが含まれ
ていることがあります。
第 1 章データの保存と再作成
59
SADecoupleEx (TeaLeafCSS_1966): Canister spacer file does not exist
(C:¥Program Files (x86)¥TeaLeaf¥Canister¥Canister.spacer).
キャニスター・スペース・ファイルは、キャニスター内でのセッションの保管用に
ディスク・スペースを予約するために使用されます。上記のメッセージは、このフ
ァイルが存在しないことを示しています。これがない場合、キャニスターは、ディ
スク・スペースが少なくなっているときに、処理したセッションを保存できませ
ん。
拡張デカプラー・セッション・エージェントは通常、このスペーサー・ファイルと
対話しません。ただし、低ディスク・スペース状態が検出されると、このセッショ
ン・エージェントはそれを削除してディスク・スペースを解放します。このメッセ
ージが表示された場合、DecoupleEx がファイルを検出できなかったということで
す。
v セッション・エージェントについて詳しくは、「IBM Tealeaf CX 構成マニュア
ル」の『拡張デカプラー・セッション・エージェント』を参照してください。
スペーサー・ファイルは、TLTMaint ユーティリティーの実行時に作成されます。こ
の問題を修正するために、このユーティリティーを実行してスペーサー・ファイル
を作成できます。
v 「IBM Tealeaf CX インストール・マニュアル」の『CX システムの管理』を参照
してください。
サービスの開始時に DecoupleEx 警告が発生する
Windows アプリケーション・イベント・ログに、キャニスターが停止されたことを
示す TeaLeaf パイプラインからの警告メッセージが含まれていることがあります。
SADecoupleEx: Canister shared memory is invalid. Flow of hits to
the canister has been stopped.
アプリケーション・イベント・ログに、この同じ時刻の近傍に集まった他の多数の
TeaLeaf メッセージが含まれている場合、すべての Tealeaf サービスがシャットダ
ウンして再始動していることが確認されることがあります。ほとんどの場合、
Windows のスケジュールされたタスクの「TLBackup -CycleServices」は、早朝の時
間 (通常は、2:05am) に実行されます。CycleServices の開始の一部は、TLTMaint プ
ログラムを実行し、これは、TeaLeaf キャニスター・サーバー・サービスが開始さ
れるたびに実行されます。TLTMaint は、長期キャニスター全体でデータ整合性を調
べ、2 秒から 200 秒以上実行されることがあります。ほとんどの場合、1 分未満で
完了します。TLTMaint の実行中は、他の TeaLeaf サービスは LTC に接続できま
せん。
SADecoupleEx から表示されている警告メッセージが発生するのは、Tealeaf パイプ
ラインがキャニスターに接続しようとしていて、TLTMaint がまだ実行中であるため
にキャニスターが使用可能でないことを通知された場合です。
イベント・ログ内の少し後の TeaLeaf 始動メッセージで、TLTMaint がエラーなし
で完了したことが分かり、また TeaLeaf パイプラインからの別のメッセージで、キ
ャニスターへのヒットのフローが再開されたことが示されます。
60
Tealeaf トラブルシューティング・ガイド
Tealeaf が配置されて数週間経つと、LTC が大きくなっているため、TLTMaint プロ
グラムの完了にかかる時間が長くなります。そのため、この警告メッセージは、初
期インストール後に数週間は表示されないが、その後はイベント・ログの標準的な
項目になることがあります。
イベント・ログにこの警告が表示され、それが始動シーケンスの一部でない場合
は、http://support.tealeaf.com/ でサポート・ケースを入力してください。
TeaLeaf Technology Error: Data length メッセージへの対処
「TeaLeaf Technology Error Data length」メッセージに対処するには、以下の手順を
使用します。
以下のエラーを受け取る場合があります。
TeaLeaf Technology Error: Data length (xxxxxx) exceeds maximum size (yyyyyy).
Body discarded.
本体をキャプチャーするために、以下の変更を行います。
1. IBM Tealeaf CX Passive Capture Application (PCA サーバー) 構成: IBM
Tealeaf CX Passive Capture Application サーバーがある場合にのみ以下を適用し
てください。PCA Web コンソールの「パイプライン」タブで「最大応答サイ
ズ」を調整します。
v 「IBM Tealeaf Passive Capture Application PCA マニュアル」の『PCA Web
コンソール - 「パイプライン」タブ』を参照してください。
2. RealiTeaIBM Tealeaf CX サーバー構成: TealeafCaptureSocket.cfg の
[Globals] セクションで MaxDataSize を調整します。後でトランスポート・サ
ービスを再始動します。
v 「IBM Tealeaf CX 構成マニュアル」の『トランスポート・サービスの構成』
を参照してください。
注: これらの変更を完了すると、これらの大きなヒットがキャプチャーされること
によって、パフォーマンスおよびディスク使用率に悪影響が出ます。
FetchNSAT で WriteInteraction に失敗した
FetchNSAT failed in WriteInteraction メッセージとコード 160 または 127 を受
け取る場合があります。
このセクションの説明を使用して、これらのエラーの対処方法について理解してく
ださい。
FetchNSAT failed in WriteInteraction とコード -160 への対処
コード 160 の FetchNSAT failed in WriteInteraction に対処するには、セッショ
ン・タイムアウトを 1 分増やすことを検討してください (特にこのエラーが繰り返
しかつ頻繁に発生する場合)。
セッション・タイムアウトは、トリガーされたイベントによって変更することもで
きます。「IBM Tealeaf イベント・マネージャー・マニュアル」の『TEM の「イベ
ント」タブ』を参照してください。
第 1 章データの保存と再作成
61
このエラーの最も可能性が高い原因は、セッション内の次のヒットがちょうど追加
されたときに、セッションがタイムアウトになった場合です。結果として、セッシ
ョンがフラグメント化し、ヒットが新規に作成されたセッション内に配置されま
す。
FetchNSAT failed in WriteInteraction とコード -127 への対処
通常、コード -127 の FetchNSAT failed in WriteInteraction メッセージは、シ
ステムが現在サイクル・サービスまたは CanTrim 操作を完了しているときに発生し
ます。
ヒットがパイプライン内にあるときに (これはめったに発生しません) Tealeaf キャ
ニスター・サーバー・サービスで障害が発生した場合、ヒットがドロップされてこ
のメッセージが出されることがあります。
キャニスター・サービスの再始動時にのみこのメッセージが発生している場合は、
無視できます。
サービスの構成に関する追加情報
サービスの構成および管理については、「IBM Tealeaf CX インストール・マニュア
ル」を使用してください。
トランスポート・サービスのセットアップおよび管理については、「IBM Tealeaf
CX 構成マニュアル」の『トランスポート・サービスの構成』を参照してください。
サイクル・サービスについて詳しくは、「IBM Tealeaf CX インストール・マニュア
ル」の『CX システムの管理』を参照してください。
62
Tealeaf トラブルシューティング・ガイド
第 2 章 Tealeaf データベースのトラブルシューティング
インストールされている Tealeaf SQL データベースでアクセスまたはパフォーマン
スに関連した問題が発生した場合は、このセクションでのトラブルシューティング
のヒントを確認してください。問題の解決に役立つ可能性があります。
注: Tealeaf データベース・マネージャーの一部の機能では、Tealeaf データベース
をホストしている SQL Server に対するシステム管理者特権が必要です。
Tealeaf SQL データベースは、データベースのアップグレードまたは再インストー
ルに使用できる Tealeaf データベース・マネージャーを使用してインストールしま
す。これらの一部のステップでは、再インストールまたはアップグレードが必要に
なることがあります。「IBM Tealeaf CX データベース・ガイド」の『Tealeaf デー
タベース・マネージャーの使用』を参照してください。
注: Tealeaf データベース・マネージャーは、SQL レポート・データベースおよび
IBM Tealeaf cxResults データベースのインストールに使用します。キャニスター・
データベースのインストールや更新には使用できません。これらのデータベース
は、初期インストール時に Setup.exe によって処理サーバーの一部としてインスト
ールされます。これらのデータベースについて詳しくは、「IBM Tealeaf CX インス
トール・マニュアル」の『CX のインストールおよびセットアップ』を参照してく
ださい。
v キャニスター・データベースの構成について詳しくは、「IBM Tealeaf CX 構成マ
ニュアル」の『CX キャニスターの構成』を参照してください。
SQL Server 構成
このセクションのトピックでは、SQL Server 構成での問題を修正する方法について
説明します。
SQL Server に接続できない
Tealeaf が SQL Server データベースに接続できない場合は、以下のステップを試行
します。
1. SQL Server カスタム・ポート
v デフォルトでは、SQL Server はポート 1433 を listen します。このポート
は、インストール時に別の選択を行わない限り、Tealeaf のデフォルト通信ポ
ートでもあります。SQL Server 構成マネージャーを使用して、この値を確認
できます。
2. 動的ポートで接続できない
v SQL Server 実装で動的ポートが使用されている場合、Tealeaf ソリューション
をその動的ポートに同期する必要があります。 64 ページの『SQL Server 動的
ポートの使用の構成』を参照してください。
3. SQL ネットワーク・プロトコル
© Copyright IBM Corp. 1999, 2015
63
v デフォルトでは、SQL Server では、Tealeaf で使用される TCP および名前付
きパイプは有効になっていません。SQL 構成マネージャーを使用して、これ
らのプロトコルが有効になっていることを確認します。
モデル・データベース・サイズの不一致が原因でインストールに失
敗する
Tealeaf データベースのインストール時に、Tealeaf で構成されているデータベー
ス・サイズと SQL Server Management Studio で構成されているモデル・データベ
ース・サイズが不一致であることが原因で Tealeaf データベース・マネージャーが
失敗を報告することがあります。
まれに、ユーザーが SQL Server インストール済み環境のモデル・データベース・
サイズをデフォルト値の 50MB から変更する場合があります。SQL Server
Management Studio では、モデル・データベース・サイズより小さいデータベース
をインストールできません。例えば、モデル・データベース・サイズが 250MB に
設定されている場合、Tealeaf データベース・マネージャーが Tealeaf データベース
をインストールしようとすると、一部のインストールは、データベースがこの最小
制限より小さいために失敗します。
この問題は、以下のいずれかを実行することで解決できます。
1. SQL Server Management Studio のモデル・データベース・サイズを 50MB に再
構成します。詳しくは、SQL Server 製品に付属の資料を参照してください。
2. SQL Server Management Studio のモデル・データベース・サイズより少し大き
くなるように Tealeaf データベース・マネージャーのデータベース・サイズを再
構成します。上記の例では、データベース・サイズを 260MB に設定できます。
v 各データベースの個別ファイル・グループでデータベース・サイズを構成する
必要があります。「IBM Tealeaf CX データベース・ガイド」の『Tealeaf デー
タベース・マネージャー・リファレンス』を参照してください。
SQL Server 動的ポートの使用の構成
Tealeaf では、SQL Server へのアクセス時における動的ポートの使用は、ネイティ
ブにサポートされていません。 Tealeaf では、可能であれば、動的ポートの使用を
無効にすることをお勧めします。
SQL Server の始動時に、動的ポートが選択されます。操作中、このポートが使用さ
れます。再始動した場合、競合が発生しない限り、構成されているポートはそのま
まになります。
ポートを動的のままにする必要がある場合は、以下のステップを実行します。
1. すべての Tealeaf サービスを開始します。
2. データベースを開始します。
3. SQL Server Management Studio を使用して、SQL Server が使用しているポート
を確認します。
4. Tealeaf データベース・マネージャーの「接続」ダイアログで、各データベース
についてこのポートを入力する必要があります。「IBM Tealeaf CX データベー
ス・ガイド」の『Tealeaf データベース・マネージャー・リファレンス』を参照
してください。
64
Tealeaf トラブルシューティング・ガイド
5. Tealeaf データベース・マネージャーで、データベースのポートを設定できま
す。
a. TDM メニューから「モード」 > 「情報/構成 (Info/Config)」 > 「レポー
ト・サーバー構成 (Report Server Configuration)」を選択します。
b. ポートを適宜入力します。変更を適用すると、以下のレジストリー・キーが
更新されます。
v 「IBM Tealeaf CX データベース・ガイド」の『Tealeaf データベース・マ
ネージャー・リファレンス』を参照してください。
6. 必要に応じて、Tealeaf データベース・マネージャーを使用して、データベース
をインストールまたはアップグレードします。
v 「IBM Tealeaf CX データベース・ガイド」の『Tealeaf データベース・マネー
ジャーの使用』を参照してください。
レポート・サーバーで、データベースのポート番号は、以下のレジストリー・キー
内にあります。これらを更新するには、Tealeaf データベース・マネージャーの「接
続 (Connecting)」画面を使用します。
製品 (データベース)
レジストリー・キー
IBM Tealeaf cxImpact (レポート)
Tealeaf Technology > DataStore > Report Server > Port
IBM Tealeaf cxResults (訪問者)
Tealeaf Technology > DataStore > Report Server > Visitor Port
IBM Tealeaf cxReveal (検索)
Tealeaf Technology > DataStore > Database > Search > Database Port
注: 新規動的ポートを選択するように SQL Server に強制すると、Tealeaf データベ
ース・マネージャーの「接続 (Connecting)」画面でデータベースにアクセスするたび
に新規ポートを使用し、Tealeaf データベース・マネージャーで上記ステップを使用
して、該当するレジストリー・キーに新規ポートを再入力する必要があります。
新しい SQL Server へのマイグレーション
SQL Server の新規インスタンスにマイグレーションする場合は、必要なステップが
さらに存在します。
「IBM Tealeaf CX データベース・ガイド」の『 Tealeaf データベースのマイグレー
ション』を参照してください。
MDF ファイル名の要求時に復元が失敗した
データベースを SQL Server の新規インスタンスに復元したときに、以下のような
エラーが発生することがあります。
Restore failed for Server <MyServer>
Additional information:System.Data.SqlClient.SqlError: File:
’C:¥Program Files¥Microsoft SQL Server¥
MSSQL10_50.MSSQLSERVER¥MSSQL¥DATA¥RL_REPORTS.mdf’ is claimed by ’DATA’(3) and
’PRIMARY’(1). The WITH MOVE clause can be used to relocate one or more files.
(Microsoft.SqlServer.Smo)
第 2 章 Tealeaf データベースのトラブルシューティング
65
上記の問題の原因は、すべての Tealeaf データベース名を RL_REPORT.mdf に変換す
る SQL Server 復元プロシージャーです。この状態は通常、新規ロケーションのデ
ィレクトリー構造が異なる場合、またはデータベースを新規バージョンの SQL
Server に移動した場合に生じます。
解決方法としては、各データ・ファイルのファイル名を手動で追加して、ファイル
名の末尾にファイルのファイル・グループ ID を含めます。
データベースを復元するための該当するステップについて詳しくは、「IBM Tealeaf
CX データベース・ガイド」の『Tealeaf データベースのマイグレーション』を参照
してください。
64 ビット・オペレーティング・システムにおける SQL Server
のパフォーマンスが悪い
64 ビット・オペレーティング・システムでの SQL Server の低いパフォーマンスを
修正するには、以下の手順を実行します。
注: Tealeaf バージョン 8.8 以降を使用している場合、SQL Server 2005 はサポート
されなくなっています。詳しくは、「IBM Tealeaf CX データベース・ガイド」の
『サポートされる SQL Server のバージョン』を参照してください。
Tealeaf データベースは、64 ビット・オペレーティング・システムの機能を利用す
るように設計されています。ただし、Microsoft の問題のため、64 ビット・バージ
ョンの Windows で SQL Server 2005 を実行している場合、パフォーマンスの問題
が生じることがあります。問題には次のようなものがあります。
v SQL Server 2005 のパフォーマンスが突然低下する。
v SQL Server 2005 が短期間応答しなくなる。
v SQL Server 2005 に接続しているアプリケーションでタイムアウトが発生する。
v 単純なコマンドを実行した場合でも、またはシステムでアプリケーションを使用
した場合に問題が発生する。
64 ビットの Windows オペレーティング・システムが SQL Server プロセスの作業
セットをページアウトしていることが問題である可能性があります。SQL Server
2005 SP2 以降では、SQL Server のプロセスが、プロセスに割り振られているメモ
リーの 50 パーセントに到達すると、SQL Server のエラー・ログにエラー・メッセ
ージが出はじめることがあります。
問題を修正するには、以下の手順を実行します。
1. Microsoft のトラブルシューティング・ステップを確認します。詳しくは、
http://support.microsoft.com/kb/918483 の『How to troubleshoot this
problem』を参照してください。
2. 問題が解決しない場合は、Windows が SQL Server プロセスのバッファー・プ
ール・メモリーをページアウトしないようにすることができます。SQL Server
サービスの始動アカウントであるユーザー・アカウントに「メモリー内のページ
のロック」ユーザー権限を割り当てることで、メモリーをロックできます。
66
Tealeaf トラブルシューティング・ガイド
v このステップでは、オペレーティング・システムがメモリーをページアウトし
ないようにし、代わりに SQL Server がページングを実行できるようにしま
す。詳しくは、http://technet.microsoft.com/en-us/library/ms190730.aspx
を参照してください。
3. SQL Server を再始動します。
トラブルシューティング・ステップなど、このトピックについて詳しくは、
http://support.microsoft.com/kb/918483 にアクセスしてください。
SuperSocket 情報: (SpnRegister): Windows アプリケーショ
ン・イベント・ログ内のエラー 1355
SQL Server がサービス・プリンシパル名 (SPN) を登録できない場合、
「SuperSocket 情報: (SpnRegister): エラー 1355」メッセージがスローされま
す。
http://support.microsoft.com/kb/303411 に以下の説明があります。
このメッセージはエラー・メッセージではありません。このテキストは、SQL
Server がサービス・プリンシパル名 (SPN) を登録できなかったことを示す単
なる警告です。これは、使用されているセキュリティー・メカニズムが、
Kerberos ではなく、Microsoft Windows NT チャレンジ/応答 (NTLM) 認証で
あることを示しています。
原因
このメッセージは通常、SQL Server のサービス・アカウントが、SPN を登録
するために必要な権限を備えていないドメイン・ユーザーとして実行されてい
ることが原因で表示されます。
SQL Server がプロシージャー sys.sp_OAGetProperty へのアク
セスをブロックする
一部の環境では、SQL Server のエラー・ログに以下のエラーが表示されることがあ
ります。
SQL Server blocked access to procedure ’sys.sp_OAGetProperty’ of component
’Ole Automation Procedures’ because this component is turned off as part of
the security configuration for this server. A system administrator can
enable the use of ’Ole Automation Procedures’ by using sp_configure.
For more information about enabling ’Ole Automation Procedures’,
see "Surface Area Configuration" in SQL Server Books Online.
sys.sp_OAGetProperty は、システム詳細へのアクセスを許可する自動化プロシージ
ャーです。Tealeaf はこのストアード・プロシージャーを使用して、ディスク・スペ
ースに関する詳細を取得します。
注: sys.sp_OAGetProperty プロシージャーへのアクセスが有効になっていない場
合、以下のようになります。
1. ポータルにおけるデータベース・ファイル・グループ・サイズ・レポートおよび
データベース表サイズ・レポートに、フリー・スペースおよび未使用スペースの
情報が含まれません。
2. SQL Server 上で使用可能なディスク・スペースが記録されず、Tealeaf イベン
ト・ログで表示されません。
第 2 章 Tealeaf データベースのトラブルシューティング
67
このエラー・メッセージは安全です。ただし、混乱を避けるため、このストアー
ド・プロシージャーを使用する pr_ServerDiskSpace へのアクセスを拒否すること
ができます。アクセスを拒否した場合、pr_ServerDiskSpace
(sys.sp_OAGetProperty ではない) からエラー・メッセージがレポートされます。後
者のプロシージャーからのエラー・メッセージは、ハッキングや悪意のあるソフト
ウェアを示している可能性があるため、不要なメッセージは抑止する必要がありま
す。
アクセスを拒否するには、SQL Server Management Studio から以下を実行します。
use TL_STATISTICS
go
Deny execute on pr_ServerDiskSpace to TLAdmin;
Deny execute on pr_ServerDiskSpace to TLUser;
use TL_visreport
go
Deny execute on pr_ServerDiskSpace to TLAdmin;
Deny execute on pr_ServerDiskSpace to TLUser
Tealeaf データベース構成
このセクションのトピックでは、Tealeaf データベース構成での問題を修正する方法
について説明します。
接続できない
Tealeaf データベースにアクセスできない場合は、適切な完全修飾ホスト名を使用し
ていることを確認する必要があります。
名前付きデータベース・インスタンスに対して実行している場合は、ホスト名は以
下の特定の形式に従っている必要があります。
<host_name>¥<instance_name>
ここで、
<host_name> は、IP アドレス、マシン名または localhost です。
<instance_name> は、DB インスタンスの名前です。
「IBM Tealeaf CX データベース・ガイド」の『Tealeaf データベース・マネージャ
ーの使用』を参照してください。
アップグレード時に Tealeaf データベース・マネージャーで結果
セット抽出のアップグレードに失敗する
状況によっては、データベース・マネージャーが結果セット抽出のアップグレード
に失敗することがあります。
必要なビューが存在していません。RSE データベースを再作成する必要がありま
す。 71 ページの『cxResults の結果セット抽出データベース』を参照してくださ
い。
68
Tealeaf トラブルシューティング・ガイド
クラスター化サーバー環境でデータベースの作成に失敗する
クラスター化サーバー環境へのインストール中に、作成時にエラー・メッセージが
表示される場合は、クラスター・グループまたは依存関係リストの一部ではないデ
ィスクへ SQL パスを誤って指定した可能性があります。
クラスター依存問題を解決するには、http://support.microsoft.com/kb/295732を参照し
てください。
Tealeaf データベース・マネージャーで、データベース・ファイルが保管されている
パスを確認する必要もあります。リモート・サーバーへのパスが分からない場合
は、担当者にお問い合わせください。
注: パスは、SQL Server を基準とした絶対パスでなければなりません。ネットワー
ク・パスは許可されません。
「IBM Tealeaf CX データベース・ガイド」の『Tealeaf データベース・マネージャ
ーの使用』を参照してください。
Tealeaf データベース・パフォーマンス
Tealeaf データベース・パフォーマンスは、割り振られているメモリー量およびデー
タベース・フラグメント化の影響を受けることがあります。
メモリー量およびフラグメント化に関連したデータベース・パフォーマンスの問題
に対処するには、このセクションの情報を使用します。
メモリーの割り振り
いくつかの問題を解決するために、Tealeaf データベースに対するメモリーの割り振
りを調整することが必要な場合があります。
次のいずれかの状態が発生している場合は、その下に記述されている解決策を実行
します。
1. Tealeaf の実行速度が遅い
2. レポートの到着が遅延している
3. SQL Server を実行しているボックスでページングまたはディスク入出力の問題
が発生している
SQL Server に割り振られているメモリーの設定が低すぎる可能性があります。SQL
Server Management Studio で Tealeaf データベースに割り振られているメモリー量
を確認および変更できます。
フラグメント化
通常のデータ操作により、ハード・ディスク・メディアおよび保管されている
Tealeaf データベースがフラグメント化することがあります。時間の経過につれて、
ディスクのフラグメント化がパフォーマンスに大きく影響する可能性があります。
v 通常のサーバー保守の一環として、DBA は定期的に、ディスクのフラグメント化
チェックを実行し、ディスクのデフラグを実行する必要があります。
第 2 章 Tealeaf データベースのトラブルシューティング
69
Tealeaf データベースのインデックスもフラグメント化することがあります。最適な
パフォーマンスを確保するために、定期的にこれらのデフラグを実行する必要があ
ります。
注: 一般的に、データベース・インデックスのフラグメント化は、20% 未満に保つ
必要があります。
v リリース 7.1 以前: Microsoft SQL Server 管理コンソールを使用して、フラグメ
ント化チェックおよびデフラグ・タスクを実行できます。詳細については、製品
に付属の資料を参照してください。
v リリース 7.2: Tealeaf データベース・マネージャーを使用して、データベース・
インデックスのフラグメント化ステータスを検査して、必要に応じてデフラグ・
タスクを実行できます。「IBM Tealeaf CX データベース・ガイド」の『Tealeaf
データベース・マネージャーの使用』を参照してください。
システム・データベースのアップグレード時に Tealeaf データベ
ース・マネージャーがハングする
システム・データベースのアップグレード時にシステムの他のコンポーネントが実
行中である場合、Tealeaf データベース・マネージャーがハングすることがありま
す。
この状態は複数の要因が原因で発生する可能性がありますが、多くの場合、その原
因は、レポート・サーバーの Windows パイプライン内にアクティブな統計ロガ
ー・セッション・エージェントが存在することです。このセッション・エージェン
トは、パイプライン内の統計情報を収集し、ポータル・ベースのレポートで使用す
るために統計データベースにサブミットするために使用されます。
v 「IBM Tealeaf CX 構成マニュアル」の『統計ロガー・セッション・エージェン
ト』を参照してください。
アクティブなセッション・エージェントが統計データベースを開いたままにしてい
るため、Tealeaf データベース・マネージャーがそれを使用できなくなっていること
可能性があります。その場合、ハングが発生します。
考えられる解決方法
この問題を解決するために、以下のいずれかの解決方法を試すことができます。
1. データベース・マネージャーを開始する前に、トランスポート・サービスを停止
します。
注: トランスポート・サービスを停止するとすぐに、ヒットがドロップされ、デ
ータが失われます。
a. データベース・マネージャーを使用した後に、TMS を使用して必ずトランス
ポート・サービスを再始動してください。
v 「IBM Tealeaf CX 構成マニュアル」の『トランスポート・サービスの構成』
を参照してください。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『TMS の「全体ビュー」タブ』
を参照してください。
2. 処理パイプラインから統計ロガー・セッション・エージェントを削除するか、無
効にします。
70
Tealeaf トラブルシューティング・ガイド
注: Tealeaf では、オールインワン・システムでデータベース・マネージャーを
操作しているときには、統計ロガー・セッション・エージェントを無効にするこ
とをお勧めします。
a. セッション・エージェントをパイプラインから削除したら、データベース・
マネージャーを開始できます。
b. データベース・マネージャーを終了した後に、TMS を使用して必ずそれを再
び追加してください。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『TMS パイプライン・エディタ
ー』を参照してください。
3. 統計ロガー・セッション・エージェントがキャニスター内の専用子パイプライン
の一部である場合は、TMS を使用してパイプライン全体を無効にすることがで
きます。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『TMS パイプライン・エディタ
ー』を参照してください。
さまざまな Tealeaf データベースでの問題の対処
さまざまな Tealeaf データベースで発生する可能性のある問題に対処する方法を習
得するには、このセクションの情報を使用します。
cxResults の訪問者データベース
訪問者データベースは、IBM Tealeaf cxResults に適用されます。リリース 8.7 か
ら、IBM Tealeaf cxResults は、新規にライセンス交付を受ける製品として使用でき
なくなっています。リリース 8.6 以前で IBM Tealeaf cxResults のライセンス交付
を受けたお客様は、リリース 8.7 以降でも引き続き製品を使用でき、またそのサポ
ートを受けることができます。詳しくは、Tealeaf カスタマー・サポートにお問い
合わせください。
訪問者データベースのデータ接続タイムアウト設定がありますが、大きなデフォル
ト値が設定されています。これを変更する必要はありません。
訪問者データベースのデータ接続タイムアウト
訪問者データベースのデータ接続タイムアウト設定がありますが、大きなデフォル
ト値が設定されています。これを変更する必要はありません。
cxResults の結果セット抽出データベース
RSE データベースのアップグレードまたは再インストール時に、以下のエラー・メ
ッセージが出ることがあります。エラー・メッセージの後には、テーブル作成ステ
ートメントが続きます。
Failed to create the database views:
Invalid object name ’RSE_HITSTATISTICS’.
この場合、RSE データベースで一部のビューが欠落している可能性があります。こ
の場合、RSE データベースが空です。この問題を解決するには、以下のように、デ
ータベースを再作成する必要があります。
第 2 章 Tealeaf データベースのトラブルシューティング
71
1. Tealeaf データベース・マネージャーを実行します。「IBM Tealeaf CX データベ
ース・ガイド」の『Tealeaf データベース・マネージャーの使用』を参照してく
ださい。
2. 「拡張モード」を選択します。
3. 「データベース・インストール (Database Install)」タブで「作成」をクリックし
ます。
4. 「データベース・タイプ (Database Type)」ペインで「RSE」をクリックしま
す。
5. 「実行」をクリックします。RSE データベースが再作成されます。
v 生成されたエラー・メッセージを確認および監視します。
6. 再インストールの完了後に、データベースをアップグレードできます。「IBM
Tealeaf CX データベース・ガイド」の『Tealeaf データベース・マネージャーの
使用』を参照してください。
cxReveal データベースのインストールで照合設定が強制される
IBM Tealeaf cxReveal 検索データベースをインストールしようとした場合、データ
ベース照合設定が以下に強制されることがあります。
SQL_Latin1_General_CP1_CI_AS
SQL Server の照合設定に関係なく、この設定が構成されます。これは、海外 (特に
ヨーロッパ) のユーザーの場合に問題になります。
解決方法としては、Tealeaf データベース・マネージャーを使用して、TL_SEARCH デ
ータベースをドロップして再インストールします。
注: 開始する前に、システム・データベース (TL_SYSTEM) およびレポート・データ
ベース (TL_REPORTS) がインストールされていて、インストールする TL_SEARCH デ
ータベースのバージョンにアップグレードされていることを確認してください。
1. ポータル・サーバーで、Tealeaf データベース・マネージャーを開始します。
2. TDM メニューで「モード」 > 「データベース・セットアップ (Database
Setup)」 > 単一データベース・モード (Single Database Mode)」を選択しま
す。
3. 以下のように、検索 (TL_SEARCH) データベースをドロップします。
a. 「単一データベース・オプション (Single Database Options)」画面で「データ
ベース」ドロップダウンから「検索」を選択します。
b. 「アクション」ドロップダウンで、「アンインストール (Uninstall)」を選
択します。
c. 「OK」をクリックします。
d. データベースがアンインストールされます。
4. 検索データベースを作成します。
a. 以下の場所で提供されている検索データベース作成スクリプトを使用しま
す。
<Tealeaf_install_directory>¥SQL¥DBCreateScripts¥CREATE_TL_SEARCH.sql
b. Tealeaf データベース・マネージャーを開始します。
72
Tealeaf トラブルシューティング・ガイド
c. TDM メニューで「モード」 > 「データベース・セットアップ (Database
Setup)」 > 単一データベース・モード (Single Database Mode)」を選択しま
す。
d. TDM メニューで「DB 作成 (DB Creation)」 > 「データベースの作成
(Create Databases)」を選択し、当該オプションが選択されないようにしま
す。
e. 「単一データベース・オプション (Single Database Options)」画面で「データ
ベース」ドロップダウンから「検索」を選択します。
f. 「アクション」ドロップダウンから、「インストール (Install)」を選択し
ます。
g. 「OK」をクリックします。
5. 適切な照合設定を使用して、検索データベースがインストールされます。
6. さらにインストール操作を実行する場合は、「データベースの作成 (Create
Databases)」オプションを再有効化できます。TDM メニューで「DB 作成 (DB
Creation)」 > 「データベースの作成 (Create Databases)」を選択し、当該オプ
ションが選択されるようにします。
構成の問題
データベース構成およびデータ収集に関する問題をトラブルシューティングするに
は、このセクションの情報を使用します。
データ収集のパフォーマンスが低い
データ収集プロセスが大量のメモリーを消費している場合、または終了に失敗して
いる場合は、データ収集プログラムのバッチ・サイズ設定を調整する必要が生じる
ことがあります。この設定は、単一のバッチでデータ収集プログラム用に抽出また
はロードするレコードの最大数を定義します。デフォルト値は 2000 に設定されて
います。
注: この値を 5000 以上に変更しないでください。
「IBM Tealeaf cxImpact 管理マニュアル」の『CX 設定』を参照してください。
データ収集時間が長い
通常、データ収集は、5 分未満で実行されます。データ収集プロセスが 10 分を超
えている場合、データ・トリム間隔設定のサイズを大きくする必要があります。
デフォルト値は「1 - 毎時」です。これを大きい値に設定することで、このプロセ
スの実行の頻度が下がります。ただし、データベースのサイズの一時的なスパイク
が生じます。
「IBM Tealeaf cxImpact 管理マニュアル」の『CX 設定』を参照してください。
データベース接続タイムアウト
Tealeaf データベースで繰り返しタイムアウトが発生している場合は、データベース
接続タイムアウト設定を調整する必要が生じることがあります。デフォルトの接続
第 2 章 Tealeaf データベースのトラブルシューティング
73
タイムアウトは 30 秒に設定されます。しばらくシステムが実行されていて、トラ
フィックが増加した場合、現在の設定でご使用のハードウェアがトラフィック・レ
ベルに対応できない可能性があります。
この値を現在の値の 2 倍に設定してみてください。再発する場合は、さらに 2 倍
してください。
注: 300 秒 (5 分) を超える接続タイムアウトを設定する必要がある場合は、ご使用
の環境にさらに問題がある可能性があります。
「IBM Tealeaf cxImpact 管理マニュアル」の『CX 設定』を参照してください。
複数のキャニスターからのデータ収集パフォーマンス
デフォルトでは、Tealeaf は 2 つのキャニスターから同時に収集できます。ご使用
の環境にさらにキャニスターがある場合は、「データ収集 - 同時最大数」設定のサ
イズを大きくすることができます。適切な設定は、ご使用のハードウェア環境によ
って異なります。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『CX 設定』を参照してください。
以下のいずれかに気付いた場合:
1. データ収集がスローダウンしている
2. データ収集プロセスでエラーがある
3. キャニスターがビジーである
その場合は、この設定を小さくしてみてください。
データベースが大きくなりすぎる
データベースのサイズがストレージの制限に近づいている場合、設定の調整を検討
できます。
1. ページ・パフォーマンス・レポートを使用していない場合は、パス統計を収集す
る必要はありません。パス統計の収集を無効にすることで、かなりのデータベー
ス・スペースを節約できます。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『CX 設定』を参照してくださ
い。
2. SQL Server Management Studio で、各データベースのリカバリー・モデル設定
を確認します。リカバリー・モデルが「フル (Full)」に設定されている場合
は、データベースおよびそのログ・ファイルは大きくなる可能性があります。
「IBM Tealeaf CX データベース・ガイド」の『データベースのサイズ変更』を
参照してください。
エラー - 既存の接続がリモート・ホストによって強制的に閉じら
れた
このエラーが頻繁に発生する場合は、ここで説明されているように、ログ情報を確
認する必要があります。
ときどき、データ収集プログラムが以下のログ・メッセージを登録することがあり
ます。
74
Tealeaf トラブルシューティング・ガイド
An existing connection was forcibly closed by the remote host
このエラーは、SQL Server またはそれをホストしているサーバーが予期せず接続を
閉じたことを示しています。通常、SQL Server が再始動されたか、既存のすべての
接続を閉じる必要がある操作 (バックアップやリストア操作など) が実行された場合
です。
このようなエラーが散発的に発生する場合は、データ収集やデータの妥当性に影響
しません。
注: このようなエラーが頻繁に発生している場合は、データ収集が実際に実行され
ているかを確認してください。ポータルを使用して実行された最新のデータ収集プ
ログラムのログ情報を確認できます。「IBM Tealeaf cxImpact 管理マニュアル」の
『ポータル・ログ』を参照してください。
訪問者データベース抽出
訪問者データベース抽出は、セッション・データをデータベースから抽出して訪問
者データベース用にステージング・テーブルに挿入するために使用します。このセ
クションでは、VDB 抽出での問題をトラブルシューティングする方法に関する推奨
を示します。
v 「IBM Tealeaf CX 構成マニュアル」の『スケジューリング・サービスの構成』を
参照してください。
訪問者を検索できません
訪問者データベースの検索を完了できない場合、または結果が更新されなくなった
場合は、訪問者データベース抽出ジョブが無効になっている可能性があります。
このジョブの有効化について詳しくは、「IBM Tealeaf CX 構成マニュアル」の『ス
ケジューリング・サービスの構成』を参照してください。
エラー・コード 12029 がレポートされる断続的な検索サーバー接
続エラーの対処
サーバーへの接続を確立できなかったことを示すメッセージが含まれたエラーを検
索サーバーが定期的に返すことがあります。
以下は、メッセージの例です。
An error occurred while executing the search.
<ServerName> - Error: (12029) A connection with the server could
be established
サーバー接続エラーをトラブルシューティングするには、以下のトピックの手順を
実行します。
VDB ログオンでの TCP 接続エラー (Windows Server 2003 SP2)
VDB 抽出プロセスがセッションの処理に失敗し、
TL_VDB_Extractor_<TIMESTAMP>.log に以下の一般フォーマットのエラーが表示され
る場合があります。
第 2 章 Tealeaf データベースのトラブルシューティング
75
Extract from canister failed after <number of tries> retries.
CanisterId: <Canister Id>. Exiting.
上記の場合、キャニスター読み取りエラーの最大数に達すると、Windows Server
2003 SP2 で実行されている訪問者データベース抽出が抽出を進めることができなく
なります。
この問題は、Windows Server 2003 SP2 にのみ適用されます。原因は、複数の問題
のいずれかの可能性があります。以下に、問題の根本原因の診断に役立つステップ
について説明します。
以下の手順を実行してください。
1. Windows コマンド・ライン・シェルから、検索サーバーをホストしているリモ
ート・サーバーで以下のコマンドを実行します。
netstat -an | findstr 19000
v 上記のコマンドは、検索サーバーで使用されるデフォルト・ポートであるポー
ト 19000 を介したソケット接続のネットワーク・ステータスを検査します。
検索サーバーが別のポートを使用している場合は、この値を変更してくださ
い。「IBM Tealeaf cxImpact 管理マニュアル」の『Tealeaf サーバーの管理』
を参照してください。
2. netstat コマンドから返された結果に、FIN_WAIT または LAST_ACK 状態の複数
のソケットが含まれている場合、検索サーバーは、リモート TCP クライアント
に前に送信された接続終了要求に対して、まだ確認応答していません。これらの
ソケットが占有されていて、TCP/IP ポートの枯渇を引き起こしている可能性が
あります。検索サーバーにさらに接続することができなくなり、検索サーバーが
フリーズして使用不可の状態になることがあります。
3. サーバーの構成方法の問題によって解決方法がもたらされることがあります。こ
の問題に対する Microsoft の解決方法について詳しくは、http://
support.microsoft.com/kb/979230 のホット・フィックスを参照してください。
4. ホット・フィックスを適用した後に、検索サーバーをホストしているサーバーを
リブートします。
データベース・アップグレードのトラブルシューティング
1 つ以上の Tealeaf データベースのアップグレード時に、以下のようなエラーを受
け取ることがあります。
Invalid filegroup <name> specified.
ここで、<name> はデータベース・ファイル名です。
このエラーは、データベース・ファイル <name> が欠落していることを示していま
す。この問題を修正するには、そのファイルが含まれるデータベースに単一のファ
イル・グループが含まれることになっているかどうかを判別する必要があります。
注: 単一のファイル・グループが含まれる Tealeaf データベースは、TL_REPORTS デ
ータベースのみです (データベースが、Tealeaf のリリース 4.x バージョンからアッ
プグレードされた場合)。その他のすべての Tealeaf データベースには、複数のファ
イル・グループが含まれています。
76
Tealeaf トラブルシューティング・ガイド
データベースに単一のファイル・グループが含まれる場合、Tealeaf データベース・
マネージャーを使用してデータベースを再インストールします。
データベースに複数のファイル・グループが含まれる場合、ファイル・グループが
欠落していることはデータベース破壊を示し、データベースの再作成またはバック
アップからのリストアが必要なことがあります。
データベースのアップグレード時における無効なファイル・グルー
プ指定エラー
1 つ以上の Tealeaf データベースのアップグレード時に、以下のようなエラーを受
け取ることがあります。
Invalid filegroup <name> specified.
このエラーは、データベース・ファイル (<name>) が欠落していることを示していま
す。
この問題を修正するには、そのファイルが入っているデータベースに単一のファイ
ル・グループが含まれることになっているのかどうかを判別する必要があります。
データベースに単一のファイル・グループが含まれる場合
注: 単一のファイル・グループが含まれる Tealeaf データベースは、TL_REPORTS デ
ータベースのみです (データベースが、Tealeaf のリリース 4.x バージョンからアッ
プグレードされた場合)。その他のすべての Tealeaf データベースには、複数のファ
イル・グループが含まれています。
Tealeaf データベース・マネージャーを使用してデータベースの再インストールを試
行します。「IBM Tealeaf CX データベース・ガイド」の『Tealeaf データベースの
インストール』を参照してください。
データベースに複数のファイル・グループ (欠落しているものを含む) が含まれてい
る場合は、以下のようにします。
データベースが単一ファイル・グループ・データベースでない場合は、ファイル・
グループが欠落していることは、データベース破壊を示しています。この重大な問
題が発生した場合、データベースを再作成するか、バックアップからリストアする
必要が生じることがあります。
v 詳しくは、Tealeaf http://support.tealeaf.com にお問い合わせください。
チェックリスト
Tealeaf データベースでまだ問題が発生している場合は、システムの以下の情報を取
得します。
1. レポート・サーバー/SQL Server を実行しているボックスのフルスペック
(CPU、RAM、各ハード・ディスクに関する情報など) を取得します。ドライブ
情報には、ドライブ数、各ドライブの内容、および使用可能なディスク・スペー
スが含まれている必要があります。
2. 使用中の Tealeaf のバージョンを取得します。後続の Tealeaf リリースで改善さ
れていることがあります。
第 2 章 Tealeaf データベースのトラブルシューティング
77
3. トラフィック・ロードはどれくらいですか? 1 日当たりのページ数はどれくらい
ですか? 1 ページ当たりのイベント数はどれくらいですか? 1 セッション当たり
のページ数はどれくらいですか?
4. ポータル全体が遅いのですか、それともポータルの特定の項目が遅いのですか?
v 後者の場合は、問題は恐らく、個別項目のコードまたは構成の問題が原因で発
生しています。
5. ログ・レベル = 9 を設定します。1 日分または 2 日分の
TealeafReportingSvc.log メッセージを取得します。
v この情報は、トラブルシューティングをするときに役に立ちます。
6. SQL Server で、「パフォーマンス・モニター (Performance Monitor)」を開きま
す。5 から 10 分間、平均ディスク・キューおよび 1 秒当たりのページのカウ
ンターを監視します。
いずれかが一貫して大きい値に保たれていますか?
v ボックスにおいてページングが多いことが、「パフォーマンス・モニター
(Performance Monitor)」で示されていますか? これは、データ・サービスで
メモリーが枯渇していることを示している可能性があります。
7. TL_REPORTS データベースの大きさはどれくらいですか?
上記の情報を取得した後に、http://support.tealeaf.com でサポート・チケットをオープ
ンします。
キャニスター・パフォーマンスの調整
システム・ハードウェア、Web トラフィック、および構成オプションによっては、
STC はバックログを持つようになり、許可されたすべてのメモリーを使い切り、後
で処理するために DecoupleEx パイプライン・エージェントを介して着信ヒットを
ディスクにスプーリングし始めることがあります。このセクションでは、高メモリ
ー使用状態を処理するためのガイドラインを示します。
Tealeaf 短期キャニスター (STC) は、Web アプリケーションのアクティブ・セッシ
ョンからのセッション・データを処理するためのメモリー内データ・ストアです。
セッションの終了またはタイムアウト時に、データは短期キャニスターから長期キ
ャニスターに移動され、ディスク上に保管されます。
v Tealeaf キャニスターは、c-tree データベース・ソリューションに依存していま
す。詳しくは、http://www.faircom.comを参照してください。
キャニスター・ステータスのモニター
Tealeaf ポータルを使用して、DecoupleEx システム・ステータス・レポートでキャ
ニスター・ステータスをモニターできます。
1. Tealeaf ポータル・アプリケーションに管理者としてログインします。
2. システム・レポートの下に、以下のキャニスター・ステータスおよび
DecoupleEx ステータスのレポートがあります。
v キャニスター・ステータス: 現在の Web トラフィックおよび STC メモリー/
ディスク使用量に関する情報を示します。
v DecoupleEx ステータス: 現在の DecoupleEx ステータスおよびスプーリング
に関する情報を示します。
78
Tealeaf トラブルシューティング・ガイド
v 「IBM Tealeaf cxImpact 管理マニュアル」の『システム・ステータス』を参照
してください。
DecoupleEx のシステム・ステータス・レポートで、各処理サーバーの「キャニスタ
ー・ステータス」値を検索します。
「キャニスター:スプーリング」ステータス
このステータスは、キャニスターが 1 つ以上のパフォーマンスしきい値を超過し、
DecoupleEx が着信ヒットのスプーリングを開始したことを示しています。
この状態では、キャニスターは、メモリー内に既にあるデータを処理中であり、キ
ャニスターに到着した新規データは、後から読み取ってキャニスターに入れるため
にディスク・スプールに書き込まれます。
v DecoupleEx セッション・エージェントの「パーシスタンス (Persistence)」設定
が有効になっていれば、サービスを再始動した場合、またはリブートした場合、
スプールされたデータはディスクに保持されます。
v 「パーシスタンス (Persistence)」が無効になっている場合は、DecoupleEx を実
行するトランスポート・サービスが開始されると、ディスク・スプールは削除さ
れます。
v 「IBM Tealeaf CX 構成マニュアル」の『拡張デカプラー・セッション・エージェ
ント』を参照してください。
DecoupleEx システム・ステータス・レポートで、キャニスターの理由による高メモ
リー使用率が示されている場合、おそらく、キャプチャーされた Web トラフィッ
クにサージがあったことが原因と思われます。Tealeaf システム設定を調整してキャ
ニスターのデータ・スループットを大きくすることはできますが、そのような変更
によってスループットが十分に大きくなるのは、スプールされたバックログが、指
定されたセッション・タイムアウトよりも相当長い期間を表している場合のみで
す。例えば、「セッション・アイドル秒数 (Session Idle Seconds)」設定が 300
秒になるようにキャニスターが構成されている場合、キャニスター設定の再構成を
効果的にするには、スプールされたバックログの期間が 1 時間を超えていなければ
なりません。
v 「IBM Tealeaf CX 構成マニュアル」の『CX キャニスターの構成』を参照してく
ださい。
v セッション・タイムアウト設定の構成について詳しくは、 84 ページの『セッショ
ン・タイムアウトの設定』を参照してください。
「キャニスター:リアルタイム」ステータス
STC は、着信ヒットをリアルタイムに処理するために使用可能です。
「キャニスター:該当なし」ステータス
現在、キャニスター・ステータスは使用不可です。
キャニスターがオフラインになっているか、データを処理する準備ができていない
可能性があります。
第 2 章 Tealeaf データベースのトラブルシューティング
79
キャニスター・スプーリング
スプーリング時には、キャニスター・マネージャー・サービスおよびその子プロセ
スは引き続き、短期キャニスターに挿入されたデータを処理します。
DecoupleEx がヒットをキャニスターに入れるフローを停止した場合、セッションが
タイムアウトになり始め、短期キャニスターから移動されるため、c-tree メモリー使
用率は徐々に低下します。
c-tree メモリー使用率レベルが事前定義のしきい値未満に低下すると、DecoupleEx
は再度、短期キャニスターへのデータの挿入を開始します。この状態は、
DecoupleEx システム・ステータス・レポートで Canister:Real-Time として表示さ
れます。
v メモリー使用率レベルは、拡張デカプラー・セッション・エージェントのパラメ
ーターで構成できます。『c-tree メモリー使用率の構成』を参照してください。
スプールされたデータのボリュームが短期キャニスターのメモリー容量を超過して
いる限り、キャニスターは、「リアルタイム」状態と「スプーリング」状態の間を
行き来します。また、ポータルのアクティビティー・レポートは、Web サイト・ア
クティビティーが実際のキャプチャー時間よりも遅く発生していることを示しま
す。その理由は、これらの統計は、STC プロセスによるキャニスターへの挿入後に
記録されるためです。これらのアクティビティー・レポートでは、スプーリングが
原因で、数時間、予期されるより小さいカウントが示されることはよくあることで
す。レポートでのこのような不自然な低アクティビティー期間から数時間は、通常
より大きいカウントが示されることがあります。これは、より高速に (通常、拡張
デカプラー・セッション・エージェントで構成されている最大安全速度で)、スプー
ルされたヒットがスプールからキャニスターに再挿入されていたためです。
スプーリングが行われる場合、十分な期間、低 Web トラフィック期間中の動作を
特定するために、キャニスター・ステータスを観察する必要があります。このよう
な期間中に、キャニスターは追いつく必要があります。古いスプール・ファイルの
処理中にも新規スプール・ファイルが作成され続けます。これは、新規スプール・
ファイルを作成可能になる前に最後のスプール・ファイルが消費されるのに十分な
長い期間、スプール・データの消費速度が作成速度を超過するまで、スプーリング
が停止しないためです。
スプーリングが慢性的な状態になった場合、根本原因に応じて、以下の解決方法の
いずれかにより、問題を緩和できます。
v ワークロードの削減
v スループットの最適化
v より高速/大規模な Tealeaf ハードウェア・クラスターの作成
c-tree メモリー使用率の構成
拡張デカプラー・セッション・エージェントの構成で、セッション・エージェント
がディスクへの着信ヒットのスプーリングを開始し、セッション・エージェントが
スプーリングの開始後にキャニスターへのヒットの送信を再開するキャニスター・
メモリーしきい値 (パーセント) を定義できます。
v これらの設定は、TMS のパイプライン・エディターを使用して構成できます。以
下の「表示名」列に、変更する DecoupleEx セッション・エージェントのパラメ
80
Tealeaf トラブルシューティング・ガイド
ーターがリストされています。「IBM Tealeaf cxImpact 管理マニュアル」の
『Tealeaf 管理システム』を参照してください。
v これらのパラメーターは、TealeafCaptureSocket.cfg ファイルの [DecoupleEx]
セクションで構成できます。「内部名」列に、変更するパラメーターがリストさ
れています。
表 2. キャニスター・スプーリング
表示名
内部名
説明
使用されて
いるキャニ
スター・メ
モリーの最
大 %
(Canister
Max %
Memory
Used)
CanCheckMaxCtreeMemUsedPct
Tealeaf キャニスター・サーバーによ
って割り振られたメモリーの最大許容
パーセント。0 に設定すると、キャッ
シュ値が無視され、
CanCheckMinCtreeMemUsedPct 設定も
無視されます。
使用されて
いるキャニ
スター・メ
モリーの最
小 %
(Canister
Min %
Memory
Used)
CanCheckMinCtreeMemUsedPct
v デフォルト値は 80 % です。
使用中の FairCom キャッシュの最小
パーセントを指定します。
v この値が検査されるのは、
CanCheckMaxCtreeMemUsedPct 設定
が有効になっている場合のみです。
v 最大値を超過した場合、最小値に達
するまで、拡張デカプラーがヒット
をキューに入れます。
v デフォルト値は 50 % です。
「IBM Tealeaf CX 構成マニュアル」の『拡張デカプラー・セッション・エージェン
ト』を参照してください。
キャニスター・スプーリングおよびアーカイブ・マネージャー
注: リリース 7.1 で、アーカイブ・マネージャーは非推奨になりました。
v リリース 7.0 以前: アーカイブ・マネージャーを使用している場合、スプーリン
グにより、ある日のデータがまだスプールにある場合、その日のアーカイブが遅
延することがあります。その日のセッション・データの処理は、次の日まで遅延
されます。通常、この問題は致命的ではありません。ただし、次のスケジュール
されたアーカイブ・プロセスの前にスプールされたすべてのデータをキャニスタ
ーに再挿入できるように、Web トラフィック・レベルが十分に低下するかどうか
を評価する必要があります。
データ・スプールが 24 時間以内にクリアされない場合、アーカイブ・プロセスは
複数の日にわたって延期されることがあります。
回避策:
v archiver.cfg で CanisterKeepDays の値を 1 だけ大きくすることができます。
この設定は、キャニスター・データ・ファイルが処理サーバーに保持される日数
を示します。この日数が経過すると、アーカイブ・マネージャー・サービスがそ
のファイルを取得しようとします。この値を大きくすると、このエラーがなくな
第 2 章 Tealeaf データベースのトラブルシューティング
81
るはずです。ただし、追加日のデータを保管するのに十分なスペースが処理サー
バー上のストレージに存在する必要があります。
v archiver.cfg の LockOutPeriod 値を大きくして、データがキャプチャーされた
翌日の遅くにアーカイブが開始されるようにすることができます。ただし、Web
トラフィックが当日に増加し始めたときにアーカイブ・プロセスがまだ実行中で
あるため、処理サーバーに負担をかける可能性があります。
キャニスター設定の適用
注: キャニスター設定を変更してトランスポート・サービスを再始動した後に、キ
ャニスターが稼働中になるまで、ヒットがスプールされることがあります。状況に
よっては、拡張デカプラー・セッション・エージェントが、キャニスターが再始動
されたことを示す通知を受け取らず、キャニスターがヒットを受け取る準備ができ
ているのにもかかわらず、ヒットがスプールされ続けることがあります。この場
合、すべての Tealeaf サービスの再始動が必要になります。「IBM Tealeaf CX 構成
マニュアル」の『CX キャニスターの構成』を参照してください。
Tealeaf サイジング計算のためのメトリック
大幅なスプーリングなしで Web トラフィックを処理するために Tealeaf キャニス
ターに必要なサイジングを計算するためにメトリックを使用できます。
必要なサイジングを計算するのに以下のメトリックが役に立ちます。
注: これらの値は、ディスク・ストレージおよびデータベースのサイズ変更用に計
算するためにも役立ちます。
DecoupleEx ログに基づいて、ピーク値を計算できます。これらのファイルは以下の
ファイルに保管されます。
<Tealeaf_logs_directory>¥CSS_*
ここで、
<Tealeaf_logs_directory> は、DecoupleEx 構成で指定されます。「IBM Tealeaf
CX 構成マニュアル」の『拡張デカプラー・セッション・エージェント』を参照して
ください。
以下の表に、パフォーマンス/サイズ変更のメトリックを示します。システム要件を
評価する上で、サイズ変更の計算に必要な絶対最小情報は、最初の 2 つの項目で
す。他の情報は、より正確な評価を提供します。
v アクティビティー・レポートは、Tealeaf ポータルで使用可能です。「IBM
Tealeaf レポーティング・ガイド」の『Tealeaf レポート・ビルダー』を参照して
ください。
メトリック
データ・ソース
1 日当たりの平均セッション (または訪問) 数
ポータル・アクティビティー・レポートのセッション・カウント・レポート
を参照してください。妥当な日数にわたって、この値を平均化してくださ
い。
82
Tealeaf トラブルシューティング・ガイド
1 日当たりの平均ページ・ビュー数
ポータル・アクティビティー・レポートのページ・ビュー・カウント・レポ
ートを参照してください。妥当な日数にわたって、この値を平均化してくだ
さい。
1 日当たりの平均ヒット数
ポータル・アクティビティー・レポートのヒット・カウント・レポートを参
照してください。妥当な日数にわたって、この値を平均化してください。
平均セッション期間
ポータル・アクティビティー・レポートのセッション期間レポートを参照し
てください。妥当な日数にわたって、この値を平均化してください。
平均ページ・サイズ
ポータル・アクティビティー・レポートのページ・サイズ・レポートを参照
してください。妥当な日数にわたって、この値を平均化してください。
注: 可能であれば、Tealeaf 参照ディメンション値でフィルターに掛けて、
レポートからイメージ・ファイルおよび他の静的コンテンツを削除してくだ
さい。
セッション当たりの平均ヒット/ページ数
ポータル・アクティビティー・レポートのセッション平均ヒット・レポート
を参照してください。妥当な日数にわたって、この値を平均化してくださ
い。
ピーク時間におけるセッション数
ポータル・アクティビティー・レポートのセッション・カウント・レポート
を参照してください。ピーク日のピーク時間を使用してください。
v 代わりとして、DecoupleEx ログ・ファイルを使用できます。このファイ
ルの場所は、前にリストされています。
ピーク時間におけるページ・ビュー数
ポータル・アクティビティー・レポートのページ・ビュー・カウント・レポ
ートを参照してください。ピーク日のピーク時間を使用してください。
v 代わりとして、DecoupleEx ログ・ファイルを使用できます。このファイ
ルの場所は、前にリストされています。
ピーク時間におけるヒット数
ポータル・アクティビティー・レポートのヒット・カウント・レポートを参
照してください。ピーク日のピーク時間を使用してください。
v 代わりとして、DecoupleEx ログ・ファイルを使用できます。このファイ
ルの場所は、前にリストされています。
永続化される日数
この設定は、キャニスター構成で定義されます。「IBM Tealeaf CX 構成マ
ニュアル」の『CX キャニスターの構成』の「データを保持する日数
(Number of Days to Retain Data)」を参照してください。
セッション・タイムアウト
この設定は、キャニスター構成で定義されます。「IBM Tealeaf CX 構成マ
ニュアル」の『CX キャニスターの構成』の「セッション・アイドル秒数
(Session Idle Seconds)」を参照してください。
第 2 章 Tealeaf データベースのトラブルシューティング
83
伸張係数
このメトリックとして、データ・ボリュームの期待される伸張または測定さ
れた伸張のいずれかを使用できます。
注: 上記情報を取得した後に、システムの正常性およびハードウェア要件を評価す
るために、Tealeaf Professional Services にお問い合わせください。
セッション・タイムアウトの設定
短期キャニスターは、キャニスターの「セッション・アイドル秒数 (Session Idle
Seconds)」設定に基づいてセッションを終了するタイミングを決定します。
「セッション・アイドル秒数 (Session Idle Seconds)」の値を超える期間、あるセ
ッションについてキャニスターに新規ヒットが挿入されなかった場合、STC はその
セッションを閉じ、ダウンストリーム処理用のフラグを立てます。このタイムアウ
ト方式は、標準的な Web アプリケーションの手法に似ています。
v この設定の構成について詳しくは、「IBM Tealeaf CX 構成マニュアル」の『CX
キャニスターの構成』を参照してください。
以下の 2 番目の設定が、セッションを終了するタイミングの決定に関与することが
あります。
v イベントの発生に基づいてセッションを閉じるようにイベントを定義できます。
例えば、Web アプリケーションにログアウトのリンクまたはボタンがある場合、
そのリンクまたはボタンが押されたときにトリガーされるセッション終了イベン
トを定義できます。
v STC を保護するために、トランスポート・サービスのキャニスター・パイプライ
ン・エージェントは、セッションのサイズおよび期間に制限を課します。デフォ
ルトでは、これらの制限は、2048 件の合計ヒット、5MB の合計メモリー、およ
び 1 時間の合計セッション期間に設定されています。上記の設定のいずれかを変
更した後には、トランスポート・サービスを再始動する必要があります。
– 合計セッションの設定について詳しくは、「IBM Tealeaf CX 構成マニュア
ル」の『CX キャニスターの構成』を参照してください。
セッションのフラグメント化の原因
Tealeaf セッションはフラグメント化される場合があります。セッションのフラグメ
ント化の原因を以下に示します。
セッションのフラグメント化は、以下の条件により発生します。
v Tealeaf 非アクティブ・タイムアウト期間が超過した場合に、訪問者のセッション
がフラグメント化されます。例えば、訪問者が昼食時に Web ページを開いたま
まにし、昼食後に同じブラウザー・ウィンドウで再びブラウズすると、フラグメ
ント化されたセッションが生じることがあります。非アクティブ期間が長いた
め、最初の数ページが短期キャニスター (STC) から長期キャニスター (LTC) に
移動されます。昼食後に続くページは STC 内に配置され、固有のセッション・
フラグメント ID が付与されます。ただし、新規セッションは同じブラウザー・
ウィンドウであるため、TLTSID セッション Cookie 値は変更されません。
v 3 つの「安全」制限 (期間、ヒット数、バイト) のいずれかを超過した訪問者セッ
ションは、STC スペースを無用に消費することを防止するために、STC から
84
Tealeaf トラブルシューティング・ガイド
LTC に移動されます。セッションが LTC に移動された後に、同じ TLTSID の
次のヒットにより、STC 内に新規セッション・フラグメントが生成されます。
v キャニスター・サービスが保守のためにシャットダウンされるときに開いていた
セッションは、LTC に移動されます。同じ TLTSID の後続のヒットにより、STC
に新規セッション・フラグメントが作成されます。
Tealeaf サービスが TLUSER または ADMIN としてキャニスターに接続す
るための基本キャニスター・ファイルの再作成
キャニスター・データ・ストア内に TLUSER/ADMIN ユーザー ID が存在しない場
合、他の Tealeaf サービスはキャニスターに接続できません。そのような場合に
は、基本キャニスター・ファイルを再作成し、既存のキャニスター・セッションお
よび検索インデックス・データを保存する必要があります。
以下のステップでは、基本キャニスター・ファイルを再作成し、既存のキャニスタ
ー・セッションおよび検索インデックス・データを保存します。
1. すべての Tealeaf サービスを停止します。
2. CANISTER.dbs ディレクトリーを CANISTER.dbs.old に名前変更します。
3. Indexes ディレクトリーを Indexes.old に名前変更します。
4. CanRebuild.exe を実行し、完全なキャニスターのみを再作成することを選択し
ます。
5. Indexes.old ディレクトリーを名前変更して Indexes に戻します。
6. 以下のファイルを CANISTER.dbs.old から新規の CANISTER.dbs ディレクトリー
に移動します (コピーしないでください)。
LSSN * PEVT * NDLY.dat LDLY.dat PATH.dat SRVR.dat EVNT.dat SEVT.dat
7. すべての Tealeaf サービスを開始します。
キャニスター・サービスが再始動され続ける
Windows の「コントロールパネル」の「サービス」を使用してキャニスター・サ
ービスを無効にしても、サービスが再始動され続ける場合は、ネットワーク・モニ
ターおよびインフラストラクチャー診断ツール (Big Brother など) がこの再始動を
実行していないかを確認する必要があります。
キャニスター・ストレージ割り振りの評価
単一のキャニスターを使用して Web サイトの複数のサイトまたは領域をモニター
している場合、以下のプロセスを使用して、各サイトのキャニスター・ストレージ
要件を評価できます。
注: 以下のステップでは、各個別サイトまたは領域を識別するために参照ディメン
ションが正しく構成されているものと想定しています。「IBM Tealeaf CX イベン
ト・マネージャー・マニュアル」の『Tealeaf イベント・マネージャー』を参照して
ください。
1. キャニスター・ストレージ・デバイスで、1 日当たりに使用されている合計スト
レージ・スペース量を判別します。
第 2 章 Tealeaf データベースのトラブルシューティング
85
2. Tealeaf ポータルで、「Tealeaf」 > 「システム・ステータス」 > 「キャニスタ
ー」を選択します。
3. 合計セッション・カウントに対する各ホストのセッション・カウントの比率によ
り、使用されているスペース量の大まかな見積もりが得られます。
特定のホストからのセッションが平均より相当大きい場合、この見積もりは正確で
はない可能性があります。しかし、見積もりとしては十分なものになります。
キャニスター・セッション・エージェント・パフォーマンスの評価
キャニスター・セッション・エージェントでは、複数のスレッドがサポートされま
す。これにより、複数の Tealeaf パイプラインを介して短期キャニスターにヒット
をルーティングすることで、ヒット挿入レートを上げることができます。パイプラ
インを追加する前に、現在のキャニスター挿入パフォーマンスを評価する必要があ
ります。
通常、キャニスター・セッション・エージェントのボトルネックは、STC メモリー
の使用を改善するためにヒットを圧縮しているときに発生します。セッション・エ
ージェントのパフォーマンス統計の表示を有効にすることで、ヒット挿入レートお
よび圧縮レートをモニターできます。
TealeafCapturesocket.cfg のキャニスター・セッション・エージェント構成セクシ
ョンで、以下のプロパティー値を設定します。
DisplayPerf=true
このオプションにより、Tealeaf パイプライン・ステータス・レポートの「キューに
登録済み」フィールドへのセッション・エージェントの最大処理レートの出力が有
効になります。
v Tealeaf パイプライン・ステータスについて詳しくは、「IBM Tealeaf cxImpact 管
理マニュアル」の『Tealeaf 管理システム』を参照してください。
有効になっている場合、以下に示すように、レポート内のキャニスター・セッショ
ン・エージェントの「キューに登録済み」フィールドに、30360558 のような数値が
表示されます。
86
Tealeaf トラブルシューティング・ガイド
この数値を使用して、キャニスター・セッション・エージェントにボトルネックが
あるかどうか、および必要なヒット・レートを提供するために必要なパイプライン
の数を判別できます。数値 30360558 では、下 4 桁が STC への最大圧縮レートを
示しており、上 4 桁または 5 桁がセッション・エージェントへの最大挿入レート
を示しています。上記の例では、以下を示しています。
v 最大挿入レート = 3036 ヒット/秒
v 最大圧縮レート = 558 ヒット/秒
アーカイブ・サーバーなしでのキャニスター・ファイルのバックアップ
Tealeaf システムでアーカイブ・サーバーを使用していない場合、以下の方式を使用
してキャニスター LSSN ファイルをバックアップできます。
注: セッション・データ・ファイルのバックアップ時に、キャニスターがデータ・
ファイルにアクセス可能であってはなりません。アクセスできる場合、当該ファイ
ルを再作成する必要が生じます。
処理サーバーのダウン時間を最小限に抑えてファイルをバックアップするには、以
下のようにします。
1. 対象の LSSN ファイルにこれから追加されるデータがないことを確認します。
例えば、昨日のデータ・ファイルをバックアップする場合、昨日用のスプー
ル・データがないことを確認します。
2. キャニスター・サービスをシャットダウンします。
3. 一時ディレクトリーを作成します。
4. 対象の lssn データ・ファイル (lssn*.dat および lssn*.idx) を一時ディレク
トリーに移動します。
5. キャニスター・サービスを再始動します。
第 2 章 Tealeaf データベースのトラブルシューティング
87
6. 一時ディレクトリーのファイルをバックアップします。
7. 対応する dtSearch インデックスをバックアップします。
8. キャニスター・サービスをシャットダウンします。
9. 一時ディレクトリー内の LSSN ファイルをアクティブな CANISTER.dbs ディレ
クトリーに戻します。
10. キャニスター・サービスを再始動します。
稼働中のキャニスターに LSSN ファイルをリストアする際には、CanTrim が無効に
なっているか、リストアされたデータ・ファイルが次回の始動時にトリムされない
ように保存日数の設定が十分に大きいことを確認してください。
キャニスターの移動
Tealeaf キャニスターを移動するには、セッション・データ・ファイルおよびそのイ
ンデックスを移動し、該当する変更の構成を更新する必要があります。
注: この手順は、オフピーク時にスケジュールする必要があります。キャニスター
が無効になって切断されている期間に、キャプチャーされたすべてのヒットがドロ
ップされます。
注: 現在のバージョンにアップグレードする前に Tealeaf ソリューションがリリー
ス 7.2 にアップグレードされ、リリース 7.2 バージョンを丸 1 日実行できなかっ
た場合、アプリケーション・イベント・ログでエラー 160 を受け取ることがありま
す。 90 ページの『NextLssnRec() のエラー 160(0)』を参照してください。
キャニスター検索インデックス・データの移動
キャニスター検索インデックス・データを新しい場所に移動できます。
1. 以下のように、TMS を使用して、キャニスター構成を開きます。
a. Tealeaf ポータルに管理者としてログインします。
b. メニューから、「Tealeaf」 > 「TMS」を選択します。
c. キャニスター・ノードを展開します。
d. 「キャニスター構成」をクリックします。
e. 「構成アクション」パネルで、「表示/編集」をクリックします。
f. キャニスター構成が表示されます。「IBM Tealeaf CX 構成マニュアル」の
『CX キャニスターの構成』を参照してください。
2. 「キャニスター・サービス」タブで、「インデックス付けするファイルの場所
(Location of Files to be Indexed)」の値をこのディレクトリーの新規場所に
変更します。他のいずれのフィールドも編集しないでください。
3. 変更を保存する場合は、「OK」をクリックします。
a. TMS で、「セッション・インデクサー」ノードを展開します。
b. 「インデックス・サービス構成 (Index Service configuration)」をクリックし
ます。
c. 「構成アクション」パネルで、「表示/編集」をクリックします。
d. セッション・インデクサー構成が表示されます。「IBM Tealeaf CX 構成マニ
ュアル」の『CX インデックス付けの構成』を参照してください。
88
Tealeaf トラブルシューティング・ガイド
4. 「インデックス付けオプション」タブで、「メモリー内で一時 XML を作成
(Build Temporary XML In Memory)」をクリアします。
5. 「一時 XML ファイルのパス (Path for Temp XML File)」の値を編集して、一時
XML ファイルの場所の新規ディレクトリー・パスにします。
6. 「メモリー内で一時 XML を作成 (Build Temporary XML In Memory)」を選択し
ます。
7. 変更を保存する場合は、「OK」をクリックします。
キャニスター・セッション・データの移動
キャニスター・セッション・データを移動できます。
1. TMS で「キャニスター・サーバー」ノードを開きます。
a. TMS で、「キャニスター・サーバー」ノードを展開します。
b. 「キャニスター・サーバー構成」をクリックします。
c. 「構成アクション」パネルで、「表示/編集」をクリックします。
d. キャニスター・サーバー構成が表示されます。「IBM Tealeaf CX 構成マニュ
アル」の『CX キャニスターの構成』を参照してください。
2. LOCAL_DIRECTORY の値を、CANISTER.dbs ディレクトリーの親ディレクトリーの
絶対パスになるように設定します。必ず、値に最後の円記号 (¥) を含めてくださ
い。
キャニスター移動の完了
キャニスター検索インデックス・データまたはキャニスター・セッション・データ
を移動した後で、以下に説明する手順に従うことで移動を完了できます。
キャニスターの移動を完了するには、以下を実行します。
1. 既存のキャニスター・ディレクトリーをバックアップします。
2. Windows の「スタート」メニューから「すべての TeaLeaf サービスを停止
(Stop all TeaLeaf services)」を選択します。
3. Windows の「コントロールパネル」の「サービス」を使用して、TeaLeaf トラ
ンスポート・サービスを停止します。
4. Indexes ディレクトリー/CANISTER.dbs ディレクトリーの親ディレクトリーを、
上記の構成設定で指定した新規の場所に移動します。
5. ファイルおよびディレクトリーを移動した後に、バックアップした元のディレク
トリーを削除する必要があります。
6. 「スタート」メニューのショートカット「すべての TeaLeaf サービスを開始
(Start all TeaLeaf services)」を使用して、すべての Tealeaf サービスを再始
動します。
ctree エラー
ctree データベース操作でエラーが発生する場合があります。
以下のセクションに、ctree データベース操作により生成される可能性のある各種タ
イプのエラーをリストします。
第 2 章 Tealeaf データベースのトラブルシューティング
89
NextLssnRec() のエラー 160(0)
このセクションでは、インデックスのないセッションなどの問題について説明しま
す。
インデックスのないセッション
アプリケーション・イベント・ログに、セッション・インデクサーが現在更新中の
インデックスのないセッションを照会していることを示すエラーが表示される場合
があります。
アプリケーション・イベント・ログに表示されるエラーの例は以下のとおりです。
Event Type: Error
Event Source: TeaLeaf Session Indexer
Event Category: Indexer
Event ID: 9864
Date: 10/9/2009
Time: 2:41:05 PM
User: N/A
Computer: TLDB01
Description:
Failed to retrieve record from Canister. Error 160(0) in NextLssnRec():
retrieving first batch of unindexed LSSN records.. (Type: FAIRCOM; Code: 160).
上記で示されているようにイベント・ソースが TeaLeaf セッション・インデクサー
である場合、セッションはインデックス付けの実行でスキップされ、次の実行で選
択されます。
注: システムをリリース 7.2 にアップグレードし、LSSN キャニスター・ファイル
が当日について既に作成されている場合は、このエラーを連続して受け取る可能性
があります。リリース 7.2 では、Tealeaf は、LSSN キャニスター・ファイルでトラ
ンザクション・サポートを導入しました。既存の当日の LSSN ファイルには、トラ
ンザクションのサポートは含まれていません。上記のエラーは、このサポートの欠
落が原因です。
インデックス付けを待機しているセッションはまだインデックス付けされているた
め、データ損失のリスクはありません。ただし、当日のデータが完全にインデック
ス付けされるまで、イベント・ログでは引き続き、このようなエラー・メッセージ
を受け取ることになります。数日経ってもイベント・ログにこのようなエラーが引
き続き表示される場合は、Tealeaf http://support.tealeaf.com にお問い合わせくださ
い。
システムの異常終了によりデータ・ファイルとインデックスの間の参
照が破壊される問題
インデックスのないセッションの最初のバッチを取得する際、キャニスターがセッ
ションをプルできません。
v TLTMaint ログにエラーはレポートされていません。
v 自動化インデックス付けプロセスが一切実行できません。
アプリケーション・イベント・ログで以下のエラーが表示されることがあります。
(11:29 Session Indexer) - Failed to retrieve record from Canister.
Error 160(0) in NextLssnRec(): retrieving first batch of unindexed
LSSN records.. (Type: FAIRCOM; Code: 160).
90
Tealeaf トラブルシューティング・ガイド
インデックスの修正:
システムの異常終了によりインデックスに不正なファイル情報が追加された場合、
以下に説明する手順を使用してインデックスを修正します。
インデックスを修正するには、以下を実行します。
1. TMS を使用して、キャニスター・サービスをシャットダウンします。「IBM
Tealeaf cxImpact 管理マニュアル」の『TMS の「全体ビュー」タブ』を参照して
ください。
2. キャニスター・データ・ボリュームで、ボリュームのルートに以下のディレクト
リーを作成します。
lssn¥Canister.dbs
3. キャニスター・データ・ストアから、LSSN_<Date>. ファイルを上記のディレク
トリーに移動します。ここで、<Date> はサーバーの異常終了の日付です。
注: ファイルをキャニスター・データ・ストアから移動する必要があります。
4. キャニスター・サービスを再始動します。
5. インデクサー・エラー・メッセージがなくなっていることを確認します。
欠落データのリカバリー:
インデックスの問題を修正した後、以下の手順を実行して欠落しているデータをリ
カバリーします。
以下の手順を実行して、lssn¥Canister.dbs ディレクトリーに移動されたセッショ
ン・データ・ファイルをリカバリーします。
1. *.idx ファイルを ¥lssn¥Canister.dbs ディレクトリーから削除します。
2. コマンド・シェルで以下のコマンドを実行します。
tltmaint -v -noserver -archiver -localdir ¥lssn
注: セッション・データのファイル・サイズによっては、上記のコマンドの完了
に時間がかかることがあります。
3. 「コマンドプロンプト」が戻ると、最後の行はステータスを示しています。
「no errors」というメッセージは、すべて問題ないことを示しています。
4. プレフィックスが LSSN_ のファイルを ¥lssn¥Canister.dbs ディレクトリーか
らコピーして、キャニスター・データ・ディレクトリーに戻します。
5. TMS を使用してキャニスター・サービスを再始動します。「IBM Tealeaf
cxImpact 管理マニュアル」の『TMS の「全体ビュー」タブ』を参照してくださ
い。
6. これで、セッション・データが使用可能になりました。
7. テストするために、サーバーの異常終了の日付からセッションを検索します。
「IBM Tealeaf cxImpact ユーザー・マニュアル」の『セッション・データの検
索』を参照してください。
第 2 章 Tealeaf データベースのトラブルシューティング
91
Error 69(0) への対処
Error 69(0) は通常、指定されている .dat ファイルのインデックスが破損してい
ることを示しています。ここに記載されている手順を使用して Error 69(0) エラー
に対応してください。
アプリケーション・イベント・ログに以下のエラーが繰り返し表示されることがあ
ります。
Failed to retrieve record from Canister. Error 69(0) in ProcessSesn():
Could not update session CANISTER.dbs¥LSSN_20120815_MyServer.dat 469778184.
isam_err = 69. (Type: FAIRCOM; Code: 69).
このエラーはサービスのリサイクルおよびポータルのリブート後にも表示されるこ
とがありますが、キャニスターは正常に動作しているように見えます。
この問題を修復するには、以下のステップを実行してインデックスを再作成しま
す。
注: キャニスター・インデックスの再作成には、長時間かかることがあります。以
下のステップは、オフピーク時に実行してください。
1. キャニスターをホストしているサーバーに管理者としてログインします。
2. 上記のファイルが収められているディレクトリーにナビゲートします。通常、こ
のディレクトリーは以下のようになります。
<Tealeaf_install_directory>¥Canister¥Canister.dbs
3. 以下の名前パターンに一致しているすべてのファイル (3 ファイル) を
Canister.dbs ディレクトリーから移動します。
LSSN_20120815_MyServer*.idx
4. TMS を使用してキャニスター・サービスを再始動します。「IBM Tealeaf
cxImpact 管理マニュアル」の『TMS の「全体ビュー」タブ』を参照してくださ
い。
5. キャニスターは再始動すると、キャニスターに保管されているすべてのセッショ
ンを再インデックス付けして、インデックスを再作成しようとします。データの
ボリュームによっては、この処理には数時間かかることがあります。
キャニスターを構成するための追加リソース
キャニスターの構成について詳しくは、「IBM Tealeaf CX 構成マニュアル」の
『CX キャニスターの構成』を参照してください。
例外をトラブルシューティングするためのログ・レベルの変更
インデクサー・ログで例外が検出された場合、インデクサーのログ・レベルを 4 ま
たは 5 に上げます。これにより、より幅広いデバッグ・データ・セットをキャプチ
ャーできます。
エラーを Tealeaf カスタマー・サポートにレポートする際には、レベル 4 以上に
設定されたログ・ファイルをサブミットします。
ステップ:
以下のステップを実行して、ログ・レベルを変更します。
92
Tealeaf トラブルシューティング・ガイド
1. ポータルに管理者としてログインします。
2. ポータル・メニューから、「Tealeaf」 > 「TMS」を選択します。
3. Tealeaf 管理システムが表示されます。「IBM Tealeaf cxImpact 管理マニュア
ル」の『Tealeaf 管理システム』を参照してください。
4. 「表示」ドロップダウンから「サーバー」を選択します。
5. 「セッション・インデクサー」ノードをクリックします。
6. 「インデックス・サービス構成 (Index Service configuration)」をクリックしま
す。「構成アクション」パネルで、「表示/編集」をクリックします。
7. 「インデックス構成 (Index configuration)」が表示されます。
8. 「スケジューリング/診断」タブをクリックします。
9. 「診断」グループで、レベルを 4 または 5 に上げます。
10. 「保存」をクリックします。
11. 構成を各サーバーにプッシュします。ここで、サービスの再始動を実行しては
なりません。「IBM Tealeaf CX 構成マニュアル」の『CX インデックス付け
の構成』を参照してください。
注: トラブルシューティングのためにインデックス付けレベルを上げた場合
は、必ず、より適切な値にログ・レベルをリセットしてください。推奨値は 2
です。
「インデックス付け待ちのセッション数 (Sessions waiting to be
indexed)」がしきい値を超えたことの確認
直接プル・インデックス付けを使用している場合、インデックスのないセッション
に対してディスク・スペースや他のマシン・リソースが消費されないため、「イン
デックス付け待ちのセッション数 (Sessions Waiting to be Indexed)」は、かなり無意
味なしきい値になります。
他の場合には、セッション・インデクサー・サービスが処理するためにファイルを
ディスクに書き込むようにシステムを構成できます。バージョン 4.0 SP 2 で直接
プル・インデックス付けが導入される前には、「インデックス付け待ちのセッショ
ン数 (Sessions waiting to be indexed)」が多い場合、インデックス付けされるセッシ
ョンがディスクに物理ファイルとして書き込まれるため、切迫した問題を示してい
ました。
Tealeaf の 4.0 SP 2 からリリース 7.1 までのバージョンでは、PortalStatus.cfg
でこのしきい値の検査を無効にするか、しきい値を大きくして頻繁にしきい値がト
リガーされないようにすることをお勧めします。設定を再確認するために、
IndexConfig.exe ユーティリティーを実行し、「操作実行時間」タブをクリックし
て、「キャニスターとの直接通信の有効化 (Enable direct communication with
Canister)」チェック・ボックスが選択されているかどうかを確認します。
v リリース 7.2 以降では、インデックス構成は TMS を使用して管理します。
「IBM Tealeaf CX 構成マニュアル」の『CX インデックス付けの構成』を参照し
てください。
...¥TeaLeaf¥Tools¥PortalStatus.cfg の WaitToBeIndexed エラーしきい値を大き
くするか、0 に設定してこのしきい値の検査を完全に無効にすることができます。
第 2 章 Tealeaf データベースのトラブルシューティング
93
欠落セッションをインデックスに追加するための「検査と修正」機能の使用
セッション・インデクサー・サービスが停止状態の場合、セッションは、長期キャ
ニスターへの移動時にインデックス付けされません。一部のセッションがインデッ
クス付けされていない、またはインデックスが最新でない可能性があると思われる
場合、検索サーバーの「インデックスの検査および修正 (Check and Fix Indexes)」
機能を使用できます。
注: この修正を適用する前に、ファイル
<Tealeaf_install_directory>¥IndexCheck.exe がアップグレードまたはパッチされ
ていることを確認します。
検査と修正機能を実行するには、以下のようにします。
1. Web ブラウザーを開き、以下のアドレスに移動します。
http://<hostname or IP address of Tealeaf server>:19000/
2. 「キャニスター/インデクサー検査 (Canister/Indexer Check)」リンクをクリックし
ます。結果ページの表に、それぞれの日のデータに存在するセッション数および
そのセッションの中でインデックス付けされているセッションの数が表示されま
す。
3. 「検査と修正」をクリックします。
4. システムで、インデックス付けする必要があるセッションの数が示され、プロセ
スが開始されます。ブラウザー・ウィンドウを閉じた場合でも、プロセスはバッ
クグラウンドで続行されます。
a. ブラウザー・ウィンドウを閉じた後にプロセスのステータスを確認するに
は、新規ブラウザー・ウィンドウを開き、以下の URL を入力します。
http://<hostname/IP addr of Tealeaf server>:19000/CanisterIndexCheckerStatus
キャニスターからのインデックス付けセッション数の取得に失敗した
このエラーは、TeaLeaf セッション・インデクサー・サービスがキャニスター・サ
ーバー・データ・ストア・サービスに接続できないことを示しています。この状態
が発生する可能性があるのは、キャニスター・サーバー・サービスが停止状態また
は保守モードの場合です。
キャニスター・サーバー・サービスは、開始されると、TLTMaint プログラムを実行
して、保守モードを開始します。TLTMaint は、キャニスター・データ・ファイルの
徹底的な検査を実行します。TLTMaint は通常、1 分未満で完了しますが、キャニス
ターの .dat ファイルまたは .idx ファイルのいずれかを無効にした異常シャット
ダウンが発生した場合、完了するまでにかなり長い時間がかかることがあります。
他の Tealeaf サービスは開始すると、キャニスター・サーバーとの通信を開こうと
します。サービスの動作は問題ありません。開始直後に通信を確立できない場合、
10 秒程度ごとに再試行し、少なくとも 5 分間待機してから、接続エラーをイベン
ト・ログにレポートします。
94
Tealeaf トラブルシューティング・ガイド
実際のイベント・ログを確認すると、セッション・インデクサー・サービス・エラ
ー・メッセージの後に、TLTMaint がエラーなしで完了したことを示すメッセージが
表示されており、セッション・インデクサー・エラー・メッセージがログに記録さ
れなくなっています。
インデックス・エラー・リカバリー
インデックス・ジョブが新規インデックスを作成するか、マージを実行すると、新
規インデックスが作成され、確実にインデックス名を予約するために TLL ファイル
に即時に追加されますが、インデックスは無効とマークされます。インデックスま
たはマージ操作が完了すると、インデックスは有効とマークされます。
インデックスまたはマージが異常終了した場合、インデックスは無効とマークされ
たままになり、ロックされたままになります。ロックは、2 時間を超えてロック状
態のままである場合、解除されます。TLL 検査時に、無効とマークされた、ロック
のないインデックスがインデックス検査で見つかった場合、そのインデックスは削
除されます。
インデックス付け時にエラーが返された場合、インデックスは、「インデックス検
査が必要」とマークされます。このインデックスは、このフラグが削除されるま
で、インデックス付けで使用されません。インデックス検査が失敗した場合、イン
デックスは破損とマークされ、TLL から削除されます。検査に成功した場合、「検
査が必要」フラグがクリアされ、インデックスが稼働状態に戻ります。
破損したインデックス・ディレクトリーは、後で検査するために、.CORRUPT ファイ
ル拡張子を付けて名前変更されます。
インデックスの再作成
必要な場合は、インデックス・ディレクトリーを削除し、検索サーバーでインデッ
クス検査オプションを使用することで、インデックスを再作成できます。
詳しくは、Tealeaf http://support.tealeaf.com にお問い合わせください。
インデックス付けの構成のための追加リソース
構成について詳しくは、「IBM Tealeaf CX 構成マニュアル」の『CX インデックス
付けの構成』を参照してください。
RSE サービスの障害の問題への対処
要求バッファーに適切な UTF-8 エンコーディングが含まれていないと、RSE サー
ビスの障害の原因となります。以下の情報を使用して RSE サービスの障害の問題
に対処します。
結果セットに対する分析の実行時に、RSE で障害が起こり、以下のエラー・メッセ
ージが生成されます。
Error getting session info for session 290610439: System.Xml.XmlException:
Invalid character in the given encoding. Line 3035, position 351. at
System.Xml.XmlTextReaderImpl.Throw(Exception e) at
第 2 章 Tealeaf データベースのトラブルシューティング
95
System.Xml.XmlTextReaderImpl.InvalidCharRecovery(Int32& bytesCount, Int32&
charsCount) at System.Xml.XmlTextReaderImpl.GetChars(Int32 maxCharsCount) at
System.Xml.XmlTextReaderImpl.ReadData() at
System.Xml.XmlTextReaderImpl.ParseCDataOrComment(XmlNodeType type, Int32&
outStartPos, Int32& outEndPos) at
System.Xml.XmlTextReaderImpl.ParseCDataOrComment(XmlNodeType type) at
System.Xml.XmlTextReaderImpl.ParseElementContent() at
System.Xml.XmlReader.ReadString() at
TeaLeaf.SearchServer.XmlParsing.SessionInfoFromMemStream(MemoryStream
memStream, TLSession sessn, Boolean parseSummary) at
TeaLeaf.SearchServer.TLSession.GetSessionInfo(Boolean rsp, Boolean
interestingHits, Boolean parseSummary, Int32 timeout, Boolean validateXML,
Boolean SessionXML, Boolean log)
UTF-8 エンコードをサポートするには、以下の名前/値のペアが要求バッファーに含
まれている必要があります。
REQ_BUFFER_ENCODING=UTF-8
REQ_BUFFER_ORIG_ENCODING=ISO-8859-1
RESP_BODY_ENCODING=UTF-8
この問題を修正するには、以下のいずれかのアップグレードを実行する必要があり
ます。
v PCA Build 3330 以降にアップグレードします。あらかじめ I18N を有効にして
おく必要があります。
v IBM Tealeaf cxImpact Build 7080 以降にアップグレードします。具体的には、パ
イプライン・セッション・エージェント SAInflate がバージョン 7080 以上でな
ければなりません。
照会サーバーを正しくシャットダウンおよび再始動できない
照会サーバーを再始動した直後に、イベント・ログに以下のようなエラーが表示さ
れることがあります。
Errors:
7/28/2008 10:50:00 AM QueryServer ERROR An error occurred in the listener for
10.10.32.252:21000 : Only one usage of each socket address (protocol/network
address/port) is normally permitted
7/28/2008 10:50:00 AM QueryServer ERROR An error occurred in the listener for
127.0.0.1:21000 : Only one usage of each socket address (protocol/network
address/port) is normally permitted
7/28/2008 10:50:00 AM QueryServer ERROR at
System.Net.Sockets.Socket.DoBind(EndPoint endPointSnapshot, SocketAddress
socketAddress)
at System.Net.Sockets.Socket.Bind(EndPoint localEP)
at System.Net.Sockets.TcpListener.Start(Int32 backlog)
at TeaLeaf.Reporting.Server.TLHttpServer.Listen(Object obj)
上記のエラー・メッセージが表示されている場合は、問題の原因は、RSE サービス
が正しくシャットダウンできなかったことです。場合によっては、シャットダウ
ン・コマンドの発行後に数秒間、サービスが作動可能のままになることがありま
す。
RSE サービスの再始動が試行されると、サービスは、割り当てられたポートのバイ
ンドに失敗します。このエラーが発生すると、Windows タスクマネージャー (また
はそれに相当するツール) を使用して、サービスを手動で強制終了する必要があり
ます。その後、RSE サービスを通常の Tealeaf 始動手順の一部として再始動できま
す。
96
Tealeaf トラブルシューティング・ガイド
この問題は、Tealeaf バージョンの後続のビルドで解決される可能性があります。詳
しくは、Tealeaf http://support.tealeaf.com にお問い合わせください。
トラブルシューティング - データ収集プログラム
データ収集プログラムのトラブルシューティングを行うには、このセクションの情
報を使用します。
無視できるデータ収集プログラム・メッセージ
SQL Server のリブート中または SQL Server がメンテナンス・モードに入ったとき
に、特定のメッセージがポータルのデータ収集プログラム・ログに書き込まれま
す。ほとんどの場合、これらのメッセージは無視できます。
例えば、ポータルのデータ収集プログラム・ログに、1 つ以上の以下のエラー・メ
ッセージが表示される場合があります。
A transport-level error has occurred when sending the request to the server.
An existing connection was forcibly closed by the remote host.
A network-related or instance-specific error occurred while establishing a
connection to SQL Server. The server was not found or was not accessible.
これらのエラーは、頻繁に、または不定期および予期しない間隔で再表示されない
限り、無視できます。
データ収集プログラムのパフォーマンス問題への対処
このセクションでは、データ収集プログラムのパフォーマンスのトラブルシューテ
ィングを開始する方法に関する情報を示します。
Tealeaf データ収集プログラムは、最適な動作を行っている場合、すべてのアクティ
ブおよび使用可能なキャニスターに対して 5 分ごとに少なくとも 1 回実行されま
す。実行するトランザクション数が多いため、データ収集プログラムでパフォーマ
ンスの問題が生じることがあり、この問題は、Tealeaf コンポーネントが原因である
場合もそうでない場合もあります。
データ収集プログラムが定期的に停止する問題への対処
データ収集プログラムが定期的に停止してデータ収集の実行が完了せず、以下のロ
グ・メッセージが表示される場合があります。
3:05:26 TeaLeaf Data Collector ERROR Data Collection appears to be stalled.
Data Collection has been running since: 2012-06-20 02:05:26
このエラー・メッセージが表示される場合は、ログでデータ収集実行の期間を確認
します。データ収集実行の期間が 1 時間を超えた場合、プロセスが自動的に再始動
し、以下のようなメッセージがログに記録されます。
2012-06-20T10:40:26 TeaLeaf Data Collector STATUS The TeaLeaf Data Collector
is stopping.
The TeaLeaf Data Collector has been running for: 0 days, 8 hours, 6 seconds.
第 2 章 Tealeaf データベースのトラブルシューティング
97
データ収集実行を完了するための時間を短縮するために、以下の値を上げて実験で
きます。
設定
推奨される調整
データ収集 - 同時最大数
データ収集プログラムが同時に照会できるキャニスターの最大数。現在の値
より多くのキャニスターがある場合は、この値を 2 上げてみます。
データ収集 - バッチ・サイズ
単一のバッチで収集するレコードの最大数。この値を 2000 上げてみます。
データ収集プログラムのパフォーマンスを効果的に調整するために、何度も収集を
実行して、これらの設定を実験する必要が生じることがあります。
v これらの設定について詳しくは、「IBM Tealeaf cxImpact 管理マニュアル」の
『CX 設定』を参照してください。
タイムアウト
データ・ロードおよびシステム・パフォーマンスによっては、データ収集操作がタ
イムアウトになることがあります。
タイムアウトが発生した場合、データ収集プログラムのログに以下のようなメッセ
ージが表示されます。
Error occurred while executing the non-query command: Timeout expired. The
timeout period elapsed prior to completion of the operation or the server is
not responding.
注: タイムアウトの問題を解決するには、基盤となるシステム・パフォーマンスを
分析する必要があります。
短期的には、プロセスが完了できるように以下の設定を試すことができます。
1. ポータルに管理者としてログインします。
2. 「ポータル」メニューから、「Tealeaf」 > 「ポータル管理」を選択します。
3. IBM Tealeaf CX 設定リンクをクリックします。
4. 「データ収集プログラム」カテゴリーをクリックします。
5. 「データベース接続 - タイムアウト (秒)」という設定を見つけます。
6. 「編集」をクリックします。
7. プロセスを完了できるように十分にこの値を大きくします。
データ収集プログラム・サービスまたはレポート・データベースが
ダウンした場合、統計データはどうなるか?
処理サーバーでイベントが開始されるたびに、処理サーバー上のキャニスター・デ
ータ・ストアで 1 つ以上のレコードが作成されます。機能しているシステムでは、
レコード・データ収集プログラム (RDC) サービスが、各処理サーバーからこれらの
データを収集し、その情報をレポート・データベースに保管します。
RDC は通常、ポータルをホストしているのと同じサーバー上で実行されます。デフ
ォルトでは、前回の実行が完了してから 5 分後にデータ収集を実行するようにスケ
ジュールされています。
98
Tealeaf トラブルシューティング・ガイド
RDC がレポート・データベースと通信できないか処理サーバー上のキャニスターと
通信できない場合、または RDC 自体を実行できない場合、レコードは、処理サー
バー上のキャニスターに累積されます。次に RDC が正常に実行されたときに、処
理サーバー上のキャニスター内のすべてのレコードが収集されてレポート・データ
ベースに保管されます。
デフォルトで、処理サーバー上のキャニスターは、レコードをローカルに 48 時間
保持します。その時間を超えても RDC がこれらのレコードを読み取って取得でき
ない場合、処理サーバー上のキャニスターは、最も古いレコードから削除し始めま
す。古いレコードは、1 時間のチャンクで削除されます。
v レコードが保持される期間は、キャニスター構成の「サービス実行」タブのパラ
メーターで構成します。「IBM Tealeaf CX 構成マニュアル」の『CX キャニスタ
ーの構成』を参照してください。
イベント・グラフのカウントとドリルダウン検索のカウントの不一
致
イベント・グラフまたはダッシュボードで、特定の期間のイベント・カウントをレ
ポートできます。基盤となるセッションにドリルダウンするためのリンクをクリッ
クすると、返されるセッション数が、グラフでレポートされている数と異なりま
す。
上記では、グラフ内のすべてのイベントが、セッション内で 1 回のみカウントされ
るように構成されていることが想定されています。そうなっていない場合は、グラ
フと返されるセッション数とでは、カウントが異なる可能性があります。
この問題は、データ収集プログラムがキャニスターからイベント・カウントをどの
ように収集しているかに関係している可能性があるため、これらの値の矛盾は、ポ
ータルからでは分からないことがあります。以下のステップを実行して、イベン
ト・カウントが一致しているかどうかを確認します。
注: 以下のステップを実行するには、regedit を使用する必要と SQL 照会を実行す
る必要があります。このタスクについてご質問がある場合は、Tealeaf
http://support.tealeaf.com にお問い合わせください。
1. キャニスター・サーバーにログインします。
2. Windows の「スタート」メニューから、regedit を開きます。
3. 以下のレジストリー・キーの値を取得します。この値を保存します。
HKEY_LOCAL_MACHINE¥SOFTWARE¥TeaLeaf Technology¥
DataStore¥Canister¥Time-Statistics Table Trim Seconds
4. この値を 86400 (24 時間) に設定します。この設定により、実質的に、キャニ
スター上に集約されたイベント・データの削除が無効になります。
5. 以下のレジストリー・キーと値を regedit に挿入します。
HKEY_LOCAL_MACHINE¥SOFTWARE¥TeaLeaf Technology¥
DataStore¥ReportServer¥Canister Trim Disabled
6. この値を true に設定します。
注: このレジストリー設定は、各キャニスターのデフォルト構成の一部である
Can Trim Enabled とは異なります。その設定は変更しないでください。
第 2 章 Tealeaf データベースのトラブルシューティング
99
7. 設定を保存します。
8. 数時間、またはグラフと検索のカウントで矛盾が見つかるまで、データ収集プ
ログラムを実行します。
9. 矛盾が検出された場合、以下のステップを実行して、キャニスター上の EVNT
テーブルに照会して、イベント・グラフ・カウントが正しく収集されているか
どうかを判別します。
a. キャニスター・サーバーで以下のショートカットを使用して「コマンドプ
ロンプト」を開きます。
Start > All Programs > TeaLeaf Technology > Portal Server > Server >
Client Tools
b. 「コマンドプロンプト」で、次のコマンドを入力します。
csql -p ADMIN
c. 以下の SQL 照会を実行します。
SELECT * FROM EVNT
10. ポータルでレポートされているカウントに照らして、照会から返されたカウン
トを検証します。
11. Tealeaf Technology ハイブで以下のレジストリー設定の値を元に戻します。
¥DataStore¥Canister¥Time-Statistics Table Trim Seconds
12. Tealeaf Technology ハイブで以下のレジストリー項目を無効にするか削除しま
す。
¥DataStore¥ReportServer¥Canister Trim Disabled
13. regedit 設定を保存します。
データ収集プログラムがキャニスターに接続できない場合の対応方
法
データ収集プログラムがキャニスターに接続できず、以下に示すメッセージがロ
グ・ファイルに書き込まれる場合があります。
ログ・ファイルに以下のいずれかのメッセージが含まれている場合があります。
Could not connect to lpwsa3000:CANISTER Canister + {lpwsa3000, 5597}.
... CANISTER is not active
... Data Collection error on server ...
その場合、データ収集プログラムとキャニスターの間の接続が作動可能になってい
ません。
この問題を解決するには、以下を実行します。
1. Tealeaf データ収集プログラム・サービスを再始動します。それでも問題が解決
しない場合は、以下のステップを続行します。
2. システムに対する最近の変更を確認します。例えば、Tealeaf を最近アップグレ
ードした場合、一部の構成変更がデータ収集プログラムに影響することがありま
す。
3. 「ポータル管理」ページでキャニスター・サーバーの名前を確認します。
4. Tealeaf ポータルを使用して、キャニスター・ユーザー名およびパスワードを確
認します。
100
Tealeaf トラブルシューティング・ガイド
v キャニスターで TLADMIN および TLUSER アカウントにカスタム・パスワード
を使用している場合は、Tealeaf ポータルでパスワードを正しく入力したこと
を確認します。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『Tealeaf サーバーの管理』を参
照してください。
5. 上記で問題が解決しない場合は、ポータル・サーバーがキャニスター・サーバー
を ping できることを確認します。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『Tealeaf サーバーの管理』を参
照してください。
6. 上記が機能した場合、ポート 5597 でのキャニスター・サーバーへのポータル・
サーバーからの telnet が機能していることを確認します。
注: ポータルを使用してデータ収集プログラム設定に対して変更を行う場合は、設
定を即時に適用できるように、サービスを再始動する必要があります。
イベント・ログ内の SQL 例外「接続はピアによってリセットされ
ました: ソケット書き込みエラー」
このエラーが発生する可能性があるのは、Tealeaf レポート・データ収集プログラ
ム・サービスが、リモート・サーバー上で稼働している SQL Server と通信しよう
としている場合です。これは、リモート SQL Server がレポート・データ収集プロ
グラム・サービスによるデータ挿入要求に応答しなかったことを示しています。こ
のエラー状態は、ネットワークまたは SQL Server のいずれかに関連しています。
リモート SQL Server での一時的な問題であった場合、Tealeaf レポート・データ収
集プログラム・サービスを再始動すると、問題が消去されます。Tealeaf サービスを
再始動してもエラーが解決されない場合、リモート SQL Server 担当の DBA、また
は Tealeaf サーバーとリモート SQL Server の間の接続を担当しているネットワー
ク・スタッフに問い合わせてください。恐らく、根本原因は、これらの 2 つの領域
のいずれかにあります。
データベース表にデータがあるにもかかわらずデータベース・ファ
イル・グループ・レポートにデータが表示されない場合の対応方法
インストール後に、データベース表にデータがあるにもかかわらず、データベー
ス・ファイル・グループ・レポートにデータが表示されません。以下の情報を使用
して、この問題をトラブルシューティングします。
注: この問題は、リリース 8.4 以降の新規インストール済み環境に適用されます。
この問題の原因は、ホストおよび訪問者ホストの値が localhost のままになり、マ
シン名にマップされないという、インストール時のバグです。レポートが
localhost を使用してレポート・データについての照会を試行すると、ポータルが
データベースへの接続に失敗し、空のレポートがレンダリングされます。
v この問題は、お客様が上記レジストリー設定を変更した場合にも発生することが
あります。ただし、この状態はまれです。
この問題を修正するには、以下のようにします。
1. レポート・サーバーに管理者としてログインします。
第 2 章 Tealeaf データベースのトラブルシューティング
101
2. 次のレジストリー・ハイブ (64 ビット) にナビゲートします。
SOFTWARE¥Wow6432Node¥TeaLeaf Technology¥DataStore¥ReportServer
3. 次の設定を変更します。
表 3. データベース・ファイル・グループ・レポートにデータが表示されない
設定
現在の値
新しい値
Host
localhost
マシンのフルネーム
VisitorHost localhost
(IBM Tealeaf
cxResults が
インストー
ルされてい
る場合)
マシンのフルネーム
4. レジストリーを保存します。
5. レポート・サーバーを再始動します。
トラブルシューティング - データ・サービス
データ・サービスのトラブルシューティングを行うには、このセクションの情報を
使用します。
Tealeaf データ・サービスの問題発生時には、カスタマー・サポートにレポート・ロ
グ情報を提供します。 106 ページの『ログのレポート』を参照してください。
「IBM Tealeaf CX 構成マニュアル」の『Tealeaf データ・サービスの構成』を参照
してください。
Failed to write ReportQueryLogEntity エラー・メッセージへの
対応方法
Failed to write ReportQueryLogEntity エラーは、内部ロギング・テーブルでのト
ランザクションの問題を記録したものです。ユーザーおよびパフォーマンスには一
切影響しないため、無視できます。
データ・サービス・ログのメッセージ例は以下のとおりです。
Failed to write ReportQueryLogEntity
トラブルシューティング - レポート・ビルダー
レポート・ビルダーのトラブルシューティングを行うには、このセクションの情報
を使用します。
レポート・ビルダーからのドリルダウン時の「There are no
matches for your search」
レポート・ビルダーで、ドリルダウンが有効になっている場合は、レポート・ビル
ダー詳細テーブル内のリンクをクリックして、テーブル内の項目のソース・データ
を提供した、基盤となるセッションのリストを確認できます。一部の場合には、非
102
Tealeaf トラブルシューティング・ガイド
ゼロのハイパーリンクが付いた数値をクリックしても、それに対してセッションを
受け取らず、代わりに以下のようなメッセージを受け取ることがあります。
There were no matches to your search, as it may be one of XX session(s)
pending indexing. Please wait a moment and try again.
ここで、
v XX は数値です。
この問題は、インデックス付けを待機しているセッションのバックログが原因の可
能性があります。ただし、通常、レポート・ビルダーのドリルダウンをクリックし
たときにこのメッセージが表示されるのは、返すことができるセッション数に関す
る組み込みの制限が原因です。
取得するセッションが多すぎる場合に検索サーバーが異常終了しないようにするた
めに、ドリルダウン照会などの照会から返すことができる最大セッション数として
16,384 件という制限があります。要求されたセッションの数がこの制限を超過した
場合、検索サーバーは、エラーや警告を出さずに要求を失敗させます。結果とし
て、ポータルは検索サーバーからセッションを受け取らず、上記のメッセージをポ
ストすることになります。
v 検索サーバー・ログに、「Nothing Found」メッセージがポストされます。
v 新しいビルドでは、以下のように、より説明が多いメッセージが検索サーバー・
ログに含まれます。
Max results = XX is too high for a same-page search. The limit is 16384.
ここで、XX は数値です。
Tealeaf レポート・ビルダーは、リリース 8.0 で導入されたときに、レポート・ビル
ダーから多数の結果を生成する可能性がある「同じページで AND 演算」照会を使
用して、ドリルダウン検索を統合しました。多くの場合、比較的単純なレポートか
らのドリルダウン照会で、この 16,384 セッションの制限を超過する可能性がありま
す。
この問題にパッチを当てるために、セッション・セグメントで返される最大セッシ
ョン数を減らすことができます。
注: 以下の一連のステップにおけるパラメーターは、セッション・セグメントを作
成するために、結果セット抽出でも使用されます。これは、IBM Tealeaf cxResults
を使用して分析できます。パラメーターが現在の値に設定されている理由について
入手可能なすべての情報を確認する必要があります。
1. ポータルに管理者としてログインします。
2. 「ポータル」メニューから、「Tealeaf」 > 「ポータル管理」を選択します。
3. 左ナビゲーション・ペインから、IBM Tealeaf CX 設定カテゴリーをクリックし
ます。
4. 「検索」リンクをクリックします。
5. 「セッション・セグメントの最大セッション数制限」の値を 1000 以下に設定し
ます。
v デフォルト値は 1000 です。
第 2 章 Tealeaf データベースのトラブルシューティング
103
v リリース 7.x 以前からアップグレードしたお客様の場合、IBM Tealeaf
cxResults 用に大きなセッション・セグメントを作成する際に使用するため
に、この値がかなり大きな値に設定されていることがあります。ただし、この
設定は、Tealeaf レポート・ビルダーの上記のユース・ケースに該当するもの
であり、適宜サイズ変更する必要があります。
6. 「保存」をクリックします。
7. ドリルダウン・リンクを再試行します。
v リンクでまだセッションが返されない場合、1 にサイズ変更する必要がありま
す。それでも失敗した場合は、値を 1000 にリセットし、
http://support.tealeaf.com にお問い合わせください。
トラブルシューティング - トップ・ムーバー
トップ・ムーバーのトラブルシューティングを行うには、このセクションの情報を
使用します。
トップ・ムーバー・データが収集されていない場合の対応方法
リリース 8.2 では、レポート・サーバーのタイム・ゾーンが、Tealeaf システムのタ
イム・ゾーンに一致している必要があります。タイム・ゾーンが一致していない場
合は、トップ・ムーバー・データは収集されません。トップ・ムーバー・レポート
に何も表示されません。
トップ・ムーバーを構成した場合、トップ・ムーバーのデータが収集されてポータ
ルに表示できるようになるまでに時間がかかることがあります。毎時トップ・ムー
バーは 1 時間ごとに収集され、日次トップ・ムーバーは 1 日に 1 回収集されま
す。
トップ・ムーバーの作成について詳しくは、「IBM Tealeaf イベント・マネージャ
ー・マニュアル」の『TEM の「トップ・ムーバー」タブ』を参照してください。
トップ・ムーバーのレポート作成について詳しくは、「IBM Tealeaf レポーティン
グ・ガイド」の『トップ・ムーバーの分析』を参照してください。
注: 新規に作成された日次トップ・ムーバーでは、トップ・ムーバー用に次の日の
データ収集プログラムが実行されるまで、トップ・ムーバー・レポートでのデータ
の表示が開始されません。デフォルトでは、この実行は、午前 5:30 に行われます。
24 時間経過後にトップ・ムーバー・データがまだ収集されていない場合、レポー
ト・サーバーのタイム・ゾーンを Tealeaf システムのタイム・ゾーンに一致するよ
うに変更します。以下のセクションに、このために必要な手順を示します。
Tealeaf システムのタイム・ゾーンの取得
Tealeaf システムのタイム・ゾーンを取得するには、以下の手順を実行します。
1. ポータルにログインします。
注: Tealeaf システムのタイム・ゾーンは、初期インストール時に構成する必要
があります。それ以降は変更してはなりません。この回避策のため、Tealeaf シ
ステムのタイム・ゾーンを変更しないでください。変更すると、Tealeaf システ
ムの他の多数のコンポーネントに影響が出る可能性があります。
104
Tealeaf トラブルシューティング・ガイド
2. 「ポータル」メニューから、「Tealeaf」 > 「TMS」を選択します。
3. Tealeaf 管理システムが表示されます。「IBM Tealeaf cxImpact 管理マニュア
ル」の『Tealeaf 管理システム』を参照してください。
4. 「全体ビュー」タブをクリックします。
5. 「ビュー」ドロップダウンから「サーバー」を選択します。
6. マスター・サーバーをクリックします。
7. 「Tealeaf ノード」をクリックします。
8. 「Tealeaf グローバル構成設定 (Tealeaf global configuration settings)」をクリ
ックします。
9. 「表示/編集」をクリックします。
10. 「ロール・タイム・ゾーン (Roll Time Zone)」の値を確認します。この値は、
Tealeaf システムのタイム・ゾーンです。
ポータルでのトップ・ムーバー計算時間の確認
ポータルでのトップ・ムーバー計算時間を確認するには、以下の手順を実行しま
す。
トップ・ムーバーの数および収集されていないデータのボリュームによっては、最
初の再計算の完了に長時間かかることがあります。開始する前に、毎時および日次
のトップ・ムーバー再計算に構成されている時刻 (Tealeaf システム時刻で表される)
で、ピーク時が再開される前に再計算を完了するのに十分な時間があることを確認
する必要があります。
ポータルでのトップ・ムーバー計算時間を確認するには、以下を実行します。
1. Tealeaf ポータルにログインします。
2. 「ポータル」メニューから、「Tealeaf」 > 「ポータル管理」を選択します。
3. 左ナビゲーション・パネルから、IBM Tealeaf CX 設定パネルをクリックしま
す。
4. 「データ収集プログラム」をクリックします。
5. 「トップ・ムーバー - 日次計算の時刻」の値を確認します。この値は、日次ト
ップ・ムーバーが再計算される、Tealeaf システムのタイム・ゾーンの時刻で
す。必要な場合は、これを変更して、オフピーク時に行われるようにします。
6. 毎時トップ・ムーバーは、正時の 10 分後に再計算されます。毎時トップ・ムー
バーの最初の再計算には、長時間かかることがあります。可能であれば、オフピ
ーク時にスケジュールしてください。
a. すべてのトップ・ムーバーの計算を無効にするには、「トップ・ムーバー」
設定の値を「無効」に設定します。
b. 営業時間後に、この設定を再有効化できます。
v 毎時トップ・ムーバーは、次の正時の 10 分後に再計算されます。
v 日次トップ・ムーバーは、Tealeaf システムのタイム・ゾーンの「トップ・
ムーバー - 日次計算の時刻」の時刻に再計算されます。
レポート・サーバーのタイム・ゾーンの変更
レポート・サーバーのタイム・ゾーンを変更するには、以下の手順を実行します。
第 2 章 Tealeaf データベースのトラブルシューティング
105
開始する前に、Tealeaf レポート・サーバーをホストしているマシンに対する管理者
権限を備えていることを確認します。
レポート・サーバーをホストしているマシンのタイム・ゾーンを Tealeaf ロール・
タイム・ゾーンに変更した場合、その後、トップ・ムーバーは正常に計算されま
す。
1. Tealeaf レポート・サーバーをホストしているマシンに管理者としてログオンし
ます。
2. Windows ツールバーで、右下隅にある時刻値をクリックします。
3. Windows Server 2008 では、「日付と時刻の設定の変更...」をクリックします。
4. 「タイムゾーンの変更...」をクリックします。
5. 「タイムゾーン」ドロップダウンから、Tealeaf システムのタイム・ゾーンに対
応するタイム・ゾーンを選択します。
注: この変更が一時的なものである場合は、変更を行う前に、選択したタイム・
ゾーンをメモしてください。
6. 「OK」を 2 回クリックします。
7. トップ・ムーバーは、ポータル設定に基づいた、Tealeaf システムのタイム・ゾ
ーンの時刻に再計算されます。
ログのレポート
Tealeaf データ・サービスまたはレポート・サービスを使用している場合、カスタマ
ー・サポートに以下の情報を提供します。
v 関連する日付のすべてのデータ・サービス・ログ・ファイル。これらは、以下の
場所にあります。
<TeaLeaf_install_directory>¥Logs¥TLDataService*.log
v 関連する日付のすべての Tealeaf データベース・マネージャー・ログ・ファイ
ル。これらは、以下の場所にあります。
<TeaLeaf_install_directory>¥Logs¥TeaLeafDatabaseManager*.log
v Windows アプリケーション・イベント・ログに表示されたすべてのエラーまたは
警告。
データ収集プログラムの構成のための追加リソース
このトピックを使用して、データ収集プログラムの構成に関する追加の文書リソー
スを特定します。
データ収集プログラムに関する詳細:
v 「IBM Tealeaf cxImpact 管理マニュアル」の『データの集計および保存』を参照
してください。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『CX 設定』を参照してください。
データ・サービスの構成について詳しくは、「IBM Tealeaf CX 構成マニュアル」の
『Tealeaf データ・サービスの構成』を参照してください。
106
Tealeaf トラブルシューティング・ガイド
レポート・サーバーの構成について詳しくは、「IBM Tealeaf CX 構成マニュアル」
の『レポート・サーバーの構成』を参照してください。
検索サーバー・ログの「Auth failed, no Authorization header on
cmd」エラーへの対処
検索サーバー用にポータル認証または NT 認証が有効になっている場合、認証の失
敗を示すエラーが検索サーバー・ログに表示される場合があります。
例えば、検索サーバー・ログに以下のエラーが表示される場合があります。
Auth failed, no Authorization header on cmd:
/EventDefinitions</Authentication>
Auth failed, no Authorization header on cmd:
/IndexSearchParallelStart</Authentication>
Auth failed, no Authorization header on cmd: /SessionInfo</Authentication>
Auth failed, no Authorization header on cmd: /ResultSet</Authentication>
Auth failed, no Authorization header on cmd: /TLLList</Authentication>
このようなメッセージのいくつかは、製品の通常使用で予期されるものです。
NT 認証またはポータル認証を使用している場合、ユーザーがログインして、当該
の認証で保護されたデータについて検索サーバーに照会しようとするたびに、この
メッセージが 1 回生成されます。
検索サーバーが NT 認証またはポータル認証用に構成されている場合、Tealeaf ユ
ーザーの代わりに Tealeaf サービスによって行われた要求を検証するために、一連
のヘッダーが使用されます。
検索サーバーがチャレンジ・ストリングで応答するまで、このサーバーを呼び出し
ている Tealeaf サービスは認証ヘッダーを追加できません。その後、このストリン
グは、検索サーバーへの後続の照会のヘッダーで使用されます。初期の照会の後に
後続の照会が続くかどうかを検索サーバーが予想できないため、初期要求は拒否さ
れ、このようなメッセージがログに記録されます (実際にエラーである場合)。
v 検索サーバーからの拒否応答には、適切な認証情報を使用して有効な後続の要求
を生成するために使用される一連のチャレンジ・ヘッダーが含まれています。
注: このようなエラー・メッセージが非常に短い間隔で表示される場合、または検
索機能を実行できない状態とともに表示される場合は、認証の構成方法に関する問
題を示している可能性があるため、調査する必要があります。「IBM Tealeaf CX 構
成マニュアル」の『検索サーバーの構成』を参照してください。
通常の状態では、このような項目のいずれかの後には、ほぼ必ず、同じコマンドの
通常のログ項目が続きます。これは、クライアントが正しい認証ヘッダーを 2 回目
の試行で正常に提供したことを示しています。
検索サーバー構成で Active Directory グループを追加できない
新規ドメインを追加するか、ドメインで新規 Active Directory グループを有効にし
た場合、検索サーバー構成でグループを追加できないことがあります。
TMS でグループを追加しようとすると、以下のエラー・メッセージを受け取ること
があります。
第 2 章 Tealeaf データベースのトラブルシューティング
107
Error getting domain groups!
検索サーバー・ログに以下のようなエラー・メッセージが含まれることがありま
す。
Authorization error: NetGroupGetUsers() error
(domainServer: ¥¥MyServer group: corp¥TealeafPortal): Access is denied.
この問題は、ドメインのグループ・セットに対するアクセス権限が原因の可能性が
あります。多くの環境で、新規ドメインは、グループ情報に匿名でアクセスできる
ようにするために、検索サーバーなどの任意のクライアントを許可するように定義
されます。Active Directory のこの「匿名バインド」セキュリティー・ポリシーによ
り、Tealeaf は認証用にグループ情報を使用できます。
一部の環境では、この匿名アクセスが許可されません。名前付きユーザーを使用し
て認証マスター・サーバー上で検索サーバー構成ユーティリティーを実行すること
で、グループ情報にアクセスできることがあります。以下の手順を実行してくださ
い。
1. 認証マスターの名前が分かっていない場合、TMS でそれを見つけます。
a. ポータルに管理者としてログインします。
b. 「ポータル」メニューから、「Tealeaf」 > 「TMS」を選択します。
c. Tealeaf 管理システムが表示されます。「全体ビュー」タブの「表示」ドロッ
プダウンから「サーバー」を選択します。
v TMS について詳しくは、「IBM Tealeaf cxImpact 管理マニュアル」の
『Tealeaf 管理システム』を参照してください。
d. 「検索サーバー構成」ノードを展開します。
e. 「検索サーバー構成」をクリックします。「構成/アクション」パネルで、
「表示/編集」をクリックします。
f. 検索サーバー構成が表示されます。「認証」ウィンドウで、認証マスター設
定の値を確認します。
g. この値が、ご使用の Tealeaf 環境の認証マスターです。
h. 変更をキャンセルし、TMS を終了します。
2. 認証マスター・サーバーで、当該ユーザー・グループ情報にアクセスできる名前
付きユーザーとして実行されるように検索サーバー構成ユーティリティーを構成
する必要があります。
a. 管理者として認証マスター・サーバーにログインします。
b. Windows の「スタート」メニューから、「コントロールパネル」の「サー
ビス」を開きます。
c. 「TeaLeaf Search Server」を右クリックします。「プロパティー」を選択し
ます。
d. 「ログイン」タブで、「このアカウント (This Account)」を使用するように
選択します。
e. ドメイン・グループ情報へのアクセスが許可されるユーザーのユーザー名お
よびパスワードを入力します。
f. 変更を保存します。
g. 検索サーバーを再始動します。
108
Tealeaf トラブルシューティング・ガイド
第 3 章トラブルシューティング - 再生サーバー
このセクションでは、ブラウザー・ベースの再生クライアントに再生用のセッショ
ンを提供する再生サーバーに関連したソリューションのトラブルシューティングに
ついて説明します。
トラブルシューティング - レンダリング問題
再生サーバーによるコンテンツのレンダリングに時間がかかっていると思われる場
合、以下のステップを実行して、ページごとのレンダリング時間を特定します。
1. 再生サーバー・インターフェースにログインします。
2. 「セッション・リスト」リンクをクリックします。
3. ロードされたセッションを選択します。
v セッションがロードされなかった場合、インターフェースのホーム・ページを
使用して、ローカル・デスクトップからセッションをロードできます。
4. SessionNNNN_NNNNNNNNNN のようなリンクが含まれたセッションを選択します。
5. 「NavList」リンクをクリックします。すべてのページ、そのレンダリング時
間、および他の情報が表示されます。
6. 個別ページを選択して、そのレンダリングされた HTML を確認し、異常がない
か探します。
7. 各ページのページ・ロードの詳細 (PLD) リンクを確認することもできます。ペ
ージ・ロードの詳細では、レンダリング時間およびロード時間が公開されていま
す。各ページについて 10 秒未満であれば、妥当な時間と見なされます。
8. 10 秒を大幅に超過しているロード時間が確認された場合、以下のようにしま
す。
v 過度のロード時間が単一のページに当てはまっている場合、その個別ページで
参照されているコンテンツへのアクセスで問題が生じている可能性がありま
す。ページ上の参照を確認し、ブラウザーで各参照をロードします。
v 過度のロード時間が全部ではないが複数のページに当てはまっている場合、遅
い時間が個別サーバーに当てはまっているのかどうかを特定できるかを確認し
ます。個別サーバーに当てはまっている場合、接続またはネットワークの問題
を示している可能性があります。
v 過度のロード時間がサーバー上のすべてのページに当てはまっている場合、問
題が複数のセッションに当てはまっているかを確認します。そうなっている場
合、再生サーバーで問題が生じている可能性があります。Tealeaf
http://support.tealeaf.com にお問い合わせください。
© Copyright IBM Corp. 1999, 2015
109
BBR の再生ビューにエンコードされた文字で応答が表示される問題への対
処
BBR 再生ビューに表示されるヒットの応答で、文字の一部がエンコードされて表示
される (例えば < の代わりに < が表示される) 場合があります。
同じデスクトップからの再生の他の特性は、以下のとおりです。
v RTV は正常に機能している
v BBR 応答ビューは正常に機能している
以下に、BBR 再生ビューの出力例を示し、エンコードされた文字が含まれた応答ビ
ューを示します。
<!doctype html>>!--[if ie]<>![endif]-->
<html lang="nl">
<head id="ctl00_Head1">
<meta http-equiv="X-UA-Compatible" content="IE=8" />
<meta charset="utf-8" />
<title>example.com - Here’s my web site</title>
<meta http-equiv="Content-Language" content="nl" />
<meta name="copyright" content="MyCo - All rights reserved" />
<meta name="author" content="MyCo" />
<meta content="text/javascript" http-equiv="Content-Script-Type" />
<meta id="ctl00_metaRobots" name="robots" content="NOODP" />
<meta name="verify-v1" content="VQALIO5JJtratMWQdcnDiNmlqN/vZObY5iifah8=" />
この正しくない出力の原因としては、以下のものなど、多数の問題のいずれかが考
えられます。
1. ページが返されるのを待機していてポータルがタイムアウトになった
2. 再生サーバー・レンダラーが、コンテンツが元のサーバーから配信されるのを待
機している
3. 再生サーバーが静的コンテンツに接続できない
4. その他の問題
109 ページの『トラブルシューティング - レンダリング問題』を参照してくださ
い。
再生サーバーを構成するための追加リソース
再生サーバーの構成に関する追加リソースを検索するには、このトピックの情報を
使用します。
構成について詳しくは、「IBM Tealeaf CX 構成マニュアル」の『再生サーバーの構
成』を参照してください。
再生サーバーでのプロキシー・エラーが原因で BBR セッションが BBR
で再生されない
BBR は、セッションの再生中にハングしたり、イメージおよび正しいページ・フォ
ーマット設定の表示に失敗したりすることがあります。
110
Tealeaf トラブルシューティング・ガイド
再生サーバーが、プロキシー構成の問題が原因で、元のサイト上のコンテンツにア
クセスできなくなっている可能性があります。
再生サーバーでのプロキシー・エラーが原因でセッションが BBR
で再生されない場合の問題の診断
再生サーバーでのプロキシー・エラーが原因でセッションが BBR で再生されない
問題を診断できます。
この問題を診断するには、以下を実行します。
1. BBR でセッションを再生します。
2. 再生サーバーをホストしているサーバーに管理者としてログインします。通常、
このサーバーはポータル・サーバーでもあります。
3. ブラウザー・ウィンドウを開きます。次の場所にナビゲートします。
http://localhost:38000
注: ローカル・ホストから接続していて、認証が有効になっている場合は、ユー
ザー名とパスワードに ssadmin/ssadmin を使用できます。
4. 再生サーバー・インターフェースが表示されます。
5. 「キャッシュ」をクリックします。
6. キャッシュ・リストを検討します。バイト長が 0 でコンテンツ・タイプがない
項目が複数ある場合、再生サーバーで、内部 Tealeaf プロキシーを介した元のサ
ーバーへの通信で問題が発生しています。
上記の情報が存在する場合は、再生サーバーは、WinInet を使用して元のサーバーに
アクセスするように構成されています。この接続方式では、ローカル・システム・
アカウントを使用して実行している場合 (再生サーバーのデフォルト設定)、プロキ
シーを使用できません。
v WinInet は、ホスティング・サーバー上の Internet Explorer インスタンスによっ
て使用される設定に基づいて構成されます。この設定は、ローカル・システム・
アカウントとして実行されているサービスでは構成できません。
再生サーバーでのプロキシー・エラーが原因でセッションが BBR
で再生されない場合の問題の修正
再生サーバーがドメイン内の名前付きアカウントを使用するように構成すること
で、再生サーバーでのプロキシー・エラーが原因でセッションが BBR で再生され
ない問題を修正できます。
再生サーバーがドメイン内の名前付きアカウントを使用するように構成するには、
以下を実行します。
1. 再生サーバーの構成: 再生サーバーをホストしているサーバーに管理者として
ログインします。
2. 管理者の「コントロールパネル」で、「サービス」パネルを開きます。
3. 「Tealeaf 再生サーバー」を右クリックして、「プロパティー」を選択します。
4. 「ログオン」タブをクリックします。
5. 「アカウント」ラジオ・ボタンをクリックします。
第 3 章トラブルシューティング - 再生サーバー
111
6. 以下のフォーマットで、名前付きアカウントのドメインおよびユーザー名を入
力します。
SomeDomain¥SomeUser
7. パスワードを 2 回入力します。
8. 「適用」をクリックします。
9. 再生サーバー・サービスを再始動します。
10. Internet Explorer の構成: Internet Explorer のインスタンスを開きます。
11. 「ツール」 > 「オプション...」を選択します。
12. Internet Explorer で使用するプロキシー・サーバーを構成します。
注: 詳しくは、インストールされているバージョンの Internet Explorer からア
クセスできる製品資料を参照してください。
13. ブラウザー内で IE キャッシュをクリアします。
14. 「OK」をクリックして「オプション」ウィンドウを閉じます。
注: Internet Explorer を構成した後に、キャッシュをクリアするために、「コン
トロールパネル」の「サービス」から再生サーバーを再始動する必要がありま
す。
15. 構成の検証: 構成を検証するために、以下の URL を使用してキャッシュ設定
をテストできます。これは、ローカル・マシン上の再生サーバーを使用して、
静的コンテンツ URL を処理しています。
http://localhost:38000/GetCacheFile?href=http://www.tealeaf.com/images/
home/slide-deck-1.jpg
16. 上記でイメージが表示された場合、構成は機能しています。
17. 表示されない場合は、以下のようにします。
a. href= の後ろを、Web アプリケーション上の既知の静的コンテンツ・オブ
ジェクトを指す別の URL に置き換えてみます。
b. これが失敗した場合は、IT スタッフとともに構成設定を再検討します。
BBR でのイベントまたはヒット属性の作成時にポータルが含まれているブ
ラウザー・ウィンドウが開かない
BBR を使用して、コンテキスト・メニューからデータを強調表示したり、イベント
またはヒット属性を作成したりすることができます。これらのイベントまたはヒッ
ト属性は、イベント・マネージャーでドラフトが作成され、セッション内で項目を
見つけるためのデータが事前に取り込まれます。場合によっては、コンテキスト・
メニューを使用して、イベント・マネージャーで事前定義されたイベントまたはヒ
ット属性が含まれているブラウザー・ウィンドウを強制的に開くのに失敗すること
があります。
この問題は、以下の 1 つ以上の項目が原因で発生した可能性があります。
v デフォルトでは、Firefox 4 以降で、ウィンドウのフォーカス (前面か背面か) の
切り替えが阻害されます。使用可能にするには、以下を実行します。
1. Firefox を開きます。
2. メニューで、「ツール」 > 「オプション...」を選択します。
112
Tealeaf トラブルシューティング・ガイド
3. 「コンテンツ」タブをクリックします。
4. 「JavaScript を有効にする」オプションを選択します。次に、「拡張」ボタン
をクリックします。
5. 「ウィンドウのフォーカス (前面か背面か) を切り替える」オプションを選択
します。
6. 「OK」を 2 回クリックします。
注: ブラウザー・ウィンドウに開かれているタブが複数あり、「ポータル」タ
ブが前面のタブでない場合は、ウィンドウのフォーカス (前面か背面か) の切
り替えは機能しません。
v Web ブラウザーの JavaScript 設定をチェックしてください。
ページがレンダリングされない
再生サーバーがページをレンダリングしようとしたときに、「Page not rendered」
メッセージが表示される場合があります。
再生時に、応答コンテンツが、以下のエラー・メッセージに置き換えられることが
あります。
Page not rendered. Pages that contain AJAX responses with a text/html content
type or or malformed HTML are not rendered.
Consider adding a replay rule to remove this page.
上記のメッセージが表示された場合、再生サーバーは、ページを正しくレンダリン
グできませんでした。ページを表示できなかった理由については、さまざまな理由
が考えられます。最も単純な解決方法としては、再生からページを削除します。
再生からページを削除するには、以下のようにします。
1. BBR のナビゲーション・リストで、現在選択されているページを右クリックし
ます。
2. 「再生からこのページを削除」を選択します。
3. セッションが次に Tealeaf ユーザーに対して再生される際に、このページは再生
時にスキップされます。
再生ルールの作成について詳しくは、「IBM Tealeaf cxImpact ユーザー・マニュア
ル」の『BBR の再生ルール』を参照してください。
第 3 章トラブルシューティング - 再生サーバー
113
114
Tealeaf トラブルシューティング・ガイド
第 4 章トラブルシューティング - RealiTea Viewer
このセクションの情報を使用して、Tealeaf RealiTea Viewer のインストール、構
成、および使用に関連する問題のトラブルシューティングを行います。
注: リリース 8.0 で、イベント・エディターは Tealeaf ポータルに移動され、RTV
では使用できなくなりました。「IBM Tealeaf イベント・マネージャー・マニュア
ル」の『Tealeaf イベント・マネージャー』を参照してください。
注: RTV でのブラウザー関連の問題については、サポートされるバージョンの
Internet Explorer がインストールされていることを確認してください。「IBM
Tealeaf RealiTea Viewer ユーザー・マニュアル」の『RealiTea Viewer の概要』を参
照してください。
RealiTea Viewer のインストールの問題のトラブルシューティング
RealiTea Viewer のインストール時に問題が発生する場合があります。このセクショ
ンでは、RealiTea Viewer のインストール時に発生する可能性のある問題と、その対
処方法について説明します。
「TeaLeaf RealiTea Viewer requires Microsoft IE V5.0 or
greater」エラーへの対処
IBM Tealeaf CX RealiTea Viewer のインストール時に、Internet Explorer のバージ
ョン・レベルに関連したエラーが表示される場合があります。
エラーの例は以下のとおりです。
TeaLeaf RealiTea Viewer requires Microsoft IE V5.0 or greater.
以下のレジストリー項目を追加することで、問題が修正されることがあります。
[HKEY LOCAL MACHINE¥SOFTWARE¥Microsoft¥Internet Explorer¥Version Vector]
"VML"="1.0"
"IE"="6.0000"
IE 7 をインストールした場合
オペレーティング・システムが最初にインストールされた後に Internet Explorer 7
をマシンに追加した場合は、マシン上に IE のインスタンスが複数存在していま
す。
以下のように、別の項目をレジストリーに追加する必要があります。
[HKEY_LOCAL_MACHINE¥SOFTWARE¥Microsoft¥Internet Explorer¥Version Vector]
"VML"="1.0"
"xIE"="6.0000"
"IE"="7.0000"
Viewer インストーラーの実行後に、"IE"="7.0000" 項目をレジストリーから削除し
て、Internet Explorer の将来のバージョンへのアップグレード時に問題が生じないよ
うにします。
© Copyright IBM Corp. 1999, 2015
115
RTV のアンインストール後にもかかわらず「削除しますか
(Would you like to remove)」が表示され続ける
RTV をアンインストールして、再インストールしようとしている場合、RTV コン
ポーネントが既に削除されているのにもかかわらず、「削除しますか (Would you
like to remove)」ダイアログを受け取ることがあります。
この問題は、InstallShield Installation Information フォルダーが存在することが原因
です。Windows エクスプローラーでフォルダーを表示できず、アンインストール後
に手動でクリーンアップしようとしたときに見つかりにくくなっている可能性があ
ります。修正するには、次のようにします。
注: この変更を行うには、ローカル・マシンに対する管理者権限が必要です。
1. ローカル・マシンで、以下のディレクトリーにナビゲートします。
C:¥Program Files
2. 「Windows エクスプローラー」メニューで、「ツール」 > 「オプション...」を
選択します。
3. 「表示」タブをクリックします。
4. 「ファイルとフォルダの表示」ノードで、「すべてのファイルとフォルダを表示
する」を選択します。
5. 「OK」をクリックします。
6. これで、Program Files フォルダーで、InstallShield Installation
Information フォルダーが表示されているはずです。
7. InstallShield Installation Information フォルダーの各サブディレクトリー
で、setup.ini ファイルを開いてその内容を読みます。RTV インストール情報
が含まれているサブディレクトリーが見つかったら、そのサブディレクトリー全
体を削除します。
RTV パフォーマンスの改善
拡張オプション設定および以下に説明する外部ファイル・データベースを作成する
ことで、RTV のパフォーマンスを改善できます。
RTV における典型的なパフォーマンス上の問題は、JavaScript、スタイル・シート、
およびイメージなどの外部ファイルのロードに関係します。
RTV 拡張オプションの設定
1. 「RTV」メニューで、「ツール」 > 「オプション」を選択します。
2. 「拡張」タブをクリックします。
3. 以下のプロパティー値を設定します。
拡張オプション
値
JavaScript 自動ページ拡張 (Javascript Autopage advanced)
オフ
再生中にイメージを保管
オン
116
Tealeaf トラブルシューティング・ガイド
外部イメージなどにリダイレクトを使用
オフ
セッションの初期ページがロードされた後に、上記の設定により、静的コンテンツ
がローカルに強制的に保管されます。このローカル・ファイルが後続のページ・ロ
ードで使用されるため、セッションの残りのページのロードが加速されます。「IBM
Tealeaf RealiTea Viewer RTV ユーザー・マニュアル」の『RealiTea Viewer - 「拡張
オプション」タブ』を参照してください。
v これらの設定は、ユーザー・プロファイルに対して構成できます。「IBM Tealeaf
RealiTea Viewer ユーザー・マニュアル」の『RealiTea Viewer - プロファイル・
オプション』を参照してください。
外部ファイル・データベースの作成
前の解決方法が不十分な場合、外部ファイル・データベースを作成できます。.tli
ファイルを使用して、再生時に参照される静的コンテンツを保管できます。この方
式を使用することで、セッションの最初のページのロード時間が改善されます。
注: サイトに対して変更を行った場合、この解決方法により、廃止されたバージョ
ンの保管ファイルを RTV が参照する可能性があります。これにより、さまざまな
再生の問題が生じることがあります。サイトの変更を行った場合は、構成から .tli
ファイルを削除し、これらのステップを繰り返して新規ファイルを作成する必要が
あります。
1. 前の解決方法の設定を適用します。 116 ページの『RTV 拡張オプションの設
定』を参照してください。
2. 「オプション」画面で「静的ファイル」タブを選択します。
3. 「「イメージの取得」により静的ファイル・データベースに移動」オプションを
選択します。
4. 「新規」をクリックします。提案された名前を受け入れるか、任意のファイル名
と場所を選択することができます。
5. 「OK」をクリックします。
6. これで、セッションの再生時に外部ファイルが保管されます。再生されるページ
が増加すると、ソース・サーバーから必要とされる要求が減少します。
RealiTea Viewer にイメージが表示されない問題への対処
RealiTea Viewer にイメージが表示されるためには、REQ 内の SERVER_NAME が、ビ
ューアーが実行されているデスクトップから元の Web サーバーに到達できる名前
に解決可能でなければなりません。このようになっていない場合、イメージは表示
されません。
例えば、SERVER_NAME が company.com の場合に、Web サイトにアクセスするた
めにデスクトップで http://www.company.com/ を使用する必要がある場合、ビュー
アーはイメージを取得できません。
この問題を修正するために、以下のように、ビューアー・プロファイル・サーバー
再マップ・オプションを使用できます。
第 4 章トラブルシューティング - RealiTea Viewer
117
1. RTV で、「表示」 > 「オプション」 > 「プロファイル」 > 「プロファイルの
編集」を選択します。
2. company.com というスタンザを作成します。この値は、SERVER NAME にある
ストリングに一致している必要があります。
3. このスタンザで、以下の行を作成します。
SERVER_NAME=www.company.com
4. プロファイルの変更を保存し、オプション・ダイアログを終了します。再生が再
描画され、イメージが存在しています。
キャプチャーされたすべての Web サーバーで、プロファイルにスタンザが必要で
す。 5 つのサーバーがキャプチャーされている場合、5 つのスタンザのそれぞれに
ついて、プロファイルに SERVER NAME=www.company.com を追加する必要がありま
す。例えば、REQ 内の SERVER_NAME が web1、web2、web3 などである場合、そ
れぞれに 1 つのセクションが必要です ([web1]、[web2]、[web3] など)。
RealiTea Viewer でスクリプトが再生されない
「エラー - CallJS: Javascript 関数が見つかりません」により RealiTea Viewer
でスクリプトが再生できない場合があります。
CallJS:JavaScript 関数が見つかりません:
TeaLeaf_Client_tlGetNodeFromXPath エラーの原因の調査
以下の説明に従って、CallJS:JavaScript 関数が見つかりません:
TeaLeaf_Client_tlGetNodeFromXPath エラーの原因を調査できます。
セッションの再生中に、以下のエラーが表示されることがあります。
エラー - CallJS: Javascript 関数が見つかりません:
TeaLeaf_Client_tlGetNodeFromXPath
このエラーは、以下のいずれかの原因によって発生した可能性があります。
1. IBM Tealeaf CX RealiTea Viewer での実行が許可されないスクリプト: IBM
Tealeaf CX RealiTea Viewer は、セッションに組み込まれたスクリプトを再生す
るように構成する必要があります。以下を確認します。
a. 「RTV」メニューから、「ツール」 > 「オプション...」を選択します。
b. 「再生」タブをクリックします。
c. 「スクリプトの実行を許可」チェック・ボックスを選択します。
d. 「OK」をクリックします。
v 「IBM Tealeaf RealiTea Viewer ユーザー・マニュアル」の『RealiTea
Viewer - 再生オプション』を参照してください。
2. 不適切にフォーマット設定された HTML ページ: セッションで、一部の応答で
のみ上記のエラー・メッセージが表示されることがあります。以下のことを確認
してください。
a. セッションを開きます。
b. ツールバーの「再生ツール (Replay tool)」をクリックします。
c. 「表示可能ページ」リストで、エラーが発生したページの 1 つを選択しま
す。
118
Tealeaf トラブルシューティング・ガイド
d. 再生ペインを右クリックし、「ドキュメント・ソースの表示...」を選択しま
す。
e. 応答が表示されます。このページが HTML ページの場合、ページの基本構造
は、以下のようになっている必要があります。以下のタグが存在し、表示さ
れている順にリストされていることを確認してください。タグ間のコンテン
ツは無視して構いません。
<HTML>
<HEAD>
(header content)
</HEAD>
<BODY>
(body content)
</BODY>
</HTML>
f. 表示されたページに上記の構造がない場合は、Web アプリケーションが、選
択したページを正しく構成していない可能性があります。Notepad.exe で表
示されたソース・ページをローカル・コンピューターに保存し、Web アプリ
ケーション開発チームに提供します。
RTV でのセッションの取得中における「結果セットからセッションをロー
ドできません」
完了したセッションについて RTV で検索を実行しているときに、以下のようなエ
ラーを受け取ることがあります。
結果セット RS_20091124-992233-000 からセッションをロードできません
サーバー cximpact:19000
上記のエラーを受け取った場合は、ブラウザーで以下の URL を入力します。
http://cximpact:19000/version
上記の URL で、Tealeaf Search Server (TLSrchSrv) のバージョン情報が含まれた
XML が返されない場合は、以下の URL を試行します。
http://cximpact.mycompany.com:19000/version
上記によって XML が返された場合は、検索サーバー構成で別名として検索サーバ
ーの完全修飾名を指定する必要があります。以下の手順を実行してください。
1. ポータルに管理者としてログインします。
2. 「ポータル」メニューで、「Tealeaf」 > 「TMS」を選択します。
3. Tealeaf 管理システムが表示されます。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『Tealeaf 管理システム』を参照
してください。
4. RTV のローカル・インスタンスによってアクセスされる検索サーバーが含まれ
ているサーバーを選択します。
5. 「検索サーバー」ノードをクリックします。
6. 「検索サーバー構成」をクリックします。
7. 「アクション」パネルで、「表示/編集」をクリックします。
8. 検索サーバー構成で、検索サーバーの完全修飾名を入力します。以下のフォー
マットにすることができます。
第 4 章トラブルシューティング - RealiTea Viewer
119
cximpact.mycompany.com
v http:// は不要です。
v ポート番号 (19000 など) は不要です。
9. 「OK」をクリックします。
10. TMS で、この検索サーバー構成を他のサーバーにプッシュするタスクを構成し
ます。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『TMS の「ジョブ」タブ』を参
照してください。
11. ジョブが完了したら、検索を再実行して、結果が返されるかどうかを確認しま
す。
アーカイブされたセッションの再生時におけるエラー
アーカイブされたセッションの再生中にセッションをロードできなかったことを示
すエラー・メッセージが表示される場合があります。
アーカイブされたセッションで、以下のエラー・メッセージが表示されることがあ
ります。
キャニスター LSSN_* のセッション <session number> をロードできません。
<Server name> で LSSN オープンが失敗しました。
1. 修正するために、インデックス/ポータル・マシンまたはキャニスター・マシンに
対して、検索サーバーからの対応する TLX ファイルを要求できます。または、
アクセスするためにキャニスター・セッション ID を使用できます。
2. 上記のいずれもうまくいかなかった場合、検索サーバーに対して TLC ファイル
を要求します。
3. これがうまくいった場合は、IBM Tealeaf CX を終了し、ポータルを使用して、2
マシン構成の IBM Tealeaf CX サーバー設定に正しい値が含まれていることを確
認します。
4. 再生を再試行します。
ステータス・コード 0 の原因
HTTP StatusCode=0 は、ヒットまたはページの不完全なキャプチャーに関連してお
り、多くの場合、ヒットに「キャンセルされた要求」(ReqCancelled=Client、
ReqCancelled=Server、または ReqCancelled=True") のラベルを付けます。
Passive Capture ソフトウェアによって解釈される要求のキャンセルは、いくつかの
方法で行われることがあります。
1. ページのレンダリングが完了する前に、訪問者が「戻る」ボタンをクリックした
か、表示されているリンクをクリックしました。
2. 訪問者がブラウザーで明示的に「停止」ボタンをクリックするか、キーボードで
Esc キーなどを押すことができます。
3. 要求または応答データの実際の長さが、HTTP Content-Length ヘッダーに指定さ
れている値と異なることがあります。このようになるのは、クライアントまたは
120
Tealeaf トラブルシューティング・ガイド
サーバーが TCP/IP 接続を閉じた、Web サーバーによるコンテンツ長の計算ミ
スやレポートミス、Content-Length ヘッダーがまったく存在しないことが原因の
可能性があります。
いくつかのページで「戻る」ボタンが押されたとビューアーで誤って表示さ
れる
ビューアーは、現在のページの「リファラー」がセッション内の直前のページの
URL でない場合は常に、ブラウザーの「戻る」ボタンが使用されたものと想定しま
す。
この問題に対処するには、以下を実行します。
1. 「戻る」ボタンの挿入をオフにするには、「表示」 > 「オプション」を選択し
ます。
2. 「再生」タブを選択します。
3. 「「戻る」ページの挿入」チェック・ボックスをクリアします。
再生ビューに HTTP ヘッダーが表示される問題への対処
再生ビューに HTTP ヘッダーが表示される場合があります。この問題に対処するに
は、以下の手順を使用します。
1. RTV で、「表示」 > 「オプション」を選択します。
2. 「再生」タブをクリックします。
3. 「HTTP ヘッダー・スキップ」設定を「自動」に設定します。
セッションの再生時にページが欠落する考えられる原因
セッションの再生で一部のページが欠落する場合があります。このトピックでは、
欠落ページの考えられる原因について説明します。
ページが欠落しているように思われるセッションについて、可能性が最も高い原因
は以下のとおりです。
v ページを再生しないようにビューアーが構成されている可能性があります。この
問題を解決するには、次の手順を実行します。
– ページの完全な URL (ファイル拡張子を含む) を取得します。
– ビューアーの解釈済みページのオプションを確認します。
– 再生するファイル・タイプの拡張子のそばにチェック・マークが付いているこ
とを確認します。
– ビューアーのプロファイルのオプションを確認し、欠落しているページの
URL が IGNOREURL 行にリストされていないことを確認します。
v IBM Tealeaf CX Passive Capture Application サーバー (PCA サーバー) を使用し
ている場合は、以下のとおりです。
– PCA サーバー Web UI のインターフェース・ページでキャプチャーするよう
に PCA サーバーが構成されていない Web サーバーが存在する可能性があり
ます。
第 4 章トラブルシューティング - RealiTea Viewer
121
– 欠落しているページのタイプがバイナリー・ファイルです。これを判別するに
は、以下のようにします。
- 自身でセッションを作成します。再生から欠落しているページのファイル拡
張子を調べます。それが、PCA サーバー Web UI の「その他」ページの
ExcludeExtensions リストにある拡張子に一致するかを確認します。
- 一致する場合は、その拡張子を ExcludeExtensions リストから削除し、「変
更の保存」をクリックします (データ・キャプチャーの中断を最小限に抑え
るために、できればWeb トラフィックが低いときに行ってください)。
– PCA サーバーのキャプチャー NIC への入力データに問題が生じていることが
あります。
- ページがないことを認識するセッション・レベルのイベントを定義できる場
合は、焦点を絞った TCPDump を実行して、そのような問題があるかどうか
を判別できます。この問題が発生する可能性が最も高い時刻に、TCPDump
実行 (ファイルへの出力) を開始します。Web サーバー IP アドレス、また
は少なくとも IP ポート番号でトラフィックにフィルターを掛けることがで
きる場合、それにより、出力ファイルのサイズがあまりにも迅速に大きくな
らないようにすることができます。 TCPDump を使用してネットワーク・ト
ラフィックをファイルに記録する手順については、事前準備を参照してくだ
さい。
- 上記の変更を行った後に、ポータルで、欠落しているページのイベントの発
生を観察します。イベントが確認された後に、TCPDump 実行を停止できま
す。次に、イベントを開始したセッションを取得し、そのセッションから
REMOTE ADDR (クライアント IP アドレス) を取得し、TCPDump 出力フ
ァイルをフィルターに掛けて、PCA サーバーへの入力データで一部のデー
タが欠落しているという理由でページが欠落しているかどうかを分析するた
めに、はるかに小さいファイルを作成することができます (手順について
は、事前準備を参照)。
この手順は、対象の Web トラフィックが HTTPS の場合、より複雑になります。
その場合、TCPDump 実行の開始後に発生した、キャプチャーされたセッションの
開始部分を調べて、TCPDump 出力に初期 SSL ハンドシェークが含まれていること
を確認する必要があります。このハンドシェーク・データのキャプチャーは、分析
用にキャプチャーされたデータを暗号化解除する上で重要になります。IIS キャプチ
ャー・フィルターを使用している場合は、以下のとおりです。
v キャプチャー・フィルターがインストールされていない/機能していない/接続でき
ない/Tealeaf サーバーへの十分な帯域幅を備えていない/Tealeaf サーバーへの断続
的なネットワーク障害が発生している Web サーバーがあります。この場合、解
決方法としては、各 Web サーバーの Windows アプリケーション・イベント・
ログを調べて、それぞれに対してフィルターが正しく実行されていることを確認
します。
v 欠落しているページのタイプがバイナリー・ファイルです。これが当てはまって
いるかどうかを判別するには、セッションを手動で操作します。再生から欠落し
ているページのファイル拡張子を調べます。それが、TealeafIIS.cfg ファイルの
ExcludeExtensions リストにある拡張子に一致するかを確認します。一致する場合
は、各 Web サーバーの .cfg ファイルの ExcludeExtensions リストからその拡張
子を削除し、IIS を再始動して .cfg ファイルを再ロードします (できれば、Web
トラフィックが非常に低いときに行ってください)。
122
Tealeaf トラブルシューティング・ガイド
HTTP ステータス・コード 304 およびキャッシュに入れられたオブジェク
ト
オプションとしてサポートされている場合、Web サーバーは、キャッシュに入れら
れたローカル・コピーを使用するようにブラウザーに指示する HTTP ステータス・
コード 304 を返すことができます。
GET 要求の一部として、ブラウザーは、If-Modified-Since というヘッダーを組み
込むことができます。
v Tealeaf でキャプチャーされたヒットの「要求」ビューでは、これは HTTP IF
MODIFIED SINCE と表示されます。
このヘッダーとともに、オブジェクトがいつキャッシュに入れられたのかを示す
日付があります。このヘッダーを検索して、その中の日付を要求されたリソース
の最終変更日と比較するかどうかは、Web サーバーに委ねられています。ほとん
どの Web サーバーでは、このオプションがサポートされます。
Web サーバーでこのオプションがサポートされる場合、キャッシュに入れられたロ
ーカル・コピーを使用するようにブラウザーに指示する HTTP ステータス・コード
304 が返されることがあります。Web ブラウザーとサーバーの間のこの対話でも、
応答本体の長さがゼロの REQ/RSP ペアが生じます。このイベント・シーケンス
は、ブラウザーの「戻る」ボタンを押して、REQ を Web サーバーに発行すること
なく、ローカル・メモリー・キャッシュからページを取得する操作とは異なりま
す。
ローカル・キャッシュにオブジェクトのコピーが見つかった場合、ブラウザーの要
求には、If-Modified-Since ヘッダーのみが組み込まれるため、この動作は、キャ
ッシュに入れることができるファイルにのみ適用する必要があります。
キャッシュを処理する方法は各ブラウザーに完全に委ねられていますが、キャッシ
ュは必ずしもメモリー内キャッシュである必要はありません。Internet Explorer の場
合、キャッシュに入れられたファイルは、ローカル・ディスク上の一時インターネ
ット・ファイルとして保管され、IE の「インターネットオプション」で明示的に
削除するまで保持されます。そのため、ブラウザーを終了して再び開いても、304
を回避することはできません。
「再生オプション (Replay options)」タブで「リモート 304 ページのロード」チェ
ック・ボックスを選択した場合、If-Modified-Since ヘッダーを組み込まない単純
な GET 要求を実行するため、Web サーバーは、304 応答ではなく、オブジェクト
を返します。ただし、ビューアーは、元の訪問者が見たのと同じオブジェクトを取
得していない可能性があります。結果として行われる (ホーム・ページなどへの) リ
ダイレクトは、セッションの再生時にすぐに明らかになるわけではないため、通
常、このオプションは無効にされます。
v 「IBM Tealeaf RealiTea Viewer ユーザー・マニュアル」の『RealiTea Viewer - 再
生オプション』を参照してください。
第 4 章トラブルシューティング - RealiTea Viewer
123
セッションで .css ファイルが欠落している理由
カスケーディング・スタイル・シート (.css) ファイルは、静的コンテンツと見なさ
れます。Tealeaf 環境がどのように構成されているのかに応じて、以下のファイル・
タイプの一部およびすべては、キャプチャーからドロップされることがあります。
.au, .avi, .bin, .bmp, .cab, .class, .css, .dcr, .doc,
.exe, .gif, .gz, .htc, .htrc, .jar, .jpeg, .jpg, .js,
.mov, .mp3, .mp4, .mpe, .mpg, .pdf, .png, .ppt, .ra, .ram,
.rar, .rm, .rtf, .snd, .swf, .tif, .tiff, .wav, .xls,
.zip, .ico
上記のファイル拡張子リストは、多数の一般的なバイナリー・ファイル・タイプを
示しています。これは、以下のメカニズムを使用して管理できます。
v PCA: PCA Web コンソールの「パイプライン」タブを使用して、バイナリー・
コンテンツを管理する以下の方法を構成できます。
– 除外される拡張子リストに拡張子が存在しているキャプチャー・ファイルを、
PCA によって自動的にドロップします。「IBM Tealeaf Passive Capture
Application PCA マニュアル」の『PCA Web コンソール - 「パイプライン」
タブ』を参照してください。
– PCA ビルド 3502 から、イメージとして識別された応答をドロップするように
PCA を構成できます。「IBM Tealeaf Passive Capture Application PCA マニュ
アル」の『PCA Web コンソール - 「パイプライン」タブ』を参照してくださ
い。
v Windows パイプライン:
– DelImages は、データ・ドロップ・セッション・エージェントで有効になって
いる場合、Windows パイプライン内のイメージ・データを破棄して、繰り返し
の静的コンテンツがセッションに保管されないようにします。「IBM Tealeaf
CX 構成マニュアル」の『データ・ドロップ・セッション・エージェント』を
参照してください。
– オプションとして、キャプチャーされたセッションの永続スナップショットを
保持するために、静的コンテンツをキャプチャーして保管するように静的アー
カイブを構成できます。
注: 静的アーカイブがデプロイされている場合は、DelImages を無効にする必
要があります。「IBM Tealeaf cxImpact 管理マニュアル」の『静的アーカイブ
の管理』を参照してください。
Tealeaf 環境がどのように構成されているのかに応じて、静的コンテンツ (スタイ
ル・シート (.css ファイル) を含む) が処理時にドロップされることがあります。
ファイル拡張子がドロップ対象として構成されている場合、Tealeaf は応答を破棄し
ます。
v 要求の HTTP ステータス・コードが 200 の場合、その要求はドロップされま
す。結果として、静的コンテンツの要求は、要求を満たす際にエラーが発生しな
い限り、セッションのページ・リストに表示されません。
各ページでこれらのファイルに対する要求を複数回行うことがあるため、これらの
タイプの正常なヒットをすべて保管すると、データベースおよびインデックスのス
ペースを浪費する可能性があります。これらの静的ファイルはめったに変更されま
せん。特定のエラーがない限り、正常に配信されたと想定する方が合理的です。
124
Tealeaf トラブルシューティング・ガイド
静的 HTML ページの再生時におけるエラー
再生時に、同一ページへの複数の強調表示されたリンクが表示される場合がありま
す。
Missing anchor attributes in the <A> link HTML tag
同じ HTML ページ上の項目にリンクされたアンカー属性は、セッションにおいて
ページとともにダウンロードされません。これらの項目はクライアント・サイドの
タグ機能であるため、同じページへの複数の強調表示されたリンクが表示されるこ
とがあります。
Internet Explorer の最新バージョン用に作成されたアプリケーションでの
再生の問題
一部の Web アプリケーションは、Internet Explorer の最新バージョンで導入されて
いる最先端の機能を利用するように作成されています。組み込みバージョンの IE
Web ブラウザー・コントロールを使用する RTV などのアプリケーションでは、こ
れらの機能を使用できるようにするために特定のレジストリー設定を行う必要があ
ります。
注: 変更を行う前に、デスクトップにインストールされている IBM Tealeaf
cxImpact ソリューションとの互換性がある最新バージョンの RTV があることを確
認する必要があります。Tealeaf ソフトウェアのダウンロードについて詳しくは、
『Tealeaf CX のダウンロード』を参照してください。
デフォルトでは、RTV の Web ブラウザー・コントロールは、IE 7 互換モードに
戻るため、再生時に予期しない動作につながる可能性があります。症状には、以下
のものが含まれることがあります。
v 文字サイズの違い
v 用紙位置決め
v CSS の異常
互換性のため、アプリケーションに対して機能制御キー値が定義されていない場
合、デフォルトで、Web ブラウザー・コントロールは IE7 標準モードで実行され
ます。
正しく再生されるようにするために、デフォルトで適切な IE ブラウザー・バージ
ョンになるように、RTV で使用される IE Web ブラウザー・コントロールを構成
する必要があります。 IE8 標準モードで RTV Web ブラウザー・コントロールを
実行するには、以下の新しい値をレジストリーに追加します。
[(HKEY_CURRENT_USER or HKEY_LOCAL_MACHINE)¥Software¥Microsoft¥
Internet Explorer¥Main¥FeatureControl¥FEATURE_BROWSER_EMULATION]
"RealiTeaPro.exe" = dword 8000 (Hex: 0x1F40)
http://msdn.microsoft.com/en-us/library/ee330730%28v=vs.85%29.aspx#browser_emulation
を参照してください。
第 4 章トラブルシューティング - RealiTea Viewer
125
IE6 のプロキシー問題
IE6 を使用して Web アプリケーションにプロキシー・サーバー経由で接続してい
る場合、RTV で再生の問題が発生することがあります。この問題は、再生時に再生
ウィンドウにステータス・コード 404 エラー・ページが表示されるという形で現れ
ます。応答データが正確で、イメージ・ダウンロードが機能しているように見える
にもかかわらず、実際にはコンテンツがキャプチャーされません。
RTV は、ご使用のローカル・コンピューターにインストールされている IE バージ
ョンの組み込みバージョンの Internet Explorer コントロールを使用します。RTV
は、再生で使用するために内部 HTTP サーバーを作成します。プロキシー・サーバ
ーをバイパスして、代わりにローカル・サーバーを使用するように IE コントロー
ルが構成されていない場合、RTV はコンテンツを再生できないことがあります。
IE7 以降は、このバイパスを実行するように自動的に構成されています。IE6 で
は、プロキシーをバイパスしてローカル HTTP サーバー・アドレスを使用するよう
に Internet Explorer を手動で構成する必要があります。
1. ローカル・システム上で、Internet Explorer 6 を開きます。
2. 「IE」メニューで、「ツール」 > 「オプション...」を選択します。
3. 「接続」タブをクリックします。
4. 「LAN の設定...」をクリックします。
5. 左の「プロキシーサーバー」ペインで、以下を行います。
a. 「LAN にプロキシサーバーを使用する」チェック・ボックスをクリックしま
す。
b. 「ローカルアドレスにはプロキシサーバーを使用しない」チェック・ボッ
クスをクリックします。
6. 「OK」をクリックします。
7. 「OK」をクリックします。
8. IE6 を閉じます。
9. RTV を再始動します。
IndexWizard.dll is incompatible メッセージへの対処
ビューアーに IndexWizard.dll が非互換であることを示すメッセージが表示される
場合があります。この問題に対処するには、以下の手順を使用します。
RTV ダイアログは以下を表示します。
IndexWizard.dll is incompatible, Viewer cannot find .tlx file.
1. 「コマンドプロンプト」ウィンドウを開き、RTV ビューアー・インストール・
ディレクトリーに入ります。
2. 以下のコマンドを実行します。
regsvr32 IndexWizard.dll
126
Tealeaf トラブルシューティング・ガイド
埋め込みの .pdf 文書が別ウィンドウで開く問題への対処
PDF 文書がビューアーではなく別ウィンドウで開く場合、PDF が埋め込み文書とし
て開くようにプロパティーを設定できます。
Adobe Reader 8 のインターネット設定に、ブラウザー・ウィンドウ内で .pdf を開
くための設定があります。この設定を有効にする必要があります。
イベント・アイコンが使用不可になる問題への対処
このセクションの情報を使用して、イベント・アイコンが使用不可になる問題の原
因をトラブルシューティングします。
イベント・アイコンが使用可能になっていない場合、ご使用の Tealeaf デプロイメ
ントに応じて、以下のいずれかの構成を実行します。
オールインワン Tealeaf またはスタンドアロン・ポータル・サー
バー・デプロイメントで使用できないイベント・アイコンへの対処
オールインワン Tealeaf またはスタンドアロン・ポータル・サーバー・デプロイメ
ントでイベント・アイコンが使用できない場合、以下の手順に従います。
1. ポータル・サーバーで RegEdit を実行します。
2. 次の場所にナビゲートします。
HKEY LOCAL MACHINE¥ SOFTWARE¥TeaLeaf Technology¥DataStore¥SearchServer
3. EventImagesPath は、...¥TeaLeaf¥Portal¥WebApp ディレクトリーの絶対パスで
ある必要があります。
マルチサーバー・デプロイメントでイベント・アイコンが使用でき
ない問題への対処
マルチサーバー・デプロイメント環境でイベント・アイコンが使用できない場合、
以下の手順を実行します。
1. ポータルに管理者としてログインします。
2. 「ポータル」メニューから、「Tealeaf」 > 「TMS」を選択します。
3. 「全体ビュー」タブで、キャニスターをホストするサーバー (処理サーバー) を
選択します。
a. 「検索サーバー」ノードを開きます。
b. 「検索サーバー構成」ノードをクリックします。
c. 「表示/編集」をクリックします。
d. ポータル・サーバーに適切な値を入力します。
e. 変更を保存します。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『TMS の「全体ビュー」タ
ブ』を参照してください。
4. 環境内に複数のキャニスターがある場合は、各キャニスターについて上記の
TMS ステップを繰り返します。
第 4 章トラブルシューティング - RealiTea Viewer
127
5. 単一または複数のキャニスター・サーバーに変更をプッシュするようにジョブを
構成します。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『TMS の「ジョブ」タブ』を参
照してください。
再生ルールの問題のトラブルシューティング
このセクションの情報を使用して、再生ルールに関連した問題のトラブルシューテ
ィングを行います。
IgnoreURL ルールがイベント・リストをページ・リストとマージし
てしまう問題への対処
非常に稀に、IgnoreURL ルールが原因でイベント・リストがページ・リストにマー
ジされることがあります。
新規 IgnoreURL ルールを作成した場合、イベント・リストがページ・リストにマー
ジされていることに気付くことがあります。これはあまり発生しません。
この問題を修正するには、以下のステップを実行します。
1. セッションで保存されていない変更がある場合、保存します。
2. セッションを閉じます。
3. 再度開きます。
4. 各ペインが通常どおりに分離したものになります。
長時間の使用後に RealiTea Viewer (RTV) が異常終了する問題への対処
朝に RTV を開き、セッションの検索と再生に数時間費やした場合、RTV は、一時
ディレクトリーで大量のディスク・スペースを消費します。長時間の使用後に、
RTV アプリケーション・ウィンドウが突然消えることがあります。
RTV は、再生の実行時にセッションのすべてのヒットをダウンロードします。検索
の実行時には、検索に一致する特定のヒットをダウンロードする必要があります。
長時間の使用後に RealiTea Viewer (RTV) が異常終了する場合、以下を実行しま
す。
v 検索をより制限的なものにします。利点は 2 つあります。
– 検索が早く完了する
– RTV を実行しているコンピューターにおける結果セットによる消費メモリー
が削減される
v 検索後に、再生を開始する前に、ヒット結果が表示されるまで待機します。RTV
が個別にヒットをダウンロードしてすぐに再生しようとしている場合は、RTV が
個別ヒットをダウンロードしているときに RTV 検索結果画面の右上にある「キ
ャンセル」をクリックします。
v 1 時間程度ごと、または 20 件のセッションを再生した後に中断して RTV を閉
じてから、再び開きます。この再始動により、RTV は、メモリーおよびディス
ク・キャッシュからスペースを解放できます。
128
Tealeaf トラブルシューティング・ガイド
DWR POST の POST データの突き合わせが失敗する
リリース 8.4 にアップグレードし、サイトで DWR を使用してメッセージを Web
サーバーに転送する場合、POST を正しく突き合わせるために、パッチを適用し、
RTV 再生プロファイルで変更を行う必要があります。
「IBM Tealeaf RealiTea Viewer ユーザー・マニュアル」の『RealiTea Viewer の概
要』を参照してください。
複数のバージョンの IBM Tealeaf cxImpact にアクセスするための RTV
の構成
サイトに複数のバージョンの IBM Tealeaf cxImpact がインストールされている場
合、各バージョンをアクセスするように RTV を構成できます。
v 既知のバージョン: 46xx 以降
RTV の問題領域はイベント・エディターです。使用している各バージョンの IBM
Tealeaf cxImpact についてイベント・エディター DLL を最新バージョンの RTV が
使用できるようにする必要があります。以下の例では、2 つのバージョン (6050 と
7075) の IBM Tealeaf CX を使用しています。
1. RTV の最新リリースの完全バージョンをインストールします。
2. リリース 6050 の Tealeaf インストール・ディレクトリーで EventEd.dll ファ
イルを検索します。
3. このファイルを EventEd6050.dll に名前変更します。
4. このファイルをリリース 7075 の RTV ディレクトリーにコピーします。
5. 6050 キャニスターのイベントを編集するには、以下のようにします。
a. RTV を閉じます。
b. Windows の「スタート」メニューから「ファイル名を指定して実行」を選択
します。
c. 以下のコマンドを実行します。
regsvr32 EventEd6050.dll
d. RTV を再度開きます。
6. 70755 キャニスターのイベントを編集するには、以下のようにします。
a. RTV を閉じます。
b. Windows の「スタート」メニューから「ファイル名を指定して実行」を選択
します。
c. 以下のコマンドを実行します。
regsvr32 EventEd.dll
d. RTV を再度開きます。
トラブルシューティング - 再生の説明
このセクションでは、IBM Tealeaf CX RealiTea Viewer を使用した Tealeaf セッシ
ョンの再生での一般的な問題を診断するために従うことができる準備ステップの再
生の説明の概要を示します。
第 4 章トラブルシューティング - RealiTea Viewer
129
以下のセクションでは、一連のステップで概要を示し、特定の再生状態に関連した
一般的な問題を緩和するのに役立つ例がいくつか含まれています。
再生の概要
再生時に、RTV は、ターゲット Web ページのバージョンを、制御できる Internet
Explorer のインスタンスにロードします。ターゲット・ページで必要なオブジェク
トが要求されると、RTV は IE インスタンスの要求をインターセプトし、ロードさ
れたセッションに要求されたオブジェクトがあるのかどうか、または元のサーバ
ー、Web アプリケーションから取得する必要があるのかどうかを判別します。
RTV はセッション・データでオブジェクトを見つけることができる場合、そのバー
ジョンを作成して、使用しているプロキシー・サーバーを介してそれを要求し、外
部 Web サーバーから取得したかのように、要求されたオブジェクトを配信しま
す。
v 要求のヘッダーを確認すると、このようなプロキシーを介した要求は通常、
localhost:<some_port_number> から発信されています。
イメージ、JavaScript、および CSS は通常、キャプチャーされず、セッション・デ
ータに保管されません。これは、これらの項目はあまり変更されず、大きなストレ
ージのオーバーヘッドが必要になるためです。再生時に、これらの項目は一般的
に、元のサーバーから要求されます。HTML、顧客データに基づいて作成されたス
クリプト、JSON、およびバイナリー・データなどの他の項目は通常、セッション・
データにキャプチャーされます。これらは、再生時にライブで要求された場合、変
更されていたり、使用不可であったりする可能性があるためです。
注: キャプチャー時と再生時で同じである必要があるすべてのデータをセッショ
ン・データにキャプチャーする必要があります。
再生の問題のテーブルを含む一般的な問題のトラブルシューティングについて詳し
くは、 136 ページの『次のステップ』を参照してください。
チェック 1. 必要なものがすべてセッション内にあることを確認する
RTV の「ページ・ロードの詳細」ページで、Web ページがセッションおよび元の
サーバーに対して要求している各オブジェクトを確認できます。
v 項目が存在すれば、ページ・ロードの詳細により、正しく再生されていないエレ
メントに対する洞察が得られることがあります。
v ページ・ロードの詳細にアクセスするには、「表示」 > 「ページ・ロードの詳
細」を選択します。
必要なすべてのデータがセッション・データ内にあり、サーバーからアクセスでき
ることを確認することで、多くの複雑に見える再生の問題を修正できます。多くの
場合、欠落しているか再生に失敗している UI エレメントは、セッションから欠落
している POST または JSON 要求が使用可能になるとすぐに、修正されます。
例
v 再生時に JavaScript または CSS が正常に取得されない場合、サイトが正しく再
生されないか、レンダリングの品質が不十分になる可能性があります。
130
Tealeaf トラブルシューティング・ガイド
– このタイプのエラーは簡単に修正されます。
v 一部のファイルが、Cookie またはログイン・アカウントなどのユーザー資格情報
に基づいて作成されています。
– これらのファイルがセッション・データにキャプチャーされていないにもかか
わらず、再生時に要求された場合、通常、正常に完了しません。ほとんどの場
合、ファイルの汎用バージョンが元のサーバーから返されるか、要求時にリダ
イレクトが行われ、ホーム・ページなどの別の無関係なページが返されます。
この問題により、不安定な再生になります。
v Web ページの UI エレメントに動的に影響を及ぼすために POST データが必要
な場合、このデータをセッション・データにキャプチャーする必要があります。
– 一般的な例としては、前の選択に基づいて自動的にデータが取り込まれるドロ
ップダウン・リストや、ユーザーの入力に基づいて切り替えられるラジオ・ボ
タン・グループがあります。
– 再生時には通常、UI エレメントが変更されると、要求が発行されます。この
要求は通常、ページに必要なデータを送信するようにサーバーに指示する
POST 要求です。キャプチャー時に発生した内容を再生で正確に表すには、こ
の要求および返されるデータがセッション内になければなりません。
– これらのデータをキャプチャーするために、UI Capture を実装する必要が生じ
ることがあります。
v 特定の場合として、再生を正常に機能させるために、JavaScript をセッション・デ
ータにキャプチャーする必要がある場合があります。
– 良い例として、.NET Web サイトの ashx ファイルが挙げられます。このタイ
プのファイルには、ページの UI エレメントを制御するために必要なスクリプ
ト・コードが含まれているためです。
– ユーザーと Web ページの対話中にこのようなデータがサーバーで動的に作成
されている場合、再生で、キャプチャー時に使用されたバージョンと同じバー
ジョンを参照する必要があります。この場合、正しく再生するために、カスタ
ムビルドの JavaScript をセッション・データにキャプチャーする必要がありま
す。
v 疑わしいときは、ページ・ロードの詳細を確認してください。
サインインが必要なサイトの再生
お客様が、ログインしていないユーザーからのイメージ、スクリプト、オブジェク
トなどの静的コンテンツのほとんどをブロックしている場合、恐らく、RTV が再生
時にこのコンテンツを取得する際に問題が生じます。
オプション
v コンテンツを取得して、再生時に提供できるようにコンテンツを保管できる
Tealeaf ポータル・サーバーなどのプロキシー・サーバーに配置できます。このシ
ナリオでは、静的コンテンツの URL をプロキシーにマップするためのホスト/ポ
ートの再マップ・ルールが必要です。
v PCA でビジネス IT モードを有効にして、すべてのイメージおよび静的コンテン
ツがキャプチャーされるようにすることができます。
– ブラックリストに入れられた拡張子および MIME タイプを削除し、ファイル
名拡張子をホワイトリストに追加する必要があります (gif、jpg など)。
第 4 章トラブルシューティング - RealiTea Viewer
131
– また、処理サーバーにおいて、DataDrop パイプライン・エージェントで
DelImages が無効になっていて、コンテンツがドロップされないようになって
いることを確認する必要もあります。「IBM Tealeaf CX 構成マニュアル」の
『データ・ドロップ・セッション・エージェント』を参照してください。
注: PCA ビルド 3502 から、PCA パイプラインでこの機能を有効にすること
ができます。これにより、処理されて処理サーバーに送信されるデータのボリ
ュームが制限されます。「IBM Tealeaf Passive Capture Application PCA マニ
ュアル」の『PCA Web コンソール - 「パイプライン」タブ』を参照してくだ
さい。
注: この構成では、セッション内のすべてのコンテンツをキャプチャーしま
す。このモードで動作すると、ストレージ要件が劇的に増大するため、使用す
るのは、POC や再生をデモンストレーションする必要がある他の一時的な状態
の際のみにしてください。この解決方法は、一時的に使用するためだけのもの
です。
チェック 2. 必要なデータがプライバシーによってブロックされていないこ
とを確認する
プライバシーを使用して、お客様の機密データを覆い隠します。プライバシーはお
客様のデータを保護しますが、再生に必要なデータがブロックされる可能性があり
ます。
再生の問題を引き起こす一般的なルールは、BlockURLFields です。このルールは、
URL の末尾の ? 文字の後に付加されたすべてのパラメーターをブロックします。
再生時に、ナビゲーション・リスト (左上ペイン) の URL の多くで、後ろに X 文
字のリストが続いていることが確認された場合、プライバシー設定の問題が発生し
ている可能性があります。
v ナビゲーション・リスト内の URL の後ろに反復文字が続いている場合は、通
常、プライバシーがその原因です。
RTV が要求をセッション内のデータと突き合わせるには、覆い隠された URL パラ
メーターが必要になります。要求を突き合わせることができなかった場合、元のサ
ーバーに対して要求されます。返されるヒットは、元々キャプチャーされたヒット
とは同じではないため、再生の品質が不十分になります。
例
v セッションのメインページ要求に URL パラメーターが含まれている場合、それ
らを覆い隠すと、RTV に強制的に元のサーバーに対して要求させる可能性がある
ため、再生の品質が不十分になり、ページのヒット・カウントが不自然に増加し
ます。
v .NET サーバー・セッション内の .axd ページがプライバシーによってブロックさ
れている場合、JavaScript イベントに応答するために必要な、Web ページの重要
な部分が使用不可になります。
132
Tealeaf トラブルシューティング・ガイド
– 通常、各要求について、これらのページは同じ名前で (例えば、
WebResource.axd?xxxxxxx) 異なるコンテンツを持つため、ページに必要なセッ
ション内の WebResource.axd のバージョンを RTV が判別するために、URL
パラメーターが必要になります。
– これが発生する可能性があるファイル・タイプがいくつかあります。UI コン
トロールの特定の JavaScript が含まれているファイルはすべて、再生時にセッ
ション・データから使用可能でなければなりません。
v POST データがプライバシーによってブロックされるか、プライバシーによって
ブロックされた URL パラメーターが POST 要求に含まれている場合、その
POST 要求は正しく突き合わせされないため、UI エレメントの再生に失敗しま
す。
v ページを固有にするために使用されているパラメーターがプライバシーにブロッ
クされた場合、その URL の再生が妨げられます。あるお客様のサイトで、
document および page パラメーターを使用して、アプリケーション・フォームの
動的に生成された GIF イメージが要求されていました。これらのパラメーターが
ブロックされ、RTV でイメージの検索に失敗しました。イメージは、セッション
内に存在していた場合でも、表示できませんでした。
チェック 3. Client UI Capture for Ajax が使用中で、そのイベントがキ
ャプチャーされる
Tealeaf は、お客様の Web サイトにデプロイされ、訪問者が Web サイトをナビゲ
ートする際に訪問者のブラウザーに提供される IBM Tealeaf CX UI Capture for
AJAX を用意しています。
この JavaScript は、クライアントの Web ページ上の UI エレメントにフックさ
れ、訪問者が UI エレメントと対話したときにイベントを Tealeaf システムに返送
します。イベントは、XML データに変換され、Ajax を使用して Web サイトに
POST して戻されます。
v 「IBM Tealeaf UI Capture for Ajax Guide」の『UI Capture for Ajax Guide』を参
照してください。
UI イベントはキャプチャーされた後に、再生時に RTV で使用するためにセッショ
ンに保存されます。イベントは、XML のバンドルとして取得され、RTV のセッシ
ョンの REQ ビューで表示できます。RTV は、タイム・スタンプおよび他のパラメ
ーターを使用して、これらのイベントをソートしてセッション内のページに関連付
けます。
イベントは、ユーザーが Web アプリケーションと対話している間にキャプチャー
されたものであるため、ユーザーが Web ページで各 UI エレメントとどのように
対話したかを対話順に再生できます。ただし、このタイプの再生が正しく機能する
には、イベントが親ページに正しく突き合わされる必要があり、またイベントが関
連する UI エレメントが再生時にページの UI で使用可能でなければなりません。
注: 再生は順次です。あるイベントが正しく再生されなかった場合、次の再生イベ
ントのセットも失敗することが予期できます。
第 4 章トラブルシューティング - RealiTea Viewer
133
ライブラリーの組み込みおよびセットアップについて詳しくは、「IBM Tealeaf UI
Capture for Ajax Guide」の『UI Capture for Ajax Guide』を参照してください。
例
v Web ページがフォームを含んでおり、Tealeaf IBM Tealeaf CX UI Capture for
AJAX を参照しています。フォームは、ラジオ・ボタン・セットの値に基づい
て、表示されるか非表示になります。ラジオ・ボタン・イベントの再生が失敗し
た場合、再生時にフォームは表示されません。
– この場合、フォームが UI に存在していないため、当該ラジオ・ボタンのクリ
ック後にフォーム・フィールドに入力するすべての再生イベントの再生も失敗
します。このよくある状態には、さまざまなバリエーションがあります。
v Web ページに一連のドロップダウン・リストがあります。リスト 1 での選択
は、リスト 2 のコンテンツに影響します。例えば、リスト 1 で「ホンダ」を選
択した場合、ページは、「ホンダ」が製造する型式を要求してリスト 2 を埋めま
す。必要なデータをプライバシー機能がブロックしたために、リスト 1 での要求
が失敗し、要求の結果として HTTP 404 エラーになった場合、またはリスト 1
のイベントが開始できなかった場合、リスト 2 の再生が失敗します。例えば、リ
スト 2 に依存しているリスト 3 がある場合、リスト 3 のイベントも失敗しま
す。この場合、チェック 1 および 2 に従って、UI イベント・データがセッショ
ンでキャプチャーされていること、および要求が正しく突き合わされていること
(例えば、プライバシー・ブロッキングなし) を確認します。
v 前に xpath が含まれた複数のイベントがあり、それらにメンバーの長いリストが
あり、「value」データがないことがあります。このようなイベントは、再生時に
何も行わず、また後続のすべての UI イベントも何も行いません。
– この場合、XPATH イベントに、恐らくページ上のコンテンツに突き合わせるこ
とができない重要な情報が欠落しているため、RTV はイベントを UI エレメ
ントに送信できません。
注: この状態は複雑です。Tealeaf エンジニアリングに問い合わせて支援を要請
してください。
チェック 4. ナビゲーション・リストの各ページに対して要求されているメ
インページが 1 つのみであることを確認する
再生に関する一般的な問題が発生するのは、RTV ユーザーがナビゲーション・リス
トのページをクリックしたときです。ページが表示されてから非表示になり、HTTP
404 または別の正しくないページに置き換えられます。
このシナリオでは、RTV が再生時に UI のエレメントを強調表示する際に、
JavaScript または HTML を実行しました。Web アプリケーションへの訪問時に訪
問者によってクリックされたエレメントを示すために再生時にフィールドおよび UI
エレメントを強調表示するように RTV を構成できます。
RTV では、再生強調表示オプションにより、現在強調表示されている UI エレメン
トに関連したスクリプトを実行し、元の Web サイト用のスクリプトで指定された
すべてのアクションを実行できます。元のサイトが単純であり、UI コントロールで
エレメントを切り替えない場合は、このオプションは必ずしも必要とは限りませ
134
Tealeaf トラブルシューティング・ガイド
ん。ただし、サイトで複雑な JavaScript の動作を使用して UI エレメントを制御し
ている場合は、再生時にこれらのスクリプト・アクションを実行する必要がありま
す。
v RTV で、「ツール」 > 「オプション」 > 「再生」タブを選択します。オプショ
ンのラベルは、「強調表示時に JavaScript を呼び出す」です。
例
v 親サイトに現在のページからナビゲートして離れるための「次へ」ボタンがある
場合、恐らく、RTV がそれを強調表示したときにナビゲーションが発生します。
ナビゲーションが発生しないようにこのアンカー・タグまたは JavaScript を削除
する必要があります。
–
137 ページの『第 5 章再生の問題のテーブル』を参照してください。
v 画面の残りを非アクティブにして、対話できるフォームを表示するオーバーレ
イ・ページがあります。
チェック 5. フレーム・コンテンツが正しく構成されていることを確認する
フレームを使用している Web サイトでは、再生でページを正しく表示するための
作業が必要になることがあります。多くの場合、セッション内の 1 ページは親フレ
ームになり、ナビゲーション・リスト (左上のリスト) 内のそれ以降のページは、親
の中に配置する必要がある子フレームになります。
フレームを適切に再生できるようにするために、以下の RTV 機能を有効にする必
要があります。
v 「ツール」 > 「オプション」 > 「再生」 > 「フレームの再生」 (必須)
v 「ツール」 > 「オプション」 > 「拡張」 > 「リモート・フレームの再生
(Replay Remote Frames)」 (オプション)
v 「ツール」 > 「オプション」 > 「拡張」 > 「アグレッシブ・フレーム配置」
(オプション)
次に、以下のように、RTV にフレーム・セットの階層を指示する必要があります。
1. 親ページであると思われるページを見つけます。ナビゲーション・リスト内のそ
のページをクリックし、「応答」ボタンをクリックして、応答の HTML コード
を調べます。このコードに、<FRAME> タグが含まれているはずです。このタグの
内部に、ナビゲーション・リスト内の後続ページの URL が表示されます。
v 見つかった後に、ナビゲーション・リスト内の親ページを右クリックし、「再
生ルール」 > 「このページをフレームに配置」 > 「_top」を選択できます。
親ページは、後続のすべての子ページを保持するように構成されます。
2. ナビゲーション・リストから親ページ内に配置する必要がある各ページを見つけ
ます。各ページを右クリックし、「再生ルール」 > 「このページをフレームに
配置」を選択してから、当該エレメントに関係したフレーム ID を選択します。
v 通常、親ページの FRAME エレメントにある src パラメーターには、割り当て
る子エレメントの URL が含まれています。その場合、親ページ内の FRAME
エレメントの name または ID パラメーターを使用して子を割り当てます。
第 4 章トラブルシューティング - RealiTea Viewer
135
次のステップ
問題が解決しない場合、『再生の問題のテーブル』を参照してください。
137 ページの『第 5 章再生の問題のテーブル』を参照してください。
136
Tealeaf トラブルシューティング・ガイド
第 5 章再生の問題のテーブル
このページは、RTV を使用したセッションの再生に影響する問題に対する解決方法
を見つける入り口点となります。
このページを使用するには、以下のようにします。
v 以下のリンク内のシナリオを確認します。シナリオは S-## で始まります。
v 該当するシナリオが見つかったら、すべての質問に 1 つずつ答えてください。
注: 可能であれば、以下のページを確認する際には、インターネットに接続され
た状態にしてください。このページにある解決方法では、再生の説明や Tealeaf
オンライン・ヘルプ内の別の場所にリストされている解決方法を参照することが
あります。
v
139 ページの『S-01. 再生内のページが表示されない、または正しいページではな
い』
–
v
v
139 ページの『Q-01. ページが正しく要求されているかどうかを確認するため
にページ・ロードの詳細を確認しましたか?』
139 ページの『S-02. 再生時にエレメントが Web ページに表示されない』
–
139 ページの『Q-01. ナビゲーション・リスト (左上のペイン) 内のページの
いずれかの後に、単一文字のリスト (XXXXX や @@@@ など) があります
か? 』
–
140 ページの『Q-02. イメージおよび CSS 以外で 404 ステータス・コードに
なる要求はありますか? 』
–
140 ページの『Q-03. ページ・ロードの詳細にホーム・ページに対する複数の
要求または複数のリダイレクトがありますか? 』
–
140 ページの『Q-04. ロード中のグラフィックスがありますか、またはページ
の大きなセクションがブランクになっていますか? 』
140 ページの『S-03. UI エレメントがページ上に存在しますが、データが取り込
まれていません。後続の再生は機能しません。』
–
140 ページの『Q-01. ページ・ロードの詳細に、イメージおよび CSS 以外の
404 要求はありますか? 』
–
141 ページの『Q-02. ページ・ロードの詳細に、リダイレクトされる要求また
は空のデータを返す要求がありますか? 』
–
141 ページの『Q-03. ページ・ロードの詳細に、タイプが POST で元のサーバ
ーに対して要求されている、200 で完了している要求はありますか? 』
-
v
141 ページの『Q-03. いいえ: TLA に URL は存在しますか? 』
141 ページの『S-04. 再生時にページが表示されるが、すぐに 404 または明らか
に正しいものではない他のページに置き換えられる。』
–
141 ページの『Q-01. ページ・ロードの詳細に、複数のメインページ
(asp、jsp、html、htm、php などの拡張子が付いたページ) に対する要求が表示
されていますか? 』
© Copyright IBM Corp. 1999, 2015
137
v
142 ページの『S-05. ウィンドウ・コンテンツの一部が欠落している (グラフィッ
クのロード中であるか、明らかなブランク領域がページにある)。』
–
142 ページの『Q-01. ナビゲーション・リスト (左上のリスト) に、フォーマ
ット設定されていない HTML または正しく見えないデータが含まれている複
数の後続ページがありますか? 』
-
v
v
143 ページの『Q-02. ページ・ロードの詳細 (S-01 を参照) に、404 を返して
いる、タイプが POST の要求はありますか? 』
–
143 ページの『Q-03. ページ・ロードの詳細 (S-01 を参照) で、すべてが正し
く (404 なしで) 完了していて、ブランク領域にあるはずのコンテンツを表示
できるのにもかかわらず、(ナビゲーション・リストで) 別のページとして表示
されますか? 』
–
144 ページの『Q-04. 長方形の領域 (場合によっては、ブランクまたはメッセ
ージ入り) がページの一部をカバーしていますか? 』
–
144 ページの『Q-05. RSP を確認した (RSP ボタンを押した) ときに、有効な
HTML と思われるページ全体 (開始/終了 html タグ、body タグ、およびコン
テンツ) が存在するように見えますか? 』
145 ページの『S-06. JavaScript エラーを示すポップアップが出続けました。』
–
145 ページの『Q-01. デバッグするかどうかをポップアップで尋ねられますか?
』
–
145 ページの『Q-02. スクリプトの実行を続行するかどうかをポップアップで
尋ねられますか? 』
-
145 ページの『Q-01. はい: ポップアップで「アクセスが拒否されました」
と示されていて、かつ現在のページが HTTPS を使用していますか? 』
-
145 ページの『Q-02. はい: ポップアップで「アクセスが拒否されました」
と示されていますか? 』
-
146 ページの『Q-03. はい: ポップアップで「'x' が未定義です」と示されて
いますか? 』
147 ページの『S-07. RTV の再生速度が稼働中サイトより大幅に遅い』
147 ページの『Q-01. URL の一部を置き換えて (つまり、「my.site.com」を
「blocked」に変更して) URL をブロックしていますか? 』
148 ページの『S-08. 一部のクライアント UI イベントが再生されない』
–
138
142 ページの『Q-01. はい: 後続のページのコンテンツが、グラフィックが
ロード中の領域またはブランク領域のコンテンツであるようですか? 』
–
–
v
141 ページの『Q-01. はい: 初期ページ上にサブミット・ボタンまたは他の
ページ遷移ボタン (「次へ」など) がありますか? 』
148 ページの『Q-01. UI イベントがある時点までは再生されますか? 』
-
148 ページの『Q-01. はい: タイプが「Exception」の UI イベントがありま
すか? 』
-
148 ページの『Q-02. はい: クリックスルー時に、何かを実行するはずに見
えるイベントがページに影響を及ぼさないですか? 』
-
149 ページの『Q-03. はい: ページにフォーム・フィールドは含まれている
が、イベントが欠落しているように思われますか? 』
-
149 ページの『Q-04. はい: タイプが「change」の、失敗しているイベント
がナビゲーション・リストにありますか? 』
Tealeaf トラブルシューティング・ガイド
v
149 ページの『Q-05. はい: 壊れたイベントは、ナビゲーション・リストの
当該項目で「xpath」から開始していますか? 』
150 ページの『S-09. 再生がうまくいかないページがある。』
–
–
150 ページの『Q-01. 多数の意味のない (と思われる) 文字としてページが表
示されますか? 』
-
150 ページの『Q-01. はい: 表示するページに一致していない固有の照会ス
トリングまたは URL がページに含まれていますか? 』
-
150 ページの『Q-02. 表示するページにも一致する、同じ URL または照会
ストリングがすべてのページに含まれていますか? 』
150 ページの『Q-03. ページで Web ページの一部が表示されますか?』
-
150 ページの『Q-01. はい: ページはフレーム・セットの一部のように見え
ますか? 』
S-01. 再生内のページが表示されない、または正しいページではない
Q-01. ページが正しく要求されているかどうかを確認するためにページ・ロ
ードの詳細を確認しましたか?
いいえ:
v 「RTV」>「表示」>「ページ・ロードの詳細」にアクセ
スします。
v すべての要求を見て、表示されることが期待されるメイ
ンページが 404 などの 200 以外のステータス・コード
になっているかどうかを確認します。ページがリモー
ト・サイトではなく、セッションから返されていること
を確認します。リモート・サイトからのものになってい
る場合は、セッション・データに正しく取り込まれてい
ません。再生しようとしているタイプのページをキャプ
チャーするように PCA がセットアップされていること
を確認します。200 以外のコードを返している場合、ほ
ぼ確実に、正しくキャプチャーされていません。ページ
が提供される別のページになるときには、多くの場合、
リモート・サーバーがページを提供できなかった後のリ
ダイレクトです。これもまた、セッションが正しくキャ
プチャーされていないことを示しています。
S-02. 再生時にエレメントが Web ページに表示されない
Q-01. ナビゲーション・リスト (左上のペイン) 内のページのいずれかの後
に、単一文字のリスト (XXXXX や @@@@ など) がありますか?
はい:
プライバシー機能が、要求を UI エレメントに突き合わせ
るために必要になることがある URL フィールド・データを
ブロックしています。プライバシー設定を変更し、URL フ
ィールドが通過できるようにします。通常、原因は、キャニ
スター・サーバー上の Windows パイプライン内のルール
BlockURLFields です。
第 5 章再生の問題のテーブル
139
Q-02. イメージおよび CSS 以外で 404 ステータス・コードになる要求はあ
りますか?
はい:
欠落ファイルに AXD、ASHX、ASPX などのような拡張子が
ある場合、そのファイルには、ページ上にエレメントを表示
するために必要な JavaScript が含まれています。そのファ
イルがセッションでキャプチャーされなかったため、RTV
が元のサーバーにそのファイルに対する要求を行い、失敗し
ています。PCA で、404 を示しているページの拡張子がホ
ワイトリストに入れられていることを確認します。また、
「ブロック」リストにないことも確認します。
注: ページに拡張子がない場合、PCA は、ヘッダー内の
Content-Type に含まれている MIME タイプに基づいて、ペ
ージを保持するか破棄するかを決定します。その欠落してい
るページの MIME タイプがホワイトリストに入れられてい
て、ブロックもされていないことを確認してください。
Q-03. ページ・ロードの詳細にホーム・ページに対する複数の要求または複
数のリダイレクトがありますか?
はい:
恐らく、再生に必要なページがキャプチャーされておらず、
再生時に元のサーバーに対して要求されています。サーバー
では、これらのページを提供するために Cookie または有効
なセッション ID が必要なため、ホーム・ページまたは他
の汎用ページへのリダイレクトが返されているだけです。
PCA で、元々要求されたページに、ホワイトリストに入れ
られていてブロックされていない拡張子があることを確認し
ます。
注: ページに拡張子がない場合、PCA は、ヘッダー内の
Content-Type に含まれている MIME タイプに基づいて、ペ
ージを保持するか破棄するかを決定します。その欠落してい
るページの MIME タイプがホワイトリストに入れられてい
て、ブロックもされていないことを確認してください。
Q-04. ロード中のグラフィックスがありますか、またはページの大きなセク
ションがブランクになっていますか?
はい:
S-05 を参照してください。
S-03. UI エレメントがページ上に存在しますが、データが取り込まれていません。
後続の再生は機能しません。
Q-01. ページ・ロードの詳細に、イメージおよび CSS 以外の 404 要求はあ
りますか?
はい:
S-02、Q-02 を参照してください。
140
Tealeaf トラブルシューティング・ガイド
Q-02. ページ・ロードの詳細に、リダイレクトされる要求または空のデータ
を返す要求がありますか?
はい:
S-02、Q-02 を参照してください。
Q-03. ページ・ロードの詳細に、タイプが POST で元のサーバーに対して
要求されている、200 で完了している要求はありますか?
はい:
セッション (TLS) を TLA として保存し、セッション内で
テキスト検索を実行して、欠落している URL がセッショ
ン・ファイル内にあるかどうかを確認します。
Q-03. いいえ: TLA に URL は存在しますか?
いいえ:
POST 要求がセッション・データにキャプチャーさ
れませんでした。これが発生するのは、MIME タイ
プまたは拡張子がホワイトリストに入っていない
か、PCA の POST セクションでブロックされてい
るためです。この拡張子を追加するか、ブロックさ
れている場合はブロックを解除してください。ま
た、MIME タイプを追加するか、MIME タイプ・
セクションでブロックを解除してください。
はい:
恐らく、再生時にセッションでキャプチャーされた
POST 要求の突き合わせで問題が生じています。
URL に URL エンコード値 (_ や %36 など) が含
まれている場合、「RTV」>「ツール」>「オプショ
ン」>「拡張」にアクセスし、「厳格なポスト・デ
ータ・マッチング (Strict Post Data Matching)」をク
リアします。これは、POST 要求の突き合わせ時に
単純なストリングの比較を実行しません。
注: リリース 8.3 で、この設定は削除されました。
POST データ・マッチング・プラグインの問題の可
能性があります。「IBM Tealeaf CX 構成マニュア
ル」の『POST データ・マッチング・プラグインの
管理』を参照してください。
S-04. 再生時にページが表示されるが、すぐに 404 または明らかに正しいものでは
ない他のページに置き換えられる。
Q-01. ページ・ロードの詳細に、複数のメインページ
(asp、jsp、html、htm、php などの拡張子が付いたページ) に対する要求が
表示されていますか?
Q-01. はい: 初期ページ上にサブミット・ボタンまたは他のページ
遷移ボタン (「次へ」など) がありますか?
はい:
第 5 章再生の問題のテーブル
141
恐らく、再生時に使用されている強調表示により、
ボタンでナビゲートされています。強調表示の際に
JavaScript を実行するために RTV が必要ない場合
(動的に表示/非表示が切り替えられるエレメントが
ない場合など)、「RTV」>「ツール」>「オプショ
ン」>「再生」で「強調表示時に JavaScript を呼
び出す」をオフにすることができます。
強調表示の際に他のエレメントを再生するために
JavaScript を実行する必要がある場合、応答 mod
ルールを作成して当該ボタンを開始する JavaScript
を置き換えることができます。通常、要求対象の
URL のサブ検索を実行すれば十分です。次に、
URL を「#」文字 (アンカー) に置き換えます。
いいえ:
新規ページをロードしようとしている JavaScript が
存在している可能性があります。
「window.location.href」、「window.navigate」、
「document.location」、「window.location」などの句
を検索すると、ナビゲーションを実行しているコー
ドを特定するのに役立ちます。
これらが見つからない場合、強調表示を実行してい
るコードが、単にアンカー・タグの「<a href=」で
ある可能性があります。これらは多数存在するた
め、ページ・ロードの詳細で表示されている最後の
「メイン」ページ URL を検索する必要がありま
す。問題の原因となっている URL (404 の原因とな
っている URL、または正しくないページである
URL) が分かったら、その URL およびうまくいけ
ば、それに関連したアンカー・タグを検索できま
す。
上記のいずれの場合でも、応答 mod ルールでは、
コードまたはアンカー・タグを置き換えて、強調表
示の際に開始しないようにする必要があります。
S-05. ウィンドウ・コンテンツの一部が欠落している (グラフィックのロード中であ
るか、明らかなブランク領域がページにある)。
この設定が使用可能な場合、「RTV」 > 「ツール」 > 「オプション」 >
「拡張」 > 「2 フェーズの再生」が選択されていることを確認します。
Q-01. ナビゲーション・リスト (左上のリスト) に、フォーマット設定され
ていない HTML または正しく見えないデータが含まれている複数の後続ペ
ージがありますか?
Q-01. はい: 後続のページのコンテンツが、グラフィックがロード
中の領域またはブランク領域のコンテンツであるようですか?
はい:
142
Tealeaf トラブルシューティング・ガイド
コンテンツは正しく突き合わされていませんが、セ
ッション内にあります。通常、これは、親ページ
(ブランク領域があるか、グラフィックがロード中で
あるページ) の URLが、ホストが組み込まれた
URL を使用していることを意味します。これによ
り、このコンテンツがロードされない場所にクロス
サイト・スクリプティングの問題が生じます。
RTV は、localhost:190X にあるプロキシー・サーバ
ーを介してコンテンツをロードし、これがホストで
あることが期待されます。再生ページが異なるホス
ト (元のサイトのホスト) に対して要求を行った場
合、ブラウザー内のセキュリティーにより、その要
求がブロックされます。
これを修正するには、含まれているホストが組み込
まれた URL を検索する必要があります。例とし
て、「www.thecustomersite.com/
interesting_content.asp」という URL を使用して説明
します。
この URL は、上記のフォーマット設定されていな
い HTML が含まれている後続ページの 1 つに一致
しています。
この URL を「/interesting_content.asp」に変更する
ための応答 mod ルールを追加する必要がありま
す。この相対 URL により、RTV は、欠落してい
る領域にコンテンツを配置できるようになります。
Q-02. ページ・ロードの詳細 (S-01 を参照) に、404 を返している、タイプ
が POST の要求はありますか?
はい:
欠落している領域を埋めるコンテンツは、セッション内にな
いか、正しく突き合わせされていない可能性があるため、ペ
ージによって元のサーバーに要求されています。S-02、Q-02
を参照してください。
Q-03. ページ・ロードの詳細 (S-01 を参照) で、すべてが正しく (404 なし
で) 完了していて、ブランク領域にあるはずのコンテンツを表示できるのに
もかかわらず、(ナビゲーション・リストで) 別のページとして表示されます
か?
はい:
「RTV」->「ツール」->「オプション」->「拡張」->「厳格
なポスト・データ・マッチング (Strict Post Data
Matching)」をオフにしてみてください。このオプション
は、コンテンツに対して完全一致のストリングの比較を実行
します。これにより、比較が失敗することがあり、コンテン
ツが誤って配置されます。
第 5 章再生の問題のテーブル
143
注: リリース 8.3 で、この設定は削除されました。POST
データ・マッチング・プラグインの問題の可能性がありま
す。「IBM Tealeaf CX 構成マニュアル」の『POST デー
タ・マッチング・プラグインの管理』を参照してください。
Q-04. 長方形の領域 (場合によっては、ブランクまたはメッセージ入り) が
ページの一部をカバーしていますか?
はい:
これは、フレーム配置の問題の可能性があります。セッショ
ンで逆方向にナビゲートすると、問題の発生頻度が上がるこ
とがあります。
この場合、問題を修正するには、RTV の「拡張オプショ
ン」タブにある「アグレッシブ・フレーム配置」をクリアし
てみてください。
Q-05. RSP を確認した (RSP ボタンを押した) ときに、有効な HTML と
思われるページ全体 (開始/終了 html タグ、body タグ、およびコンテンツ)
が存在するように見えますか?
はい:
一部の場合、CSS または JavaScript を使用してページのコ
ンテンツが非表示にされ、「ロード中」の部分が完了する
と、ページが表示されることがあります。ただし、RTV で
は、ページは既にそこにある (完了する必要がある Ajax 要
求がない) ため、表示されるようにする必要があります。例
として、ページのロード時に表示される DIV があるセッシ
ョンが挙げられます。応答 mod ルールを作成して、JS コ
ードを置き換えて表示されるようにすることができます。こ
れには、お客様の JavaScript を精査する必要があります。
お客様の例:
body タグは、以下のとおりです。
<body
onLoad="javascript:onloadExpressICMS();
javascript:setOnLoadFlag();
javascript:hideProgres();
javascript:validateAllForOnLoad(’A’);
javascript:myFormLoad();
javascript:setFocus(’agentRecord1’);
javascript:releaseOnLoadFlag();
javascript:controlInsuredInformationBlock
(’F’,’false’);
javascript:handleIcmsCookie(’1250291211465’);
javascript:displayLinks();">
このタグには、(ページの再生時に進行状況表示バーのみが
表示されていたため) 検索した「hideProgress()」の呼び出し
が含まれていました。この関数を呼び出すと役に立つ可能性
があると気付いたため、以下の再生ルールを作成しました。
<HostProfile name="eagent.farmersinsurance.com" id="31">
<ResponseModify id="34"
url="/PLA/eAgent/eAutoE/view/info/
premiumsummary/
144
Tealeaf トラブルシューティング・ガイド
premiumSummaryCancelAll"
pattern="onLoad=""
replacementString="onLoad="
hideProgres()"
onLoaded="" occurrences="all"/>
</HostProfile>
このルールは、タグを以下のように変換しました。
<body onLoad="javascript:hideProgres();">
これで、ページは、まず hideProgress() 関数を呼び出して表
示されるようになりました。
S-06. JavaScript エラーを示すポップアップが出続けました。
注: スクリプトの実行を続行するかどうかをポップアップで尋ねられた場
合、絶対に「いいえ」を押さないでください。そうすると、RTV のスクリ
プト・エンジンが無効になり、RTV を再始動するまでスクリプトが実行さ
れなくなります。
Q-01. デバッグするかどうかをポップアップで尋ねられますか?
はい:
スクリプト・デバッガーをオフにしてみてください。
「RTV」->「ツール」->「オプション」->「拡張」->「スク
リプト・デバッガーの無効化」。これにより、デバッグする
ように求めるポップアップがブロックされます。
これでもブロックされない場合は、IE を開き、「ツー
ル」->「インターネットオプション」->「詳細設定」を選
択し、「スクリプトのデバッグを使用しない (Internet
Explorer)」と「スクリプトのデバッグを使用しない (その
他)」にチェック・マークを付けます。
これらのいずれでも解決しない場合は、S-06、Q-02 の解決
方法を参照してください。
Q-02. スクリプトの実行を続行するかどうかをポップアップで尋ねられます
か?
Q-01. はい: ポップアップで「アクセスが拒否されました」と示さ
れていて、かつ現在のページが HTTPS を使用していますか?
はい:
多くの場合、これは、RTV が非セキュア接続でロ
ーカル・ホストを使用してファイルを提供している
場合にセキュア・ページ上にある変数を JavaScript
が設定または変更しようとすることが原因です。(通
常は別ファイルにある) 問題の行を見つけ、要求を
行うことができないようにする必要があります。
HTTPS の場合でも、次のトピックを参照してくだ
さい。
Q-02. はい: ポップアップで「アクセスが拒否されました」と示されていま
すか?
第 5 章再生の問題のテーブル
145
はい:
多くの場合、これは、JavaScript が「document.domain = 」
でドメインを設定しようとすることが原因です。このテキス
トのサブ検索を実行して、これが問題なのかどうかを確認す
る必要があります。見つからなかった場合は、「RTV」->
「ツール」->「イメージの取得」を使用してから、別のサブ
検索を実行する必要があります。これは、セッション内にな
い、動的に要求/生成されるページを取得し、検索します。
見つかった場合は、このテキストを「//document.domain=」
に置き換える応答 mod ルールを作成します。これにより、
JavaScript の当該行がコメント化されます。
これでうまくいかない場合は、ドメイン固有で RTV が再生
時にそれを設定できないようにしている他の JavaScript メ
ンバーが存在する可能性もあります。この時点で、
document.、window. を検索して調べる必要があります。こ
の問題の行を変更する応答 mod ルールを作成する必要があ
ります。
例:
あるお客様がレビュー・パートナー Bazaarvoice を使用して
いて、これが IFrame でロードされ、reviews.epson.com か
らのコンテンツを取得していました。RTV は、
localhost:1901 (内部プロキシー) からすべてのものをロード
していたため、クロスサイト・スクリプティングの問題があ
りました。これを修正するために、以下の再生ルールを作成
しました。
<ResponseModify id="159" url="" pattern=
"reviews.epson.co.uk"
replacementString="localhost:1901" occurrences="all"/>
このルールにより、IFrame URL を、使用している
localhost:1901 に変更し、クロスサイト・スクリプティング
を削除することができました。
Q-03. はい: ポップアップで「'x' が未定義です」と示されていますか?
はい:
多くの場合、これは、セッションで収集されていないオブジ
ェクトまたは再生時に元のサーバーから収集できないオブジ
ェクトを JavaScript が要求することが原因です。
これは、JavaScript ファイルが正常にロードされなかったこ
とが原因の可能性があります。ページ・ロードの詳細を確認
し、JS ファイルが 404 を返していないかを確認してくださ
い。
v 404 を返しているファイルが元のサーバーに対して要求
されている場合、パスワードが保護されていてセッショ
ンなしで取得できないか、ファイアウォールの背後にあ
るなどブロックされているネットワーク状態になってい
ることを意味します。いずれの場合でも、このファイル
146
Tealeaf トラブルシューティング・ガイド
をキャプチャー時に収集する必要があります。
S-02、Q-02 を参照してください。
v 404 がない場合は、再生時にページが実行される方法と
実際に実行される方法で異なる点があることを意味しま
す。一部の JavaScript が再生時に元のサーバーから正常
に取得されたが (200 ステータス)、そのコンテンツがキ
ャプチャー時に要求されたときとは異なっている可能性
があります。ページ・ロードの詳細に、コンテンツ長が
空のリダイレクトまたはページがある場合、恐らく、こ
れが原因です。そのようなページがキャプチャー時に収
集されるようにしてください (S-02、Q-02 を参照)。
v 問題が発生しているオブジェクトが Tealeaf 関連の変数
のようである場合は、恐らく、お客様が TeaLeaf.js ファ
イルを正しく組み込んでいません。キャッシュに入れる
ことができる静的な方法で組み込まれていることを確認
してください。通常、これは、後続の組み込まれた要求
内ではなく、メインページの上部にあることを意味しま
す。動的に生成されるページのいずれかに組み込まれて
いる場合、これは重大な問題であり、解決する必要があ
ります。スクリプトをデプロイする方法の詳細について
は、UI Capture ライブラリーのインストール・マニュア
ルを参照してください。
v 前述のどの問題にも当てはまらない場合は、JavaScript 変
数が原因で、スクリプトが再生時に失敗していることを
意味します。この問題を突き止めるには、ポップアップ
で示されている変数のサブ検索を実行して調査します。
S-07. RTV の再生速度が稼働中サイトより大幅に遅い
Q-01. URL の一部を置き換えて (つまり、「my.site.com」を「blocked」に
変更して) URL をブロックしていますか?
はい:
不明なホスト名または URL に要求が送信される問題が内部
プロキシー・サーバーで発生しているのが確認されていま
す。通常、この問題は、すべてのコンテンツのパフォーマン
スが非常に遅くなることで明らかになります。これを修正す
る方法としては、IIS のホスト・ファイルにアクセスして、
ローカル・ホストと同じ項目として新しい文言をファイルに
追加します。例えば、ローカル・ホストと同じ項目として、
上記のような「blocked」をホスト・ファイルに追加しま
す。
いいえ:
内部プロキシーまたはその他のソフトウェア (アンチウィル
ス) で RTV ユーザー・エージェントが認識されない可能性
があります。これは、RTV が何かを要求したときに、不明
なユーザー・エージェント・ストリング (つまり、Internet
Explorer や Firefox などではない) がブロックされてコンテ
第 5 章再生の問題のテーブル
147
ンツを要求できなかったり、パフォーマンスが低下したりす
る可能性があることを意味します。お客様は、再生の信頼性
を高めるために、内部インフラストラクチャーによって
RTV が認識され、RTV がコンテンツを要求できるようにす
る必要があります。また、この問題が原因で、RTV が要求
した際に、イメージ、CSS、およびサイトのその他の部分が
ブロックされて、再生の品質が不十分になることもありま
す。
S-08. 一部のクライアント UI イベントが再生されない
Q-01. UI イベントがある時点までは再生されますか?
Q-01. はい: タイプが「Exception」の UI イベントがありますか?
はい:
TeaLeafTarget ページが正しくセットアップされて
いることを検証してください。 RTV で REQ ボタ
ンを押し、Exception タイプのイベントの REQ バ
ッファーを検査します。イベントに「FailedUrl」パ
ラメーターが含まれていて、URL に
TeaLeafTarget.asp が含まれている場合、誤構成で
す。これは、Client-Side Capture には適用されませ
ん。
ResponseType=unknown の場合、これは、ターゲッ
ト・ページの誤構成も示しています。
Q-02. はい: クリックスルー時に、何かを実行するはずに見えるイベントが
ページに影響を及ぼさないですか?
はい:
特定の時点まで再生が機能し、後続のイベントでページが変
更されないか強調表示されない場合、通常、一部のコンテン
ツが欠落していることを意味します。イベントは、フィール
ドやボタンなどのページ上のフォーム・エレメントに関連付
けられた ID に基づいています。これらの UI エレメント
が存在しないか、ID が固有でないか存在しない場合、再生
で使用できません。
メインウィンドウで、イベントで再生されるはずの UI エ
レメントを右クリックし、「エレメント・ソースの表示」を
選択します。これにより、ページ内の UI エレメントの
HTML が表示されます。当然ですが、エレメントがメイン
ページにない場合は、S-02 を参照してください。
エレメントの ID が分かったら、イベント ID が、HTML
内の UI エレメント ID と同じであることを確認します。
ID がない場合、または ID が何らかの形で異なる場合は、
これが原因でエレメントが再生されていません。イベントが
後続の UI イベントの UI エレメントの表示をトリガーす
148
Tealeaf トラブルシューティング・ガイド
ることになっている場合、欠落している UI エレメントが
1 つあれば、後続のすべてのエレメントが失敗する可能性が
あります。
Q-03. はい: ページにフォーム・フィールドは含まれているが、イベントが
欠落しているように思われますか?
はい:
フィールドがあるフォームがメインページに含まれていて、
ユーザーとフィールドの対話を表示する UI イベントが存
在しないようである場合、UI イベントが欠落しているか、
キャプチャーされていない可能性があります。これは、ペー
ジ上のユーザーの対話をキャプチャーできるようにするリス
ナーを、ページ上の他の JavaScript が「アンフック」して
いるために発生することがあります。
上記の Q-01 を確認し、ターゲット・ページが正しく構成
されており、取り込まれるはずの UI イベントが欠落して
いると思われる場合は、エンジニアリングにお問い合わせく
ださい。
Q-04. はい: タイプが「change」の、失敗しているイベントがナビゲーショ
ン・リストにありますか?
はい:
イベントのタイプが「change」の場合、RTV が再生してい
るイベントのリストにそのタイプのイベントを追加する必要
があります。このイベントが必要になるのは、フォーム・フ
ィールドに「KeyUp」などの他の関連イベントが欠落してい
る場合です。このイベントを有効にするために、「RTV」->
「ツール」->「オプション」->「UI イベント」にアクセス
し、「新規タイプの追加」ボタンの隣のフィールドに単語
「change」を追加します。「新規タイプの追加」ボタンがア
クティブになったら、そのボタンをクリックしてこのタイプ
を追加します。次に、リスト内の「変更」の隣にあるチェッ
ク・ボックスをクリックします。
Q-05. はい: 壊れたイベントは、ナビゲーション・リストの当該項目で
「xpath」から開始していますか?
はい:
タイプが xpath のイベントが必要になるのは、再生される
ページ上の UI エレメントに ID が含まれていない場合で
す。xpath は、HTML DOM を辿ってエレメントを見つ
け、そのエレメントを再生時に使用することを示していま
す。
xpath イベントは、特殊な事例を処理するために TeaLeaf
UI Capture ライブラリーを変更する必要が生じることがあ
るため、難しくなることがあります。
再生時に xpath イベントが失敗する場合は、エンジニアリ
ングにお問い合わせください。
第 5 章再生の問題のテーブル
149
S-09. 再生がうまくいかないページがある。
Q-01. 多数の意味のない (と思われる) 文字としてページが表示されますか?
Q-01. はい: 表示するページに一致していない固有の照会ストリン
グまたは URL がページに含まれていますか?
はい:
それを右クリックし、「再生ルール」->「再生から
このページを削除」を選択できます。これにより、
この URL が含まれたすべてのページが削除される
ので注意してください。
Q-02. 表示するページにも一致する、同じ URL または照会ストリングがす
べてのページに含まれていますか?
はい:
固有の REQ 値を使用してそれらを削除する必要がありま
す。問題のページの 1 つで「要求」ボタンをクリックし、
必要のないページ内に存在するが必要なページ内に存在しな
い REQ の名前と値のペアを検索します。これの良い例とし
て、表示しない AJAX 要求を通常は示す
「HTTP_X_REQUESTED_WITH=XMLHttpRequest」が挙げら
れます。REQ でこれを強調表示し、「再生からこの要求値
を含むページを削除」を右クリックして選択します。これに
より、今後これらのページが非表示になります。
Q-03. ページで Web ページの一部が表示されますか?
Q-01. はい: ページはフレーム・セットの一部のように見えますか?
はい:
Q-02 を参照してください。
cxReveal エラー「スレッドは中止されつつありました。(Thread was
being aborted.)」
このエラー・メッセージは、<Authentication> ノードを使用して認証を有効にする
ように IBM Tealeaf cxReveal spanelcfg.xml ファイルを構成していないことが原因
である可能性があります。
注: この問題は、リリース 7.1 以前からの IBM Tealeaf cxReveal に該当します。
Error
Source: sesnList.aspx.cs:line 119
Search:
Description: スレッドは中止されつつありました。(Thread was being aborted.)
150
Tealeaf トラブルシューティング・ガイド
cxReveal データベースにあるセッションを再生できない
結果が IBM Tealeaf cxReveal 検索から返されたときに、セッションを再生できない
ことがあります。セッション・リストから再生するセッションを選択したときに、
ブラウザー・ベースの再生でセッションのロードに失敗することがあります。
セッションを取得できない理由として複数の理由が考えられますが、問題の原因
は、セッション・データ内の一部のタイム・スタンプである可能性があります。
ヒットが IBM Tealeaf CX Passive Capture Application によって再組み立てされると
きに、PCA は、タイム・スタンプ情報を見つけて生成しようとします。この情報が
誤った形式であるか欠落している場合、PCA はデフォルトで値 01/01/1970 を書き
込みます。
このヒットが処理サーバーに渡されると、以下にリストされた順序で以下の内容が
発生します。
v ヒット内のセッション属性情報が処理され、IBM Tealeaf cxReveal 検索データベ
ースに書き込まれます。
v ヒットが、上記のタイム・スタンプとともにセッション・アーカイブ・ファイル
に書き込まれます。
v 1 時間ごとに 1 回正時に、セッション・アーカイブ・ファイルがパージされま
す。これは、その中のデータが、処理サーバーに保管するには古すぎると見なさ
れるためです。
– 「IBM Tealeaf Passive Capture Application マニュアル」の『Performance
Measurement』を参照してください。
そのため、IBM Tealeaf cxReveal ユーザーがこのセッション・データの検索を実行
すると、データが処理サーバーに存在するが、パージされた可能性があることを、
検索データベースが示します。IBM Tealeaf cxReveal がこれらのセッション・ファ
イルにアクセスしようとすると、ファイルは、正しくないタイム・スタンプ値のた
め見つかりません。
テストするには、以下のようにします。
1. TMS を使用して、セッション・ファイルが保管されているディレクトリーを見
つけます。
v 詳しくは、 78 ページの『キャニスター・パフォーマンスの調整』を参照して
ください。
2. 1 時間の終わり近くに、管理者として処理サーバーにログインします。
3. TMS を使用して見つけたディレクトリーにナビゲートします。
4. ファイル名に 1970 のタイム・スタンプが含まれているファイルを見つけます。
ファイル名パターンは、以下のようなものです。
LSSN_19700101_<hostname>
5. 検索を使用して、このアーカイブからのセッションの取得を試行します。
v 「IBM Tealeaf cxReveal ユーザー・マニュアル」の『cxReveal - セッション属
性によるセッションの検索』を参照してください。
6. これらのセッションが見つかった場合、BBR を使用してセッションを再生し、
要求内のタイム・スタンプ値が破損した理由の確認を試行します。
第 5 章再生の問題のテーブル
151
v タイム・スタンプ情報は、要求の [timestamp] セクションに保管されます。
v これらの値について詳しくは、「IBM Tealeaf RealiTea Viewer ユーザー・マ
ニュアル」の『RealiTea Viewer - 要求ビュー』を参照してください。
152
Tealeaf トラブルシューティング・ガイド
第 6 章 Tealeaf 管理システムのトラブルシューティング
Tealeaf 管理システムのトラブルシューティングを行うには、このセクションの情報
を使用します。
リリース 7.0 から、Tealeaf では、Tealeaf サーバー構成の集中管理が可能です。
Tealeaf ポータルを介して、Tealeaf 管理システム (TMS) を使用することで、管理者
は、1 つの中央の場所で構成の変更を行ってから、影響を受けるすべてのサーバー
にその変更をプッシュすることができます。TMS について詳しくは、「IBM
Tealeaf cxImpact 管理マニュアル」の『Tealeaf 管理システム』を参照してくださ
い。
TMS で問題が発生している場合は、以下のトラブルシューティングの症状および解
決方法を確認します。
TMS 始動のトラブルシューティング
TMS 始動の問題を診断してトラブルシューティングするには、このセクションの情
報を使用します。
TMS マスターのサーバー・リストに TMS スレーブ・サーバーが
表示されない
スレーブ・サーバーが TMS マスター上のサーバー・リストに表示されない場合、
スレーブ・サーバーを TMS マスター・サーバーとして構成できます。
スレーブ・サーバーを TMS マスター・サーバーとして構成するには、以下を実行
します。
1. TMS マスターにするサーバーの名前を識別します。
2. 誤構成されたサーバーで TMS を停止します。
3. スレーブ・サーバー上のコマンド・ラインから、次のコマンドを実行します。
TLMgmtSrv.exe -setmaster <master_server>
ここで、<master_server> は実際の TMS マスターの名前です。
4. TMS を再始動します。
5. イベント・ログでエラーがないかを確認します。
始動時に、イベント・ログオン TMS スレーブで、TMS マスター
として実行されていると示される
始動時に、イベント・ログオン TMS スレーブで、TMS マスターとして実行されて
いることが示される場合、複数の TMS マスターが存在することを意味します。
『TMS マスターのサーバー・リストに TMS スレーブ・サーバーが表示されない』
を参照してください。
© Copyright IBM Corp. 1999, 2015
153
自己署名 TMS 証明書の有効期限が切れた
Tealeaf 管理サービス (TLMGmtSrv.exe) は、自己署名 TMS 証明書を使用して SSL
通信を行います。この TMS 証明書の有効期限が切れた場合は、別の自己署名証明
書、または信頼された認証局が発行した証明書に置き換えることができます。
PCA で openssl ユーティリティーを使用して秘密鍵を生成し、その秘密鍵を使用し
て自己署名 SSL 証明書を生成することができます。その後、TMS サービスが実行
されている IBM Tealeaf サーバーに、この証明書をコピーできます。
以下のステップを実行して、自己署名 SSL 証明書を生成します。
1. コマンド・プロンプトを開き、以下のディレクトリーにナビゲートします。
/usr/local/ctccap/bin/
2. genrsa -out コマンドを使用して秘密鍵を生成します。例えば、以下のコマン
ドでは、2048 ビットの RSA 鍵ファイルである TLMgmtSrv.key ファイルが生成
されます。
openssl genrsa -out TLMgmtSrv.key 2048
3. 秘密鍵からパスフレーズを削除します。例えば、以下のコマンドを実行する
と、パスフレーズが削除されます。
copy TLMgmtSrv.key TLMgmtSrv.key.orig
openssl rsa -in TLMgmtSrv.key.orig -out TLMgmtSrv.key
4. 生成した秘密鍵を使用して、自己署名証明書を作成します。コマンド・プロンプ
トを使用して、自己署名証明書を生成します。例えば、以下のコマンドを使用
すると、生成した TLMgmtSrv.key 秘密鍵を使用して、TLMgmtSrvNoKey.crt 証明
書が生成されます。
openssl req -x509 -days 3650 -newkey rsa:2048 -key ./TLMgmtSrv.key –out
TLMgmtSrvNoKey.crt
-days 3650 オプションは、example.crt 証明書の有効期間が、その時点から
365 日間 (1 年間) であることを指定します。
openssl req コマンドは、さまざまな値をたずねるプロンプトを対話式に表示し
ます。以下の表に、これらのプロンプトと応答例を示します。
表 4. openssl req コマンドの値の例
154
プロンプト
応答例
Country Name (2 文字のコード)
US
State or Province Name (フルネーム)
California
Locality Name (市など)
San Francisco
Organization Name (企業など)
Tealeaf®, an IBM® Company
Organizational Unit Name (部門など)
Release Engineering
Common Name (自分の名前など)
cx.Tealeaf.com
Email Address
[email protected]
Tealeaf トラブルシューティング・ガイド
5. cat コマンドを使用して 2 つのファイルを結合し、自身の秘密鍵を含む単一の
証明書を生成します。例えば、以下のようなコマンドを使用します。
cat TLMgmtSrvNoKey.crt TLMgmtSrv.key > TLMgmtSrv.crt
6. 置き換え対象の TMS 証明書がある Windows ベースの Tealeaf サーバーに、
PCA から新しい証明書ファイルを転送します。
新しい証明書の名前およびディレクトリーが、有効期限が切れた証明書の名前
(TLMgmtSrv.crt) およびディレクトリーと同じになるようにしてください。デフ
ォルトのロケーションは Tealeaf¥TLMgmtSrv¥SSL です。
7. 新しい証明書ファイルをインストールする前に TMS サービスを停止し、証明書
ファイルをインストールしてから TMS サービスを再開します。
TMS サービスに対して非 SSL モードを構成している場合は、
Tealeaf 管理システム (TMS) にアクセスしようとするとエラーが
発生します。
TMS サービスに対して非 SSL モードを構成している場合は、TMS にアクセスす
ると、「TMS サービスへの接続中にエラーが発生しました」というエラーが表示さ
れます。
この問題を解決するには、以下のステップを実行します。
1. Tealeaf 管理システム (TMS) にログインします。
2. 「全体ビュー」タブで、「Tealeaf 管理サーバー」を展開し、「Tealeaf 管理シ
ステムの構成 (Tealeaf Management System Configuration)」をクリックしま
す。
3. 「構成アクション」領域で、「表示/編集」をクリックします。
4. UseSSL パラメーターが 0 になっていることを確認します。
デフォルトでは、UseSSL パラメーターの値は 1 です。
必ずマスター TMS サーバーとスレーブ TMS サーバーでこの値を確認しま
す。
5. 変更を保存して適用します。
6. TMS マスター・サーバーで、$Tealeaf_Home¥Portal¥WebApp に移動します。
7. web.config ファイルを開き、<appSettings> セクションに以下のエントリーを
追加します。
<add key="TMS_USE_SSL" value="false"/>
以下のセクションは、web.config ファイルの <appSettings> セクションの例
です。

<appSettings>
......
<add key="TMS_USE_SSL" value="false"/>
......
</appSettings>
8. web.config ファイルで変更を保存します。
第 6 章 Tealeaf 管理システムのトラブルシューティング
155
9. TMS マスター・サーバーで、$Tealeaf_Home¥Portal¥WebService に移動しま
す。
10. web.config ファイルを開き、<appSettings> セクションに以下のエントリーを
追加します。
<add key="TMS_USE_SSL" value="false"/>
以下のセクションは、web.config ファイルの <appSettings> セクションの例
です。

<appSettings>
......
<add key="TMS_USE_SSL" value="false"/>
......
</appSettings>
11. web.config ファイルで変更を保存します。
12. マスター・サーバーで TMS と World Wide Web 発行サービスを再始動し、ス
レーブ・サーバーで TMS サービスを再始動して、変更を適用します。
不明なマスターからの要求
スレーブ・サーバーがマスターに接続するために使用しているアドレスとは異なる
IP アドレスを使用して、TMS マスターがスレーブ・サーバー上の TMS に接続し
ようとする場合があり、スレーブ・サーバー上の TMS マスターの名前が異なる IP
アドレスに解決される場合、不一致が発生します。
スレーブ・サーバーの TLMgmtSrv_access_YYYMMDD.log で、以下のようなメッセー
ジが表示されることがあります。
10/10/10 13:55:35 | W | Auth: Request from unknown master at aaa.bbb.ccc.ddd!
ここで、
v aaa.bbb.ccc.ddd は IP アドレスです。
この問題を修正するには、TMS マスターが通信に使用している名前として IP アド
レスを使用します。
1. スレーブ・サーバーにログインします。
2. コマンド・ライン・シェルを開きます。
3. Tealeaf インストール・ディレクトリーにナビゲートします。
4. 以下のコマンドを実行します。
TLMgmtSrv.exe -setmaster aaa.bbb.ccc.ddd
ここで、
v aaa.bbb.ccc.ddd は TMS マスターの IP アドレスです。
5. 影響を受ける各スレーブ・サーバーで上記ステップを繰り返します。
156
Tealeaf トラブルシューティング・ガイド
第 7 章 IBM Tealeaf の資料およびヘルプ
IBM Tealeaf には、ユーザー、管理者、および開発者用の資料とヘルプが備わって
います。
製品資料の表示
IBM Tealeaf 製品のすべての資料が、以下の Web サイトから入手できます。
https://tealeaf.support.ibmcloud.com/
以下の表の情報を使用して、IBM Tealeaf の製品資料を表示してください。
表 5. ヘルプの取得
表示対象
表示方法
製品資料
IBM Tealeaf ポータルで、「?」 > 「製品資
料」に移動します。
IBM Tealeaf Knowledge Center
IBM Tealeaf ポータルで、「?」 > 「製品資
料」に移動し、「ExperienceOne Knowledge
Center の IBM Tealeaf Customer Experience」
を選択します。
IBM Tealeaf ポータルのページのヘルプ
IBM Tealeaf ポータルで、「?」 > 「このペ
ージのヘルプ」に移動します。
IBM Tealeaf CX PCA のヘルプ
IBM Tealeaf CX PCA の Web インターフェ
ース上で、「ガイド」を選択して「IBM
Tealeaf CX PCA マニュアル」にアクセスし
てください。
© Copyright IBM Corp. 1999, 2015
157
IBM Tealeaf 製品の入手可能な資料
以下の表は、すべての IBM Tealeaf 製品の入手可能な資料のリストです。
表 6. IBM Tealeaf 製品の入手可能な資料：
IBM Tealeaf 製品
入手可能な資料
IBM Tealeaf CX
v IBM Tealeaf Customer Experience の概要ガ
イド
v IBM Tealeaf CX クライアント・フレーム
ワーク・データ統合ガイド
v IBM Tealeaf CX 構成マニュアル
v IBM Tealeaf CX Cookie Injector マニュア
ル
v IBM Tealeaf CX データベース・ガイド
v IBM Tealeaf CX イベント・マネージャ
ー・マニュアル
v IBM Tealeaf CX 用語集
v IBM Tealeaf CX インストール・マニュア
ル
v IBM Tealeaf CX PCA マニュアル
v IBM Tealeaf CX PCA リリース・ノート
IBM Tealeaf CX
v IBM Tealeaf CX RealiTea Viewer Client
Side Capture マニュアル
v IBM Tealeaf CX RealiTea Viewer ユーザ
ー・マニュアル
v IBM Tealeaf CX リリース・ノート
v IBM Tealeaf CX リリース・アップグレー
ド・マニュアル
v IBM Tealeaf CX サポートおよびトラブル
シューティング FAQ
v IBM Tealeaf CX トラブルシューティン
グ・ガイド
v IBM Tealeaf CX UI Capture j2 ガイド
v IBM Tealeaf CX UI Capture j2 リリース・
ノート
IBM Tealeaf cxImpact
v IBM Tealeaf cxImpact 管理マニュアル
v IBM Tealeaf cxImpact ユーザー・マニュア
ル
v IBM Tealeaf cxImpact レポーティング・ガ
イド
158
Tealeaf トラブルシューティング・ガイド
表 6. IBM Tealeaf 製品の入手可能な資料 (続き)：
IBM Tealeaf 製品
入手可能な資料
IBM Tealeaf cxConnect
v IBM Tealeaf cxConnect for Data Analysis
管理マニュアル
v IBM Tealeaf cxConnect for Voice of
Customer 管理マニュアル
v IBM Tealeaf cxConnect for Web Analytics
管理マニュアル
IBM Tealeaf cxOverstat
IBM Tealeaf cxOverstat ユーザー・マニュア
ル
IBM Tealeaf cxReveal
v IBM Tealeaf cxReveal 管理マニュアル
v IBM Tealeaf cxReveal API ガイド
v IBM Tealeaf cxReveal ユーザー・マニュア
ル
IBM Tealeaf cxVerify
v IBM Tealeaf cxVerify インストール・ガイ
ド
v IBM Tealeaf cxVerify ユーザーズ・ガイド
IBM Tealeaf cxView
IBM Tealeaf cxView ユーザーズ・マニュアル
IBM Tealeaf CX Mobile
v IBM Tealeaf CX Mobile Android Logging
Framework ガイド
v IBM Tealeaf Android Logging Framework
リリース・ノート
v IBM Tealeaf CX Mobile 管理マニュアル
v IBM Tealeaf CX Mobile ユーザー・マニュ
アル
v IBM Tealeaf CX Mobile iOS Logging
Framework ガイド
v IBM Tealeaf iOS Logging Framework リリ
ース¥ノート
第 7 章 IBM Tealeaf の資料およびヘルプ
159
160
Tealeaf トラブルシューティング・ガイド
特記事項
本書は米国 IBM が提供する製品およびサービスについて作成したものです。
本書に記載の製品、サービス、または機能が日本においては提供されていない場合
があります。日本で利用可能な製品、サービス、および機能については、日本 IBM
の営業担当員にお尋ねください。本書で IBM 製品、プログラム、またはサービス
に言及していても、その IBM 製品、プログラム、またはサービスのみが使用可能
であることを意味するものではありません。これらに代えて、IBM の知的所有権を
侵害することのない、機能的に同等の製品、プログラム、またはサービスを使用す
ることができます。ただし、IBM 以外の製品とプログラムの操作またはサービスの
評価および検証は、お客様の責任で行っていただきます。
IBM は、本書に記載されている内容に関して特許権 (特許出願中のものを含む) を
保有している場合があります。本書の提供は、お客様にこれらの特許権について実
施権を許諾することを意味するものではありません。実施権についてのお問い合わ
せは、書面にて下記宛先にお送りください。
〒103-8510
東京都中央区日本橋箱崎町19番21号
日本アイ・ビー・エム株式会社
法務・知的財産
知的財産権ライセンス渉外
以下の保証は、国または地域の法律に沿わない場合は、適用されません。 IBM お
よびその直接または間接の子会社は、本書を特定物として現存するままの状態で提
供し、商品性の保証、特定目的適合性の保証および法律上の瑕疵担保責任を含むす
べての明示もしくは黙示の保証責任を負わないものとします。国または地域によっ
ては、法律の強行規定により、保証責任の制限が禁じられる場合、強行規定の制限
を受けるものとします。
この情報には、技術的に不適切な記述や誤植を含む場合があります。本書は定期的
に見直され、必要な変更は本書の次版に組み込まれます。IBM は予告なしに、随
時、この文書に記載されている製品またはプログラムに対して、改良または変更を
行うことがあります。
本書において IBM 以外の Web サイトに言及している場合がありますが、便宜のた
め記載しただけであり、決してそれらの Web サイトを推奨するものではありませ
ん。それらの Web サイトにある資料は、この IBM 製品の資料の一部ではありませ
ん。それらの Web サイトは、お客様の責任でご使用ください。
IBM は、お客様が提供するいかなる情報も、お客様に対してなんら義務も負うこと
のない、自ら適切と信ずる方法で、使用もしくは配布することができるものとしま
す。
© Copyright IBM Corp. 1999, 2015
161
本プログラムのライセンス保持者で、(i) 独自に作成したプログラムとその他のプロ
グラム (本プログラムを含む) との間での情報交換、および (ii) 交換された情報の
相互利用を可能にすることを目的として、本プログラムに関する情報を必要とする
方は、下記に連絡してください。
IBM Bay Area Lab
1001 E Hillsdale Boulevard
Foster City, California 94404
U.S.A.
本プログラムに関する上記の情報は、適切な使用条件の下で使用することができま
すが、有償の場合もあります。
本書で説明されているライセンス・プログラムまたはその他のライセンス資料は、
IBM 所定のプログラム契約の契約条項、 IBM プログラムのご使用条件、またはそ
れと同等の条項に基づいて、 IBM より提供されます。
この文書に含まれるいかなるパフォーマンス・データも、管理環境下で決定された
ものです。そのため、他の操作環境で得られた結果は、異なる可能性があります。
一部の測定が、開発レベルのシステムで行われた可能性がありますが、その測定値
が、一般に利用可能なシステムのものと同じである保証はありません。さらに、一
部の測定値が、推定値である可能性があります。実際の結果は、異なる可能性があ
ります。お客様は、お客様の特定の環境に適したデータを確かめる必要がありま
す。
IBM 以外の製品に関する情報は、その製品の供給者、出版物、もしくはその他の公
に利用可能なソースから入手したものです。 IBM は、それらの製品のテストは行
っておりません。したがって、他社製品に関する実行性、互換性、またはその他の
要求については確証できません。 IBM 以外の製品の性能に関する質問は、それら
の製品の供給者にお願いします。
IBM の将来の方向または意向に関する記述については、予告なしに変更または撤回
される場合があり、単に目標を示しているものです。
本書には、日常の業務処理で用いられるデータや報告書の例が含まれています。よ
り具体性を与えるために、それらの例には、個人、企業、ブランド、あるいは製品
などの名前が含まれている場合があります。これらの名称はすべて架空のものであ
り、名称や住所が類似する企業が実在しているとしても、それは偶然にすぎませ
ん。
著作権使用許諾:
本書には、様々なオペレーティング・プラットフォームでのプログラミング手法を
例示するサンプル・アプリケーション・プログラムがソース言語で掲載されていま
す。お客様は、サンプル・プログラムが書かれているオペレーティング・プラット
フォームのアプリケーション・プログラミング・インターフェースに準拠したアプ
リケーション・プログラムの開発、使用、販売、配布を目的として、いかなる形式
においても、IBM に対価を支払うことなくこれを複製し、改変し、配布することが
できます。このサンプル・プログラムは、あらゆる条件下における完全なテストを
経ていません。従って IBM は、これらのサンプル・プログラムについて信頼性、
利便性もしくは機能性があることをほのめかしたり、保証することはできません。
162
Tealeaf トラブルシューティング・ガイド
これらのサンプル・プログラムは特定物として現存するままの状態で提供されるも
のであり、いかなる保証も提供されません。 IBM は、お客様の当該サンプル・プ
ログラムの使用から生ずるいかなる損害に対しても一切の責任を負いません。
商標
IBM、IBM ロゴおよび ibm.com® は、世界の多くの国で登録された International
Business Machines Corporation の商標です。他の製品名およびサービス名等は、それ
ぞれ IBM または各社の商標である場合があります。現時点での IBM の商標リスト
については、http://www.ibm.com/legal/copytrade.shtml をご覧ください。
プライバシー・ポリシーに関する考慮事項
サービス・ソリューションとしてのソフトウェアも含めた IBM ソフトウェア製品
(「ソフトウェア・オファリング」) では、製品の使用に関する情報の収集、エン
ド・ユーザーの使用感の向上、エンド・ユーザーとの対話またはその他の目的のた
めに、Cookie はじめさまざまなテクノロジーを使用することがあります。Cookie と
は Web サイトからお客様のブラウザーに送信できるデータで、お客様のコンピュ
ーターを識別するタグとしてそのコンピューターに保存されることがあります。多
くの場合、これらの Cookie により個人情報が収集されることはありません。ご使
用の「ソフトウェア・オファリング」が、これらの Cookie およびそれに類するテ
クノロジーを通じてお客様による個人情報の収集を可能にする場合、以下の具体的
事項をご確認ください。
デプロイされた構成によっては、このソフトウェア製品は、セッション管理、お客
様のユーザビリティーの向上、または他のご使用状況の追跡または機能上の目的の
ために、お客様のユーザー名その他の個人情報を収集するセッション・クッキーお
よびパーシスタント・クッキーを使用することがあります。これらの Cookie は無
効にできますが、その場合、これらを有効にした場合の機能を活用することはでき
ません。
Cookie およびこれに類するテクノロジーによる個人情報の収集は、各国の適用法令
等による制限を受けます。この「ソフトウェア・オファリング」が Cookie および
さまざまなテクノロジーを使用してエンド・ユーザーから個人情報を収集する機能
を提供する場合、お客様は、個人情報を収集するにあたって適用される法律、ガイ
ドライン等を遵守する必要があります。これには、エンド・ユーザーへの通知や同
意取得の要求も含まれますがそれらには限られません。
IBM は、お客様がお客様のエンド・ユーザー (お客様の Web サイトの訪問者) に
対して次のことを実施されるようお勧めします。 (1) お客様の Web サイトの「ご
利用条件」(すなわち、「プライバシー・ポリシー」)へのリンクがはっきりと目に見
えるように提供されていること。そのリンクには、IBM へのリンク、および訪問者
に関するデータ収集と用途について説明したリンクが含まれていること。 (2) お客
様に代わって IBM が訪問者のコンピューター上にクッキーおよび明らかにそれと
分かる GIF/Web ビーコンを置き、そのテクノロジーの説明も一緒に表示することを
通知すること。 (3) お客様またはお客様に代わって IBM がクッキーおよび明らか
にそれと分かる GIF/Web ビーコンを置く前に、法律で必要とされる範囲の、訪問者
からの許諾を得ること。
特記事項
163
このような意図による、クッキーを含めたさまざまなテクノロジーの使用に関する
情報は、「IBM オンラインでのプライバシー・ステートメント」
(http://www.ibm.com/privacy/details/jp/ja) の『クッキー、Web ビーコン、その他のテ
クノロジー』の節を参照してください。
164
Tealeaf トラブルシューティング・ガイド
Printed in Japan

Download Report