内容

はじめに

前提条件

要件

使用するコンポーネント

背景説明

電話サービスが接続されていないエラー

Broadworksトークンがダウンロードできない

失敗したConfig-wxt.xmlダウンロードシーケンス

Config-wxt.xmlの読み取りまたは解析ができない

Config-wxt.xmlの取得に成功した後のサービス検出の問題

クライアントが検出されたSBCへのSIP接続の確立に失敗する

関連情報

はじめに

このドキュメントでは、Webex for Broadworksクライアントがパートナーの電話サービスに接続できない場合のシナリオとトラブルシューティング手順について説明します。

前提条件

要件

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

- Webexエラーコード

- Session Initiation Protocol（SIP）

- セッションボーダーコントローラ(SBC)

- 完全修飾ドメイン名(FQDN)

使用するコンポーネント

このドキュメントの内容は、特定のソフトウェアやハードウェアのバージョンに限定されるものではありません。

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

背景説明

サインインに成功しても、電話サービスの登録が失敗する可能性があります。クライアントログは通常、原因を示唆します。このガイドでは、BWKS電話サービスに接続できない場合の一般的なエラーと解決策について説明します。

このガイドでは、より頻繁に発生するエラーの一部のみを取り上げます。WebexのBroadworks電話サービスの接続の問題を調査する方法を提案します。また、潜在的なエラーをすべて包括的に理解するために、特定のログまたはドキュメントを参照することの重要性にも焦点を当てています。

注：ユーザがログインすると、デスクトップクライアントがSIPセッションを確立します。モバイルデバイスは、コール中にオンデマンドでSIPセッションを設定します。セッション開始におけるこれらの違いを除けば、デスクトップクライアントとモバイルクライアントは同じであり、トラブルシューティング手順は両方に等しく適用されます。

電話サービスが接続されていないエラー

電話サービスは、次のような特定の条件下で接続解除されることがあります。

1. BroadWorksスコープが構成されていません。

2. BroadWorksトークンをダウンロードできません。

3. config-wxt.xmlダウンロードシーケンスに失敗しました。

4. config-wxt.xmlを読み取ることも解析することもできません。

5. config-wxt.xmlの取得に成功した後のサービス検出の問題。

6. クライアントは、検出されたどのSBCへのSIP接続の確立にも失敗します。

Broadworksトークンをダウンロードできない

ログにエラーが見つかりました：

Error: errorCode=1502

Error 1000:1502

Http error when trying to get BWC Token from Broad Cloud, httpStatusCode:

HTTP request failed

これは、BroadWorksトークンの取得に問題があることを示しています。

この問題はさまざまな理由で発生します。調査を開始するポイントを次に示します。

- この問題は、HTTP要求から受信したコンテンツが正しくないか、HTTP要求自体が失敗したことが原因である可能性があります。

- AuthService設定に問題がある場合。

- WAN/LANの問題

- 認証の問題

次に、設定ミスが原因でBroadworks AuthServiceがトークンを発行しない場合のログ抽出の例を示します。

--- Try to retrieve the BWC token using the teams token

2024-02-02 12:02:22.498 9619 9771 D WBX_TEAMS-ucf: tid[0x261f] BroadWorksTokenManager.cpp::130 operator():BWC:SCF: Get a BWC token using the teams token endpoint

--- The /bwtoken/fetch has been sent

2024-02-02 12:02:22.501 9619 9771 D WBX_TEAMS-ucf: tid[0x261f] BroadWorksTokenManager.cpp::158 operator():BWC:SCF: Created BWC token request with ID: [Redacted]. Tracking ID=[Redacted]

...

...

2024-02-02 12:02:22.503 9619 9771 D WBX_TEAMS-ucf: tid[0x2622] HttpRequestManagerEx.cpp::1112 makeHttpRequestWithProxy:newnet: httpRestRequest: https://[Redacted]/, with TID: [Redacted]

...

...

2024-02-02 12:02:22.503 9619 9771 I WBX_TEAMS-ucf: tid[0x2622] HttpRequestManagerEx.cpp::1914 logRequest:{"id":"newnet: Making HTTP request","uri":"https://[Redacted]/","method":"GET","action":"/[Redacted]/api/v1/idp/bwtoken/fetch","defaultUrl":"https://[Redacted]/","currentUrl":"https://[Redacted]/","retryable":false,"trackingId":"[Redacted]","cancellationId":"[Redacted]"}

--- This request fails with 401

2024-02-02 12:02:24.183 9619 9771 D WBX_TEAMS-ucf: tid[0x26de] HttpRequestManagerEx.cpp::186 operator():newnet: httpRestRequest: Got HTTP Error, trackingID=[Redacted]

