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

by user

on 28 марта 2017

Category: Documents

>> Downloads: 36

263

views

Report

Comments

Description

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

Transcript

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

IBM Tealeaf CX
バージョン 9 リリース 0.1
2014 年 12 月 4 日
Tealeafトラブルシューティン
グ・ガイド
お願い
本書および本書で紹介する製品をご使用になる前に、 157 ページの『特記事項』に記載されている情報をお読みください。
本書は、IBM Tealeaf CX バージョン 9 リリース 0 モディフィケーション 1 および新しい版で明記されていない限
り、以降のすべてのリリースおよびモディフィケーションに適用されます。
お客様の環境によっては、資料中の円記号がバックスラッシュと表示されたり、バックスラッシュが円記号と表示さ
れたりする場合があります。
原典：
IBM Tealeaf CX
Version 9 Release 0.1
December 4, 2014
Tealeaf Troubleshooting Guide
発行：
日本アイ・ビー・エム株式会社
担当：
トランスレーション・サービス・センター
© Copyright IBM Corporation 1999, 2014.
目次
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
ミラーリング・サーバー . . . . . . . . . . 1
データベースからのデータのクリア. . . . . . . 2
段階的な削除 . . . . . . . . . . . . . 2
キャニスターからのデータのクリア. . . . . . 2
SQL Server からのデータのクリア . . . . . . 4
Tealeaf システム上で時刻をチェックする . . . . . 5
Tealeaf サーバー . . . . . . . . . . . . 5
Tealeaf タイム・ゾーン . . . . . . . . . . 5
Passive Capture Application サーバー (PCA サーバ
ー). . . . . . . . . . . . . . . . . 5
RealiTea Viewer タイム・ゾーン . . . . . . . 6
構成 . . . . . . . . . . . . . . . . . 6
事前準備. . . . . . . . . . . . . . . . 6
Passive Capture Application サーバー (PCA サーバー)
のトラブルシューティング. . . . . . . . . . 6
PCA で /var/log/messages が非常に迅速に大きくなる 7
多数の ReqCancelled=Client ヒット . . . . . . 8
データのダンプの記録 . . . . . . . . . . 9
TL キューの開始に失敗し、キャプチャーが無効にな
る . . . . . . . . . . . . . . . . . 10
PCA Capture ログに「client_random missing」メッセ
ージが含まれている . . . . . . . . . . . 10
PCA Capture ログに「Max SYN/WAIT limit
reached」が含まれている . . . . . . . . . . 11
PCA 上で有効期限が切れた SSL 証明書の置換 . . 12
© Copyright IBM Corp. 1999, 2014
PCA キャプチャー・ログ・エラー・メッセージ
「reassd:SSL セッション・キャッシュ・エントリー
が見つかりません...(reassd: Couldn't find SSL session
cache entry . . .)」 . . . . . . . . . . . .
PCA が reveal オブジェクトを作成できなかった . .
PCA のリブート後に ReqCancelled ページが大幅に
増加する . . . . . . . . . . . . . . .
特定タイプのファイルのドロップ方法 . . . . .
非標準ファイル拡張子をキャプチャーするための
PCA の構成 . . . . . . . . . . . . .
非標準 MIME タイプをキャプチャーするための
PCA の構成 . . . . . . . . . . . . .
特定の拡張子を持つヒットの応答をドロップする
ための PCA の構成 . . . . . . . . . .
PCA ディスク・スペースを解放する . . . . . .
フェイルオーバーのトラブルシューティング . . .
フェイルオーバーの開始、停止、および再始動 .
フェイルオーバー状態の判別 . . . . . . .
Web コンソールの再始動時に、ulimit コア・ファイ
ル・サイズ制限を変更できないエラーが発生する . .
NIC の追加後に PCA が開始に失敗する. . . . .
エラー System.Web.HttpRequestValidationException . .
PSIO_SIGCAUGHT エラーの意味 . . . . . . . .
messages ディレクトリーが、「crond(pam_unix) セッ
ションはユーザー・ルートについてクローズされて
います (crond(pam_unix) session closed for user
root)」メッセージでいっぱいである理由 . . . . .
解決方法 1: メッセージの抑止 . . . . . . .
解決方法 2: 異なるログ・ファイルへのメッセー
ジのリダイレクト . . . . . . . . . . .
Siebel アプリケーション用の IIS 6 キャプチャー・
フィルターで正しくキャプチャーされない . . . .
カスタマー・サポートに提供する情報 . . . . .
追加 tcpdump コマンド . . . . . . . . . .
追加トピック . . . . . . . . . . . . . .
ライセンス・キーの検索および更新 . . . . . .
Windows レジストリーでのライセンス・キーの適
用 . . . . . . . . . . . . . . . .
デフォルト IIS 権限 . . . . . . . . . . .
グラフの開始日付に 1970 の日付が表示される . .
NT 認証済みユーザーがポータルにログインできない
一部のユーザーはポータルにログインできるが、400
- 不正要求エラーを受け取るユーザーもいる . . .
参照先 . . . . . . . . . . . . . . .
ポータルでの合計セッション数のカウントとアーカ
イブされたセッション数のカウントの差 . . . . .
Internet Explorer での表示の問題 . . . . . . .
信頼済みサイトとしての Tealeaf コンポーネント
の登録 . . . . . . . . . . . . . . .
Windows でのセキュリティー強化の削除または無
効化 . . . . . . . . . . . . . . . .
12
13
14
15
15
15
16
16
17
17
18
21
22
23
23
24
25
25
26
26
26
29
29
30
30
30
30
31
32
32
32
33
33
iii
IE8 を使用してローカル・マシンでポータルにロ
グインしようとしたときのスタック・オーバーフ
ロー・エラー . . . . . . . . . . . . .
管理グループに対するすべてのメニューへのアクセ
スの有効化 . . . . . . . . . . . . . .
Internet Explorer でメニュー・バーの下にポータル・
コンテンツが表示されない . . . . . . . . .
ポータルの時刻が数時間ずれている . . . . . .
ポータルが検索サーバーに接続できない . . . . .
Excel に XML エクスポートを表示できない . . .
トラブルシューティング・トピックのプレリリース
5.0 . . . . . . . . . . . . . . . . .
データベースからの誤った日付のパージ . . . .
グラフの作成時にイベントの説明が見つからない
ポータル・ホーム・ページの一般エラー . . . .
ポータルのログオン画面を取得できない . . . .
エラー - 593-Non ADMIN user blocked from
logon . . . . . . . . . . . . . . .
どのユーザー ID を使用してもポータルにログイ
ンできない . . . . . . . . . . . . .
ポータルのライブ・セッション・ページで 500 エ
ラーが出される . . . . . . . . . . . .
IIS エラー・メッセージ . . . . . . . . . .
エラー・メッセージ: 「アプリケーションプール
'DefaultAppPool' の ID が無効です。」 . . . .
エラー・メッセージ: 「App-Domain が作成され
なかったため、要求を実行できませんでした。エ
ラー: 0x80004005 未定義のエラー」 . . . . .
エラー・メッセージ:「ディレクトリの変更の監視
を開始できませんでした」エラー・メッセージ .
エラー・メッセージ: 「現在の ID (NT
AUTHORITY¥NETWORK SERVICE) は
C:¥WINDOWS¥Microsoft.NET¥Framework¥
v2.0.50727¥Temporary ASP.NET ファイルへの書き
込みアクセス権がありません」 . . . . . . .
エラー・メッセージ: 「ASP.NET はドメインコ
ントローラー上の ASPNET アカウントでは動作
しません」 . . . . . . . . . . . . .
エラー・メッセージ:「CS0016: 出力ファイル
c:¥WINDOWS¥Microsoft.NET¥Framework64¥
v2.0.50727¥Temporary ASP.NET Files¥portal¥
d71063af¥5e3121f8¥App_global.asax.j8jlnnti.dll に書
き込めませんでした」 - 「アクセスは拒否されま
した。」 . . . . . . . . . . . . . .
エラー・メッセージ: 401.2 「サーバーの構成に
よりログオンに失敗しました」 . . . . . . .
共通 IIS 404 問題 . . . . . . . . . . .
301 ステータス・コード . . . . . . . . .
Windows/System32/LogFiles/W3SVC の中にログ・
エントリーがない . . . . . . . . . . .
サービス利用不可メッセージ . . . . . . .
一部の NT ユーザーがポータルへのアクセス時に
400 - 要求の長さのエラー・メッセージを受け取
るが、受け取らないユーザーもいる . . . . .
ログインしようとしても Default.aspx から離れら
れない . . . . . . . . . . . . . . .
iv
36
37
37
37
38
39
40
40
41
41
42
42
43
43
43
43
43
44
44
44
セッションが 29 時間 (1740 分、つまり 1 日と
5 時間) で存続しなくなる . . . . . . . .
エラー・メッセージ: 「NT ログイン/DB ログイ
ンと新しいユーザーのダイアログがすべて
Default.aspx ページに表示されます」 . . . . .
Internet Explorer でも NT 資格情報ダイアログが
ポップアップする . . . . . . . . . . .
BBRFilter.dll の開始中のエラー . . . . . . .
ロケール・エラー . . . . . . . . . . .
「system.net/defaultProxy」構成セクションで指定
された Web プロキシーの作成中にエラーが発生
する。 . . . . . . . . . . . . . . .
IIS7 を使用していて 401.2 が表示される . . .
役に立つ他の Microsoft 知識ベースの記事 . . .
完了したセッションの検索を実行できない . . . .
ステータス・コード 400 エラー . . . . . .
検索パフォーマンス問題の診断 . . . . . . . .
「すべてのテキスト」で検索される内容 . . . . .
検索に単語 NOT を含めることができない . . . .
フィールド名に ~ または他の句読文字が含まれたフ
ィールドで検索できない . . . . . . . . . .
セッション・フラグメントが検索結果に影響する理
由 . . . . . . . . . . . . . . . . .
ポータルとビューアー (またはデータ抽出/cxConnect)
でレポートされるセッション・カウントの差 . . .
構成 . . . . . . . . . . . . . . . . .
ディスクの入出力が制限されているかどうかの判別
方法 . . . . . . . . . . . . . . . . .
dtSearch のハング後に繰り返し再始動される . . .
キャニスター・スペーサー・ファイルが存在しない
サービスの開始時に DecoupleEx 警告が発生する . .
TeaLeaf Technology Error: Data length (xxxxxx)
exceeds maximum size (yyyyyyy). Body discarded . .
FetchNSAT で WriteInteraction に失敗した . . . .
FetchNSAT で WriteInteraction にコード -160 で
失敗した . . . . . . . . . . . . . .
FetchNSAT で WriteInteraction にコード -127 で
失敗した . . . . . . . . . . . . . .
構成 . . . . . . . . . . . . . . . . .
46
46
46
47
47
47
48
48
49
50
51
51
52
52
52
54
54
54
55
56
57
58
58
58
58
59
第 2 章 Tealeaf データベースのトラブル
シューティング . . . . . . . . . . . 61
44
44
45
45
45
45
45
45
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
SQL Server 構成. . . . . . . . . . . . .
SQL Server に接続できない . . . . . . . .
モデル・データベース・サイズの不一致が原因で
インストールに失敗する . . . . . . . . .
SQL Server 動的ポートの使用の構成 . . . . .
新しい SQL Server へのマイグレーション . . .
64 ビット・オペレーティング・システムにおける
SQL Server のパフォーマンスが悪い . . . . .
SuperSocket 情報: (SpnRegister): Windows アプリ
ケーション・イベント・ログ内のエラー 1355 . .
SQL Server がプロシージャー
sys.sp_OAGetProperty へのアクセスをブロックす
る . . . . . . . . . . . . . . . .
Tealeaf データベース構成. . . . . . . . . .
61
61
62
62
63
64
65
65
66
接続できない . . . . . . . . . . . . .
アップグレード時に Tealeaf データベース・マネ
ージャーで結果セット抽出のアップグレードに失
敗する . . . . . . . . . . . . . . .
クラスター化サーバー環境でデータベースの作成
に失敗する . . . . . . . . . . . . .
Tealeaf データベース・パフォーマンス . . . .
システム・データベースのアップグレード時に
Tealeaf データベース・マネージャーがハングする
個別データベースでの問題 . . . . . . . . .
cxResults の訪問者データベース . . . . . .
cxResults の結果セット抽出データベース . . .
cxReveal の検索データベース . . . . . . .
構成の問題 . . . . . . . . . . . . . .
データ収集 . . . . . . . . . . . . .
訪問者データベース抽出 . . . . . . . . . .
訪問者を検索できません . . . . . . . . .
断続的な検索サーバー接続エラーでエラー・コー
ド 12029 がレポートされる . . . . . . . .
VDB ログオンでの TCP 接続エラー (Windows
Server 2003 SP2). . . . . . . . . . . .
データベース・アップグレードのトラブルシューテ
ィング . . . . . . . . . . . . . . . .
データベースのアップグレード時における無効な
ファイル・グループ指定エラー . . . . . . .
チェックリスト . . . . . . . . . . . . .
キャニスター・パフォーマンスの調整 . . . . .
キャニスター・ステータスのモニター . . . .
キャニスター・スプーリング . . . . . . .
Tealeaf のサイズ変更の計算 . . . . . . . .
セッション・タイムアウトの設定 . . . . . .
セッションがフラグメント化する理由 . . . . .
Tealeaf サービスが TLUSER または ADMIN として
キャニスターに接続できない . . . . . . . .
キャニスター・サービスが再始動され続ける . . .
キャニスター・ストレージ割り振りの評価 . . . .
キャニスター・セッション・エージェント・パフォ
ーマンスの評価 . . . . . . . . . . . . .
アーカイブ・サーバーなしでのキャニスター・ファ
イルのバックアップ . . . . . . . . . . .
キャニスターの移動 . . . . . . . . . . .
キャニスター検索インデックス・データの移動 .
キャニスター・セッション・データの移動 . . .
キャニスター移動の完了 . . . . . . . . .
ctree エラー . . . . . . . . . . . . . .
NextLssnRec() のエラー 160(0) . . . . . . .
エラー 69(0) . . . . . . . . . . . . .
構成 . . . . . . . . . . . . . . . . .
例外をトラブルシューティングするためのログ・レ
ベルの変更 . . . . . . . . . . . . . .
「インデックス付け待ちのセッション数 (Sessions
waiting to be indexed)」がしきい値を超えた . . .
一部のセッションがインデックスから欠落している
ように思われる . . . . . . . . . . . . .
キャニスターからのインデックス付けセッション数
の取得に失敗した . . . . . . . . . . . .
66
66
66
67
67
68
68
69
69
70
70
72
72
73
73
74
74
74
75
75
76
79
81
81
82
82
82
インデックス・エラー・リカバリー . . . . . . 91
インデックスの再作成 . . . . . . . . . . . 91
構成 . . . . . . . . . . . . . . . . . 91
RSE サービスで障害が起こる . . . . . . . . 91
照会サーバーを正しくシャットダウンおよび再始動
できない . . . . . . . . . . . . . . . 92
トラブルシューティング - データ収集プログラム . 93
許容可能なエラー・メッセージ . . . . . . . 93
パフォーマンスの問題 . . . . . . . . . . 93
データ収集プログラム・サービスまたはレポー
ト・データベースがダウンした場合、統計データ
はどうなるか? . . . . . . . . . . . . 94
イベント・グラフのカウントとドリルダウン検索
のカウントの不一致 . . . . . . . . . . 95
キャニスターとデータ収集プログラムの接続性の
問題 . . . . . . . . . . . . . . . . 96
イベント・ログ内の SQL 例外「接続はピアによ
ってリセットされました: ソケット書き込みエラ
ー」 . . . . . . . . . . . . . . . . 97
データベース・ファイル・グループ・レポートに
データが表示されない . . . . . . . . . . 97
トラブルシューティング - データ・サービス . . . 98
ReportQueryLogEntity エラー・メッセージの書き
込みに失敗した . . . . . . . . . . . . 98
トラブルシューティング - レポート・サービス . . 98
トラブルシューティング - レポート・ビルダー . . 98
レポート・ビルダーからのドリルダウン時の
「There are no matches for your search」 . . . 98
トラブルシューティング - トップ・ムーバー. . . 100
トップ・ムーバーが更新されない. . . . . . 100
ログのレポート. . . . . . . . . . . . . 102
構成 . . . . . . . . . . . . . . . . 102
検索サーバー・ログの「Auth failed, no
Authorization header on cmd」エラー . . . . . 102
検索サーバー構成で Active Directory グループを追
加できない . . . . . . . . . . . . . . 103
83
第 3 章トラブルシューティング - 再生
サーバー. . . . . . . . . . . . . . 105
84
84
85
85
86
86
86
88
88
トラブルシューティング - レンダリング問題. . .
BBR 再生ビューにエンコードされた文字が含まれ
た応答が表示される . . . . . . . . . . .
構成 . . . . . . . . . . . . . . . .
再生サーバーでのプロキシー・エラーが原因で
BBR セッションが BBR で再生されない . . . .
診断 . . . . . . . . . . . . . . .
修正 . . . . . . . . . . . . . . .
BBR でのイベントまたはヒット属性の作成時にポ
ータルが含まれているブラウザー・ウィンドウが開
かない. . . . . . . . . . . . . . . .
ページのレンダリングのエラー . . . . . . .
89
105
106
106
106
107
107
108
109
89
90
90
第 4 章トラブルシューティング RealiTea Viewer . . . . . . . . . . 111
RealiTea Viewer をインストールできません .
.
. 111
目次
v
エラー - 「TeaLeaf RealiTea Viewer requires
Microsoft IE V5.0 or greater」 . . . . . . .
RTV のアンインストール後にもかかわらず「削
除しますか (Would you like to remove)」が表示
され続ける . . . . . . . . . . . . .
RTV パフォーマンスの改善 . . . . . . . .
RTV 拡張オプションの設定 . . . . . . .
外部ファイル・データベースの作成 . . . . .
RealiTea Viewer にイメージが表示されない . . .
RealiTea Viewer でスクリプトが再生されない . .
Error - CallJS: JavaScript 関数が見つかりません:
TeaLeaf_Client_tlGetNodeFromXPath . . . . .
RTV でのセッションの取得中における「結果セッ
トからセッションをロードできません」 . . . .
アーカイブされたセッションの再生時におけるエラ
ー . . . . . . . . . . . . . . . . .
ステータス・コード 0 の原因 . . . . . . . .
いくつかのページで「戻る」ボタンが押されたとビ
ューアーで誤って表示される . . . . . . . .
HTTP ヘッダーが「再生」ビューで表示される . .
セッションの再生時に一部のページが欠落している
ように思われる. . . . . . . . . . . . .
HTTP ステータス・コード 304 およびキャッシュ
に入れられたオブジェクト . . . . . . . . .
セッションで .css ファイルが欠落している理由
静的 HTML ページの再生時におけるエラー . . .
Internet Explorer の最新バージョン用に作成された
アプリケーションでの再生の問題. . . . . . .
IE6 のプロキシー問題 . . . . . . . . . .
IndexWizard.dll が非互換であるとビューアーに表示
される. . . . . . . . . . . . . . . .
埋め込みの .pdf 文書が別ウィンドウで開く . . .
イベント・アイコンが使用不可になっている . . .
オールインワン Tealeaf またはスタンドアロン・
ポータル・サーバー . . . . . . . . . .
マルチサーバー・デプロイメント. . . . . .
再生ルール . . . . . . . . . . . . . .
IgnoreURL ルールにより、イベント・リストが
ページ・リストにマージされる . . . . . .
RealiTea Viewer (RTV) の継続的な異常終了 . . .
DWR POST の POST データの突き合わせが失敗す
る . . . . . . . . . . . . . . . . .
複数のバージョンの CX での RTV の使用 . . .
vi
111
111
112
112
113
113
114
114
115
116
116
116
117
トラブルシューティング - 再生の説明 . . . .
再生の概要 . . . . . . . . . . . . .
チェック 1. 必要なものがすべてセッション内にあ
ることを確認する . . . . . . . . . . .
チェック 2. 必要なデータがプライバシーによって
ブロックされていないことを確認する . . . .
チェック 3. Client UI Capture for Ajax が使用中
で、そのイベントがキャプチャーされる . . .
チェック 4. ナビゲーション・リストの各ページに
対して要求されているメインページが 1 つのみで
あることを確認する . . . . . . . . . .
チェック 5. フレーム・コンテンツが正しく構成さ
れていることを確認する. . . . . . . . .
次のステップ . . . . . . . . . . . .
. 125
. 125
. 125
. 127
. 128
. 129
. 130
. 131
第 5 章再生の問題のテーブル . . . . 133
cxReveal エラー「スレッドは中止されつつありま
した。(Thread was being aborted.)」 . . . . . . 146
cxReveal データベースにあるセッションを再生でき
ない . . . . . . . . . . . . . . . . 146
117
第 6 章 Tealeaf 管理システムのトラブ
ルシューティング . . . . . . . . . . 149
118
119
120
始動 . . . . . . . . . . . . . . . .
TMS マスターのサーバー・リストに TMS スレ
ーブ・サーバーが表示されない . . . . . .
始動時に、イベント・ログオン TMS スレーブ
で、TMS マスターとして実行されていると示さ
れる . . . . . . . . . . . . . . .
自己署名 TMS 証明書の有効期限が切れた. . .
TMS サービスに対して非 SSL モードを構成し
ている場合は、Tealeaf 管理システム (TMS) に
アクセスしようとするとエラーが発生します。 .
アクセス . . . . . . . . . . . . . . .
不明なマスターからの要求 . . . . . . . .
120
121
122
122
122
122
122
123
123
123
124
124
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
149
149
149
149
151
152
152
第 7 章 IBM Tealeaf の資料およびヘル
プ . . . . . . . . . . . . . . . . 153
特記事項. . . . . . . . . . . . . . 157
商標 . . . . . . . . . . . . .
プライバシー・ポリシーに関する考慮事項.
.
.
.
.
. 159
. 159
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, 2014
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
IBM Tealeaf CX: 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
IBM Tealeaf CX: 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 のトラブルシューティングについては、 149 ページの『第 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
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
第 1 章データの保存と再作成
以下のセクションには、システム障害の発生時にシステムを迅速にリストアまたは
マイグレーションできるように、重要な 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
ミラーリング・サーバー
問題が発生しているのと同じインストール済み環境および設定が含まれたミラー・
サーバーを作成して、環境を保存することができます。これを行うには、Norton
Ghost のようなツールを使用して、サーバーのディスクのイメージを作成します。
© Copyright IBM Corp. 1999, 2014
1
データベースからのデータのクリア
段階的な削除
データベースの段階的なクリアを実行するために、キャニスター、データ収集、お
よびデータ保存の各設定を調整して、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 キャニスターおよびデータベースでは、構成設定に基
づいて古いデータがトリムされます。
注: キャニスターからクリアされたデータをリカバリーすることはできません。
Tealeaf では、安全のため、キャニスターのバックアップを実行することをお勧めし
ます。「IBM Tealeaf cxImpact 管理マニュアル」の『TLBackup および TLRestore』
を参照してください。
キャニスターの再作成
必要であれば、短期キャニスター、長期アーカイブ、および対応する dtSearch イン
デックスを再作成できます。CanRebuild ユーティリティーは、すべてのセッショ
ン・データの削除も行います。すべてのデータを削除した後に、短期キャニスタ
ー・テーブルを再作成し、イベント定義を読み取ります。
2
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
注: 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 サーバー・マシンおよびインデックス付けマシン (デュ
アル・インストール済み環境の場合) でサービスを停止します。キャニ
スターからすべてのセッション・データを削除し、キャニスター・テー
ブルを再作成します。「完全なキャニスターの再作成 (Rebuild Full
Canister)」オプションでは、セッションの対応するインデックスも削除さ
れます。
スプール・ファイルの削除 (Delete Spool Files)
このオプションが選択された場合、キャニスター・ハード・ディスクに
保管されているスプールされたヒットが含まれているすべてのファイル
が削除されます。このオプションを使用するのは、スプールされたデー
タが破損状態であることが分かっている場合か、削除する必要がある場
合のみにしてください。
セッション・データの保持 (Preserve Session Data)
このオプションは、サーバー上の長期キャニスターに保管されたセッシ
ョン・データを保持する場合に選択します。
第 1 章データの保存と再作成
3
注: このオプションが有効になっていない場合、サーバー上のすべての
セッション・データ (インデックス・ファイルを含む) は、再作成の一環
として削除されます。
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 データベース・マネージャーを使
用して管理できます。
リモート MS SQL データベースを再作成するには、以下のようにします。
注: このプロセスには、SQL Server でのシステム管理者特権が必要です。
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 データベース・マネー
ジャー・リファレンス』を参照してください。
4
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
Tealeaf システム上で時刻をチェックする
注: すべての Tealeaf サーバー上の時刻が厳密に同期されていることが重要です。
信頼できるマスター・クロックにそれ自体が同期されている共通ソースに対して、
すべてのサーバーが同期されている必要があります。
Tealeaf サーバー
Tealeaf ソフトウェアは通常、Windows 2003 または Windows 2008 サーバーで実行
されます。各サーバーの「コントロールパネル」で、「日付と時刻」アプレットを
使用して、タイム・ゾーン、日付、および時刻が正しく設定されていることを確認
します。
サーバーは自動的に、サーバーの接続先のドメイン・コントローラー上のクロック
に自身のクロックが同期された状態を保ちます。Tealeaf システムがドメインに属し
ていない場合、http://support.tealeaf.com/ でサポート・ケースを開いて、スクリプ
ト・ソリューションまたはサード・パーティーの時刻同期ソリューションの構成の
支援を依頼してください。
Tealeaf タイム・ゾーン
リリース 8.0 では、ユニバーサル・タイム・ゾーン設定がすべての Tealeaf サーバ
ーに適用されます。
すべての Tealeaf ソフトウェアは、夏時間調整時刻に必要な変更を認識していま
す。すべてのタイム・ゾーンの選択は、標準時からのオフセットを使用して行われ
ます。例えば、夏時間調整時刻が有効になっている場合でも、米国の東海岸にある
すべてのシステムに対して、「GMT-5:00 東部標準時 (米国およびカナダ)」を選択
する必要があります。
v 「IBM Tealeaf CX 構成マニュアル」の『システム・タイム・ゾーンの構成』を参
照してください。
Passive Capture Application サーバー (PCA サーバー)
PCA サーバーは企業のマスター・クロックにアクセスできない可能性があるため、
接続先のメイン Tealeaf トランスポート・サービスに時刻を同期するように構成す
る必要があります。
PCA サーバー時間は、時間設定で最も重要です。すべての PCA サーバーは、互い
に数秒以内の差になっていなければなりません。PCA サーバーは、要求ごとに
[timestamp] セクションを作成します。ここに記録された日時は、GMT 時間です。
v 各タイム・スタンプの末尾に追加された Z に注意してください。
PCA サーバー時間を同期するには、以下のようにします。
1. SSH と root ユーザー ID を使用して PCA サーバーにログインします。
a. データ・センター内のメイン Tealeaf トランスポート・サービスをホストし
ている Tealeaf サーバーにインストールされていることが多い、PuTTY プロ
グラムを使用できます。
2. コマンド date を実行します。これにより、日付、時刻、および PCA サーバー
で構成されているタイム・ゾーンが表示されます。
第 1 章データの保存と再作成
5
v 「IBM Tealeaf Passive Capture Application マニュアル」の『PCA Web コンソ
ール -「配信 (Delivery)」タブ』を参照してください。
v タイム・ゾーンの変更について詳しくは、「IBM Tealeaf CX 構成マニュア
ル」の『システム・タイム・ゾーンの構成』を参照してください。
RealiTea Viewer タイム・ゾーン
IBM Tealeaf CX RealiTea Viewer スタンドアロン・アプリケーションの個別ユーザ
ーは、RTV で使用されるタイム・ゾーンを構成できます。通常、これは RTV ユー
ザーのタイム・ゾーンにします。
1. RTV を起動します。
2. メニュー・バーから「ツール」 > 「オプション」を選択します。
3. 結果のダイアログで「再生」タブを選択します。
4. 「タイム・ゾーン」ドロップダウンから正しいタイム・ゾーンを選択します。
構成
システム・タイムの構成について詳しくは、「IBM Tealeaf CX 構成マニュアル」の
『システム・タイム・ゾーンの構成』を参照してください。
事前準備
トラブルシューティングを開始する前に、以下の構成ステップを正常に完了したこ
とを検討および確認する必要があります。
v PCA のインストール後に、必要なすべてのデータ型を効果的にキャプチャーし、
ご使用の環境内でのキャプチャー用に PCA を調整するために、追加構成が必要
になることがあります。「IBM Tealeaf Passive Capture Application マニュアル」
の『インストール』を参照してください。
v また、PCA が初期インストール時に正しく構成されたことを検討および確認する
必要もあります。「IBM Tealeaf Passive Capture Application マニュアル」の『初
期 PCA 構成』を参照してください。
Passive Capture Application サーバー (PCA サーバー) のトラブルシュ
ーティング
TMS の「パイプライン・ステータス」タブを確認することで、Tealeaf 処理サーバ
ーが、PCA からキャプチャーされたデータを受け取っているかどうかを判別できま
す。
1. Tealeaf ポータルに管理者としてログインします。
2. メニューから、「Tealeaf」 > 「TMS」を選択します。
3. 「パイプライン・ステータス」タブをクリックします。「IBM Tealeaf cxImpact
管理マニュアル」の『TMS の「パイプライン・ステータス」タブ』を参照して
ください。
6
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
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/)
またはこれに相当するツールを使用して、これを開き、パケットの欠落などの異
常について分析する必要があります。
a. 表示されている内容が分からない場合、Tealeaf は、ライブ・ミーティング・
セッションによって、またはお客様からダンプ・ファイルを取得して (ユーザ
ーの個人情報が含まれていない場合)、この診断の支援を行うことができま
す。
PCA で /var/log/messages が非常に迅速に大きくなる
デフォルトの syslog.conf では、/var/log/messages がすべてのログ通知メッセージ
(Passive Capture からのものを含む) を受け取ります。Red Hat Linux で
syslog.conf を変更して「messages」ファイルが Passive Capture メッセージを受け
取らないようにするには、以下のように、/etc/syslog.conf ファイルの
/var/log/messages 行を編集します。
*.info;mail.none;authpriv.none;cron.none;local0.none /var/log/messages
第 1 章データの保存と再作成
7
local0.none 設定を組み込んで、Passive Capture ログ・メッセージが
/var/log/messages に書き込まれないようにします。
v これらのメッセージは引き続き、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 ヒットが密接して発生している
ことがあります。
どちらの場合でも、Tealeaf キャプチャーの有効性に関する問題を示しています。こ
の問題をトラブルシューティングするには、tcpdump コマンドを使用する必要があ
ります。
1 つのファイルに tcpdump を実行すると、大きなファイルがすぐに生成されます。
tcpdump および http://support.tealeaf.com/ リソースを最大限に利用してデータを分析
するには、多数の ReqCancelled=Client ヒットが含まれているセッションを再現で
きることが重要になります。分析用のダンプ・ファイルの記録を開始する前に、問
題の動作を効果的に作成可能である必要があります。そのため、最初のステップと
して、ReqCancelled ヒットを確実に再現する方法を調査します。
注: この解決方法は、標準インデックス付けを使用している 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
8
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
– HTTP VIA (Tealeaf によってキャプチャーされる REQ で提供されている場
合)。一部のネットワークではこのフィールドはありませんが、物理ロー
ド・バランサーまたはプロキシーに関係するネットワークにはあります。
2. 少なくとも 1 営業日、通常どおりにデータ収集を実行します。
3. 検索を手動で使用して、上記のケース 1 で指定したのと同じ情報を取得しま
す。
分析により、多数の ReqCancelled=Client が含まれたセッションの原因であ
る可能性が最も高い特定の状態が導き出されたら、次にデータ・ダンプを記録
します。
データのダンプの記録
1. ReqCancelled=Client ヒットを引き起こした可能性が最も高いと分かっている状
態をできる限り綿密に複製する必要があります。いずれかの特定のページにアク
セスでき、またいずれかの特定の Web サーバーまたはプロキシーに要求を送信
できることを確認する必要があります。数回テスト実行を完了し、特定のテス
ト・セッションを行い、Tealeaf でキャプチャーされたデータを使用して、テス
ト・セッションに多数の ReqCancelled=Client ページがまだ含まれていること
を確認します。
2. 実際の tcpdump レコードを作成するための時間を用意します。
a. 可能であれば、1 日の静かな時間にスケジュールします。
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/ に問い合わせ
て、データのリモート分析用の時間を設けてください。
第 1 章データの保存と再作成
9
9. キャプチャーされたセッション、およびセッションがキャプチャーされたのと同
じ期間における未加工トラフィックの対応する tcpdump が用意できたら、
Tealeaf エンジニアリングが、ReqCancelled=Client ヒットの根本原因の特定を
支援できます。
TL キューの開始に失敗し、キャプチャーが無効になる
キャプチャーを正しく初期化できなかった場合は、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
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 が開始されます。
PCA Capture ログに「client_random missing」メッセージが含まれてい
る
上記のメッセージが capture.log に表示された場合、PCA で SSL トラフィックが
破損していることが示されています。
v 原因としては、多くの問題が考えられます。PCA が使用している SSL 鍵が重複
している可能性があります。
v 使用している鍵について詳しくは、「IBM Tealeaf Passive Capture Application マ
ニュアル」の『PCA Web コンソール -「SSL 鍵 (SSL Keys)」タブ』を参照して
ください。
v 「IBM Tealeaf Passive Capture Application マニュアル」の『SSL 鍵』を参照して
ください。
10
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
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 パケットが破損した
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」メッセージが表示される可能性があります。
第 1 章データの保存と再作成
11
関連する問題をデバッグする際に、PCA の最大 SynWait 制限を大きくすることが
できます。多数の高トラフィック・スパイクがあるサイトでは、インストール/構成
時に、この制限を大きくする必要が生じることがあります。最大制限を大きくした
後に、キャプチャー・ログをモニターします。
v Syn/Wait バッファーがすぐにいっぱいになり、毎分、多数の接続がドロップされ
ている場合、恐らく、問題は SPAN ポート構成にあります。
v 1 時間に数個の Syn/Wait パケットが欠落しているだけの場合は、恐らく、正常
なネットワーク動作です。
PCA 上で有効期限が切れた SSL 証明書の置換
Web コンソールを暗号化するために SSL 証明書が PCA に追加されている場合、
その証明書は最終的に有効期限が切れます。有効期限が切れた場合、
http://support.tealeaf.com/ の解決方法『How to encrypt the PCA Console』の指示に従
って、新規証明書を PCA に追加する必要があります。
新規証明書は、Windows のスケジュールされたタスクとして PortalStatus を実行し
ているユーザーのセキュリティー・コンテキストで、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 セッションは固有であり、セッションが完全にネゴシエーションされた後
に、長期セッションで再使用するために、そのセッション・キーがキャッシュに入
れられます。このメッセージは、次の 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 より大きくしないでください。
12
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
v (可能性は高くない) PCA 再始動が発生したことが原因で、SSL セッション項目
キャッシュ・テーブルがクリアされました。PCA ソフトウェアの再初期化後に、
進行中だった SSL トランザクションにより、「not found」メッセージが生成さ
れます。再始動が発生するのは、Web コンソール構成変更を保存した場合、また
は正常性/保守スクリプトが、PCA の正常性の評価に基づいて再始動命令を発行
した場合です。
PCA が reveal オブジェクトを作成できなかった
ビルド 3324 以降にアップグレードした後に、PCA Capture ログに以下のようなエ
ラー・メッセージが見つかることがあります。 PCA を開始できない可能性があり
ます。
Oct 12 12:05:03 sh005 reassd[4763]: Couldn’t create reveal object: 1
上記の場合、問題は恐らく、古い PCA ビルドによって生成された秘密鍵を新しい
ビルドが検証できないことにあります。基本的な解決方法としては、現在の 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
第 1 章データの保存と再作成
13
6. PCA の再始動後に、Web コンソールを使用して、すべての PCA プロセスが機
能していること、およびデータが適切なターゲットに渡されていることを確認
します。
v 「IBM Tealeaf Passive Capture Application マニュアル」の『PCA Web コン
ソール -「サマリー」タブ』を参照してください。
v 「IBM Tealeaf Passive Capture Application マニュアル」の『PCA Web コン
ソール -「配信 (Delivery)」タブ』を参照してください。
7. PCA 操作が確認された場合、問題は、問題のある .ptl 鍵に特定されていま
す。
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 ページが大幅に増加する
注: 以下の解決方法は、2058 より前の TeaLeaf Passive Capture バージョンにのみ
適用されます。
リブート後に、ReqCancelled ページの数が大幅に増加することがあります。Linux
カーネルは、リブート後に 2 つのメモリー・パラメーターをデフォルト値にリセッ
トします。この動作を修正するには、以下のステップが必要です。
v 以下のように、実行中の値を変更します。
1. PCA に SSH で接続し、root にログイン (または su を実行) します。
2. 以下のコマンドを使用して、Tealeaf キャプチャー・ソフトウェアを停止しま
す。
service tealeaf-pca stop
3. 以下の 2 つのコマンドを発行します。
14
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
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 の新規設定をロードします。
注: PCA Capture SW 2058 以降のバージョンでは、開始時にこれらの値が自動的に
検査されて構成されます。該当するバージョンのいずれかを実行している場合は、
ここに示している回避策を適用する必要はありません。
また、sysctl.conf ファイルの変更を今行い、後で 2058 以降にアップグレードす
ることもできます。アップグレード時に sysctl.conf ファイルの変更を削除する必
要はありません。
特定タイプのファイルのドロップ方法
特定のタイプのファイルであるヒットをドロップするように PCA を構成できま
す。これは、.PDF などの大きなバイナリー・ファイル・タイプが Tealeaf によって
キャプチャーおよび処理されないようにする場合に役に立ちます。以下の一連のス
テップでは、特定の拡張子を持つ応答ファイルがキャプチャーから削除される一方
で、そのファイルが照会されている要求は、キャプチャー・ストリーム内に入った
ままになっています。
非標準ファイル拡張子をキャプチャーするための PCA の構成
1. PCA Web コンソールを開きます。
2. 「パイプライン」タブをクリックします。
3. 必要な拡張子を「包含されるファイル拡張子 (Included File Extensions)」リスト
に追加します。
a. 必要な拡張子を「包含されるファイル拡張子 (Included File Extensions)」テ
キスト・フィールドに入力します。
b. 「追加」をクリックします。
c. 「変更の保存」をクリックします。
非標準 MIME タイプをキャプチャーするための PCA の構成
1. PCA Web コンソールを開きます。
2. 「パイプライン」タブをクリックします。
3. 必要な拡張子を「以下の MIME タイプをすべてキャプチャー (Capture All
Mimetypes)」リストに追加します。
a. 必要な MIME タイプを「以下の MIME タイプをすべてキャプチャー
(Capture All Mimetypes)」テキスト・フィールドに入力します。
b. 「追加」をクリックします。
第 1 章データの保存と再作成
15
c. 「変更の保存」をクリックします。
特定の拡張子を持つヒットの応答をドロップするための 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 ディスク・スペースを解放する
デフォルトでは、IBM Tealeaf CX Passive Capture Application は、/usr パーティシ
ョンにインストールされます。さまざまなメッセージによって、パーティションが
いっぱいになっていることを示す内容を受け取ることがあります。以下のステップ
を実行して、パーティションがいっぱいであることを確認し、ディスク・スペース
を解放するための対策を実行します。
1. /usr がスペース不足になっていることを確認します。使用可能なすべてのパー
ティションのディスク・スペースを確認するには、PCA をホストしている
Linux サーバーで以下のコマンドを実行します。
df -h
v /usr パーティションで使用可能なディスク・スペースを確認します。
2. サーバー上で、/usr/local/ctccap/bin-debug にナビゲートします。名前が
core で始まるファイルを検索します。これらのコア・ダンプ・ファイルは大き
くなる可能性があるため、問題解決のために、削除するか、別の場所に移動する
必要があります。
v すべてのコア・ダンプ・ファイルを検索するために、ctccap ディレクトリー
にナビゲートし、以下のコマンドを実行します。
find /usr/local/ctccap/ -name "core*" -print
v 可能であれば、これらのファイルを削除して、ディスク・スペースを解放しま
す。
16
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
フェイルオーバーのトラブルシューティング
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 の正しい開始順序は、以下のとおりで
す。
v 最初にマスター PCA を開始します。
v マスター PCA が正常に開始された後に、スレーブ PCA を開始します。
注: 正しいフェイルオーバー操作で問題が発生している場合、常にコマンド・ラ
インを使用して手動で停止および開始する必要があります。
第 1 章データの保存と再作成
17
注: サービスが複数回有効または無効にされた場合、PCA はフェイルオーバー・ア
クティブ状態を正しく示さないことがあります。これは、すべての PCA ビルドに
影響する既知の問題です。
Web コンソールを通じたフェイルオーバーの再開
フェイルオーバー・サービスは、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. フェイルオーバーしたサービスを開始するには、以下のようにします。
tealeaf start failoverd
フェイルオーバー状態の判別
以下のセクションを使用して、PCA フェイルオーバーの問題を判別するのに役立て
ます。
マスター PCA 統計
以下で、各種フェイルオーバー状態のマスター・フェイルオーバー・サーバーにつ
いて PCA によって公開される統計を確認できます。これらの統計は、「統計」タ
ブのフェイルオーバー・セクションで公開されます。
18
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
v 「ノードの状態 (Node state)」統計が「アクティブ」に設定されている場合、サ
ーバーはヒットを他の Tealeaf サーバーに配信しています。
v 「IBM Tealeaf Passive Capture Application マニュアル」の『PCA Web コンソー
ル -「統計」タブ』を参照してください。
ノードの状態がアクティブであり、ヒットを配信していることを意味します。この
場合、以下のようになります。
値
統計
master ノードの役割
active ノードの状態
running
キャプチャー状態
yes
フェイルオーバー・アクティブ (Failover active)
マスターがスレーブに強制的にフェイルオーバーされました。マスターは停止され
ました。この場合、以下のようになります。
値
統計
master ノードの役割
passive
ノードの状態
stopped
キャプチャー状態
yes
フェイルオーバー・アクティブ (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 enabled.
フェイルオーバー・サービスが PCA スレーブ・マシンにフォールオーバーした場
合、以下のようになります。
第 1 章データの保存と再作成
19
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 によって公開される統計を確認できます。これらの統計は、「統計」タ
ブのフェイルオーバー・セクションで公開されます。
v 「ノードの状態 (Node state)」統計が「アクティブ」に設定されている場合、サ
ーバーはヒットを他の Tealeaf サーバーに配信しています。
v 「IBM Tealeaf Passive Capture Application マニュアル」の『PCA Web コンソー
ル -「統計」タブ』を参照してください。
マスターがアクティブ・ノード状態で実行中です。スレーブはパッシブ状態 (非配
信) です。この場合、以下のようになります。
値
統計
slave
ノードの役割
passive
ノードの状態
running
キャプチャー状態
yes
フェイルオーバー・アクティブ (Failover active)
スレーブ PCA は実行中で、マスター PCA は停止されているか存在しません (スレ
ーブ PCA にフェイルオーバーしました)。この場合、以下のようになります。
値
統計
slave
ノードの役割
active ノードの状態
running
キャプチャー状態
yes
フェイルオーバー・アクティブ (Failover active)
スレーブがマスターにフェイルバックしたときに、ノード状態は再びパッシブに戻
ります。
「IBM Tealeaf Passive Capture Application マニュアル」の『PCA Web コンソール
-「統計」タブ』を参照してください。
20
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
スレーブ 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.
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 を使用してデフォルトのシステム・レベル設
定が定義されます。PCA の異常終了の発生時に、PCA はこのユーティリティーを
使用して、アクティビティーをトラブルシューティングするためにコア・ファイル
を提供します。セキュリティー、インストール済みの Linux OS で使用されている
システム・ポリシー、およびプラットフォームとバージョンの依存関係に応じて、
非 root ユーザーの PCA の観点からは、ulimit が期待どおりに機能しないことがあ
ります。
以下により、非 root ユーザーとして実行されているときのデフォルト設定を確認で
きます。
su ctccap
ulimit -c
第 1 章データの保存と再作成
21
確認する必要がある行は、以下のものです。
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. ログ・ファイルを確認して、問題が解決されたことを確認します。
NIC の追加後に 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).
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
22
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
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
Symptom:
ErrorSystem.Web.HttpRequestValidationException: A potentially dangerous
Request.Cookies value was detected from the client (ErrorId=
Resolution:
IIS Manager で、TeaLeaf IIS キャプチャー・フィルターが、特定の Web サイトで
はなくグローバル Web サイト・レベルでインストールされていることを確認しま
す。
PSIO_SIGCAUGHT エラーの意味
PSIO_SIGCAUGHT エラーが表示された場合は常に、本当の原因について、キャプチャ
ー・ログ・ファイル内の前の部分を調べる必要があります。この PSIO_SIGCAUGHT
エラーは、pipelined が delivered と通信しようとしたが、その通信がシグナルによ
って中断したことによるものです。
ほとんどの場合、このシグナルは、captured が pipelined にシャットダウンするよう
に指示したことによるものです。captured は、以下のようなさまざまな理由で
pipelined にシャットダウンするように指示します。
v captured の別の子プロセスが異常終了したか終了した。
v captured がシャットダウンする。
第 1 章データの保存と再作成
23
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 メッセージが変更されました。
messages ディレクトリーが、「crond(pam_unix) セッションはユーザ
ー・ルートについてクローズされています (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]:
Sep 6 16:24:01 ganymede crond(pam_unix)[23971]:
by (uid=0)
Sep 6 16:24:03 ganymede crond(pam_unix)[23971]:
Sep 6 16:25:01 ganymede crond(pam_unix)[24020]:
by (uid=0)
Sep 6 16:25:02 ganymede crond(pam_unix)[24020]:
session closed for user root
session opened for user root
session closed for user root
session opened for user root
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
24
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
この同じ /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 つの解決方
法があります。
解決方法 1: メッセージの抑止
セッション・スタックに pam_unix を入れる唯一の目的は、このレベルのロギング
を提供することです。このロギングを抑止するには、システム認証セッション・ス
タックで開始される pam モジュールは、pam_unix と pam_limits のみであるた
め、/etc/pam.d/crond でシステム認証セッション・スタッキングを開始する行をコ
メント化し、セッション 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
解決方法 2: 異なるログ・ファイルへのメッセージのリダイレクト
1. 以下のように /etc/syslog.conf を編集します。
第 1 章データの保存と再作成
25
# 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 にのみ表示されます。
Siebel アプリケーション用の IIS 6 キャプチャー・フィルターで正しくキ
ャプチャーされない
IBM Tealeaf CX RealiTea Viewer によって表示されるエラーは、「Invalid Deflate
Data」です。
Siebel ISAPI フィルターが圧縮を実行しています。IIS キャプチャー・フィルターが
この圧縮を処理するようにするには、Tealeaf IIS キャプチャー・フィルターがイン
ストールされているすべての Siebel Web サーバー上の TeaLeafIIS6.cfg ファイル
の [Globals] セクションに以下の 2 行を追加します。
IgnoreChunked=False
IgnoreGZip=False
この変更を行った後に、当該 Web サーバーで IIS を再始動する必要があります。
カスタマー・サポートに提供する情報
IBM Tealeaf CX Passive Capture Application またはそのホスト・サーバーでの問題
が解決しない場合、Tealeaf カスタマー・サポートに問い合わせる前に、以下の情報
を見つけて確認する必要があります。
v 実行されている PCA のバージョンは何ですか?
v listen 対象はどのような NIC ですか?
v 問題が新規インストールまたはアップグレードの一部として発生しましたか? こ
れがアップグレード時に発生した場合、同じ問題がアップグレード前にも発生し
ましたか?
v tcpdump を実行します。メモリー・ダンプで何かでフィルターに掛けましたか、
それとも、NIC を listen しただけですか?
v Tealeaf PCA への root 権限または root 権限を備えたユーザーを提供します。
追加 tcpdump コマンド
拡張 tcpdump の詳細
tcpdump の拡張詳細を取得するには、PCA サーバーで man tcpdump を実行する
か、http://www.tcpdump.org/ Web サイトから取得します。簡易形式は、以下のとお
りです。
26
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
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 オプションおよびその引数を削除します。その場
合、出力はコンソールに表示されます。
キャプチャー・スニファー・ポートでのトラフィックのテスト
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:
第 1 章データの保存と再作成
27
ポートのフィルタリング
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
両方のタイプのトラフィックを表示するには、以下のようにします。
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
ここで、
28
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
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 パケットに関する、選択した情報
上記の例は、クライアントからサーバーへの初期 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 ポータルから使用
可能な機能が決定されます。
注: Tealeaf カスタマー・サポートにサブミットするためにライセンス・キーを取得
し、それを変更する必要がない場合は、「ポータル」メニューで「ヘルプ」 >
「IBM Tealeaf CX Portal について」を選択します。ライセンス・キーの隣にある
値をコピーします。詳しくは、Tealeaf http://suppor.tealeaf.com を参照してくださ
い。
TMS を使用してライセンス・キーを適用する方法について詳しくは、「IBM
Tealeaf cxImpact 管理マニュアル」の『Tealeaf ライセンス・キーの管理』を参照し
てください。
第 1 章データの保存と再作成
29
Windows レジストリーでのライセンス・キーの適用
ポータルおよび TMS が使用可能でない場合、Windows レジストリーで Tealeaf 製
品ライセンス・キーを適用できます。
Windows レジストリーでライセンス・キーを適用する方法について詳しくは、
「IBM Tealeaf cxImpact 管理マニュアル」の『Tealeaf ライセンス・キーの管理』を
参照してください。
デフォルト IIS 権限
Tealeaf のインストールまたはアップグレード時に、IIS に必要な権限は自動的に構
成されます。企業の理由で権限を変更した場合は、ポータル機能が損なわれる可能
性があります。動作はさまざまです。
ポータル・アプリケーションまたはポータル API で使用する IIS 権限が以下のセ
ットから変更されていると思われる場合は、TLIISUtility を再実行します。
TLIISUtility を実行するには、以下のようにします。
注: このユーティリティーを再実行すると、必要なフォルダーの権限が上記の設定
に変更されます。それ以外に、再実行はポータルに影響しません。
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 の日付が表示される
恐らく、キャプチャーされて処理されたヒットのタイム・スタンプのいずれかに 0
が含まれていました。0 のタイム・スタンプは、1/1/1970 に該当します。このヒッ
トがイベントをトリガーした場合、イベントのタイム・スタンプも 1/1/1970 になり
ます。
NT 認証済みユーザーがポータルにログインできない
場合によっては、NT 資格情報を使用してポータルにアクセスしようとしている
Tealeaf ユーザーがログインできないことがあります。
30
IBM Tealeaf CX: 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’]
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 章データの保存と再作成
31
修正するには、次のようにします。
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)
ポータルでの合計セッション数のカウントとアーカイブされたセッション数
のカウントの差
ポータルの「アクティビティーの合計」レポートで、左上のセッション・カウント
が、右下のアーカイブされたセッション・カウントに一致していないことがありま
す。環境によって、いずれかのカウントが多くなることがあります。
合計セッション数のカウントは、新規 Web サイト・セッションが開始されるたび
に増分されます。アーカイブされたセッション数のカウントは、セッションが保存
用にマークされると増分されます。この定義の違いにより、カウントの差が生じる
ことがあります。
午前 0 時頃には、一部のアクティブ・セッションがまだ長期キャニスターに保存さ
れていないため、合計セッション数がアーカイブされたセッション数よりも多くな
ることがあります。
同様に、ある日に、午前 0 時より前に開始され、午前 0 時より後に終了して保存
されたセッションのバーストがあった場合、合計セッション数よりもアーカイブさ
れたセッション数が多くなることがあります。
Internet Explorer での表示の問題
Windows Server 2003 および Windows Server 2008 では、デフォルトで、Internet
Explorer でセキュリティー強化機能が有効になります。IE でセキュリティー強化が
有効になっている場合、以下の問題の一部またはすべてが発生する可能性がありま
す。
1. Tealeaf ポータル:
v ポータル・メニューが表示されない。
v JavaScript エラー「getElementByID is null or not an object」
32
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
2. PCA:
v Web コンソールでボタンのクリックが機能しない。
3. RTV:
v 不明な影響
Internet Explorer で表示の問題が発生している場合、セキュリティー強化機能を無効
にするか、Tealeaf コンポーネントを信頼済みサイトとして追加することができま
す。
信頼済みサイトとしての Tealeaf コンポーネントの登録
パフォーマンスを改善するために、Internet Explorer で信頼済みサイトとして
Tealeaf コンポーネントの URL を登録できます。
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 セキュリティ強化の構成」を削除します。
1. Windows の「スタート」メニューから、「設定」>「コントロールパネル」>
「プログラムの追加と削除」を選択します。
2. 「Windows コンポーネントの追加と削除」をクリックします。
3. 「Internet Explorer セキュリティ強化の構成」を選択してオフにします。
第 1 章データの保存と再作成
33
4. 「次へ」をクリックします。
5. これで、コンポーネントが削除されます。
Windows Server 2008 用の無効化
以下のステップでは、Windows Server 2008 内で「Internet Explorer セキュリティー
強化の構成」を無効にします。
1. Windows の「スタート」メニューから、「設定」 > 「コントロールパネル」
> 「管理ツール」 > 「サーバーマネージャー」を選択します。
2. 以下のように、「サーバーマネージャー」が表示されます。
34
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
Windows サーバーマネージャー
3. 「IE ESC の構成」リンクをクリックします。
第 1 章データの保存と再作成
35
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 更新が実行されている。
36
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
管理グループに対するすべてのメニューへのアクセスの有効化
必要な場合は、以下の SQL を使用して、管理ユーザー・グループに対して 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 の「詳
細設定」タブの「マルチメディア」で以下の 2 つの項目が選択されていることを確
認します。
v 自動的にイメージのサイズを変更する
v Web ページのアニメーションを再生する
ポータルの時刻が数時間ずれている
デフォルト・ポータル・タイム・ゾーンは GMT ベースであり、ご使用の Tealeaf
実装で期待されるものとは異なることがあります。
タイム・ゾーンを設定するステップは、以下のとおりです。
1. ポータルにポータル管理者としてログインします。
2. 「Tealeaf」 > 「ポータル管理」を選択します。
3. 管理するアカウントのタイプを選択します。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『CX ユーザー管理』を参照して
ください。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『cxView ユーザー管理』を参照
してください。
第 1 章データの保存と再作成
37
v 「IBM Tealeaf cxReveal ユーザー管理マニュアル」の『cxReveal ユーザー管
理』を参照してください。
4. 時刻の違いが発生しているユーザーを選択します。
5. 「タイム・ゾーン」ドロップダウンから、ユーザーの正しいタイム・ゾーンを選
択します。
6. 変更を完了するには、「保存」をクリックします。
7. 時刻の変更が結果として適用されたことを確認するために、「アクティブ」 >
「セッション」を選択し、アクティブ・セッションのタイム・スタンプを確認し
ます。
ポータルが検索サーバーに接続できない
ポータルで IP アドレスまたは完全修飾ドメイン・ネームで宛先サーバーを指定し
ても、ポータルが検索サーバーと通信できない場合は、ログ・レベルを 9 に設定し
て問題をデバッグする必要があります。
v リリース 7.2 より前: 「スタート」 > 「プログラム」 > 「TeaLeaf
Technology」 > 「TeaLeaf RealiTea レポート・サーバー (TeaLeaf RealiTea
Report Server)」 > 「RealiTea レポート・サーバー構成 (RealiTea Report
Server Configuration)」を選択して、TeaLeaf ReportConfig.exe ユーティリティ
ーを開き、変更を行います。
1. 次に、World Wide Web Publishing Service を再始動します。
v リリース 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 が、ポータルで指定されているも
のとは異なるプロキシー設定セットを継承している可能性があります。この問題を
修正するには、これらの設定を継承しないようにポータルを構成する必要がありま
す。
注: この変更が企業の要件に違反していないことを確認してください。
解決方法としては、以下の XML をポータルの Web.Config ファイルに追加しま
す。
<system.net>
<defaultProxy>
<proxy usesystemdefault="false"/>
</defaultProxy>
</system.net>
Web.Config ファイルは、以下のロケーションに保管されます。
38
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
<Tealeaf_install_directory>¥Portal¥WebApp
注: 問題の修正後に、必ず、ログ・レベルを前の値にリセットしてください。
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 章データの保存と再作成
39
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 以前のシステムにのみ適用されます。
誤った日付のレコードをレポート・データベースから削除するには、以下のよう
に、イベントの固有 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’
40
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
グラフの作成時にイベントの説明が見つからない
注: この解決方法は、Tealeaf のリリース 4.x 以前のバージョンに適用されます。
イベントのポータルのグラフを、イベント・エディターで作成した直後に作成しよ
うとすると、以下のメッセージを受け取ることがあります。
Event Description Not Found
グラフを作成するには、5 分から 30 分待機する必要が生じることがあります。待
機する必要がある時間の長さは、レポート・データ収集プログラム・サービスのデ
ータ収集時間によって異なります。
v システムがビジーである場合、処理サーバーからデータを収集するためにかかる
時間の長さが原因で、レポート・データ収集プログラムが新規サイクルを開始す
るのに、デフォルトの間隔の 5 分より長い時間がかかります。
v 正しくサイズ変更されたシステムでは、新規イベントの説明を表示するのに、5
分から 10 分より長い遅延は生じません。
新規に定義したイベントのイベントの説明が存在するようになる前にグラフを調べ
た場合、次のデータ収集実行が完了してイベントの説明が取得されるまで、グラフ
にデータは表示されません。
ポータル・ホーム・ページの一般エラー
注: この解決方法は、Tealeaf のリリース 4.x 以前のバージョンに適用されます。
ポータル・ホーム・ページで以下のエラー・メッセージが出されることがありま
す。
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 構成マニュアル」の『レポート・サーバーの構成』を参
照してください。
問題を診断できない場合は、以下を実行し、情報を確認します。
第 1 章データの保存と再作成
41
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
TLAspUtil.dll と TLPrivacy.dll の両方に、IUSR <ポータル・サーバー名> ユー
ザーまたは関連する Windows NT/Active Directory グループ (NT 認証統合機能を使
用している場合) に対する読み取り権限および読み取りと実行権限が設定されてい
ることを確認します。
エラー - 593-Non ADMIN user blocked from logon
注: この解決方法は、Tealeaf のリリース 4.x 以前のバージョンに適用されます。
このエラーは、TLTMaint.exe がデータ検証またはリカバリーのためにキャニスター
をロックした場合に発生します。
このエラーをクリアするには、以下のようにします。
1. 「開始」メニューのショートカットを使用して、すべての Tealeaf サービスを停
止します。トランスポート・サービスは実行したままでも構いません。
2. 「コマンドプロンプト」ウィンドウを使用して、Tealeaf インストール・ディレ
クトリーにナビゲートします。
3. コマンド・ラインで次のコマンドを入力します。
TLTMaint -NoServer
4. TLTMaint の実行が完了するまで待機します。Windows イベント・ログにリカバ
リー不能エラーがレポートされた場合は、http://support.tealeaf.com/ にお問い合わ
せください。
5. TLTMaint の完了後に、「開始」メニューから「Tealeaf サービスの開始 (Start
Tealeaf Services)」ショートカットを使用します。
6. サービスの再始動後に、ポータル・ログインが正しく機能していることを確認し
ます。
42
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
どのユーザー ID を使用してもポータルにログインできない
注: この解決方法は、Tealeaf のリリース 4.x 以前のバージョンに適用されます。
ポータルにログインしようとすると、次のエラー・メッセージが表示されます。
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)」
ショートカットを選択します。
ポータルのライブ・セッション・ページで 500 エラーが出される
注: この解決方法は、Tealeaf のリリース 4.x 以前のバージョンに適用されます。
...¥TeaLeaf¥Portal¥Web Application¥temp chart ディレクトリーは、NT 認証を
使用していない場合、TeaLeaf Active Directory ユーザー・グループまたはポータ
ル・マシンの IUSR * ユーザーによって書き込み可能でなければなりません。
IIS エラー・メッセージ
このセクションでは、IIS によって生成される、一般的なエラー・メッセージについ
て説明します。
v IIS ステータス・コードについて詳しくは、http://support.microsoft.com/kb/
318380 を参照してください。
エラー・メッセージ: 「アプリケーションプール
'DefaultAppPool' の ID が無効です。」
名前付きアカウントを使用している場合、以下の情報を確認します。
v 「ユーザーはパスワードを変更できない」を true に設定します。パスワードを
有効期限なしに設定しても、効果がないように思われます。
v ユーザーは IIS_WPG のメンバーです。
– http://geekswithblogs.net/EltonStoneman/archive/2008/05/26/theidentity-of-application-pool-esbapppool-is-invalid.aspx
– http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/
Library/IIS/f05a7c2b-36b0-4b6e-ac7c-662700081f25.mspx?mfr=true
エラー・メッセージ: 「App-Domain が作成されなかったため、
要求を実行できませんでした。エラー: 0x80004005 未定義のエラ
ー」
AppDomain の ID に適切な権限が設定されていません。デフォルトについて IIS 権
限の資料を確認してください。
第 1 章データの保存と再作成
43
エラー・メッセージ:「ディレクトリの変更の監視を開始できませ
んでした」エラー・メッセージ
IIS/ASP.NET のディレクトリー権限に問題がある可能性があります。詳しくは、
http://support.microsoft.com/kb/317955を参照してください。
エラー・メッセージ: 「現在の ID (NT AUTHORITY¥NETWORK
SERVICE) は C:¥WINDOWS¥Microsoft.NET¥Framework¥
v2.0.50727¥Temporary ASP.NET ファイルへの書き込みアクセス
権がありません」
以下を実行します。
1. コマンド・シェルを開き (「スタート」 > 「ファイル名を指定して実行」 >
「cmd」)、ご使用の OS ビルドによって、50727 が含まれた以下のいずれかの
ディレクトリーにナビゲートします。
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 はドメインコントローラー上の
ASPNET アカウントでは動作しません」
構成ファイルの processModel セクションで指定されているユーザー名/パスワード
が無効であるため、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 「サーバーの構成によりログオンに失
敗しました」
「ディレクトリセキュリティ」>「認証とアクセス制御」ウィンドウで有効になっ
ている認証方式がありませんでした。
44
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
共通 IIS 404 問題
http://support.microsoft.com/kb/248033/en-usを参照してください。
301 ステータス・コード
以下を再実行します。
aspnet_regiis -i
Windows/System32/LogFiles/W3SVC の中にログ・エントリーが
ない
IIS は失敗しました。必要なユーザー・アカウント権限を確認します。権限の問題が
見つからない場合は、IIS を再インストールします。
サービス利用不可メッセージ
Network Service ユーザーのアプリケーション・プール権限の問題が発生している
可能性があります。詳しくは、http://support.microsoft.com/?kbid=842493を参照
してください。
一部の NT ユーザーがポータルへのアクセス時に 400 - 要求の長
さのエラー・メッセージを受け取るが、受け取らないユーザーもい
る
ユーザーがあまりにも多くの 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/kerberosauthentication-problem-with-active-directory.aspx を参照してください。
ログインしようとしても Default.aspx から離れられない
Cookie の問題の可能性があります。
v SimpleTest.aspx を実行して、Cookie が機能していることを確認します。
第 1 章データの保存と再作成
45
v Cookie が機能している場合、クライアント・マシン上の日付が正しいことを確認
します。
– 日付があまりにもずれている場合、ポータルの Cookie の有効期限が既に切れ
ていると判断されていて、結果としてユーザーが「ログイン」ページ上に留ま
っている可能性があります。
セッションが 29 時間 (1740 分、つまり 1 日と 5 時間) で存続
しなくなる
ポータルのアプリケーション・プールの「リサイクル設定 (Recycling settings)」タブ
で「ワーカー処理をリサイクルする (分) (Recycle worker processing (in
minutes))」設定を無効にします。
エラー・メッセージ: 「NT ログイン/DB ログインと新しいユーザ
ーのダイアログがすべて Default.aspx ページに表示されます」
ASP.NET は適切に機能していません。
次のコマンドを再実行します。
aspnet_regiis -i
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 が選択されていることを確認します。
46
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
– ASP.NET タブが存在しない場合は、aspnet_regiis に当該仮想ディレクト
リーを手動で登録する必要が生じることがあります。
BBRFilter.dll の開始中のエラー
Microsoft Visual C++ 2005 再頒布可能パッケージ (x86) が欠落しているか、破損し
ています。詳しくは、http://www.microsoft.com/downloads/
details.aspx?familyid=32bc1bee-a3f9-4c13-9c99-220b62a191ee&displaylang=enを
参照してください。
ロケール・エラー
ポータルのロケール指定に以下を記述します。
<system.web>
<globalization fileEncoding="utf-8" requestEncoding="utf-8"
responseEncoding="utf-8" culture="en-US" uiCulture="en-US" />
</system.web>
「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>
第 1 章データの保存と再作成
47
IIS7 を使用していて 401.2 が表示される
401.2 エラーが表示されている場合、匿名認証とフォーム認証が有効になっているこ
とを確認します。匿名のアカウントが IUSR であるか、または適切な権限を備えた
他のアカウントであることを確認します。
役に立つ他の Microsoft 知識ベースの記事
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
詳細:
48
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
[InvalidOperationException: 一時クラスを生成できません (result=1)。
エラー CS2001: ソースファイル 'D:¥WINDOWS¥TEMP¥d0lurtzx.0.cs' が見つかりま
せんでした。
エラー 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 サーバーの管理』を
参照してください。
第 1 章データの保存と再作成
49
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 構成マニュアル」の『検索サーバーの構成』を参照してくださ
い。
50
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
検索パフォーマンス問題の診断
長い検索時間、検索タイムアウト、または検索時間の増大が発生している場合、以
下のテストを試行して、検索を加速できるかどうかを確認する必要があります。
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. このビューは、特定のページを見つけるために応答で検索できる単語を示しま
す。
要求では、デフォルトで特定の項目が含まれます。「IBM Tealeaf CX 構成マニュア
ル」の『CX インデックス付けの構成』を参照してください。
第 1 章データの保存と再作成
51
検索に単語 NOT を含めることができない
Tealeaf は、以下の 2 つの異なる検索エンジンを使用します。
v dtSearch インデクサーは、より強力なものであり、RTV またはポータルで完了
したセッションを検索する際に呼び出されます。
v ストリング比較機能は、単純なストリング比較検索機能であり、アクティブ・セ
ッションの検索時に呼び出されます。
dtSearch インデックス付けエンジンで、単語 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 管理マニュアル」の『キャラクターのインデックス付
け』を参照してください。
セッション・フラグメントが検索結果に影響する理由
セッションは、複数の条件下でフラグメント化することがあります。フラグメント
化は、検索および一部のイベント・トリガーに影響します。
例えば、ビジネス・プロセスの Web ページが、「アイテムの追加」、「チェック
アウトの開始」、および「チェックアウトの完了」の各イベントで構成されている
52
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
ものとします。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 サーバーの管
理』を参照してください。
v BBR でのフラグメント化の管理について詳しくは、「IBM Tealeaf cxImpact ユー
ザー・マニュアル」の『BBR のオプション』を参照してください。
第 1 章データの保存と再作成
53
ポータルとビューアー (またはデータ抽出/cxConnect) でレポートされるセ
ッション・カウントの差
アーカイブには、セッションがタイムアウトになるまで評価できないセッション・
レベルの複合イベントが含まれている必要があるため、セッションは、最後のヒッ
トのタイム・スタンプに従って、長期キャニスターに保管されます。セッションの
最後のヒットのタイム・スタンプは、これらのイベントおよびセッションのセッシ
ョン時間属性に適用されます。
ビューアーのアーカイブ検索とデータ抽出/IBM TealeafcxConnect for Data Analysis
検索ではともに、インデックスを使用し、日時フィルターがセッションの最後のタ
イム・スタンプに対して突き合わされます。ポータルのアクティビティーの合計レ
ポートでレポートされる 1 日のセッション数と、ビューアーまたはデータ抽出ツー
ルによって返される 1 日のセッション数には、少しの差が生じることがあります。
構成
構成について詳しくは、以下を参照してください。
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 「パフォーマンスオブジェクト」ドロップダウンで「物理ディスク」を選択しま
す。
v 右端のラジオ・ボタン・セットで「すべてのインスタンス」を選択します。
v ラジオ・ボタンの左のペアで「一覧からカウンタを選ぶ」を選択します。
v リスト・ボックスから以下の 3 つのカウンターを複数選択します。
– 平均ディスク・キュー長
– 平均ディスク読み取りキュー長
– 平均ディスク書き込みキュー長
v 「追加」をクリックします。
54
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
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
54 ページの『ディスクの入出力が制限されているかどうかの判別方法』で説明さ
れている方法で、Windows PerfMon ユーティリティーを実行します。
1. Tealeaf インデックス・ディレクトリーが存在するディスクの平均ディスク・
キュー長を確認します。通常、この値が 1 より大きい場合、ディスクは入出
力要求に対応できません。
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 部門と話し合
ってください。
第 1 章データの保存と再作成
55
検索サーバーのウォッチドッグ・タイムアウト設定の編集
ディスク・ハードウェア・パフォーマンスを改善できない場合は、以下のように、
検索サーバーのウォッチドッグ・タイムアウト設定を変更します。
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 パイプライ
ンからの警告メッセージが含まれていることがあります。
SADecoupleEx (TeaLeafCSS_1966): Canister spacer file does not exist
(C:¥Program Files (x86)¥TeaLeaf¥Canister¥Canister.spacer).
キャニスター・スペース・ファイルは、キャニスター内でのセッションの保管用に
ディスク・スペースを予約するために使用されます。上記のメッセージは、このフ
ァイルが存在しないことを示しています。これがない場合、キャニスターは、ディ
スク・スペースが少なくなっているときに、処理したセッションを保存できませ
ん。
拡張デカプラー・セッション・エージェントは通常、このスペーサー・ファイルと
対話しません。ただし、低ディスク・スペース状態が検出されると、このセッショ
56
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
ン・エージェントはそれを削除してディスク・スペースを解放します。このメッセ
ージが表示された場合、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 パイプラインからの別のメッセージで、キ
ャニスターへのヒットのフローが再開されたことが示されます。
Tealeaf が配置されて数週間経つと、LTC が大きくなっているため、TLTMaint プロ
グラムの完了にかかる時間が長くなります。そのため、この警告メッセージは、初
期インストール後に数週間は表示されないが、その後はイベント・ログの標準的な
項目になることがあります。
イベント・ログにこの警告が表示され、それが始動シーケンスの一部でない場合
は、http://support.tealeaf.com/ でサポート・ケースを入力してください。
第 1 章データの保存と再作成
57
TeaLeaf Technology Error: Data length (xxxxxx) exceeds maximum
size (yyyyyyy). Body discarded
以下のエラーを受け取る場合があります。
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 で WriteInteraction にコード -160 で失敗した
このエラーが繰り返し頻繁に発生した場合、セッション・タイムアウトを 1 分増や
すことができます。
v セッション・タイムアウトは、トリガーされたイベントによって変更することも
できます。「IBM Tealeaf イベント・マネージャー・マニュアル」の『TEM の
「イベント」タブ』を参照してください。
このエラーの最も可能性が高い原因は、セッション内の次のヒットがちょうど追加
されたときに、セッションがタイムアウトになった場合です。結果として、セッシ
ョンがフラグメント化し、ヒットが新規に作成されたセッション内に配置されま
す。
FetchNSAT で WriteInteraction にコード -127 で失敗した
通常、システムは現在、サイクル・サービスまたは CanTrim 操作を実行していま
す。
v ヒットがパイプライン内にあるときに (これはめったに発生しません) Tealeaf キ
ャニスター・サーバー・サービスで障害が発生した場合、ヒットがドロップされ
てこのメッセージが出されることがあります。
v キャニスター・サービスの再始動時にのみこのメッセージが発生している場合
は、無視できます。
58
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
構成
「IBM Tealeaf CX 構成マニュアル」の『トランスポート・サービスの構成』を参照
してください。
サイクル・サービスについて詳しくは、「IBM Tealeaf CX インストール・マニュア
ル」の『CX システムの管理』を参照してください。
第 1 章データの保存と再作成
59
60
IBM Tealeaf CX: 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 に接続できない
Tealeaf が SQL Server データベースに接続できない場合は、以下のステップを試行
します。
1. SQL Server カスタム・ポート
v デフォルトでは、SQL Server はポート 1433 を listen します。このポート
は、インストール時に別の選択を行わない限り、Tealeaf のデフォルト通信ポ
ートでもあります。SQL Server 構成マネージャーを使用して、この値を確認
できます。
2. 動的ポートで接続できない
v SQL Server 実装で動的ポートが使用されている場合、Tealeaf ソリューション
をその動的ポートに同期する必要があります。 62 ページの『SQL Server 動的
ポートの使用の構成』を参照してください。
3. SQL ネットワーク・プロトコル
v デフォルトでは、SQL Server では、Tealeaf で使用される TCP および名前付
きパイプは有効になっていません。SQL 構成マネージャーを使用して、これ
らのプロトコルが有効になっていることを確認します。
© Copyright IBM Corp. 1999, 2014
61
モデル・データベース・サイズの不一致が原因でインストールに失
敗する
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 データベース・マネージャー・リファレンス』を参照
してください。
5. Tealeaf データベース・マネージャーで、データベースのポートを設定できま
す。
62
IBM Tealeaf CX: 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 データベースのトラブルシューティング
63
上記の問題の原因は、すべての Tealeaf データベース名を RL_REPORT.mdf に変換す
る SQL Server 復元プロシージャーです。この状態は通常、新規ロケーションのデ
ィレクトリー構造が異なる場合、またはデータベースを新規バージョンの SQL
Server に移動した場合に生じます。
解決方法としては、各データ・ファイルのファイル名を手動で追加して、ファイル
名の末尾にファイルのファイル・グループ ID を含めます。
データベースを復元するための該当するステップについて詳しくは、「IBM Tealeaf
CX データベース・ガイド」の『Tealeaf データベースのマイグレーション』を参照
してください。
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
サービスの始動アカウントであるユーザー・アカウントに「メモリー内のページ
のロック」ユーザー権限を割り当てることで、メモリーをロックできます。
v このステップでは、オペレーティング・システムがメモリーをページアウトし
ないようにし、代わりに SQL Server がページングを実行できるようにしま
す。詳しくは、http://technet.microsoft.com/en-us/library/ms190730.aspx
を参照してください。
3. SQL Server を再始動します。
64
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
トラブルシューティング・ステップなど、このトピックについて詳しくは、
http://support.microsoft.com/kb/918483 にアクセスしてください。
SuperSocket 情報: (SpnRegister): Windows アプリケーショ
ン・イベント・ログ内のエラー 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 イベン
ト・ログで表示されません。
このエラー・メッセージは安全です。ただし、混乱を避けるため、このストアー
ド・プロシージャーを使用する pr_ServerDiskSpace へのアクセスを拒否すること
ができます。アクセスを拒否した場合、pr_ServerDiskSpace
(sys.sp_OAGetProperty ではない) からエラー・メッセージがレポートされます。後
者のプロシージャーからのエラー・メッセージは、ハッキングや悪意のあるソフト
ウェアを示している可能性があるため、不要なメッセージは抑止する必要がありま
す。
アクセスを拒否するには、SQL Server Management Studio から以下を実行します。
第 2 章 Tealeaf データベースのトラブルシューティング
65
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 データベースにアクセスできない場合は、適切な完全修飾ホスト名を使用し
ていることを確認する必要があります。
名前付きデータベース・インスタンスに対して実行している場合は、ホスト名は以
下の特定の形式に従っている必要があります。
<host_name>¥<instance_name>
ここで、
<host_name> は、IP アドレス、マシン名または localhost です。
<instance_name> は、DB インスタンスの名前です。
「IBM Tealeaf CX データベース・ガイド」の『Tealeaf データベース・マネージャ
ーの使用』を参照してください。
アップグレード時に Tealeaf データベース・マネージャーで結果
セット抽出のアップグレードに失敗する
必要なビューが存在していません。RSE データベースを再作成する必要がありま
す。 69 ページの『結果セット抽出データベースで結果セットの分析に失敗する』を
参照してください。
クラスター化サーバー環境でデータベースの作成に失敗する
クラスター化サーバー環境へのインストール中に、作成時にエラー・メッセージが
表示される場合は、クラスター・グループまたは依存関係リストの一部ではないデ
ィスクへ SQL パスを誤って指定した可能性があります。
クラスター依存問題を解決するには、http://support.microsoft.com/kb/295732を参照し
てください。
Tealeaf データベース・マネージャーで、データベース・ファイルが保管されている
パスを確認する必要もあります。リモート・サーバーへのパスが分からない場合
は、担当者にお問い合わせください。
注: パスは、SQL Server を基準とした絶対パスでなければなりません。ネットワー
ク・パスは許可されません。
「IBM Tealeaf CX データベース・ガイド」の『Tealeaf データベース・マネージャ
ーの使用』を参照してください。
66
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
Tealeaf データベース・パフォーマンス
メモリーの割り振り
次のいずれかの状態が発生している場合は、その下に記述されている解決策を実行
します。
1. Tealeaf の実行速度が遅い
2. レポートの到着が遅延している
3. SQL Server を実行しているボックスでページングまたはディスク入出力の問題
が発生している
SQL Server に割り振られているメモリーの設定が低すぎる可能性があります。SQL
Server Management Studio で Tealeaf データベースに割り振られているメモリー量
を確認および変更できます。
フラグメント化
通常のデータ操作により、ハード・ディスク・メディアおよび保管されている
Tealeaf データベースがフラグメント化することがあります。時間の経過につれて、
ディスクのフラグメント化がパフォーマンスに大きく影響する可能性があります。
v 通常のサーバー保守の一環として、DBA は定期的に、ディスクのフラグメント化
チェックを実行し、ディスクのデフラグを実行する必要があります。
Tealeaf データベースのインデックスもフラグメント化することがあります。最適な
パフォーマンスを確保するために、定期的にこれらのデフラグを実行する必要があ
ります。
注: 一般的に、データベース・インデックスのフラグメント化は、20% 未満に保つ
必要があります。
v リリース 7.1 以前: Microsoft SQL Server 管理コンソールを使用して、フラグメ
ント化チェックおよびデフラグ・タスクを実行できます。詳細については、製品
に付属の資料を参照してください。
v リリース 7.2: Tealeaf データベース・マネージャーを使用して、データベース・
インデックスのフラグメント化ステータスを検査して、必要に応じてデフラグ・
タスクを実行できます。「IBM Tealeaf CX データベース・ガイド」の『Tealeaf
データベース・マネージャーの使用』を参照してください。
システム・データベースのアップグレード時に Tealeaf データベ
ース・マネージャーがハングする
システム・データベースのアップグレード時にシステムの他のコンポーネントが実
行中である場合、Tealeaf データベース・マネージャーがハングすることがありま
す。
この状態は複数の要因が原因で発生する可能性がありますが、多くの場合、その原
因は、レポート・サーバーの Windows パイプライン内にアクティブな統計ロガ
ー・セッション・エージェントが存在することです。このセッション・エージェン
トは、パイプライン内の統計情報を収集し、ポータル・ベースのレポートで使用す
るために統計データベースにサブミットするために使用されます。
第 2 章 Tealeaf データベースのトラブルシューティング
67
v 「IBM Tealeaf CX 構成マニュアル」の『統計ロガー・セッション・エージェン
ト』を参照してください。
アクティブなセッション・エージェントが統計データベースを開いたままにしてい
るため、Tealeaf データベース・マネージャーがそれを使用できなくなっていること
可能性があります。その場合、ハングが発生します。
考えられる解決方法
この問題を解決するために、以下のいずれかの解決方法を試すことができます。
1. データベース・マネージャーを開始する前に、トランスポート・サービスを停止
します。
注: トランスポート・サービスを停止するとすぐに、ヒットがドロップされ、デ
ータが失われます。
a. データベース・マネージャーを使用した後に、TMS を使用して必ずトランス
ポート・サービスを再始動してください。
v 「IBM Tealeaf CX 構成マニュアル」の『トランスポート・サービスの構成』
を参照してください。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『TMS の「全体ビュー」タブ』
を参照してください。
2. 処理パイプラインから統計ロガー・セッション・エージェントを削除するか、無
効にします。
注: Tealeaf では、オールインワン・システムでデータベース・マネージャーを
操作しているときには、統計ロガー・セッション・エージェントを無効にするこ
とをお勧めします。
a. セッション・エージェントをパイプラインから削除したら、データベース・
マネージャーを開始できます。
b. データベース・マネージャーを終了した後に、TMS を使用して必ずそれを再
び追加してください。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『TMS パイプライン・エディタ
ー』を参照してください。
3. 統計ロガー・セッション・エージェントがキャニスター内の専用子パイプライン
の一部である場合は、TMS を使用してパイプライン全体を無効にすることがで
きます。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『TMS パイプライン・エディタ
ー』を参照してください。
個別データベースでの問題
cxResults の訪問者データベース
注: 訪問者データベースは、IBM Tealeaf cxResults に適用されます。リリース 8.7
から、IBM Tealeaf cxResults は、新規にライセンス交付を受ける製品として使用で
きなくなっています。リリース 8.6 以前で IBM Tealeaf cxResults のライセンス交
68
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
付を受けたお客様は、リリース 8.7 以降でも引き続き製品を使用でき、またそのサ
ポートを受けることができます。詳しくは、Tealeaf カスタマー・サポートにお問
い合わせください。
訪問者データベースのデータ接続タイムアウト
訪問者データベースのデータ接続タイムアウト設定がありますが、大きなデフォル
ト値が設定されています。これを変更する必要はありません。
cxResults の結果セット抽出データベース
結果セット抽出データベースで結果セットの分析に失敗する
RSE データベースのアップグレードまたは再インストール時に、以下のエラー・メ
ッセージが出ることがあります。エラー・メッセージの後には、テーブル作成ステ
ートメントが続きます。
Failed to create the database views:
Invalid object name ’RSE_HITSTATISTICS’.
この場合、RSE データベースで一部のビューが欠落している可能性があります。こ
の場合、RSE データベースが空です。この問題を解決するには、以下のように、デ
ータベースを再作成する必要があります。
1. Tealeaf データベース・マネージャーを実行します。「IBM Tealeaf CX データベ
ース・ガイド」の『Tealeaf データベース・マネージャーの使用』を参照してく
ださい。
2. 「拡張モード」を選択します。
3. 「データベース・インストール (Database Install)」タブで「作成」をクリックし
ます。
4. 「データベース・タイプ (Database Type)」ペインで「RSE」をクリックしま
す。
5. 「実行」をクリックします。RSE データベースが再作成されます。
v 生成されたエラー・メッセージを確認および監視します。
6. 再インストールの完了後に、データベースをアップグレードできます。「IBM
Tealeaf CX データベース・ガイド」の『Tealeaf データベース・マネージャーの
使用』を参照してください。
cxReveal の検索データベース
cxReveal データベースのインストールで照合設定が強制される
IBM Tealeaf cxReveal 検索データベースをインストールしようとした場合、データ
ベース照合設定が以下に強制されることがあります。
SQL_Latin1_General_CP1_CI_AS
SQL Server の照合設定に関係なく、この設定が構成されます。これは、海外 (特に
ヨーロッパ) のユーザーの場合に問題になります。
解決方法としては、Tealeaf データベース・マネージャーを使用して、TL_SEARCH デ
ータベースをドロップして再インストールします。
第 2 章 Tealeaf データベースのトラブルシューティング
69
注: 開始する前に、システム・データベース (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 データベース・マネージャーを開始します。
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)」を選択し、当該オプ
ションが選択されるようにします。
構成の問題
データ収集
データ収集のパフォーマンスが低い
データ収集プロセスが大量のメモリーを消費している場合、または終了に失敗して
いる場合は、データ収集プログラムのバッチ・サイズ設定を調整する必要が生じる
70
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
ことがあります。この設定は、単一のバッチでデータ収集プログラム用に抽出また
はロードするレコードの最大数を定義します。デフォルト値は 2000 に設定されて
います。
注: この値を 5000 以上に変更しないでください。
「IBM Tealeaf cxImpact 管理マニュアル」の『CX 設定』を参照してください。
データ収集時間が長い
通常、データ収集は、5 分未満で実行されます。データ収集プロセスが 10 分を超
えている場合、データ・トリム間隔設定のサイズを大きくする必要があります。
デフォルト値は「1 - 毎時」です。これを大きい値に設定することで、このプロセ
スの実行の頻度が下がります。ただし、データベースのサイズの一時的なスパイク
が生じます。
「IBM Tealeaf cxImpact 管理マニュアル」の『CX 設定』を参照してください。
データベース接続タイムアウト
Tealeaf データベースで繰り返しタイムアウトが発生している場合は、データベース
接続タイムアウト設定を調整する必要が生じることがあります。デフォルトの接続
タイムアウトは 30 秒に設定されます。しばらくシステムが実行されていて、トラ
フィックが増加した場合、現在の設定でご使用のハードウェアがトラフィック・レ
ベルに対応できない可能性があります。
この値を現在の値の 2 倍に設定してみてください。再発する場合は、さらに 2 倍
してください。
注: 300 秒 (5 分) を超える接続タイムアウトを設定する必要がある場合は、ご使用
の環境にさらに問題がある可能性があります。
「IBM Tealeaf cxImpact 管理マニュアル」の『CX 設定』を参照してください。
複数のキャニスターからのデータ収集パフォーマンス
デフォルトでは、Tealeaf は 2 つのキャニスターから同時に収集できます。ご使用
の環境にさらにキャニスターがある場合は、「データ収集 - 同時最大数」設定のサ
イズを大きくすることができます。適切な設定は、ご使用のハードウェア環境によ
って異なります。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『CX 設定』を参照してください。
以下のいずれかに気付いた場合:
1. データ収集がスローダウンしている
2. データ収集プロセスでエラーがある
3. キャニスターがビジーである
その場合は、この設定を小さくしてみてください。
データベースが大きくなりすぎる
データベースのサイズがストレージの制限に近づいている場合、設定の調整を検討
できます。
第 2 章 Tealeaf データベースのトラブルシューティング
71
1. ページ・パフォーマンス・レポートを使用していない場合は、パス統計を収集す
る必要はありません。パス統計の収集を無効にすることで、かなりのデータベー
ス・スペースを節約できます。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『CX 設定』を参照してくださ
い。
2. SQL Server Management Studio で、各データベースのリカバリー・モデル設定
を確認します。リカバリー・モデルが「フル (Full)」に設定されている場合
は、データベースおよびそのログ・ファイルは大きくなる可能性があります。
「IBM Tealeaf CX データベース・ガイド」の『データベースのサイズ変更』を
参照してください。
エラー - 既存の接続がリモート・ホストによって強制的に閉じられた
ときどき、データ収集プログラムが以下のログ・メッセージを登録することがあり
ます。
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 構成マニュアル」の『スケ
ジューリング・サービスの構成』を参照してください。
72
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
断続的な検索サーバー接続エラーでエラー・コード 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 に以下の一般フォーマットのエラーが表示され
る場合があります。
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. ホット・フィックスを適用した後に、検索サーバーをホストしているサーバーを
リブートします。
第 2 章 Tealeaf データベースのトラブルシューティング
73
データベース・アップグレードのトラブルシューティング
データベースのアップグレード時における無効なファイル・グルー
プ指定エラー
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 リリースで改善さ
れていることがあります。
3. トラフィック・ロードはどれくらいですか? 1 日当たりのページ数はどれくらい
ですか? 1 ページ当たりのイベント数はどれくらいですか? 1 セッション当たり
のページ数はどれくらいですか?
4. ポータル全体が遅いのですか、それともポータルの特定の項目が遅いのですか?
74
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
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 でサポート・チケットをオープ
ンします。
キャニスター・パフォーマンスの調整
Tealeaf 短期キャニスター (STC) は、Web アプリケーションのアクティブ・セッシ
ョンからのセッション・データを処理するためのメモリー内データ・ストアです。
セッションの終了またはタイムアウト時に、データは短期キャニスターから長期キ
ャニスターに移動され、ディスク上に保管されます。
v Tealeaf キャニスターは、c-tree データベース・ソリューションに依存していま
す。詳しくは、http://www.faircom.comを参照してください。
システム・ハードウェア、Web トラフィック、および構成オプションによっては、
STC はバックログを持つようになり、許可されたすべてのメモリーを使い切り、後
で処理するために DecoupleEx パイプライン・エージェントを介して着信ヒットを
ディスクにスプーリングし始めることがあります。このセクションでは、高メモリ
ー使用状態を処理するためのガイドラインを示します。
キャニスター・ステータスのモニター
Tealeaf ポータルを使用して、DecoupleEx システム・ステータス・レポートでキャ
ニスター・ステータスをモニターできます。
1. Tealeaf ポータル・アプリケーションに管理者としてログインします。
2. システム・レポートの下に、以下のキャニスター・ステータスおよび
DecoupleEx ステータスのレポートがあります。
v キャニスター・ステータス: 現在の Web トラフィックおよび STC メモリー/
ディスク使用量に関する情報を示します。
v DecoupleEx ステータス: 現在の DecoupleEx ステータスおよびスプーリング
に関する情報を示します。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『システム・ステータス』を参照
してください。
第 2 章 Tealeaf データベースのトラブルシューティング
75
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 セッション・タイムアウト設定の構成について詳しくは、 81 ページの『セッショ
ン・タイムアウトの設定』を参照してください。
「キャニスター:リアルタイム」ステータス
STC は、着信ヒットをリアルタイムに処理するために使用可能です。
「キャニスター:該当なし」ステータス
現在、キャニスター・ステータスは使用不可です。キャニスターがオフラインにな
っているか、データを処理する準備ができていない可能性があります。
キャニスター・スプーリング
スプーリング時には、キャニスター・マネージャー・サービスおよびその子プロセ
スは引き続き、短期キャニスターに挿入されたデータを処理します。DecoupleEx が
ヒットをキャニスターに入れるフローを停止した場合、セッションがタイムアウト
になり始め、短期キャニスターから移動されるため、c-tree メモリー使用率は徐々に
低下します。
76
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
c-tree メモリー使用率レベルが事前定義のしきい値未満に低下すると、DecoupleEx
は再度、短期キャニスターへのデータの挿入を開始します。この状態は、
DecoupleEx システム・ステータス・レポートで Canister:Real-Time として表示さ
れます。
v メモリー使用率レベルは、拡張デカプラー・セッション・エージェントのパラメ
ーターで構成できます。『c-tree メモリー使用率の構成』を参照してください。
スプールされたデータのボリュームが短期キャニスターのメモリー容量を超過して
いる限り、キャニスターは、「リアルタイム」状態と「スプーリング」状態の間を
行き来します。また、ポータルのアクティビティー・レポートは、Web サイト・ア
クティビティーが実際のキャプチャー時間よりも遅く発生していることを示しま
す。その理由は、これらの統計は、STC プロセスによるキャニスターへの挿入後に
記録されるためです。これらのアクティビティー・レポートでは、スプーリングが
原因で、数時間、予期されるより小さいカウントが示されることはよくあることで
す。レポートでのこのような不自然な低アクティビティー期間から数時間は、通常
より大きいカウントが示されることがあります。これは、より高速に (通常、拡張
デカプラー・セッション・エージェントで構成されている最大安全速度で)、スプー
ルされたヒットがスプールからキャニスターに再挿入されていたためです。
スプーリングが行われる場合、十分な期間、低 Web トラフィック期間中の動作を
特定するために、キャニスター・ステータスを観察する必要があります。このよう
な期間中に、キャニスターは追いつく必要があります。古いスプール・ファイルの
処理中にも新規スプール・ファイルが作成され続けます。これは、新規スプール・
ファイルを作成可能になる前に最後のスプール・ファイルが消費されるのに十分な
長い期間、スプール・データの消費速度が作成速度を超過するまで、スプーリング
が停止しないためです。
スプーリングが慢性的な状態になった場合、根本原因に応じて、以下の解決方法の
いずれかにより、問題を緩和できます。
v ワークロードの削減
v スループットの最適化
v より高速/大規模な Tealeaf ハードウェア・クラスターの作成
c-tree メモリー使用率の構成
拡張デカプラー・セッション・エージェントの構成で、セッション・エージェント
がディスクへの着信ヒットのスプーリングを開始し、セッション・エージェントが
スプーリングの開始後にキャニスターへのヒットの送信を再開するキャニスター・
メモリーしきい値 (パーセント) を定義できます。
v これらの設定は、TMS のパイプライン・エディターを使用して構成できます。以
下の「表示名」列に、変更する DecoupleEx セッション・エージェントのパラメ
ーターがリストされています。「IBM Tealeaf cxImpact 管理マニュアル」の
『Tealeaf 管理システム』を参照してください。
v これらのパラメーターは、TealeafCaptureSocket.cfg ファイルの [DecoupleEx]
セクションで構成できます。「内部名」列に、変更するパラメーターがリストさ
れています。
第 2 章 Tealeaf データベースのトラブルシューティング
77
表 1. キャニスター・スプーリング
表示名
内部名
説明
使用されて
いるキャニ
スター・メ
モリーの最
大 %
(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 だけ大きくすることができます。
この設定は、キャニスター・データ・ファイルが処理サーバーに保持される日数
を示します。この日数が経過すると、アーカイブ・マネージャー・サービスがそ
のファイルを取得しようとします。この値を大きくすると、このエラーがなくな
るはずです。ただし、追加日のデータを保管するのに十分なスペースが処理サー
バー上のストレージに存在する必要があります。
v archiver.cfg の LockOutPeriod 値を大きくして、データがキャプチャーされた
翌日の遅くにアーカイブが開始されるようにすることができます。ただし、Web
78
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
トラフィックが当日に増加し始めたときにアーカイブ・プロセスがまだ実行中で
あるため、処理サーバーに負担をかける可能性があります。
キャニスター設定の適用
注: キャニスター設定を変更してトランスポート・サービスを再始動した後に、キ
ャニスターが稼働中になるまで、ヒットがスプールされることがあります。状況に
よっては、拡張デカプラー・セッション・エージェントが、キャニスターが再始動
されたことを示す通知を受け取らず、キャニスターがヒットを受け取る準備ができ
ているのにもかかわらず、ヒットがスプールされ続けることがあります。この場
合、すべての Tealeaf サービスの再始動が必要になります。「IBM Tealeaf CX 構成
マニュアル」の『CX キャニスターの構成』を参照してください。
Tealeaf のサイズ変更の計算
以下のメトリックは、Tealeaf キャニスターで大幅なスプーリングなしで Web トラ
フィックを処理するために必要なサイズ変更を計算するのに役立ちます。
v これらの値は、ディスク・ストレージおよびデータベースのサイズ変更用に計算
するためにも役立ちます。
DecoupleEx ログに基づいて、ピーク値を計算できます。これらのファイルは以下の
ファイルに保管されます。
<Tealeaf_logs_directory>¥CSS_*
ここで、
<Tealeaf_logs_directory> は、DecoupleEx 構成で指定されます。「IBM Tealeaf
CX 構成マニュアル」の『拡張デカプラー・セッション・エージェント』を参照して
ください。
以下の表に、パフォーマンス/サイズ変更のメトリックを示します。システム要件を
評価する上で、サイズ変更の計算に必要な絶対最小情報は、最初の 2 つの項目で
す。他の情報は、より正確な評価を提供します。
v アクティビティー・レポートは、Tealeaf ポータルで使用可能です。「IBM
Tealeaf レポーティング・ガイド」の『Tealeaf レポート・ビルダー』を参照して
ください。
メトリック
データ・ソース
1 日当たりの平均セッション (または訪問) 数
ポータル・アクティビティー・レポートのセッション・カウント・レポート
を参照してください。妥当な日数にわたって、この値を平均化してくださ
い。
1 日当たりの平均ページ・ビュー数
ポータル・アクティビティー・レポートのページ・ビュー・カウント・レポ
ートを参照してください。妥当な日数にわたって、この値を平均化してくだ
さい。
第 2 章 Tealeaf データベースのトラブルシューティング
79
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)」を参照してください。
伸張係数
このメトリックとして、データ・ボリュームの期待される伸張または測定さ
れた伸張のいずれかを使用できます。
80
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
注: 上記情報を取得した後に、システムの正常性およびハードウェア要件を評価す
るために、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 キャニスターの構成』を参照してください。
セッションがフラグメント化する理由
以下の 3 つのいずれかの原因により、フラグメント化されたセッションが作成され
ることがあります。
v Tealeaf 非アクティブ・タイムアウト期間が超過した場合に、訪問者のセッション
がフラグメント化されます。例えば、訪問者が昼食時に Web ページを開いたま
まにし、昼食後に同じブラウザー・ウィンドウで再びブラウズすると、フラグメ
ント化されたセッションが生じることがあります。非アクティブ期間が長いた
め、最初の数ページが短期キャニスター (STC) から長期キャニスター (LTC) に
移動されます。昼食後に続くページは STC 内に配置され、固有のセッション・
フラグメント ID が付与されます。ただし、新規セッションは同じブラウザー・
ウィンドウであるため、TLTSID セッション Cookie 値は変更されません。
v 3 つの「安全」制限 (期間、ヒット数、バイト) のいずれかを超過した訪問者セッ
ションは、STC スペースを無用に消費することを防止するために、STC から
LTC に移動されます。セッションが LTC に移動された後に、同じ TLTSID の
次のヒットにより、STC 内に新規セッション・フラグメントが生成されます。
v キャニスター・サービスが保守のためにシャットダウンされるときに開いていた
セッションは、LTC に移動されます。同じ TLTSID の後続のヒットにより、STC
に新規セッション・フラグメントが作成されます。
第 2 章 Tealeaf データベースのトラブルシューティング
81
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 ポータルで、「Tealeaf」 > 「システム・ステータス」 > 「キャニスタ
ー」を選択します。
3. 合計セッション・カウントに対する各ホストのセッション・カウントの比率によ
り、使用されているスペース量の大まかな見積もりが得られます。
特定のホストからのセッションが平均より相当大きい場合、この見積もりは正確で
はない可能性があります。しかし、見積もりとしては十分なものになります。
82
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
キャニスター・セッション・エージェント・パフォーマンスの評価
キャニスター・セッション・エージェントでは、複数のスレッドがサポートされま
す。これにより、複数の Tealeaf パイプラインを介して短期キャニスターにヒット
をルーティングすることで、ヒット挿入レートを上げることができます。パイプラ
インを追加する前に、現在のキャニスター挿入パフォーマンスを評価する必要があ
ります。
通常、キャニスター・セッション・エージェントのボトルネックは、STC メモリー
の使用を改善するためにヒットを圧縮しているときに発生します。セッション・エ
ージェントのパフォーマンス統計の表示を有効にすることで、ヒット挿入レートお
よび圧縮レートをモニターできます。
TealeafCapturesocket.cfg のキャニスター・セッション・エージェント構成セクシ
ョンで、以下のプロパティー値を設定します。
DisplayPerf=true
このオプションにより、Tealeaf パイプライン・ステータス・レポートの「キューに
登録済み」フィールドへのセッション・エージェントの最大処理レートの出力が有
効になります。
v Tealeaf パイプライン・ステータスについて詳しくは、「IBM Tealeaf cxImpact 管
理マニュアル」の『Tealeaf 管理システム』を参照してください。
有効になっている場合、以下に示すように、レポート内のキャニスター・セッショ
ン・エージェントの「キューに登録済み」フィールドに、30360558 のような数値が
表示されます。
この数値を使用して、キャニスター・セッション・エージェントにボトルネックが
あるかどうか、および必要なヒット・レートを提供するために必要なパイプライン
の数を判別できます。数値 30360558 では、下 4 桁が STC への最大圧縮レートを
第 2 章 Tealeaf データベースのトラブルシューティング
83
示しており、上 4 桁または 5 桁がセッション・エージェントへの最大挿入レート
を示しています。上記の例では、以下を示しています。
v 最大挿入レート = 3036 ヒット/秒
v 最大圧縮レート = 558 ヒット/秒
アーカイブ・サーバーなしでのキャニスター・ファイルのバックアップ
Tealeaf システムでアーカイブ・サーバーを使用していない場合、以下の方式を使用
してキャニスター LSSN ファイルをバックアップできます。
注: セッション・データ・ファイルのバックアップ時に、キャニスターがデータ・
ファイルにアクセス可能であってはなりません。アクセスできる場合、当該ファイ
ルを再作成する必要が生じます。
処理サーバーのダウン時間を最小限に抑えてファイルをバックアップするには、以
下のようにします。
1. 対象の LSSN ファイルにこれから追加されるデータがないことを確認します。
例えば、昨日のデータ・ファイルをバックアップする場合、昨日用のスプー
ル・データがないことを確認します。
2. キャニスター・サービスをシャットダウンします。
3. 一時ディレクトリーを作成します。
4. 対象の lssn データ・ファイル (lssn*.dat および lssn*.idx) を一時ディレク
トリーに移動します。
5. キャニスター・サービスを再始動します。
6. 一時ディレクトリーのファイルをバックアップします。
7. 対応する dtSearch インデックスをバックアップします。
8. キャニスター・サービスをシャットダウンします。
9. 一時ディレクトリー内の LSSN ファイルをアクティブな CANISTER.dbs ディレ
クトリーに戻します。
10. キャニスター・サービスを再始動します。
稼働中のキャニスターに LSSN ファイルをリストアする際には、CanTrim が無効に
なっているか、リストアされたデータ・ファイルが次回の始動時にトリムされない
ように保存日数の設定が十分に大きいことを確認してください。
キャニスターの移動
Tealeaf キャニスターを移動するには、セッション・データ・ファイルおよびそのイ
ンデックスを移動し、該当する変更の構成を更新する必要があります。
注: この手順は、オフピーク時にスケジュールする必要があります。キャニスター
が無効になって切断されている期間に、キャプチャーされたすべてのヒットがドロ
ップされます。
注: 現在のバージョンにアップグレードする前に Tealeaf ソリューションがリリー
ス 7.2 にアップグレードされ、リリース 7.2 バージョンを丸 1 日実行できなかっ
84
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
た場合、アプリケーション・イベント・ログでエラー 160 を受け取ることがありま
す。 86 ページの『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 インデックス付けの構成』を参照してください。
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 ディレクトリーの親ディレクトリーの
絶対パスになるように設定します。必ず、値に最後の円記号 (¥) を含めてくださ
い。
第 2 章 Tealeaf データベースのトラブルシューティング
85
キャニスター移動の完了
上記の構成変更の一方または両方を行った後に、以下のようにします。
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 データベース操作により、以下のタイプのエラーが生成されることがありま
す。
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 ファイルには、トラ
ンザクションのサポートは含まれていません。上記のエラーは、このサポートの欠
落が原因です。
86
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
インデックス付けを待機しているセッションはまだインデックス付けされているた
め、データ損失のリスクはありません。ただし、当日のデータが完全にインデック
ス付けされるまで、イベント・ログでは引き続き、このようなエラー・メッセージ
を受け取ることになります。数日経ってもイベント・ログにこのようなエラーが引
き続き表示される場合は、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).
インデックスの修正:
この場合、システムの異常終了により、正しくないファイル情報がインデックスに
追加された可能性があります。この問題を修正するには、以下を実行します。
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」というメッセージは、すべて問題ないことを示しています。
第 2 章 Tealeaf データベースのトラブルシューティング
87
4. プレフィックスが LSSN_ のファイルを ¥lssn¥Canister.dbs ディレクトリーか
らコピーして、キャニスター・データ・ディレクトリーに戻します。
5. TMS を使用してキャニスター・サービスを再始動します。「IBM Tealeaf
cxImpact 管理マニュアル」の『TMS の「全体ビュー」タブ』を参照してくださ
い。
6. これで、セッション・データが使用可能になりました。
7. テストするために、サーバーの異常終了の日付からセッションを検索します。
「IBM Tealeaf cxImpact ユーザー・マニュアル」の『セッション・データの検
索』を参照してください。
エラー 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).
このエラーはサービスのリサイクルおよびポータルのリブート後にも表示されるこ
とがありますが、キャニスターは正常に動作しているように見えます。
上記のエラーは通常、指定されている .dat ファイルのインデックスが破損してい
ることを示しています。
この問題を修復するには、以下のステップを実行してインデックスを再作成しま
す。
注: キャニスター・インデックスの再作成には、長時間かかることがあります。以
下のステップは、オフピーク時に実行してください。
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 キャニスター
の構成』を参照してください。
88
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
例外をトラブルシューティングするためのログ・レベルの変更
インデクサー・ログで例外が検出された場合、インデクサーのログ・レベルを 4 ま
たは 5 に上げます。これにより、より幅広いデバッグ・データ・セットをキャプチ
ャーできます。
v エラーを Tealeaf カスタマー・サポートにレポートする際には、レベル 4 以上
に設定されたログ・ファイルをサブミットします。
ステップ:
以下のステップを実行して、ログ・レベルを変更します。
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
でこのしきい値の検査を無効にするか、しきい値を大きくして頻繁にしきい値がト
第 2 章 Tealeaf データベースのトラブルシューティング
89
リガーされないようにすることをお勧めします。設定を再確認するために、
IndexConfig.exe ユーティリティーを実行し、「操作実行時間」タブをクリックし
て、「キャニスターとの直接通信の有効化 (Enable direct communication with
Canister)」チェック・ボックスが選択されているかどうかを確認します。
v リリース 7.2 以降では、インデックス構成は TMS を使用して管理します。
「IBM Tealeaf CX 構成マニュアル」の『CX インデックス付けの構成』を参照し
てください。
...¥TeaLeaf¥Tools¥PortalStatus.cfg の WaitToBeIndexed エラーしきい値を大き
くするか、0 に設定してこのしきい値の検査を完全に無効にすることができます。
一部のセッションがインデックスから欠落しているように思われる
セッション・インデクサー・サービスが停止状態の場合、セッションは、長期キャ
ニスターへの移動時にインデックス付けされません。一部のセッションがインデッ
クス付けされていない、またはインデックスが最新でない可能性があると思われる
場合、検索サーバーの「インデックスの検査および修正 (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. 「検査および修正 (Check and Fix)」をクリックします。
4. システムで、インデックス付けする必要があるセッションの数が示され、プロセ
スが開始されます。ブラウザー・ウィンドウを閉じた場合でも、プロセスはバッ
クグラウンドで続行されます。
a. ブラウザー・ウィンドウを閉じた後にプロセスのステータスを確認するに
は、新規ブラウザー・ウィンドウを開き、以下の URL を入力します。
http://<hostname/IP addr of Tealeaf server>:19000/CanisterIndexCheckerStatus
キャニスターからのインデックス付けセッション数の取得に失敗した
このエラーは、TeaLeaf セッション・インデクサー・サービスがキャニスター・サ
ーバー・データ・ストア・サービスに接続できないことを示しています。この状態
が発生する可能性があるのは、キャニスター・サーバー・サービスが停止状態また
は保守モードの場合です。
キャニスター・サーバー・サービスは、開始されると、TLTMaint プログラムを実行
して、保守モードを開始します。TLTMaint は、キャニスター・データ・ファイルの
徹底的な検査を実行します。TLTMaint は通常、1 分未満で完了しますが、キャニス
90
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
ターの .dat ファイルまたは .idx ファイルのいずれかを無効にした異常シャット
ダウンが発生した場合、完了するまでにかなり長い時間がかかることがあります。
他の Tealeaf サービスは開始すると、キャニスター・サーバーとの通信を開こうと
します。サービスの動作は問題ありません。開始直後に通信を確立できない場合、
10 秒程度ごとに再試行し、少なくとも 5 分間待機してから、接続エラーをイベン
ト・ログにレポートします。
実際のイベント・ログを確認すると、セッション・インデクサー・サービス・エラ
ー・メッセージの後に、TLTMaint がエラーなしで完了したことを示すメッセージが
表示されており、セッション・インデクサー・エラー・メッセージがログに記録さ
れなくなっています。
インデックス・エラー・リカバリー
インデックス・ジョブが新規インデックスを作成するか、マージを実行すると、新
規インデックスが作成され、確実にインデックス名を予約するために TLL ファイル
に即時に追加されますが、インデックスは無効とマークされます。インデックスま
たはマージ操作が完了すると、インデックスは有効とマークされます。インデック
スまたはマージが異常終了した場合、インデックスは無効とマークされたままにな
り、ロックされたままになります。ロックは、2 時間を超えてロック状態のままで
ある場合、解除されます。TLL 検査時に、無効とマークされた、ロックのないイン
デックスがインデックス検査で見つかった場合、そのインデックスは削除されま
す。
インデックス付け時にエラーが返された場合、インデックスは、「インデックス検
査が必要」とマークされます。このインデックスは、このフラグが削除されるま
で、インデックス付けで使用されません。インデックス検査が失敗した場合、イン
デックスは破損とマークされ、TLL から削除されます。検査に成功した場合、「検
査が必要」フラグがクリアされ、インデックスが稼働状態に戻ります。
破損したインデックス・ディレクトリーは、後で検査するために、.CORRUPT ファイ
ル拡張子を付けて名前変更されます。
インデックスの再作成
必要な場合は、インデックス・ディレクトリーを削除し、検索サーバーでインデッ
クス検査オプションを使用することで、インデックスを再作成できます。詳しく
は、Tealeaf http://support.tealeaf.com にお問い合わせください。
構成
構成について詳しくは、「IBM Tealeaf CX 構成マニュアル」の『CX インデックス
付けの構成』を参照してください。
RSE サービスで障害が起こる
結果セットに対する分析の実行時に、RSE で障害が起こり、以下のエラー・メッセ
ージが生成されます。
第 2 章 Tealeaf データベースのトラブルシューティング
91
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
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 エンコードが含まれていないこ
とです。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 タスクマネージャー (また
92
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
はそれに相当するツール) を使用して、サービスを手動で強制終了する必要があり
ます。その後、RSE サービスを通常の Tealeaf 始動手順の一部として再始動できま
す。
この問題は、Tealeaf バージョンの後続のビルドで解決される可能性があります。詳
しくは、Tealeaf http://support.tealeaf.com にお問い合わせください。
トラブルシューティング - データ収集プログラム
許容可能なエラー・メッセージ
ポータル・データ収集プログラムのログで、以下の 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.
上記のメッセージが表示されるほぼすべてのシナリオで、基本的な問題は、SQL
Server がリブートしているか、保守モードになったことです。これらのエラーは、
頻繁に、または不定期および予期しない間隔で再表示されない限り、無視できま
す。
パフォーマンスの問題
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 データベースのトラブルシューティング
93
データ収集実行を完了するための時間を短縮するために、以下の値を上げて実験で
きます。
設定
推奨される調整
データ収集 - 同時最大数
データ収集プログラムが同時に照会できるキャニスターの最大数。現在の値
より多くのキャニスターがある場合は、この値を 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 分後にデータ収集を実行するようにスケジュールされ
ています。
RDC がレポート・データベースと通信できないか処理サーバー上のキャニスターと
通信できない場合、または RDC 自体を実行できない場合、レコードは、処理サー
94
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
バー上のキャニスターに累積されます。次に RDC が正常に実行されたときに、処
理サーバー上のキャニスター内のすべてのレコードが収集されてレポート・データ
ベースに保管されます。
デフォルトで、処理サーバー上のキャニスターは、レコードをローカルに 48 時間
保持します。その時間を超えても RDC がこれらのレコードを読み取って取得でき
ない場合、処理サーバー上のキャニスターは、最も古いレコードから削除し始めま
す。古いレコードは、1 時間のチャンクで削除されます。
v レコードが保持される期間は、キャニスター構成の「サービス実行」タブのパラ
メーターで構成します。「IBM Tealeaf CX 構成マニュアル」の『CX キャニスタ
ーの構成』を参照してください。
イベント・グラフのカウントとドリルダウン検索のカウントの不一
致
イベント・グラフまたはダッシュボードで、特定の期間のイベント・カウントをレ
ポートできます。基盤となるセッションにドリルダウンするためのリンクをクリッ
クすると、返されるセッション数が、グラフでレポートされている数と異なりま
す。
v 上記では、グラフ内のすべてのイベントが、セッション内で 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 とは異なります。その設定は変更しないでください。
7. 設定を保存します。
8. 数時間、またはグラフと検索のカウントで矛盾が見つかるまで、データ収集プ
ログラムを実行します。
第 2 章 Tealeaf データベースのトラブルシューティング
95
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 ポータルを使用して、キャニスター・ユーザー名およびパスワードを確
認します。
v キャニスターで TLADMIN および TLUSER アカウントにカスタム・パスワード
を使用している場合は、Tealeaf ポータルでパスワードを正しく入力したこと
を確認します。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『Tealeaf サーバーの管理』を参
照してください。
96
IBM Tealeaf CX: 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 つの領域
のいずれかにあります。
データベース・ファイル・グループ・レポートにデータが表示され
ない
インストール後に、データベース・ファイル・グループ・レポートにデータが表示
されないことがあります。ただし、基盤となるデータベース表を調べると、データ
が存在していることが分かることがあります。
v この問題は、リリース 8.4 以降の新規インストール済み環境に適用されます。
この問題の原因は、ホストおよび訪問者ホストの値が localhost のままになり、マ
シン名にマップされないという、インストール時のバグです。レポートが
localhost を使用してレポート・データについての照会を試行すると、ポータルが
データベースへの接続に失敗し、空のレポートがレンダリングされます。
v この問題は、お客様が上記レジストリー設定を変更した場合にも発生することが
あります。ただし、この状態はまれです。
この問題を修正するには、以下のようにします。
1. レポート・サーバーに管理者としてログインします。
2. 次のレジストリー・ハイブ (64 ビット) にナビゲートします。
SOFTWARE¥Wow6432Node¥TeaLeaf Technology¥DataStore¥ReportServer
3. 次の設定を変更します。
第 2 章 Tealeaf データベースのトラブルシューティング
97
表 2. データベース・ファイル・グループ・レポートにデータが表示されない
設定
現在の値
新しい値
Host
localhost
マシンのフルネーム
VisitorHost localhost
(IBM Tealeaf
cxResults が
インストー
ルされてい
る場合)
マシンのフルネーム
4. レジストリーを保存します。
5. レポート・サーバーを再始動します。
トラブルシューティング - データ・サービス
Tealeaf データ・サービスの問題発生時には、カスタマー・サポートにレポート・ロ
グ情報を提供します。 102 ページの『ログのレポート』を参照してください。
v 「IBM Tealeaf CX 構成マニュアル」の『Tealeaf データ・サービスの構成』を参
照してください。
ReportQueryLogEntity エラー・メッセージの書き込みに失敗し
た
データ・サービス・ログに以下のようなエラー・メッセージが定期的に表示される
ことがあります。
Failed to write ReportQueryLogEntity
上記のエラーは、内部ロギング・テーブルでのトランザクションの問題を記録した
ものです。ユーザーおよびパフォーマンスには一切影響しないため、無視できま
す。
トラブルシューティング - レポート・サービス
注: リリース 8.0 で、レポート・サービスは、Tealeaf データ・サービスに完全に統
合されたコンポーネントになっています。『トラブルシューティング - データ・サ
ービス』を参照してください。
トラブルシューティング - レポート・ビルダー
レポート・ビルダーからのドリルダウン時の「There are no
matches for your search」
レポート・ビルダーで、ドリルダウンが有効になっている場合は、レポート・ビル
ダー詳細テーブル内のリンクをクリックして、テーブル内の項目のソース・データ
を提供した、基盤となるセッションのリストを確認できます。
98
IBM Tealeaf CX: 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 データベースのトラブルシューティング
99
v リリース 7.x 以前からアップグレードしたお客様の場合、IBM Tealeaf
cxResults 用に大きなセッション・セグメントを作成する際に使用するため
に、この値がかなり大きな値に設定されていることがあります。ただし、この
設定は、Tealeaf レポート・ビルダーの上記のユース・ケースに該当するもの
であり、適宜サイズ変更する必要があります。
6. 「保存」をクリックします。
7. ドリルダウン・リンクを再試行します。
v リンクでまだセッションが返されない場合、1 にサイズ変更する必要がありま
す。それでも失敗した場合は、値を 1000 にリセットし、
http://support.tealeaf.com にお問い合わせください。
トラブルシューティング - トップ・ムーバー
トップ・ムーバーが更新されない
トップ・ムーバーを構成した場合、トップ・ムーバーのデータが収集されてポータ
ルに表示できるようになるまでに時間がかかることがあります。毎時トップ・ムー
バーは 1 時間ごとに収集され、日次トップ・ムーバーは 1 日に 1 回収集されま
す。
注: 新規に作成された日次トップ・ムーバーでは、トップ・ムーバー用に次の日の
データ収集プログラムが実行されるまで、トップ・ムーバー・レポートでのデータ
の表示が開始されません。デフォルトでは、この実行は、午前 5:30 に行われます。
トップ・ムーバーの作成について詳しくは、「IBM Tealeaf イベント・マネージャ
ー・マニュアル」の『TEM の「トップ・ムーバー」タブ』を参照してください。
v トップ・ムーバーのレポート作成について詳しくは、「IBM Tealeaf レポーティ
ング・ガイド」の『トップ・ムーバーの分析』を参照してください。
24 時間待機しても、構成したトップ・ムーバーにデータが表示されない場合は、以
下の問題が原因の可能性があります。リリース 8.2 では、レポート・サーバーのタ
イム・ゾーンが、Tealeaf システムのタイム・ゾーンに一致している必要がありま
す。タイム・ゾーンが一致していない場合は、トップ・ムーバー・データは収集さ
れません。トップ・ムーバー・レポートに何も表示されません。
この問題に対処するには、Tealeaf システムのタイム・ゾーンに一致するようにレポ
ート・サーバーのタイム・ゾーンを変更する必要があります。以下のセクションで
は、必要なステップを示します。
Tealeaf システムのタイム・ゾーンの取得
1. ポータルにログインします。
注: Tealeaf システムのタイム・ゾーンは、初期インストール時に構成する必要
があります。それ以降は変更してはなりません。この回避策のため、Tealeaf シ
ステムのタイム・ゾーンを変更しないでください。変更すると、Tealeaf システ
ムの他の多数のコンポーネントに影響が出る可能性があります。
2. 「ポータル」メニューから、「Tealeaf」 > 「TMS」を選択します。
100
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
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 システムのタイム・ゾーンの「トップ・
ムーバー - 日次計算の時刻」の時刻に再計算されます。
レポート・サーバーのタイム・ゾーンの変更
レポート・サーバーをホストしているマシンのタイム・ゾーンを Tealeaf ロール・
タイム・ゾーンに変更した場合、その後、トップ・ムーバーは正常に計算されま
す。
注: 開始する前に、Tealeaf レポート・サーバーをホストしているマシンに対する管
理者権限を備えていることを確認します。
第 2 章 Tealeaf データベースのトラブルシューティング
101
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 データ・サービスの構成』を参照してください。
レポート・サーバーの構成について詳しくは、「IBM Tealeaf CX 構成マニュアル」
の『レポート・サーバーの構成』を参照してください。
検索サーバー・ログの「Auth failed, no Authorization header on
cmd」エラー
検索サーバーに対してポータルまたは NT 認証が有効になっている場合、検索サー
バー・ログに以下のようなエラーが表示されることがあります。
102
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
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 でグル
ープを追加しようとすると、以下のエラー・メッセージを受け取ることがありま
す。
Error getting domain groups!
検索サーバー・ログに以下のようなエラー・メッセージが含まれることがありま
す。
Authorization error: NetGroupGetUsers() error
(domainServer: ¥¥MyServer group: corp¥TealeafPortal): Access is denied.
この問題は、ドメインのグループ・セットに対するアクセス権限が原因の可能性が
あります。多くの環境で、新規ドメインは、グループ情報に匿名でアクセスできる
ようにするために、検索サーバーなどの任意のクライアントを許可するように定義
第 2 章 Tealeaf データベースのトラブルシューティング
103
されます。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. 検索サーバーを再始動します。
104
IBM Tealeaf CX: 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, 2014
105
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. その他の問題
105 ページの『トラブルシューティング - レンダリング問題』を参照してくださ
い。
構成
構成について詳しくは、「IBM Tealeaf CX 構成マニュアル」の『再生サーバーの構
成』を参照してください。
再生サーバーでのプロキシー・エラーが原因で BBR セッションが BBR
で再生されない
BBR は、セッションの再生中にハングしたり、イメージおよび正しいページ・フォ
ーマット設定の表示に失敗したりすることがあります。再生サーバーが、プロキシ
ー構成の問題が原因で、元のサイト上のコンテンツにアクセスできなくなっている
可能性があります。
106
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
診断
この問題を診断するには、以下を実行します。
1. BBR でセッションを再生します。
2. 再生サーバーをホストしているサーバーに管理者としてログインします。通常、
このサーバーはポータル・サーバーでもあります。
3. ブラウザー・ウィンドウを開きます。次の場所にナビゲートします。
http://localhost:38000
注: ローカル・ホストから接続していて、認証が有効になっている場合は、ユー
ザー名とパスワードに ssadmin/ssadmin を使用できます。
4. 再生サーバー・インターフェースが表示されます。
5. 「キャッシュ」をクリックします。
6. キャッシュ・リストを検討します。バイト長が 0 でコンテンツ・タイプがない
項目が複数ある場合、再生サーバーで、内部 Tealeaf プロキシーを介した元のサ
ーバーへの通信で問題が発生しています。
上記の情報が存在する場合は、再生サーバーは、WinInet を使用して元のサーバーに
アクセスするように構成されています。この接続方式では、ローカル・システム・
アカウントを使用して実行している場合 (再生サーバーのデフォルト設定)、プロキ
シーを使用できません。
v WinInet は、ホスティング・サーバー上の Internet Explorer インスタンスによっ
て使用される設定に基づいて構成されます。この設定は、ローカル・システム・
アカウントとして実行されているサービスでは構成できません。
修正
この問題を修正するには、ドメイン内の名前付きアカウントを使用するように再生
サーバーを構成する必要があります。
1. 再生サーバーの構成: 再生サーバーをホストしているサーバーに管理者として
ログインします。
2. 管理者の「コントロールパネル」で、「サービス」パネルを開きます。
3. 「Tealeaf 再生サーバー」を右クリックして、「プロパティー」を選択します。
4. 「ログオン」タブをクリックします。
5. 「アカウント」ラジオ・ボタンをクリックします。
6. 以下のフォーマットで、名前付きアカウントのドメインおよびユーザー名を入
力します。
SomeDomain¥SomeUser
7. パスワードを 2 回入力します。
8. 「適用」をクリックします。
9. 再生サーバー・サービスを再始動します。
10. Internet Explorer の構成: Internet Explorer のインスタンスを開きます。
11. 「ツール」 > 「オプション...」を選択します。
12. Internet Explorer で使用するプロキシー・サーバーを構成します。
第 3 章トラブルシューティング - 再生サーバー
107
注: 詳しくは、インストールされているバージョンの 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. メニューで、「ツール」 > 「オプション...」を選択します。
3. 「コンテンツ」タブをクリックします。
4. 「JavaScript を有効にする」オプションを選択します。次に、「拡張」ボタン
をクリックします。
5. 「ウィンドウのフォーカス (前面か背面か) を切り替える」オプションを選択
します。
6. 「OK」を 2 回クリックします。
注: ブラウザー・ウィンドウに開かれているタブが複数あり、「ポータル」タ
ブが前面のタブでない場合は、ウィンドウのフォーカス (前面か背面か) の切
り替えは機能しません。
v Web ブラウザーの JavaScript 設定をチェックしてください。
108
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
ページのレンダリングのエラー
再生時に、応答コンテンツが、以下のエラー・メッセージに置き換えられることが
あります。
Error rendering this page! This may be caused by AJAX responses with a
text/html content type, or malformed HTML. Consider adding a replay
rule to remove this page.
上記のメッセージが表示された場合、再生サーバーは、ページを正しくレンダリン
グできませんでした。ページを表示できなかった理由については、さまざまな理由
が考えられます。最も単純な解決方法としては、再生からページを削除します。
再生からページを削除するには、以下のようにします。
1. BBR のナビゲーション・リストで、現在選択されているページを右クリックし
ます。
2. 「再生からこのページを削除」を選択します。
3. セッションが次に Tealeaf ユーザーに対して再生される際に、このページは再生
時にスキップされます。
再生ルールの作成について詳しくは、「IBM Tealeaf cxImpact ユーザー・マニュア
ル」の『BBR の再生ルール』を参照してください。
第 3 章トラブルシューティング - 再生サーバー
109
110
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
第 4 章トラブルシューティング - RealiTea Viewer
注: リリース 8.0 で、イベント・エディターは Tealeaf ポータルに移動され、RTV
では使用できなくなりました。「IBM Tealeaf イベント・マネージャー・マニュア
ル」の『Tealeaf イベント・マネージャー』を参照してください。
注: RTV でのブラウザー関連の問題については、サポートされるバージョンの
Internet Explorer がインストールされていることを確認してください。「IBM
Tealeaf RealiTea Viewer ユーザー・マニュアル」の『RealiTea Viewer の概要』を参
照してください。
RealiTea Viewer をインストールできません
エラー - 「TeaLeaf RealiTea Viewer requires Microsoft IE
V5.0 or greater」
IBM Tealeaf CX RealiTea Viewer をインストールしようとしているときに、以下の
エラーを受け取ることがあります。
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 の将来のバージョンへのアップグレード時に問題が生じないよ
うにします。
RTV のアンインストール後にもかかわらず「削除しますか
(Would you like to remove)」が表示され続ける
RTV をアンインストールして、再インストールしようとしている場合、RTV コン
ポーネントが既に削除されているのにもかかわらず、「削除しますか (Would you
like to remove)」ダイアログを受け取ることがあります。
この問題は、InstallShield Installation Information フォルダーが存在することが原因
です。Windows エクスプローラーでフォルダーを表示できず、アンインストール後
© Copyright IBM Corp. 1999, 2014
111
に手動でクリーンアップしようとしたときに見つかりにくくなっている可能性があ
ります。修正するには、次のようにします。
注: この変更を行うには、ローカル・マシンに対する管理者権限が必要です。
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 のパフォーマンスを加速することができる 2 つの領域を示します。
RTV における典型的なパフォーマンス上の問題は、JavaScript、スタイル・シート、
およびイメージなどの外部ファイルのロードに関係します。
RTV 拡張オプションの設定
1. 「RTV」メニューで、「ツール」 > 「オプション」を選択します。
2. 「拡張」タブをクリックします。
3. 以下のプロパティー値を設定します。
拡張オプション
値
JavaScript 自動ページ拡張 (Javascript Autopage advanced)
オフ
再生中にイメージを保管
オン
外部イメージなどにリダイレクトを使用
オフ
セッションの初期ページがロードされた後に、上記の設定により、静的コンテンツ
がローカルに強制的に保管されます。このローカル・ファイルが後続のページ・ロ
ードで使用されるため、セッションの残りのページのロードが加速されます。「IBM
Tealeaf RealiTea Viewer RTV ユーザー・マニュアル」の『RealiTea Viewer - 「拡張
オプション」タブ』を参照してください。
112
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
v これらの設定は、ユーザー・プロファイルに対して構成できます。「IBM Tealeaf
RealiTea Viewer ユーザー・マニュアル」の『RealiTea Viewer - プロファイル・
オプション』を参照してください。
外部ファイル・データベースの作成
前の解決方法が不十分な場合、外部ファイル・データベースを作成できます。.tli
ファイルを使用して、再生時に参照される静的コンテンツを保管できます。この方
式を使用することで、セッションの最初のページのロード時間が改善されます。
注: サイトに対して変更を行った場合、この解決方法により、廃止されたバージョ
ンの保管ファイルを RTV が参照する可能性があります。これにより、さまざまな
再生の問題が生じることがあります。サイトの変更を行った場合は、構成から .tli
ファイルを削除し、これらのステップを繰り返して新規ファイルを作成する必要が
あります。
1. 前の解決方法の設定を適用します。 112 ページの『RTV 拡張オプションの設
定』を参照してください。
2. 「オプション」画面で「静的ファイル」タブを選択します。
3. 「「イメージの取得」により静的ファイル・データベースに移動」オプションを
選択します。
4. 「新規」をクリックします。提案された名前を受け入れるか、任意のファイル名
と場所を選択することができます。
5. 「OK」をクリックします。
6. これで、セッションの再生時に外部ファイルが保管されます。再生されるページ
が増加すると、ソース・サーバーから必要とされる要求が減少します。
RealiTea Viewer にイメージが表示されない
REQ 内の SERVER_NAME は、ビューアーが実行されているデスクトップから元の
Web サーバーに到達できる名前に解決可能でなければなりません。例えば、
SERVER_NAME が company.com であるが、デスクトップが
http://www.company.com/
を使用して Web サイトに到達する必要がある場合、ビューアーは、イメージを取
得できません。
この問題を修正するために、以下のように、ビューアー・プロファイル・サーバー
再マップ・オプションを使用できます。
1. RTV で、「表示」 > 「オプション」 > 「プロファイル」 > 「プロファイルの
編集」を選択します。
2. company.com というスタンザを作成します。この値は、SERVER NAME にある
ストリングに一致している必要があります。
3. このスタンザで、以下の行を作成します。
SERVER_NAME=www.company.com
4. プロファイルの変更を保存し、オプション・ダイアログを終了します。再生が再
描画され、イメージが存在しています。
第 4 章トラブルシューティング - RealiTea Viewer
113
キャプチャーされたすべての Web サーバーで、プロファイルにスタンザが必要で
す。 5 つのサーバーがキャプチャーされている場合、5 つのスタンザのそれぞれに
ついて、プロファイルに SERVER NAME=www.company.com を追加する必要がありま
す。例えば、REQ 内の SERVER_NAME が web1、web2、web3 などである場合、そ
れぞれに 1 つのセクションが必要です ([web1]、[web2]、[web3] など)。
RealiTea Viewer でスクリプトが再生されない
Error - 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 つを選択しま
す。
d. 再生ペインを右クリックし、「ドキュメント・ソースの表示...」を選択しま
す。
e. 応答が表示されます。このページが HTML ページの場合、ページの基本構造
は、以下のようになっている必要があります。以下のタグが存在し、表示さ
れている順にリストされていることを確認してください。タグ間のコンテン
ツは無視して構いません。
<HTML>
<HEAD>
(header content)
</HEAD>
<BODY>
(body content)
</BODY>
</HTML>
114
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
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. 検索サーバー構成で、検索サーバーの完全修飾名を入力します。以下のフォー
マットにすることができます。
cximpact.mycompany.com
v http:// は不要です。
v ポート番号 (19000 など) は不要です。
9. 「OK」をクリックします。
10. TMS で、この検索サーバー構成を他のサーバーにプッシュするタスクを構成し
ます。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『TMS の「ジョブ」タブ』を参
照してください。
11. ジョブが完了したら、検索を再実行して、結果が返されるかどうかを確認しま
す。
第 4 章トラブルシューティング - RealiTea Viewer
115
アーカイブされたセッションの再生時におけるエラー
アーカイブされたセッションで、以下のエラー・メッセージが表示されることがあ
ります。
The session <session number> in Canister LSSN_* cannot be loaded:
LSSN open failure on <Server name>.
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 ヘッダーに指定さ
れている値と異なることがあります。このようになるのは、クライアントまたは
サーバーが TCP/IP 接続を閉じた、Web サーバーによるコンテンツ長の計算ミ
スやレポートミス、Content-Length ヘッダーがまったく存在しないことが原因の
可能性があります。
いくつかのページで「戻る」ボタンが押されたとビューアーで誤って表示さ
れる
ビューアーは、現在のページの「リファラー」がセッション内の直前のページの
URL でない場合は常に、ブラウザーの「戻る」ボタンが使用されたものと想定しま
す。
1. 「戻る」ボタンの挿入をオフにするには、「表示」 > 「オプション」を選択し
ます。
2. 「再生」タブを選択します。
3. 「「戻る」ページの挿入」チェック・ボックスをクリアします。
116
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
HTTP ヘッダーが「再生」ビューで表示される
1. RTV で、「表示」 > 「オプション」を選択します。
2. 「再生」タブをクリックします。
3. 「HTTP ヘッダー・スキップ」設定を「自動」に設定します。
セッションの再生時に一部のページが欠落しているように思われる
ページが欠落しているように思われるセッションについて、可能性が最も高い原因
は以下のとおりです。
v ページを再生しないようにビューアーが構成されている可能性があります。この
問題を解決するには、次の手順を実行します。
– ページの完全な URL (ファイル拡張子を含む) を取得します。
– ビューアーの解釈済みページのオプションを確認します。
– 再生するファイル・タイプの拡張子のそばにチェック・マークが付いているこ
とを確認します。
– ビューアーのプロファイルのオプションを確認し、欠落しているページの
URL が IGNOREURL 行にリストされていないことを確認します。
v IBM Tealeaf CX Passive Capture Application サーバー (PCA サーバー) を使用し
ている場合は、以下のとおりです。
– PCA サーバー Web UI のインターフェース・ページでキャプチャーするよう
に PCA サーバーが構成されていない Web サーバーが存在する可能性があり
ます。
– 欠落しているページのタイプがバイナリー・ファイルです。これを判別するに
は、以下のようにします。
- 自身でセッションを作成します。再生から欠落しているページのファイル拡
張子を調べます。それが、PCA サーバー Web UI の「その他」ページの
ExcludeExtensions リストにある拡張子に一致するかを確認します。
- 一致する場合は、その拡張子を ExcludeExtensions リストから削除し、「変
更の保存」をクリックします (データ・キャプチャーの中断を最小限に抑え
るために、できればWeb トラフィックが低いときに行ってください)。
– PCA サーバーのキャプチャー NIC への入力データに問題が生じていることが
あります。
- ページがないことを認識するセッション・レベルのイベントを定義できる場
合は、焦点を絞った TCPDump を実行して、そのような問題があるかどうか
を判別できます。この問題が発生する可能性が最も高い時刻に、TCPDump
実行 (ファイルへの出力) を開始します。Web サーバー IP アドレス、また
は少なくとも IP ポート番号でトラフィックにフィルターを掛けることがで
きる場合、それにより、出力ファイルのサイズがあまりにも迅速に大きくな
らないようにすることができます。 TCPDump を使用してネットワーク・ト
ラフィックをファイルに記録する手順については、 6 ページの『事前準備』
を参照してください。
- 上記の変更を行った後に、ポータルで、欠落しているページのイベントの発
生を観察します。イベントが確認された後に、TCPDump 実行を停止できま
す。次に、イベントを開始したセッションを取得し、そのセッションから
第 4 章トラブルシューティング - RealiTea Viewer
117
REMOTE ADDR (クライアント IP アドレス) を取得し、TCPDump 出力フ
ァイルをフィルターに掛けて、PCA サーバーへの入力データで一部のデー
タが欠落しているという理由でページが欠落しているかどうかを分析するた
めに、はるかに小さいファイルを作成することができます (手順について
は、 6 ページの『事前準備』を参照)。
この手順は、対象の Web トラフィックが HTTPS の場合、より複雑になります。
その場合、TCPDump 実行の開始後に発生した、キャプチャーされたセッションの
開始部分を調べて、TCPDump 出力に初期 SSL ハンドシェークが含まれていること
を確認する必要があります。このハンドシェーク・データのキャプチャーは、分析
用にキャプチャーされたデータを暗号化解除する上で重要になります。IIS キャプチ
ャー・フィルターを使用している場合は、以下のとおりです。
v キャプチャー・フィルターがインストールされていない/機能していない/接続でき
ない/Tealeaf サーバーへの十分な帯域幅を備えていない/Tealeaf サーバーへの断続
的なネットワーク障害が発生している Web サーバーがあります。この場合、解
決方法としては、各 Web サーバーの Windows アプリケーション・イベント・
ログを調べて、それぞれに対してフィルターが正しく実行されていることを確認
します。
v 欠落しているページのタイプがバイナリー・ファイルです。これが当てはまって
いるかどうかを判別するには、セッションを手動で操作します。再生から欠落し
ているページのファイル拡張子を調べます。それが、TealeafIIS.cfg ファイルの
ExcludeExtensions リストにある拡張子に一致するかを確認します。一致する場合
は、各 Web サーバーの .cfg ファイルの ExcludeExtensions リストからその拡張
子を削除し、IIS を再始動して .cfg ファイルを再ロードします (できれば、Web
トラフィックが非常に低いときに行ってください)。
HTTP ステータス・コード 304 およびキャッシュに入れられたオブジェク
ト
GET 要求の一部として、ブラウザーは、If-Modified-Since というヘッダーを組み
込むことができます。
v Tealeaf でキャプチャーされたヒットの「要求」ビューでは、これは HTTP IF
MODIFIED SINCE と表示されます。
このヘッダーとともに、オブジェクトがいつキャッシュに入れられたのかを示す
日付があります。このヘッダーを検索して、その中の日付を要求されたリソース
の最終変更日と比較するかどうかは、Web サーバーに委ねられています。ほとん
どの Web サーバーでは、このオプションがサポートされます。
Web サーバーでこのオプションがサポートされる場合、キャッシュに入れられたロ
ーカル・コピーを使用するようにブラウザーに指示する HTTP ステータス・コード
304 が返されることがあります。Web ブラウザーとサーバーの間のこの対話でも、
応答本体の長さがゼロの REQ/RSP ペアが生じます。このイベント・シーケンス
は、ブラウザーの「戻る」ボタンを押して、REQ を Web サーバーに発行すること
なく、ローカル・メモリー・キャッシュからページを取得する操作とは異なりま
す。
118
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
ローカル・キャッシュにオブジェクトのコピーが見つかった場合、ブラウザーの要
求には、If-Modified-Since ヘッダーのみが組み込まれるため、この動作は、キャ
ッシュに入れることができるファイルにのみ適用する必要があります。
キャッシュを処理する方法は各ブラウザーに完全に委ねられていますが、キャッシ
ュは必ずしもメモリー内キャッシュである必要はありません。Internet Explorer の場
合、キャッシュに入れられたファイルは、ローカル・ディスク上の一時インターネ
ット・ファイルとして保管され、IE の「インターネットオプション」で明示的に
削除するまで保持されます。そのため、ブラウザーを終了して再び開いても、304
を回避することはできません。
「再生オプション (Replay options)」タブで「リモート 304 ページのロード」チェ
ック・ボックスを選択した場合、If-Modified-Since ヘッダーを組み込まない単純
な GET 要求を実行するため、Web サーバーは、304 応答ではなく、オブジェクト
を返します。ただし、ビューアーは、元の訪問者が見たのと同じオブジェクトを取
得していない可能性があります。結果として行われる (ホーム・ページなどへの) リ
ダイレクトは、セッションの再生時にすぐに明らかになるわけではないため、通
常、このオプションは無効にされます。
v 「IBM Tealeaf RealiTea Viewer ユーザー・マニュアル」の『RealiTea Viewer - 再
生オプション』を参照してください。
セッションで .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 パイプライン内のイメージ・データを破棄して、繰り返し
第 4 章トラブルシューティング - RealiTea Viewer
119
の静的コンテンツがセッションに保管されないようにします。「IBM Tealeaf
CX 構成マニュアル」の『データ・ドロップ・セッション・エージェント』を
参照してください。
– オプションとして、キャプチャーされたセッションの永続スナップショットを
保持するために、静的コンテンツをキャプチャーして保管するように静的アー
カイブを構成できます。
注: 静的アーカイブがデプロイされている場合は、DelImages を無効にする必
要があります。「IBM Tealeaf cxImpact 管理マニュアル」の『静的アーカイブ
の管理』を参照してください。
Tealeaf 環境がどのように構成されているのかに応じて、静的コンテンツ (スタイ
ル・シート (.css ファイル) を含む) が処理時にドロップされることがあります。
ファイル拡張子がドロップ対象として構成されている場合、Tealeaf は応答を破棄し
ます。
v 要求の HTTP ステータス・コードが 200 の場合、その要求はドロップされま
す。結果として、静的コンテンツの要求は、要求を満たす際にエラーが発生しな
い限り、セッションのページ・リストに表示されません。
各ページでこれらのファイルに対する要求を複数回行うことがあるため、これらの
タイプの正常なヒットをすべて保管すると、データベースおよびインデックスのス
ペースを浪費する可能性があります。これらの静的ファイルはめったに変更されま
せん。特定のエラーがない限り、正常に配信されたと想定する方が合理的です。
静的 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 のダウンロード』を参照してください。
120
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
デフォルトでは、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
を参照してください。
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. 「ローカルアドレスにはプロキシサーバーを使用しない」チェック・ボッ
クスをクリックします。
第 4 章トラブルシューティング - RealiTea Viewer
121
6. 「OK」をクリックします。
7. 「OK」をクリックします。
8. IE6 を閉じます。
9. RTV を再始動します。
IndexWizard.dll が非互換であるとビューアーに表示される
RTV ダイアログは以下を表示します。
IndexWizard.dll is incompatible, Viewer cannot find .tlx file.
1. 「コマンドプロンプト」ウィンドウを開き、RTV ビューアー・インストール・
ディレクトリーに入ります。
2. 以下のコマンドを実行します。
regsvr32 IndexWizard.dll
埋め込みの .pdf 文書が別ウィンドウで開く
Adobe Reader 8 のインターネット設定に、ブラウザー・ウィンドウ内で .pdf を開
くための設定があります。この設定を有効にする必要があります。
イベント・アイコンが使用不可になっている
イベント・アイコンが使用可能になっていない場合、ご使用の 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. 変更を保存します。
122
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
v 「IBM Tealeaf cxImpact 管理マニュアル」の『TMS の「全体ビュー」タ
ブ』を参照してください。
4. 環境内に複数のキャニスターがある場合は、各キャニスターについて上記の
TMS ステップを繰り返します。
5. 単一または複数のキャニスター・サーバーに変更をプッシュするようにジョブを
構成します。
v 「IBM Tealeaf cxImpact 管理マニュアル」の『TMS の「ジョブ」タブ』を参
照してください。
再生ルール
IgnoreURL ルールにより、イベント・リストがページ・リストに
マージされる
新規 IgnoreURL ルールを作成した場合、イベント・リストがページ・リストにマー
ジされていることに気付くことがあります。これはあまり発生しません。
この問題を修正するには、以下のステップを実行します。
1. セッションで保存されていない変更がある場合、保存します。
2. セッションを閉じます。
3. 再度開きます。
4. 各ペインが通常どおりに分離したものになります。
RealiTea Viewer (RTV) の継続的な異常終了
RTV は、再生の実行時にセッションのすべてのヒットをダウンロードします。検索
の実行時には、検索に一致する特定のヒットをダウンロードする必要があります。
朝に RTV を開き、セッションの検索と再生に数時間費やした場合、RTV は、一時
ディレクトリーで大量のディスク・スペースを消費します。長時間の使用後に、
RTV アプリケーション・ウィンドウが突然消えることがあります。この問題が生じ
ている場合は、以下のようにします。
v 検索をより制限的なものにします。利点は 2 つあります。
– 検索が早く完了する
– RTV を実行しているコンピューターにおける結果セットによる消費メモリー
が削減される
v 検索後に、再生を開始する前に、ヒット結果が表示されるまで待機します。RTV
が個別にヒットをダウンロードしてすぐに再生しようとしている場合は、RTV が
個別ヒットをダウンロードしているときに RTV 検索結果画面の右上にある「キ
ャンセル」をクリックします。
v 1 時間程度ごと、または 20 件のセッションを再生した後に中断して RTV を閉
じてから、再び開きます。この再始動により、RTV は、メモリーおよびディス
ク・キャッシュからスペースを解放できます。
第 4 章トラブルシューティング - RealiTea Viewer
123
DWR POST の POST データの突き合わせが失敗する
リリース 8.4 にアップグレードし、サイトで DWR を使用してメッセージを Web
サーバーに転送する場合、POST を正しく突き合わせるために、パッチを適用し、
RTV 再生プロファイルで変更を行う必要があります。
v 「IBM Tealeaf RealiTea Viewer ユーザー・マニュアル」の『RealiTea Viewer の
概要』を参照してください。
複数のバージョンの CX での 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 を再度開きます。
124
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
トラブルシューティング - 再生の説明
このセクションでは、IBM Tealeaf CX RealiTea Viewer を使用した Tealeaf セッシ
ョンの再生での一般的な問題を診断するために従うことができる準備ステップの再
生の説明の概要を示します。以下のセクションでは、一連のステップで概要を示
し、特定の再生状態に関連した一般的な問題を緩和するのに役立つ例がいくつか含
まれています。
再生の概要
再生時に、RTV は、ターゲット Web ページのバージョンを、制御できる Internet
Explorer のインスタンスにロードします。ターゲット・ページで必要なオブジェク
トが要求されると、RTV は IE インスタンスの要求をインターセプトし、ロードさ
れたセッションに要求されたオブジェクトがあるのかどうか、または元のサーバ
ー、Web アプリケーションから取得する必要があるのかどうかを判別します。
RTV はセッション・データでオブジェクトを見つけることができる場合、そのバー
ジョンを作成して、使用しているプロキシー・サーバーを介してそれを要求し、外
部 Web サーバーから取得したかのように、要求されたオブジェクトを配信しま
す。
v 要求のヘッダーを確認すると、このようなプロキシーを介した要求は通常、
localhost:<some_port_number> から発信されています。
イメージ、JavaScript、および CSS は通常、キャプチャーされず、セッション・デ
ータに保管されません。これは、これらの項目はあまり変更されず、大きなストレ
ージのオーバーヘッドが必要になるためです。再生時に、これらの項目は一般的
に、元のサーバーから要求されます。HTML、顧客データに基づいて作成されたス
クリプト、JSON、およびバイナリー・データなどの他の項目は通常、セッション・
データにキャプチャーされます。これらは、再生時にライブで要求された場合、変
更されていたり、使用不可であったりする可能性があるためです。
注: キャプチャー時と再生時で同じである必要があるすべてのデータをセッショ
ン・データにキャプチャーする必要があります。
再生の問題のテーブルを含む一般的な問題のトラブルシューティングについて詳し
くは、 131 ページの『次のステップ』を参照してください。
チェック 1. 必要なものがすべてセッション内にあることを確認する
RTV の「ページ・ロードの詳細」ページで、Web ページがセッションおよび元の
サーバーに対して要求している各オブジェクトを確認できます。
v 項目が存在すれば、ページ・ロードの詳細により、正しく再生されていないエレ
メントに対する洞察が得られることがあります。
v ページ・ロードの詳細にアクセスするには、「表示」 > 「ページ・ロードの詳
細」を選択します。
必要なすべてのデータがセッション・データ内にあり、サーバーからアクセスでき
ることを確認することで、多くの複雑に見える再生の問題を修正できます。多くの
第 4 章トラブルシューティング - RealiTea Viewer
125
場合、欠落しているか再生に失敗している UI エレメントは、セッションから欠落
している POST または JSON 要求が使用可能になるとすぐに、修正されます。
例
v 再生時に JavaScript または CSS が正常に取得されない場合、サイトが正しく再
生されないか、レンダリングの品質が不十分になる可能性があります。
– このタイプのエラーは簡単に修正されます。
v 一部のファイルが、Cookie またはログイン・アカウントなどのユーザー資格情報
に基づいて作成されています。
– これらのファイルがセッション・データにキャプチャーされていないにもかか
わらず、再生時に要求された場合、通常、正常に完了しません。ほとんどの場
合、ファイルの汎用バージョンが元のサーバーから返されるか、要求時にリダ
イレクトが行われ、ホーム・ページなどの別の無関係なページが返されます。
この問題により、不安定な再生になります。
v Web ページの UI エレメントに動的に影響を及ぼすために POST データが必要
な場合、このデータをセッション・データにキャプチャーする必要があります。
– 一般的な例としては、前の選択に基づいて自動的にデータが取り込まれるドロ
ップダウン・リストや、ユーザーの入力に基づいて切り替えられるラジオ・ボ
タン・グループがあります。
– 再生時には通常、UI エレメントが変更されると、要求が発行されます。この
要求は通常、ページに必要なデータを送信するようにサーバーに指示する
POST 要求です。キャプチャー時に発生した内容を再生で正確に表すには、こ
の要求および返されるデータがセッション内になければなりません。
– これらのデータをキャプチャーするために、UI Capture を実装する必要が生じ
ることがあります。
v 特定の場合として、再生を正常に機能させるために、JavaScript をセッション・デ
ータにキャプチャーする必要がある場合があります。
– 良い例として、.NET Web サイトの ashx ファイルが挙げられます。このタイ
プのファイルには、ページの UI エレメントを制御するために必要なスクリプ
ト・コードが含まれているためです。
– ユーザーと Web ページの対話中にこのようなデータがサーバーで動的に作成
されている場合、再生で、キャプチャー時に使用されたバージョンと同じバー
ジョンを参照する必要があります。この場合、正しく再生するために、カスタ
ムビルドの JavaScript をセッション・データにキャプチャーする必要がありま
す。
v 疑わしいときは、ページ・ロードの詳細を確認してください。
サインインが必要なサイトの再生
お客様が、ログインしていないユーザーからのイメージ、スクリプト、オブジェク
トなどの静的コンテンツのほとんどをブロックしている場合、恐らく、RTV が再生
時にこのコンテンツを取得する際に問題が生じます。
126
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
オプション
v コンテンツを取得して、再生時に提供できるようにコンテンツを保管できる
Tealeaf ポータル・サーバーなどのプロキシー・サーバーに配置できます。このシ
ナリオでは、静的コンテンツの URL をプロキシーにマップするためのホスト/ポ
ートの再マップ・ルールが必要です。
v PCA でビジネス IT モードを有効にして、すべてのイメージおよび静的コンテン
ツがキャプチャーされるようにすることができます。
– ブラックリストに入れられた拡張子および MIME タイプを削除し、ファイル
名拡張子をホワイトリストに追加する必要があります (gif、jpg など)。
– また、処理サーバーにおいて、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 パラ
メーターが必要になります。要求を突き合わせることができなかった場合、元のサ
ーバーに対して要求されます。返されるヒットは、元々キャプチャーされたヒット
とは同じではないため、再生の品質が不十分になります。
第 4 章トラブルシューティング - RealiTea Viewer
127
例
v セッションのメインページ要求に URL パラメーターが含まれている場合、それ
らを覆い隠すと、RTV に強制的に元のサーバーに対して要求させる可能性がある
ため、再生の品質が不十分になり、ページのヒット・カウントが不自然に増加し
ます。
v .NET サーバー・セッション内の .axd ページがプライバシーによってブロックさ
れている場合、JavaScript イベントに応答するために必要な、Web ページの重要
な部分が使用不可になります。
– 通常、各要求について、これらのページは同じ名前で (例えば、
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 エレメントとどのように
対話したかを対話順に再生できます。ただし、このタイプの再生が正しく機能する
128
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
には、イベントが親ページに正しく突き合わされる必要があり、またイベントが関
連する UI エレメントが再生時にページの UI で使用可能でなければなりません。
注: 再生は順次です。あるイベントが正しく再生されなかった場合、次の再生イベ
ントのセットも失敗することが予期できます。
ライブラリーの組み込みおよびセットアップについて詳しくは、「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 を構成できます。
第 4 章トラブルシューティング - RealiTea Viewer
129
RTV では、再生強調表示オプションにより、現在強調表示されている UI エレメン
トに関連したスクリプトを実行し、元の Web サイト用のスクリプトで指定された
すべてのアクションを実行できます。元のサイトが単純であり、UI コントロールで
エレメントを切り替えない場合は、このオプションは必ずしも必要とは限りませ
ん。ただし、サイトで複雑な JavaScript の動作を使用して UI エレメントを制御し
ている場合は、再生時にこれらのスクリプト・アクションを実行する必要がありま
す。
v RTV で、「ツール」 > 「オプション」 > 「再生」タブを選択します。オプショ
ンのラベルは、「強調表示時に JavaScript を呼び出す」です。
例
v 親サイトに現在のページからナビゲートして離れるための「次へ」ボタンがある
場合、恐らく、RTV がそれを強調表示したときにナビゲーションが発生します。
ナビゲーションが発生しないようにこのアンカー・タグまたは JavaScript を削除
する必要があります。
–
133 ページの『第 5 章再生の問題のテーブル』を参照してください。
v 画面の残りを非アクティブにして、対話できるフォームを表示するオーバーレ
イ・ページがあります。
チェック 5. フレーム・コンテンツが正しく構成されていることを確認する
フレームを使用している Web サイトでは、再生でページを正しく表示するための
作業が必要になることがあります。多くの場合、セッション内の 1 ページは親フレ
ームになり、ナビゲーション・リスト (左上のリスト) 内のそれ以降のページは、親
の中に配置する必要がある子フレームになります。
フレームを適切に再生できるようにするために、以下の RTV 機能を有効にする必
要があります。
v 「ツール」 > 「オプション」 > 「再生」 > 「フレームの再生」 (必須)
v 「ツール」 > 「オプション」 > 「拡張」 > 「リモート・フレームの再生
(Replay Remote Frames)」 (オプション)
v 「ツール」 > 「オプション」 > 「拡張」 > 「アグレッシブ・フレーム配置」
(オプション)
次に、以下のように、RTV にフレーム・セットの階層を指示する必要があります。
1. 親ページであると思われるページを見つけます。ナビゲーション・リスト内のそ
のページをクリックし、「応答」ボタンをクリックして、応答の HTML コード
を調べます。このコードに、<FRAME> タグが含まれているはずです。このタグの
内部に、ナビゲーション・リスト内の後続ページの URL が表示されます。
v 見つかった後に、ナビゲーション・リスト内の親ページを右クリックし、「再
生ルール」 > 「このページをフレームに配置」 > 「_top」を選択できます。
親ページは、後続のすべての子ページを保持するように構成されます。
2. ナビゲーション・リストから親ページ内に配置する必要がある各ページを見つけ
ます。各ページを右クリックし、「再生ルール」 > 「このページをフレームに
配置」を選択してから、当該エレメントに関係したフレーム ID を選択します。
130
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
v 通常、親ページの FRAME エレメントにある src パラメーターには、割り当て
る子エレメントの URL が含まれています。その場合、親ページ内の FRAME
エレメントの name または ID パラメーターを使用して子を割り当てます。
次のステップ
問題がまだ解決しない場合は、 133 ページの『第 5 章再生の問題のテーブル』を
参照してください。
第 4 章トラブルシューティング - RealiTea Viewer
131
132
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
第 5 章再生の問題のテーブル
このページは、RTV を使用したセッションの再生に影響する問題に対する解決方法
を見つける入り口点となります。
このページを使用するには、以下のようにします。
v 以下のリンク内のシナリオを確認します。シナリオは S-## で始まります。
v 該当するシナリオが見つかったら、すべての質問に 1 つずつ答えてください。
注: 可能であれば、以下のページを確認する際には、インターネットに接続され
た状態にしてください。このページにある解決方法では、再生の説明や Tealeaf
オンライン・ヘルプ内の別の場所にリストされている解決方法を参照することが
あります。
v
135 ページの『S-01. 再生内のページが表示されない、または正しいページではな
い』
–
v
v
135 ページの『Q-01. ページが正しく要求されているかどうかを確認するため
にページ・ロードの詳細を確認しましたか?』
135 ページの『S-02. 再生時にエレメントが Web ページに表示されない』
–
135 ページの『Q-01. ナビゲーション・リスト (左上のペイン) 内のページの
いずれかの後に、単一文字のリスト (XXXXX や @@@@ など) があります
か? 』
–
136 ページの『Q-02. イメージおよび CSS 以外で 404 ステータス・コードに
なる要求はありますか? 』
–
136 ページの『Q-03. ページ・ロードの詳細にホーム・ページに対する複数の
要求または複数のリダイレクトがありますか? 』
–
136 ページの『Q-04. ロード中のグラフィックスがありますか、またはページ
の大きなセクションがブランクになっていますか? 』
136 ページの『S-03. UI エレメントがページ上に存在しますが、データが取り込
まれていません。後続の再生は機能しません。』
–
136 ページの『Q-01. ページ・ロードの詳細に、イメージおよび CSS 以外の
404 要求はありますか? 』
–
137 ページの『Q-02. ページ・ロードの詳細に、リダイレクトされる要求また
は空のデータを返す要求がありますか? 』
–
137 ページの『Q-03. ページ・ロードの詳細に、タイプが POST で元のサーバ
ーに対して要求されている、200 で完了している要求はありますか? 』
-
v
137 ページの『Q-03. いいえ: TLA に URL は存在しますか? 』
137 ページの『S-04. 再生時にページが表示されるが、すぐに 404 または明らか
に正しいものではない他のページに置き換えられる。』
–
137 ページの『Q-01. ページ・ロードの詳細に、複数のメインページ
(asp、jsp、html、htm、php などの拡張子が付いたページ) に対する要求が表示
されていますか? 』
© Copyright IBM Corp. 1999, 2014
133
v
138 ページの『S-05. ウィンドウ・コンテンツの一部が欠落している (グラフィッ
クのロード中であるか、明らかなブランク領域がページにある)。』
–
138 ページの『Q-01. ナビゲーション・リスト (左上のリスト) に、フォーマ
ット設定されていない HTML または正しく見えないデータが含まれている複
数の後続ページがありますか? 』
-
v
v
139 ページの『Q-02. ページ・ロードの詳細 (S-01 を参照) に、404 を返して
いる、タイプが POST の要求はありますか? 』
–
139 ページの『Q-03. ページ・ロードの詳細 (S-01 を参照) で、すべてが正し
く (404 なしで) 完了していて、ブランク領域にあるはずのコンテンツを表示
できるのにもかかわらず、(ナビゲーション・リストで) 別のページとして表示
されますか? 』
–
140 ページの『Q-04. 長方形の領域 (場合によっては、ブランクまたはメッセ
ージ入り) がページの一部をカバーしていますか? 』
–
140 ページの『Q-05. RSP を確認した (RSP ボタンを押した) ときに、有効な
HTML と思われるページ全体 (開始/終了 html タグ、body タグ、およびコン
テンツ) が存在するように見えますか? 』
141 ページの『S-06. JavaScript エラーを示すポップアップが出続けました。』
–
141 ページの『Q-01. デバッグするかどうかをポップアップで尋ねられますか?
』
–
141 ページの『Q-02. スクリプトの実行を続行するかどうかをポップアップで
尋ねられますか? 』
-
141 ページの『Q-01. はい: ポップアップで「アクセスが拒否されました」
と示されていて、かつ現在のページが HTTPS を使用していますか? 』
-
141 ページの『Q-02. はい: ポップアップで「アクセスが拒否されました」
と示されていますか? 』
-
142 ページの『Q-03. はい: ポップアップで「'x' が未定義です」と示されて
いますか? 』
143 ページの『S-07. RTV の再生速度が稼働中サイトより大幅に遅い』
143 ページの『Q-01. URL の一部を置き換えて (つまり、「my.site.com」を
「blocked」に変更して) URL をブロックしていますか? 』
144 ページの『S-08. 一部のクライアント UI イベントが再生されない』
–
134
138 ページの『Q-01. はい: 後続のページのコンテンツが、グラフィックが
ロード中の領域またはブランク領域のコンテンツであるようですか? 』
–
–
v
137 ページの『Q-01. はい: 初期ページ上にサブミット・ボタンまたは他の
ページ遷移ボタン (「次へ」など) がありますか? 』
144 ページの『Q-01. UI イベントがある時点までは再生されますか? 』
-
144 ページの『Q-01. はい: タイプが「Exception」の UI イベントがありま
すか? 』
-
144 ページの『Q-02. はい: クリックスルー時に、何かを実行するはずに見
えるイベントがページに影響を及ぼさないですか? 』
-
145 ページの『Q-03. はい: ページにフォーム・フィールドは含まれている
が、イベントが欠落しているように思われますか? 』
-
145 ページの『Q-04. はい: タイプが「change」の、失敗しているイベント
がナビゲーション・リストにありますか? 』
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
v
145 ページの『Q-05. はい: 壊れたイベントは、ナビゲーション・リストの
当該項目で「xpath」から開始していますか? 』
146 ページの『S-09. 再生がうまくいかないページがある。』
–
–
146 ページの『Q-01. 多数の意味のない (と思われる) 文字としてページが表
示されますか? 』
-
146 ページの『Q-01. はい: 表示するページに一致していない固有の照会ス
トリングまたは URL がページに含まれていますか? 』
-
146 ページの『Q-02. 表示するページにも一致する、同じ URL または照会
ストリングがすべてのページに含まれていますか? 』
146 ページの『Q-02. ページで Web ページの一部が表示されますか?』
-
146 ページの『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 章再生の問題のテーブル
135
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 を参照してください。
136
IBM Tealeaf CX: 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 章再生の問題のテーブル
137
恐らく、再生時に使用されている強調表示により、
ボタンでナビゲートされています。強調表示の際に
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. はい: 後続のページのコンテンツが、グラフィックがロード
中の領域またはブランク領域のコンテンツであるようですか?
はい:
138
IBM Tealeaf CX: 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 章再生の問題のテーブル
139
注: リリース 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/
140
IBM Tealeaf CX: 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 章再生の問題のテーブル
141
はい:
多くの場合、これは、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 を返しているファイルが元のサーバーに対して要求
されている場合、パスワードが保護されていてセッショ
ンなしで取得できないか、ファイアウォールの背後にあ
るなどブロックされているネットワーク状態になってい
ることを意味します。いずれの場合でも、このファイル
142
IBM Tealeaf CX: 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 章再生の問題のテーブル
143
ンツを要求できなかったり、パフォーマンスが低下したりす
る可能性があることを意味します。お客様は、再生の信頼性
を高めるために、内部インフラストラクチャーによって
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 エレメントの表示をトリガーす
144
IBM Tealeaf CX: 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 章再生の問題のテーブル
145
S-09. 再生がうまくいかないページがある。
Q-01. 多数の意味のない (と思われる) 文字としてページが表示されますか?
Q-01. はい: 表示するページに一致していない固有の照会ストリン
グまたは URL がページに含まれていますか?
はい:
それを右クリックし、「再生ルール」->「再生から
このページを削除」を選択できます。これにより、
この URL が含まれたすべてのページが削除される
ので注意してください。
Q-02. 表示するページにも一致する、同じ URL または照会ストリングがす
べてのページに含まれていますか?
はい:
固有の REQ 値を使用してそれらを削除する必要がありま
す。問題のページの 1 つで「要求」ボタンをクリックし、
必要のないページ内に存在するが必要なページ内に存在しな
い REQ の名前と値のペアを検索します。これの良い例とし
て、表示しない AJAX 要求を通常は示す
「HTTP_X_REQUESTED_WITH=XMLHttpRequest」が挙げら
れます。REQ でこれを強調表示し、「再生からこの要求値
を含むページを削除」を右クリックして選択します。これに
より、今後これらのページが非表示になります。
Q-02. ページで Web ページの一部が表示されますか?
Q-01. はい: ページはフレーム・セットの一部のように見えますか?
はい:
cxReveal エラー「スレッドは中止されつつありました。(Thread was
being aborted.)」
注: この問題は、リリース 7.1 以前からの IBM Tealeaf cxReveal に該当します。
Error
Source: sesnList.aspx.cs:line 119
Search:
Description: スレッドは中止されつつありました。(Thread was being aborted.)
このエラー・メッセージは、<Authentication> ノードを使用して認証を有効にする
ように IBM Tealeaf cxReveal spanelcfg.xml ファイルを構成していないことが原因
である可能性があります。
cxReveal データベースにあるセッションを再生できない
結果が IBM Tealeaf cxReveal 検索から返されたときに、セッションを再生できない
ことがあります。セッション・リストから再生するセッションを選択したときに、
ブラウザー・ベースの再生でセッションのロードに失敗することがあります。
146
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
セッションを取得できない理由として複数の理由が考えられますが、問題の原因
は、セッション・データ内の一部のタイム・スタンプである可能性があります。
ヒットが 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 詳しくは、 75 ページの『キャニスター・パフォーマンスの調整』を参照して
ください。
2. 1 時間の終わり近くに、管理者として処理サーバーにログインします。
3. TMS を使用して見つけたディレクトリーにナビゲートします。
4. ファイル名に 1970 のタイム・スタンプが含まれているファイルを見つけます。
ファイル名パターンは、以下のようなものです。
LSSN_19700101_<hostname>
5. 検索を使用して、このアーカイブからのセッションの取得を試行します。
v 「IBM Tealeaf cxReveal ユーザー・マニュアル」の『cxReveal - セッション属
性によるセッションの検索』を参照してください。
6. これらのセッションが見つかった場合、BBR を使用してセッションを再生し、
要求内のタイム・スタンプ値が破損した理由の確認を試行します。
v タイム・スタンプ情報は、要求の [timestamp] セクションに保管されます。
v これらの値について詳しくは、「IBM Tealeaf RealiTea Viewer ユーザー・マ
ニュアル」の『RealiTea Viewer - 要求ビュー』を参照してください。
第 5 章再生の問題のテーブル
147
148
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
第 6 章 Tealeaf 管理システムのトラブルシューティング
リリース 7.0 から、Tealeaf では、Tealeaf サーバー構成の集中管理が可能です。
Tealeaf ポータルを介して、Tealeaf 管理システム (TMS) を使用することで、管理者
は、1 つの中央の場所で構成の変更を行ってから、影響を受けるすべてのサーバー
にその変更をプッシュすることができます。TMS について詳しくは、「IBM
Tealeaf cxImpact 管理マニュアル」の『Tealeaf 管理システム』を参照してくださ
い。
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 証明書の有効期限が切れた
Tealeaf 管理サービス (TLMGmtSrv.exe) は、自己署名 TMS 証明書を使用して SSL
通信を行います。この TMS 証明書の有効期限が切れた場合は、別の自己署名証明
書、または信頼された認証局が発行した証明書に置き換えることができます。
PCA で openssl ユーティリティーを使用して秘密鍵を生成し、その秘密鍵を使用し
て自己署名 SSL 証明書を生成することができます。その後、TMS サービスが実行
されている IBM Tealeaf サーバーに、この証明書をコピーできます。
以下のステップを実行して、自己署名 SSL 証明書を生成します。
© Copyright IBM Corp. 1999, 2014
149
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 コマンドは、さまざまな値をたずねるプロンプトを対話式に表示し
ます。以下の表に、これらのプロンプトと応答例を示します。
表 3. openssl req コマンドの値の例
プロンプト
応答例
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]
5. cat コマンドを使用して 2 つのファイルを結合し、自身の秘密鍵を含む単一の
証明書を生成します。例えば、以下のようなコマンドを使用します。
cat TLMgmtSrvNoKey.crt TLMgmtSrv.key > TLMgmtSrv.crt
6. 置き換え対象の TMS 証明書がある Windows ベースの Tealeaf サーバーに、
PCA から新しい証明書ファイルを転送します。
新しい証明書の名前およびディレクトリーが、有効期限が切れた証明書の名前
(TLMgmtSrv.crt) およびディレクトリーと同じになるようにしてください。デフ
ォルトのロケーションは Tealeaf¥TLMgmtSrv¥SSL です。
150
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
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 ファイルで変更を保存します。
9. TMS マスター・サーバーで、$Tealeaf_Home¥Portal¥WebService に移動しま
す。
10. web.config ファイルを開き、<appSettings> セクションに以下のエントリーを
追加します。
<add key="TMS_USE_SSL" value="false"/>
以下のセクションは、web.config ファイルの <appSettings> セクションの例
です。
第 6 章 Tealeaf 管理システムのトラブルシューティング
151

<appSettings>
......
<add key="TMS_USE_SSL" value="false"/>
......
</appSettings>
11. web.config ファイルで変更を保存します。
12. マスター・サーバーで TMS と World Wide Web 発行サービスを再始動し、ス
レーブ・サーバーで TMS サービスを再始動して、変更を適用します。
アクセス
不明なマスターからの要求
スレーブ・サーバーの 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 アドレスです。
この場合、スレーブ・サーバーがマスターに接続するために使用しているアドレス
とは異なる IP アドレスを使用して、TMS マスターがスレーブ・サーバー上の
TMS に接続しようとしています。この不一致は、スレーブ・サーバー上での TMS
マスターの名前が異なる IP アドレスに解決される場合に発生することがありま
す。
この問題を修正するには、TMS マスターが通信に使用している名前として IP アド
レスを使用します。
1. スレーブ・サーバーにログインします。
2. コマンド・ライン・シェルを開きます。
3. Tealeaf インストール・ディレクトリーにナビゲートします。
4. 以下のコマンドを実行します。
TLMgmtSrv.exe -setmaster aaa.bbb.ccc.ddd
ここで、
v aaa.bbb.ccc.ddd は TMS マスターの IP アドレスです。
5. 影響を受ける各スレーブ・サーバーで上記ステップを繰り返します。
152
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
第 7 章 IBM Tealeaf の資料およびヘルプ
IBM Tealeaf には、ユーザー、管理者、および開発者用の資料とヘルプが備わって
います。
製品資料の表示
IBM Tealeaf 製品のすべての資料が、以下の Web サイトから入手できます。
https://tealeaf.support.ibmcloud.com/
以下の表の情報を使用して、IBM Tealeaf の製品資料を表示してください。
表 4. 入手、ヘルプ
表示対象
表示方法
製品資料
IBM Tealeaf ポータルで、「?」 > 「製品資
料」に移動します。
IBM Tealeaf ポータルのページのヘルプ
IBM Tealeaf ポータルで、「?」 > 「このペ
ージのヘルプ」に移動します。
IBM Tealeaf CX PCA のヘルプ
IBM Tealeaf CX PCA Web インターフェー
スで「ガイド」を選択して、「IBM Tealeaf
CX PCA マニュアル」にアクセスします。
IBM Tealeaf 製品の入手可能な資料
以下の表を使用して、すべての IBM Tealeaf 製品の入手可能な資料のリストを表示
します。
表 5. 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 リリース・ノート
© Copyright IBM Corp. 1999, 2014
153
表 5. IBM Tealeaf 製品の入手可能な資料 (続き)
IBM Tealeaf 製品
入手可能な資料
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 レポーティング・ガ
イド
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 ユーザー・マニュア
ル
154
IBM Tealeaf cxVerify
IBM Tealeaf cxVerify 管理マニュアル
IBM Tealeaf cxView
IBM Tealeaf cxView ユーザー・マニュアル
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
表 5. IBM Tealeaf 製品の入手可能な資料 (続き)
IBM Tealeaf 製品
入手可能な資料
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 の資料およびヘルプ
155
156
IBM Tealeaf CX: 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, 2014
157
本プログラムのライセンス保持者で、(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 は、これらのサンプル・プログラムについて信頼性、
利便性もしくは機能性があることをほのめかしたり、保証することはできません。
158
IBM Tealeaf CX: 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 は無効
にできますが、その場合、これらを有効にした場合の機能を活用することはできま
せん。
Cookie およびこれに類するテクノロジーによる個人情報の収集は、各国の適用法令
等による制限を受けます。この「ソフトウェア・オファリング」が Cookie および
さまざまなテクノロジーを使用してエンド・ユーザーから個人情報を収集する機能
を提供する場合、お客様は、個人情報を収集するにあたって適用される法律、ガイ
ドライン等を遵守する必要があります。これには、エンド・ユーザーへの通知や同
意取得の要求も含まれますがそれらには限られません。
IBM は、お客様がお客様のエンド・ユーザー (お客様の Web サイトの訪問者) に
対して次のことを実施されるようお勧めします。 (1) お客様の Web サイトの「ご
利用条件」(すなわち、「プライバシー・ポリシー」)へのリンクがはっきりと目に見
えるように提供されていること。そのリンクには、IBM へのリンク、および訪問者
に関するデータ収集と用途について説明したリンクが含まれていること。 (2) お客
様に代わって IBM が訪問者のコンピューター上にクッキーおよび明らかにそれと
分かる GIF/Web ビーコンを置き、そのテクノロジーの説明も一緒に表示することを
通知すること。 (3) お客様またはお客様に代わって IBM がクッキーおよび明らか
にそれと分かる GIF/Web ビーコンを置く前に、法律で必要とされる範囲の、訪問者
からの許諾を得ること。
特記事項
159
このような目的での Cookie を含む様々なテクノロジーの使用の詳細については、
IBMの『IBM オンラインでのプライバシー・ステートメント』
(http://www.ibm.com/privacy/details/jp/ja/) の『クッキー、ウェブ・ビーコン、その他
のテクノロジー』を参照してください。
160
IBM Tealeaf CX: Tealeafトラブルシューティング・ガイド
Printed in Japan

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

Comments

Description

Transcript

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