טלפונים נתמכים ייווצרו ויוקצו באופן אוטומטי למשתמשים ב-Webex Calling על-ידי כלי ההקצאה. הטלפונים המסומנים "כן" בעמודה "נתמכים בכלי העברת המכשיר" יועברו אוטומטית גם מ-Cisco BroadWorks או מ-BroadCloud ל-Webex Calling כאשר כלי העברת המכשיר מופעל. טלפונים המסומנים 'לא' בעמודה זו זקוקים להתערבות ידנית כדי לשנות את כתובת ה-URL של ה-DMS בתבנית המכשיר Cisco BroadWorks או בטלפון עצמו.

העמודה האחרונה מספקת את המיפוי של דגמי הטלפון לעמודה "סוג מכשיר" של כלי ההמרה הקובץ/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

מקOS:

./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 כדי לקבל את GeneralSettings הנוכחיות:

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

אם ההגדרות שלך לא תואמות לזו שלעיל, השתמש בפקודה הגדר כדי לקבוע מחדש את ההגדרות שלך.

שלב 2: השתמש ב-CLI כדי להגדיר את ה-OCI Proxy.

שנה את הספרייה ל-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

אם ההגדרות שלך לא תואמות לזו שלעיל, השתמש בפקודה הגדר כדי לקבוע מחדש את ההגדרות שלך.

שלב 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.

אמת ששרת לקוח פתוח שנפרס ופעיל

השתמש בפקודות שלהלן כדי לפרוס ולהפעיל את שרת הלקוח הפתוח בשרת היישום המשני אם הוא לא נפרס או עדיין לא הופעל.

שלב 1: פרוס את השרת באמצעות פקודת ה-CLI הבאה:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

שלב 2: הפעל את השרת עם פקודה זו:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

הפעל הפעלת מספרים

בצע את הפקודות הבאות ב-CLI כדי להפעיל את המספרים:

שלב 1: הפעל את פקודת הפעלת המספר:

AS_CLI> cd SubscriberMgmt/NumberActivation

שלב 2: הפעל את הפקודה המופעלת להפעלה:

AS_CLI> set dnMode groupAndUserActivationEnabled

שלב 3: בבקשת האישור, הזן Y.

עבור BroadCloud

כלי החילוץ משולב בפורטל ספק השירות של BroadCloud. מנהל מערכת של ספק שירות יכול:

1. שלח בקשות חילוץ בעד 50 לקוחות לכל בקשה.
   לא ניתן להגיש בקשה חילוץ עבור אותו לקוח יותר מ-10 פעמים ביום.
2. הורד את קובץ הנתונים שחולץ, בתבנית ZIP, למשך עד 28 יום מתאריך הגשת הבקשה.

הנתונים שלהלן מציגים את פורטל ספק השירות.

איור 6: פורטל ספק שירות

איור 7: פורטל ספק שירות

עבור 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:
                          - 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.
   MIGRATION_MODE = Supported values are webex_for_broadworks_to_wholesale. The default value is broadworks_to_wholesale. Use webex_for_broadworks_to_wholesale for Webex for BroadWorks migrations.
   

   המאפיין REFRESH_TOKEN הוא הכרחי עבור הגירת Webex for BroadWorks.

5. שנה את נתיב הסביבה JDK/JRE בקובץ export.sh אם נתיב הסביבה המשני של שרת היישומים Cisco BroadWorks JDK/JRE שונה מהקובץ:

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

פלט

קובץ ZIP של פלט (extracted_data_<timestamp>.zip) יהיה זמין באותה ספריית כלי חילוץ. השתמש בפקודה שלהלן כדי להציג ולהשתמש בקובץ ה-ZIP עבור קלט כלי ההמרה:

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

כלי ההמרה הזה פועל עבור כל ההגירה. כלי ההמרה פועל בכל מחשב, כולל מחשב נייד של מנהל מערכת של שותף, ומשתמש בממשקי ה-API הציבוריים של Webex. הוא קורא את קובץ ה-ZIP (extracted_data_<timestamp>.zip) הפלט של כלי החילוץ כקלט וממיר את ה-XML הגולמי לתבנית JSON המשמשת את כלי ההקצאה.

דרישות מקדימות

לאחר ההורדה והחילוץ של כלי ההגירה הבינאריים, קבע את התצורה של התנאים המוקדמים הבאים:

