المحتويات

المقدمة

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

المتطلبات

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

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

سير العمل

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

التكوين

إضافة بيانات اعتماد

إضافة عنوان الشبكة

تطبيقات المجموعة

صفحة نظرة عامة

تقرير SI CUCDM

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

التحقق من الصحة

المقدمة

يوضح هذا المستند كيفية إنشاء تقارير مخزون الخدمة (SI) في نشر حل التعاون المستضاف (HCS) 9.2.1 والتفاعلات بين مخزون خدمة تنفيذ وسيط التعاون المستضاف (HCM-F) من Cisco ومدير مجال الاتصالات الموحدة (CUCDM) 8.1.x من Cisco أثناء هذه العملية.

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

المتطلبات

لا توجد متطلبات خاصة لهذا المستند.

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

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

- CUCDM 8.1.x

- HCM-F، الإصدار 9.2.1

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

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

HCS SI من Cisco هو تطبيق يوفر تقارير لمزودي الخدمة لأغراض الفوترة. تحتوي هذه التقارير على بيانات حول العملاء والمشتركين والأجهزة والتفاصيل الأخرى المتوفرة حاليا في CUCDM. وبالإضافة إلى ذلك، يمكن أن يقوم SI بإنشاء تقارير مباشرة من خوادم تطبيق Cisco Unified Communications Manager و Cisco Unity Connection للعملاء المزودين في Cisco HCM-F الذين ليس لديهم CUCDM مكون. يقوم SI تلقائيا بنقل ملفات التقارير على فواصل زمنية منتظمة قابلة للتكوين إلى خوادم SFTP البعيدة. يستخدم موفرو الخدمة هذه التقارير لإنشاء سجلات فوترة لعملائهم.

سير العمل

1. تتم جدولة تقارير SI وتكوينها عبر تكوين مخزون الخدمة بواسطة المسؤول.

2. استنادا إلى جدول زمني محدد، تقوم خدمة ويب SI بإرسال طلب لبروتوكول الوصول البسيط إلى الكائن (SOAP) إلى CUCDM.

3. تتلقى CUCDM طلب SOAP هذا وتقوم بتشغيل حركة لإنشاء بيانات ذات صلة بمخزون الخدمة وترسل CUCDM هذه البيانات إلى HCM-F SI عبر SFTP.

4. يرى بروتوكول SI الملف (الملفات) الجديد، ويزيل ضغط الملف (الملفات)، ويعالج الملف (الملفات).

5. ينتج SI في نهاية المطاف ملفا (ملفات) .si.

6. تقوم SI بإنشاء نسخ إحتياطية من جميع الملفات، والتي تتضمن .si للاسترداد لاحقا ودعم الحقل إذا لزم الأمر.

7. يعمل بروتوكول SI على نقل الملف (الملفات) .si إلى مضيف (مضيف) SFTP كما تم تكوينه في واجهة المستخدم الرسومية (GUI).

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

يجب تثبيت HCM-F و CUCDM وتكوينهما. يجب تنشيط هذه الخدمات وبدء تشغيلها على HCM-F:

- قاعدة بيانات CDM من Cisco

- Cisco Tomcat

- واجهة مستخدم Cisco HCS SI

أستخدم خدمة ويب للواجهة الشمالية HCS من Cisco، إذا كنت تخطط لتكوين SI من خلال الواجهة الإدارية SI. أستخدم خدمة تلبية HCS من Cisco، إذا كنت تخطط لتكوين SI من خلال NBI HCM-F من Cisco. تأكد من تشغيل خدمة HCS CUCDMSync من Cisco إذا كنت تخطط لتشغيل خدمة Cisco HCS CUCDMSync. أستخدم خدمة محول تزويد HCS من Cisco بحيث يمكن للمزامنة التلقائية نشر بيانات CUCDM إلى مستودع البيانات المشتركة. يحصل SI على بيانات الاتصال ل CUCDM من مستودع البيانات المشتركة. توفر خدمة مهايئ إمداد Cisco HCS بيانات الاعتماد ومعلومات SNMP، بالإضافة إلى توفير بيانات Syslog عن بعد على أجهزة مدير الاتصالات الموحدة من Cisco.

