المقدمة
يوضح هذا المستند بعض السيناريوهات وخطوات أستكشاف الأخطاء وإصلاحها عند فشل Webex لعميل Broadworks في الاتصال بخدمات هاتف الشريك.
المتطلبات الأساسية
المتطلبات
توصي Cisco بأن تكون لديك معرفة بالمواضيع التالية:
- رموز خطأ Webex
- بروتوكول بدء جلسة عمل (SIP)
- وحدة التحكم في حد جلسة العمل (SBC)
- اسم المجال المؤهل بالكامل (FQDN)
المكونات المستخدمة
لا يقتصر هذا المستند على إصدارات برامج ومكونات مادية معينة.
تم إنشاء المعلومات الواردة في هذا المستند من الأجهزة الموجودة في بيئة معملية خاصة. بدأت جميع الأجهزة المُستخدمة في هذا المستند بتكوين ممسوح (افتراضي). إذا كانت شبكتك قيد التشغيل، فتأكد من فهمك للتأثير المحتمل لأي أمر.
معلومات أساسية
حتى في عمليات تسجيل الدخول الناجحة، يمكن أن يفشل تسجيل خدمة الهاتف. تشير سجلات العميل عادة إلى السبب. يغطي هذا الدليل الأخطاء والحلول الشائعة عند فشل الاتصال بخدمات هاتف BWKS.
يتناول هذا الدليل فقط مجموعة من الأخطاء التي تتم مواجهتها بشكل متكرر. ويقترح طرق للتحقيق في مشاكل اتصال خدمة الهاتف ل Broadworks ل Webex. ويبرز هذا الدليل أيضا أهمية الاطلاع على سجلات أو وثائق محددة من أجل التوصل إلى فهم شامل لجميع الأخطاء المحتملة.
ملاحظة: يقوم عميل سطح المكتب بإنشاء جلسة SIP عند تسجيل الدخول، بينما يقوم الجهاز المحمول بإعداد جلسة SIP عند الطلب (أثناء المكالمة). وبصرف النظر عن هذه الفروق في بدء جلسة العمل، فإن عملاء أجهزة الكمبيوتر المكتبية والأجهزة المحمولة هم نفس الفروق الأخرى، وتنطبق إجراءات أستكشاف الأخطاء وإصلاحها على كليهما بشكل متساو.
خطأ في اتصال خدمات الهاتف
يمكن قطع اتصال خدمات الهاتف في ظل ظروف معينة مثل:
- لم يتم تكوين نطاق BroadWorks.
- يتعذر تنزيل الرمز المميز ل BroadWorks.
- فشل تسلسل التنزيل config-wxt.xml.
- لا يمكن قراءة config-wxt.xml أو تحليله.
- مشاكل اكتشاف الخدمة بعد الاسترداد الناجح config-wxt.xml.
- فشل العميل في إنشاء اتصال SIP تجاه أي SBC مكتشفة.
يتعذر تنزيل الرمز المميز ل 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 لا يصدر الرمز المميز بسبب misconfiguration.
--- 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 غير قابل للاسترداد بواسطة العميل.
قد يرجع هذا إلى مشاكل متعددة. فيما يلي بعض النقاط التي يتعين بدء التحقيقات فيها:
- تأكد من وجود الهوية/نوع ملف التعريف الصحيح وأنه مطبق على المستخدم تحت المستخدم > التحكم في المكالمات > مظهر المكالمة المشتركة:
- لسطح المكتب: Business Communicator - PC.
- ل Mobileм: Connect - Mobile.
- بالنسبة للكمبيوتر اللوحي: الاتصال - الكمبيوتر اللوحي.
- تأكد من إستخدام ملف أرشيف نوع الجهاز (DTAF) ذي الصلة مع كل إصدار WebEx جديد.
- تأكيد تمكين علامة ملف التعريف الأساسي للمستخدم.
أنت يستطيع أيضا فحصت الأساسي خط ميناء:
1. انتقل إلى مجموعة > موارد > تعريف/ملف تعريف الجهاز > بحث.
2. حدد اسم تعريف/ملف تعريف جهاز.
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
[0x5840][]connect_manager_impl.cpp:1462 bwc::ConnectManagerImpl::onServiceDiscoveryCompleted:BWC:INTERNAL: ConnectManager: Service discovery completed, discovered addresses (0):
فشل العميل في إنشاء اتصال SIP تجاه أي SBCs مكتشفة
الأخطاء التي تم مشاهدتها في السجلات:
SIP disconnected due to timeout or socket error
No more SBC addresses to try. Going offline
ConnectManager: SIP connect failed
يشير ذلك إلى عدم قدرة العميل على إنشاء اتصال مع SBC.
قد يكون ذلك بسبب انتهاء المهلة أو رفض طلبات الاتصال.
فيما يلي بعض النقاط التي يتعين البدء في التحقيق فيها.
- قم بمراجعة السجلات عن كثب لمعرفة ما إذا كانت هناك أي أخطاء ذات معنى تم إرجاعها من محاولات الاتصال ب "مجلس التنسيق".
- ابحث عن أي أخطاء تظهر أثناء الاتصال.
- تحقق من الاستجابة لطلب التسجيل.
فيما يلي مثال على مقتطفات السجل.
يوضح هذا المثال حالات انتهاء المهلة الزمنية التي تحاول الاتصال بكل من بروتوكولات 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.
معلومات ذات صلة