音声とユニファイド コミュニケーション : Cisco PGW 2200 ソフトスイッチ

PGW 2200 ソフトスイッチ: TAC ケースのトラブルシューティング情報の収集

2015 年 11 月 25 日 - 機械翻訳について
その他のバージョン: PDFpdf | 英語版 (2015 年 9 月 1 日) | フィードバック


目次


概要

Cisco Technical Assistance Center(TAC)でサービス リクエストをオープンするときには、問題を識別および修正しやすくするために予備情報が必要です。 この情報の一部は常に必要であり、他の情報は、問題の性質によって異なります。 サービス リクエストをオープンした後にエンジニアからこの情報を収集するように依頼された場合は、解決が遅くなります。 また、問題を十分に説明する必要があり、その時点で問題に陥った過程を示すコール フローを含める必要があります。 Message Definition Language(MDL)、スヌーパ、スニファおよびデバッグ情報の収集は、サービス リクエストをオープンするときにサービス リクエスト ノートに添付できます。

このドキュメントの第一の目的は、問題の種類に応じて必須の予備情報を指定します。 これによってエンジニアに情報をただちに送信できます。 第 2 の目的は、反復テストおよび同一のデータの再収集を回避するために TAC のための情報を収集する際の一般的なガイドラインを提供することです。

この文書は、Cisco PGW 2200 ソフトスイッチ(以前は SC 2200 および VSC 3000、または Cisco テレフォニー コントローラ)メディア ゲートウェイ コントローラ(MGC)ソフトウェアに基づいてデータおよび音声シグナリングのソリューションをサポートするシスコのお客様のためのものです。

前提条件

要件

サポート担当者は MGC ベースのソリューションやコンポーネントをよく知る必要があります。 詳細については、この資料の「関連情報」セクションで供給されるリンクを参照して下さい。

使用するコンポーネント

このドキュメントの情報は、次のソフトウェアのバージョンに基づくものです。

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されたものです。 このドキュメントで使用するすべてのデバイスは、クリアな(デフォルト)設定で作業を開始しています。 ネットワークが稼働中の場合は、コマンドが及ぼす潜在的な影響を十分に理解しておく必要があります。

表記法

ドキュメント表記の詳細は、『シスコ テクニカル ティップスの表記法』を参照してください。

基本情報

次の手順を実行します。

  1. 情報を収集する前に、mgcgrp のメンバとしてログインしていることを確認します。 これを行うには、id コマンドを発行します。

    http://www.cisco.com/c/dam/en/us/support/docs/voice-unified-communications/pgw-2200-softswitch/27580-collect-troubleshoot-info1.gif

  2. uname コマンドを発行して、UNIX バージョンを表示します。

    http://www.cisco.com/c/dam/en/us/support/docs/voice-unified-communications/pgw-2200-softswitch/27580-collect-troubleshoot-info2.gif

  3. prtconf コマンドを発行して、RAM のサイズを表示します。

    http://www.cisco.com/c/dam/en/us/support/docs/voice-unified-communications/pgw-2200-softswitch/27580-collect-troubleshoot-info3.gif

    RAM のサイズを判断するもう一つの方法は、uname コマンドを発行することです。

    http://www.cisco.com/c/dam/en/us/support/docs/voice-unified-communications/pgw-2200-softswitch/27580-collect-troubleshoot-info4.gif

  4. df コマンドを発行して、使用できる空きディスク容量を判断します。

    http://www.cisco.com/c/dam/en/us/support/docs/voice-unified-communications/pgw-2200-softswitch/27580-collect-troubleshoot-info5.gif

  5. 以前の手順で説明したコマンドの結果を保存し、> ./filename.txt コマンドまたは複数の添付ファイルの場合は >> ./filename.txt コマンドを使用して出力をファイルにリダイレクトします。

    NIC アクションのレイヤ 2 とレイヤ 3 に関する情報を収集するには、ifconfig および netstat コマンドを発行します。 この情報の一部はサービスリクエスト ノートの更新に必要です。

    http://www.cisco.com/c/dam/en/us/support/docs/voice-unified-communications/pgw-2200-softswitch/27580-collect-troubleshoot-info6.gif

  6. 作成された netinfo.txt ファイルを TAC エンジニアに送信する必要があります。 ファイルにリダイレクトされた出力を使った pkginfo コマンドを使用してパッチ レベルが検査されます。

    collect_troubleshoot_info7.gif

  7. 作成された patches-installed.txt ファイルを TAC エンジニアに送信する必要があります。 mml コマンドを発行して、稼働中の PGW 2200 ソフトウェア バージョンを確認します。

    collect_troubleshoot_info8.gif

  8. rtrv-ne-health コマンドを発行して、ネットワーク要素の健全性を確認します。 これは、リリース 9 で適用されます。

    collect_troubleshoot_info9.gif

