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

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

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

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

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

قم بتعيين مسار بيئة JRE/JDK في token_generator.sh لنظام التشغيل MAC وtoken_generator.bat لنظام التشغيل Windows. إذا كان مسار JAVA_HOME موجودًا بالفعل، فسيتم إعادة استخدامه بواسطة الأداة.

• جهاز الماك: JAVA_HOME="/Users/cisco/jdk/zulu@1.8.282/Contents/Home/"

• نظام التشغيل Windows: JAVA_الصفحة الرئيسية=C:\Progra~1\Java\jre1.8.0_321

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

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

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

token_generator.bat

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

./token_generator.sh

الخرج:

اسم الأداة: إصدار أداة مُنشئ الرمز: 1.13.0 تحميل عنوان URL في مستعرض الويب الخاص بك: http://localhost:8080 

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

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

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

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

الشكل رقم 5: إنشاء الرمز المميز

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

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

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

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

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

AS_CLI> الأقراص المدمجة /التطبيقات/OpenClientServer/GeneralSettings.

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

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

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

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

تغيير الدليل إلى وكيل OCI:

AS_CLI> الأقراص المدمجة /التطبيقات/OpenClientServer/OCIProxy

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

AS_CLI/Applications/OpenClientServer/OCIProxy> get enabled = true enabledLoginLevelScreening = false enableResponseCaching = false responseCacheDurationHours = 24 استجابةCacheRenewPeriodMins = 30 رسالةQueueCapacity = 50 رسالةQueueTimeoutSeconds = 1800 

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

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

التغيير إلى دليل التوفير:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

شغّل الأمر التالي للحصول على إعدادات توفير OCI الحالية:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> الحصول على وصف العنوان ======================== 127.0.0.1 محليًا كـ 

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

 AS_CLI/Maintenance/ManagedObjects> يمكنك الحصول على broadworks وتحقق من أن المخرجات الخاصة بك تبدو جيدة. راجع أدناه للحصول على مخرجات العينة: AS_CLI/Maintenance/ManagedObjects> الحصول على كائنات BroadWorks المدارة من BroadWorks ========================== * الخادم: التعريف..............: كإصدار...............: Rel_21.sp1_1.551 الدولة الإدارية..: إلغاء قفل * التطبيقات: الاسم الإصدار نشر الحالة الإدارية Execution الحالة الفعالة ========================================================================================= AndProvisioning 21.sp1_1.551 true unlocked unlocked FlashPolicy 21.sp1_1.551 false unlocked توقف OpenClientServer 21.sp1_1.551 true unlocked unlocked WebContainer 21.sp1_1.551 true unlocked unlocked Unlocked 4 إدخالات تم العثور عليها. * التطبيقات المستضافة: اسم الإصدار Context Path تم نشر ================================================================== 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 إدخالات. 

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

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

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

AS_CLI/Maintenance/ManagedObjects> نشر تطبيق OpenClientServer

الخطوة 2: بدء الخادم بهذا الأمر:

AS_CLI/Maintenance/ManagedObjects> بدء تطبيق OpenClientServer

تمكين تنشيط الأرقام

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

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

AS_CLI> SubscriberMgmt/NumberActivation

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

AS_CLI> قم بتعيين dnMode groupAndUserActivationEnabled

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

لـ BroadCloud

تم دمج أداة الاستخراج في مدخل موفر خدمة BroadCloud. يستطيع مسؤول موفر الخدمة:

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

تظهر الأرقام أدناه مدخل موفر الخدمة.

الشكل 6: مدخل موفر الخدمة

الشكل 7: مدخل موفر الخدمة

لنظام Cisco BroadWorks وWebex من أجل BroadWorks

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

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

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

1. SCP ثنائيات أداة الاستخراج إلى خادم تطبيق Cisco BroadWorks الثانوي.
2. SSH إلى خادم تطبيق Cisco BroadWorks الثانوي لتكوين المتطلبات الأساسية وتشغيل أداة الاستخراج.
3. قم بتكوين موفر الخدمة ومعرف المجموعة للاستخراج من Cisco BroadWorks في conf/exportTool.yml. راجع عينة مقتطف YAML أدناه:

   ServiceProviderID-A:      - GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B:                        - الكل 

