עבור ברודקלאוד

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

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

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

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

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

בקשת חילוץ CSV

התחל בקשת חילוץ CSV

1. הורד את קובץ ה-CSV של הלקוח

   לחץ על הקישור הורד קובץ CSV של לקוח בפינה הימנית העליונה של הקטע התחל בקשת חילוץ CSV.

2. עריכת רשימת הלקוחות

   המנהל יכול לערוך את קובץ ה-CSV הזה כך שיכלול רק את הלקוחות שעבורם יש לבצע את החילוץ.

3. העלאה ושליחה

   לאחר העריכה, העלה את קובץ ה-CSV שהשתנה.

   לחץ על שלח כדי להפעיל בקשת חילוץ עבור הלקוחות המפורטים והמיקומים הקשורים אליהם.

התחל בקשת חילוץ עבור לקוח עם קובץ CSV של מיקומים

1. בחירת מיקומי לקוח והורדה

   בחר לקוח מהתפריט הנפתח.

   הורד את קובץ ה- locations.csv המתאים מ- View Customers→ Sites tab → Export Locations as CSV.

2. עריכת קובץ המיקומים

   מנהל המערכת יכול לערוך את קובץ ה-CSV כך שיכלול רק את המיקומים שהוא מעוניין לחלץ.

3. העלאה ושליחה

   העלה את קובץ ה-locations.csv הערוך ולחץ על שלח.

   רק המיקומים שצוינו עבור הלקוח הנבחר ייכללו בבקשת החילוץ.

התחלת בקשת חילוץ עבור כל הלקוחות

1. לחץ על שלח כדי ליזום בקשת חילוץ עבור כל הלקוחות ו כל המיקומים שלהם תחת ספק השירות הנוכחי.

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

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 אם שרת היישומים המשני של 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. ניתן להגדיר באופן אופציונלי את מזהה PROVISIONING_(שהועתק מהתבנית במרכז השותפים) ב- conf/partner.cfg קוֹבֶץ:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

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

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

11. ניתן להפעיל באופן אופציונלי את המאפיינים ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG__USER_[] TYPE ENABLE_MUSIC_ON_HOLD, ו- ANALOG_USER_TYPE_DISABLE_T38 כדי להגדיר שיחה ממתינה, מוזיקה בהמתנה ולהשבית את הגדרות T38 עבור כל המשתמשים מסוג אנלוגי.

מילוי ה input/customers.csv

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

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

מילוי ה input/users.csv

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

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

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

Windows

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

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

macOS

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

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

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

2. הפעל את כלי הטרנספורמציה:

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

Customer/user בדיקה מוקדמת

כלי הטרנספורמציה מבצע קריאות API ל-Webex כדי לזהות בעיות הקצאה פוטנציאליות. כברירת מחדל, הוא יאמת את כתובת הלקוח ואת כתובת הדוא"ל הראשית שלו. אם ערך מזהה PROVISIONING_מצוין ב- 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

דוח חריגים

כלי הטרנספורמציה מייצר את דוח החריגים בתוך הפלט /<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 במחשב. ג'אווה זמינה ממקורות רבים, כולל:
   • 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_:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

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

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

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

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

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

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

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

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

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

Windows

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

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

macOS

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

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

דרישות מוקדמות עבור Webex עבור העברת BroadWorks

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

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

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

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

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

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

יומני טרמינל

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

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

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

פלט

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

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

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

איור 9: Control Hub

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

איור 11: שיחות

עבור ברודקלאוד

עבור שותפי BroadCloud, השתמשו בפורטל ספק השירות כדי להגיש בקשת העברה עבור מספרים, מכשירים והעברות של Shared Call Appearances (SCA).

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

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

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

ישנן שתי אפשרויות זמינות לבחירת סוג ההגירה בפורטל:

• העברה – בחר באפשרות זו כדי ליזום בקשה להעברת מספרים, מכשירים ותצוגות שיחות משותפות (SCA).
• סטטוס מכשיר – בחר באפשרות זו כדי להציג את הסטטוס הנוכחי של מכשיר ב-BroadCloud וב-Calling.

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

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

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

העברת מיקומים נבחרים (אופציונלי)

כדי להתחיל את ההגירה עבור תת-קבוצה ספציפית של מיקומים המפורטים בקובץ customer.json, צרפו קובץ locations.csv לבקשתכם. קובץ CSV זה צריך לפרט רק את המיקומים שבכוונתך להעביר.

כדי להוריד את רשימת האתרים הפעילים הזמינים, נווט אל הצג לקוחות → בחר לקוח → ייצוא מיקומים כקובץ CSV.

איור 14: ייצוא מיקומים כקובץ CSV

עבור 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. הפעל מספרים בסיטונאות.
5. צור הופעות שיחות משותפות ב-Wholesale עבור הגירות BroadCloud. [This השלב רלוונטי רק עבור BroadCloud migrations].

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. כדי לשלוח שוב הודעות הפעלה, עליך להגדיר שלח מחדש_הזמנה_EMAILS=true ב- conf/partner.cfg קוֹבֶץ.

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

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

   JAVA_HOME=/usr/local/java/java_base

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

טלפונים של פוליקום

כדי להעביר טלפוני Polycom מ-Cisco BroadWorks ל-Wholesale Calling, מנהל שותף חייב ליצור חשבון חדש. Identity/Device קובץ סוג פרופיל ברמת המערכת ב-Cisco BroadWorks כל תבנית של התקן Polycom. עיינו באיור 14 והעלו את הקובץ המותאם אישית device-move-tool/conf/deviceProfile/{region}/ קובץ .cfgpolycom_vvx. לאחר העלאת קובץ המכשיר החדש, ודא שהקובץ החדש שנוצר קיים ברמת הקבוצה. כמו כן, ודא שהקובץ 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 מורידים ומעבדים את% BWMACADDRESS%.cfg, מה שמבקש מטלפוני Polycom להוריד ולעבד את migration_%BWMACADDRESS%.cfg, מה שמגדיר את device.prov.serverName ל- https://plcm.sipflash.com.
   https://plcm.sipflash.com עבור אזור ארה"ב, לאזורים אחרים יש כתובות URL שונות.
5. טלפון ה-Polycom מוריד את קובץ %BWMACADDRESS%.cfg מ- https://plcm.sipflash.com וינוהל על ידי מערכת ניהול השיחות של Webex Calling.

איור 14: Identity/device הוסף קובץ מסוג פרופיל

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

ישנן שתי שיטות להפעיל את ה-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

פלט

לאחר העברת המכשיר, המכשירים חזרו לאינטרנט ומוכנים להפעלה make/receive שיחות. עיין באיור 15 כדי לראות דוגמה למצב המכשיר:

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

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

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

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

עבור ספק 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 לכתובת ה-URL של ספק השירות עבור פרופילי מכשירים ב-Cisco BroadWorks ותפעיל מחדש את מספרי הטלפון.
3. צוות Webex Calling מחזיר את כתובת ה-URL של ה-DMS לכתובת ה-URL של ספק השירות בפרופילי המכשירים ב-Webex Calling.
4. מנהלי שותפים חייבים לבטל או למחוק את מספרי הטלפון ב-Webex Calling דרך פורטל מרכז הבקרה.
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