用於從 BroadWorks、 Webex for BroadWorks 和 BroadCloud 轉換為批發 RTM 解決方案的移轉工具

佈建工具將自動建立支援的電話，並指定給Webex Calling中的使用者。當裝置移動工具執行時，在「裝置移動工具支援」欄中標有「是」的電話也會從Cisco BroadWorks 或 BroadCloud 自動移至Webex Calling 。在該欄中標有「否」的電話需要手動干預才能變更Cisco BroadWorks 裝置範本或電話本身中的 DMS URL 。

最後一欄提供電話機型與檔案轉換工具/輸入/newphones.csv 中「裝置類型」欄的對映。（請參閱轉換工具 如需newphones.csv的相關資訊，請參閱本文的部分）。

合作夥伴管理員在開始執行移轉工具之前，至少會執行此權杖產生器公用工具一次。執行此工具是在合作夥伴帳戶加入批發 RTM 解決方案後的一次性活動。此工具可讓合作夥伴管理員透過 Web 瀏覽器登入，以取得所需的唯一 TOKEN，以將其更新為移轉工具的合作夥伴組態檔。

先決條件

下載後，解壓縮移轉工具二進製文件。

在token_generator.sh（適用於MAC和token_generatorWindows 版 .bat。如果 JAVA_主路徑已存在，工具將重複使用。

• MAC：Java_ HOME="/Users/cisco/jdk/zulu@1.8.282/ Contents/ 主畫面/"

• Windows：Java_主目錄=C:\Program~1\ Java\jre1.8.0_ 321

執行的指示

在權杖產生器目錄中的終端中執行以下指令：

Windows：

token_generator.bat

MacOS：

./token_generator .sh

輸出：

工具名稱：權杖產生器工具版本：1.13.0 在您的 Web 瀏覽器中載入URL ：http://localhost:8080 

在終端上的 Web 瀏覽器中開啟URL ，使用合作夥伴管理員憑證登入以獲取 TOKEN，並複制相同的標記以供進一步使用。

下面提供使用者介面圖示以供參考：

圖 3：使用Cisco Webex登入

圖 4：「憑證」視窗

圖 5：權杖產生

請設定以下步驟，然後再在次要 BroadWorks 伺服器中執行擷取和裝置移動工具。

啟用 OCI-P 連線

裝置移動工具透過 OCI-P 指令與 BroadWorks 通訊，若要啟用 OCI-P 連線，請使用以下步驟：

步驟 1 ：使用 CLI 來配置一般設定。

在 CLI 中執行以下指令以變更到 一般設定目錄：

如_CLI> cd /Applications/OpenClientServer/一般設定。

在 CLI 中執行以下指令以取得目前的一般設定：

AS_CLI/Applications/OpenClientServer/GeneralSettings> 取得用戶端埠 = 2208 用戶端啟用 = 真安全用戶端埠 = 2209 安全用戶端埠啟用 = 真 systemDomain = <> 

如果您的設定與上述不相符，請使用設定 指令，以重新設定您的設定。

第 2 步：使用 CLI 來設定 OCI Proxy。

將目錄變更為 OCI Proxy：

如_CLI> cd /Applications/OpenClientServer/OCIProxy

執行以下 CLI 以取得目前設定。您應該看到以下內容：

AS_CLI/Applications/OpenClientServer/OCIProxy> 已啟用 = true 啟用的LoginLevelScreencing = 錯誤啟用回應緩存 = 錯誤的回應緩存持續時間 = 24 回應緩存RenewPeriodMins = 30 訊息佇列容量 = 50 訊息佇列TimeoutSeconds = 1800 

如果您的設定與上述不相符，請使用設定 指令，以重新設定您的設定。

第 3 步：使用 CLI 來設定 OCI 佈建。

切換到佈建目錄：

如_CLI> cd /System/NetworkAccessLists/OCI/佈建

執行以下指令以取得目前的 OCI 佈建設定：

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> 獲取地址說明 ========================== 127.0.0.1 本機為 

