תודה על המשוב.

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

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

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

תנאים מוקדמים

התקן את Java 8, 11, 17 או 21 במחשב. Java זמינה ממקורות רבים, כולל:

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

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

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

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

חלונות:

token_generator.bat

מקאוס:

./token_generator.sh

פלט:

Tool Name: Token Generator Tool
Version: 1.13.0
Load the URL in your web browser: http://localhost:8080

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

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

איור 3: התחבר עם Cisco Webex

איור 4: חלון אישורים

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

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

אפשר קישוריות OCI-P

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

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

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

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

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

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

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

שלב 2: השתמש ב- CLI כדי להגדיר את פרוקסי OCI.

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

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

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

AS_CLI/Applications/OpenClientServer/OCIProxy> get
enabled = true
enabledLoginLevelScreening = false
enableResponseCaching = false
responseCacheDurationHours = 24
responseCacheRenewPeriodMins = 30
messageQueueCapacity = 50
messageQueueTimeoutSeconds = 1800

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

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

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

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

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

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> get
Address Description
========================
127.0.0.1 local as

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

 AS_CLI/Maintenance/ManagedObjects> get broadworks and check
that your output looks OK.
See below for sample output:
AS_CLI/Maintenance/ManagedObjects> get broadworks
BroadWorks Managed Objects
==========================
* Server:
Identity..............: AS
Version...............: Rel_21.sp1_1.551
Administrative State..: Unlocked
* Applications:
Name Version Deployed Administrative State Effective State
=========================================================================================
ExecutionAndProvisioning 21.sp1_1.551 true Unlocked Unlocked
FlashPolicy 21.sp1_1.551 false Unlocked Stopped
OpenClientServer 21.sp1_1.551 true Unlocked Unlocked
WebContainer 21.sp1_1.551 true Unlocked Unlocked
4 entries found.
* Hosted Applications:
Name Version Context Path Deployed
==================================================================
CommPilot 21.sp1_1.551 / true
DeviceManagementFiles 21.sp1_1.551 /DeviceManagement true
JWSFiles 21.sp1_1.551 /FileRepos true
MediaFiles 21.sp1_1.551 /media true
OCIFiles 21.sp1_1.551 /ocifiles true
5 entries found.

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

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

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

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

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

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

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

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

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

AS_CLI> cd SubscriberMgmt/NumberActivation

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

AS_CLI> set dnMode groupAndUserActivationEnabled

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

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

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

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

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

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

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

בקשת תמצית CSV

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

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

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

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

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

3. העלה והגשה

   לאחר העריכה, העלה את ה- CSV שהשתנה.

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

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

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

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

   הורד את locations.csv המתאים מהכר טיסייה הצג לקוחות → אתרים → יי צוא מי קומים כ- CSV.

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

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

3. העלה והגשה

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

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

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

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

עבור סיסקו ברודוורקס ו- Webex עבור ברודוורקס

1. כלי החילוץ פועל בשרת היישומים המשני של Cisco BroadWorks ברשת השו תפים ומתחבר דרך OCI-P.
2. הכלי מושך נתונים גולמיים של ארגונים, קבוצות, מספרים, משתמשים, שירותים, מכשירים ולקו חות רכים מפלטפורמת Cisco BroadWorks או BroadCloud ומוציא נתונים אלה לקבצי XML המספקים את התשומות לכלי הטרנספורמציה.

הסעיפים הבאים מסבירים כיצד להתקין ולהגדיר את כלי החילוץ.

תנאים מוקדמים

1. SCP כלי החילוץ הבינאריים לשרת היישומים המשני של סיסקו 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_ .zip<timestamp>) זמין באותה ספריית כלי חילוץ. השתמש בפקודה הבאה כדי להציג ולהשתמש בקובץ ZIP עבור הקלט של כלי שינוי צורה:

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

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

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