1. הגדר את אסימון הרענון_(האסימון שהועתק מכלי מחולל האסימונים) ואת השם_של המיקום _הראשי_ בקובץ conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. לחלופין, הגדר את מזהה ההקצאה_ (שהועתק מהתבנית במרכז השותפים) בקובץ conf/partner.cfg:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   כדי לקבל אימות מלא יותר של כתובת הדוא"ל של הלקוח, תוכל להגדיר אופציונלית את מזהה ההקצאה_.
3. קבע תצורה של מידע חסר בקובץ input/customers.csv (ראה הקטע הבא) אם חסר.
4. הוסף את כתובת הדוא"ל של משתמש הקצה בקובץ input/users.csv.
5. אם יש להקצות טלפונים חדשים, הוסף את כתובת ה-MAC וכתובת הדוא"ל של הטלפון החדש של המשתמש לקובץ input/newphones.csv. הדבר נדרש רק אם מנהלי המערכת של השותף רוצים להקצות טלפונים חדשים בשיחות Wholesale.
6. המר את מוקדי השיחות של BroadWorks ל-CxEssentials באמצעות קובץ input/cxessentials.csv.
7. לחלופין, הפעל את השדרוג_כל_CALL_CENTERS_TO_CX_ESSENTIALS כדי להמיר את כל מרכזי השיחות ל-CxEssentials.
8. השתמש בקובץ input/locations.csv כדי לתמוך בהגירה הארגונית הגדולה המאפשרת למנהלי מערכת לבצע הגירה של מיקומי הלקוח שלהם לפי מיקום
9. לחלופין, אפשר שימוש בכתובות MAC מהכותרת סוכן המשתמש של הודעת SIP REGISTER כאשר כתובת MAC אינה זמינה בפרופיל מכשיר Cisco BroadWorks. בטל את ההערה של הקו "USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes" בקובץ conf/partner.cfg
10. תכונת סנכרון שרת הרשת מאפשרת למנהלי מערכת להקצות מספרי טלפון, כתובות MAC וכתובות דוא"ל של משתמשים במהלך ההקצאה באותו אזור הגירה. כדי להפעיל אותה, הגדר USE_NS_SYNC=yes בconf/partner.cfg.

    אם סנכרון NS מושבת, המערכת תדלג על מספר הטלפון והקצאת המכשיר, והמשתמשים יקבלו כתובות דוא"ל זמניות.

מילוי קלט/customers.csv

הקובץ input/customers.csv מספק נתונים שעשויים להיות חסרים ב-Cisco BroadWorks או ב-BroadCloud. ניתן להשאיר קובץ זה ריק אם כל המידע ההכרחי כבר זמין. אין צורך למלא את כל העמודים, רק המידע החסר הוא חובה.

הטבלה שלהלן מסבירה את העמודות החשובות ביותר ב- input/customers.csv.

הוראות להפעלה

הפעל את כלי ההמרה בכל מערכת הפעלה. השתמש בשלבים הבאים כדי להפעיל את הכלי ב-Windows וב-macOS:

Windows

בצע את הפקודה להלן כדי להפעיל את כלי ההמרה ב-Windows:

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

מקOS

בצע את השלבים הבאים כדי להפעיל את כלי ההמרה ב-macOS:

1. צור סביבה וירטואלית והתקן יחסי תלות כדי להפעיל את כלי ההמרה באמצעות Python:

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

2. הפעל את כלי ההמרה:

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

בדיקה מוקדמת של לקוח/משתמש

כלי ההמרה מבצע שיחות API אל Webex כדי ללכוד בעיות הקצאה פוטנציאליות. כברירת מחדל, הוא יאמת את כתובת הלקוח ואת כתובת הדוא"ל הראשית. אם ערך מזהה ההקצאה_צוין בקובץ conf/partner.cfg, הוא גם יאמת פרטי מיקום. תוצאות הבדיקה המוקדמת כלולות בדוח החריגה.

בנוסף, ניתן להוסיף את הפרמטרים האופציונליים הבאים בעת הפעלת כלי ההמרה:

בדיקה מוקדמת

בנוסף להפעלת ה-API לבדיקה מוקדמת עבור פרטי הלקוח, כלי ההמרה יפעיל גם את ה-API לבדיקה מוקדמת עבור הודעות הדוא"ל של המנוי.

תצוגה מקדימה

