CVP SIPハートビートの設定とトラブルシューティング

要件

次の項目に関する知識があることが推奨されます。

• Cisco Unified Customer Voice Portal（CVP）

使用するコンポーネント

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

• Cisco Unified Customer Voice Portal(CVP)12.5
• Session Initiation Protocol（SIP）

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、初期（デフォルト）設定の状態から起動しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。

概要

サーバグループは、同じタイプの1つ以上の宛先IPアドレス（エンドポイント）で構成され、サーバグループドメイン名で識別されます。サーバグループは、SIPのエンドポイントにハートビートメカニズムを追加します。この機能により、コール制御でのフェールオーバーが高速化され、エンドポイントの障害による遅延が排除されます。

• CVP SIPサーバグループは、ハートビートメカニズムにSIP Options方式を使用します。
• OPTIONSを使用すると、ユーザエージェント(UA)は別のUAまたはプロキシサーバに機能について問い合わせることができます。これにより、クライアントはサポートされているメソッド、コンテンツタイプ、拡張機能、コーデックなどに関する情報を検出できます。相手を「呼び出し中」にしないで。
• ほとんどの実装では、SIP pingメカニズムとしてOPTIONSを使用します。SIP ping RFC

コンフィギュレーション

SIPエンドポイントでCVP SIPハートビートを有効にするには、次の手順を実行する必要があります。

ステップ1:OAMP Webページにアクセスします。

ステップ2:[System] -> [SIP Server Group] に移動します。

ステップ3：すでに追加したSIPサーバのリストを表示するか、新しいエンドポイントを追加します。

ステップ4:[Heartbeat Properties] タブに移動します。

ステップ5：次のように設定します。[Use Heartbeats to Endpoints] を有効にすると、デフォルト値が入力されます。

注：  SIPエラー(503 - Service Unavailable、480 - Temporarily Unavailable、600 - Busy)が静的3分のダウンタイムごとに発生します。アップおよびダウンエンドポイントハートビート間隔は、任意の2つのハートビートの間です。ただし、同じエンドポイントに対するハートビートの間ではありません。SIPサーバグループは特定の間隔でウェイクアップせず、すべての要素に対してハートビートを送信します。これは、このアプローチによってCPU使用率の問題が発生する可能性があるためです。また、多くのエンドポイントのハートビートを追跡するために、より多くのリソースが必要になります。

たとえば、すべてのSIPサーバグループの合計3つの要素が30000ms（30秒）の間隔で予防的にハートビートを各要素に送信するには、[エンドポイントハートビート間隔(Endpoint Heartbeat Interval)]を10000ms（10秒）に設定する必要があります。 現在ダウンしている要素は変動する可能性があるため、リアクティブモードでは確定的ではなく、ハートビート間隔も変動します。要素がUPのときにpingをオフにするには、UP間隔をゼロに設定します（リアクティブping）。 要素がダウンしたときにpingをオフにするには、ダウン間隔をゼロに設定します（プロアクティブping）。 要素がUPまたはDOWNのときにpingを実行するには、両方の間隔を0より大きい値に設定します（適応型ping）。

ステップ6:SIPサーバグループポート。また、SIPサーバグループハートビートが検出されなかったり、設定された宛先に対するsipオプションメッセージがWiresharkで表示されないことにも注意してください。

[Call Server SIP]タブの[Call Server SIP Subsystem]がポート5060でリッスンするように設定されている場合は、同じポートでリッスンするようにハートビートのSIPサーバグループを設定できません。異なるポートを指定する必要があります。

注：  問題は、ポートがすでにsipサブシステムまたはsipサーバグループハートビート用に設定されていることをユーザに通知したり、警告したりしないことです。SIPサーバグループハートビートオプションが機能せず、ログで通知する方法がありません。これは、SRVグループがアップまたはダウンの場合に関係なく、単にSRVグループをすべて緑色にマークします。これは、sipオプションメッセージが送信されないために、ユーザはサーバがすべてアップしていると考え、そうではない可能性があります。SIP Call ServerとSIP Server Groupハートビートのリスニングポートは、プロセスが異なるため、同じポートを2回使用することはできません。

ステップ7：ホストの上書き：リソース割り当て情報(RAI)ですか。ゲートウェイからRAIを使用する場合は、必ずゲートウェイのDeploy and Configure with the Trunk Utilization Feature with Customer Voice PortalのRAIグループにオーバーライドホストを関連付ける必要があります。

