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

העמודה האחרונה מספקת את המיפוי של דגמי הטלפון לעמודה "סוג מכשיר" של כלי ההמרה הקובץ/input/newphones.csv. (ראה סעיף כלי המרה במאמר זה לקבלת מידע נוסף על newphones.csv).

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

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

לאחר ההורדה, חלץ את בינאריות כלי ההגירה.

הגדר את נתיב הסביבה של JRE/JDK ב-token_generator.sh עבור MAC וב-token_generator.bat עבור Windows. אם נתיב JAVA_HOME כבר קיים, הכלי יעשה בו שימוש חוזר.

• מק: JAVA_HOME="/משתמשים/cisco/jdk/zulu@1.8.282/Contents/Home/"

• Windows: JAVA_HOME=C:\פרוגרה~1\Java\jre1.8.0_321

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

הפעל את הפקודה הבאה במסוף בתוך ספריית מחולל האסימונים:

Windows:

token_generator.bat

מקOS:

./token_generator.sh

פלט:

שם כלי: גרסת כלי מחולל אסימונים: 1.13.0 טען את כתובת ה-URL בדפדפן האינטרנט שלך: http://localhost:8080 

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

האיורים של ממשק המשתמש ניתנים להלן לעיון:

איור 3: היכנס באמצעות Cisco Webex

איור 4: חלון פרטי כניסה

איור 5: יצירת אסימונים

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

הפעל קישוריות OCI-P

כלי העברת המכשיר מתקשר עם BroadWorks באמצעות פקודות OCI-P. כדי לאפשר קישוריות OCI-P, השתמש בשלבים הבאים:

שלב 1: השתמש ב-CLI כדי לקבוע תצורה של הגדרות כלליות.

הפעל את הפקודה הבאה ב-CLI כדי לשנות לספריית GeneralSettings:

AS_CLI> cd /יישומים/OpenClientServer/GeneralSettings.

הפעל את הפקודה הבאה ב-CLI כדי לקבל את GeneralSettings הנוכחיות:

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

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

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

שנה את הספרייה ל-OCI Proxy:

AS_> cd /יישומים/OpenClientServer/OCIProxy

הפעל את ה-CLI הבא כדי לקבל הגדרות נוכחיות. עליך לראות את הדברים הבאים:

AS_CLI/Applications/OpenClientServer/OCIProxy> get enabled = true enabledLoginLevelScreening = false enableResponseCaching = false responseCacheDurationHours = 24 responseCacheRenewPeriodדקות = 30 messageQueueCapacity = 50 messageQueueTimeoutSeconds = 1800 

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

שלב 3: השתמש ב-CLI כדי להגדיר הקצאת OCI.

שנה לספריית ההקצאה:

כ_CLI> cd /מערכת/NetworkAccessLists/OCI/הקצאה

הפעל את הפקודה הבאה כדי לקבל את הגדרות הקצאת OCI הנוכחיות:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> קבל תיאור כתובת ======================== 127.0.0.1 מקומי כ- 

שלב 4: הפעל את הפקודה להלן ב-CLI כדי לוודא שהתצורה שלך נכונה.

 AS_CLI/Maintenance/ManagedObjects> קבל את Broadworks ובדוק שהפלט שלך נראה תקין. עיין להלן לקבלת פלט לדוגמה: AS_CLI/Maintenance/ManagedObjects> קבל את BroadWorks Managed Objects ========================== * שרת: זהות..............: גרסת AS...............: Rel_21.sp1_1.551 מדינה מנהלית..: נעילת * יישומים בוטלה: שם גרסה פריסת מצב מנהל מערכת אפקטיבי מצב ========================================================================================= ExecutionAndProvisioning 21.sp1_1.551 נכון לא נעול לא נעול FlashPolicy 21.sp1_1.551 false לא נעול הופסק OpenClientServer 21.sp1_1.551 נכון לא נעול לא נעול WebContainer 21.sp1_1.551 נכון לא נעול לא נעול 4 ערכים נמצאו. * יישומים מתארחים: שם גרסה נתיב הקשר פרוס ================================================================== CommPilot 21.sp1_1.551 / נכון DeviceManagementFiles 21.sp1_1.551 /DeviceManagement נכון JWSFiles 21.sp1_1.551 /FileRepos נכון MediaFiles 21.sp1_1.551 /media true OCIFiles 21.sp1_1.551 /ocifiles נכון 5 ערכים נמצאו. 

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

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

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

AS_CLI/Maintenance/ManagedObjects> פרוס יישום OpenClientServer

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

