نظرة عامة

الغرض من هذه الوثيقة هو تقديم تعليمات مفصلة حول استخدام الأدوات للانتقال من Cisco BroadWorks وWebex for BroadWorks وBroadCloud إلى Wholesale وWebex Calling. تغطي هذه الوثيقة مجموعة من أدوات الترحيل المصممة للمساعدة في ترحيل عملاء Cisco BroadWorks وWebex for BroadWorks وBroadCloud الحاليين إلى حل Wholesale Route-to-Market.

تهدف أدوات الهجرة إلى تسهيل الانتقال الكامل من خدمات BroadWorks إلى خدمات البيع بالجملة. إنها ليست مصممة للتعايش طويل الأمد بين الخدمتين داخل نفس منظمة العملاء.

تأثير الهجرة

وتتمثل التأثيرات المترتبة على الهجرة فيما يلي:

المسؤولون

بعد الهجرة، يجب على المسؤولين القيام بما يلي:

  • ابدأ باستخدام Partner Hub وControl Hub لتكوين الميزات بدلاً من CommPilot.
  • إعادة تكوين أي ميزات ليست جزءًا من الترحيل.

    يتعين عليك ترحيل الميزات التي لا يتم ترحيلها تلقائيًا بعد اكتمال أدوات الترحيل يدويًا.

المستخدمون

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

  • سيفقد المستخدمون سجل مكالماتهم وسجل رسائلهم.
  • سيفقد المستخدمون جميع إعدادات خط المفاتيح الشخصية والتخصيصات ويجب عليهم إعادة تكوين هذه الإعدادات بعد الترحيل. وتشمل الأمثلة الاتصال السريع.
  • يجب على المستخدمين إعادة تعيين رموز الوصول وكلمات المرور الخاصة بهم عند تسجيل الدخول الأول.
  • يُطلب من المستخدمين الذين يستخدمون عميل UC-One عند تسجيل الدخول لأول مرة الترقية إلى تطبيق Webex.

هندسة أدوات الهجرة

تتكون هندسة أدوات الهجرة من أربع أدوات مختلفة:

  1. أداة الاستخراج—تستخرج المؤسسات والمجموعات والأرقام والمستخدمين والخدمات والهواتف والعملاء البرمجيات من Cisco BroadWorks. يجب على شركاء BroadCloud تقديم طلب استخراج في بوابة مزود الخدمة.
  2. أداة التحويل—تحويل المعلومات المستخرجة بواسطة أداة الاستخراج إلى ملف JSON يمكن تحريره.
  3. أداة التجهيز—تستخدم ملف إخراج JSON من أداة التحويل لتجهيز العملاء والمواقع والأرقام والمستخدمين والخدمات والهواتف باستخدام واجهات برمجة تطبيقات Webex العامة.
  4. أداة نقل الجهاز—تستخدم ملف إخراج أداة التحويل JSON لإعادة بناء الملفات الشخصية وإعادة تشغيل الهواتف، وتنشيط الأرقام في حل Wholesale RTM، وإلغاء تنشيط أرقام الهواتف في Cisco BroadWorks.
    • تدعم هذه الأداة استعادة ملفات تعريف الهاتف والعميل الناعم وتنشيط الرقم مرة أخرى في Cisco BroadWorks.
    • يجب على شركاء BroadCloud إرسال طلب الهجرة في بوابة مزود الخدمة.

يوضح الرسم التوضيحي التالي كيفية عمل الأدوات الأربع بشكل تسلسلي من خلال التواصل مع Cisco BroadWorks وواجهات برمجة التطبيقات العامة وتحميل المقاييس إلى خدمات Webex للتحليلات المستقبلية بعد أن يقوم المسؤول بتشغيل مهام الترحيل.

مخطط هندسة أدوات الهجرة

الشكل رقم 1: أدوات الهجرة

المتطلبات

قبل تشغيل أدوات الهجرة، يجب على الشريك استيفاء المتطلبات التالية:

  1. يجب أن يكون حساب الشريك ومسؤول الشريك مدمجين في حل Wholesale RTM. خلال مرحلة ما قبل البيع، لا يُطلب من الشركاء الانضمام إلى حل Wholesale RTM لتشغيل أداة الاستخراج.
  2. يجب على الشريك مراجعة قائمة التحقق قبل الهجرة للتأكد من استيفاء جميع المتطلبات.
  3. يجب الحصول على بيانات اعتماد مسؤول نظام Cisco BroadWorks لتشغيل أدوات الاستخراج ونقل الجهاز. لا ينطبق هذا على شركاء BroadCloud.
  4. يجب تشغيل أدوات الاستخراج ونقل الجهاز من خادم Cisco BroadWorks Application Server الثانوي أثناء فترة الصيانة لتقليل المخاطر. سوف يقوم شركاء BroadCloud بتشغيل أداة نقل الجهاز من بوابة مزود الخدمة.
  5. قم بمراجعة قائمة أجهزة Webex Calling المدعومة.
  6. قم بمراجعة قائمة أجهزة Webex Calling غير المدعومة.
  7. يتعين على الشركاء أن يطلبوا من فريق حساباتهم في شركة Cisco الحصول على إصدار البرنامج الثابت المدعوم للهواتف والأجهزة.
  8. يتعين على عملاء UC-One الترقية إلى الإصدارات التالية:
    • يجب أن يكون عملاء Desktop Communicator الإصدار 22.9.12 أو أعلى
    • يجب أن يكون عملاء Mobile Connect بإصدار 3.9.14 أو أعلى.
  9. يجب أن يحتوي جهاز المسؤول على:
    • JDK/JRE 1.8 مطلوب لأداة التجهيز.
    • تتطلب أجهزة MAC وLinux إصدار Python 3.10.5 أو أعلى لأداة التحويل.
  10. يجب أن يكون لدى العملاء عنوان إرسال فواتير صالح، ويجب أن يكون لدى المستخدمين النهائيين عنوان بريد إلكتروني تجاري مُهيأ في Cisco BroadWorks. إذا لم يتم تعيين القيم، فيجب على مسؤولي الشركاء الاتصال بعملائهم للحصول عليها. يجب إضافة هذه التفاصيل إلى ملفات CSV (القيم المنفصلة بفاصلة) قبل تشغيل أداة التحويل. يتم توفير ملفات CSV النموذجية باستخدام أداة التحويل.

خطة الترحيل

تتضمن خطة الهجرة 3 مراحل:

  1. التحضير
    • احصل على نسخة من بيانات المستخدم باستخدام أداة الاستخراج
    • إنشاء رمز مميز باستخدام أداة إنشاء الرمز المميز
    • استخدم أداة التحويل لتنسيق بيانات المستخدم
  2. التوفير
    • احصل على أحدث بيانات المستخدم باستخدام أداة الاستخراج
    • استخدم أداة التحويل لتنسيق بيانات المستخدم
    • توفير أداة التجهيز للمستخدمين
  3. الترحيل
    • نقل الأجهزة باستخدام أداة نقل الجهاز
    • الهجرة بدون أجهزة [ تفعيل أرقام الهواتف من خلال Control Hub ]

    إذا لم يكن لدى مسؤولي الشركاء أجهزة لنقلها من Cisco BroadWorks إلى Wholesale، فلن يكون من الضروري تشغيل أداة نقل الجهاز. يمكن لمسؤولي الشركاء استخدام الرابط العام أدناه لتفعيل أرقام الهواتف مباشرة من خلال بوابة Control Hub. لمعرفة المزيد من المعلومات، ارجع إلى إدارة أرقام الهواتف في Control Hub.

    يعد إلغاء تنشيط أرقام الهواتف في Cisco BroadWorks اختياريًا إذا قام مسؤولو الشركاء بتنشيط أرقام هواتفهم من خلال Control Hub.

الميزات التي تم نقلها تلقائيًا إلى خدمة الاتصال بالجملة

