BAT および TAPS のトラブルシューティングの管理

この章では、Cisco Unified Communications Manager 一括管理（BAT）または Tool for Auto-Registered Phones Support（TAPS）の使用時に発生する可能性のある各種問題およびメッセージについて説明します。

設定ファイルを表示するためのトレースの有効化

Cisco Unified Communications Manager Serviceability の [サービス制御（Service Control）] ウィンドウで、トレースファイルの書き込み機能を有効にすることができます。

トレース ファイルを使用すると、ツールの機能上の問題を追跡することができます。 システムは、BAT および TAPS のトレース ファイルを、BAT および TAPS がインストールされているサーバに書き込みます。

BAT および TAPS トレース ファイルは、次のように表示されます。

bps<index number>.log

taps<index number>.log

ここで、<index number> の範囲は 1 ～ 250 です。

手順

ステップ 1

Cisco Unified Communications Manager Serviceability で、[トレース(Trace)] > [トレース設定(Trace Configuration)] の順に選択します。

[トレース設定(Trace Configuration)]ウィンドウが表示されます。

ステップ 2

[サーバ（Server）] ドロップダウン リスト ボックスから、 Cisco Unified Communications Manager のサーバを選択します。

ステップ 3

[設定済みサービス(Configured Services)] ドロップダウン リスト ボックスから次のサービスのいずれかを選択します。

  • BAT トレース ファイルの設定の場合は、[プロビジョニング サービス] を選択します。
  • TAPS トレース ファイルの設定の場合は、[TAPS Service] を選択します。

ステップ 4

トレース機能をアクティブにするには、[トレースを有効にする(Trace On)] チェックボックスをオンにします。

ステップ 5

[トレースフィルタ設定(Trace Filter Settings)] の [デバッグトレースレベル(Debug Trace Level)] ドロップダウン リスト ボックスから設定するトレース レベルを選択します。

次の表の説明を参照して、適切なデバッグ トレース レベルをクリックします。

表 1. デバッグ トレース レベル

レベル

説明

重大（Fatal）

アプリケーションの中止を引き起こす可能性がある非常に重大なエラー イベントをトレースします。

エラー（Error）

アラームの状態とイベントをトレースします。 異常なパスで生成されるすべてのトレースに使用します。 CPU サイクルの最小数を使用します。

警告（Warn）

有害な可能性のある状況をトレースします。

情報（Info）

多くのサーブレットの問題をトレースします。システム パフォーマンスへの影響は最小です。

デバッグ（Debug）

通常運用時に発生するすべての状態遷移条件とメディア レイヤ イベントをトレースします。

すべてのロギングをオンにするトレース レベルです。

ステップ 6

必要に応じて、[Cisco Bulk Provisioning Serviceトレースフィールド] チェックボックスと [トレース監視を基準としたデバイス名] チェックボックスをオンにします。

ステップ 7

[トレース出力設定(Trace Output Settings)] に、ファイルの最大数、ファイルごとの最大行数、およびファイルごとの最大分数の値を入力し、[更新(Update)] をクリックします。

機能が有効になり、トレース ファイルがサーバ上の次に示すロケーションに書き込まれます。
  • BAT トレース ファイル：/var/log/active/cm/trace/bps/log4j
  • TAPS トレース ファイル：/var/log/active/cm/trace/taps/log4j

ステップ 8

[更新(Update)] をクリックします。

次のタスク

トレース ファイルに含める情報を設定すると、リアルタイム監視ツール（RTMT）で trace および log central オプションを使用して、トレース ファイルを収集し、表示できます。 詳細については、『CiscoUnified Communications Manager Serviceability System Guide』を参照してください。

設定ファイルのトレースの無効化

Cisco Unified Communications Manager Serviceability の [サービス制御(Service Control)] ウィンドウで、トレース ファイルの書き込みを無効にすることができます。

手順

ステップ 1

Cisco Unified Communications Manager Serviceability で、[トレース(Trace)] > [トレース設定(Trace Configuration)] の順に選択します。

[トレース設定(Trace Configuration)]ウィンドウが表示されます。

ステップ 2

[サーバ（Server）] ドロップダウン リスト ボックスから、 Cisco Unified Communications Manager のサーバを選択します。

ステップ 3

[設定済みサービス（Configured Services）] ドロップダウン リスト ボックスから、[Cisco Bulk Provisioning Service] を選択します。