تختلف الخدمات المطلوبة بين تقرير CUCDM وتقرير تطبيق الاتصالات الموحدة المدعوم.

بالنسبة لتقارير CUCDM، تحتاج إلى هذه الخدمات:

- خدمة إمداد المهايئ Cisco HCS Provisioning Adapter Service

- Cisco Tomcat

- مخزون خدمة HCS من Cisco

- واجهة مستخدم Cisco HCS SI

- قاعدة بيانات CDM من Cisco

- خدمة تلبية HCS من Cisco

- خدمة HCS CUCDMSync من Cisco

- خدمة HCS UCSMSync من Cisco

- خدمة Cisco HCS VCenterSync

بالنسبة لتقارير تطبيقات الاتصالات الموحدة المدعومة، تحتاج إلى هذه الخدمات:

- خدمة إمداد المهايئ Cisco HCS Provisioning Adapter Service

- Cisco Tomcat

- مخزون خدمة HCS من Cisco

- واجهة مستخدم Cisco HCS SI

- قاعدة بيانات CDM من Cisco

يجب تنشيط خدمات الويب وتشغيلها على CUCDM 8.1.x.

=>[webservices] #

show

|OPTION |VALUE |DESCRIPTION |

|------ |----- |----------- |

|Enabled |True |Enable Webservice |

|8.1.0 |True |Enable version 8.1.0 webservices interface |

|8.0.0 |False |Enable version 8.0.0 compatible webservices interface |

التكوين

ملاحظة: أستخدم أداة بحث الأوامر (للعملاء المسجلين فقط) للحصول على مزيد من المعلومات حول الأوامر المستخدمة في هذا القسم.

تأكد من إضافة CUCDM كمثيل تطبيق إدارة في HCM-F. وذلك لأن مخزون خدمة HCM-F يعتمد على البيانات الواردة من CUCDM من أجل إنشاء تقارير SI، وبالتالي يجب إضافته.

للقيام بذلك، أختر InStructure Manager (إدارة البنية الأساسية) > شبكة الإدارة > تطبيق الإدارة > إضافة جديد.

- إصدار واجهة برمجة التطبيقات (API) - من هذه القائمة المنسدلة، أختر إما 8.1.0 أو 8.0.
عند التكامل مع إصدار CUCDM أقدم من 8.1.2، يجب تعيين إصدار API على 8.0. يمكن تعيين إصدار واجهة برمجة التطبيقات على 8.0 أو 8.1 عند التكامل مع CUCDM 8.1.2 أو إصدار أحدث. لاحظ أيضا أنه إذا تم تكوين إصدار واجهة برمجة التطبيقات (API) رقم 8.0، فلن تتم مزامنة خطوط اتصال SIP، وسيتم مزامنة اسم الموقع فقط لموقع العميل.

- المنفذ - إعدادات المنفذ الافتراضية إلى 8181. هذا هو منفذ SOAP الذي يتم إستخدامه من قبل SI لإرسال رسالة SOAP الأولى إلى CUCDM.

- بيانات الاعتماد - أختر مسؤول نوع بيانات الاعتماد وقم بتوفير معرف مستخدم (في هذه الحالة hcmf). يتم إستخدام هذا المستخدم للوصول إلى CUCDM.

ملاحظة: يلزم أن يكون هذا المستخدم موجودا أيضا في CUCDM بنفس كلمة المرور. للتحقق من ذلك، أخترت من ال CUCDM GUI إدارة عامة>إدارة مستعمل.

عند إضافة/تكوين هذا المستخدم، تأكد من التحقق من الوصول إلى خدمة ويب. (يتم إستخدام هذا المستخدم من قبل HCM-F SI لإرسال طلب خدمة ويب إلى CUCDM، وبالتالي يجب تمكينه.)