يتم ترحيل ميزات المستخدم هذه تلقائيًا بواسطة أدوات الترحيل:

  • إعدادات الرسائل الصوتية والتحية المخصصة (لا يتم ترحيل الرسائل الصوتية والصوت المخصص للاسم ورقم التعريف الشخصي للمستخدمين)
  • الأرقام البديلة
  • BroadWorks Anywhere
  • حقل مصباح مزدحم
  • معرف المتصل (الاسم المخصص ورقم الهاتف)
  • المكالمة بالانتظار
  • إعدادات تحويل المكالمات (تحويل المكالمات always/busy/no answer/not (يمكن الوصول إليها)
  • مقاطعة الاتصال
  • عدم الإزعاج
  • إعدادات الفاكس
  • مكتب بعيد
  • مظهر مشترك للمكالمات
  • رنين شخصي متزامن (بما في ذلك الجدول الزمني والمعايير الانتقائية)
  • إشعار المكالمة (بما في ذلك الجدول الزمني والمعايير الانتقائية)
  • رفض المكالمات مجهولة الهوية
  • رفض المكالمات الانتقائية
  • إعادة توجيه المكالمات الانتقائية
  • التقاط المكالمات الموجهة والتدخل
  • إعفاء من الدخول بالقوارب
  • اضغط للتحدث
  • الخصوصية
  • موسيقى قيد الانتظار
  • الخدمة في الإجازات
  • الخدمة الليلية

يتم ترحيل ميزات المجموعة هذه تلقائيًا بواسطة أدوات الترحيل:

  • الرد التلقائي
    • مستوى واحد فقط
    • تحيات مخصصة
    • إعدادات تحويل المكالمات (دائمًا، مشغول، انتقائي)
    • الأرقام البديلة
    • قائمة العطلة غير متوفرة في Webex
    • رفض المكالمات الانتقائية
  • مركز الاتصال القياسي Cisco BroadWorks وقائمة انتظار مكالمات BroadCloud:
    • التكوين الأساسي
    • تحيات مخصصة
    • الوكلاء والمشرفين
    • إعدادات تحويل المكالمات (دائمًا، مشغول، انتقائي)
    • الأرقام البديلة
    • الموسيقى قيد الانتظار
  • حديقة المكالمات
  • التقاط المكالمة
  • مجموعة الخطوط المجمَّعة
    • إعدادات إعادة توجيه المكالمات (دائمًا، مشغول، انتقائي، غير قابل للوصول)
    • الأرقام البديلة
  • رمز الموقع (واحد لكل موقع أو مجموعة)
  • مجموعة الترحيل
  • الجداول الزمنية (على مستوى المجموعة فقط، ولا يتم ترحيل جداول المؤسسات)
  • مدخل الصوت
  • الموسيقى قيد الانتظار
  • قائمة الهاتف المشتركة

الأجهزة المدعومة

سيتم إنشاء الهواتف المدعومة وتخصيصها تلقائيًا للمستخدمين في Webex Calling بواسطة أداة التجهيز. سيتم أيضًا نقل الهواتف التي تحمل علامة "نعم" في العمود "المدعومة في أداة نقل الجهاز" تلقائيًا من Cisco BroadWorks أو BroadCloud إلى Webex Calling عند تشغيل أداة نقل الجهاز. تحتاج الهواتف التي تم وضع علامة "لا" عليها في هذا العمود إلى تدخل يدوي لتغيير عنوان URL الخاص بـ DMS في قالب جهاز Cisco BroadWorks أو في الهاتف نفسه.

يوفر العمود الأخير تعيين طرازات الهواتف إلى عمود "نوع الجهاز" في الملف transform-tool/input/newphones.csv. (راجع قسم أداة التحويل في هذه المقالة للحصول على مزيد من المعلومات حول newphones.csv).

طراز الهاتف

مدعوم في أداة نقل الجهاز

نوع الجهاز في newphones.csv

سيسكو MPP 6821

نعم

DMS سيسكو 6821

سيسكو MPP 6841

نعم

DMS سيسكو 6841

سيسكو MPP 6851

نعم

DMS سيسكو 6851

سيسكو MPP 6861

نعم

DMS سيسكو 6861

سيسكو MPP 6871

نعم

DMS سيسكو 6871

سيسكو MPP 7811

نعم

DMS سيسكو 7811

سيسكو MPP 7821

نعم

DMS سيسكو 7821

سيسكو MPP 7832

نعم

DMS سيسكو 7832

سيسكو MPP 7841

نعم

DMS سيسكو 7841

سيسكو MPP 7861

نعم

DMS سيسكو 7861

سيسكو MPP 8811

نعم

DMS سيسكو 8811

سيسكو MPP 8832

نعم

DMS سيسكو 8832

سيسكو MPP 8841

نعم

DMS سيسكو 8841

سيسكو MPP 8845

نعم

DMS سيسكو 8845

سيسكو MPP 8851

نعم

DMS سيسكو 8851

سيسكو MPP 8861

نعم

DMS سيسكو 8861

سيسكو MPP 8865

نعم

DMS سيسكو 8865

سيسكو MPP 8875

نعم

DMS سيسكو 8875

سيسكو ATA191

نعم

DMS سيسكو 191

سيسكو ATA192

نعم

DMS سيسكو 192

سيسكو DBS 110

نعم

DMS Cisco DBS110

بوليكوم VVX101

نعم

دي إم إس بوليكوم VVX101

بوليكوم VVX150

نعم

DMS بوليكوم VVX150

بوليكوم VVX201

نعم

DMS بوليكوم VVX201

بوليكوم VVX250

نعم

DMS بوليكوم VVX250

بوليكوم VVX301

نعم

دي إم إس بوليكوم VVX301

بوليكوم VVX311

نعم

DMS بوليكوم VVX311

بوليكوم VVX350

نعم

DMS بوليكوم VVX350

بوليكوم VVX401

نعم

DMS بوليكوم VVX401

بوليكوم VVX411

نعم

DMS بوليكوم VVX411

بوليكوم VVX450

نعم

DMS بوليكوم VVX450

بوليكوم VVX501

نعم

DMS بوليكوم VVX501

بوليكوم VVX601

نعم

دي إم إس بوليكوم VVX601

بوليكوم تريو 8300

نعم

DMS بوليكوم تريو 8300

بوليكوم تريو 8500

نعم

DMS بوليكوم تريو 8500

بوليكوم تريو 8800

نعم

DMS بوليكوم تريو 8800

بوليكوم ساوند ستيشن 5000

نعم

DMS بوليكوم SSIP5000

بوليكوم ساوند ستيشن 6000

نعم

DMS بوليكوم SSIP6000

يالينك T33G

نعم

DMS يالينك T33G

يالينك T41S

نعم

DMS يالينك T41S

يالينك T42S

نعم

DMS يالينك T42S

يالينك T43U

نعم

DMS يالينك T43U

يالينك T46U

نعم

DMS يالينك T46U

يالينك T46S

نعم

DMS يالينك T46S

يالينك T48S

نعم

DMS يالينك T48S

يالينك T48U

نعم

DMS يالينك T48U

يالينك T53W

نعم

دي إم إس يالينك T53W

يالينك T54W

نعم

دي إم إس يالينك T54W

يالينك T57W

نعم

دي إم إس يالينك T57W

يالينك T58V

نعم

DMS يالينك T58V

يالينك CP920

نعم

دي إم إس يالينك CP920

يالينك CP960

نعم

دي إم إس يالينك CP960

يالينك W52B

نعم

DMS Yealink W52P

يالينك W56B

نعم

DMS Yealink W56P

يالينك W60B

نعم

DMS Yealink W60P

يالينك W70B

نعم

DMS Yealink W70P

يالينك CP925

نعم

دي إم إس يالينك CP925

يالينك CP965

نعم

دي إم إس يالينك CP965

الأجهزة غير المدعومة

إذا كان العميل يستخدم الأجهزة غير المدعومة بواسطة حل Wholesale RTM، فلن تكون هذه الأجهزة مؤهلة للهجرة. في هذه الحالة، لديك الخيارات التالية:

  1. قم بتوفير الهواتف الجديدة على Cisco BroadWorks قبل الترحيل.
  2. اترك الهواتف القديمة في Cisco BroadWorks، ويجب على المستخدمين تثبيت تطبيق Webex لإجراء واستقبال المكالمات.

باقات الاتصال بالجملة

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

تكوين حزمة ترحيل Cisco BroadWorks

سيتم تحويل جميع المشتركين الذين يقومون بالهجرة من Cisco BroadWorks افتراضيًا إلى حزمة الاتصال Webex. إذا كانت حزمة Webex Voice مطلوبة للمشتركين الذين ليس لديهم انتظار مكالمات أو بريد صوتي مخصص، فيمكن تمكين ذلك في ملف partner.cfg الخاص بأداة التحويل عن طريق إلغاء التعليق على السطر USE_WEBEX_VOICE_PACKAGE.

تعيين حزمة ترحيل Webex لـ BroadWorks

تتم ربط حزم Webex for BroadWorks تلقائيًا بحزم الاتصال بالجملة. هذا غير قابل للتكوين.

حزمة Webex لـ BroadWorks

باقة الاتصال بالجملة

Softphone

Webex Voice

أساسي

Webex Calling

المعيار

Webex Suite

مميزة

Webex Suite

تعيين حزمة هجرة BroadCloud

عمليات الهجرة من حزم خرائط الناقل BroadCloud استنادًا إلى نوع المحطة. يمكن تكوين التعيين الافتراضي في ملف تكوين أداة التحويل conf/rialto_station_type_to_wholesale_package.csv.

نوع محطة الناقل BroadCloud

باقة الاتصال بالجملة

أساسي

Webex Voice

قاعة المؤتمرات

Webex Voice

المراسلة

Webex Voice

المعيار

Webex Voice

المسؤول التنفيذي

Webex Suite

جميع أنواع المحطات الأخرى

Webex Voice

تحويل حساب مستخدم BroadWorks أو BroadCloud إلى مساحة عمل Webex Calling

مساحة عمل Webex هي هاتف مشترك بين العديد من الأشخاص، على سبيل المثال: على سبيل المثال: الهواتف في غرفة المؤتمرات أو المستودع أو الردهة. يمكن تكوين مثل هذه الهواتف في Webex Calling كمساحات عمل Webex بدلاً من مستخدمي Webex. يتوفر خيار لتحويل حسابات المستخدمين من Cisco BroadWorks أو BroadCloud Carrier إلى مساحات عمل تلقائيًا أثناء عملية الترحيل.

خطوات:

  1. في الملف transform_tool/input/users.csv, تعيين الحزمة "common_area" للمستخدمين لتحويلها إلى مساحة عمل.
    • مثال: bwuser@domain,,,common_area
  2. (BroadCloud فقط) لتحويل جميع حسابات المستخدمين لنوع محطة معين إلى مساحات عمل، أضف إدخالاً إلى transform-tool/conf/rialto_station_type_to_wholesale_package.csv وقم بتعيين الحزمة بالجملة إلى "common_area_calling".
    • مثال: conference_room_v2,common_area_calling
  3. قم بتشغيل أداة التحويل.
  4. قم بتشغيل أداة التجهيز.
  5. افتح Control Hub للمنظمة العميل التي تم إنشاؤها حديثًا وقم بتعيين نطاق SIP (انظر الشكل 2، تكوين نطاق SIP في Control Hub).
  6. قم بتشغيل أداة التجهيز مرة أخرى. يؤدي هذا إلى إنشاء مساحات العمل وتعيين الهواتف لها.

الحدود:

لا يتم ترحيل تكوين ميزات المستخدم (على سبيل المثال، إعادة توجيه المكالمات، وعدم الإزعاج) تلقائيًا إلى مساحة العمل.

نافذة مركز التحكم في إعدادات المؤسسة التي تسلط الضوء على قسم عنوان SIP لمكالمات Cisco Webex.

الشكل رقم 2: تكوين نطاق SIP في Control Hub

أداة توليد الرموز

يقوم مسؤولو الشركاء بتشغيل أداة إنشاء الرمز هذه مرة واحدة على الأقل قبل البدء في تشغيل أدوات الترحيل. يعد تشغيل هذه الأداة نشاطًا لمرة واحدة بعد دمج حساب الشريك في حل Wholesale RTM. تتيح هذه الأداة لمسؤولي الشركاء تسجيل الدخول عبر متصفح الويب للحصول على الرمز الفريد المطلوب لتحديث ملفات تكوين الشريك لأدوات الترحيل.

المتطلبات المسبقة

قم بتثبيت Java 8، 11، 17، أو 21 على الكمبيوتر. تتوفر لغة Java من مصادر عديدة، بما في ذلك:

بعد التنزيل، قم باستخراج الملفات الثنائية لأداة الترحيل.

هذه الخطوة اختيارية

تعليمات التشغيل

قم بتشغيل الأمر التالي في المحطة الطرفية داخل دليل منشئ الرمز المميز:

  • يجب أن تكون المنافذ التالية متاحة لتشغيل أداة إنشاء الرمز. المنافذ: 8080، 50009، 50010، 50011، 50012، و50013

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

نظام التشغيل Windows:

token_generator.bat

ماك:

./token_generator.sh

المخرجات:

Tool Name: Token Generator Tool
Version: 1.13.0
Load the URL in your web browser: http://localhost:8080

افتح عنوان URL في متصفح الويب على الجهاز، وقم بتسجيل الدخول باستخدام بيانات اعتماد مسؤول الشريك للحصول على الرمز المميز ثم انسخه للاستخدام الإضافي.

يتم تقديم الرسوم التوضيحية لواجهة المستخدم أدناه للرجوع إليها:

تسجيل الدخول باستخدام شاشة Cisco Webex

الشكل رقم 3: تسجيل الدخول باستخدام Cisco Webex

شاشة تسجيل الدخول إلى نافذة بيانات الاعتماد

الشكل رقم 4: نافذة بيانات الاعتماد

شاشة إنشاء الرمز

الشكل رقم 5: توليد الرمز

مهام إعداد BroadWorks

قم بتكوين الخطوات التالية، قبل تشغيل أدوات الاستخراج ونقل الجهاز في خادم BroadWorks الثانوي.

ينطبق هذا على Cisco BroadWorks وWebex لـ BroadWorks. لا تنطبق هذه الخطوات على BroadCloud.

تمكين اتصال OCI-P

تتواصل أداة نقل الجهاز مع BroadWorks من خلال أوامر OCI-P، لتمكين اتصال OCI-P استخدم الخطوات التالية:

الخطوة 1: استخدم CLI لتكوين الإعدادات العامة.

قم بتشغيل الأمر التالي في CLI للتبديل إلى دليل GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

قم بتشغيل الأمر التالي في CLI للحصول على الإعدادات العامة الحالية:

AS_CLI/Applications/OpenClientServer/GeneralSettings> get
clientPort = 2208
clientPortEnabled = true
secureClientPort = 2209
secureClientPortEnabled = true
systemDomain = <>

إذا كانت إعداداتك لا تتطابق مع ما ورد أعلاه، فاستخدم الأمر set لإعادة تكوين إعداداتك.

الخطوة 2: استخدم CLI لتكوين وكيل OCI.

تغيير الدليل إلى OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

قم بتشغيل CLI التالي للحصول على الإعدادات الحالية. يجب أن ترى ما يلي:

AS_CLI/Applications/OpenClientServer/OCIProxy> get
enabled = true
enabledLoginLevelScreening = false
enableResponseCaching = false
responseCacheDurationHours = 24
responseCacheRenewPeriodMins = 30
messageQueueCapacity = 50
messageQueueTimeoutSeconds = 1800

إذا كانت إعداداتك لا تتطابق مع ما ورد أعلاه، فاستخدم الأمر set لإعادة تكوين إعداداتك.

الخطوة 3: استخدم CLI لتكوين توفير OCI.

التغيير إلى دليل التجهيز:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

قم بتشغيل الأمر التالي للحصول على إعدادات OCI Provisioning الحالية:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> get
Address Description
========================
127.0.0.1 local as

الخطوة 4: قم بتشغيل الأمر أدناه في CLI للتحقق من صحة التكوين الخاص بك.

 AS_CLI/Maintenance/ManagedObjects> get broadworks and check
that your output looks OK.
See below for sample output:
AS_CLI/Maintenance/ManagedObjects> get broadworks
BroadWorks Managed Objects
==========================
* Server:
Identity..............: AS
Version...............: Rel_21.sp1_1.551
Administrative State..: Unlocked
* Applications:
Name Version Deployed Administrative State Effective State
=========================================================================================
ExecutionAndProvisioning 21.sp1_1.551 true Unlocked Unlocked
FlashPolicy 21.sp1_1.551 false Unlocked Stopped
OpenClientServer 21.sp1_1.551 true Unlocked Unlocked
WebContainer 21.sp1_1.551 true Unlocked Unlocked
4 entries found.
* Hosted Applications:
Name Version Context Path Deployed
==================================================================
CommPilot 21.sp1_1.551 / true
DeviceManagementFiles 21.sp1_1.551 /DeviceManagement true
JWSFiles 21.sp1_1.551 /FileRepos true
MediaFiles 21.sp1_1.551 /media true
OCIFiles 21.sp1_1.551 /ocifiles true
5 entries found.

التحقق من نشر خادم العميل المفتوح وتنشيطه

استخدم الأوامر أدناه لنشر وبدء تشغيل Open Client Server على خادم التطبيق الثانوي إذا لم يتم نشره أو لم يبدأ تشغيله بالفعل.

الخطوة 1: قم بنشر الخادم باستخدام أمر CLI التالي:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

الخطوة 2: ابدأ تشغيل الخادم بهذا الأمر:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

تفعيل تفعيل الأرقام

قم بتنفيذ الأوامر التالية في CLI لتمكين تنشيط الأرقام:

الخطوة 1: قم بتشغيل أمر تنشيط الرقم:

AS_CLI> cd SubscriberMgmt/NumberActivation

الخطوة 2: قم بتشغيل أمر التنشيط الممكّن:

AS_CLI> set dnMode groupAndUserActivationEnabled

الخطوة 3: عند مطالبة التأكيد، أدخل Y.

أداة الاستخراج

لـ BroadCloud

تم دمج أداة الاستخراج في بوابة مزود خدمة BroadCloud. يمكن لمسؤول مزود الخدمة القيام بما يلي:

  1. إرسال طلبات استخراج لما يصل إلى 50 عميلاً لكل طلب.
    لا يمكن تقديم طلب استخراج لنفس العميل أكثر من 10 مرات في اليوم.
  2. قم بتنزيل ملف البيانات المستخرج، بتنسيق ZIP، لمدة تصل إلى 28 يومًا من تاريخ تقديم الطلب.

تظهر الأشكال التالية بوابة مزود الخدمة.

شاشة بوابة مزود الخدمة تُظهر طلب استخراج الهجرة بالجملة.

الشكل 6: بوابة مقدم الخدمة

شاشة بوابة مزود الخدمة تعرض طلبات استخراج الهجرة بالجملة

الشكل 7: بوابة مقدم الخدمة

طلب استخراج CSV

بدء طلب استخراج CSV

  1. تنزيل ملف CSV الخاص بالعميل

    انقر فوق الرابط تنزيل ملف CSV للعميل في الزاوية اليمنى العليا من قسم بدء طلب استخراج ملف CSV.

  2. تعديل قائمة العملاء

    يمكن للمسؤول تحرير ملف CSV هذا ليشمل فقط العملاء الذين يتعين استخراج البيانات منهم.

  3. تحميل وإرسال

    بعد التحرير، قم بتحميل ملف CSV المعدل.

    انقر فوق إرسال لبدء طلب استخراج للعملاء المدرجين والمواقع المرتبطة بهم.

بدء طلب استخراج بيانات العميل باستخدام ملف CSV للمواقع

  1. حدد العميل ومواقع التنزيل

    اختر العميل من القائمة المنسدلة.

    قم بتنزيل ملف locations.csv المقابل من عرض العملاءعلامة التبويب المواقع تصدير المواقع بتنسيق CSV.

  2. تعديل ملف المواقع

    يمكن للمسؤول تحرير ملف CSV ليشمل فقط المواقع التي يرغب في استخراجها.

  3. تحميل وإرسال

    قم بتحميل ملف locations.csv المحرر وانقر على إرسال.

    سيتم تضمين المواقع المحددة فقط للعميل المحدد في طلب الاستخراج.

بدء طلب الاستخراج لجميع العملاء

  1. انقر فوق إرسال لبدء طلب استخراج لـ جميع العملاء و جميع مواقعهم ضمن مزود الخدمة الحالي.

الأقسام الموجودة في طلب المستخرج.

لـ Cisco BroadWorks وWebex لـ BroadWorks

  1. يتم تشغيل أداة الاستخراج على خادم Cisco BroadWorks Application Server الثانوي ضمن شبكة الشريك وتتصل عبر OCI-P.
  2. تقوم الأداة بسحب البيانات الخام الخاصة بالمؤسسة والمجموعات والأرقام والمستخدمين والخدمات والأجهزة والعملاء الناعمين من منصة Cisco BroadWorks أو BroadCloud وإخراج هذه البيانات إلى ملفات XML التي توفر المدخلات لأداة التحويل.

تشرح الأقسام التالية كيفية تثبيت أداة الاستخراج وتكوينها.

المتطلبات المسبقة

  1. يقوم SCP باستخراج الثنائيات من أداة Cisco BroadWorks Application Server الثانوية.
  2. قم بالاتصال بخادم Cisco BroadWorks Application Server الثانوي عبر SSH لتكوين المتطلبات الأساسية وتشغيل أداة الاستخراج.
  3. قم بتكوين مزود الخدمة ومعرف المجموعة لاستخراجهما من Cisco BroadWorks في conf/exportTool.yml. راجع مقتطف YAML النموذجي التالي:
    ServiceProviderID-A:
         - GroupID-A1
         - GroupID-A2
         - GroupID-A3
    ServiceProviderID-B:
                           - ALL
    
  4. تأكد من صحة معرف المستخدم وكلمة المرور واسم المضيف لخادم تطبيق Cisco BroadWorks الثانوي في conf/partner.cfg ملف:
    BROADWORKS_USER_ID = admin
    BROADWORKS_PASSWORD = admin
    BROADWORKS_HOST_NAME = localhost
    REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.
    

    الخاصية REFRESH_TOKEN إلزامية للانتقال إلى Webex for BroadWorks.

  5. تعديل JDK/JRE مسار البيئة في ملف export.sh إذا كان خادم Cisco BroadWorks Application Server الثانوي JDK/JRE مسار البيئة مختلف عن الملف:
    JAVA_HOME=/usr/local/java/java_base

تعليمات التشغيل

قم بتشغيل الأمر التالي في خادم Cisco BroadWorks Application Server الثانوي من دليل أداة الاستخراج:

./export.sh

سجلات المحطة الطرفية

تتوفر السجلات التالية في المحطة الطرفية عند التصدير الناجح: تشغيل أداة تصدير البيانات BroadSoft:

 Running BroadSoft Data Export Tool
************************************************
Starting Export Tool v: 1.15.0
Export started for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Exporting users for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export users completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed
Export Dump Zip Directory : output/20221017223452_ExportTool
Export Dump Zip File name :extracted_data_1666060500618.zip
Zip file with the name extracted_data_1666060500618.zip has been created
ZIP file creation process completed 
Exported files converted as ZIP file
**************************************************

الناتج

يتوفر ملف إخراج ZIP (extracted_data_<timestamp>.zip) في نفس دليل أداة الاستخراج. استخدم الأمر التالي لعرض ملف ZIP واستخدامه لإدخال أداة التحويل:

ls –ltr
drwxr-xr-x 2 bwadmin bwadmin   4096 Oct  4 11:53 lib/
-rwxr-xr-x 1 bwadmin bwadmin 956719 Oct  4 11:53 exportTool.jar
-rwxr-xr-x 1 bwadmin bwadmin   2635 Oct  4 11:53 export.sh
drwxr-xr-x 2 bwadmin bwadmin   4096 Oct  5 05:04 conf/
drwxrwxr-x 3 bwadmin bwadmin   4096 Oct 17 22:34 output/
drwxrwxr-x 2 bwadmin bwadmin   4096 Oct 17 22:34 logs/
-rw-rw-r-- 1 bwadmin bwadmin  46341 Oct 17 22:35 extracted_data_1666060500618.zip

أداة التحويل

يتم تشغيل أداة التحويل هذه لجميع عمليات الترحيل. يتم تشغيل أداة التحويل على أي جهاز كمبيوتر، بما في ذلك الكمبيوتر المحمول الخاص بمسؤول الشريك، وتستخدم واجهات برمجة التطبيقات العامة Webex. يقوم بقراءة ملف ZIP الناتج عن أداة الاستخراج (extracted_data_<timestamp>.zip) كمدخل ويحول XML الخام إلى تنسيق JSON الذي تستخدمه أداة التجهيز.

المتطلبات المسبقة

بعد تنزيل ملفات الثنائيات لأدوات الترحيل واستخراجها، قم بتكوين المتطلبات الأساسية التالية:

  1. قم بتعيين رمز التحديث_(الرمز المنسوخ من أداة إنشاء الرمز) واسم_الموقع [_الرئيسي_في conf/partner.cfg ملف:
    REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
    NAME_OF_MAIN_LOCATION=Main
    
  2. يمكنك اختياريًا تعيين معرف التزويد_(الذي تم نسخه من القالب في مركز الشركاء) في conf/partner.cfg ملف:
    PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1
    للحصول على تحقق أكثر اكتمالاً لعنوان البريد الإلكتروني للعميل، يمكنك بشكل اختياري تعيين معرف التزويد_.
  3. تكوين المعلومات المفقودة في input/customers.csv الملف (انظر القسم التالي) إذا كان مفقودًا.
  4. أضف عنوان البريد الإلكتروني للمستخدم النهائي في input/users.csv ملف.
  5. إذا كان من المقرر تجهيز هواتف جديدة، فأضف عنوان MAC وعنوان البريد الإلكتروني للهاتف الجديد للمستخدم إلى input/newphones.csv ملف. هذا مطلوب فقط إذا أراد مسؤولو الشركاء توفير هواتف جديدة في المكالمات بالجملة.
  6. قم بتحويل مراكز الاتصال BroadWorks إلى CxEssentials باستخدام input/cxessentials.csv ملف.
  7. اختياريًا، قم بتمكين الخاصية UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS لتحويل جميع مراكز الاتصال إلى CxEssentials.
  8. استخدم input/locations.csv ملف لدعم هجرة المؤسسات الكبيرة التي تسمح للمسؤولين بنقل مواقع عملائهم حسب الموقع
  9. يمكنك بشكل اختياري تمكين استخدام عناوين MAC من رأس User-Agent لرسالة SIP REGISTER عندما لا يتوفر عنوان MAC في ملف تعريف جهاز Cisco BroadWorks. قم بإلغاء تعليق السطر "USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes" في الملف conf/partner.cfg
  10. تتيح ميزة مزامنة خادم الشبكة للمسؤولين توفير أرقام الهواتف وعناوين MAC وعناوين البريد الإلكتروني للمستخدمين أثناء التوفير في نفس منطقة الهجرة. لتفعيله، قم بتعيين USE_NS_SYNC=yes في conf/partner.cfg.

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

  11. يمكنك بشكل اختياري تمكين خصائص ANALOG_USER_TYPE_ENABLE_CALL_WAITING، وANALOG__USER_[] TYPE ENABLE_MUSIC_ON_HOLD، وANALOG_USER_TYPE_DISABLE_T38 لتكوين انتظار المكالمات، وتعليق الموسيقى، وتعطيل إعدادات T38 لجميع مستخدمي النوع التناظري.

ملء input/customers.csv

الملف input/customers.csv يوفر بيانات قد تكون مفقودة في Cisco BroadWorks أو BroadCloud. يمكن ترك هذا الملف فارغًا إذا كانت جميع المعلومات الإلزامية متوفرة بالفعل. لا يلزمك ملء جميع الأعمدة، فقط المعلومات المفقودة هي الإلزامية.

جميع هذه الحقول اختيارية.

يوضح الجدول أدناه أهم الأعمدة في input/customers.csv.

اسم العمود

القواعد

المعرف

في وضع المؤسسة في Cisco BroadWorks:

  • هذا هو معرف مزود خدمة Cisco BroadWorks للمؤسسة.
  • كما أن هناك حاجة إلى خط منفصل لكل مجموعة داخل المؤسسة. المعرف هو معرف مجموعة Cisco BroadWorks.

في وضع موفر خدمة BroadWorks، هذا هو معرف مجموعة Cisco BroadWorks.

في BroadCloud، هذا هو معرف عميل Rialto.

معرف خارجي

هذا هو المعرف الذي يتطابق مع المعرف الداخلي للشريك لهذا العميل. يجب أن يكون هذا العمود فريدًا ضمن مؤسسة شريكة Webex. هذا العمود اختياري، وسيتم إنشاء معرف فريد تلقائيًا بواسطة أداة التحويل.

لا يتم استخدام هذا العمود للمجموعات داخل المؤسسة.

اسم العميل

بالنسبة للمؤسسة، يتم استخدام هذا العمود كحقل اسم عميل Webex.

بالنسبة لمجموعة داخل مؤسسة، يتم استخدام هذا العمود كاسم موقع. يجب أن تكون أسماء المواقع فريدة داخل المؤسسة.

البريد الإلكتروني الأساسي

يتم استخدام هذا كعنوان البريد الإلكتروني لمسؤول عملاء Webex.

يعد هذا العمود اختياريًا للمجموعات داخل المؤسسة.

أعمدة العناوين

بالنسبة للمؤسسة، يتم استخدام العنوان كعنوان إرسال الفواتير وعنوان الموقع الأول.

بالنسبة لمجموعة داخل مؤسسة، يتم استخدام العنوان كعنوان موقع.

المنطقة الزمنية

يرجى الرجوع إلى قسم المنطقة الزمنية في هذه المقالة.

اللغة

انظر اللغات التي يدعمها Webex.

رقم التعريف الشخصي للبريد الصوتي الافتراضي

انظر تعيين رقم التعريف الشخصي للبريد الصوتي.

ملء input/users.csv

الملف input/users.csv يوفر بيانات قد تكون مفقودة في Cisco BroadWorks أو BroadCloud. يمكن ترك هذا الملف فارغًا إذا كانت جميع المعلومات الإلزامية متوفرة بالفعل. لا يلزمك ملء جميع الأعمدة، فقط المعلومات المفقودة هي الإلزامية.

جميع هذه الحقول اختيارية.

اسم العمود

القواعد

معرف المستخدم

معرف فريد للمستخدم. يمكن أن يكون هذا معرف مستخدم BroadWorks أو BroadCloud.

البريد الإلكتروني

(اختياري) عنوان البريد الإلكتروني للمستخدم. إذا تم توفيرها، فسيتم استخدامها لأغراض التجهيز.

رقم التليفون

(اختياري) رقم هاتف المستخدم الذي سيتم توفيره.

حزمة

(اختياري) نوع حزمة المستخدم. القيم المسموح بها: الصوت، الاتصال، المجموعة، common_area، virtual_line، dont_migrate، أو call_park_ext.

يتم استخدام القيمة dont_migrate عندما يرغب الشركاء في استبعاد مستخدمين معينين - إلى جانب أجهزتهم وأرقام هواتفهم - من كل من التجهيز والهجرة.

يتم دعم هذا لكل من BroadWorks و BroadCloud. عند التطبيق، لن يتم ترحيل المستخدمين المحددين والموارد المرتبطة بهم أو توفيرها.

لاستخدام هذا، يجب على المسؤولين إدخال dont_migrate في عمود الحزمة في ملف users.csv.

التوسع

(اختياري) ملحق الهاتف الذي سيتم تعيينه للمستخدم.

الاسم

(اختياري) الاسم الكامل للمستخدم.

ata_settings

(اختياري) القيم المسموح بها: t38، التناظرية

ل enable/disable انتظار المكالمات، وتعليق الموسيقى، وإعدادات T38

T38:

يؤدي هذا الخيار إلى تعطيل انتظار المكالمات وتعليق الموسيقى، وتمكين إعدادات T38 لأجهزة ATA.

التناظرية:

  • على غرار خيار T38، يعمل هذا الإعداد أيضًا على تعطيل انتظار المكالمات والموسيقى قيد الانتظار، وتمكين T38 لأجهزة ATA.
  • الميزة الرئيسية للخيار التناظري هي أنه يمكن التحكم في هذه الميزات عبر ملفات partner.cfg، مما يوفر المزيد من المرونة للتكوين.

do_not_move_phone

BroadWorks فقط. علم اختياري لمنع انتقال الجهاز إلى Webex Calling.

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

هذا الإعداد متاح فقط لـ BroadWorks، وليس لـ BroadCloud.

لاستخدامه، يجب على المسؤولين تحديد do_not_move_phone في العمود do_not_move_phone (BroadWorks فقط) من ملف users.csv.

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

تعليمات التشغيل

قم بتشغيل أداة التحويل في أي نظام تشغيل. استخدم الخطوات أدناه لتشغيل الأداة في Windows وmacOS:

Windows

قم بتنفيذ الأمر أدناه لتشغيل أداة التحويل في Windows:

transform.bat -extract= -customers= -users= -newphones=

ماك أو إس

قم بتنفيذ الخطوات التالية لتشغيل أداة التحويل على نظام macOS:

  1. قم بإنشاء بيئة افتراضية وقم بتثبيت التبعيات لتشغيل أداة التحويل باستخدام Python:
    python3 -m venv venv
    source venv/bin/activate
    python3 -m pip install requests
    python3 -m pip install requests-oauthlib
    python3 -m pip install phonenumbers
    
  2. تشغيل أداة التحويل:
    ./transform.sh -extract= -customers= -users= -newphones=

Customer/user فحص مسبق

تقوم أداة التحويل بإجراء مكالمات API إلى Webex لالتقاط مشكلات التزويد المحتملة. بشكل افتراضي، سيتم التحقق من صحة عنوان العميل والبريد الإلكتروني الأساسي. إذا تم تحديد قيمة معرف التزويد_في conf/partner.cfg الملف، وسوف يقوم أيضًا بالتحقق من صحة معلومات الموقع. يتم تضمين نتائج الفحص المسبق في تقرير الاستثناء.

بالإضافة إلى ذلك، يمكن إضافة المعلمات الاختيارية التالية عند تشغيل أداة التحويل:

فحص مسبق

بالإضافة إلى تشغيل واجهة برمجة التطبيقات للتحقق المسبق من معلومات العميل، ستقوم أداة التحويل أيضًا بتشغيل واجهة برمجة التطبيقات للتحقق المسبق من رسائل البريد الإلكتروني للمشتركين.

معلومات التحقق المسبق

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

يستغرقprecheckinfo وقتًا إضافيًا للتشغيل.

سجلات المحطة الطرفية

يتم تسجيل البيانات التالية في المحطة عند التحويل الناجح:

Summary Report
BroadWorks enterprises that can be successfully migrated: 1
BroadWorks enterprises that cannot be migrated: 0
BroadWorks users that can be successfully migrated: 4
BroadWorks users that cannot be migrated: 0
Phones that can be successfully migrated: 3
Phones that are not compatible with Webex Calling: 0

تقرير الاستثناء

أداة التحويل تولد تقرير الاستثناء داخل output/<timestamp>/exception_report.txt الدليل. يمكنك استخدام هذا التقرير لتحديد المشكلات التي ستؤثر على عملية الترحيل وإصلاحها في نظام Cisco BroadWorks.

بعد تعديل بيانات المستخدم لحل الاستثناء، أعد تشغيل أدوات الاستخراج والتحويل باستخدام البيانات الجديدة. ملف تقرير الاستثناء العينة على النحو التالي:

Exception Report
Tue Oct 18 08:12:09 2022

Enterprises with Communication Barring Feature
Recommendation: manually configure the Outgoing Calling Plan in Control Hub
________________________________________________________________________________
collabmigrationtestGRP_engg

الناتج

سيكون ملف إخراج JSON (customer.json) متاحًا في output/<timestamp>/<groupid> الدليل. ملف العينة customer.json هو كما يلي:

{
    "customer": {
        "provisioningId": "!!!!!!!!!!REPLACE_WITH_PROVISIONINGID!!!!!!!!!!",
        "packages": [
            "webex_calling",
            "common_area_calling"
        ],
        "externalId": "external_id_engg_grp1",
        "address": {
            "addressLine1": "100 Main Street",
            "addressLine2": "",
            "city": "Gaithersburg",
            "stateOrProvince": "MD",
            "zipOrPostalCode": "20877",
            "country": "US"
        },
        "customerInfo": {
            "name": "Engineering Group - 1",
            "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com"
        },
        "provisioningParameters": {
            "calling": {
                "location": {
                    "name": "Main",
                    "address": {
                        "addressLine1": "100 Main Street",
                        "addressLine2": "",
                        "city": "Gaithersburg",
                        "stateOrProvince": "MD",
                        "zipOrPostalCode": "20877",
                        "country": "US"
                    },
                    "timezone": "America/New_York",
                    "language": "en_us",
                    "numbers": [
                        "+15205551101",
                        "+15205551102",
                        "+15205551103",
                        "+15205551104",
                        "+15205551105",
                        "+15205551106",
                        "+15205551107",
                        "+15205551108",
                        "+15205551109",
                        "+15205551110"
                    ],
                    "mainNumber": "+15205551101"
                }
            }
        }
    },
    "broadworks_info": {
        "service_provider_id": "collabmigrationtestSP_engg",
        "group_id": "collabmigrationtestGRP_engg"
    },
    "subscribers": [
        {
            "amareswaranvel+benjaminjack@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+benjaminjack@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Benjamin",
                        "lastName": "Jack",
                        "primaryPhoneNumber": "+15205551102",
                        "extension": "1102"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering17861@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 7861",
                        "mac": "CC98914EAAD7"
                    }
                ]
            }
        },
        {
            "amareswaranvel+lucasoliver@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+lucasoliver@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Lucas",
                        "lastName": "Oliver",
                        "primaryPhoneNumber": "+15205551103",
                        "extension": "1103"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering16821@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 6821",
                        "mac": "5486BCAE7E45"
                    }
                ]
            }
        },
        {
            "amareswaranvel+leojackson@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+leojackson@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Leo",
                        "lastName": "Jackson",
                        "primaryPhoneNumber": "+15205551104",
                        "extension": "1104"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineeringmacpc@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": []
            }
        },
        {
            "amareswaranvel+owenalex@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+owenalex@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Owen",
                        "lastName": "Alexander",
                        "primaryPhoneNumber": "+15205551101",
                        "extension": "1101"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering8811@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 8811",
                        "mac": "F87B204E4066"
                    }
                ]
            }
        }
    ],
    "auto_attendants": [],
    "call_queues": [],
    "hunt_groups": [],
    "schedules": [],
    "call_parks": [],
    "call_pickups": [],
    "paging_groups": [],
    "voice_portals": [
        {
            "name": "Automated Voice Portal",
            "firstName": "Automated",
            "lastName": "Voice Portal",
            "languageCode": "en_us",
            "phoneNumber": "+15205551105",
            "extension": "1105"
        }
    ],
    "shared_call_appearances": [],
    "business_communicator_desktop_to_upgrade_to_webex_app": [
        "PC Comm - Engg Device Profile"
    ],
    "connect_client_to_upgrade_to_webex_app": [],
    "locations": [],