ステップ 4

トレース機能を非アクティブにするには、[トレースを有効にする(Trace On)] チェックボックスをオフにします。

ステップ 5

[更新(Update)] をクリックします。

この操作によって、機能が無効になります。

BAT ログ ファイル

BAT では、バルクトランザクションごとにログ ファイルが生成されます。 このログ ファイルにはレコードのキー値が表示されるので、管理者は容易にレコードを再検討できます。 電話機の MAC アドレスは、電話機の追加、更新、または変更時のキー値の役目を果たします。 ユーザが追加されるときには、ユーザー ID がキー値の役目を果たします。 BAT で作成した各ジョブのログ ファイルを表示するには、該当するジョブを表示し、[ログファイル名(Log File Name)] カラムのリンクをクリックします。 ポップアップ ウィンドウに、そのジョブのログ ファイルの詳細が表示されます。

ログ ファイルの名前には、実行された操作の内容、およびその操作が終了した時刻が示されます。

  • ログ ファイル名：ファイル名はジョブ ID を表します。ジョブ ID は、ジョブが送信されたときにシステムが作成する一意の識別子です。

  • タイムスタンプ：ログ ファイル名に含まれるタイムスタンプ形式は、mmddyyyyhhmmss です。

  • ログ ファイル名の形式は、jobid#timestamp.txt です。

BAT のトラブルシューティング

問題 この項では、発生する可能性があるシナリオやエラー メッセージについて説明し、解決するために必要な処置を示します。

管理ページに [一括管理(Bulk Administration)] メニューが表示されない

問題 Cisco Unified Communications Manager の管理ページに [一括管理(Bulk Administration)] メニューが表示されない。

考えられる原因 [一括管理(Bulk Administration)] メニューにアクセスできるのは、Cisco Unified Communications Manager の最初のノードだけです。

解決法 Cisco Unified Communications Manager の最初のノードにログインしていることを確認してください。

[一括管理(Bulk Administration)] のすべての機能にアクセスできない

問題 [一括管理(Bulk Administration)] のすべての機能にアクセスできない

考えられる原因 Cisco Unified Communications Manager の管理ページにログインした後は、[一括管理(Bulk Administration)] のすべてのウィンドウにアクセスできるわけではありません。

解決法 この問題は、User ID に適用される、アプリケーションへのアクセス制限によるものです。 システム管理者に問い合わせて、必要な権限の付与を依頼してください。

BAT.xlt ファイルで [BAT形式にエクスポート(Export to BAT Format)] ボタンが機能しない

問題 BAT.xlt ファイルで [BAT形式にエクスポート(Export to BAT Format)] ボタンが機能しない。

考えられる原因 BAT.xlt ファイルで [BAT形式にエクスポート(Export to BAT Format)] ボタンをクリックしても、何も実行されません。

解決法 ブランクのセルをクリックします。 カーソルがセル内のテキスト上にあるか、テキスト ボックス内にあるときには、ボタンが使用不可になっているように見える場合があります。

データを CSV 形式にエクスポートするときに、BAT の Excel スプレッドシートでコンパイル エラーが発生する

問題 データを CSV 形式にエクスポートするときに、BAT の Excel スプレッドシートでコンパイル エラーが発生する

考えられる原因 使用している Microsoft Excel のバージョンを確認します。 Excel 97 を使用している場合に、BAT.xlt で問題があったことが報告されています。

解決法 Microsoft Excel 2000 以降のバージョンを使用してください。

BAT の Excel スプレッドシートが操作に反応しない

問題 BAT の Excel スプレッドシートが操作に反応しない

考えられる原因 BAT の Excel スプレッドシートが、行の追加などの操作に応答しません。

解決法 BAT の Excel スプレッドシートを開くときに、[マクロを有効にする] オプションが選択されていることを確認します。BAT.xlt のマクロを有効化する手順は、次のとおりです。

  1. BAT.xlt を開きます。
  2. [メニュー] > [ツール] > [マクロ] > [セキュリティ] へ移動します。
  3. [セキュリティ レベル] を [中] に設定します。
  4. BAT.xlt を閉じ、再び開きます。 プロンプトが表示されたら、[マクロを有効にする] を選択します。

データ ファイル（CSV）形式が電話テンプレートやサンプル ファイルに一致しない

問題 データ ファイル（CSV）形式が電話テンプレートやサンプル ファイルに一致しない。