仕組み

SIPエンドポイントとCVPコールサーバ間のメッセージフローをデモンストレーションします。

Diagnostic

ステップ1：コールサーバの[Diag]ページに移動します。任意のブラウザhttps://<callserver-ip>:8000/cvp/diagを使用します。 

ステップ2:SIP、ICM、IVRの状態がサービス中であると想定されているが、ここでは部分的なサービスとして表示されていることを確認します。

ステップ3：いずれかのリンクを使用して、サービスの一部に関して発生したエラーを確認できます。

ステップ4:SIPトレースを有効にしてログを収集し、確認します。リンクをたどって、「CVP」の項を参照してください。

トラブルシュート

CVPによって生成されたSIP Optionsメッセージはログに表示されません。WSMでWiresharkトレースまたはキャプチャが必要です。

シナリオ 1

SIPサーバグループエンドポイントの1つが到達不能です。

通常は、CVPコールサーバのログから、Unreachableテーブルがtrueまたはfalseに設定されていることがわかります。

5: 10.201.224.41: Aug 19 2022 12:36:49.655 -0700: %CVP_12_5_SIP-6-SIP_INFO:  B2BUA using timeout=180  seconds for DsUnreachableDestinationTable [id:5000] 
58: 10.201.224.41: Aug 19 2022 12:36:50.827 -0700: %CVP_12_5_SIP-6-SIP_INFO:  Using property: DsUnreachableDestinationTableTimer=180 [id:5000] 
130: 10.201.224.41: Aug 19 2022 12:36:50.843 -0700: %CVP_12_5_SIP-6-SIP_INFO:  Using property: UseDsUnreachableDestinationTable=true [id:5000] 

Wiresharkから、次の情報を確認できます。

シナリオ 2

CVPログのメッセージ

14: 10.201.198.7: Sep 26 2021 01:21:25.988 -0500: %_ConnectionManagement-3-com.dynamicsoft.DsLibs.DsUALibs.DsSipLlApi.ConnectionManagement:  UnreachableDestinationTable - remove (10.201.198.21:5060:1). Current count: 3  
16: 10.201.198.7: Sep 26 2021 01:21:25.988 -0500: %_ConnectionManagement-3-com.dynamicsoft.DsLibs.DsUALibs.DsSipLlApi.ConnectionManagement:  UnreachableDestinationTable - remove (10.201.198.21:5060:2). Current count: 2  
18: 10.201.198.7: Sep 26 2021 01:21:25.988 -0500: %_ConnectionManagement-3-com.dynamicsoft.DsLibs.DsUALibs.DsSipLlApi.ConnectionManagement:  UnreachableDestinationTable - remove (10.201.198.21:5061:4). Current count: 1  
217: 10.201.198.7: Sep 26 2021 01:21:25.988 -0500: %CVP_12_5_SIP-6-SIP_INFO:  /10.201.198.21 endpointUnreachableClear com.dynamicsoft.DsLibs.servergroups.EndpointEvent[source=DEFAULT:10.201.198.21:5060:1 numTries=3] [id:5000] 

ハートビートが有効ではありません – CUCMサービスは使用できません

CUCMエンドポイントが3分間、到達不能テーブルに移動します。

推奨事項

• SIPハートビートの設定
• ログをチェックしてCUCMが送信する内容を確認し、このコード(Sip.properties)を無視します。
• レビュー：SIP.System.ExcludedCauseCodeFromUnreachableTable = 47,25
  

  503応答で到達不能なテーブルに追加された宛先は、さらにフィルタリングを行い、Reason-headerで送信される原因コードを生成します。修正により、SIP.propertiesにSIP.System.ExcludedCauseCodeFromUnreachableTable = 47,25というプロパティが追加されました。

  原因コードが着信する原因コードと一致する場合、宛先は到達不能テーブルに追加されません。
• レビュー：SIP.DsUnreachableDestinationTableTimer = 15
  

  到達不能テーブルタイマーは、SIP.Propertiesで設定できるようになりました。

  レビュー：CVP到達不能な宛先テーブルトラッキングの無効化：シスコ

注：  SIP.UseDsUnreachableDestinationTable = falseに設定すると、実際のSIPエンドポイントの停止や輻輳を検出できません。これは回避策です。問題の根本原因を調査するには、OPTIONSを追加します。