"webex_for_broadworks_info": {
        "users": [
            {
                "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5"
            }
        ],
        "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg",
        "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk"
    }
}

ال `webex_for_broadworks_info` تتوفر خاصية JSON لعمليات نقل Webex لـ BroadWorks فقط. ال `broadcloud_info` تتوفر خاصية JSON لعمليات نقل BroadCloud فقط.

أداة التجهيز

يمكن تشغيل أداة التجهيز على أي جهاز، عادةً (الكمبيوتر المحمول الخاص بمسؤول الشريك) وتستخدم واجهات برمجة التطبيقات العامة Webex. يقوم بقراءة ملف JSON الناتج عن أداة التحويل (customer.json) كمدخل وتوفير العملاء والمواقع والأرقام والمستخدمين والخدمات والأجهزة في حل Webex Wholesale RTM.

المتطلبات المسبقة

قم بتكوين المتطلبات الأساسية التالية داخل دليل أداة التجهيز:

  1. قم بتثبيت Java 8، 11، 17، أو 21 على الكمبيوتر. تتوفر لغة Java من مصادر عديدة، بما في ذلك:
  2. بعد تنزيل ملفات الثنائيات لأدوات الهجرة واستخراجها، قم بتعيين متغير بيئة JAVA_HOME في provisioning_tool.sh لنظام MAC و provisioning_tool.bat لنظام Windows.
  3. ملف partner.cfg:
    • قم بتعيين معرف WHOLESALE_PROVISIONING_ورمز REFRESH_(الرمز المنسوخ من أداة إنشاء الرمز). يتعين على مسؤولي الشركاء الاتصال بفريق حساباتهم للحصول على معرف التزويد_:
      WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
      REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
      
    • قم بتعيين ALLOW_ADMIN_INVITE_EMAILS إلى false، إذا كان الشريك لا يريد إرسال رسالة ترحيب بالبريد الإلكتروني للمستخدمين. القيمة الافتراضية هي true.

  4. استخدم خاصية WEBEX4BWKS_EMAIL_SUBJECT لعمليات نقل Webex for BroadWorks لإرسال موضوع بريد إلكتروني لطلب تغيير كلمة المرور لمشتركي Webex for BroadWorks.
  5. استخدم خاصية WEBEX4BWKS_EMAIL_BODY لعمليات نقل Webex for BroadWorks لإرسال نص بريد إلكتروني لطلب تغيير كلمة المرور لمشتركي Webex for BroadWorks.
  6. تتيح ميزة مزامنة خادم الشبكة للمسؤولين توفير أرقام الهواتف وعناوين MAC وعناوين البريد الإلكتروني للمستخدمين أثناء التوفير في نفس منطقة الهجرة. لتفعيله، قم بتعيين USE_NS_SYNC=yes في conf/partner.cfg.

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