4. تأكد من صحة معرف مستخدم خادم تطبيق Cisco BroadWorks الثانوي وكلمة المرور واسم المضيف في ملف conf/partner.cfg:

   BROADWORKS_USER_معرف = BROADWORKS الخاص بالمسؤول_كلمة المرور = BROADWORKS الخاص بالمسؤول_المضيف_NAME = رمز تحديث المضيف المحلي_الرمز المميز = رمز تحديث المسؤول الشريك تم نسخه من أداة مُنشئ الرمز المميز. وضع الترحيل_= القيم المدعومة هي webex_for_broadworks_to_wholesale. القيمة الافتراضية هي broadworks_to_wholesale. استخدم webex_for_broadworks_to_wholesale Webex من أجل ترحيل BroadWorks. 

   خاصية تحديث_الرمز المميز إلزامية لترحيل Webex من أجل BroadWorks.

5. قم بتعديل مسار بيئة JDK/JRE في ملف export.sh إذا كان مسار بيئة JDK/JRE لخادم تطبيق Cisco BroadWorks الثانوي مختلفًا عن الملف:

   JAVA_الصفحة الرئيسية=/usr/local/java/java_base

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

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

./export.sh

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

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

 تشغيل أداة تصدير بيانات BroadSoft ************************************************ وبدء تشغيل أداة التصدير v: 1.15.0 بدأ التصدير لـ SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg تصدير المستخدمين لـ SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg تصدير المستخدمين المكتملة لـ SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg اكتمل التصدير لـ SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg تصدير إكمال دليل تفريغ الرمز البريدي: output/20221017223452_اسم الملف المضغوط الصادر ExportTool:تم extracted_data_⁦1666060⁩إنشاء ملف مضغوط 500618.zip بالاسم extracted_data_1666060500618.zip اكتملت عملية إنشاء ملف مضغوط تم تصدير الملفات المحولة كملف مضغوط ************************************************** 

الناتج

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

ls -ltr drwxr-xr-x 2 bwadmin 4096 أكتوبر  4 11:53 lib/ -rwxr-xr-x 1 bwadmin bwadmin 956719 أكتوبر  4 11:53 exportTool.jar -rwxr-xr-x 1 bwadmin bwadmin 2635 أكتوبر  4 11:53 export.sh drwxr-xr-x 2 bwadmin bwadmin 4096 أكتوبر  5 05:04 conf/ drwxrwxr-x 3 bwadmin bwadmin 4096 أكتوبر 17 22:34 إخراج/ drwxrwxr-x 2 bwadmin bwadmin 4096 أكتوبر 17 22:34 سجلات/ -rw-rw-r- 1 bwadmin bwadmin 46341 أكتوبر 17 22:35 extracted_data_1666060500618.zip 

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

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

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

1. قم بتعيين رمز_التحديث (الرمز الذي تم نسخ من أداة منشئ الرمز) واسم_الموقع_الرئيسي_ في ملف conf/partner.cfg:

   تحديث_الرمز=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NAME_OF_MAIN_الموقع=main 

2. قم بتعيين معرف التوفير_ (الذي تم نسخه من القالب في Partner Hub) بشكل اختياري في ملف conf/partner.cfg:

   التوفير_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   للحصول على مزيد من التحقق من عنوان البريد الإلكتروني للعميل، يمكنك تعيين معرف التوفير_ بشكل اختياري.
