أدوات الترحيل للانتقال من BroadWorks وWebex لـ BroadWorks وBroadCloud إلى حلول Wholesale RTM

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

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

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

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

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

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

• ماك: الصفحة الرئيسية لـ JAVA_="/Users/cisco/jdk/zulu@1.8.282/Contents/Home/"

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

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

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

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

token_generator.bat

ماك:

./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> cd /Applications/OpenClientServer/GeneralSettings.

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

AS_CLI/Applications/OpenClientServer/GeneralSettings> الحصول على 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> احصل على وصف العنوان ========================= 127.0.0.1 محليًا 

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

 AS_CLI/Maintenance/ManagedObjects> احصل على broadworks وتأكد من أن الناتج الخاص بك يبدو جيدًا. انظر أدناه للحصول على عينة من الناتج: AS_CLI/Maintenance/ManagedObjects> الحصول على BroadWorks BroadWorks Managed Objects =========================== * الخادم: هوية..............: نسخة AS...............: Rel_21.sp1_1.551 الحالة الإدارية..: التطبيقات المفتوحة *: الاسم الإصدار تم النشر الحالة الإدارية الحالة الفعالة ================================================================================================== ExecutionAndProvisioning 21.sp1_1.551 true غير مقفل غير مقفل FlashPolicy 21.sp1_1.551 false غير مقفل متوقف OpenClientServer 21.sp1_1.551 true غير مقفل غير مقفل WebContainer 21.sp1_1.551 true غير مقفل غير مقفل تم العثور على 4 إدخالات. * التطبيقات المستضافة: الاسم الإصدار السياق المسار تم النشر ==================================================================== 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 /ocifles true تم العثور على 5 إدخالات. 

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

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

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

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

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

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

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

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

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

AS_CLI> cd 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 Application Server الثانوي لتكوين المتطلبات الأساسية وتشغيل أداة الاستخراج.
3. قم بتكوين موفر الخدمة ومعرف المجموعة لاستخراجهما من Cisco BroadWorks في conf/exportTool.yml. راجع مقتطف YAML النموذجي أدناه:

   معرف مقدم الخدمة-A:      - معرف المجموعة-A1 - معرف المجموعة-A2 - معرف المجموعة-A3 معرف مقدم الخدمة-B:                        - الجميع 

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

   BROADWORKS_USER_ID = admin BROADWORKS_PASSWORD = admin BROADWORKS_HOST_NAME = localhost REFRESH_TOKEN = رمز التحديث الخاص بمسؤول الشريك الذي تم نسخه من أداة إنشاء الرمز المميز. وضع الهجرة _ = القيم المدعومة هي webex_for_broadworks_to_wholesale. القيمة الافتراضية هي broadworks_to_wholesale. استخدم webex_for_broadworks_to_wholesale لترحيلات Webex لـ BroadWorks. 

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

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

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

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

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

./export.sh

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

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

 تشغيل أداة تصدير البيانات BroadSoft **************************************************** بدء تشغيل أداة التصدير v: 1.15.0 بدأت عملية التصدير لـ SP=collabmigrationtestSP_engg، المجموعة=collabmigrationtestGRP_engg تصدير المستخدمين لـ SP=collabmigrationtestSP_engg، المجموعة=collabmigrationtestGRP_engg تم تصدير المستخدمين لـ SP=collabmigrationtestSP_engg، المجموعة=collabmigrationtestGRP_engg تم التصدير لـ SP=collabmigrationtestSP_engg، المجموعة=collabmigrationtestGRP_engg تم التصدير تم تصدير دليل Zip: output/20221017223452_ExportTool Export Dump Zip اسم الملف:extracted_data_1666060500618.zip تم إنشاء ملف ZIP باسم extracted_data_1666060500618.zip تم الانتهاء من عملية إنشاء ملف ZIP تم تصدير الملفات وتحويلها إلى ملف ZIP ************************************************** 

الناتج

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

ls –ltr drwxr-xr-x 2 bwadmin 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 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. قم بتعيين REFRESH_TOKEN (الرمز المنسوخ من أداة توليد الرمز) وNAME_OF_MAIN_LOCATION في ملف conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj NAME_OF_MAIN_LOCATION=الرئيسي 

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

   التزويد_معرف=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

ملء ملف input/customers.csv

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

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

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

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

Windows

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

تحويل.bat - استخراج =  - العملاء =  - المستخدمون =  - الهواتف الجديدة = 

ماك

قم بتنفيذ الخطوات التالية لتشغيل أداة التحويل على نظام 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=

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

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

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

فحص مسبق

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

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

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

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

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

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

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

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

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

تقرير الاستثناءات الثلاثاء 18 أكتوبر 2022 08:12:09 المؤسسات التي لديها ميزة حظر الاتصالات التوصية: قم بتكوين خطة الاتصال الصادرة يدويًا في مركز التحكم ________________________________________________________________________________ collabmigrationtestGRP_engg 

الناتج