1. פתח את הקובץ export.sh.
2. אתר את המשתנה HTTPS_PROXY_HOST ובטל את ההערה שלו (הסר את # המוביל).

3. הגדר את הערך HTTPS_PROXY_HOST כ:

   HTTPS_PROXY_HOST=<proxy-host>

4. אתר את המשתנה HTTPS_PROXY_PORT ובטל את ההערה שלו (הסר את # המוביל).
5. הגדר את הערך HTTPS_PROXY_PORT כ:

   HTTPS_PROXY_PORT=<proxy-port>

6. שמור וסגור את הקובץ export.sh.
7. פתח את הקובץ partner.cfg והוסף את הטוקן_רענון הנדרש.
8. ודא שהמארח, שם המשתמש והסיסמה של BroadWorks מוגדרים כהלכה ב- partner.cfg.
9. הפעל את הסקריפט:

   ./export.sh

טופס אירוסין:

כלי החילוץ (BroadCloud ו- BroadWorks) מייצר כעת באופן אוטומטי קובץ XLSX מאוחד שכותרתו טו פס מעורבות SUA.xlsx במהלך הביצוע. הקובץ מאוכלס מראש בכל הנתונים הזמ ינים בגיליונות עבודה רלוונטיים, מה שעוזר לייעל ולהאיץ את השלמת השו תפים.

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

תנאים מוקדמים

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

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

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

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   כדי לקבל אימות מלא יותר של כתובת הדואר האלקטרוני של הלקוח, באפשרותך להגדיר את PROVISIONING_ID.
3. הגדר מידע חסר בקובץ input/customers.csv (ראה סעיף הבא) אם חסר.
4. הוסף את כתובת הדוא"ל של משתמש הקצה בקובץ input/users.csv.
5. אם יש לספק טלפונים חדשים, הוסף את כתובת ה- mac וכתובת הדוא"ל של הטלפון החדש של המשתמש לקובץ input/newphones.csv. פעולה זו נדרשת רק אם מנהלי המערכת השותפים רוצים לספק טלפונים חדשים בשיחות סיטונאיות.
6. המר את מוקדי הטלפונים של BroadWorks ל- CXEssentials באמצעות הקובץ input/cxessentials.csv.
7. לחלופין, אפשר את המאפיין UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS כדי להמיר את כל מוקדי הטלפונים ל-CXEssentials.
8. השתמש בקובץ input/locations.csv כדי לתמוך בהעברה ארגונית גדולה המאפשרת למנהלי מערכת להעביר את מיקומי הלקוחות שלהם לפי מיקום
9. לחלופין, אפשר שימוש בכתובות MAC מהכותרת User-Agent של הודעת SIP REG ISTER כאשר כתובת ה- MAC אינה זמינה בפרופיל ההתקן של Cisco BroadWorks . בטל את ההערה של השורה USE_MAC_ADDRESS_FROM_SIP_REGISTER=כן בקובץ conf/partner.cfg
10. אפשר באופן אופציונלי את המאפיינים ANALOG_USER_TYPE_ENABLE_CALL_WAITING, ANALOG_USER_TYPE_ENABLE_ MUSIC_ON_HOLD ו- ANALOG_USER_TYPE_DISABLE_T38 כדי להגדיר את ההמתנה לשיחה, מוסיקה בהמתנה ולהשבית הגדרות T38 עבור כל המשתמשים מסוג אנלוגי.

11. אם ברצונך להגדיר התקני שער גנריים, הוסף את כתובת ה- MAC ומזהה המשתמש של המכשיר לקובץ input/genericgateways.csv. כמו כן, ציין אם המשתמש הוא הבעלים הראשי או משתמש משותף (עבור הופעות שיחות משותפות). זה נחוץ רק אם מנהלי השותפים מתכננים להשתמש במכשירי שער גנריים בשיחות סי טונאיות.

    תכונה זו אינה זמינה עבור העברות BroadCloud לסיטונאות .

12. עבור העברות BroadCloud, כדי להמיר את כל המשתמשים עם סוג תחנת ההודעות ל- voice_mail_group, עדכן את הקובץ conf/rialto_station_type_to_wholesale_package.csv על-ידי החלפת ערך הח בילה הסיטונ אית ב- voice_mail_group עבור השורה שבה סוג תחנת ריאלטו שולח הודעה.

    לחלופין, הפעל את המאפיין COMMON_VOICE_MAIL_GROUP_PASSCODE ב- partner.cfg כדי להגדיר את קוד ה- PIN המוגדר כברירת מח דל לקבוצות דואר קולי.

    אם מאפיין זה לא צוין ב- partner.cfg, יש לספק אותו לכל לקוח בקובץ customers.csv תחת העמודה CommonVoicEmailGroupPassCode.

13. להגירה של אנשי קשר משותפים אל Webex Calling

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

    תצורת מפתח:

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      מאפיין חדש , COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE, מוצג בקו בץ partner.cfg. מאפיין זה קובע כיצד מעבירים אנשי קשר נפוצים מ- Rialto ל Webex Calling -.

    • ללא הגדרת רשימת טלפונים משותפת לתוקף_סיומת_וירטואלי_התחלת_טווח

      אנשי קשר נפוצים יועברו כ אנשי קשר בארגון (אנשי קשר בארגון).

      אין צורך בתצורה נוספת.

      אנשי הקשר נשארים נגישים בר מת הארגון.

    • עם הגדרת COMMON_PHONE_LIST_TO_EXTENSION_VIRTUAL_EXTENSION_START_RANGE

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

      לכל איש קשר יצורף מספר סיומת, וטווח ההתחלה של התוסף מו גדר במאפיין COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE ב- partner.cfg.

      הרחבות וירטואליות נתמכות הן ברמת הארגון והן ברמת המיקום, בהתאם להיקף איש הקשר.

14. הפעל ספק הקלטת שיחות ברירת מחדל ל- Webex.

    שלב זה נדרש רק בעת העברת הגדרות הקלטת שיחות עבור משתמשים שהוגדרו עם Dubber להקלטת שיחות מק וריות של Cisco ב- Webex.

    כדי להפעיל אפשרות זו:

    • בקובץ partner.cfg, הגדר את המאפיין הבא, Default _CALL_RECORDING_VENDOR=WebEx.
    • בנוסף, השתמש במאפיין WEBEX_CALL_RECORDING_STORAGE_REGION כדי להגדיר את אזור האחסון.

      אפשרות ההקלטה לפי דרי שה מ- BroadCloud אינה נתמכת ב Webex Calling -. הגדרות הקלטת שיחות אלה לא יעברו ויו פיעו בדוח החריג.

15. אי הכללה של מספרי טלפון נבחרים מההעברה:

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

    • תחילה בצע את כלי הטרנספורמציה בפעם הראשונה. עם השלמתו, הכלי ייצור קובץ בשם telephone_numbers_inventory.csv, הממוקם בתוך ספריית הפלט /timestamp/. הלקוח נדרש לעיין בקו בץ זה ולציין "כן" בעמודה "Drop Tn's" עבור כל מספר טלפון שיש להוציא מההעברה הקרובה.
    • לאחר עדכון הקובץ telephone_numbers_inventory.csv עם דגלי ההדרה המתאימים, כלי הטרנספורמציה מבוצע בפעם השנייה. יש להעביר את הקובץ המעודכן כארגומנט בפורמט הבא.

      . /transform.sh -חילוץ=קלט/נתונים_חולצים_1747640608219.zip -מספרי ביטול = {filepath/telephone_numbers_inventory.csv}

16. לחלופין, הגדר את המאפיין ALLOW_RESTRICT_BY_PARTNER_MODE כבוי כדי לאפשר למנהלי לקוחות לשנות הגדרות שהוגדרו על-ידי שותף במרכז הב קרה.
17. להעברת מספרים ניידים (BroadWorks ניידות) מברודקלאוד ל Webex Calling

    סעיף זה מתאר את ההעברה של תכ ונת BroadWorks Mobility (מספרי סלולרי של לקוחות) מ- BroadCloud (שילוב רשת סלולרית) לסי טונאות Webex Calling (מפעיל הרשת הסלולרית Webex Go ).

    דרישות מוק דמות - לפני תחילת תהליך ה העברה, מנהלי מערכת שותפים חייבים לפנות ל צוות חשבון Cisco כדי לבצע את תצורת ספק PSTN המחובר לענן (CCP) ורשימת הספק המותאמת אישית (CCL).

    מאפיין חדש, ASSIGN_MOBILE_NUMBERS_TO_USERS, מתווסף לקובץ partner.cfg. הפעל מאפיין זה כדי לאפשר הקצאה והעברה של מספרים ניידים למשתמשים.

    • תכונה זו נתמכת רק עבור העברות Broadcloud לסיטונאות.
    • ב- Webex Wholesale, למשתמשי קצה יכולים להיות מספר נייד או מספר PSTN (לא שניהם), שלא כמו ב- BroadCloud.
    • כאשר מספר נייד מוקצה למשתמש, מספר ה- PSTN הראשי שלו הופך למספר המשני (החלופי) שלו.
    • לא ניתן להעביר מספרים ניידים עבור משתמשים המו מרים למרחבי עבודה או קווים וירטואליים.
    • לאחר הקצאת מספר נייד ב- Webex Wholesale, הוא יופיע כפעיל במרכז הבקרה. מצב זה אינו אומר שהמספר מוכן מיד לקבל שיחות. יכולת השיחה תהיה זמינה רק לאחר השלמת ההעברה במלו אה.
    • הגדרות שילוב טלפון נייד שהוגדרו על ידי משתמשי קצה בפורטל המשתמש המתקשר (CUP) אינן מועברות. לאחר ההעברה, כאשר מתקשרים למספר טלפון, מספר נייד או סיו מת, כל המכשירים של המשתמש יצלצלו.

18. כדי להגדיר באופן אופציונלי מגבלות כמות חבילות במהלך העברת הלקוח, ציין את הכמות עבור כל חבילה בקובץ input/package_quantity.csv. כמות החבילה המוגדרת חייבת להיות גדולה או שווה למספר החבילות שהוקצו למשתמש /סביבת עבודה.

    מגבלות כמות חבילות אינן נתמכות כרגע עבור העברות Webex עבור BroadWorks לסיטונאות.

    בעת הפעלת כלי הטרנספורמציה, ספק את הקובץ המעודכן כ פרמטר קלט:. <extract_zip_file>/transform.sh -חלץ = -חבילות חבילות = קלט/כמות חבילה.csv.

19. העבר אתרים מלקוחות מרובים מ- Broadworks/Broadcloud ללקוח יחיד בסיטונאות Webex Calling
    • מצב ריצה חדש, -ConsolidatedMigration, מוצג בכלי Transform כדי לתמוך בהעברת אתרי לקוחות מרובים מ- Broadcloud/Broadworks לפלטפורמת Webex Wholesale תחת ארגון לקוחות סיטונאי יחיד. כאשר מצב זה מופעל, הכלי מאחד אתרי לקוחות מרובים לארגון לקוחות סיטונאי אחד

      -consolidatedMigration

    • ישנם ארגומנטים אופציונליים אחרים שניתן לתת יחד עם -ConsolidatedMigration כגון

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

    • אם ניתן -targetEnterpriseID והמזהה קיים בקובץ הפלט של כלי החילוץ, הוא ישמש ליצירת ארגון הלקוחות הסיטונאי ואם לא נמצא מזהה, הכלי יח זור להשתמש בכל פרטי הלקוח הזמינים מקובץ הפלט של כלי החילוץ.
    • אם ניתן -ConsolidateDexternalId הוא יגדיר את ExternalID עבור הלקוח ואם הוא לא ניתן, הכלי יחזור להשתמש בזרימה קיימת עבור מזהה חיצוני.
    • <timestamp>קובץ JSON מאוחד (customer.json) יהיה זמין בספריית הפלט /המאוחד.

מילוי ה- input/customers.csv

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

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

מילוי ה- input/users.csv

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

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

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

חלונות

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

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

מקאוס

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

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

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

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

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

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

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

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

בדיקה מוקדמת

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

מידע מראש

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

יומני מסוף

היומנים הבאים בטרמינל בטרנספורמציה מוצלחת:

Summary Report
BroadWorks enterprises that can be successfully migrated: 1
BroadWorks enterprises that cannot be migrated: 0
BroadWorks users that can be successfully migrated: 4
BroadWorks users that cannot be migrated: 0
Phones that can be successfully migrated: 3
Phones that are not compatible with Webex Calling: 0

דוח חריגה

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

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

Exception Report
Tue Oct 18 08:12:09 2022

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

פלט

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

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

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

תנאים מוקדמים

הגדר את התנאים המוקדמים הבאים בתוך ספריית כלי הקצאה:

1. התקן את Java 8, 11, 17 או 21 במחשב. Java זמינה ממקורות רבים, כולל:
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. לאחר הורדה וחילוץ של הקבצים הבינאריים של כלי ההעברה, הגדר את משתנה הסביבה JAVA_HOME ב- provisioning_tool.sh עבור MAC ו- provisioning_tool.bat עבור Windows.
3. הקובץ partner.cfg:
   • הגדר את WHOLESALE_PROVISIONING_ID ו- REFRESH_TOKEN (אסימון שהועתק מכלי מחולל האסימונים). על מנהלי המערכת השותפים ליצור קשר עם צוות החשבון שלהם כדי לקבל את PROVISIONING_ID:

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • הגדר את SEND_SUBSCRIBERS_WELCOME_EMAIL ל- false, אם השותפים לא רוצים לשלוח דוא"ל קבלת פנים למשתמשים. ערך ברירת המחדל הוא true.

     Webex שולח הודעות דוא"ל קבלת פנים רק למשתמשי קצה. מנהלי לקוחות אינם מקבלים הודעות דוא"ל לקבלת פנים.

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

4. השתמש במאפיין WEBEX4BWKS_EMAIL_SUBJECT עבור העברות Webex עבור BroadWorks כדי לשלוח את נושא הדואר האלקטרוני של בקשת שינוי סיסמה עבור מנויי Webex עבור BroadWorks.
5. השתמש במאפיין WEBEX4BWKS_EMAIL_BODY עבור העברות Webex עבור BroadWorks כדי לשלוח את גוף הדואר האלקטרוני של בקשת שינוי סיסמה עבור מנויי Webex עבור BroadWorks.
6. השתמש במאפיין CUSTOM_TAG S כדי להוסיף תגים לאחר יצירת הלקוח.
7. כדי לה חיל הנחות סיטונ איות, על מנהלי השותפים ליצור קשר עם צוות החשבון של Cisco לפני שתתחיל בהעברה.

   נכס חדש, APPLY_WHOLESALE_DISCOUNTS מתווסף ל- partner.cfg. הפעל מאפיין זה כדי להחיל הנחות על משתמשים וסבי בות עבודה.

8. (אופציונלי) הגדר במפורש את חיבור ה- PSTN

   כדי לציין את חיבור PSTN עבור כל המיקומים שהוצגו במהלך ההעברה, כולל המיקום הראשי, הוסף את המאפיין הבא לקובץ partner.cfg:

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

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

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

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

חלונות

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

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

מקאוס

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

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

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

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

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

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

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

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

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

יומני מסוף

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

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

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

פלט

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

המערכת תיצור קובץ Provisioning_Report_*.csv בספריית הפולט/מאוגדת_דוחות/. קובץ זה מכיל פרטי הצלחה וכישלון עבור כל ישות והגדרות שלה, ומספק דוח אספקה מקיף.

כלי הקצאה יוצר גם קובץ Pro visioning_Statistics_*.csv בספריית הפלט /consolidated_reports/. דוח זה מכיל את הספירות של לקוחות, מיקומים, משתמשים, מכשירים ותכונות קבו צתיות שסופקו בהצלחה ובלי הצלחה.

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

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

איור 9: רכזת בקרה

איור 10: התקנים

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

הגבלות לאחר הקצאה

לאחר השלמת הקצאת ההעברה של BroadCloud, הפעולות הבאות ייחסמו:

• פורטל CAP - הוספת משתמשים או מכשירים מועברים.
• SP Portal - יצירת הזמנות ADD עם מכשירים או מספרים.
• RSB API - יצירת הזמנות ADD עם מכשירים או מספרים ויצירת משתמשים. הזמנות RSB ADD שבוצעו עם מכשירים או מספרים יידחו.

העברת BroadCloud לסיטונאי - הגבלת רישום מכשירים

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

מגבלה זו אינה חלה על:

• לקוחות המעברים מ- Broadworks/W4b לסיטונאות.
• העברות BroadCloud לסיטונאות באזורים שונים.

הדרכה מומלצת

כדי להימנע מבעיות ברישום מכשירים, השלם את העברת העברת ההתקנים ברמת המיקום לפני שתנסה לרשום מכשירים לפלטפורמת Webex עבור העברות BroadCloud ל-Wholesale באותו אזור.

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

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

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

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

קיי מות שתי אפשרויות לבחירת סוג ההעברה בפורטל:

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

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

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

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

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

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

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

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

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

כאשר אתה משתמש באותו תא מטען SIP עבור Webex Calling חברת BroadCloud Carrier, מנהלי מערכת צריכים להשתמש באפשרות 'ניתו ק מספרים'. פעולה זו מסירה מספרי טלפון מקבלת שיחות נכנסות לאחר ההעברה ב- BroadCloud.

כדי להפעיל אפשרות זו,

1. בקובץ partner.cfg, הגדר DISCONNECT_NUMBERS_FROM_RIALTO = כן.
2. הפעל מחדש את כלי ההעברה באמצעות אותו קובץ customer.json ו- partner.cfg המעודכן.

אם המספרים לא מצליחים להתנתק, העלה בקשת סיסקו TAC.

עבור סיסקו ברודוורקס ו- Webex עבור ברודוורקס

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

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

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

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

   נוהל תצורה

   1. פתח את הקובץ devicemove.sh.
   2. אתר את המשתנה PROXY_HOST ובטל את ההערה שלו (הסר את המספר המוביל עבור devicemove.sh).

   3. הגדר את הערך PROXY_HOST כ:

      PROXY_HOST=<proxy-host>

   4. אתר את המשתנה PROXY_PORT ובטל את ההערה שלו (הסר את המספר המוביל עבור devicemove.sh).

   5. הגדר את ערך PROXY_PORT כ:

      PROXY_PORT=<proxy-port>

   6. אנא אתר את המשתנה PROXY_SCHEME ובטל את ההערה שלו (הסר את המספר המוביל עבור devicemove.sh). שלב זה הוא אופציונלי; אם הוא נשאר בהערה, ערך ברירת המחדל עבור PROXY_SCHEME יהיה HTTP.

   7. הגדר את הערך PROXY_SCHEME כ:

      PROXY_SCHEME=<proxy-scheme>

   8. שמור וסגור את הקובץ devicemove.sh.
   9. פתח את הקובץ partner.cfg והוסף את הטוקן_רענון הנדרש.
   10. ודא שהמארח, שם המשתמש והסיסמה של BroadWorks מוגדרים כהלכה ב- partner.cfg

   11. הפעל את הסקריפט:

       ./devicemove.sh

SCP ו- SSH

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

תנאים מוקדמים

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

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

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

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

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

   JAVA_HOME=/usr/local/java/java_base

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

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

כדי להעביר טלפונים של Polycom מ- Cisco BroadWorks לשיחות סי טונאיות, מנהל שותף חייב ליצור קובץ סוג זהות/התקן חדש ברמת המערכת ב- Cisco BroadWorks לכל תבנית מכשיר Polycom. עיין באיור 14 והעלה את הקובץ המותאם אישית Device-Move-Tool/Conf/DeviceProfile/ {region} /polycom_vvx.cfg. לאחר העלאת קובץ ההתקן החדש, ודא שהקובץ החדש שנוצר קיים ברמת הקבוצה. כמו כן, ודא שהעברת הקובץ_%BWMAC Address%.cfg אינה מתנגשת עם כל קובץ קיים במערכת שלך).

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

תהליך ההעברה לטלפונים של Polycom:

1. הכלי להעברת ההתקן מחליף את הקובץ %BWMACAddress%.cfg ברמת ההתקן ב- polycom_vvx2.cfg. קובץ זה מתייחס להעברה_%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 עבור אזור ארה"ב, לאזורים אחרים יש כתובות אתרים שונות.
5. הטלפון של פוליקום מוריד את %BWMACAddress%.cfg מ- https://plcm.sipflash.com והוא ינוהל על ידי ה- DMS. Webex Calling

איור 14: הוספת קובץ סוג פרופיל זהות/התקן

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

ישנן שתי שיטות להפעיל את ה- DMT, הראשונה היא להפעיל באמצעות לקוח בודד בכל פעם והשנייה היא לרוץ דרך לקוחות מרובים בו זמנית.

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

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

יומני מסוף

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

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

פלט

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

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

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

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

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

שלבים להגדרת תצורה והפעלה של סקריפט Devicemove

1. פתח את הקובץ devicemove.sh.
2. אתר את המשתנה HTTPS_PROXY_HOST ובטל את ההערה שלו (הסר את # המוביל).

3. הגדר את הערך HTTPS_PROXY_HOST כ:

   HTTPS_PROXY_HOST=<proxy-host>

4. אתר את המשתנה HTTPS_PROXY_PORT ובטל את ההערה שלו (הסר את # המוביל).
5. הגדר את הערך HTTPS_PROXY_PORT כ:

   HTTPS_PROXY_PORT=<proxy-port>

6. שמור וסגור את הקובץ devicemove.sh.
7. פתח את הקובץ partner.cfg והוסף את הטוקן_רענון הנדרש.
8. ודא שהמארח, שם המשתמש והסיסמה של BroadWorks מוגדרים כהלכה ב- partner.cfg.
9. הפעל את הסקריפט:

   ./devicemove.sh

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

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

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

עבור סיסקו ברודוורקס ו- Webex עבור ברודוורקס

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

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

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

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

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

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

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -revertProfiles

החזר מספרים

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -revertNumbers

יומני מסוף

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

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

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

החזר מספרים

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