AS_CLI/Maintenance/ManagedObjects> הפעל את היישום OpenClientServer

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

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

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

כ_CLI> מנוי cdMgmt/NumberActivation

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

כ_CLI> הגדר קבוצת dnModeAndUserActivationEnabled

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

   מזהה ספק שירות-A:      - GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceספקID-B:                        - הכל 

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

   BROADWORKS__ = מנהל BROADWORKS_סיסמה = מנהל BROADWORKS_HOST_NAME = localhost REFRESH_TOKEN = אסימון רענון של מנהל המערכת של שותף שהועתק מכלי מחולל האסימונים. מצב הגירה_ = ערכים נתמכים הם webex_for_broadworks_to_wholesale. ערך ברירת המחדל הוא broadworks_to_wholesale. השתמש webex_for_broadworks_to_wholesale עבור הגירות של Webex עבור BroadWorks. 

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

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

   JAVA_HOME=/usr/local/java/java_base

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

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

./export.sh

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

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

 פועל כלי ייצוא נתונים BroadSoft ************************************************ החל כלי ייצוא v: 1.15.0 הייצוא התחיל עבור SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg יצוא משתמשים עבור SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg ייצוא משתמשים הושלם עבור SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg הייצוא הושלם עבור SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg ייצוא הושלם Dump Zip Directory : פלט/20221017223452_שם קובץ Zip Dump ExportTool :extracted_data_1666060500618.zip קובץ Zip בשם extracted_data_1666060500618.zip נוצר תהליך יצירת קובץ ZIP הושלם קבצים מיוצאים שהומרו כקובץ ZIP ************************************************** 

פלט

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

ls –ltr drwxr-xr-x 2 bwadmin bwadmin 4096 אוק  4 11:53 lib/ -rwxr-xr-x 1 bwadmin bwadmin 956719 אוקטובר  4 11:53 exportTool.jar -rwxr-xr-x 1 bwadmin bwadmin 2635 אוק  4 11:53 export.sh drwxr-xr-x 2 bwadmin bwadmin 4096 אוק  5 05:04 conf/ drwxrwxr-x 3 bwadmin bwadmin 4096 אוק 17 22:34 פלט/ drwxrwxr-x 2 bwadmin bwadmin 4096 אוק 17 22:34 יומני רישום/ -rw-rw-r-- 1 bwadmin bwadmin 46341 אוק 17 22:35 extracted_data_1666060500618.zip 

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

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

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

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

   רענון_אסימון=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj שם_של_המיקום הראשי_=ראשי 

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

   הקצאה_מזהה=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

מילוי קלט/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 מקור venv/bin/activate python3 -m pip install requests python3 -m pip install requests-oauthlib 

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

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

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

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

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

בדיקה מוקדמת

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

תצוגה מקדימה

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

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

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

דוח סיכום של ארגוני BroadWorks שניתן לבצע הגירה בהצלחה: 1 ארגוני BroadWorks שלא ניתן לבצע הגירה: 0 משתמשי BroadWorks שניתן לבצע הגירה בהצלחה: 4 משתמשי BroadWorks שלא ניתן לבצע הגירה: 0 טלפונים שניתן לבצע הגירה בהצלחה: 3 טלפונים שאינם תואמים ל-Webex Calling: 0 

דוח חריגה

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

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

דוח חריגה יום שלישי 18 08:12:09 2022 המלצה על תכונת חסימת תקשורת: קבע ידנית את התצורה של תוכנית השיחות היוצאות ב-Control Hub ________________________________________________________________________________ collabmigrationtestGRP_engg 

פלט

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

