כלי הגירה למעבר מ-BroadWorks, מ-Webex עבור BroadWorks ופתרונות BroadCloud ל-Wholesale RTM

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

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

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

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

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

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

• מק: JAVA_HOME="/Users/cisco/jdk/zulu@1.8.282/Contents/Home/"

• Windows: JAVA_HOME=C:\ a 1\Java\jre1.8.0_321

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

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

Windows:

token_generator.bat

מקינטוש:

./token_generator.ש

פלט:

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

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

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

איור 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> get clientPort = 2208 clientPortEnabled = true secureClientPort = 2209 secureClientPortEnabled = true systemDomain = <> 

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

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

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

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

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

AS_CLI/Applications/OpenClientServer/OCIProxy> קבל מופעל = 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> קבל תיאור כתובת ======================== 127.0.0.1 מקומי כ- 

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

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

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

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

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

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

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

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

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

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

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

AS_CLI> cd SubscriberMgmt/NumberActivation

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

AS_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:

   ServiceProviderID-A:      - GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B:                        - הכל 

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

   מזהה _משתמש_BROADWORKS = admin BROADWORKS_ = admin BROADWORKS_HOST_NAME = LOCALHOST REFRESH _TOKEN = Partner administrator’s refresh token copy from the Token Generator tool. מצב_הגירה = ערכים נתמכים הם webex_for_broadworks_to_wholesale. ערך ברירת המחדל הוא broadworks_to_wholesale. השתמש webex_for_broadworks_to_wholesale בהגירת Webex עבור BroadWorks. 

   מאפיין 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:

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

פלט

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

ls –ltr drwxr-xr-x 2 bwadmin bwadmin 4096 Oct  4 11:53 lib/ -rwxr-xr-x 1 bwadmin bwadmin 956719 אוק  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 אוק  5 05:04 conf/ drwxrwxr-x 3 bwadmin bwadmin 4096 Oct 17 22:34 פלט/ drwxrwxr-x 2 bwadmin bwadmin 4096 Oct 17 22:34 יומני רישום/ -rw-rw-r-- 1 bwadmin bwadmin 46341 Oct 17 22:35 extracted_data_1666060500618.zip 

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

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

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

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

   רענן _TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj שם_של_מיקום_MAIN=ראשי 

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

   ID_=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

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

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

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

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

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

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

Windows

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

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

macOS

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

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

   python3 -m venv venv מקור venv / bin / הפעל פייתון3 -m pip התקנת בקשות פייתון3 -m pip התקנת בקשות-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 

דוח חריג

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

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

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

פלט

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