Cisco PGW 2200 設定のエクスポート

ほとんどの場合、TAC が要求する現在の Cisco PGW 2200 ソフトスイッチ設定は設定エラーに対して分析するために使用されます。 この設定は、prov-rtrv:all コマンドの出力ではなく、 それは、使用されているプロビジョニング コマンドが表示されないためです。 その代わり、TAC は問題の再作成用の設定スクリプトまたはシステムの現在の *.dat ファイルのどちらかが必要です。

  1. 現在の設定をエクスポートして保存するには、prov exp: all コマンドを MML から発行します。

    作成された config-exported.tar ファイルを TAC エンジニアに送信する必要があります。

    http://www.cisco.com/c/dam/en/us/support/docs/voice-unified-communications/pgw-2200-softswitch/27580-collect-troubleshoot-info10.gif

  2. 現在の *.dat ファイルを保存するために、UNIX で tar アーカイブ ユーティリティを使用します。

    作成された config.tar ファイルをこのケースで作業している TAC エンジニアに送信する必要があります。

    http://www.cisco.com/c/dam/en/us/support/docs/voice-unified-communications/pgw-2200-softswitch/27580-collect-troubleshoot-info11.gif

TAC によって要求されるより詳細な情報

問題がこの段階で解決されない場合は、より多くの情報が必要です。 このセクションで説明されているログ メッセージおよびアラームでの情報を収集します。

  1. OS の Solaris のメッセージを確認してください。 ファイル messages と messages.x を、TAC エンジニアに送信する必要があります。

    http://www.cisco.com/c/dam/en/us/support/docs/voice-unified-communications/pgw-2200-softswitch/27580-collect-troubleshoot-info12.gif

  2. Cisco PGW 2200 ソフトスイッチ アプリケーションのメッセージを確認するために、tail コマンドを発行します。

    問題に関連するすべての platform.log ファイルを TAC エンジニアに送信する必要があります。

    http://www.cisco.com/c/dam/en/us/support/docs/voice-unified-communications/pgw-2200-softswitch/27580-collect-troubleshoot-info13.gif

  3. Cisco PGW 2200 ソフトスイッチ アラームを確認するために、rtrv-alms コマンドを発行します。

    http://www.cisco.com/c/dam/en/us/support/docs/voice-unified-communications/pgw-2200-softswitch/27580-collect-troubleshoot-info14.gif

    読み取り可能な日時を使った CLI からログ ファイルからのアラームを収集するには、次のように Perl で再処理のスクリプトを作成します(このスクリプトをカット アンド ペーストします)。

    alias rdalm 'perl -F, -anwe '\''print 
    unpack("x4 A15", localtime($F[1])),".$F[2]: @F[0,3..7]"'\'''

    Alarms ディレクトリ内への CD:

    cd /opt/CiscoMGC/var/spool
    

    次のコマンドを実行します。

    rdalm alm_yyymmdd* 

    yyyymmdd は関連している日付です。

  4. rtrv dest: all コマンドを発行し、基本 SS7 のネットワーク ステータスを確認します。

    http://www.cisco.com/c/dam/en/us/support/docs/voice-unified-communications/pgw-2200-softswitch/27580-collect-troubleshoot-info15.gif