3. قم بتكوين المعلومات المفقودة في ملف الإدخال/clients.csv (راجع القسم التالي) إذا كانت هذه المعلومات مفقودة.
4. أضف عنوان البريد الإلكتروني للمستخدم النهائي في ملف الإدخال/users.csv.
5. إذا كان سيتم توفير هواتف جديدة، فأضف عنوان mac وعنوان البريد الإلكتروني لهاتف المستخدم الجديد إلى ملف الإدخال/newphones.csv. يكون هذا مطلوبًا فقط إذا أراد مسؤولو الشريك توفير هواتف جديدة في Wholesale Calling.
6. قم بتحويل مراكز اتصال BroadWorks إلى CxEssentials باستخدام ملف input/cxessentials.csv.
7. بشكل اختياري، قم بتمكين ترقية خاصية_ALL_CALL_CENTERS_ إلى_CX_ESSENTIALS لتحويل جميع مراكز الاتصال إلى CXEssentiALS.
8. استخدم ملف input/locations.csv لدعم ترحيل المؤسسة الكبير الذي يسمح للمسؤولين بترحيل مواقع عملائهم حسب الموقع
9. قم بشكل اختياري بتمكين استخدام عناوين MAC من عنوان وكيل المستخدم في رسالة SIP REGISTER عندما لا يتوفر عنوان MAC في ملف تعريف جهاز Cisco BroadWorks. قم بإلغاء تعليق سطر "استخدام _MAC_ADDRESS_FROM_SIP_REGISTER=yes" في الملف conf/partner.cfg

املأ المدخلات/customers.csv

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

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

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

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

ويندوز

نفّذ الأمر التالي لتشغيل أداة التحويل في نظام التشغيل Windows:

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

macOS

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

1. قم بإنشاء بيئة ظاهرية وتثبيت التبعيات لتشغيل أداة التحويل باستخدام Python:

   python3 -m venv venv source venv/bin/activate python3 -m pip install requests python3 -m pip install requests-oauthlib 

2. تشغيل أداة التحويل:

   ./transform.sh -extract= -customers= -users= -newphones=

الفحص المسبق للعميل/المستخدم

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

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

الفحص المسبق

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

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

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

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

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

تقرير ملخص مؤسسات BroadWorks التي يمكن ترحيلها بنجاح: 1 من مؤسسات BroadWorks التي لا يمكن ترحيلها: 0 من مستخدمي BroadWorks الذين يمكن ترحيلهم بنجاح: 4 من مستخدمي BroadWorks الذين لا يمكن ترحيلهم: 0 هواتف يمكن ترحيلها بنجاح: 3 هواتف غير متوافقة مع Webex Calling: 0 

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

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

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

تقرير استثناء Tue Oct 18 08:12:09 2022 الشركات مع ميزة حظر الاتصال توصية: تكوين خطة المكالمات الصادرة يدويًا في Control Hub ________________________________________________________________________________ collabmigrationtestGRP_engg 

الناتج

سيتوفر ملف JSON الخاص بالمخرجات (customer.json) في الدليل output// . فيما يلي عينة ملف customer.json :