{ "customer": { "provisioningId": "!!!!!!!!!!REPLACE_עם_הקצאה!!!!!!!!!!", "חבילות": ["webex_calling", "common_area_calling" ], "externalId": "external_id_engg_grp1", "כתובת": { "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" }, "אזור זמן": "America/N"ew_יורק", "שפה": "en_us", "מספרים": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110" ], "mainNumber": "+15205551101" } }}, "broadworks_info": {"service_provider_id": "collabmigration testSP_engg", "group_id": "collabmigration testGRP_engg" }, "מנויים": [{ "amareswaranvel+benjaminjack@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE_עם_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+benjaminjack@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "בנג'מין", "lastName": "ג'ק", "primaryPhoneNumber": "+15205551102", "שלוחה": "1102" } }, "תכונות": [ { "/v1/people/{personId}/features/דואר קולי": { "מופעל": true, "sendBusyCalls": { "מופעל": true, "ברכה": "ברירת מחדל" }, "sendUnansweredCalls": { "מופעל": true, "ברכה": "ברירת מחדל", "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": { "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+lucasoliver@gmail.com", "package": "webex_calling", "provisioningParameters": { "firstName": "לוקאס", "lastName": "Oliver", "primaryPhoneNumber": "+15205551103", "extension": "1103" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true, "sendBusyCalls": { "מופעל": true, "ברכה": "ברירת מחדל" }, "sendUnansweredCalls": { "מופעל": true, "ברכה": "ברירת מחדל", "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": { "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": { "מופעל": true, "ברכה": "ברירת מחדל" }, "sendUnansweredCalls": { "מופעל": true, "ברכה": "ברירת מחדל", "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": "אוון", "lastName": "אלכסנדר", "primaryPhoneNumber": "+15205551101", "extension": "1101" } }, "features": [ { "/v1/people/{personId}/features/voicemail": { "enabled": true, "sendBusyCalls": { "מופעל": true, "ברכה": "ברירת מחדל" }, "sendUnansweredCalls": { "מופעל": true, "ברכה": "ברירת מחדל", "numberOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "external", "externalEmail": "engineering8811@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_עם_PERSONID!!!!!!!!!!", "מוצר": "DMS Cisco 8811", "mac": "F87B204E4066" } ] } } ], "auto_attendants": [], "call_queues": [], "hunt_groups": [], "לוחות זמנים": [], "call_parks": [], "call_pickups": [], "paging_groups": [], "voice_portals": [ { "name": "פורטל קולי אוטומטי", "firstName": "אוטומטי", "lastName": "פורטל קולי", "languageCode": "en_us", "phoneNumber": "+15205551105", "שלוחה": "1105" } ], "shared_call_appearances": [], "business_communicator_desktop_to_upgrade_to_webex_app": ["PC Comm - פרופיל מכשיר Engg"], "connect_client_to_upgrade_to_webex_app": [], "מיקומים": [], "webex_for_broadworks_info": { "users": [ { "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgמזהה": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

כלי ההקצאה יכול להפעיל בכל מחשב בדרך כלל את המחשב (מחשב נייד של מנהל המערכת של השותף) ומשתמש בממשקי ה-API הציבוריים של Webex. הוא קורא את קובץ ה-JSON של פלט כלי ההמרה (customer.json) כקלט והקצה את הלקוחות, המיקומים, המספרים, המשתמשים, השירותים והמכשירים בפתרון Webex Wholesale RTM.

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

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

1. התקן את Java 8, 11 או 17 במחשב. Java זמין ממקורות רבים, כולל:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://download.oracle.com/java/17/latest/jdk-17_macos-x64_bin.dmg
2. לאחר ההורדה והחילוץ של כלי ההגירה הבינאריים, הגדר את משתנה הסביבה של JAVA_HOME ב-provisioning_tool‎.sh עבור MAC ו-provisioning_tool‎.bat עבור Windows.
3. קובץ partner.cfg:
   • הגדר את מזהה הקצאה__ואסימון רענון_ (האסימון שהועתק מכלי יוצר האסימונים). מנהלי המערכת של השותף חייבים לפנות לצוות החשבון שלהם כדי לקבל את מזהה ההקצאה_:

     סיטונאות_הקצאה_מזהה = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 רענון_אסימון=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.

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

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

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

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

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

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

Windows

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

כדי להקצות לקוח יחיד: provision.bat -input= כדי להקצות לקוחות מרובים: provision.bat -input= 

מקOS

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

כדי להקצות לקוח יחיד: ./transform.sh -input= כדי להקצות לקוחות מרובים: ./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 לחלוטין. עליך להפעיל את כלי ההקצאה עם ארגומנט לאחר הגירה.

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

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

שם כלי: גרסת כלי הקצאה: 1.15.0 ********** התחיל עיבוד הקובץ : input/customer.json **************** הקצאת לקוח ממתין ללקוח external_id_engg_grp1 כדי להשלים את ההקצאה... ממתין שהלקוח external_id_engg_grp1 ישלים את ההקצאה...   מצב לקוח external_id_engg_grp1: הקצאת מספרים הקצאת משתמשים הקצאת תכונות משתמש הקצאת ברכות הקצאה לוחות זמנים הקצאת מכשירים הקצאת הופעות שיחה משותפת הקצאת ניתובים אוטומטיים הקצאת תורי שיחות הקצאת קבוצות גישוש הקצאת קבוצות הקצאת שיחות הקצאת פארקי שיחות הקצאת מענה לשיחות הקצאת מענה לשיחות הקצאת פורטל קולי ********** קובץ הושלם : input/customer.json **************** 

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

פלט

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

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

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

איור 9: Control Hub

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

איור 11: התקשרות

עבור BroadCloud

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

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

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

איור 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:

   רענון_אסימון=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS__ = מנהל מערכת BROADWORKS_סיסמה = מנהל מערכת BROADWORKS_מארח_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 בתוך ספריית כלי העברת המכשיר:

עבור מכשיר להעביר לקוח יחיד: ./devicemove.sh -input= ./devicemove.sh -input=/tmp/customername.json עבור מכשיר להעביר לקוחות מרובים: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json בנוסף, כלי העברת המכשיר תומך בהגירת טלפונים בודדים/ספציפיים ממהדורה 1.35.0. השתמש בפקודה הבאה: ./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

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

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

שם כלי: גרסת כלי העברת מכשיר: 1.15.0 כלי המכשיר התחיל... מכשירים חוקיים להגירה: ------------------------------------------------------------------------------------------------------------------- | סוג מכשיר | מק | גרסה | דוא"ל | ------------------------------------------------------------------------------------------------------------------- | DMS Cisco 7861 | מק"ט98914eaad7 | סרגל סטנסילים Stencils_cc98914eaad7_ | דוא"ל@gmail.com | | DMS Cisco 6821 | 5486bcae7e45 | סרגל סטנסילים Stencils_5486bcae7e45_ | דוא"ל:@gmail.com | | DMS Cisco 8811 | f87b204e4066 | סרגל סטנסילים Stencils_f87b204e4066_ | מייל: info@gmail.com | האם ------------------------------------------------------------------------------------------------------------------- ברצונך לבצע הגירה של כל המכשירים האלה? ([Y]ים או [N]O) כן העלאת פרופילי מכשיר עבור DMS Cisco MPP LC Rebuild Device Process Started בנייה מחדש של מכשיר התהליך הושלם בהצלחה אתחול מחדש תהליך התחיל תהליך האתחול הושלם בהצלחה שינוי פרופילים עבור Business Communicator תחת collabmigrationtestGRP_engg תהליך הפעלת מספרי טלפון של webex התחיל עבור מזהה הארגון של הלקוח: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c תהליך הפעלת מספרי טלפון של Webex הושלם עבור מזהה הארגון של הלקוח: 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c תהליך השבתת מספרי הטלפון של Broadworks החל עבור groupId : collabmigrationtestGRP_engg תהליך השבתת מספרי טלפון של Broadworks הושלם עבור groupId: collabmigrationtestGRP_engg הגירת מכשיר הושלמה 

פלט

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

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

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

בטל פרופילים

שם כלי: גרסת כלי העברת מכשיר: 1.15.0 כלי המכשיר התחיל עבור תהליך החזרה... מכשירים שניתן להעביר בחזרה מ-Webex Calling ל-BroadWorks: - ------------------------------------------------------------------------------------------------------------------- | סוג מכשיר | מק | גרסה | דוא"ל | ------------------------------------------------------------------------------------------------------------------- | DMS Cisco 7861 | מק"ט98914eaad7 | סרגל סטנסילים Stencils_cc98914eaad7_ | דוא"ל@gmail.com | | DMS Cisco 6821 | 5486bcae7e45 | סרגל סטנסילים Stencils_5486bcae7e45_ | דוא"ל:@gmail.com | | DMS Cisco 8811 | f87b204e4066 | סרגל סטנסילים Stencils_f87b204e4066_ | מייל: info@gmail.com | ------------------------------------------------------------------------------------------------------------------- האם ברצונך להעביר בחזרה את המכשירים האלה מ-Webex Calling ל-BroadWorks? (כן, Y, לא, N):  כן העלאת פרופילי מכשיר עבור DMS Cisco MPP LC Rebuild Device Process Started Rebuild Device Process Completed Successfully Reboot Process Started Reboot Process Completed Successfully Migration Device Completed For Deprovisioning Process 

החזר מספרים

שם כלי: גרסת כלי העברת מכשיר: 1.15.0 האם ברצונך להמשיך בהחזרת מספרים ל-Broadworks?  ([Y]ים או [N]o):  Y [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551108, +15205551109, +15205551110] התחלה אחורה תהליך הפעלת מספרי טלפון של Broadworks התחיל עבור groupId : collabmigrationtestGRP_engg תהליך הפעלת מספרי טלפון של broadworks הושלם עבור groupId: התהליך של collabmigrationtestGRP_engg ביטול הגירת מכשיר הושלם בהצלחה