دليل أستكشاف أخطاء دفاتر هاتف TMS وإصلاحها

المقدمة

يصف هذا المستند كيفية أستكشاف أخطاء المشاكل المختلفة وإصلاحها باستخدام كتب هواتف مجموعة إدارة TelePresence (TMS) من Cisco.

المتطلبات الأساسية

المتطلبات

توصي Cisco بأن تكون لديك معرفة بالمواضيع التالية:

• Cisco TMS
• نقاط النهاية لنظام TelePresence من Cisco
• خدمات معلومات الإنترنت (IIS) من Microsoft

المكونات المستخدمة

تستند المعلومات الواردة في هذا المستند إلى إصدارات البرامج والمكونات المادية التالية:

• Cisco TMS الإصدار 14.x و 15.x
• نقاط النهاية للبرامج TC و CE

تم إنشاء المعلومات الواردة في هذا المستند من الأجهزة الموجودة في بيئة معملية خاصة. بدأت جميع الأجهزة المُستخدمة في هذا المستند بتكوين ممسوح (افتراضي). إذا كانت شبكتك مباشرة، فتأكد من فهمك للتأثير المحتمل لأي أمر.

المنتجات ذات الصلة

هذا وثيقة يستطيع أيضا كنت استعملت مع هذا جهاز وبرمجية صيغة:

• Cisco TelePresence Endpoints MX-Series، C-Series، SX-Series، EX-Series، أجهزة مجموعة الغرفة، و MXPs
• فيديو Jabber للتواجد عن بُعد من Cisco (Movi)

معلومات أساسية

يمكن الوصول إلى دفاتر هاتف TMS باستخدام HTTP أو HTTPS استنادا إلى البروتوكول الذي تم تمكينه في IIS على خادم Microsoft Windows. يجب إضافة النظام في TMS للحصول على دفتر الهاتف (دليل الشركة). أما بالنسبة للأنظمة الأحدث، فإن البحث في دفتر الهاتف هو اتصال مباشر ولا يتم تخزين البيانات على النظام. يجب أن يكون TMS قيد التشغيل ويجب أن يقبل الاتصالات حتى تعمل دفاتر الهاتف.

أدلة دفتر هواتف TMS

دليل عمومي

الدليل العمومي هو ملف مخزن على برنامج الترميز حيث لا يمكن تغيير الإدخالات عبر جهاز التحكم عن بعد. يتم إرسال الملف بواسطة HTTP/HTTPs إلى جميع نقاط النهاية التي تشترك في دفتر هاتف واحد أو أكثر في Cisco TMS. تم دمج العديد من كتب الهواتف في دفتر هاتف واحد. إذا احتوت على أكثر من 400 مدخل، فإن ال 400 الأولى فقط تظهر على نقطة النهاية.

يتم إرسال الملف إلى نقطة النهاية على الفواصل الزمنية المعينة في حقل الأدوات الإدارية > التكوين > الإعدادات العامة > تكرار تحديث كتب الهاتف.

يعمل هذا فقط على نقاط النهاية التي تدعم globalDir.prm (غير مدعوم على نقاط نهاية برامج TC أو CE).

دليل الشركة

دليل الشركة عبارة عن خدمة XML على خادم Cisco TMS تسمح لنقطة النهاية باسترداد دفاتر الهاتف مباشرة من الخادم في كل مرة يتم فيها الضغط على زر دفتر الهاتف الموجود على نقطة النهاية. إنها تسمح بتسلسل هرمي لكتب الهاتف وأرقام الهاتف المتعددة في كل مدخل. كما يمكن البحث في دليل الشركة.

أنواع دفتر هاتف النظام

انتقل إلى أدوات إدارية > تكوين > إعدادات عامة لتحديد نوع دفتر هاتف النظام. يمكنك:

• إستخدام دفاتر هواتف TMS المركزية فقط (دفتر هواتف الشركة)
• إستخدام كل من كتب الهاتف المركزية والمحمولة (كلاهما)
• إستخدام دفاتر الهواتف العمومية التي تم تنزيلها إلى الأنظمة فقط (دليل الهاتف العمومي)