تمت الآن تغطية إنشاء التقرير المستمد من CUCDM. ومع ذلك، يمكن أيضا ل SI إنشاء تقارير مباشرة من تطبيق تطبيق تطبيق الاتصالات الموحدة المدعوم، و Cisco Unified Communications Manager، وخوادم تطبيق Cisco Unity Connection للعملاء المزودين في Cisco HCM-F الذين ليس لديهم CUCDM مكون.

إذا لم يتم تكوين CUCDM لديك، فأنت بحاجة إلى إضافة خوادم تطبيق مدير الاتصالات الموحدة (CUCM) من Cisco واتصال وحدة التحكم (CUC) يدويا لتشغيل تقرير مخزون الخدمة.

1. أختر Infrastructure Manager (مدير البنية الأساسية) > Customer Management (إدارة العملاء) > Cluster (العملاء). قم باختيار التطبيق المعني. على سبيل المثال، خادم CUCM أو CUC، كما هو موضح في هذه الصورة.

2. قم بإضافة كل من مسوغات النظام الأساسي و ADMIN إلى كل تطبيق كما هو موضح في هذه الصورة.

إضافة بيانات اعتماد

لإضافة بيانات اعتماد،

1. انقر فوق علامة التبويب بيانات الاعتماد.

2. طقطقة يضيف جديد.

3. أختر نوع بيانات الاعتماد.
ملاحظة: يلزم توفر كل من النظام الأساسي والمسؤول لتشغيل مجموعة تقارير تطبيق الاتصالات الموحدة.

4. أتمت المستعمل id، كلمة مرور، ودخلت كلمة مجال.

5. طقطقة حفظ.

6. كرر لإضافة نوع بيانات الاعتماد التالي.

إضافة عنوان الشبكة

1. انقر على علامة تبويب عنوان الشبكة.

2. طقطقة يضيف جديد.

3. حدد مساحة الشبكة : مساحة موفر الخدمة.

4. أدخل عنوان IPv4.
هذا مطلوب لكل من Cisco Unified Communications Manager و Cisco Unity Connection.

تطبيقات المجموعة

كرر الكل لتطبيق نظام المجموعة التالي.

بعد ذلك، قم بتكوين قطعة مخزون الخدمة في صفحة تكوين مخزون الخدمة على HCM-F، كما هو موضح في هذه الصورة.

صفحة نظرة عامة

هنا يمكنك تعيين الجدول الزمني الذي يحدد متى تريد بدء تشغيل التقرير.

1. تأكد من تحديد خانة الاختيار تمكين الجدول.
ملاحظة: إصدار تنسيق التقرير هو المفتاح هنا.

2. حدد إصدار تنسيق التقرير الذي تريد أن يقدمه تطبيق SI. تأكد من إستخدام الإصدارات المتوافقة من SI وأي تطبيق إتصالات موحدة مدعوم. لمعلومات التوافق، راجع مصفوفة التوافق لحل التعاون المستضاف من Cisco.
يكون إصدار تنسيق تقرير Cisco HCS 9.1(1) متوافقا فقط مع الإصدار 8.1 من CUCDM والإصدارات الأحدث. يتوافق إصدار تنسيق تقرير Cisco HCS 9.0(1) مع الإصدار 8.0 من CUCDM والإصدارات الأحدث. إذا قمت بتشغيل إصدار سابق من برنامج CUCDM، فأختر إصدار تنسيق التقرير 8.6(2).

تقرير SI CUCDM

1. لضمان إنشاء تنسيقات تقارير HCS الإصدار 9.1(1) و 9.0(1) بشكل صحيح، انتقل إلى مدير البنية الأساسية > تطبيق الإدارة. في هذه الصفحة، تأكد من إختيار برنامج CUCDM الإصدار 8.0 أو 8.1 وليس الإصدار 7.4.

2. بعد ذلك، قم بتكوين صفحة التكوين في صفحة تكوين مخزون الخدمة على HCM-F.