سيكون ملف الإخراج JSON (customer.json) متاحًا في الدليل output// . ملف العينة 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": صحيح، "sendBusyCalls": { "ممكّن": صحيح، "تحية": "افتراضي" }، "إرسال مكالمات غير مجاب عليها": { "ممكّن": صحيح، "تحية": "افتراضي"، "عدد الحلقات": 3 }، "messageStorage": { "mwiEnabled": صحيح، "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": صحيح، "sendBusyCalls": { "ممكّن": صحيح، "تحية": "افتراضي" }، "إرسال مكالمات غير مجاب عليها": { "ممكّن": صحيح، "تحية": "افتراضي"، "عدد الحلقات": 3 }، "messageStorage": { "mwiEnabled": صحيح، "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": صحيح، "sendBusyCalls": { "ممكّن": صحيح، "تحية": "افتراضي" }، "إرسال مكالمات غير مجاب عليها": { "ممكّن": صحيح، "تحية": "افتراضي"، "عدد الحلقات": 3 }، "messageStorage": { "mwiEnabled": صحيح، "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": { "ممكّن": صحيح، "sendBusyCalls": { "ممكّن": صحيح، "تحية": "افتراضي" }، "إرسال مكالمات غير مجاب عليها": { "ممكّن": صحيح، "تحية": "افتراضي"، "عدد الحلقات": 3 }، "messageStorage": { "mwiEnabled": صحيح، "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": "بوابة صوتية آلية"، "firstName": "آلية"، "lastName": "بوابة صوتية"، "languageCode": "en_us"، "رقم الهاتف": "+15205551105"، "الامتداد": "1105" } ]، "shared_call_appearances": []، "business_communicator_desktop_to_upgrade_to_webex_app": [ "اتصال الكمبيوتر الشخصي - ملف تعريف جهاز الهندسة" ]، "connect_client_to_upgrade_to_webex_app": []، "المواقع": []، "webex_for_broadworks_info": { "المستخدمون": [ { "المعرف": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ]، "hydra_orgالمعرف": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg"، "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

يمكن تشغيل أداة التجهيز على أي جهاز عادةً (الكمبيوتر المحمول الخاص بمسؤول الشريك) وتستخدم واجهات برمجة تطبيقات Webex العامة. يقوم بقراءة ملف 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_PROVISIONING_ ورمز REFRESH_TOKEN (الرمز الذي تم نسخه من أداة إنشاء الرمز). يجب على مسؤولي الشركاء الاتصال بفريق حساباتهم للحصول على معرف التزويد_:

     التزويد بالجملة_معرف_ = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 تحديث_الرمز=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.

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

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

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

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

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

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

Windows

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

لتوفير خدمة عميل واحد: provision.bat -input= لتوفير عملاء متعددين: provision.bat -input= 

ماك

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

لتوفير عميل واحد: ./transform.sh -input= لتوفير عملاء متعددين: ./transform.sh -input= 

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

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

قم بتشغيل أداة التجهيز باستخدام وسيطة إضافية لـ Webex لـ BroadWorks للانتقال إلى Wholesale.

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

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

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

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

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

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

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

الناتج

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

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

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

الشكل 9: Control Hub

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

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

لـ BroadCloud

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

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

تُظهر الأشكال أدناه بوابة مقدم الخدمة.

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

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

لـ 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. [تنطبق هذه الخطوة على عمليات نقل BroadCloud فقط].

SCP و SSH

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

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

1. قم بتعيين REFRESH_TOKEN (الرمز المنسوخ من أداة إنشاء الرمز) في ملف conf/partner.cfg:

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

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

   BROADWORKS_مستخدم_معرف = adminBROADWORKS_كلمة المرور = adminBROADWORKS_المضيف_الاسم = localhost 

3. تأكد من صحة مسار بيئة JDK/JRE في devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

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

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

لنقل هواتف Polycom من Cisco BroadWorks إلى Wholesale Calling، يجب على مسؤول الشريك إنشاء ملف جديد لنوع الهوية/ملف تعريف الجهاز على مستوى النظام في قالب جهاز Polycom لكل من Cisco BroadWorks. راجع الشكل 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 في الملف 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.

الشكل 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 | -------------------------------------------------------------------------------------------------------------------هل تريد نقل كل هذه الأجهزة؟ ([نعم] أو [لا]) نعم تحميل ملفات تعريف الجهاز لـ DMS Cisco MPP LC بدأت عملية إعادة بناء الجهاز اكتملت عملية إعادة بناء الجهاز بنجاح بدأت عملية إعادة التشغيل اكتملت عملية إعادة التشغيل بنجاح تعديل ملفات التعريف لـ Business Communicator ضمن مجموعة collabmigrationtestGRP_engg تنشيط عملية أرقام هواتف webex بدأت لمؤسسة العميل معرف: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c تم الانتهاء من عملية تنشيط أرقام هواتف Webex لمعرف منظمة العميل: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c بدأت عملية إلغاء تنشيط أرقام هواتف Broadworks لمجموعة معرف: collabmigrationtestGRP_engg تم إلغاء تنشيط عملية أرقام هواتف Broadworks لمجموعة معرف المجموعة: 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 الخاص بـ DMS الخاص بموفر الخدمة لملفات تعريف الأجهزة في Cisco BroadWorks وإعادة تنشيط أرقام الهواتف.
3. يقوم فريق Webex Calling بتعيين عنوان URL الخاص بـ DMS مرة أخرى إلى عنوان URL الخاص بـ DMS لمزود الخدمة في ملفات تعريف الجهاز في Webex Calling.
4. يجب على مسؤولي الشركاء إلغاء تنشيط أرقام الهواتف أو حذفها في خدمة Webex Calling من خلال بوابة Control Hub.
5. يتعين على مسؤولي الشركاء نقل أرقام هواتف PSTN مرة أخرى إلى Cisco BroadWorks.

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

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

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

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

./devicemove.sh -input=  -revertProfiles

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

./devicemove.sh -input=  -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؟ (نعم، نعم، لا، لا):  نعم تحميل ملفات تعريف الجهاز لـ DMS Cisco MPP LC بدأت عملية إعادة بناء الجهاز اكتملت عملية إعادة بناء الجهاز بنجاح بدأت عملية إعادة التشغيل اكتملت عملية إعادة التشغيل بنجاح اكتملت عملية نقل الجهاز لعملية إلغاء التجهيز 

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

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