考えられる原因 データ ファイル内の回線数は、BAT 電話テンプレートで設定された回線数以下である必要がありますが、そのようになっていません。 たとえば、電話テンプレートに 3 回線があり、これらのうち回線 1、2、3 が設定されているとします。 この場合、3 つ以下の回線が設定された電話機データ ファイルを使用する必要があります。 「1111, 2222, 4444」は、Line1-1111、Line2-2222、Line3-none、Line4-4444 となります。

解決法 使用する予定の BAT 電話テンプレートを調べてください。 CSV データ ファイルに指定される回線数は、BAT 電話テンプレートで設定された回線数を超えてはなりません。 また、CSV データ ファイルで指定するスピード ダイヤル数は、使用する予定の BAT 電話テンプレートの最大スピード ダイヤル数を超えないようにしてください。

アップロードした CSV ファイルが [ファイル名(File Name)] ドロップダウン リスト ボックスに表示されない

問題 アップロードした CSV ファイルが [ファイル名(File Name)] ドロップダウン リスト ボックスに表示されない

考えられる原因 [ファイルのアップロード(File Upload Configuration)] ウィンドウを使用して Cisco Unified Communications Manager サーバにアップロードした CSV ファイルが、さまざまな操作の [ファイル名(File Name)] ドロップダウン リスト ボックス フィールドに表示されません。 たとえば、電話機を挿入するための CSV ファイルを、[一括管理(Bulk Administration)] メニューの [ファイルのアップロード/ダウンロード(Uploading/Downloading)] メニュー オプションを使用してアップロードした場合、そのファイルが、[電話の挿入(Insert Phone Configuration)] ウィンドウの [ファイル名(File Name)] ドロップダウン リスト ボックスにオプションの 1 つとして表示されません。

解決法 このファイルが正しい機能用にアップロードされていることを確認してください。 前の例では、電話機のすべての詳細の挿入用のファイルをアップロードしましたが、CSV ファイルは実際には、電話機の特定の詳細の挿入用です。

[ファイルのアップロード/ダウンロード(Upload/Download Files)] メニュー オプションからファイルを削除し、正しい機能にアップロードしてください。

スケジュールした時刻が経過してもジョブの状態が待機中のままになっている

問題 スケジュールした時刻が経過してもジョブの状態が待機中のままになっている

考えられる原因 ジョブが特定の時刻に実行されるようにスケジュールしています。 しかし、スケジュールされている時刻を過ぎても、ジョブは待機状態のままです。

解決法 以下の詳細を確認してください。

  1. Cisco Bulk Provisioning Service（BPS）が起動していること。
  2. 処理中状態のジョブが他にないこと。 BPS は、一度に 1 つのジョブしか処理できません。
  3. BPS トランザクションで処理の停止が要求されているかどうか。 要求されている場合は、[ジョブスケジューラ(Job Scheduler)] ウィンドウに移動し、[ジョブのアクティブ化(Activate Job)] をクリックします。

ジョブが保留状態のままになっている

問題 ジョブが保留状態のままになっている

考えられる原因 ジョブと必要なすべてのデータを送信した後に、このジョブが [ジョブスケジューラ(Job Scheduler)] ウィンドウに保留状態で表示されます。 このようなジョブは実行されません。

解決法 保留状態のジョブをアクティブ化してから、BPS で実行する必要があります。 [ジョブスケジューラ(Job Scheduler)] ウィンドウに移動し、手順に従ってジョブをアクティブ化してください。

ジョブが [ジョブの検索/一覧表示(Find and List Jobs)] ウィンドウに表示されない

問題 ジョブが [ジョブの検索/一覧表示(Find and List Jobs)] ウィンドウに表示されない

考えられる原因 ジョブと必要なすべてのデータを送信したら、[一括管理(Bulk Administration)] > [ジョブスケジューラ(Job Scheduler)] の順に選択します。 スケジュールしたジョブの適切な検索条件を入力し、[検索(Find)] をクリックします。 ジョブは検索結果に表示されません。 [ジョブの検索/一覧表示(Find and List Jobs)] ウィンドウの [検索オプション(Search Options)] 領域の 3 番目のドロップダウン リスト ボックスで、[非表示(Hide)] が選択されているかどうかを確認します。 このオプションでは、完了したすべてのジョブが非表示になります。 送信したジョブがすでに完了している場合、そのジョブは [検索結果(Search Results)] 領域に表示されません。