3. في قسم إعدادات مخزون الخدمة، قم بتكوين اسم المضيف/عنوان IP الخاص بخادم SI. يجب إدخال اسم المضيف SI كعنوان IP أو اسم مجال مؤهل بالكامل. إذا لم يتم تكوين خادم CUCDM مع تمكين DNS، فأدخل عنوان IP في حقل اسم المضيف.
تم تصنيف حقل اسم المستخدم إلى خارج (مرمز بشكل ثابت).

يستخدم CUCDM اسم المستخدم، adminsftp، لنقل البيانات إلى تطبيق SI. لا يمكنك تحديث هذا الحقل.

4. دخلت في الكلمة مجال، الكلمة ل ال adminsftp مستعمل حساب. هذه الخطوة مطلوبة كتأكيد هوية لأغراض الأمان. كلمة المرور هذه هي نفسها كلمة مرور مسؤول HCS التي قمت بإعدادها أثناء تثبيت Cisco HCM-F (أو تغيرت بعد التثبيت).
ملاحظة: يتعلم CUCDM كلمة المرور هذه من SI عندما يرسل SI طلب SOAP الأصلي.

5. في قسم إعدادات SFTP لموفر الخدمة، قم بتكوين اسم المضيف والمنفذ (22) مع اسم المستخدم/كلمة المرور لخادم SFTP الذي ستقوم بإرسال ملفات تقرير .si إليه.

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

يوفر هذا القسم معلومات يمكنك إستخدامها لاستكشاف أخطاء التكوين وإصلاحها.

السجلات الهامة هي:

- activelog tomcat/logs/catalina.out - يتضمن رسائل الطلب والاستجابة من وإلى CUCDM.

- ActiveLogToCat/log/si/log4j - يحتوي على جميع العمليات الخاصة ببروتوكول SI.

ملاحظة: إذا كنت تستخدم SI دون CUCDM، فقم أيضا بمراجعة هذه السجلات:

- /var/log/active/hcs/chpa - توفير ملفات سجل خدمة المحول

- /var/log/active/hcs/ucpa - ملفات سجل خدمة UCPA

أتمت هذا steps in order to ثبتت السجل مستوى إلى تفصيلي (debug) مستوى:

1. دخلت الأمر:
admin:

set trace tracelevel

2. أدخل tracelevel (أستخدم أمر واجهة سطر الأوامر (CLI) show traceleves لإيجاد المسارات المسموح بها) - مفصل

3. أدخل ServiceName - Cisco Tomcat
تم تحديث السجل (السجلات) بنجاح.

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

لاحظ أنه يمكنك رؤية معرف المستخدم في إخراج الحركة هو مستخدم hcmf الذي تم تكوينه مسبقا في HCM-F وكذلك في CUCDM.

بمجرد أن يتم ذلك، تحقق مما إذا كانت الملفات قد تم تحويلها إلى SI بشكل صحيح. ومن المهم فهم كيفية عمل هيكل بيانات التقرير في نظام المعلومات المتكامل. تنسيق الملف SI هو ملف مستند إلى ASCII بامتداد الملف ".si". (ملحق الملف الخاص بالتنسيق المشترك لمخزون خدمة تطبيق الاتصالات الموحدة هو .ucsi)

لذلك، في الظروف العادية، ترسل CUCDM ملفات SI الخام (مضغوطة) إلى HCM-F. ثم يقوم HCM-F (SI) بتدليك البيانات. (يرى SI الملف (الملفات) الجديد، ويلغي ضغط الملف (الملفات)، ويعالج الملف (الملفات).) يوجد داخل بنية الملف عدد من الدلائل ولكل من هذه معناها الخاص يعتمد على حالة البيانات. يمكن الوصول إلى هذه المجلدات فقط من قبل مركز المساعدة التقنية (TAC) أثناء جلسة أستكشاف الأخطاء وإصلاحها عبر الحساب الجذر.

وبشكل محدد، يتم تخزين جميع الملفات هنا في بروتوكول SI: /opt/hcs/si/backup/

- dmuncompressed/ - هذا هو المكان الذي يتم فيه فك الملفات المتلقاة من CUCDM ووضع هذه الملفات.