2024-02-02 12:02:24.183 9619 9950 I WBX_TEAMS: [[Redacted]] OkHttpEventListener.kt::215 logMetrics:{"callId":"[Redacted]f","timings":{"DNS":0,"Connect":0,"TX":0,"RX":1,"Total":385},"size":{"TX":0,"RX":127},"phaseStart":{"DNS Start":0,"Connect Start":0,"TX Start":1,"RX Start":384},"protocol":"HTTP\/2","localPort":[Redacted]}

2024-02-02 12:02:24.184 9619 9771 D WBX_TEAMS-ucf: tid[0x26de] HttpRequestManagerEx.cpp::260 operator():newnet: httpRestRequest: Processing Response, trackingID=[Redacted]

2024-02-02 12:02:24.184 9619 9771 D WBX_TEAMS-ucf: tid[0x26de] HttpRequestManagerEx.cpp::304 operator():newnet: httpRestRequest: HTTP request failed, trackingID=[Redacted]

2024-02-02 12:02:24.184 9619 9771 W WBX_TEAMS-ucf: tid[0x26de] HttpRequestManagerEx.cpp::1512 convertNotSuccessResponse:newnet: Reporting telemetry for error: 401

...

...

2024-02-02 12:02:24.184 9619 9771 D WBX_TEAMS-ucf: tid[0x26de] BroadWorksTokenManager.cpp::176 handleGetBwcTokenCallbackResponse:BWC:SCF: Response from BWC auth server: 401

2024-02-02 12:02:24.184 9619 9771 E WBX_TEAMS-ucf: tid[0x26de] BroadWorksTokenManager.cpp::206 handleGetBwcTokenCallbackResponse:BWC:SCF: Http error when trying to get BWC Token from Broad Cloud, httpStatusCode: 401

2024-02-02 12:02:24.184 9619 9771 E WBX_TEAMS-ucf: tid[0x26de] BroadWorksTokenManager.cpp::58 operator():BWC:SCF: Failed to get a new broadcloud token

この例では、AuthServiceは401応答を返しました。他のHTTPエラーでも同じ問題が発生します。

失敗したConfig-wxt.xmlダウンロードシーケンス

ログにエラーが見つかりました：

errorCode=1505

error code: 1511

errorCode=1504

ConfigDownload - failed with error code:

ConfigDownload - the device profile 'Business Communicator - PC' is not found.

これは、confit-wxt.xmlファイルがクライアントによって取得できないことを示します。

この問題は、複数の問題が原因で発生する可能性があります。 調査を開始するポイントを次に示します。

- 正しいアイデンティティ/プロファイルタイプが存在し、User > Call Control > Shared Call Appearanceでユーザに適用されていることを確認します。

- デスクトップ：Business Communicator - PC。

- мモバイル：Connect - Mobile。

- タブレット用：接続 – タブレット

- 新しいWebexリリースごとに、関連するデバイスタイプアーカイブファイル(DTAF)を使用していることを確認します。

- ユーザのプライマリプロファイルフラグが有効になっていることを確認します。

プライマリ回線ポートを確認することもできます。

1. Group > Resources > Identify/Device Profile > Searchの順に移動します。

2. ID/デバイスプロファイル名を選択します。

3. 「ユーザー」タブを選択します。

4. 「検索」を選択します。

5. プライマリ回線/ポートをチェックします。

次にログの抽出例を示します。

2024-01-17T08:03:53.711Z <Error> [0xd678] BroadWorksConfigDownloader.cpp:169 BroadWorksConfigDownloader::onAccessDeviceListSucceeded:BWC:SCF: ConfigDownload - the device profile 'Business Communicator - PC' is not found.

Config-wxt.xmlの読み取りまたは解析ができない

ログにエラーが見つかりました：

errorCode=1507

failed to parse the configuration

failed to register client.

これは、クライアントがconfig-wxt.xmlを正常にダウンロードしたが、読み取ることができなかったことを示します。 これは通常、符号化の問題が原因です。 調べるには、関連するクライアントプロファイルのdefaultDeviceEncodingを確認します。

次にログの抽出例を示します。

2024-01-30T07:01:25.213Z <Info> [0x390] parser.rl:232 TP::Xml::Parser::parse:BWC:INTERNAL: Incomplete

2024-01-30T07:01:25.213Z <Info> [0x390] BroadWorksCallControl.cpp:493 BroadWorksCallControl::createConfig:BWC:SCF: failed to parse the configuration

...

...