コアダンプ

コアダンプがディレクトリ /opt/CiscoMGC/var の下にある場合は、pstack および pmap の 2 つの UNIX コマンドを Solaris 2.8 で実行し、サービスリクエスト ノートに出力を添付します。 また、サービスリクエスト ノートにコア ファイルをアップロードします。

注: Cisco では、次の他のツールでコア ファイルが解析されます。

Example : 
Under /opt/CiscoMGC/var 
<logging as root> 
#pstack <core_file> 
#pmap <core_file>

コールトレース

そのコールの「コール エンジン プロセスの状態」に対する PGW 2200 のより詳細なトレース オプションを与える「コール トレース」を依頼することを避けるために、MDL トレーサではそのコール用の TraceFile オブジェクトのコレクションを含むエンジンによって例示される C++ のオブジェクトが用意されています。 この MDL トレースは、PGW 2200 で問題が関係している場所の詳細情報を提供でき、ケースの処理中に利用することができます。 最適なシナリオは、問題が発生したときに可能な限り多くの情報をアップロードすることです。 実行するシナリオやソリューションに基づいて、次の項で詳しく説明されている情報を収集できます。

PGW 2200 MDL トレースの収集

この手順を使用して、MML コマンド STA-SC-TRC(トレースの開始)を介して MDL トレースを収集します。

Cisco PGW 2200 ソフトスイッチのどのバージョンを実行しているのかによって、詳細情報は次を参照してください。

  1. コールが発信される発信元の SS7 SigPath 番号または発信元の TrunkGroup 番号を識別します。

  2. 次のように、ログをローテートします。 /opt/CiscoMGC/bin/log_rotate.sh の下でスクリプトを実行します。

  3. MDL トレースを開始します。

    mml>sta-sc-trc:<ss7sigPath name | orig trunkgroup number>:CONFIRM
    
  4. テストを実行します(コールを発信してください)。

  5. MDL トレースの停止します。

     mml>stp-sc-trc:all
    
  6. 不正なコールのコール ID(C:)を識別します。

    このテスト コールがテスト環境で実行されている場合は、1 つの CALL_ID だけが表示されます。

    注: キャプチャが実稼働 PGW 上で実行されている場合は、これらのファイルには多くのコールからのトレースがすべてまとめて含まれる場合があります。 ファイルの各トレース レコードには、特定のレコード タイプおよびそのレコードに関連するタイプのレコードの情報があります。 各レコードには特定のコールに関連付けるコール ID があります。

  7. 読み取り可能な形式に MDL トレースを変換するには、次の手順を実行します。

    1. /opt/CiscoMGC/var/trace のディレクトリに移動します。

    2. 次のコマンドを実行します。

      get_trc.sh <trace file name>
      

      次に、例を示します。

      /opt/CiscoMGC/var/trace
      mgcusr@mgc-bru-20%get_trc.sh _ss7path_20040116103221.btr
          get_trc.sh ca/sim/sp Trace File Utility Mistral Version 1.2
          The ANALYSIS mdo file is:  GENERIC_ANALYSIS.mdo
          Retrieving _ss7path_20040116103221.btr trace file Call ID's, please wait...
          Enter one of the following commands:
          S = Simprint in less
          F = Simprint with printing of sent and received Fields in less
          D = Display trc trace in less
          G = Display trc trace in less (Generated)
          C = Convert to trc trace file
          A = Display CA file in less
          N = Move to Next call ID
          P = Move to Previous call ID
          L = List call ID's in current file
          X = Set SP flags
          H = Print Help
          Q = Quit get_trc.sh
          Or just enter the ID of the call you want if you know it
          Use (N)ext and (P)revious to move between the call ID's
          _ss7path_20040116103221.btr contains 1 call(s)
         ==> Working on call 1 ID 23 H = Help [S/F/D/G/C/A/N/P/L/H/Q/id]? 
  8. プロンプトでコール ID を入力し、不正なコールの MDL トレースに移動します。

  9. トレース ファイルに変換するには、オプション C を選択します。

    注: .btr ファイルは PGW のトレーサー機能によって生成されるバイナリ トレース ファイルです。 このファイル名の主要部分は VSC MML コマンド sta-sc-trc に指定されます。 PGW は、これらのファイルに常に .btr の拡張子を追加します。 C オプションを使用すると、このファイルはテキスト形式に変換され、拡張子が .trc のテキスト トレース ファイルになります。 これらには、ファイルを生成するためのシミュレーションのリプレイで実行される MDO コードからの行単位のトレース情報の詳細があります。 そのため、これらには MDL トレースが含まれます。

  10. トレース ファイルは /opt/CiscoMGC/var/trace にあります。

  11. /opt/CiscoMGC/var/log で platform.log 情報を収集します。 場合によっては、TAC エンジニアは、この TAC ケースが処理されている間に報告された問題に関係するその他の platform.log 情報についてたずねることができます。