{ "customer": {"provisioningId": "!!!!!!!!!!استبدال_في وجود_التزويد!!!!!!!!!!", "الحزم": ["webex_calling"، "common_area_calling" ]، "externalId": "external_id_engg_grp1"، "العنوان": { "addressLine1": "100 الشارع الرئيسي"، "addressLine2": ""، "city": "Gaithersburg"، "stateOrProvince": "MD"، "zipOrPostalCode": "20877"، "country": "US" }، "customerInfo": { "name": "Engineering Group - 1"، "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com" }، "provisioningParameters": { "calling": { "location": { "name": "Main"، "addressLine1": "100 Main Street"، "addressLine2": ""، "city": "Gaithersburg"، "stateOrProvince": "MD"، "zipOrPostalCode": "20877"، "country": "US" }، "timezone": "America/New_يورك", "اللغة": "en_us"، "الأرقام": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "mainNumber": "+15205551101" } } }, "broadworks_info": { "service_provider_id": "تعاونmigrationtestSP_engg"، "group_id": "تعاونmigrationtestGRP_engg" }، "المشتركون": [ { "amareswaranvel+benjaminjack@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE_في وجود_CUSTOMERID "!!!!!!!!!!", email": "amareswaranvel+benjaminjack@gmail.com", "package": "webex_calling"، "provisioningParameters": {"firstName": "Benjamin"، "lastName": "Jack"، "primaryPhoneNumber": "+15205551102"، "الامتداد": "1102" } }، "الميزات": [ {"/v1/people/{personId}/features/البريد الصوتي": { "ممكَّن": صحيح، "sendBusyCalls": { "ممكّن": صحيح، "رسالة ترحيب": "DEFAULT" }، "sendUnansweredCalls": { "ممكّن": صحيح، "رسالة ترحيب": "افتراضي"، "numberOfRings": 3 }، "messageStorage": { "mwiEnabled": true، "storageType": "EXTERNAL", "externalEmail": "engineering17861@mailnator.com" } } } ], "الأجهزة": [ {"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", "الامتداد": "1103" } }, "features": [ {"/v1/people/{personId}/features/البريد الصوتي": { "ممكَّن": صحيح، "sendBusyCalls": { "ممكّن": صحيح، "رسالة ترحيب": "DEFAULT" }، "sendUnansweredCalls": { "ممكّن": صحيح، "رسالة ترحيب": "افتراضي"، "numberOfRings": 3 }، "messageStorage": { "mwiEnabled": true، "storageType": "EXTERNAL", "externalEmail": "engineering16821@mailnator.com" } } } ], "الأجهزة": [ {"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/البريد الصوتي": { "ممكَّن": صحيح، "sendBusyCalls": { "ممكّن": صحيح، "رسالة ترحيب": "DEFAULT" }، "sendUnansweredCalls": { "ممكّن": صحيح، "رسالة ترحيب": "افتراضي"، "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": صحيح، "sendBusyCalls": { "ممكّن": صحيح، "رسالة ترحيب": "DEFAULT" }، "sendUnansweredCalls": { "ممكّن": صحيح، "رسالة ترحيب": "افتراضي"، "numberOfRings": 3 }، "messageStorage": { "mwiEnabled": true، "storageType": "EXTERNAL"، "externalEmail": "engineering8811@mailnator.com" } } } ]، "الأجهزة": [ { "cisUuid": "!!!!!!!!!!استبدال_في وجود_معرّف!!!!!!!!!!", الشخصي "المنتج": "DMS Cisco 8811"، "mac": "F87B204E4066" } ] } } ]، "auto_attendants": []، "call_queues": []، "hunt_groups": []، "الجداول الزمنية": []، "call_parks": []، "call_pickups": []، "paging_groups": []، "voice_portals": [ {"name": "مدخل الصوت التلقائي"، "firstName": "تلقائي"، "lastName": "مدخل الصوت"، "languageCode": "en_us"، "phoneNumber": "+15205551105"، "الامتداد": "1105" } ]، "shared_call_appearances": []، "business_communicator_desktop_to_upgrade_to_webex_app": [ "PC Comm - Engg Device Profile"], "connect_client_to_upgrade_to_webex_app": []، "المواقع": []، "webex_for_broadworks_info": { "users": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgمعرّف": "Y2lzY29zcGFyazovL3VzL79SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

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

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

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

1. قم بتثبيت Java 8 أو 11 أو 17 على الكمبيوتر. تتوفر Java من العديد من المصادر، بما في ذلك:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://download.oracle.com/java/17/latest/jdk-17_macos-x64_bin.dmg
2. بعد تنزيل واستخراج ثنائيات أدوات الترحيل، قم بتعيين متغير بيئة JAVA_HOME في provisioning_tool.sh لنظام التشغيل MAC وprovisioning_tool.bat لنظام التشغيل Windows.
3. ملف partner.cfg:
   • قم بتعيين معرف _التوفير_WHOLESALE والرمز المميز التحديث_ (الرمز الذي تم نسخ من أداة إنشاء الرمز المميز). يجب أن يتصل المسؤولون الشركاء بفريق حساباتهم للحصول على معرف_التوفير:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0_رمز التحديث=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

   • قم بتعيين السماح برسائل البريد الإلكتروني الخاصة بالمسؤول__بدعوة_البريد الإلكتروني على خاطئة، إذا لم يرغب الشريك في إرسال رسالة بريد إلكتروني للترحيب إلى المستخدمين. القيمة الافتراضية صحيحة.

4. استخدم خاصية موضوع WEBEX4BWKS_EMAIL_من أجل ترحيل Webex for BroadWorks لإرسال موضوع البريد الإلكتروني لطلب تغيير كلمة المرور إلى Webex for BroadWorks.
5. استخدم خاصية WEBEX4BWKS_EMAIL_لعمليات ترحيل Webex for BroadWorks لإرسال نص رسالة البريد الإلكتروني لطلب تغيير كلمة المرور الخاصة بمشتركي Webex for BroadWorks.

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

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

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

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

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

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

ويندوز

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

لتوفير عميل واحد: provision.bat -input=<Transform-Tool-Output-Customer-JSON-File-Path> لتوفير عملاء متعددين: provision.bat -input=<Transform-Tool-Timestamp-Output-Directory-Path> 

macOS

نفّذ الخطوات التالية لتشغيل الأداة على macOS:

لتوفير عميل واحد: ./transform.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path> لتوفير عملاء متعددين: ./transform.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path> 

المتطلبات الأساسية لتطبيق Webex من أجل ترحيل BroadWorks

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

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

شغّل أداة التوفير باستخدام وسيطة إضافية.

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

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

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

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

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

اسم الأداة: إصدار أداة التوفير: 1.15.0 ********** بدأ معالجة الملف: input/customer.json **************** توفير العميل في انتظار العميل external_id_engg_grp1 لإكمال عملية التوفير... في انتظار العميل external_id_engg_grp1 لإكمال عملية التوفير...   حالة العميل external_id_engg_grp1: أرقام التوفير التي تم توفيرها للمستخدمين توفير ميزات المستخدم توفير رسائل التحية والجداول الزمنية لتوفير الأجهزة توفير الظهور المشترك للمكالمات توفير الحضور التلقائي قوائم انتظار المكالمات توفير مجموعات الخطوط المجمَّعة توفير النداءات الجماعية توفير عمليات تعليق المكالمات توفير مدخل الصوت ********** مكتمل الملف: input/customer.json **************** 

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

الناتج

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

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

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

الشكل 9: مركز التحكم

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

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

لـ BroadCloud

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

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

تظهر الأرقام أدناه مدخل موفر الخدمة.

الشكل 12: مدخل موفر الخدمة

الشكل 13: مدخل موفر الخدمة

لنظام Cisco BroadWorks وWebex من أجل BroadWorks

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

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

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

SCP وSSH

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

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

1. قم بتعيين رمز التحديث_ (الرمز الذي تم نسخه من أداة منشئ الرمز) في ملف conf/partner.cfg:الرمز

   تحديث_=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. تأكد من صحة معرف مستخدم خادم تطبيق Cisco BroadWorks الثانوي وكلمة المرور واسم المضيف في ملف conf/deviceMoveTool.conf:

   BROADWORKS_معرف المستخدم_ = BROADWORKS الخاص بالمسؤول_كلمة المرور = BROADWORKS الخاص بالمسؤول_المضيف_NAME = المضيف المحلي 

3. لإعادة إرسال رسائل البريد الإلكتروني الخاصة بالتنشيط، تحتاج إلى تعيين إعادة إرسال_EMAILS_=true في ملف conf/partner.cfg.

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

4. تحقق من صحة مسار بيئة JDK/JRE في devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. يستطيع المسؤولون استخدام ملف locations.csv من دليل الإدخال لترحيل المجموعات المحددة بدلاً من جميع المجموعات الموجودة ضمن المؤسسة.

هواتف Polycom

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

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

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

1. تحل أداة نقل الجهاز محل الملف %BWMACADDRESS%.cfg على مستوى الجهاز بـ polycom_vvx2.cfg. يشير هذا الملف إلى migration_%BWMACADDRESS%.cfg.
2. أعد بناء ملفات تعريف الأجهزة على مستوى المجموعة أو الجهاز.
   يعتمد العمل على مستوى المجموعة أو مستوى الجهاز على تكوين المعلمة deviceLevelRebuild في file device-move-tool/conf/partner.cfg.
3. تطلب أداة نقل الجهاز من خادم تطبيق Cisco BroadWorks إعادة تشغيل الهواتف على مستوى المجموعة أو الجهاز.
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 وستتم إدارته بواسطة DMS الخاص بتطبيق Webex Calling.

الشكل 14: إضافة ملف تعريف الهوية/الجهاز

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

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

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

لنقل الجهاز للعميل الفردي: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json للجهاز نقل عملاء متعددين: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/customer1.json customer2.json customer3.json بالإضافة إلى ذلك، تدعم أداة نقل الجهاز ترحيل هاتف (هواتف) واحد/محددة من الإصدار 1.35.0. استخدم الأمر التالي: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

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

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

اسم الأداة: إصدار أداة نقل الجهاز: تم بدء أداة الجهاز 1.15.0... الأجهزة الصالحة للترحيل: ------------------------------------------------------------------------------------------------------------------- | نوع الجهاز | Mac | الإصدار | البريد الإلكتروني | ------------------------------------------------------------------------------------------------------------------- | 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 | ------------------------------------------------------------------------------------------------------------------- هل تريد ترحيل كل هذه الأجهزة؟ ([Y]es أو [N]o) نعم تحميل ملفات تعريف الأجهزة لعملية إعادة بناء جهاز DMS Cisco MPP LC تم بدء عملية إعادة بناء الجهاز بنجاح تم إكمال عملية إعادة التمهيد تم بنجاح تعديل ملفات تعريف Business Communicator ضمن المجموعة collabmigrationtestGRP_engg تم بدء عملية تنشيط أرقام هواتف webex للمؤسسة العميل: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c اكتملت عملية تنشيط أرقام هواتف webex لمعرف مؤسسة العميل: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c بدأت عملية إلغاء تنشيط أرقام هواتف broadworks للمجموعةId: collabmigrationtestGRP_engg اكتملت عملية إلغاء تنشيط أرقام هواتف broadworks للمجموعةId: اكتمل ترحيل جهاز collabmigrationtestGRP_engg

الناتج

بعد ترحيل الجهاز، أصبحت الأجهزة متصلة بالإنترنت وأصبحت جاهزة لإجراء/تلقي المكالمات. ارجع إلى الشكل 15 للاطلاع على مثال على حالة الجهاز:

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

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

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

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

لشركة المحمول الخاصة بـ BroadCloud

تكون عملية الرجوع لشركاء 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 الخاص بموفر الخدمة لملفات تعريف الأجهزة في Cisco BroadWorks وإعادة تنشيط أرقام الهواتف.
3. يقوم فريق Webex Calling بتعيين عنوان URL لخادم DMS مرة أخرى إلى عنوان URL لموفر الخدمة في ملفات تعريف الأجهزة في Webex Calling.
4. يجب أن يقوم مسؤولو الشركاء بإلغاء تنشيط أو حذف أرقام الهواتف في Webex Calling من خلال مدخل Control Hub.
5. يجب على المسؤولين الشركاء نقل أرقام هواتف PSTN مرة أخرى إلى Cisco BroadWorks.

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

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

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

إرجاع ملفات التعريف

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -revertProfiles

إرجاع الأرقام

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -revertNumbers

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

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

إرجاع ملفات التعريف

اسم الأداة: إصدار أداة نقل الجهاز: تم بدء أداة الجهاز 1.15.0 لعملية التراجع... الأجهزة التي يمكن نقلها مرة أخرى من Webex Calling إلى BroadWorks: - ------------------------------------------------------------------------------------------------------------------- | نوع الجهاز | Mac | الإصدار | البريد الإلكتروني | ------------------------------------------------------------------------------------------------------------------- | 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 | ------------------------------------------------------------------------------------------------------------------- هل تريد إعادة هذه الأجهزة من Webex Calling إلى BroadWorks؟ (نعم، نعم، لا، N):  نعم تحميل ملفات تعريف الأجهزة لعملية إعادة بناء جهاز DMS Cisco MPP LC تم بدء عملية إعادة بناء الجهاز بنجاح تم إكمال عملية إعادة التمهيد بنجاح تم إكمال عملية ترحيل الجهاز لعملية إلغاء التوفير 

إرجاع الأرقام

اسم الأداة: إصدار أداة نقل الجهاز: 1.15.0 هل تريد متابعة إرجاع الأرقام إلى Broadworks؟  ([Y] أو [N]o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110] بدء الرجوع تنشيط عملية أرقام هواتف broadworks التي بدأت لـ groupId: collabmigrationtestGRP_engg اكتملت عملية تنشيط أرقام هواتف broadworks للمجموعةId: اكتملت عملية التراجع عن ترحيل جهاز collabmigrationtestGRP_engg بنجاح