2024-01-30T07:19:10.077Z <Error> [0x45c] BroadWorksManager.cpp:781 BroadWorksManager::registerClient::<lambda_367b7b02ffeb826e6e6a25aafb052a78>::()::<lambda_f7b7c2330cd9b6c4719bd5256940e122>::operator ():BWC:SCF: BroadWorks Calling - failed to register client. errorCode=1507

2024-01-30T07:19:10.078Z <Error> [0x45c] BroadWorksLoginAdapter.cpp:452 BroadWorksLoginAdapter::handleLoginError:BWC:SCF: Login error occurred: errorCode=1507

Config-wxt.xmlの取得に成功した後のサービス検出の問題

ログにエラーが見つかりました：

onServiceDiscoveryCompleted:BWC:INTERNAL: ConnectManager: Filtered addresses (0)

これは、サービス検出中にSBCが検出されなかったことを示します。

調査を開始するポイントを次に示します。

- ログを詳細にレビューして、サービス検出で関連する情報が返されているかどうかを確認します。

- サービス検出プロセスで見られるエラーを探します。

- レジスタへの応答を確認します。

次に、ログの抽出例を示します。

適切なサービス検出：

--- 2 SBC's were discovered, SBC details logged immediately after

2024-02-01T01:53:33.975Z <Info> [0x5840][]connect_manager_impl.cpp:1462 bwc::ConnectManagerImpl::onServiceDiscoveryCompleted:BWC:INTERNAL: ConnectManager: Service discovery completed, discovered addresses (2):

2024-02-01T01:53:33.975Z <Info> [0x5840][]connect_manager_impl.cpp:1466 bwc::ConnectManagerImpl::onServiceDiscoveryCompleted:BWC:INTERNAL: { naptr: "", service: "SIP+D2U", srvptr: "[Redacted]", hostName: "[Redacted]", verifyName: "[Redacted]", address: "[Redacted]", port: 5060, priority: 1, weight: 50, order: 65535, preference: 0, ttl: 390 }, survivability: 0

2024-02-01T01:53:33.975Z <Info> [0x5840][]connect_manager_impl.cpp:1466 bwc::ConnectManagerImpl::onServiceDiscoveryCompleted:BWC:INTERNAL: { naptr: "", service: "SIP+D2U", srvptr: "[Redacted]", hostName: "[Redacted]", verifyName: "[Redacted]", address: "[Redacted]", port: 5060, priority: 2, weight: 50, order: 65535, preference: 0, ttl: 1162 }, survivability: 0

サービスの検出が正しくありません：

--- 0 SBC's were discovered

2024-02-01T01:57:38.387Z <Info> [0x5840][]connect_manager_impl.cpp:1462 bwc::ConnectManagerImpl::onServiceDiscoveryCompleted:BWC:INTERNAL: ConnectManager: Service discovery completed, discovered addresses (0):

クライアントが検出されたSBCへのSIP接続の確立に失敗する

ログにエラーが見つかりました：

SIP disconnected due to timeout or socket error

No more SBC addresses to try. Going offline

ConnectManager: SIP connect failed

これは、クライアントがSBCとの接続を確立できなかったことを示します。

これは、タイムアウトまたは接続要求の拒否が原因である可能性があります。

調査を開始するポイントを次に示します。

- ログを詳細にレビューして、SCCへの接続試行から意味のあるエラーが返されているかどうかを確認します。

- 接続時に表示されるエラーを探します。

- 登録要求に対する応答を確認します。

次に、ログの抽出例を示します。

次の例は、両方のSBCへの接続を試行するタイムアウトを順番に示しています。

--- 2 SBC's were discovered

2024-02-01T01:53:33.975Z <Info> [0x5840][]connect_manager_impl.cpp:1462 bwc::ConnectManagerImpl::onServiceDiscoveryCompleted:BWC:INTERNAL: ConnectManager: Service discovery completed, discovered addresses (2):

2024-02-01T01:53:33.975Z <Info> [0x5840][]connect_manager_impl.cpp:1466 bwc::ConnectManagerImpl::onServiceDiscoveryCompleted:BWC:INTERNAL: { naptr: "", service: "SIP+D2U", srvptr: "[Redacted]", hostName: "[Redacted]", verifyName: "[Redacted]", address: "[Redacted]", port: 5060, priority: 1, weight: 50, order: 65535, preference: 0, ttl: 390 }, survivability: 0

2024-02-01T01:53:33.975Z <Info> [0x5840][]connect_manager_impl.cpp:1466 bwc::ConnectManagerImpl::onServiceDiscoveryCompleted:BWC:INTERNAL: { naptr: "", service: "SIP+D2U", srvptr: "[Redacted]", hostName: "[Redacted]", verifyName: "[Redacted]", address: "[Redacted]", port: 5060, priority: 2, weight: 50, order: 65535, preference: 0, ttl: 1162 }, survivability: 0