HSI MDL トレースの収集

HSI MDL トレースを収集する方法の情報と手順については、『テクニカル サポート サービスの要求に対する HSI データ収集』を参照してください。

スヌーパ/スニファ トレースの収集

Cisco Packet Telephony Center モニタリングとトラブルシューティング(PTCMT)をインストールしているか古いバージョンのスヌーパを実行している場合、スヌーパ/スニファ トレースを収集するために次の手順を使用します。

  1. すべての Solaris プラットフォームでスヌープを実行します。

    1. UNIX のスヌープ情報を収集するために、superuser でログインしコマンド snoop -x42 -o snoop.log <IP address> を実行します。

    2. Ctrl + C キーを押してスヌープを終了します。

    3. サービスリクエスト ノートに snoop.log ファイルをアップロードします。

      注: このファイルが UNIX の snoop コマンドでキャプチャしたファイルであることをサービスリクエスト ノートに説明します。

  2. シスコのスヌーパ アプリケーションを実行します。

    1. Cisco スヌーパ情報を収集するために、superuser としてログインしコマンド ./snooper int INTERFACE PARMS LIST を実行するか、または完全な説明をしている ./snooper を実行できます。

    2. Nailed ソリューションについては、./snooper int hme'x' isdn ss7 rlm > snooper_int1 を実行します。ここで x はインターフェイス番号です。 ifconfig - a コマンドを発行しても、これを表示できます。 また、サービスリクエスト ノートに snooper_int1 ファイルをアップロードします。

    3. Switched ソリューションについては、./snooper int hme'x' mgcp ss7 eisup >snooper_int1 を入力します。ここで x はインターフェイス番号です。 ifconfig - a コマンドを発行しても、これを表示できます。 また、サービスリクエスト ノートに snooper_int1 ファイルをアップロードします。

    4. 2 個のインターフェイスからの出力をキャプチャする必要がある場合には、次のアプローチを使用してください。

      % ( snooper int hme0 rudp & ; sleep 1 ; snooper int hme1 rudp & ) >> test
      % ps -ef | grep snooper | grep -v grep
      root 10748 10737 1 20:52:54 pts/15 0:00 snooper int hme1 rudp
      root 10736 1 1 20:52:53 pts/15 0:00 snooper int hme0 rudp
      % tail -f test
  3. PTCMT を実行します。 詳細については、『Cisco Packet Telephony Center モニタリングとトラブルシューティング』を参照してください。

    PTCMT 情報を収集するために、superuser としてログインしコマンド ./ptcmt int INTERFACE PARMS LIST を実行するか、または完全な説明をしている ./snooper を実行できます。

    • Nailed ソリューションについては、./ptcmt int hme'x' isdn ss7 rlm > snooper_int1 を入力します。ここで x はインターフェイス番号です。 また、ifconfig - a コマンドを使用できます。 また、サービスリクエスト ノートに snooper_int1 ファイルをアップロードします。

    • Switched ソリューションについては、./ptcmt int hme'x' mgcp ss7 eisup >snooper_int1 を入力します。ここで x はインターフェイス番号です。 また、ifconfig - a コマンドを使用できます。 また、サービスリクエスト ノートに snooper_int1 ファイルをアップロードします。