بالنسبة لعمليات الترحيل عبر BroadCloud في نفس المنطقة:

  1. تتخطى الأداة إعداد الأرقام والأجهزة ومظاهر المكالمات المشتركة.
  2. تقوم الأداة بإنشاء مستخدمين ومستخدمين افتراضيين مع ملحق وملحق مؤقت.

بالنسبة لترحيلات BroadCloud إلى منطقة أخرى:

  1. ستقوم الأداة بتزويد الأرقام والأجهزة ومظاهر المكالمات المشتركة.
  2. تقوم الأداة بإنشاء مستخدمين ومستخدمين افتراضيين بأرقام هواتف وامتدادات فعلية.
    تتم جميع عمليات هجرة BroadCloud في أوروبا إلى منطقة أخرى.

تعليمات التشغيل

استخدم الخطوات التالية لتشغيل الأداة في Windows وmacOS:

Windows

قم بتنفيذ الخطوات التالية لتشغيل الأداة على نظام التشغيل Windows:

To provision single customer:
provision.bat -input=
To provision multiple customers:
provision.bat -input= 

ماك أو إس

قم بتنفيذ الخطوات التالية لتشغيل الأداة على نظام macOS:

To provision single customer:
./transform.sh -input=
To provision multiple customers:
./transform.sh -input=