解決法 [ジョブの検索/一覧表示(Find and List Jobs)] ウィンドウで 3 番目のドロップダウン リスト ボックスから [表示(Show)] を選択し、もう一度 [検索(Find)] をクリックします。 これで、完了したジョブも検索結果に表示されます。

ポート番号がテンプレートに設定されていない

問題 ポート番号がテンプレートに設定されていない

考えられる原因 CSV ファイルにはポート番号が指定されていますが、対応するポートが BAT テンプレートに設定されていません。

解決法 BAT テンプレートで、CSV ファイルで指定したポートを設定してください。

ダミー MAC アドレスの値を指定しようとしても、MAC アドレスの値がファイルで許可されない

問題 ダミー MAC アドレスの値を指定しようとしても、MAC アドレスの値がファイルで許可されない

考えられる原因 この CSV ファイルには、MAC アドレスが入っています。 MAC アドレスが CSV ファイル内のいずれかの行に含まれている場合、ダミー MAC アドレスは指定できません。

解決法 ダミー MAC アドレスを使用する場合は、MAC アドレスを指定していないレコードだけが入っている、新しい CSV ファイルを作成してください。 または別の方法として、CSV ファイルで MAC アドレスを指定し、[ダミーMACアドレスの作成(Create Dummy MAC Address)] チェックボックスをオフにしてください。

BAT.xlt スプレッドシートが Microsoft Excel XP（Office XP）で機能しない

問題 BAT.xlt スプレッドシートが Microsoft Excel XP（Office XP）で機能しない。

考えられる原因 Office XP に付属している Microsoft Excel では、マクロ セキュリティがデフォルトで高に設定されています。 この設定のため、BAT.xlt 内のマクロを実行できず、BAT.xlt が使用不可になります。

解決法 BAT.xlt 内のマクロを使用できるようにするには、次の手順を実行します。

  1. BAT.xlt を開きます。
  2. [メニュー] > [ツール] > [マクロ] > [セキュリティ] へ移動します。
  3. [セキュリティ レベル] を [中] に設定します。
  4. BAT.xlt を閉じ、再び開きます。 プロンプトが表示されたら、[マクロを有効にする] を選択します。

[電話の移行-SCCPからSIP(Migrate Phones - SCCP TO SIP)] ウィンドウを使用して、SCCP 電話機を SIP に移行する要求を送信した後も、モデル 7940 と 7960 が SCCP 電話機として表示される

問題 [電話の移行-SCCPからSIP(Migrate Phones - SCCP TO SIP)] ウィンドウを使用して、SCCP 電話機を SIP に移行する要求を送信した後も、Cisco Unified IP Phone のモデル 7940 と 7960 が SCCP 電話機として表示される。

解決法 この問題を解消するには、移行後、個々の電話機の電源を再投入（電源を一度オフにしてからオンに）します。


（注）  

Cisco Unified IP Phone（7911、7941、7961、7970、および 7971 の各モデル）の場合、移行アクティビティが正常に機能した後で電話機が SIP として登録されます。

選択したファイル形式にレコードが一致していない

問題 選択したファイル形式にレコードが一致していない

考えられる原因 MS Excel で、最後の列をブランクにして CSV ファイルを作成すると、MS Excel では、行 15 の後に来る最後の列にカンマを追加できません。このエラーは、このような CSV ファイルがいずれかの BAT 操作に使用されると発生します。

解決法 CSV ファイルの最後の列をブランクにする場合は、次の手順を実行します。

  1. 解決法 CSV ファイルを作成するときに、最後の列にダミー値を入力します。

  2. 解決法 CSV ファイルを保存して閉じます。

  3. 解決法 保存した CSV ファイルをテキスト エディタまたはメモ帳で開きます。

  4. 解決法 ダミー値をブランク値で置き換え、保存します。

BAT.xlt が Microsoft Excel 2007 で互換モードで稼働する

問題 BAT.xlt が Microsoft Excel 2007 で互換モードで稼働する

考えられる原因 Excel のテンプレート bat.xlt は Microsoft Excel 2003 のファイルです。 このファイルを Microsoft Excel 2007 で開くと、ファイルは互換モードで開きます。 互換モードでは、Excel のテンプレートが Microsoft Excel 2003 のファイルとして動作し、Microsoft Excel 2007 の機能は使用できません。