ゲートウェイのデバッグ情報の収集

Nailed ソリューション [Ni2+] または Switched ソリューション [MGCP] を使用するかに基づいて、PGW 2200 とゲートウェイ間のデバッグ情報は報告された問題の詳細情報を提供できます。

  • Nailed ソリューションについては、debug isdn q931 コマンドを入力し、TAC ケースに詳細情報をアップロードします。

  • Switched solution ソリューションについては、debug mgcp packet コマンドを入力し、TAC ケースの詳細情報をアップロードします。

注: CPU の負荷が 60 パーセントを超えている間は、この debug コマンドは実行しないように注意してください。 これは、show proc cpu コマンドでチェックできます。 また、報告した問題に基づいて、その他の debug コマンドが TAC エンジニアから要求される場合があります。

注意 注意: コール トレースの収集はシステム パフォーマンスに影響を与え、コールが廃棄されることがあります。 ログ情報の収集についてわからない場合は、稼働中のシステムでのコール トレースは TAC エンジニアの要求があるときだけ行う必要があります。

システム データの収集

Cisco PGW 2200 ソフトスイッチ ソフトウェアはデータ収集のスクリプトを含んでいます。 このスクリプトを実行すると、システムのデータ スナップショットがログ ファイルに保存されます。 問題を発見した直後に対策を実行する前にこのスクリプトを実行する必要があります。 詳細については『Cisco TAC 用のシステム データ収集』を参照してください。

データ収集スクリプトを次に示します。

mssol-pgw-6% collectdata
the location of the log file is /opt/CiscoMGC/var/log/200806111552.mssol-pgw-6.log
mssol-pgw-6% ls -al /opt/CiscoMGC/var/log/200806111552.mssol-pgw-6.log
-rw-rw-r--   1 mgcusr   mgcgrp    266375 Jun 11 15:52 /opt/CiscoMGC/var/log/200806111552.mssol-pgw-6.log
mssol-pgw-6% more /opt/CiscoMGC/var/log/200806111552.mssol-pgw-6.log

簡易解析分析ツール

mini_parse.pl は、コール フローの詳細な分析を提供できるトレース ツールです。 このツールは /opt/CiscoMGC/bin フォルダにあります。 Mini-parse は、MDL トレース ファイル(.trc)に含まれるイベントの簡単なフロー図を提供します。 使用方法を次に示します。

mini_parse.pl [-d] [-b] [-i] [-m] [-s] <tracefile>

値は次のとおりです。

  • -d: 追加のメッセージのデコードを追加

  • b: 追加の B 番号分析情報を追加

  • m: メッセージだけを出力(内部信号なし)

  • i: 追加の IN 情報を追加

  • s: 状態遷移を追加

出力はファイルにリダイレクトできます。

コールごとのトレース

Cisco PGW 2200 ソフトスイッチ リリース 9.7(3) パッチ 8 以降を使用して詳細なコール トレースを実行できます。 詳細なコール トレースは、既存のコール トレース機能に基づいており、発信者番号、着信者番号、マシン輻輳レベル(MCL)設定、原因値、および通話時間がコール トレースの基準として追加されます。 この拡張機能によりコール トレースがより正確になり、Cisco PGW 2200 ソフトスイッチがコール トレースを実行したときの Cisco PGW 2200 ソフトスイッチのシステム パフォーマンスの影響を緩和します。

コール トレースを開始する方法については、『Cisco PGW 2200 ソフトスイッチ リリース 9 操作、メンテナンス、およびトラブルシューティング ガイド』の「コール トレースの開始(リリース 9.7(3) パッチ 8 上)」の項を参照してください。

関連するシスコ サポート コミュニティ ディスカッション

シスコ サポート コミュニティは、どなたでも投稿や回答ができる情報交換スペースです。


関連情報


Document ID: 27580