المتطلبات الأساسية للانتقال إلى Webex لـ BroadWorks

يتعين على مسؤولي الشركاء تحديث قالب التوجيه الخاص بـ BroadWorks الخاص بهم لميزات التعايش مع Webex for BroadWorks. انظر إلى الصورة التالية:

بمجرد تحديث قالب Webex for BroadWorks Onboarding لدعم الترحيل، اطلب من فريق حساب Cisco تمكين تبديل ميزة "تمكين دمج شركاء البيع بالجملة" على مستوى الشريك. سيسمح هذا بإضافة حزم البيع بالجملة إلى مؤسسات عملاء Webex for BroadWorks الموجودة أثناء التجهيز.

قم بتشغيل أداة التجهيز باستخدام وسيطة إضافية.

مرحلة التحضير: هي المرحلة الافتراضية التي يمكن للمسؤولين من خلالها توفير مستخدمي BroadWorks كمشتركين بالجملة ومتابعة استخدام Webex لمستخدمي BroadWorks.

مرحلة الصيانة: هذه هي المرحلة الثانية حيث يمكن للمسؤولين تعيين ترخيص البيع بالجملة لمستخدمي Webex for BroadWorks الحاليين. يجب تشغيل أداة التجهيز باستخدام وسيطة الصيانة.