步驟 4 ：在 CLI 中執行以下指令，以驗證您的設定是否正確。

 如_CLI/維護/管理物件> 獲取 Broadworks 並檢查您的輸出是否確定。請參閱下方的範例輸出：如_CLI/維護/管理物件> 取得 BroadWorks BroadWorks 受管理物件 ============================= * 伺服器：身分...：AS 版本........：Rel_ 21.sp1_ 1.551 管理州/省...：未鎖定 * 應用程式：名稱 版本 部署 管理狀態 有效狀態 =============================================== =============================================== 執行和佈建 21.sp1_ 1.551 true 未鎖定 未鎖定 已鎖定 FlashPolicy 21.sp1_ 1.551 false 已解除鎖定已停止 OpenClientServer 21.sp1_ 1.551 true 未鎖定 未鎖定 WebContainer 21.sp1_ 1.551 true 未鎖定 已找到 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 找到 5 個項目。 

驗證已部署且處於活動狀態的開放式用戶端伺服器

使用下面的指令在次要應用程式伺服器上部署和啟動 Open Client Server（若未部署或尚未啟動）。

步驟 1 ：使用以下CLI 指令部署伺服器：

AS_CLI/Maintenance/ManagedObjects> 部署應用程式 OpenClientServer

第 2 步：使用此指令啟動伺服器：

AS_CLI/Maintenance/ManagedObjects> 啟動應用程式 OpenClientServer

啟用號碼啟用

在 CLI 中執行下列指令以啟用號碼的啟用：

步驟 1 ：執行號碼啟用指令：

如_CLI> cd SubscriberMGmt/NumberActivation

第 2 步：執行啟用啟用指令：

如_CLI> 設定 DNMode 群組與使用者啟動啟用

第 3 步：在確認提示時，輸入 Y。

適用於 BroadCloud

擷取工具已整合在 BroadCloud 服務提供者入口網站中。服務提供者管理員可以：

1. 每個請求最多為 50 個客戶提交資料提取請求。
   一天內為同一個客戶提交資料擷取請求的次數不能超過 10 次。
2. 以 ZIP 格式下載擷取的資料檔案，最多可使用自請求提交之日起 28 天。

下圖顯示了服務提供者入口網站。

圖 6：服務提供者入口網站

圖 7：服務提供者入口網站

適用於 BroadWorks 版Cisco BroadWorks 和Webex

1. 擷取工具在合作夥伴網路內的次要Cisco BroadWorks 應用程式伺服器上執行，並透過 OCI-P 進行連線。
2. 此工具從Cisco BroadWorks 或 BroadCloud 平台提取原始企業、群組、號碼、使用者、服務、裝置和軟體用戶端資料，並將此資料輸出為XML檔案，為轉換工具提供輸入。

接下來的章節將說明如何安裝和設定擷取工具。

先決條件

1. 將擷取工具可執行檔 SCP 傳送至次要Cisco BroadWorks 應用程式伺服器。
2. 透過 SSH 連接至次要Cisco BroadWorks 應用程式伺服器以設定先決條件並執行擷取工具。
3. 在 conf/exporttool.yml 中設定服務提供者和群組ID以從Cisco BroadWorks 擷取。請參閱以下 YAML 片段範例：

   服務提供者 ID-A：- GroupID-A1 - GroupID-A2 - GroupID-A3 Service提供者ID-B：- 所有 

4. 確保 conf/partner.cfg 檔案中的次要Cisco BroadWorks 應用程式伺服器使用者ID、密碼和主機名稱正確：

   BroadWorks_ USER_ ID = 管理員 BROADWorks_密碼 = 管理員 BROADWorks_主持人_NAME = 本地主機 REFRESH_ TOKEN = 合作夥伴管理員的重新整理權杖已復制自權杖產生器工具。移轉_MODE = 支援的值是webex_for_broadworks_to_wholesale。預設值是broadworks_to_wholesale。使用webex_for_broadworks_to_wholesale 適用於Webex for BroadWorks 移轉。 

   的重新整理_記號環 屬性對於Webex for BroadWorks 移轉是必需的。

5. 如果次要Cisco BroadWorks 應用程式伺服器 JDK/JRE 環境路徑與檔案不同，請修改 export.sh 檔案中的 JDK/JRE 環境路徑：

   Java_主目錄 = /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 匯出完成 匯出傾印 zip 目錄：輸出/20221017223452_匯出工具 匯出傾印 zip 檔案名稱：extracted_data_1666060500618.zip 名為extracted_data_1666060已建立 500618.zip ZIP 檔案建立過程已完成 匯出的檔案轉換為 ZIP 檔案 ************** *****************