{ "customer": { "provisioningId": "!!!!!!!!!!REPLACE_עם_PROVISIONINGID!!!!!!!!!!", "חבילות": [ "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+ eringgroup1@gmail.com" }, "provisioningParameters": { "calling": { "location": { "name": "Main", "address": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "Gaithersburg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "country": "US" }, "אזור זמן": "אמריקה/new_יורק", "שפה": "en_us", "מספרים": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+15205551108", "+15205551109", "+15205551110"], "mainNumber": "+15205551101" } } } , "broadworks_info": {"service_provider_id": "collabmigrationtestSP"_engg", "group_id": "collabmigrationtestGRP"_engg" }, "מנויים": [ { "amareswaranvel+ injack@gmail.com": { "subscriber": { "customerId": "!!!!!!!!!!REPLACE_עם_CUSTOMERID!!!!!!!!!!", "דואר אלקטרוני": "amareswaranvel+ injack@gmail.com", "חבילה": "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": נכון, "ברכה": "ברירת מחדל", "מספרOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering17861@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_עם_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": נכון, "ברכה": "ברירת מחדל", "מספרOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering16821@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_עם_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": נכון, "ברכה": "ברירת מחדל", "מספרOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": " eringmacpc@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": נכון, "ברכה": "ברירת מחדל", "מספרOfRings": 3 }, "messageStorage": { "mwiEnabled": true, "storageType": "EXTERNAL", "externalEmail": "engineering 11@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_עם_PERSONID!!!!!!!!!!", "מוצר": "DMS Cisco 8811", "מק": "F  B204E  66" } ] } } ], "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 Device Profile"], "connect_client_to_upgrade_to_webex_app": [], "מיקומים": [],"webex_for_broadworks_info": { "users": [ { "id": "Y2lzY zcGFyazovL3VzL1NVQlCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ], "hydra_orgמזהה": "Y2lzY zcGFyazovL3VzL  SR0FOSVpBVEl9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id": "Y2lzY zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } } 

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

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

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

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

     ID_WHOLESALE_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 רענן_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

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

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 OS:

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

macOS

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

כדי להקצות לקוח יחיד: ./transform.sh -input= כדי להקצות לקוחות מרובים: ./transform.sh -input= 

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

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

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

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

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

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

יומני מסוף

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

שם הכלי: גרסת כלי הקצאה: 1.15.0 ********** התחיל לעבד קובץ: input/customer.json **************** הקצאת לקוח ממתין עבור לקוח external_id_engg_grp1 כדי להשלים הקצאה... ממתין ללקוח external_id_engg_grp1 כדי להשלים את ההקצאה...   סטטוס external_id_engg_grpלקוח 1: מספרי הקצאה משתמשים הקצאה תכונות משתמש הקצאה ברכות הקצאה לוחות זמנים הקצאת התקני הקצאה הופעות של שיחות משותפות הקצאת תורי שיחות הקצאת תורי שיחות הקצאה ********** קובץ שהושלם: קלט/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. הוא משתמש בקובץ Transform Tool JSON (customer.json) כקלט ומבצע את פקודות ה-OCI-P להעברת מכשירים ולקוחות רכים.

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

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

SCP ו-SSH

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

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

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

   רענן _TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   מזהה משתמש_BROADWORKS _PASSWORD = ADMIN BROADWORKS_ = admin BROADWORKS_NAME_ = localhost 

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

   JAVA_HOME=/usr/local/java/java_base

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

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

כדי להעביר טלפוני 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. לאחר בקשת האתחול, טלפונים של פוליקום מורידים ומעבדים% BWMACADDRESS%.cfg, אשר מבקש מטלפונים של פוליקום להוריד 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 For device move multiple customers: ./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json בנוסף, כלי העברת המכשיר תומך בהגירה של טלפון יחיד/ספציפי ממהדורה 1.35.0. השתמש בפקודה הבאה: ./devicemove.sh -integration -input=  -macaddress=4CBC48 A6F8,48256741CBE9 

יומני מסוף

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

שם הכלי: גרסת כלי העברת מכשיר: 1.15.0 כלי מכשיר התחיל... מכשירים חוקיים להגירה: ------------------------------------------------------------------------------------------------------------------- | סוג מכשיר | מקName | גרסה | "דוא"ל" | ------------------------------------------------------------------------------------------------------------------- | DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914 eai7_ | אמארתבל+ injack@gmail.com | | DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486 bcae7e45_ | דוא"ל: info@gmail.com | | DMS Cisco 8811 | F  B204E  66 | Cisco-CP-8811-3PCC/11.3.7_f87-4e 66_ | אמאראנבל + owenalex@gmail.com | ------------------------------------------------------------------------------------------------------------------- האם ברצונך לבצע הגירה של כל המכשירים האלה? ([Y]ES או [N]O) כן העלאת פרופילי מכשיר עבור DMS Cisco MPP LC בנייה מחדש של תהליך המכשיר החל לבנות מחדש תהליך אתחול בהצלחה תהליך אתחול החל תהליך אתחול מחדש הושלם בהצלחה שינוי פרופילים עבור תקשורת עסקית תחת קבוצה collabmigrationtestGRP_engg הפעל את תהליך מספרי טלפון של webex החל עבור מזהה ארגון לקוח: 85ea1d6f-ff9e-41a1-843f-73 aaf12b4c הפעלת תהליך מספרי טלפון של webex שהושלם עבור מזהה ארגון לקוח: 85ea1d6f-ff9e-41a1-843f-73 aaf12b4c השבת תהליך מספרי טלפון של Broadworks החל עבור groupId: collabmigrationtestGRP_engg השבת את תהליך מספרי הטלפון של broadworks שהושלם עבור groupId: הגירת מכשיר collabmigrationtestGRP_engg הושלמה 

פלט

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

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

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

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

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

עבור BroadCloud Carrier

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

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

עבור 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 דרך פורטל Control Hub.
5. מנהלי מערכת של שותף חייבים להעביר מספרי טלפון PSTN בחזרה ל-Cisco BroadWorks.

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

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

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

שיחזור פרופילים

./devicemove.sh -input=  -revertProfiles

חזור מספרים

./devicemove.sh -input=  -revertNumbers

יומני מסוף

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

שיחזור פרופילים

שם הכלי: גרסת כלי העברת מכשיר: 1.15.0 כלי מכשיר התחיל עבור תהליך שחזור... מכשירים שניתן להעביר בחזרה מ-Webex Calling ל-BroadWorks: - ------------------------------------------------------------------------------------------------------------------- | סוג מכשיר | מקName | גרסה | "דוא"ל" | ------------------------------------------------------------------------------------------------------------------- | DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914 eai7_ | אמארתבל+ injack@gmail.com | | DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486 bcae7e45_ | דוא"ל: info@gmail.com | | DMS Cisco 8811 | F  B204E  66 | Cisco-CP-8811-3PCC/11.3.7_f87-4e 66_ | אמאראנבל + owenalex@gmail.com | ------------------------------------------------------------------------------------------------------------------- האם ברצונך להעביר בחזרה מכשירים אלה מ-Webex Calling ל-BroadWorks? (כן, י, לא, נ):  כן העלאת פרופילי מכשיר עבור DMS Cisco MPP LC בנייה מחדש של תהליך המכשיר התחיל בנייה מחדש של תהליך המכשיר הושלם בהצלחה תהליך אתחול מחדש התחיל תהליך אתחול מחדש הושלם בהצלחה הגירת מכשיר הושלמה עבור תהליך חיסור 

חזור מספרים

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