مرحلة ما بعد الهجرة: هي المرحلة النهائية التي يستطيع فيها المسؤولون تحويل BroadWorks إلى Wholesale بالكامل. يجب تشغيل أداة التجهيز باستخدام وسيطة postmigration.

سجلات المحطة الطرفية

فيما يلي سجلات التجهيز الناجحة في المحطة الطرفية:

Tool Name: Provisioning Tool
Version: 1.15.0
 
********** Started Processing File : input/customer.json ****************
 
Provisioning Customer
Waiting for customer external_id_engg_grp1 to complete provisioning...
Waiting for customer external_id_engg_grp1 to complete provisioning...
 
Customer external_id_engg_grp1 status : provisioned
Provisioning Numbers
Provisioning Users
Provisioning User Features
Provisioning Greetings
Provisioning Schedules
Provisioning Devices
Provisioning Shared Call Appearances
Provisioning Auto Attendants
Provisioning Call Queues
Provisioning Hunt Groups
Provisioning Group Pagings
Provisioning Call Parks
Provisioning Call Pickups
Provisioning Voice Portal
 
********** Completed File : input/customer.json ****************

سيتم طباعة جدول بعدد المواقع التي تم إنشاؤها لكل تشغيل:

جدول يوضح عدد المواقع التي تم إنشاؤها لكل تشغيل.

الناتج