輸出

輸出 ZIP（extracted_data_ .zip ) 檔案將在相同的擷取工具目錄中提供。使用下面的指令來檢視和使用「轉換工具」輸入的 ZIP 檔案：

ls –ltr Drwxr-xr-x 2 bwadmin bwadmin 4096 10 月4 月 11:53 lib/ -rwxr-xr-x 1 bwadmin bwadmin 956719 10 月4 月 11:53exporttool.jar -rwxr-xr-x 1 bwadmin bwadmin 2635 10 月4 11:53export.sh Drwxr-xr-x 2 bwadmin bwadmin 4096 10 月5 05:04 會議/drwxrwxr-x 3 bwadmin bwadmin 4096 10 月 17 22:34 輸出/drwxrwxr-x 2 bwadmin bwadmin 4096 10 月 17 22:34 記錄/-rw-rw-r- 1 bwadmin bwadmin 46341 10 月 22 日： 35extracted_data_1666060 500618.zip

此轉換工具適用於所有移轉。轉換工具可在任何電腦（包括合作夥伴的管理員膝上型電腦）上執行，並使用Webex公共 API。它會讀取擷取工具輸出 ZIP（extracted_data_ .zip ) 檔案作為輸入，並將原始XML轉換為佈建工具使用的 JSON 格式。

先決條件

下載並解壓縮遷移工具二進製文件後，請設定以下先決條件：

1. 設定 REFRESH_ TOKEN（從權杖產生工具複製的權杖）和 NAME_的_主要_conf/partner.cfg 檔案中的 LOCATION：

   重新整理_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 名稱_的_主要_LOCATION=主要

2. （可選）設定 PROVISIONING_ conf/partner.cfg 檔案中的ID （從 Partner Hub 中的範本複制）：

   正在佈建_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   若要對客戶電子郵件地址進行更完整的驗證，您可以選擇性地設定 PROVISIONING_ID。
3. 如果遺失了，請在 input/customers.csv 檔案（請參閱下一部分）中設定遺失資訊。
4. 在 input/users.csv 檔案中新增一般一般使用者電子郵件地址。
5. 如果要佈建新電話，請將使用者新電話的 Mac 位址和電子郵件地址新增至 input/newphones.csv 檔案。僅當合作夥伴管理員要在批發通話中佈建新電話時，才需要這樣做。
6. 使用 input/cxessentials.csv 檔案將 BroadWorks 通話中心轉換為 CxEssentials。
7. （可選）啟用 UPGRADE_所有_呼叫_中心_至_客戶體驗_ESSENTICALS 屬性，以將所有通話中心轉換為 CxEssentials。
8. 使用 input/locations.csv 檔案來支援允許管理員按位置移轉客戶位置的大型企業移轉
9. 當MAC 位址在Cisco BroadWorks裝置設定檔中不可用時，可以選擇性地啟用使用SIP註冊訊息的 User-Agent 標頭中的MAC位址。取消註釋「USE_ MAC_地址_FROM_ SIP_ REGISTER=yes” （在檔案 conf/partner.cfg 中）

填寫輸入/客戶.csv

檔案 input/customers.csv 提供了Cisco BroadWorks 或 BroadCloud 中可能缺少的資料。如果所有必填資訊已可用，此檔案可以保留為空。您不必填寫所有欄位，只有缺少的資訊是必填欄位。

下表說明 input/customers.csv 中最重要的欄位。

執行的指示

在任何作業系統中執行轉換工具。使用以下步驟在 Windows 和 macOS 中執行該工具：

Windows

執行以下指令以在 Windows 中執行轉換工具：

transform.bat -extract= -客戶= -使用者= -newphones=

macOS

執行下列步驟以在 macOS 上執行轉換工具：

1. 建立虛擬環境並安裝依賴項，以使用 Python 執行轉換工具：

   python3 -m venv venv 來源 venv/bin/啟動 python3 -m pip 安裝請求 python3 -m pip 安裝請求-oauthlib 

2. 執行轉換工具：

    ./transform.sh -extract= -客戶= -使用者= -newphones=

客戶/使用者預先檢查

轉換工具對Webex進行API調用以捕獲潛在的佈建問題。預設情況下，它將驗證客戶的地址和主要電子郵件。如果 PROVISIONING_ ID值是在 conf/partner.cfg 檔案中指定的，它還將驗證位置資訊。預先檢查結果將包含在例外報告中。

