شكرًا على ملاحظاتك.

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

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

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

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

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

• https://learn.microsoft.com/en-us/java/openjdk/download
• https://aws.amazon.com/corretto/
• https://www.oracle.com/java/technologies/downloads/#java21

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

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

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

نظام التشغيل 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 في متصفح الويب على الجهاز، وقم بتسجيل الدخول باستخدام بيانات اعتماد مسؤول الشريك للحصول على الرمز المميز ونسخه لمزيد من الاستخدام.

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

الشكل 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> 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 الحالية:

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. يمكن لمسؤول مزود الخدمة:

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. انقر فوق إرسال لبدء طلب استخراج لجميع العملاء وجميع مواقعهم ضمن مزود الخدمة الحالي.

لشركة سيسكو برودووركس وويبكس لبرودووركس

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

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

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

1. قم بنقل ثنائيات أداة الاستخراج إلى خادم تطبيقات Cisco BroadWorks الثانوي.
2. SSH إلى خادم تطبيقات Cisco BroadWorks الثانوي لتكوين المتطلبات الأساسية وتشغيل أداة الاستخراج.
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 لـ BroadWorks.

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

   JAVA_HOME=/usr/local/java/java_base

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

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

./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
**************************************************

الإخراج

<timestamp>يتوفر ملف ZIP (extracted_data_ .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

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

خطوات تكوين البرنامج النصي للتصدير وتنفيذه

1. افتح ملف export.sh.
2. حدد موقع متغير HTTPS_PROXY_HOST وقم بإلغاء التعليق عليه (قم بإزالة # البادئ).

3. قم بتعيين قيمة HTTPS_PROXY_HOST على النحو التالي:

   HTTPS_PROXY_HOST=<proxy-host>

4. حدد موقع متغير HTTPS_PROXY_PORT وقم بإلغاء التعليق عليه (قم بإزالة # البادئ).
5. قم بتعيين قيمة HTTPS_PROXY_PORT على النحو التالي:

   HTTPS_PROXY_PORT=<proxy-port>

6. قم بحفظ ملف export.sh وإغلاقه.
7. افتح ملف partner.cfg وأضف رمز refresh_token المطلوب.
8. تحقق من تكوين مضيف BroadWorks واسم المستخدم وكلمة المرور بشكل صحيح في partner.cfg.
9. قم بتشغيل البرنامج النصي:

   ./export.sh

نموذج المشاركة:

تقوم أداة الاستخراج (BroadCloud و BroadWorks) الآن تلقائيًا بإنشاء ملف XLSX مدمج بعنوان نموذج المشاركة SUA.xlsx أثناء التنفيذ. يتم تعبئة الملف مسبقًا بجميع البيانات المتاحة عبر أوراق العمل ذات الصلة، مما يساعد على تبسيط وتسريع إكمال الشركاء.

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

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

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

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

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

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   للحصول على مزيد من التحقق الكامل من عنوان البريد الإلكتروني للعميل، يمكنك اختياريًا تعيين PROVISIONING_ID.
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 من رأس وكيل المستخدم لرسالة SIP REGISTER عندما لا يكون عنوان MAC متاحًا في ملف تعريف جهاز Cisco BroadWorks. قم بإلغاء التعليق على السطر use_mac_address_from_SIP_register=نعم في الملف conf/partner.cfg
10. اختياريًا، قم بتمكين الخصائص ANALOG_USER_TYPE_ENABLE_CALL_WAITING وANALOG_USER_TYPE_ENALE_MUSIC_ON_HOLD وANALOG_USER_TYPE_DISABLE_T38 لتكوين انتظار المكالمات والموسيقى قيد الانتظار وتعطيل إعدادات T38 لجميع المستخدمين من النوع التناظري.

11. إذا كنت ترغب في إعداد أجهزة البوابة العامة، فأضف عنوان MAC الخاص بالجهاز ومعرف المستخدم إلى ملف input/genericgateways.csv. اذكر أيضًا ما إذا كان المستخدم هو المالك الأساسي أو مستخدم SHARED (لظهور المكالمات المشتركة). هذا مطلوب فقط إذا كان المسؤولون الشركاء يخططون لاستخدام أجهزة البوابة العامة في Wholesale Calling.

    هذه الميزة غير متاحة لعمليات الترحيل من BroadCloud إلى البيع بالجملة.

12. بالنسبة لعمليات ترحيل BroadCloud، لتحويل جميع المستخدمين من نوع محطة المراسلة إلى voice_mail_group، قم بتحديث ملف conf/rialto_station_type_to_wholesale_package.csv عن طريق استبدال قيمة حزمة البيع بالجملة بـ voice_mail_group للصف الذي يقوم فيه نوع محطة Rialto بالمراسلة.

    اختياريًا، قم بتمكين خاصية COMMON_VOICE_MAIL_GROUP_PASSCODE في partner.cfg لتكوين رقم التعريف الشخصي الافتراضي لمجموعات البريد الصوتي.

    إذا لم يتم تحديد هذه الخاصية في partner.cfg، فيجب توفيرها لكل عميل في ملف customers.csv ضمن عمود CommonvoicemailGroupPasscode.

13. لترحيل جهات الاتصال المشتركة إلى Webex Calling

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

    تكوين المفتاح:

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      يتم تقديم خاصية جديدة، COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE، في ملف partner.cfg. تحدد هذه الخاصية كيفية ترحيل جهات الاتصال الشائعة من Rialto إلىWebex Calling.

    • بدون قائمة الهاتف_المشتركة_بالامتدادات_الافتراضية_تم تكوين نطاق البدء

      سيتم ترحيل جهات الاتصال الشائعة كجهات اتصال للمؤسسة (جهات اتصال المؤسسة).

      لا يلزم تكوين إضافي.

      تظل جهات الاتصال متاحة على مستوى المؤسسة.

    • مع تكوين نطاق بدء التشغيل مع قائمة الهاتف_المشتركة_إلى_الامتدادات_الافتراضية_

      سيتم ترحيل جهات الاتصال الشائعة كإضافات افتراضية.

      سيتم إلحاق كل جهة اتصال برقم ملحق، ويتم تعريف نطاق البداية للامتداد في الخاصية COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE في partner.cfg.

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

14. قم بتمكين بائع تسجيل المكالمات الافتراضي لـ Webex.

    هذه الخطوة مطلوبة فقط عند ترحيل إعدادات تسجيل المكالمات للمستخدمين الذين تم تكوينهم باستخدام Dubber إلى Cisco Native Call Recording في Webex.

    لتمكين هذا الخيار:

    • في ملف partner.cfg، قم بتعيين الخاصية التالية، default_call_recording_vendor=WebEx.
    • بالإضافة إلى ذلك، استخدم الخاصية WEBEX_CALL_RECORDING_STORAGE_REGION لتكوين منطقة التخزين.

      لا يتم دعم خيار التسجيل عند الطلب من BroadCloud فيWebex Calling. لن يتم ترحيل إعدادات تسجيل المكالمات هذه وستظهر في تقرير الاستثناءات.

15. استبعاد أرقام الهواتف المحددة من الترحيل:

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

    • قم بتنفيذ أداة التحويل في البداية لأول مرة. عند الانتهاء، ستقوم الأداة بإنشاء ملف باسم telephone_numbers_inventory.csv، يقع داخل دليل الإخراج/الطابع الزمني/. يجب على العميل مراجعة هذا الملف والإشارة إلى «نعم» في عمود «Drop Tn» لكل رقم هاتف يجب استبعاده من الترحيل القادم.
    • بعد تحديث ملف telephone_numbers_inventory.csv بعلامات الاستبعاد المناسبة، يتم تنفيذ أداة التحويل مرة ثانية. يجب تمرير الملف المحدث كوسيطة بالتنسيق التالي.

      . /transform.sh - الاستخراج = الإدخال/البيانات المستخرجة _1747640608219.zip - أرقام إيقاف التشغيل = {filepath/telephone_numbers_inventory.csv}

16. اختياريًا، قم بتعيين خاصية ALLOW_RESTRICT_BY_PARTNER_MODE إلى إيقاف التشغيل للسماح لمسؤولي العملاء بتعديل الإعدادات المحددة من قبل الشريك في Control Hub.
17. لترحيل أرقام الهواتف المحمولة (BroadWorks Mobility) من BroadCloud إلى Webex Calling

    يوضح هذا القسم ترحيل ميزة BroadWorks Mobility (أرقام هواتف العملاء المحمولة) من BroadCloud (تكامل شبكة الهاتف المحمول) إلى البيع بالجملة Webex Calling (مشغل شبكة Webex Go للهاتف المحمول).

    المتطلبات الأساسية - قبل بدء عملية الترحيل، يجب على مسؤولي الشركاء التواصل مع فريق حساب Cisco للقيام بتكوين مورد PSTN المتصل بالسحابة (CCP) وتكوين قائمة شركات النقل المخصصة (CCL).

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

    • هذه الميزة مدعومة فقط لعمليات الترحيل من Broadcloud إلى البيع بالجملة.
    • في Wholesale Webex، يمكن للمستخدمين النهائيين الحصول على رقم هاتف محمول أو رقم PSTN (وليس كلاهما)، على عكس BroadCloud.
    • عندما يتم تعيين رقم هاتف محمول لمستخدم، يصبح رقم PSTN الأساسي الخاص به هو الرقم الثانوي (البديل) الخاص به.
    • لا يمكن ترحيل أرقام الهواتف المحمولة للمستخدمين الذين يتم تحويلهم إلى مساحات العمل أو الخطوط الافتراضية.
    • بعد تعيين رقم هاتف محمول في Wholesale Webex، سيظهر على أنه نشط في Control Hub. لا تعني هذه الحالة أن الرقم جاهز فورًا لتلقي المكالمات. ستكون إمكانية الاتصال متاحة فقط بعد اكتمال الترحيل بالكامل.
    • لا يتم ترحيل إعدادات تكامل الهاتف المحمول التي تم تكوينها من قبل المستخدمين النهائيين في بوابة المستخدم المتصل (CUP). بعد الترحيل، عند استدعاء رقم هاتف أو رقم هاتف محمول أو ملحق ، ستصدر جميع أجهزة المستخدم رنينًا.

18. لتكوين حدود كمية الحزمة اختياريًا أثناء ترحيل العميل، حدد الكمية لكل حزمة في ملف input/package_quantity.csv. يجب أن تكون كمية الحزمة التي تم تكوينها أكبر من أو تساوي عدد الحزم المعينة للمستخدم/مساحة العمل.

    حدود كمية الحزمة غير مدعومة حاليًا لعمليات ترحيل Webex for BroadWorks إلى البيع بالجملة.

    عند تشغيل أداة التحويل، قم بتوفير الملف المحدث كمعامل إدخال:. <extract_zip_file>/transform.sh - الاستخراج = - حدود الحزمة = الإدخال/الكمية_الحزمة.csv .

19. قم بترحيل المواقع من عملاء متعددين من Broadworks/Broadcloud إلى عميل واحد في Wholesale Webex Calling
    • تم تقديم وضع وقت تشغيل جديد، -ConsolidatedMigration، في أداة Transform لدعم ترحيل العديد من مواقع العملاء من Broadcloud/Broadworks إلى منصة Webex Wholesale ضمن منظمة واحدة لعملاء الجملة. عند تمكين هذا الوضع، تقوم الأداة بدمج العديد من مواقع العملاء في مؤسسة واحدة لعملاء الجملة

      -consolidatedMigration

    • هناك حجج اختيارية أخرى يمكن تقديمها جنبًا إلى جنب مع -consolidatedMigration مثل

      -targetEnterpriseId={rialtoCustomerId | broadWorksEnterpriseId} -consolidatedExternalId={wholesaleCustomerExternalId}

    • إذا تم إعطاء -targetEnterpriseID وكان المعرف موجودًا في ملف إخراج أداة الاستخراج، فسيتم استخدامه لإنشاء منظمة عملاء الجملة وإذا لم يتم العثور على المعرف، فستعود الأداة لاستخدام أي تفاصيل عميل متاحة من ملف إخراج أداة الاستخراج.
    • إذا تم إعطاء -consolidatedexternalid فسوف يقوم بتعيين المعرف الخارجي للعميل وإذا لم يتم تقديمه، فستعود الأداة لاستخدام التدفق الحالي للمعرف الخارجي.
    • <timestamp>سيكون ملف JSON (customer.json) الموحد متاحًا في دليل الإخراج/ /consolidated .

تعبئة ملف input/customers.csv

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

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

تعبئة ملف input/users.csv

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

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

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

شبابيك

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

transform.bat -extract=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

ماك أو إس

قم بتنفيذ الخطوات التالية لتشغيل أداة التحويل على 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=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

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

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

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

فحص مسبق

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

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

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

سجلات المحطة

يتم تسجيل الدخول التالية إلى الجهاز عند التحويل الناجح:

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

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

تقوم أداة التحويل بإنشاء تقرير الاستثناء داخل دليل الإخراج/ /exception_report.txt<timestamp>. يمكنك استخدام هذا التقرير لتحديد المشكلات التي ستؤثر على الترحيل وإصلاحها في نظام 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

الإخراج

<timestamp><groupid>سيكون ملف JSON (customer.json) الناتج متاحًا في دليل الإخراج//. نموذج ملف 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 العامة. يقوم بقراءة ملف JSON (customer.json) الناتج عن أداة التحويل كمدخل وتزويد العملاء والمواقع والأرقام والمستخدمين والخدمات والأجهزة في حل Webex Wholesale RTM.

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

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

1. قم بتثبيت Java 8 أو 11 أو 17 أو 21 على الكمبيوتر. تتوفر Java من العديد من المصادر، بما في ذلك:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. بعد تنزيل ثنائيات أدوات الترحيل واستخراجها، قم بتعيين متغير بيئة JAVA_HOME في provisioning_tool.sh لـ MAC و provisioning_tool.bat لنظام التشغيل Windows.
3. ملف partner.cfg:
   • قم بتعيين WHOLESALE_PROVISIONING_ID و REFRESH_TOKEN (الرمز الذي تم نسخه من أداة مولد الرمز المميز). يجب على مسؤولي الشركاء الاتصال بفريق الحساب الخاص بهم للحصول على PROVISIONING_ID:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • قم بتعيين SEND_SUBSCRIBERS_WELCOME_EMAIL إلى false، إذا كان الشركاء لا يريدون إرسال بريد إلكتروني ترحيبي إلى المستخدمين. القيمة الافتراضية صحيحة.

     يرسل Webex رسائل البريد الإلكتروني الترحيبية فقط للمستخدمين النهائيين. لا يتلقى مسؤولو العملاء رسائل البريد الإلكتروني الترحيبية.

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

4. استخدم الخاصية WEBEX4BWKS_EMAIL_SUBJECT لعمليات ترحيل Webex لـ BroadWorks لإرسال موضوع البريد الإلكتروني لطلب تغيير كلمة المرور لـ Webex لمشتركي BroadWorks.
5. استخدم الخاصية WEBEX4BWKS_EMAIL_BODY لعمليات ترحيل Webex لـ BroadWorks لإرسال نص البريد الإلكتروني لطلب تغيير كلمة المرور لـ Webex لمشتركي BroadWorks.
6. استخدم خاصية CUSTOM_TAGS لإضافة علامات بعد إنشاء العميل.
7. لتطبيق خصومات البيع بالجملة، يجب على مسؤولي الشركاء الاتصال بفريق حساب Cisco قبل بدء الترحيل.

   تمت إضافة خاصية جديدة، APPLY_WHOLESALE_DISCOUNTS إلى partner.cfg. قم بتمكين هذه الخاصية لتطبيق الخصومات على المستخدمين ومساحات العمل.

8. (اختياري) قم بتكوين اتصال PSTN بشكل صريح

   لتحديد اتصال PSTN لجميع المواقع التي تم توفيرها أثناء الترحيل، بما في ذلك الموقع الرئيسي، أضف الخاصية التالية إلى ملف partner.cfg:

   PSTN_CONFIGURATION=<PSTN Connection ID or exact PSTN Connection Display Name>

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

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

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

شبابيك

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

To provision single customer:
provision.bat -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
provision.bat -input=<Transform-Tool-Timestamp-Output-Directory-Path> 

ماك أو إس

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

To provision single customer:
./transform.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
./transform.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>

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

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

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

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

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

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

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

سجلات المحطة

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

Tool Name: Provisioning
Version: 1.51.0
Customer(s) provisioning started...
Sending create customer provisioning request for the External ID: customer.id.1
Customer provisioning request sent for the customer with the External ID: customer.id.1
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioned
Provisioning customer's calling settings with External ID: customer.id.1
Customer's settings are updated successfully for the External ID: customer.id.1
Provisioning secondary locations for the customer with the External ID: customer.id.1 
Provisioning location's settings and features for the customer with the External ID: customer.id.1
Subscriber(s) provisioning will be started for the customer with the External ID: customer.id.1
Provisioning subscriber(s) and settings for the customer with External ID: customer.id.1
Subscriber(s) and settings provisioning completed for the customer with External ID: customer.id.1
Provisioning user agent settings for the customer with the External ID: customer.id.1
 
********** Completed File : input/customer.json ****************

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

الإخراج

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

سيقوم النظام بإنشاء ملف Provisioning_report_*.csv في دليل الإخراج/التقارير الموحدة. يحتوي هذا الملف على تفاصيل النجاح والفشل لكل كيان وإعداداته، مما يوفر تقرير التوفير الشامل.

تقوم أداة التوفير أيضًا بإنشاء ملف Provisioning_statistics_*.csv في دليل الإخراج/التقارير الموحدة. يحتوي هذا التقرير على أعداد العملاء والمواقع والمستخدمين والأجهزة وميزات المجموعة التي تم توفيرها بنجاح ودون جدوى.

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

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

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

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

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

قيود ما بعد التزويد

بمجرد اكتمال التوفير لترحيل BroadCloud، سيتم حظر الإجراءات التالية:

• بوابة CAP - إضافة مستخدمين أو أجهزة تم نقلها.
• بوابة SP - إنشاء أوامر ADD باستخدام الأجهزة أو الأرقام.
• RSB API - إنشاء أوامر ADD مع الأجهزة أو الأرقام وإنشاء مستخدمين. سيتم رفض طلبات RSB ADD التي تم إجراؤها باستخدام الأجهزة أو الأرقام.

ترحيل BroadCloud إلى البيع بالجملة - قيود تسجيل الجهاز

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

لا ينطبق هذا القيد على:

• العملاء الذين ينتقلون من Broadworks/W4b إلى البيع بالجملة.
• عمليات الترحيل من BroadCloud إلى البيع بالجملة عبر مناطق مختلفة.

الإرشادات الموصى بها

لتجنب مشكلات تسجيل الجهاز، أكمل ترحيل نقل الجهاز على مستوى الموقع قبل محاولة تسجيل الأجهزة في منصة Webex لعمليات ترحيل BroadCloud إلى Wholesale في نفس المنطقة.

لـ برود كلاود

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

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

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

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

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

توضح الأرقام التالية بوابة مزود الخدمة.

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

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

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

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

لتنزيل قائمة المواقع النشطة المتاحة، انتقل إلى عرض العملاء ← تحديد العميل ← مواقع التصدير كملف CSV.

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

قم بتمكين خيار قطع اتصال الأرقام

عند استخدام نفس قناة SIP لـ Webex Calling BroadCloud Carrier، يجب على المسؤولين استخدام خيار قطع الاتصال بالأرقام. يؤدي هذا إلى إزالة أرقام الهواتف من تلقي المكالمات الواردة بعد الترحيل في BroadCloud.

لتمكين هذا الخيار،

1. في ملف partner.cfg، قم بتعيين DISCONNECT_NUMBERS_FROM_RIALTO = نعم.
2. أعد تشغيل أداة الترحيل باستخدام نفس ملف customer.json وpartner.cfg المحدث.

في حالة فشل الأرقام في قطع الاتصال، قم برفع طلب Cisco TAC.

لشركة سيسكو برودووركس وويبكس لبرودووركس

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

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

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

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

   إجراء التكوين

   1. افتح ملف devicemove.sh.
   2. حدد موقع متغير PROXY_HOST وقم بإلغاء التعليق عليه (قم بإزالة # البادئ لـ devicemove.sh).

   3. قم بتعيين قيمة PROXY_HOST على النحو التالي:

      PROXY_HOST=<proxy-host>

   4. حدد موقع متغير PROXY_PORT وقم بإلغاء التعليق عليه (قم بإزالة # البادئ لـ devicemove.sh).

   5. قم بتعيين قيمة PROXY_PORT على النحو التالي:

      PROXY_PORT=<proxy-port>

   6. يرجى تحديد موقع متغير PROXY_SCHEME وإلغاء التعليق عليه (إزالة # البادئ لـ devicemove.sh). هذه الخطوة اختيارية؛ في حالة استمرار التعليق عليها، ستكون القيمة الافتراضية لـ PROXY_SCHEME هي HTTP.

   7. قم بتعيين قيمة PROXY_SCHEME على النحو التالي:

      PROXY_SCHEME=<proxy-scheme>

   8. قم بحفظ ملف devicemove.sh وإغلاقه.
   9. افتح ملف partner.cfg وأضف رمز refresh_token المطلوب.
   10. تحقق من تكوين مضيف BroadWorks واسم المستخدم وكلمة المرور بشكل صحيح في partner.cfg

   11. قم بتشغيل البرنامج النصي:

       ./devicemove.sh

SCP و SSH

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

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

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

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

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

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

   JAVA_HOME=/usr/local/java/java_base

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

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

لنقل هواتف Polycom من Cisco BroadWorks إلى الاتصال بالجملة، يجب على مسؤول الشريك إنشاء ملف تعريف الهوية/الجهاز الجديد على مستوى النظام في Cisco BroadWorks لكل قالب من قوالب أجهزة Polycom. راجع الشكل 14 وقم بتحميل الملف المخصص - أداة نقل الجهاز/CONF/DeviceProfile/ {region} /polycom_vvx.cfg. بعد تحميل ملف الجهاز الجديد، تأكد من وجود الملف الذي تم إنشاؤه حديثًا على مستوى المجموعة. تأكد أيضًا من أن ملف Migration_%bwmac address%.cfg لا يتعارض مع أي ملف موجود في نظامك).

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

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

1. تستبدل أداة نقل الجهاز الملف %bwMacAddress%.cfg على مستوى الجهاز بـ polycom_vvx2.cfg. يشير هذا الملف إلى ترحيل_%bwMacAddress%.cfg.
2. قم بإعادة إنشاء ملفات تعريف الجهاز على مستوى المجموعة أو مستوى الجهاز.
   يعتمد العمل على مستوى المجموعة أو مستوى الجهاز على تكوين المعلمة DeviceLevelrebuild في الملف device-move-tool/conf/partner.cfg.
3. تطلب أداة نقل الجهاز من خادم تطبيقات Cisco BroadWorks إعادة تشغيل الهواتف على مستوى المجموعة أو مستوى الجهاز.
4. بعد طلب إعادة التشغيل، تقوم هواتف بوليكوم بتنزيل ومعالجة% bwmacAddress%.cfg، الأمر الذي يطلب من هواتف بوليكوم تنزيل ومعالجة عملية الترحيل _%bwMacAddress%.cfg، مما يؤدي إلى تعيين اسم الجهاز.prov.servername إلى https://plcm.sipflash.com.
   https://plcm.sipflash.com بالنسبة لمنطقة الولايات المتحدة، تحتوي المناطق الأخرى على عناوين URL مختلفة.
5. يقوم هاتف بوليكوم بتنزيل %bwMacAddress%.cfg من https://plcm.sipflash.com وستتم إدارته بواسطة DMS. Webex Calling

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

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

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

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

For device move single customer:
./devicemove.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>
 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= <Transform-Tool-Output-Customer-JSON-File-Path> -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

الإخراج

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

الشكل 15: حالة الجهاز

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

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

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

خطوات تكوين البرنامج النصي devicemove وتنفيذه

1. افتح ملف devicemove.sh.
2. حدد موقع متغير HTTPS_PROXY_HOST وقم بإلغاء التعليق عليه (قم بإزالة # البادئ).

3. قم بتعيين قيمة HTTPS_PROXY_HOST على النحو التالي:

   HTTPS_PROXY_HOST=<proxy-host>

4. حدد موقع متغير HTTPS_PROXY_PORT وقم بإلغاء التعليق عليه (قم بإزالة # البادئ).
5. قم بتعيين قيمة HTTPS_PROXY_PORT على النحو التالي:

   HTTPS_PROXY_PORT=<proxy-port>

6. قم بحفظ ملف devicemove.sh وإغلاقه.
7. افتح ملف partner.cfg وأضف رمز refresh_token المطلوب.
8. تحقق من تكوين مضيف BroadWorks واسم المستخدم وكلمة المرور بشكل صحيح في partner.cfg.
9. قم بتشغيل البرنامج النصي:

   ./devicemove.sh

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

لشركة برودكلاود كاريير

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

لشركة سيسكو برودووركس وويبكس لبرودووركس

تكون عملية الإرجاع الخاصة بسيسكو برودووركس وويبكس لبرودووركس كما يلي:

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

سجلات المحطة

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

إعادة ملفات التعريف

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