توصي Cisco باختيار دفتر هاتف الشركة أو كليهما، لأن دفتر الهاتف الذي تم تنزيله مدعوم فقط بنقاط نهاية Tandberg القديمة.

الإعداد الافتراضي هو كلاهما، مما يجعل الدليل العمومي متاحا في حالة فشل البحث المباشر في دليل الشركة.

المنافذ المستخدمة لدفاتر هواتف TMS

تقوم نقاط النهاية بالوصول إلى خدمة دفتر الهاتف TMS باستخدام المنفذ 80 (HTTP) أو المنفذ 443 (HTTPs). تحقق من السماح بهذه المنافذ على جدار حماية Microsoft Windows Server وأي جدار حماية على الشبكة قد يكون موجودا في المسار.

تكوين خادم دفتر هاتف نقطة النهاية

بمجرد إضافة نظام إلى TMS، يجب أن يتلقى مجموعة من إعدادات الإدارة تحتوي على عنوان الملاحظات، وعنوان الإدارة الخارجية، وعنوان دفتر الهاتف. يمكن التحقق من العنوان الموجود على النظام من واجهة ويب للنظام، xAPI (xConfiguration //phoneBook)، أو من واجهة المستخدم الموجودة على النظام.

يتم تحديد العنوان الذي تم دفعه إلى نقطة النهاية بواسطة ما يتم تكوينه في TMS في الأدوات الإدارية > التكوين > إعدادات الشبكة ضمن إعدادات الشبكة المتقدمة للأنظمة على شبكة LAN الداخلية. إذا تم تكوين حقل عنوان IPv4 لخادم TMS وتم تكوين اسم المضيف المؤهل بالكامل لخادم TMS الحقل فارغ، ثم يتم إستخدام عنوان IP، ولكن إذا تم ملء كلا الحقلين، فيفضل اسم المجال المؤهل بالكامل (FQDN) ويستعمل.

عند التحقق من عنوان URL لدفتر الهاتف، من المهم ملاحظة ما إذا كان <TMSaddress> عبارة عن FQDN أو عنوان IP. إذا كانت FQDN، فيجب أن تحتوي نقطة النهاية أيضا على خادم اسم مجال (DNS) صالح تم تكوينه. إذا لم يتم تكوين DNS على نقطة النهاية، فلن يتمكن من حل FQDN من أجل إسترداد دفاتر الهواتف. ارجع إلى قسم تكوين DNS لنقطة النهاية للخطوات للتحقق من DNS.

ملاحظة: تأكد من صحة عنوان IP. في بعض الأحيان قام العملاء مؤخرا بنقل TMS من خادم إلى آخر، لديهم TMS مختبر آخر، أو قد توجد TMS مخادعة.

تحقق من العنوان باستخدام واجهة الويب

ضمن واجهة الويب لنقطة النهاية، انتقل إلى التكوين > تكوين النظام > خادم دفتر الهاتف. تحقق من صحة إعدادات دفتر الهاتف. والأهم من ذلك، يجب أن يطابق عنوان URL هذا التنسيق: http://<TMSaddress>/tms/public/external/phonebook/phonebookservice.asmx.

تحقق من العنوان باستخدام القشرة الآمنة (SSH)

فيما يلي كيفية التحقق من العنوان باستخدام SSH:

xConfiguration //phonebook
*c xConfiguration Phonebook Server 1 ID: "default"
*c xConfiguration Phonebook Server 1 Type: TMS
*c xConfiguration Phonebook Server 1 URL: "http://<TMSaddress>/tms/public/external/
phonebook/phonebookservice.asmx"

إختبار طلب دفتر الهاتف من نقطة النهاية

الطريقة الأسرع لتحديد الاتصال هي أن يدخل SSH إلى نقطة النهاية باستخدام بيانات اعتماد المسؤول وقم بتشغيل الأمر التالي:

نوع دفتر الهاتف الخاص بالبحث في xcommand: شركة

في سيناريو العمل، سيؤدي ذلك إلى إرجاع واحدة من نتيجتين، اعتمادا على عدد الدفاتر الصوتية المعينة إلى نقطة النهاية.

إذا كان هناك كتاب صوتي واحد:

إذا تم تطبيق كتب هاتفية متعددة، فإن النتيجة ستتضمن بدلا من ذلك مجلدات دفتر الهاتف:

سيقوم هذا الأمر أيضا بتحديد أي مشاكل في الاتصال. على سبيل المثال:

• في حالة عدم تعيين أي دفاتر هاتفية إلى نقطة النهاية في TMS:

• إذا تعذر الاتصال بخدمة دفتر الهاتف:

في حالة وجود مشكلة في تكوين المصادقة في IIS على الخادم الذي يستضيف TMS:

إذا أشرت إلى 'http أو https://<TMSFQDN>/tms/public/external/phonebook/phonebookservice.asmx.' فستظهر لك إذا كانت هناك مشكلة محتملة في تحليل DNS:

التحقق من تكوين DNS لنقطة النهاية

تحقق من تكوين DNS باستخدام SSH

تحقق من تكوين DNS باستخدام واجهة الويب

ضمن واجهة الويب لنقطة النهاية، انتقل إلى تكوين > تكوين النظام > الشبكة.

تحديد ما إذا كانت خدمة دفتر الهاتف قابلة للوصول

من كمبيوتر مستخدم، أكمل الخطوات التالية:

1. ضمن نقطة النهاية، انتقل إلى التكوين > تكوين النظام > خادم دفتر الهاتف، وانسخ عنوان URL لدفتر هاتف TMS الذي تم تكوينه على نقطة النهاية.
   
   
2. لصق عنوان URL في نافذة المستعرض.
   
   

   

   
   
   إذا رأيت الصفحة الموضحة في الصورة، فهذا يعني أنه يمكن الوصول إلى خدمة دفتر الهاتف. إذا لم تظهر هذه الصفحة، فتحقق من أن الكمبيوتر الذي تقوم باختباره ليس لديه أية قيود على الشبكة للوصول إلى العنوان.
   
   إذا رأيت وجود غير مصرح به، فقد تكون هناك مشكلة في IIS، والتي ستتم مناقشتها بشكل أكبر في هذا المستند.

من جذر نقطة النهاية، أدخل:curl http://<TMS IP address>/tms/public/external/phonebook/phonebookservice.asmx

دليل هاتف TMS ومصدر دفتر الهاتف

جميع دفاتر هواتف TMS تم بناؤها من مصادر الهواتف المحمولة.

انتقل إلى كتب الهاتف > إدارة مصادر دفتر الهاتف من أجل إدارة مصادر دفتر الهاتف.

تتألف مصادر دفتر هواتف TMS حاليا من:

• نقطة نهاية Cisco TMS
• قائمة يدوية
• خدمة Active Directory
• دليل H.350 ودليل مستخدم H.350
• دفتر هاتف مستند إلى ملف
• بواب
• دفتر هاتف TMS آخر
• دليل إعداد Cisco TMS
• دفتر الهاتف المحلي للنظام
• Cisco TMS-Managed Cisco Unified CM

بمجرد إنشاء مصدر دفتر هاتف، تقوم بتوصيله بكتاب هاتف. دفتر الهاتف الذي تقوم بتوصيل المصدر ليكون دفتر الهاتف الذي تقوم بضبطه على الأجهزة. يمكنك توصيل عدة كتب هاتفية بمصادر متعددة لكتاب الهاتف

التحقق من تعيين جهات الاتصال ودفتر الهاتف على النظام

التحقق من جهات الاتصال

تحقق من مصدر دفتر الهاتف وتأكد من وجود جهات الاتصال وطرق الاتصال.

تحقق من أن دفتر الهاتف متصل بمصدر دفتر الهاتف وتأكد من وجود نفس جهات الاتصال وطرق الاتصال. دفتر الهاتف الذي تقوم بتوصيل المصدر ليكون دفتر الهاتف الذي تقوم بضبطه على الأجهزة.

ملاحظة: يمكنك الاطلاع على نقاط النهاية وفيديو Jabber للتواجد عن بعد (Movi) في دليل الهاتف، وليس في مصدر دفتر الهاتف. كونوا متيقظين للاختلافات بين الاثنين.

تعيين دفتر الهاتف على النظام

تأكد من تعيين دفاتر الهاتف على النظام. انتقل إلى كتب الهاتف > إدارة كتب الهاتف > حدد دفتر الهاتف وحدد تعيين على الأنظمة.

تظهر قائمة بالأنظمة في الجانب الأيمن ضمن أنظمة محددة.

فيديو Jabber للتواجد عن بعد (Movi) وكتب الهاتف

ملاحظة: يجب مصادقة العميل من أجل تلقي دفاتر الهواتف. يجب أن تكون منطقة VCS/Expressway التي يتم فيها التسجيل هي التحقق من بيانات الاعتماد أو التعامل معها على أنها مصادقة.

يتلقى المستخدمون دفتر الهاتف من خلال سلسلة VCS/Expressway وليس من TMS. 

التحكم في الوصول

يجب منح مجموعات الحسابات التحكم بالوصول إلى دفتر الهاتف من أجل البحث فيه.

حتى إذا تم التحقق من المستوى الأعلى، قم بتوسيعه، وتحقق من تحديد المستويات الفرعية. في حالة عدم تلقي المستخدمين الجدد لكتب الهاتف، فمن الممكن أن يكونوا جزءا من مجموعة جديدة لا يتم تحديدها ضمن علامة التبويب "التحكم بالوصول".

توفير التكوين

1. في أنظمة TMS > إمداد > مستخدمين، تحقق من تكوين نمط عنوان الفيديو.
   
   

   

   
   
   
2. تحقق من قالب التكوين المعين إلى فيديو Jabber لمستخدم TelePresence (Movi) لتكوين URI لخادم دفتر الهاتف.
   
   

   

تكرار الإدخالات

كن حذرا إذا قمت بتوصيل كتب هاتف متعددة بدفتر هاتف واحد، لأن ذلك قد يؤدي إلى ظهور الإدخالات المكررة على نقاط النهاية أو مع عميل Jabber Video للتواجد عن بعد (Movi) إذا كانت المصادر المتصلة تحتوي على نفس إدخالات دفتر الهاتف.

توجيه دفتر الهاتف

كن على علم بهذا الإعداد في حالة عدم حصول بعض نقاط النهاية على بعض إدخالات دفتر الهاتف التي تظهر في نقاط النهاية الأخرى.

في الأدوات الإدارية > التكوين > الإعدادات العامة، يوجد إعداد يسمى إدخالات دفتر هاتف المسار. نعم هو الإعداد الافتراضي، مما يعني أن نقاط النهاية تعرض العناوين التي يمكن طلبها فقط. على سبيل المثال، على نقطة نهاية H.323-only، لا يتم عرض أرقام ISDN وعناوين بروتوكول بدء الجلسات (SIP). لا تعني أن نقاط النهاية تعرض كل العناوين والأرقام في دفتر الهاتف بغض النظر عن إمكانيات الطلب الخاصة بها.

401 غير مصرح به - أستكشاف أخطاء IIS وإصلاحها

يرجع أحد أكثر مشاكل دفتر الهاتف شيوعا إلى سوء تكوين IIS. يجب تمكين المصادقة المجهولة للمجلد العمومي في IIS لنقاط النهاية لتتمكن من إسترداد دفاتر الهاتف. في حالة عدم تمكين هذا الخيار، يتم اعتراض نقاط النهاية للمصادقة التي لا يمكن توفيرها.

لتحديد ما إذا تم اعتراض نقطة النهاية للمصادقة، SSH في نقطة النهاية والاستعلام عن دفتر الهاتف باستخدام دفتر ملاحظات البحث الصوتي xcommand: الشركة. إذا تم اعتراض نقطة النهاية للمصادقة، فسترى '<Authentication Fail>' (رمز HTTP=401) كما هو موضح في هذه الصورة.

التحقق من إعدادات IIS

1. افتح جلسة عمل لبروتوكول سطح المكتب البعيد (RDP) باستخدام خادم TMS.
   
   
2. افتح مدير IIS .
   
   
3. توسيع موقع ويب الافتراضي.
   
   
4. توسيع TMS.
   
   
5. حدد عام.
   
   
6. تحديد
   
   

   

   
   
   

   

   
   
   
7. تحقق من تمكين المصادقة المجهولة، وقم بتمكين إذا لم تكن موجودة بالفعل.

إستخدام التقاط الشبكة

تحليل بيانات دفتر الهاتف في Wireshark

يبدأ البحث في دفتر الهاتف بطلب بحث إلى خدمة دفتر الهاتف على TMS التي تستجيب TMS لها وتتضمن نتيجة البحث في الاستجابة في حالة عمل كل شيء.

يمكنك تشغيل التتبع على خادم TMS أو على نقطة النهاية إذا كانت نقطة النهاية تدعم tcpdump. السماح للتتبع بتشغيل دفتر الهاتف والوصول إليه عبر واجهة الويب أو من واجهة المستخدم. يجب أن ترى طلب بحث يأتي على خادم TMS.

بعد تدفق TCP هذا، سترى مكونين أساسيين ل XML:

أولا، سوف تعرف نقطة النهاية نفسها، على سبيل المثال:

<Search>
<Identification>
  <SystemName>RoomKit</SystemName>
  <MACAddress>08:96:ad:5a:f4:f4</MACAddress>
  <IPAddress>14.49.31.33</IPAddress>
  <IPAddressV6 type="Local">fe80::a96:adff:fe5a:f4f4</IPAddressV6>
  <ProductType>Cisco Codec</ProductType>
  <ProductID>Cisco Webex Room Kit</ProductID>
  <SWVersion>ce9.9.0.3a4afe323b0</SWVersion>
  <SerialNumber>FOC2108NFRA</SerialNumber>
</Identification>

بعد ذلك، سترى تفاصيل الطلب:

<CaseSensitiveSearch>false</CaseSensitiveSearch>
      <SearchPath/>
      <SearchString/>
      <SearchType>Free</SearchType>
      <Scope>SubTree</Scope>
      <MaxResult>50</MaxResult>
      <RangeInclusive>false</RangeInclusive>
    </Search>

<ملاحظة: ستتغير قيم التفاصيل تبعا للطلب الذي تم إجراؤه. تم إجراء الطلب أعلاه باستخدام الأمر ssh 'xcommand phoneBook Search PhoneType: Corporate' من نقطة النهاية.>

يجب أن تكون الاستجابة من خادم TMS 200 OK. وإلا يمكنك أستكشاف الأخطاء وإصلاحها استنادا إلى الرسالة المختلفة التي تتلقاها.

ستحتوي إستجابة 200 OK على الإدخالات ذات الصلة من دفاتر الهاتف المعينة إلى نقطة النهاية في TMS. في الطلب أعلاه، نقطة النهاية تم تعيين دفتر هاتف واحد في TMS، ويبدو الرد كما يلي:

<SearchResponse xmlns="http://www.tandberg.net/2004/06/PhoneBookSearch/">
    <SearchResult>
        <Name />
        <Id />
        <Entry>
            <Name>HDX8000</Name>
            <Id>e_92750</Id>
            <Route>
                <CallType>384</CallType>
                <Protocol>H323</Protocol>
                <Restrict>Norestrict</Restrict>
                <DialString>hdx8000</DialString>
                <Description>hdx8000 (H.323)</Description>
                <SystemType>Polycom HDX 8000 HD</SystemType>
            </Route>
            <IsLast>false</IsLast>
            <IsFirst>true</IsFirst>
            <BaseDN />
            <SystemType>Polycom HDX 8000 HD</SystemType>
        </Entry>
        <Entry>
            <Name>SX10</Name>
            <Id>e_92749</Id>
            <Route>
                <CallType>384</CallType>
                <Protocol>SIP</Protocol>
                <Restrict>Norestrict</Restrict>
                <DialString>sx10@example.com</DialString>
                <Description>sx10@example.com (SIP)</Description>
                <SystemType>Cisco TelePresence SX10</SystemType>
            </Route>
            <IsLast>false</IsLast>
            <IsFirst>false</IsFirst>
            <BaseDN />
            <SystemType>Cisco TelePresence SX10</SystemType>
        </Entry>
        <NoOfEntries>7</NoOfEntries>
        <FolderExists>true</FolderExists>
    </SearchResult>
</SearchResponse>

تسجيل طلب/إستجابة دفتر الهاتف في TMS

قامت TMS 15.8 بتوفير إمكانية تسجيل جميع طلبات الهواتف المحمولة واستجاباتها. بشكل افتراضي، يتم تعطيل هذا التسجيل ولكن يمكن تمكينه بطريقتين.

1. من خلال تعديل ملف web.config الموجود، بشكل افتراضي على "C:\Program files (x86)\TANDBERG\TMS\wwwTMS\Public\web.config" وتعديل هذا القسم:

<logger name="Tandberg.TMS.Phonbook.PhoneBookRequestResponse" additivity="false">
<level value="shutdown" />

تغيير قيمة المستوى من 'إيقاف تشغيل' إلى 'تصحيح الأخطاء'

2. يمكن القيام بذلك بسهولة أكبر باستخدام الأداة المساعدة لتجميع سجلات TMS من خلال التحقق مما يلي:

بمجرد أن يبلغ طلب دفتر الهاتف تطبيق TMS، سيتم كتابة السجل. الموقع الافتراضي لهذا الملف هو "C:\Program files (x86)\TANDBERG\TMS\data\Logs\TMSDebug\log-phonebook-request-response.txt"

مثال على هذا الإخراج:

Incoming Request
2020-01-08 09:30:54,856|PhoneBookService [ec3eaf80-f519-4573-9e68-3d98ab494d0b] REQUEST : Identification = 14.49.31.33,Scope = SubTree,Start Time = 1/8/2020 9:30:54 AM,Start From Id = "",End At Id = "",Max Result = 50,Search String = "",Search Path = "",Range Inclusive = False,Case Sensitive Search = False,Search Type = Free,Starts With = "",

Outgoing Response
2020-01-08 09:30:55,121|PhoneBookService [ec3eaf80-f519-4573-9e68-3d98ab494d0b] RESPONSE : 14.49.31.33 <?xml version="1.0" encoding="utf-16"?><Catalog xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><Name /><Id /><Entry><Name>HDX8000</Name><Id>e_92750</Id><Route><CallType>384</CallType><Protocol>H323</Protocol><Restrict>Norestrict</Restrict><DialString>hdx8000</DialString><Description>hdx8000 (H.323)</Description><SystemType>Polycom HDX 8000 HD</SystemType></Route><Route><CallType>384</CallType><Protocol>H323</Protocol><Restrict>Norestrict</Restrict><DialString>1001</DialString><Description>1001 (H.323)</Description><SystemType>Polycom HDX 8000 HD</SystemType></Route><Route><CallType>384</CallType><Protocol>H323</Protocol><Restrict>Norestrict</Restrict><DialString>14.49.31.35</DialString><Description>14.49.31.35 (H.323)</Description><SystemType>Polycom HDX 8000 HD</SystemType></Route><IsLast>false</IsLast><IsFirst>true</IsFirst><BaseDN /><SystemType>Polycom HDX 8000 HD</SystemType></Entry><Entry><Name>SX10</Name><Id>e_92749</Id><Route><CallType>384</CallType><Protocol>SIP</Protocol><Restrict>Norestrict</Restrict><DialString>sx10@example.com</DialString><Description>sx10@example.com (SIP)</Description><SystemType>Cisco TelePresence SX10</SystemType></Route><IsLast>false</IsLast><IsFirst>false</IsFirst><BaseDN /><SystemType>Cisco TelePresence SX10</SystemType></Entry><IsLast>false</IsLast><IsFirst>false</IsFirst><NoOfEntries>7</NoOfEntries><FolderExists>true</FolderExists></Catalog>

لاحظ أن هذا مماثل جدا للمنشور و 200 OK الذي يظهر في التقاط الحزمة. ومع ذلك، سيكون هذا هو نفسه، سواء كنت تستخدم HTTP أو HTTPS. حيث أن الالتقاط سيكون غير قابل للقراءة إذا تم إستخدام HTTPS.