此外，在執行轉換工具時，還可以新增下列可選參數：

預先檢查

除了針對客戶資訊執行預檢查API之外，轉換工具還將針對訂閱者電子郵件執行預檢查API 。

預先核對資訊

預設情況下，例外報告中只會包含預檢查錯誤（即將封鎖佈建的問題）。新增此旗標也將包括成功的預檢查結果（例如，如果已存在可以自動附加的Webex組織）。

終端日誌

以下人員會在成功轉換後登入終端：

摘要報告 可成功移轉的 BroadWorks 企業：1 無法移轉的 BroadWorks 企業：可成功移轉的 0 個 BroadWorks 使用者：4 個無法移轉的 BroadWorks 使用者：0 可成功移轉的電話：3 與Webex Calling不相容的電話：0 

例外情況報告

轉換工具會在資料中心內產生例外報告：輸出/ /exception_report .txt 目錄。您可以使用此報告來識別將影響移轉的問題，並在Cisco BroadWorks 系統中進行修正。

在修改使用者資料以解決例外情況後，使用新資料重新執行「擷取和轉換工具」。例外報告檔案範例如下：

例外報告 2022 年 10 月 18 日星期二 08:12:09 具有通訊限制功能建議的企業：在 Control Hub 中手動配置外發通話計劃________________________________________________________________________________ 協作移轉測試GRP_engg 

輸出

輸出 JSON（客戶.json ) 檔案將在 中可用輸出/ / 目錄。範例客戶.json 檔案如下：