- inTranslate/ - بعد ذلك تتم ترجمة الملفات كخطوة وسيطة وهذا يذهب إلى هذا الدليل.

- cisco-normal/- ثم يتم إنتاج ملف واحد (نسخة من المخرج النهائي) ويدخل هنا.

- sp-normalized/ - بناء على الحد الأقصى لحجم الملف الذي تم تكوينه على واجهة المستخدم الرسومية، يتم تقسيم الملف السابق إلى أجزاء بناء على الحد الأقصى لحجم التعبئة الذي تم تكوينه (بعد ذلك يتم إعادة ترقيمها للتسلسل).

/opt/hcs/si/backup/dmuncompressed

[root@hcmf921 dmuncompressed]#

20150522210000GMT+1+CUCDM+1+1.dsi  20150622121500GMT+1+CUCDM+1+1.dsi

20150523210000GMT+1+CUCDM+1+1.dsi  20150623121500GMT+1+CUCDM+1+1.dsi

20150524210000GMT+1+CUCDM+1+1.dsi  20150624121500GMT+1+CUCDM+1+1.dsi

20150525210000GMT+1+CUCDM+1+1.dsi  20150625121500GMT+1+CUCDM+1+1.dsi

20150526210000GMT+1+CUCDM+1+1.dsi  20150626121500GMT+1+CUCDM+1+1.dsi

[root@hcmf921 dmuncompressed]#

/opt/hcs/si/backup/cntranslated

[root@hcmf921 cntranslated]#

20150602210000GMT+1+CUCDM+1+1.tsi  20150703121500GMT+1+CUCDM+1+1.tsi

20150603210000GMT+1+CUCDM+1+1.tsi  20150704121500GMT+1+CUCDM+1+1.tsi

20150604210000GMT+1+CUCDM+1+1.tsi  20150705121500GMT+1+CUCDM+1+1.tsi

20150605210000GMT+1+CUCDM+1+1.tsi  20150706121500GMT+1+CUCDM+1+1.tsi

[root@hcmf921 cntranslated]#

/opt/hcs/si/backup/cisco-normalized

[root@hcmf921 cisco-normalized]#

10000GMT+1+CUCDM+1+1.csi  20150703121500GMT+1+CUCDM+1+1.csi

20150603210000GMT+1+CUCDM+1+1.csi  20150704121500GMT+1+CUCDM+1+1.csi

20150604210000GMT+1+CUCDM+1+1.csi  20150705121500GMT+1+CUCDM+1+1.csi

20150605210000GMT+1+CUCDM+1+1.csi  20150706121500GMT+1+CUCDM+1+1.csi

20150606210000GMT+1+CUCDM+1+1.csi  20150707121500GMT+1+CUCDM+1+1.csi

20150607210000GMT+1+CUCDM+1+1.csi  20150708121500GMT+1+CUCDM+1+1.csi

20150608210000GMT+1+CUCDM+1+1.csi  20150709090000GMT+1+CUCDM+1+1.csi

/opt/hcs/si/backup/sp-normalized

[root@hcmf921 sp-normalized]#

20150528210000GMT+1+CUCDM+1+1.si  20150628121500GMT+1+CUCDM+1+1.si

20150529210000GMT+1+CUCDM+1+1.si  20150629121500GMT+1+CUCDM+1+1.si

20150530210000GMT+1+CUCDM+1+1.si  20150630121500GMT+1+CUCDM+1+1.si

20150531210000GMT+1+CUCDM+1+1.si  20150701121500GMT+1+CUCDM+1+1.si

20150601210000GMT+1+CUCDM+1+1.si  20150702121500GMT+1+CUCDM+1+1.si

دخلت in order to سحبت السجل مبرد من si، هذا أمر

file get activelog  tomcat/logs/catalina.out

file get activelog tomcat/logs/si/log4j/XXXXXX (where XXXX are the filenames

you want to gather)

التحقق من الصحة

لا يوجد حاليًا إجراء للتحقق من صحة هذا التكوين.