تولد أداة التجهيز تقارير النجاح والأخطاء داخل output/<external_id>/*.success/error الملفات. قم بمراجعة سجلات نجاح وأخطاء الإخراج للتحقق من نجاح التجهيز.

بعد التجهيز الناجح، سيتلقى مسؤولو العملاء والمستخدمون النهائيون رسالة بريد إلكتروني من حل Wholesale RTM.

يمكن لمسؤولي الشركاء التحقق من توفير العملاء في بوابة Partner Hub وControl Hub. يرجى الرجوع إلى الرسوم التوضيحية التالية من بوابة مركز الشركاء ومركز التحكم:

لقطة شاشة لمركز الشركاء تُظهر البحث عن عميل الجملة في حقل القائمة المنسدلة "تحديد العميل".

الشكل 8: مركز الشركاء

لقطة شاشة لمركز التحكم تُظهر علامة التبويب "المستخدمين" وقائمة المستخدمين.

الشكل 9: Control Hub

لقطة شاشة لمركز التحكم تُظهر شاشة الأجهزة وقائمة الأجهزة.

الشكل 10: الأجهزة

لقطة شاشة لمركز التحكم تُظهر شاشة الأرقام وقائمة بأرقام الهواتف.

الشكل 11: الاتصال

أداة نقل الجهاز

لـ BroadCloud

بالنسبة لشركاء BroadCloud، استخدم بوابة مزود الخدمة لإرسال طلب ترحيل للأرقام والأجهزة وعمليات ترحيل ظهور المكالمات المشتركة (SCA).

ضمن بوابة مزود الخدمة، يمكن لطلب الهجرة أن يتضمن ما يصل إلى 50 عميلاً. يمكن تقديم ما يصل إلى 10 طلبات خلال يوم واحد.

تتيح ميزة Network Server Sync للمسؤولين إلغاء تنشيط موقع broadCloud وتنشيط موقع Webex Calling عند تعيين USE_NS_SYNC=yes في conf/partner.cfg. بعد الترحيل، يتم تنشيط الأجهزة وأرقام الهواتف في موقع Webex Calling.

يمكن للمسؤولين تمكين التراجع التلقائي عن طريق تعيين ROLLBACK_TO_BROADCLOUD=true في ملف conf/partner.cfg ، والذي ينقل الأجهزة مرة أخرى إلى BroadCloud بعد الترحيل. إنه يدعم كل من عمليات الهجرة إلى نفس المنطقة أو إلى منطقة مختلفة باستخدام NS Sync، ولكن فقط لعمليات الهجرة الناجحة. بالنسبة للحالات الفاشلة، يجب على المسؤولين رفع أمر TAC الخاص بـ Cisco قبل طلب التراجع.

هناك خياران متاحان لاختيار نوع الهجرة في البوابة:

  • الهجرة – حدد هذا الخيار لبدء طلب ترحيل الأرقام والأجهزة ومظاهر المكالمات المشتركة (SCA).
  • حالة الجهاز – حدد هذا الخيار لعرض الحالة الحالية للجهاز على BroadCloud والاتصال.

تظهر الأشكال التالية بوابة مزود الخدمة.

بوابة مقدم الخدمة

الشكل 12: بوابة مقدم الخدمة

بوابة مزود الخدمة تظهر عرض طلب الهجرة.

الشكل 13: بوابة مقدم الخدمة

ترحيل المواقع المحددة (اختياري)

لبدء عملية الترحيل لمجموعة فرعية محددة من المواقع المدرجة في الملف customer.json ، قم بتضمين ملف locations.csv مع طلبك. يجب أن يتضمن ملف CSV هذا فقط المواقع التي تنوي نقلها.

عندما لا يتم توفير locations.csv، سيتم ترحيل جميع المواقع الموجودة في customer.json.

الجدول 1. أساطير Locations.csv
مصطلحتعريف

معرف الموقع

معرف الموقع للموقع الذي سيتم نقله.

اسم الموقع

اسم الموقع الذي سيتم نقله.

لتنزيل قائمة المواقع النشطة المتاحة انتقل إلى عرض العملاء → تحديد عميل → تصدير المواقع بتنسيق CSV.

تصدير المواقع بتنسيق CSV

الشكل 14: تصدير المواقع بتنسيق CSV

لـ Cisco BroadWorks وWebex لـ BroadWorks

بالنسبة لعمليات نقل Cisco BroadWorks وWebex for BroadWorks، يتم تشغيل الأداة على خادم Cisco BroadWorks Application Server الثانوي ضمن شبكة الشريك وتتصل بـ AS من خلال OCI-P. يستخدم ملف JSON الناتج عن أداة التحويل (customer.json) كمدخل ويقوم بتشغيل أوامر OCI-P لترحيل الأجهزة والعملاء الناعمين.

في حالة التشغيل الناجح، ستقوم أداة تحريك الجهاز بما يلي:

  1. قم بإلغاء تسجيل الأجهزة من Cisco BroadWorks وقم بتسجيلها في Wholesale.
  2. سيتم إعادة توجيه المستخدمين الذين يستخدمون عميل UC-One إلى تطبيق Webex عند تسجيل الدخول لأول مرة.
  3. قم بإلغاء تنشيط أرقام الهاتف من Cisco BroadWorks أو قم بإزالة أرقام الهاتف من BroadCloud.
  4. تفعيل الارقام في الجملة.
  5. إنشاء ظهورات مكالمات مشتركة في Wholesale لترحيلات BroadCloud. [This الخطوة تنطبق فقط على BroadCloud migrations].
إذا لم تكن هناك أجهزة مسجلة لدى Cisco BroadWorks أو BroadCloud تحتاج إلى نقلها، فلا داعي لتشغيل أداة نقل الجهاز.

SCP و SSH

  1. SCP أداة نقل الجهاز إلى خادم Cisco BroadWorks Application Server الثانوي.
  2. قم بالاتصال عبر SSH بخادم Cisco BroadWorks Application Server الثانوي لتكوين المتطلبات الأساسية وتشغيل أداة نقل الجهاز.

المتطلبات المسبقة

  1. قم بتعيين رمز التحديث_(الرمز المنسوخ من أداة إنشاء الرمز) في conf/partner.cfg ملف:
    REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
  2. تأكد من صحة معرف المستخدم وكلمة المرور واسم المضيف لخادم تطبيق Cisco BroadWorks الثانوي في conf/deviceMoveTool.conf ملف:
    BROADWORKS_USER_ID = admin
    BROADWORKS_PASSWORD = admin
    BROADWORKS_HOST_NAME = localhost
    
  3. لإعادة إرسال رسائل البريد الإلكتروني للتفعيل، يجب عليك تعيين إعادة إرسال_الدعوة_EMAILS=true في conf/partner.cfg ملف.

    إذا رغب المسؤولون في إرسال رسائل بريد إلكتروني للدعوة إلى مستخدميهم أثناء الترحيل، فيجب عليهم إلغاء تعليق "إعادة إرسال_الدعوة_" EMAILS=true" الممتلكات في conf/partner.cfg ملف. وإلا، يجب أن تبقى الممتلكات دون تغيير.

  4. التحقق من JDK/JRE مسار البيئة صحيح في devicemove.sh
    JAVA_HOME=/usr/local/java/java_base
  5. يمكن للمسؤولين استخدام ملف locations.csv من دليل الإدخال لترحيل المجموعات المحددة بدلاً من جميع المجموعات ضمن مؤسسة واحدة.

هواتف بوليكوم

لنقل هواتف Polycom من Cisco BroadWorks إلى Wholesale Calling، يجب على مسؤول الشريك إنشاء حساب جديد Identity/Device ملف نوع الملف الشخصي على مستوى النظام في Cisco BroadWorks لكل قالب جهاز Polycom. راجع الشكل 14 وقم بتحميل الملف المخصص device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. بعد تحميل ملف الجهاز الجديد، تأكد من وجود الملف الذي تم إنشاؤه حديثًا على مستوى المجموعة. تأكد أيضًا من أن الملف migration_%BWMAC ADDRESS%.cfg لا يتعارض مع أي ملف موجود في نظامك).

device-move-tool/conf/deviceProfile/{region}/polycom_vvx2.cfg

يتم استخدامه داخليًا بواسطة أداة نقل الجهاز.

عملية الهجرة لهواتف Polycom:

  1. تعمل أداة نقل الجهاز على استبدال الملف %BWMACADDRESS%.cfg على مستوى الجهاز بـ polycom_vvx2.cfg. يشير هذا الملف إلى migration_%BWMACADDRESS%.cfg.
  2. إعادة بناء ملفات تعريف الجهاز على مستوى المجموعة أو مستوى الجهاز.
    يعتمد التصرف على مستوى المجموعة أو مستوى الجهاز على تكوين معلمة deviceLevelRebuild في الملف device-move-tool/conf/partner.cfg.
  3. تطلب أداة نقل الجهاز من Cisco BroadWorks Application Server إعادة تشغيل الهواتف على مستوى المجموعة أو مستوى الجهاز.
  4. بعد طلب إعادة التشغيل، تقوم هواتف Polycom بتنزيل ومعالجة% BWMACADDRESS%.cfg، والذي يطلب من هواتف Polycom تنزيل ومعالجة migration_%BWMACADDRESS%.cfg، والذي يضبط device.prov.serverName على https://plcm.sipflash.com.
    https://plcm.sipflash.com بالنسبة لمنطقة الولايات المتحدة، فإن المناطق الأخرى لديها عناوين URL مختلفة.
  5. يقوم هاتف Polycom بتنزيل ملف %BWMACADDRESS%.cfg من https://plcm.sipflash.com وسيتم إدارته بواسطة Webex Calling DMS.
Identity/device ملف نوع الملف الشخصي إضافة لقطة شاشة

الشكل 14: Identity/device إضافة ملف نوع الملف الشخصي

الحقل "عنوان MAC in:", استخدم نفس القيم الموجودة في الملفات الأخرى في قالب Polycom. (في الشكل 14، استخدم عنوان URI لطلب HTTP، ولكن قد لا يكون هذا مناسبًا لنشر Cisco BroadWorks Application Server الخاص بالشريك).

تعليمات التشغيل

هناك طريقتان لاستدعاء DMT، الأولى هي الاستدعاء من خلال عميل واحد في كل مرة والأخرى هي التشغيل من خلال عملاء متعددين في وقت واحد.

يتم تشغيل أداة نقل الجهاز من خادم Cisco BroadWorks Application Server الثانوي داخل دليل أداة نقل الجهاز:

For device move single customer:
./devicemove.sh -input=
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=
 ls -l /tmp/directoryofcustomers/
customer1.json 
customer2.json
customer3.json
Additionally, the device move tool supports migrate single/specific phone(s) from 1.35.0 release.
Use the command below:
./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9

سجلات المحطة الطرفية

فيما يلي السجلات الموجودة في المحطة الطرفية عند تشغيل أداة نقل الجهاز بنجاح لترحيل الجهاز:

Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started...
Valid Devices for migration :
-------------------------------------------------------------------------------------------------------------------
|    Device Type |          Mac |                                 Version |                                 Email |
-------------------------------------------------------------------------------------------------------------------
| DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com |
| DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ |  amareswaranvel+lucasoliver@gmail.com |
| DMS Cisco 8811 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ |     amareswaranvel+owenalex@gmail.com |
-------------------------------------------------------------------------------------------------------------------
Do you want to migrate all these devices? ([Y]es or [N]o) 
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Modifying profiles for Business Communicator under group collabmigrationtestGRP_engg
Activate webex phone numbers process started for customer org Id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Activate webex phone numbers process completed for customer org id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Deactivate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Deactivate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Completed

الناتج

بعد ترحيل الجهاز، أصبحت الأجهزة متصلة بالإنترنت وجاهزة make/receive مكالمات. راجع الشكل 15 لرؤية مثال لحالة الجهاز:

لقطة شاشة لصفحة أجهزة مركز التحكم تُظهر حالة الجهاز.

الشكل 15: حالة الخدمة

بعد نقل الجهاز، أصبحت الأرقام نشطة. راجع الشكل 16 لرؤية مثال للأرقام النشطة:

لقطة شاشة لشاشة أرقام مركز التحكم تعرض الأرقام النشطة.

الشكل 16: الأرقام النشطة

العودة إلى الهجرة

يجب تنفيذ عملية الإرجاع لمؤسسة واحدة في كل مرة.

لا تقوم أداة نقل الجهاز بإلغاء تنشيط الأرقام في المكالمات بالجملة بسبب القيود الفنية أثناء عملية الإرجاع.

لشركة BroadCloud Carrier

عملية العودة لشركاء BroadCloud هي كما يلي:

  1. افتح تذكرة مع Cisco TAC لطلب استعادة الجهاز.
  2. تشغيل أداة نقل الجهاز في وضع الرجوع:
    • سيتم إلغاء تعيين أرقام الهواتف من Webex Calling، مما يترك للمستخدمين والخدمات أرقامًا فرعية فقط.
    • سيتم تحويل عناوين البريد الإلكتروني في Webex Calling إلى عناوين بريد إلكتروني مؤقتة.
    • سيتم حذف الهواتف من Webex Calling.
    • سيتم إعادة إنشاء أرقام الهواتف وعناوين البريد الإلكتروني المستخدمة كمعرفات بديلة والهواتف في BroadCloud.
    • سيتم إعادة تشغيل الهواتف.
  3. يتعين على مسؤولي الشركاء نقل أرقام هواتف PSTN مرة أخرى إلى BroadCloud Carrier.

لـ Cisco BroadWorks وWebex لـ BroadWorks

عملية الإرجاع لـ Cisco BroadWorks وWebex لـ BroadWorks هي كما يلي:

  1. افتح تذكرة مع Cisco TAC لطلب استعادة الجهاز.
  2. قم بتشغيل أداة نقل الجهاز في وضع الرجوع على خادم تطبيق BroadWorks الثانوي لعكس عمليات نقل الجهاز. سيؤدي هذا إلى إعادة تعيين عنوان URL الخاص بـ DMS إلى عنوان URL الخاص بـ DMS لمزود الخدمة لملفات تعريف الأجهزة في Cisco BroadWorks وإعادة تنشيط أرقام الهواتف.
  3. يقوم فريق Webex Calling بتعيين عنوان URL الخاص بـ DMS مرة أخرى إلى عنوان URL الخاص بـ DMS لمزود الخدمة في ملفات تعريف الجهاز في Webex Calling.
  4. يتعين على مسؤولي الشركاء إلغاء تنشيط أرقام الهواتف أو حذفها في خدمة Webex Calling من خلال بوابة Control Hub.
  5. يتعين على مسؤولي الشركاء نقل أرقام هواتف PSTN مرة أخرى إلى Cisco BroadWorks.

تعليمات لتشغيل أداة نقل الجهاز في وضع الرجوع

اتبع الخطوات التالية لتشغيل أداة نقل الجهاز في وضع الرجوع:

قم بتشغيل الأمر أدناه في خادم Cisco BroadWorks Application Server الثانوي داخل دليل أداة نقل الجهاز:

استعادة الملفات الشخصية

./devicemove.sh -input=  -revertProfiles

استعادة الأرقام

./devicemove.sh -input=  -revertNumbers

سجلات المحطة الطرفية

سنحصل على السجلات التالية في المحطة الطرفية عند تشغيل أداة نقل الجهاز بنجاح لعملية التراجع:

استعادة الملفات الشخصية

Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started for Revert Process...
Devices that can be moved back from Webex Calling to BroadWorks:
- -------------------------------------------------------------------------------------------------------------------
|    Device Type |          Mac |                                 Version |                                 Email |
-------------------------------------------------------------------------------------------------------------------
| DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com |
| DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ |  amareswaranvel+lucasoliver@gmail.com |
| DMS Cisco 8811 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ |     amareswaranvel+owenalex@gmail.com |
-------------------------------------------------------------------------------------------------------------------
Do you want to move back these devices from Webex Calling to BroadWorks? (Yes, Y, No, N): 
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Device Migration Completed for Deprovision Process

استعادة الأرقام

Tool Name: Device Move Tool
Version: 1.15.0
Do you want to continue reverting numbers to Broadworks ?  ([Y]es or [N]o): 
Y
[+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110]
Starting revert
Activate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Activate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Revert process Completed Successfully

التذييل

هجرة الشركات الكبيرة

لا تستطيع المؤسسات الكبيرة التي لديها العديد من المواقع ترحيل جميع المواقع ضمن نافذة صيانة واحدة. تتيح الوظيفة الموضحة في هذا القسم للشركاء نقل عدد قليل من المواقع في وقت واحد.

الخطوات

استخدم الخطوات التالية للتخطيط للهجرات التدريجية لمؤسسة كبيرة:

  1. استخرج بيانات المؤسسة من BroadWorks أو BroadCloud.
  2. قم بتشغيل أداة التحويل بدون خيار المواقع على البيانات المستخرجة.
  3. ابحث عن قسم الموقع الموصى بنقله في وقت واحد في exception_report.txt للتخطيط لمراحل الترحيل للحصول على مزيد من المعلومات حول تبعيات الموقع، وفحص ملفات قائمة وكيل الميزات (راجع أداة التحويل أدناه).
  4. قم بإنشاء ملف input/locations.csv عن طريق تعديل locations_to_be_edited.csv.
  5. قم بتشغيل أداة التحويل مرة أخرى باستخدام خيار المواقع.
  6. قم بفحص exception_report.txt لتحديد أي مشكلات تتعلق بتبعية الموقع للمرحلة الحالية.
  7. إصلاح مشكلات اعتماد الموقع حسب الحاجة (عن طريق تعديل locations.csv).
  8. أعد تشغيل أداة التحويل لإنشاء ملف customers.json للمرحلة الحالية.
  9. قم بتشغيل أداة التجهيز لكل customer.json.
  10. أثناء فترة الصيانة، قم بتشغيل أداة نقل الجهاز.
  11. كرر الخطوات من 4 إلى 10 للمرحلة التالية.

أداة التحويل

لتحقيق هدف نقل المواقع في مؤسسة كبيرة مرحلة بمرحلة، كما ذكر أعلاه، تمت إضافة ملف جديد locations.csv كمدخل اختياري (-locations=input/locations.csv) عند تشغيل أداة التحويل.

يحتوي ملف locations.csv على بيانات خاصة بالمواقع. إنه يتجاوز البيانات الموجودة في input/customers.csv, الذي يحتوي حاليًا على بيانات المؤسسة والموقع.

يحتوي الجدول التالي على تفاصيل locations.csv:

الوصف

القيم

القيمة الافتراضية

إلزامي

الخرائط في BroadWorks

الخرائط في BroadCloud

معرف المؤسسة

معرف المؤسسة الفريد

ص

معرف مقدم الخدمة

معرف عميل ريالتو

معرف الموقع

معرف الموقع، فريد داخل المؤسسة

ص

معرف المجموعة

معرف موقع ريالتو

حالة الهجرة

هل تم نقل هذا الموقع؟

هاجر، dont_migrate، مهاجر

مهاجر

N

الاسم

اسم هذا الموقع.

اتركه فارغًا لاستخدام locationId.

N

المنطقة الزمنية

N

اللغة

N

address1

N

address2

N

المدينة

N

الدولة

N

رمز بريدي

الرمز البريدي أو الرمز البريدي

N

دولة

رمز مكون من حرفين

N

يمكن إنشاء ملف locations.csv من ملف locations_to_be_edited.csv المملوء مسبقًا عند تشغيل أداة التحويل على مؤسسة كبيرة. إقرأ المزيد لرؤية الأمثلة.

ملف location.csv هو إدخال اختياري عند تشغيل أداة التحويل، وبالتالي ستتصرف أداة التحويل بنفس الطريقة السابقة إذا كان الخيار -locations=input/locations.csv ليس موجودا.

ملفات الإخراج الجديدة

هناك 5 ملفات إخراج جديدة من أداة التحويل:

  • locations_to_be_edited.csv – يتم ملء هذا الملف مسبقًا بمعلومات جميع المواقع الخاصة بالمؤسسة الكبيرة التي سيتم نقلها.

مثال:

locationId,enterpriseId,migration status,name,timezone,language,address1,address2,city,state,postal code,country 

auto_mig_ent_grp1,auto_mig_ent,,auto_mig_ent_grp1,,,100 Main Street,,Gaithersburg,MD,20877,US 

auto_mig_ent_grp2,auto_mig_ent,,auto_mig_ent_grp2,,,101 Main Street,,Gaithersburg,MD,20877,US 

auto_mig_ent_grp3,auto_mig_ent,,auto_mig_ent_grp3,,,102 Main Street,,Gaithersburg,MD,20877,US 

ال partners/customers يمكنك استخدامه لإنشاء مواقع.csv للتحكم في المواقع التي سيتم ترحيلها لمرحلة معينة (وتحديث معلومات المواقع حسب الحاجة).

مثال: locations.csv تم إنشاؤه من locations_to_be_edited.csvأعلاه

locationId,enterpriseId,migration status,name,timezone,language,address1,address2,city,state,postal code,country 

auto_mig_ent_grp1,auto_mig_ent,migrated,auto_mig_ent_grp1,,,100 Main Street,,Gaithersburg,MD,20877,US 

auto_mig_ent_grp2,auto_mig_ent,migrating,auto_mig_ent_grp2,,,101 Main Street,,Gaithersburg,MD,20877,US 

auto_mig_ent_grp3,auto_mig_ent,dont_migrate,auto_mig_ent_grp3,,,102 Main Street,,Gaithersburg,MD,20877,US 

هذا locations.csvيعني: لهذه المرحلة، تم ترحيل الموقع auto_mig_ent_grp1، والموقع auto_mig_ent_grp2 يهاجر، ولا تهاجر الموقع auto_mig_ent_grp3.

  • hunt_group_agents.csv, call_center_agents_supervisors.csv, paging_group_originators_targets.csv, blf_monitored_elements.csv – 4 ملفات لها نفس الغرض: إنشاء قوائم كاملة للميزات المقابلة agents/supervisors/originators/targets/monitored_elements في المواقع المهاجرة إذا كانت المواقع المهاجرة تعتمد على مواقع أخرى.

لديهم نفس التنسيق تقريبًا (يختلف اسم العمود الثالث بناءً على الميزة)، مثل (قائمة وكلاء مجموعة الصيدauto_mig_ent_grp[2] للمرحلة المذكورة أعلاه):

مثال: ما يلي من hunt_group_agents.csv

feature name,feature location,agent,location 

Sarah Rodriguez,auto_mig_ent_grp2,agent_michael@domain.com,auto_mig_ent_grp1 

Sarah Rodriguez,auto_mig_ent_grp2,agent_sally@domain.com,auto_mig_ent_grp1 

إذا لم يكن خيار المواقع موجودًا عند تشغيل أداة التحويل، فسوف تقوم الملفات الأربعة المذكورة أعلاه بإنشاء القوائم الكاملة لـ hunt-group/call-center/paging-group/busy-lamp-field’s agents/supervisors/originators/targets/monitored_elements للمؤسسة بأكملها، والتي يمكن استخدامها للتخطيط للهجرات التدريجية.

أقسام جديدة في exception_report

أثناء إجراء الترحيل التدريجي للمؤسسات الكبيرة، سيكون هناك بعض الأقسام الجديدة في exception_report.txt إذا كانت هناك تبعيات موقع غير مستوفاة.

مثال: القسم الجديد التالي مخصص لمجموعة الصيد الخاصة بموقع auto_mig_ent_grp2 الخاصة بوكلاء سارة رودريجيز في موقع auto_mig_ent_grp3 الذي لم يتم هجرته ولم يتم هجرته في هذه المرحلة.

Dependencies between locations - Hunt groups 

Name                          Location                        Agent                                            Agent's Location         Comment 

________________________________________________________________________________________________________________ 

Sarah Rodriguez       auto_mig_ent_grp2    agent_william@domain.com    auto_mig_ent_grp3    Agent in different location not migrated yet 

Sarah Rodriguez       auto_mig_ent_grp2   agent_melody@domain.com     auto_mig_ent_grp3    Agent in different location not migrated yet 

يقدم القسم الجديد التالي توصيات حول كيفية تجميع المواقع في مراحل الترحيل.

المواقع الموصى بها للتحرك في وقت واحد:

Location auto_mig_ent_grp1 has dependency on location(s) auto_mig_ent_grp2, auto_mig_ent_grp3 

Location auto_mig_ent_grp2 has dependency on location(s) auto_mig_ent_grp3

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

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

أداة التجهيز

بالنسبة للمؤسسات الكبيرة، يمكن تشغيل أداة التجهيز كالمعتاد.

أداة نقل الجهاز

يمكن تشغيل أداة نقل الجهاز لمجموعة فرعية من المواقع من customer.json. لتحقيق ذلك، أضف ملف locations.csv اختياريًا جديدًا يحتوي على عمودين.

External_id

أسماء المواقع

قيمة المعرف الخارجي

أسماء locations/group أسماء

  • هذا ملف اختياري، إذا لم يتم توفيره أو تم توفيره بالقيم الفارغة فسوف يقوم بنقل جميع المواقع.
  • إذا تم توفير أسماء المواقع ومعرفات external_الخاصة بها، فسيتم ترحيل تلك المواقع فقط.

الأمر هو كما يلي:

./devicemove.sh -input=/customer.json -locations=/Location_names.csv

المناطق الزمنية

الولايات المتحدة الأمريكية:

"timeZones":["America/Adak","America/Anchorage","America/Chicago","America/Denver","America/Los_Angeles","America/New_York","America/Phoenix","Pacific/Honolulu"]

كندا:

"timeZones":["America/Dawson_Creek","America/Edmonton","America/Halifax","America/Montreal","America/Regina","America/St_Johns","America/Vancouver","America/Winnipeg"]

أستراليا:

"timeZones":["Australia/Adelaide","Australia/Brisbane","Australia/Broken_Hill","Australia/Darwin","Australia/Hobart","Australia/Lord_Howe","Australia/Perth","Australia/Sydney"]

فرنسا:

"timeZones":["Europe/Paris"]

البرتغال:

"timeZones":["Atlantic/Azores","Europe/Lisbon"]}

المملكة المتحدة:

"timeZones":["Europe/London"]

إيطاليا:

"timeZones":["Europe/Rome"]

ألمانيا:

"timeZones":["Europe/Berlin"]