{ "customer": { "provisioningId": "!!!!!!!!!!REPLACE_有了_PROVISIONINGID!!!!!!!!!!", "packages": [ "webex_calling "， "common_area_calling " ], "externalId": "external_id_engg_grp 1", "地址": { "地址線路1": "100 主街道", "地址線路2": "", "城市": "蓋瑟斯堡", "州或省": "MD", "zip或郵遞代碼": "20877", " Country": "US" }, "customerInfo": { "name": "工程群組 - 1", "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com" }, "provisioningParameters": { "calling": { " location": { "name": "主要", "地址": { "地址線路1": "100 主街道", "地址線路2": "", "城市": "蓋瑟斯堡", "州或省": "MD", "zip或郵遞區號": "20877", "國家/地區": "US" }, "時區": "美洲/New_約克", "語言": "en_us 」，「數字」：[ 「+15201」、「+1551102」、「+1520551103」、「+15205」、「+155106」、「+15555551106」、「+155555551107」、「+151107」、「+1520551103」、「+152055511104」 ", "+15205551110" ], "mainNumber": "+15205551101" } } } }, "broadworks_info ": { "service_provider_id ": "協作遷移測試SP_engg "， "group_id ": "collabmigrationtestGRP_engg " }, "訂閱者": [ { "amareswaranvel+benjaminjack@gmail.com": { "訂閱者": { "customerId": "!!!!!!!!!!REPLACE_有了_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+benjaminjack@gmail.com", "package": "webex_calling 」，「provisioningParameters」：{ 「firstName」：「Benjamin」，「lastName」：「Jack」，「primaryPhoneNumber」：「+15205551102」，「extension」：「1102」} }，「features」：[ { "/ v1/people/{personId}/features/voicemail": { "啟用"：true, "sendBusyCalls": { "啟用": true, "greeting": "DEFAULT" }, "sendUnansweredCalls": { "啟用"：true, "greeting": "DEFAULT", "numberOfRings": 3 }, "messageStorage": { "mwi啟用": true, "storageType": "EXTERNAL", "externalEmail": "engineering17861@mailnator.com" } } } ], "裝置": [ { "cisUuid": "!!!!!!!!!!REPLACE_有了_PERSONID !!!!!!!!!!", "product": "DMS Cisco 7861", "mac": "CC98914EAAD7" } ] } }, { "amareswaranvel+lucasoliver@gmail.com": { "訂閱者" : { "customerId": "！！！！！！！！！！！！！REPLACE_有了_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+lucasoliver@gmail.com", "package": "webex_calling 」，「provisioningParameters」：{ 「firstName」：「Lucas」，「lastName」：「Oliver」，「primaryPhoneNumber」：「+15205551103」，「extension」：「1103」} }，「features」：[ { "/ v1/people/{personId}/features/voicemail": { "啟用"：true, "sendBusyCalls": { "啟用": true, "greeting": "DEFAULT" }, "sendUnansweredCalls": { "啟用"：true, "greeting": "DEFAULT", "numberOfRings": 3 }, "messageStorage": { "mwi啟用": true, "storageType": "EXTERNAL", "externalEmail": "engineering16821@mailnator.com" } } } ], "devices": [ { "cisUuid": "!!!!!!!!!!REPLACE_有了_PERSONID !!!!!!!!!!", "product": "DMS Cisco 6821", "mac": "5486BCAE7E45" } ] } }, { "amareswaranvel+leojackson@gmail.com": { "訂閱者" : { "customerId": "！！！！！！！！！！！！！REPLACE_有了_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+leojackson@gmail.com", "package": "webex_calling 」，「provisioningParameters」：{ 「firstName」：「Leo」，「lastName」：「Jackson」，「primaryPhoneNumber」：「+15205551104」，「extension」：「1104」} }，「features」：[ { "/ v1/people/{personId}/features/voicemail": { "啟用"：true, "sendBusyCalls": { "啟用": true, "greeting": "DEFAULT" }, "sendUnansweredCalls": { "啟用"：true, "greeting": "DEFAULT", "numberOfRings": 3 }, "messageStorage": { "mwi啟用": true, "storageType": "EXTERNAL", "externalEmail": "engineeringmacpc@mailnator.com" } } } ], "裝置": [] } }, { "amareswaranvel+owenaex@gmail.com": { "訂閱者" : { "customerId": "！！！！！！！！！！！！！REPLACE_有了_CUSTOMERID!!!!!!!!!!", "email": "amareswaranvel+owenaex@gmail.com", "package": "webex_calling 」，「provisioningParameters」：{ 「firstName」：「Owen」，「lastName」：「亞歷山大」，「primaryPhoneNumber」：「+15205551101」，「extension」：「1101」} }，「features」：[ { "/ v1/people/{personId}/features/voicemail": { "啟用"：true, "sendBusyCalls": { "啟用": true, "greeting": "DEFAULT" }, "sendUnansweredCalls": { "啟用"：true, "greeting": "DEFAULT", "numberOfRings": 3 }, "messageStorage": { "mwi啟用": true, "storageType": "EXTERNAL", "externalEmail": "engineering8811@mailnator.com" } } } ], "裝置": [ { "cisUuid": "!!!!!!!!!!REPLACE_有了_PERSONID !!!!!!!!!!", "product": "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」：「+1551105」，「分機」：「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 Id": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg", "hydra_customer_config_id ": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYMVk" } }

佈建工具可以在任何機器上執行，通常是合作夥伴的管理員膝上型電腦，並使用Webex公共 API。它會讀取轉換工具輸出 JSON (客戶.json ) 檔案作為輸入並佈建Webex批發 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_主環境變數的provisioning_tool.sh（適用於MAC和provisioning_toolWindows 版 .bat。
3. Partner.cfg 檔案：
   • 將 WHOLESALE_正在佈建_ID和 REFRESH_ TOKEN（從權杖產生器工具複製的權杖）。合作夥伴管理員必須聯絡其客戶團隊才能獲得 PROVISIONING_ ID：

     批發_正在佈建_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_ TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

   • 設定為允許_管理員_邀請_如果合作夥伴不想向使用者傳送歡迎電子郵件，則 EMAILS 為 false。預設值為 true。

4. 使用 WEBEX4BWKS_電子郵件_Webex for BroadWorks 移轉的 SUBJECT 屬性，以傳送Webex for BroadWorks 訂閱者的變更密碼請求電子郵件主題。
5. 使用 WEBEX4BWKS_電子郵件_Webex for BroadWorks 移轉的 BODY 屬性，用於傳送Webex for BroadWorks 訂閱者的變更密碼請求電子郵件本文。

對於 BroadCloud 移轉相同的地區：

1. 工具將跳過號碼、裝置和共用通話外觀外觀佈建。
2. 工具將建立具有分機號和臨時分機號的使用者和虛擬使用者。

對於 BroadCloud 移轉，其他地區：

1. 工具將佈建號碼、裝置和共用通話外觀外觀。
2. 工具將使用實際電話號碼和分機號建立使用者和虛擬使用者。
   所有歐洲 BroadCloud 遷移都將移轉至另一個地區。

執行的指示

使用以下步驟在 Windows 和 macOS 中執行該工具：

Windows

執行下列步驟以在 Windows 作業系統上執行該工具：

若要佈建單一客戶：Provision.bat -輸入=若要佈建多個客戶：Provision.bat -輸入= 

macOS

執行以下步驟以在 macOS 上執行該工具：

若要佈建單個客戶：./transform.sh -輸入=若要佈建多個客戶：./transform.sh -輸入= 

Webex for BroadWorks 移轉的先決條件

合作夥伴管理員必須針對 BroadWorks 共存功能更新Webex的 BroadWorks 新手上路範本。請參考下圖：

針對 BroadWorks 至批發的移轉使用Webex的額外參數執行佈建工具。

準備階段： 是預設階段，在該階段中，管理員可將 BroadWorks 使用者佈建為批發訂閱者，並繼續使用Webex for BroadWorks 使用者。

維護階段： 是第二個階段，管理員可在其中將批發授權指定給現有的Webex for BroadWorks 使用者。您必須使用參數執行佈建工具維護。

移轉後階段： 是管理員可將 BroadWorks 完全轉換為批發的最後階段。您必須使用參數執行佈建工具移轉後。

終端記錄

以下是成功佈建時終端中的記錄：

工具名稱：佈建工具版本：1.15.0 ******** 已開始處理檔案：input/customer.json ************** 佈建 客戶 等待客戶external_id_engg_grp1 以完成佈建... 等待客戶external_id_engg_grp1 以完成佈建... 客戶external_id_engg_grp1 狀態：佈建號碼 佈建使用者 佈建使用者功能 佈建問候語 佈建排程 佈建裝置 佈建共用通話外觀外觀 佈建 自動語音應答 佈建 呼叫佇列 佈建搜尋群組 佈建 群組傳呼 佈建 呼叫駐留 佈建 代接來電 佈建 語音入口網站 ********* 已完成檔案：輸入/customer.json ************** 

將列印一個表格，其中包含為每次執行建立的位置數：

輸出

佈建工具在內部生成成功和錯誤報告輸出/<external_id >/*.成功/錯誤 檔案。複查輸出的成功和錯誤記錄，以驗證成功佈建。

合作夥伴管理員可以在 Partner Hub 和 Control Hub 入口網站中驗證客戶佈建。請從 Partner Hub 和 Control Hub 入口網站中參考以下圖示：

圖 8：合作夥伴中心

圖 9：Control Hub

圖 10：裝置

圖 11：正在呼叫

適用於 BroadCloud

BroadCloud 合作夥伴，請使用服務提供者入口網站來提交號碼、裝置和 SCA 移轉的移轉請求。

在服務提供者入口網站中，一個移轉請求最多可以包括 50 個客戶。一天內最多可以提交 10 個請求。

下圖顯示了服務提供者入口網站。

圖 12：服務提供者入口網站

圖 13：服務提供者入口網站

適用於 BroadWorks 版Cisco BroadWorks 和Webex

對於適用於 BroadWorks 的Cisco BroadWorks 和Webex移轉，該工具在合作夥伴網路內的次要Cisco BroadWorks 應用程式伺服器上執行，並透過 OCI-P 連線到 AS。它使用「轉換工具」輸出 JSON (客戶.json ) 檔案作為輸入，並執行 OCI-P 指令以遷移裝置和軟體用戶端。

成功操作後，裝置移動工具將：

1. 從Cisco BroadWorks 取消註冊裝置，並在批發中註冊它們。
2. 使用 UC-One 用戶端的使用者將在首次登入時重新導向至Webex應用程式。
3. 從Cisco BroadWorks 停用電話號碼或從 BroadCloud 移除電話號碼。
4. 在批發中啟動號碼。
5. 在批發中為 BroadCloud 移轉建立共用通話外觀外觀。[此步驟僅適用於 BroadCloud 移轉]。

SCP 和 SSH

1. 將裝置移動工具 SCP 連接到次要Cisco BroadWorks 應用程式伺服器。
2. 透過 SSH 連接至次要Cisco BroadWorks 應用程式伺服器以配置先決條件並執行裝置移動工具。

先決條件

1. 設定 REFRESH_ TOKEN（從權杖產生器工具複製的權杖）（從權杖產生器工具複製）（從權杖產生器工具複製）（從權杖產生器工具複製）。

   重新整理_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. 確保次要Cisco BroadWorks 應用程式伺服器使用者ID、密碼和主機名稱在 conf/deviceMoveTool.conf 檔案中正確：

   BroadWorks_ USER_ ID = 管理員 BROADWorks_密碼 = 管理員 BROADWorks_主持人_NAME = 本地主機

3. 驗證 devicemove.sh 中的 JDK/JRE 環境路徑是否正確

   Java_主目錄 = /usr/local/java/java_base

4. 管理員可以使用輸入目錄中的locations.csv 檔案來遷移特定群組而不是企業下的所有群組。

Polycom 電話

要將 Polycom 電話從Cisco BroadWorks 移至批發通話，合作夥伴管理員必須在Cisco BroadWorks 中的系統層級建立新的身分/裝置設定檔類型檔案每個 Polycom 裝置範本。請參考圖 14 並上傳自訂檔案檔案裝置移動工具/會議/裝置設定檔/{region}/polycom_vvx .cfg 。上傳新的裝置檔案後，請確保新建立的檔案存在於群組層級。另請確保檔案migration_%BWMAC ADDRESS%.cfg 不與系統中的任何現有檔案衝突）。

供裝置移動工具在內部使用。

Polycom 電話的遷移過程：

1. 裝置移動工具取代了檔案%BWMACADDRESS%裝置層級的 .cfg，使用polycom_vvx2.cfg。請注意，此檔案是指migration_%BWMACADDRESS%.cfg。
2. 在群組層級或裝置層級重建裝置設定檔。
   在群組層級或裝置層級行事取決於檔案 system-move-tool/conf/partner.cfg 中參數 deviceLevelRebuild 的組態。
3. 裝置移動工具會要求Cisco BroadWorks 應用程式伺服器在群組層級或裝置層級重新啟動電話。
4. 收到重新啟動請求後，Polycom 電話會下載並處理% BWMACADDRESS%.cfg，要求 Polycom 電話下載並處理migration_%BWMACADDRESS%.cfg，其中將 device.prov.serverName 設定為https://plcm.sipflash.com.
   https://plcm.sipflash.com 對於美國地區，其他地區有不同的 URL。
5. Polycom 電話會下載%BWMACADDRESS%.cfg 來自https://plcm.sipflash.com 並將由Webex Calling DMS 管理。

圖 14：新增身分/裝置設定檔類型檔案

執行的指示

調用 DMT 有兩種方法，第一種是一次透過單個客戶調用，另一種是同時透過多個客戶執行。

裝置移動工具從裝置移動工具目錄內的次要Cisco BroadWorks 應用程式伺服器執行：

對於裝置移動單個客戶：./devicemove.sh -輸入= ./裝置移動.sh -輸入=/tmp/客戶名稱.json 對於多個客戶的裝置移動：./裝置移動.sh -輸入= ls -l /tmp/directoryofcustomers/ Customer1.json Customer2.json Customer3.json 此外，裝置移動工具支援從 1.35.0 版遷移單個/特定電話。使用下面的指令：./裝置移動.sh -整合 -輸入= -mac地址=4CBC4883A6F8,48256741CBE9 

終端日誌

以下是成功執行用於裝置移轉的裝置移動工具時終端中的記錄：

工具名稱：裝置移動工具版本：1.15.0 裝置工具已開始... 可移轉的有效裝置：--------------------------------------- --------------------------------------- ---------------| 裝置類型| Mac| 版本| 電子郵件| --------------------------------------- --------------------------------------- ---------------| DMS Cisco 7861| CC98914EAAD7| Cisco-CP-7861-3PCC/11.3.7_cc 98914eaad7_ | 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_f 87b204e4066_ | amareswaranvel+owenaex@gmail.com| --------------------------------------- --------------------------------------- --------------- 您要移轉所有這些裝置嗎？（[Y]es 或 [N]o）是 為 DMS 上傳裝置設定檔Cisco MPP LC 重建裝置過程已開始 重建裝置過程已成功完成 重新啟動過程已開始 重新啟動過程已成功完成 正在修改群組 CollabmigrationtestGRP 下的 Business Communications 的設定檔_engg 為客戶組織 ID 開始的啟用 Webex 電話號碼程序：85ea1d6f-ff9e-41a1-843f-7362aaf12b4c 已為客戶組織 ID 啟用 Webex 電話號碼流程：85ea1d6f-ff9e-41a1-843f-7362aaf12b4c 停用已為 groupId 啟動的 Broadworks 電話號碼流程：協作移轉測試GRP_engg 已為 groupId 停用 Broadworks 電話號碼程序：協作移轉測試GRP_engg 裝置移轉已完成

輸出

在裝置移轉後，裝置已連線並準備好撥打/接聽通話。請參閱圖 15 以查看裝置狀態的範例：

圖 15：裝置狀態

在裝置移轉後，號碼開始使用中。請參閱圖 16，以查看使用中號碼的範例：

圖 16：使用中的號碼

一次必須為一個企業執行回復作業。

適用於 BroadCloud 電訊廠商

BroadCloud 合作夥伴的回復過程如下：

1. 向Cisco TAC開立報修單以請求裝置回复。
2. 在回复模式下執行裝置移動工具：
   • 電話號碼將從Webex Calling取消指派，從而僅保留具有分機的使用者和服務。
   • Webex Calling中的電子郵件地址將恢復為臨時電子郵件地址。
   • 將從Webex Calling中刪除電話。
   • 將在 BroadCloud 中重新建立電話號碼、用作替代 ID 的電子郵件地址，以及電話。
   • 將重新啟動電話。
3. 合作夥伴管理員必須將 PSTN 電話號碼移回 BroadCloud Carrier。

適用於 BroadWorks 版Cisco BroadWorks 和Webex

Cisco BroadWorks 和Webex for BroadWorks 的回復過程如下：

1. 向Cisco TAC開立報修單以請求裝置回复。
2. 在次要 BroadWorks 應用程式伺服器上在回复模式下執行裝置移動工具，以回复裝置移轉。這會將 DMS URL重新設定為Cisco BroadWorks 中裝置設定檔的服務提供者DMS URL ，並重新啟用電話號碼。
3. Webex Calling團隊將 DMS URL重新設定為Webex Calling的裝置設定檔中的服務提供者DMS URL 。
4. 合作夥伴管理員必須透過 Control Hub 入口網站停用或刪除Webex Calling中的電話號碼。
5. 合作夥伴管理員必須將 PSTN 電話號碼移回Cisco BroadWorks。

在回复模式中執行裝置移動工具的指示

請遵循下列步驟，以回复模式執行裝置移動工具：

在裝置移動工具目錄內的次要Cisco BroadWorks 應用程式伺服器中執行以下指令：

回復設定檔

./裝置移動.sh -輸入= -revertProfiles

回复號碼

./裝置移動.sh -輸入= -revertNumbers

終端日誌

若成功執行用於回复操作的裝置移動工具，我們將在終端中取得以下記錄：

回復設定檔

工具名稱：裝置移動工具版本：1.15.0 版裝置工具已啟動以進行還原處理... 可以從Webex Calling移回 BroadWorks 的裝置：---------------------------------------------------- --------------------------------------- ----| 裝置類型| Mac| 版本| 電子郵件| --------------------------------------- --------------------------------------- ---------------| DMS Cisco 7861| CC98914EAAD7| Cisco-CP-7861-3PCC/11.3.7_cc 98914eaad7_ | 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_f 87b204e4066_ | amareswaranvel+owenaex@gmail.com| --------------------------------------- --------------------------------------- --------------- 要將這些裝置從Webex Calling移回 BroadWorks 嗎？（是，Y，否，N）：是 為 DMS 上傳裝置設定檔Cisco MPP LC 重建裝置過程已開始 重建裝置過程已成功完成重新啟動過程已開始 重新啟動過程成功完成 已成功完成裝置移轉以取消佈建過程 

回复號碼

工具名稱：裝置移動工具版本：1.15.0 要繼續將號碼回復至 Broadworks 嗎？（[Y] es 或 [N] o）：是 [+15205551102、+1520551103、+1520551103、+151104、+152055511105、+1520555551108、+15555551109、+1520555] 協作移轉測試GRP_engg 已為 groupId 啟用 Broadworks 電話號碼程序：協作移轉測試GRP_engg 裝置移轉回复程序已成功完成