כברירת מחדל, רק שגיאות בדיקה מראש (כלומר, בעיות שיחסמו את ההקצאה) כלולות בדוח החריגה. הוספת דגל זה תכלול גם תוצאות בדיקה מוקדמת מוצלחות (למשל, אם כבר קיים ארגון 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

דוח חריגה

כלי ההמרה יוצר את דוח החריגה בספר הטלפונים output/<timestamp>/exception_report.txt . באפשרותך להשתמש בדוח זה כדי לזהות את הבעיות שישפיעו על ההגירה ולתקן אותן במערכת Cisco BroadWorks.

לאחר שינוי נתוני המשתמש כדי לפתור את החריגה, הפעל מחדש את כלי החילוץ וההמרה עם הנתונים החדשים. קובץ דוח חריגה לדוגמה כדלקמן:

Exception Report
Tue Oct 18 08:12:09 2022

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

פלט

קובץ JSON של פלט (customer.json) יהיה זמין בספרייה output/<timestamp>/<groupid> . הקובץ לדוגמה customer.json הוא כדלקמן:

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

כלי ההקצאה יכול להפעיל בכל מחשב בדרך כלל את המחשב (מחשב נייד של מנהל המערכת של השותף) ומשתמש בממשקי ה-API הציבוריים של 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 = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • הגדר הודעות דוא"ל של ALLOW_ADMIN_INVITE_ ל-false, אם השותף לא רוצה לשלוח הודעת ברוכים הבאים למשתמשים. ערך ברירת המחדל הוא true.

4. השתמש במאפיין נושא הדוא"ל של WEBEX4BWKS_EMAIL_עבור ההגירה של Webex for BroadWorks כדי לשלוח את נושא הדוא"ל לבקשת שינוי הסיסמה עבור מנויי Webex for BroadWorks.
5. השתמש במאפיין WEBEX4BWKS_EMAIL_BODY עבור Webex for BroadWorks כדי לשלוח את גוף הדוא"ל לבקשת שינוי הסיסמה עבור מנויי Webex for BroadWorks.
6. תכונת סנכרון שרת הרשת מאפשרת למנהלי מערכת להקצות מספרי טלפון, כתובות MAC וכתובות דוא"ל של משתמשים במהלך ההקצאה באותו אזור הגירה. כדי להפעיל אותה, הגדר USE_NS_SYNC=yes בconf/partner.cfg.

   אם סנכרון NS מושבת, המערכת תדלג על מספר הטלפון והקצאת המכשיר, והמשתמשים יקבלו כתובות דוא"ל זמניות.

עבור הגירת BroadCloud אותו אזור:

1. הכלי מדלג על ההקצאה של המספרים, המכשירים והופעות שיחה משותפות.
2. הכלי יוצר משתמשים ומשתמשים וירטואליים עם שלוחה ושלוחה זמנית.

עבור הגירת BroadCloud אזור אחר:

1. הכלי יקצה מספרים, מכשירים והופעות שיחה משותפות.
2. הכלי יוצר משתמשים ומשתמשים וירטואליים עם מספרי טלפון ושלוחה ממשיים.
   כל הגירות BroadCloud של אירופה הן לאזור אחר.

הוראות להפעלה

השתמש בשלבים הבאים כדי להפעיל את הכלי ב-Windows וב-macOS:

Windows

בצע את השלבים הבאים כדי להפעיל את הכלי במערכת ההפעלה Windows:

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

מקOS

בצע את השלבים הבאים כדי להפעיל את הכלי ב-macOS:

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

תנאים מוקדמים עבור הגירת Webex עבור BroadWorks

מנהלי מערכת של שותפים חייבים לעדכן את תבנית הצירוף של BroadWorks שלהם עבור תכונות דו-קיום של Webex for BroadWorks. עיין בתמונה הבאה:

לאחר שתבנית הצירוף של Webex עבור BroadWorks מעודכנת כדי לתמוך בהגירה, בקש מצוות החשבון של Cisco להפעיל את הלחצן הדו-מצבי של התכונה "סיטונאות-שותף-blending-enabled" ברמת השותף. זה יאפשר הוספת חבילות Wholesale לארגוני לקוחות קיימים של Webex for BroadWorks במהלך ההקצאה.

הפעל את כלי ההקצאה עם ארגומנט נוסף.

שלב ההכנה: הוא שלב ברירת המחדל שבו מנהלי מערכת יכולים להקצות את משתמשי BroadWorks כמנוי ל-Wholesale ולהמשיך עם משתמשי Webex עבור BroadWorks.

שלב תחזוקה: הוא השלב השני שבו מנהלי מערכת יכולים להקצות את רישיון Wholesale למשתמשי Webex עבור BroadWorks הקיימים. עליך להפעיל את כלי ההקצאה עם תחזוקה ארגומנט.

שלב לאחר ההגירה: הוא השלב האחרון שבו מנהלי מערכת יכולים להמיר את BroadWorks ל-Wholesale לחלוטין. עליך להפעיל את כלי ההקצאה עם ארגומנט לאחר הגירה.

יומני רישום של מסוף

להלן יומני הרישום במסוף להקצאה מוצלחת:

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

תודפס טבלה עם מספר המיקומים שנוצרו עבור כל הפעלה:

פלט

כלי ההקצאה יוצר דוחות הצלחה ושגיאה בקובצי output/<external_id>/*.success/error . בחן את הצלחת הפלט ואת יומני הרישום של השגיאות כדי לאמת הקצאה מוצלחת.

מנהלי מערכת של שותף יכולים לאמת את הקצאת הלקוח בפורטל Partner Hub ובפורטל Control Hub. עיין באיורים הבאים מ-Partner Hub ומפורטל Control Hub:

איור 8: מרכז השותפים

איור 9: Control Hub

איור 10: מכשירים

איור 11: שיחות

עבור BroadCloud

עבור שותפי BroadCloud, השתמש בפורטל ספק השירות כדי לשלוח בקשת הגירה עבור מספרים, מכשירים והגירות SCA.

בתוך פורטל ספק השירות, בקשת הגירה יכולה לכלול עד 50 לקוחות. ניתן להגיש 10 בקשות לכל היותר תוך יום.

התכונה 'סנכרון שרת רשת' מאפשרת למנהלי מערכת להשבית את המיקום broadCloud ולהפעיל את מיקום Webex Calling בעת הגדרת USE_NS_SYNC=yes ב-conf/partner.cfg. לאחר ההגירה, מכשירים ומספרי טלפון מופעלים במיקום Webex Calling.

מנהלי מערכת יכולים להפעיל חזרה אוטומטית על-ידי הגדרה ROLLBACK_TO_BROADCLOUD=true בקובץ conf/partner.cfg , המעביר מכשירים בחזרה ל-BroadCloud לאחר ההגירה. הוא תומך הן בהגירות באותו אזור עם סנכרון NS, אך רק עבור הגירות מוצלחות. עבור מכשירים שנכשלו, מנהלי מערכת חייבים להעלות TAC של Cisco לפני בקשת החזרה למצב קודם.

הנתונים שלהלן מציגים את פורטל ספק השירות.

איור 12: פורטל ספק שירות

איור 13: פורטל ספק שירות

עבור Cisco BroadWorks ו-Webex עבור BroadWorks

עבור הגירות Cisco BroadWorks ו-Webex עבור BroadWorks, הכלי פועל בשרת היישום המשני של Cisco BroadWorks בתוך רשת השותפים ומתחבר ל-AS באמצעות OCI-P. הוא משתמש בקובץ JSON הפלט של כלי ההמרה (customer.json) כקלט ולהפעיל את פקודות OCI-P כדי לבצע הגירה של מכשירים ולקוחות רכים.

בפעולה מוצלחת, כלי העברת המכשיר יבצע:

1. בטל את הרישום של המכשירים מ-Cisco BroadWorks ורשום אותם ב-Wholesale.
2. משתמשים המשתמשים בלקוח UC-One ינותבו מחדש ליישום Webex בכניסה הראשונה.
3. השבת את מספרי הטלפון מ-Cisco BroadWorks או הסר את מספרי הטלפון מ-BroadCloud.
4. הפעל מספרים ב-Wholesale.
5. צור הופעות שיחה משותפות ב-Wholesale עבור הגירות BroadCloud. [שלב זה חל רק על הגירות של BroadCloud].

SCP ו-SSH

1. SCP כלי העברת המכשיר לשרת היישומים המשני של Cisco BroadWorks.
2. SSH לשרת היישומים המשני של Cisco BroadWorks כדי לקבוע את התצורה של הדרישות המקדימות ולהפעיל את כלי העברת המכשיר.

דרישות מקדימות

1. הגדר את אסימון הרענון_ (האסימון שהועתק מכלי מחולל האסימון) בקובץ conf/partner.cfg:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. ודא שמזהה המשתמש, הסיסמה ושם המארח המשני של שרת היישום Cisco BroadWorks נכונים בקובץ conf/deviceMoveTool.conf:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. כדי לשלוח מחדש הודעות דוא"ל של הפעלה, עליך להגדיר RESEND_הזמנה_EMAILS=true בקובץ conf/partner.cfg.

   אם מנהלי מערכת רוצים לשלוח הודעות דוא"ל של הזמנה למשתמשים שלהם במהלך ההגירה, עליהם לבטל את ההערה על המאפיין "שלח מחדש_הזמנה_EMAILS=true" בקובץ conf/partner.cfg. אחרת, הנכס יישאר ללא שינוי.

4. ודא שהנתיב סביבת JDK/JRE נכון ב-devicemove.sh

   JAVA_HOME=/usr/local/java/java_base

5. מנהלי מערכת יכולים להשתמש בקובץ locations.csv מספריית הקלט כדי לבצע הגירה של הקבוצות הספציפיות במקום של כל הקבוצות תחת ארגון.

טלפוני Polycom

כדי להעביר טלפונים של 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 בקובץ device-move-tool/conf/partner.cfg.
3. כלי העברת המכשיר מבקש משרת היישומים של Cisco BroadWorks לאתחל מחדש טלפונים ברמת הקבוצה או ברמת המכשיר.
4. לאחר בקשת האתחול, טלפונים של Polycom מורידים ו-process% BWMACADDRESS%.cfg, שמבקש מטלפונים של Polycom להוריד ולprocess 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 בתוך ספריית כלי העברת המכשיר:

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

יומני רישום של מסוף

להלן יומני הרישום במסוף להפעלה מוצלחת של כלי העברת המכשיר עבור הגירת מכשיר:

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

פלט

לאחר הגירת המכשיר, מכשירים נכנסו למצב מקוון ומוכנים לבצע/לקבל שיחות. עיין באיור 15 כדי לראות דוגמה של מצב המכשיר:

איור 15: מצב מכשיר

לאחר הגירת המכשיר, המספרים נעשים פעילים. עיין באיור 16 כדי לראות דוגמה של אילו מספרים פעילים:

איור 16: מספרים פעילים

יש לבצע את הפעולה החוזרת עבור ארגון אחד בכל פעם.

עבור ספק שירות BroadCloud

תהליך ההחזרה עבור שותפי BroadCloud הוא כדלקמן:

1. פתח כרטיס עם Cisco TAC כדי לבקש החזרת מכשיר.
2. הפעל את כלי העברת המכשיר במצב החזרה:
   • ההקצאה של מספרי הטלפון תבוטל מ-Webex Calling, והיא תשאיר משתמשים ושירותים עם שלוחות בלבד.
   • כתובות דוא"ל ב-Webex Calling יוחזרו לכתובות דוא"ל זמניות.
   • הטלפונים יימחקו מ-Webex Calling.
   • מספרי טלפון, כתובות דוא"ל המשמשות כמזהי חלופיים וטלפונים ייווצרו מחדש ב-BroadCloud.
   • הטלפונים יאותחלו.
3. מנהלי מערכת של שותף חייבים להעביר מספרי טלפון של PSTN בחזרה לספק השירות של BroadCloud.

עבור Cisco BroadWorks ו-Webex עבור BroadWorks

תהליך ההחזרה עבור Cisco BroadWorks ו-Webex עבור BroadWorks הוא כדלקמן:

1. פתח כרטיס עם Cisco TAC כדי לבקש החזרת מכשיר.
2. הפעל את כלי העברת המכשיר במצב החזרה בשרת היישומים המשני של BroadWorks כדי לבטל את הגירות המכשיר. פעולה זו תגדיר את כתובת ה-URL של ה-DMS בחזרה לכתובת ה-DMS של ספק השירות עבור פרופילי מכשירים ב-Cisco BroadWorks ותפעיל מחדש את מספרי הטלפון.
3. צוות Webex Calling מגדיר את כתובת ה-URL של ה-DMS בחזרה לכתובת ה-DMS של ספק השירות בפרופילי מכשירים ב-Webex Calling.
4. מנהלי מערכת של שותף חייבים להשבית או למחוק את מספרי הטלפון ב-Webex Calling דרך פורטל Control Hub.
5. מנהלי מערכת של שותף חייבים להעביר מספרי טלפון של PSTN בחזרה ל-Cisco BroadWorks.

הוראות להפעלת כלי העברת מכשיר במצב החזרה

בצע את השלבים הבאים כדי להפעיל את כלי העברת המכשיר במצב אחורה:

הפעל את הפקודה להלן בשרת היישומים המשני של Cisco BroadWorks בתוך ספריית כלי העברת המכשיר:

בטל פרופילים

./devicemove.sh -input=  -revertProfiles

החזר מספרים

./devicemove.sh -input=  -revertNumbers

יומני רישום של מסוף

אנו נקבל את יומני הרישום הבאים במסוף על הפעלה מוצלחת של כלי העברת המכשיר לפעולה חוזרת:

בטל פרופילים

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

החזר מספרים

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