解決法 BAT.xlt が標準モードであることを確認します。 Bat.xlt を開き、[ファイル] > [名前を付けて保存] を選択し、[Excel マクロ有効ブック] をクリックします。 ファイルの名前を入力し、[保存] をクリックします。 bat.xlt を閉じ、保存したファイル（名前を付けて保存したファイル）を開きます。

BAT パフォーマンスのトラブルシューティング

バルク トランザクションは、トラフィックの少ない時間帯に送信することをお勧めします。 Unified Communications Manager が大量のコールを処理しているときに BAT ファイルを最初のノード データベースに挿入すると、BAT トランザクションが低速になることがあります。 実際に、Unified Communications Manager によるコールの処理に悪影響を及ぼすことがあります。

ファイルあたりのレコード数が 12000 未満になるようにファイルのサイズを制限すると、BAT パフォーマンスが向上する場合があります。

また、BAT ファイルを最初のノード データベースに挿入するに当たり、Unified Communications Manager のノード サーバで動作する TFTP サービスを予め停止することにより、BAT パフォーマンスが改善することがあります。 挿入トランザクションが完了したら、TFTP サービスを再起動する必要があります。

手順

ステップ 1

[Cisco Unifiedサービスアビリティ] ウィンドウで、[ツール] > [コントロール センター - 機能サービス] を選択します。

ステップ 2

Unified CM Service リストから、対応するオプション ボタンをクリックして Cisco TFTP を選択します。

ステップ 3

[Stop] をクリックし、[OK] をクリックします。

（注）  

 

挿入トランザクションが完了したら、TFTP サービスを再起動する必要があります。 同じ手順によって、[Start] をクリックしてサービスを再起動します。

BAT および TAPS のトラブルシューティング

原則として、TAPS が使用されていない場合は、TAPS サービスを停止することをお勧めします。 サービスを停止すると TAPS を不必要に使用することを防止でき、CPU 時間を多少節約することもできます。

Tool for Auto-Registered Phones Support ログ ファイルの表示

TAPS は、TAPS ログ ファイルごとに 1 行の情報を生成します。

TAPS ログ ファイルを表示するには、[一括管理(Bulk Administration)] > [TAPS] > [TAPSログファイルの表示(View TAPS Log File)] の順に選択します。

Tool for Auto-Registered Phones Support のエラー メッセージ

Cisco UCCX サーバで TAPS を実行しているときに、次の現象が発生する場合があります。

TAPS ルート ポイント番号をダイヤルすると、ビジー トーンが聞こえる

問題 TAPS ルート ポイント番号をダイヤルすると、ビジー トーンが聞こえる

考えられる原因 ビジー トーンにより、TAPS の最大同時セッション数に達したことが示されます。 TAPS の最大セッション数は、UCCX 設定で TAPS アプリケーションに割り当てられているポート数と同じです。

解決法 この状況を防止するには、Cisco UCCX で TAPS アプリケーションに割り当てられているポート数を増やす必要があります。

CiscoUCCX サーバが起動すると、JTAPI サブシステムにサービスの一部が表示されるか、サービスが使用できない。

問題 CiscoUCCX サーバが起動すると、JTAPI サブシステムにサービスの一部が表示されるか、サービスが使用できない。

考えられる原因 Cisco Unified Communications Manager または Cisco UCCX サーバ内の設定に問題があるために、この現象が発生しています。

解決法 問題が解決するまで、次のステップを順に実行してください。

  • Cisco Unified Communications Manager が起動していることを確認します。

  • Cisco UCCX サーバで JTAPI が使用可能になっていることを確認します。

  • UCCX サーバ上の JTAPI バージョンが、Cisco Unified Communications Manager にインストールされている JTAPI と同じバージョンであることを確認します。

  • Cisco Unified Communications Manager 上でルート ポイントと CTI ポートが正しく設定されていることを確認します。

  • JTAPI ユーザに対して [CTIからのデバイスの制御を許可(Allow control of device from CTI)] チェックボックスがオンになっていることを確認します。これは、Cisco Unified Communications Manager の管理ページのユーザ ウィンドウで確認できます。

  • CTI Manager サービスが起動していることを確認します。

  • ポートとルート ポイントが、Cisco Unified Communications Manager ユーザ設定でユーザに関連付けられていることを確認します。

    さらにトラブルシューティングを行うには、Cisco UCCX サーバの MIVR ログ ファイルを収集して調査します。