--- Tries to register SIP with 1st SBC

2024-02-01T01:53:33.976Z <Info> [0x5840][]connect_manager_impl.cpp:1055 bwc::ConnectManagerImpl::connectSip::<lambda_1>::operator ():BWC:INTERNAL: ConnectManager: Network is available. Try to connect SIP, address={ naptr: "", service: "SIP+D2U", srvptr: "[Redacted]", hostName: "[Redacted]", verifyName: "[Redacted]", address: "[Redacted]", port: 5060, priority: 1, weight: 50, order: 65535, preference: 0, ttl: 390 }, survivability: 0

--- SIP registration fails

2024-02-01T01:53:34.159Z <Debug> [0x5840][]sip_session.cpp:889 bwc::SipSession::disconnected:BWC:INTERNAL: SipSession: disconnected

2024-02-01T01:53:34.159Z <Debug> [0x5840][]sip_registrations.cpp:30 TP::Sip::Utils::RegistrationPtr::~RegistrationPtr:BWC:INTERNAL: RegistrationPtr destroyed

2024-02-01T01:53:34.159Z <Info> [0x5840][]connect_manager_impl.cpp:1827 bwc::ConnectManagerImpl::onSipDisconnected:BWC:INTERNAL: ConnectManager: SIP is disconnected, exiting=false

2024-02-01T01:53:34.159Z <Info> [0x5840][]connect_manager_impl.cpp:1856 bwc::ConnectManagerImpl::onSipDisconnected:BWC:INTERNAL: ConnectManager: SIP connection is needed, we need to reconnect

2024-02-01T01:53:34.159Z <Info> [0x5840][]connect_manager_impl.cpp:1875 bwc::ConnectManagerImpl::onSipDisconnected:BWC:INTERNAL: ConnectManager: SIP disconnected due to timeout or socket error

--- Fail over to 2nd SBC (

2024-02-01T01:53:35.421Z <Info> [0x5840][]connect_manager_impl.cpp:1055 bwc::ConnectManagerImpl::connectSip::<lambda_1>::operator ():BWC:INTERNAL: ConnectManager: Network is available. Try to connect SIP, address={ naptr: "", service: "SIP+D2U", srvptr: "[Redacted]", hostName: "[Redacted]", verifyName: "[Redacted]", address: "[Redacted]", port: 5060, priority: 2, weight: 50, order: 65535, preference: 0, ttl: 1162 }, survivability: 0

--- 2nd SIP registration fails

2024-02-01T01:53:35.635Z <Debug> [0x5840][]sip_session.cpp:889 bwc::SipSession::disconnected:BWC:INTERNAL: SipSession: disconnected

2024-02-01T01:53:35.635Z <Debug> [0x5840][]sip_registrations.cpp:30 TP::Sip::Utils::RegistrationPtr::~RegistrationPtr:BWC:INTERNAL: RegistrationPtr destroyed

2024-02-01T01:53:35.635Z <Info> [0x5840][]connect_manager_impl.cpp:1827 bwc::ConnectManagerImpl::onSipDisconnected:BWC:INTERNAL: ConnectManager: SIP is disconnected, exiting=false

2024-02-01T01:53:35.635Z <Info> [0x5840][]connect_manager_impl.cpp:1856 bwc::ConnectManagerImpl::onSipDisconnected:BWC:INTERNAL: ConnectManager: SIP connection is needed, we need to reconnect

2024-02-01T01:53:35.635Z <Info> [0x5840][]connect_manager_impl.cpp:1875 bwc::ConnectManagerImpl::onSipDisconnected:BWC:INTERNAL: ConnectManager: SIP disconnected due to timeout or socket error

2024-02-01T01:53:35.635Z <Info> [0x5840][]BroadWorksCallControl.cpp:4624 BroadWorksCallControl::onOffline:BWC:SCF: onOffline

--- No more SBC's to try, SIP connect failed, client shows Phone services disconnected error

2024-02-01T01:53:36.672Z <Info> [0x5840][]connect_manager_impl.cpp:1148 bwc::ConnectManagerImpl::failOver:BWC:INTERNAL: ConnectManager: No more SBC addresses to try. Going offline.

2024-02-01T01:53:36.672Z <Info> [0x5840][]connect_manager_impl.cpp:2003 bwc::ConnectManagerImpl::onConnectFailed:BWC:INTERNAL: ConnectManager: SIP connect failed.

関連情報

- シスコのテクニカルサポートとダウンロード