預配置工具將自動創建支持的電話並將其分配給 Webex Calling 中的使用者。當設備移動工具運行時，在「設備行動工具中支援」列中標記為“是”的電話也將自動從 Cisco BroadWorks 或 BroadCloud 放在 Webex Calling。該列中標記為「否」的電話需要手動干預才能更改 Cisco BroadWorks 設備範本或電話本身中的 DMS URL。

最後一列提供手機型號到檔 transform-tool/input/newphones.csv 的 “Device type” 列的映射。（參見 有關newphones.csv）的更多資訊，請參閱本文的 Transform tool 部分。

合作夥伴管理員在開始運行遷移工具之前，至少運行一次此令牌產生器實用程式工具。運行此工具是合作夥伴帳戶加入批發 RTM 解決方案後的一次性活動。此工具允許合作夥伴管理員通過 Web 瀏覽器登錄，以獲取更新到遷移工具的合作夥伴配置檔所需的唯一 TOKEN。

先決條件

下載后，提取遷移工具二進位檔。

在 .sh 中設置 token_generatorJRE/JDK 環境路徑（適用於 MAC）和 token_generator.bat（適用於 Windows）。如果 JAVA_HOME 路徑已存在，則該工具將重用該路徑。

• MAC鍵：JAVA_HOME=“/使用者/cisco/jdk/zulu@1.8.282/Contents/Home/”

• Windows：JAVA_主目錄=C：\Progra~1\Java\jre1.8.0_321

運行說明

在終端的 token generator 目錄下運行以下命令：

Windows：

token_generator.bat

MacOS：

./token_generator.sh

輸出：

工具名稱：Token Generator Tool 版本：1.13.0 在 Web 瀏覽器中載入 URL：http://localhost:8080 

在終端的 Web 瀏覽器中開啟 URL，使用合作夥伴管理員憑證登錄以獲取 TOKEN 並複製該令牌以供進一步使用。

使用者介面插圖如下以供參考：

圖 3：使用 Cisco Webex 登錄

圖 4：Credentials （憑證） 視窗

圖 5：令牌生成

在輔助 BroadWorks 伺服器中執行提取和設備行動工具之前，請配置以下步驟。

啟用 OCI-P 連接

裝置行動工具透過 OCI-P 命令與 BroadWorks 通信，要啟用 OCI-P 連接，請使用以下步驟：

步驟1：使用 CLI 配置常規設置。

在 CLI 中執行以下命令以切換到 GeneralSettings 目錄。

作為_CLI>cd /Applications/OpenClientServer/GeneralSettings。

在 CLI 中執行以下命令以取得目前的 GeneralSettings：

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

如果您的設置與上述設置不匹配，請使用 set 命令重新設定您的設置。

步驟2：使用 CLI 配置 OCI 代理。

將目錄變更為 OCI 代理：

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 供應。

變更為 Provisioning 目錄：

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

執行以下命令以取得目前的 OCI 供應設定：

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> 獲取位址描述 ======================== 127.0.0.1 local 為 

步驟4：在 CLI 中執行以下命令以驗證您的配置是否正確。

 AS_CLI/Maintenance/ManagedObjects>獲取 broadworks 並檢查您的輸出是否正常。有關範例輸出，請參閱下文：作為_CLI/Maintenance/ManagedObjects>獲取 broadworks BroadWorks 託管物件 ========================== * 伺服器：身份。。。。。。。。。。。。。。：AS 版本...............：Rel_21.sp1_1.551 行政狀態..：已解鎖 * 應用程式：名稱 版本 已部署 行政狀態 有效狀態 ========================================================================================= ExecutionAndProvisioning 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 已部署並處於活動狀態

使用以下命令在輔助 Application Server 上部署和啟動 Open Client Server（如果尚未部署或尚未啟動）。

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

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

步驟2：使用以下命令啟動伺服器：

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

啟用號碼啟動

在 CLI 中執行以下命令以啟用號碼的啟動：

步驟1：執行 number activiation 命令：

AS_CLI>cd SubscriberMgmt/NumberActivation

步驟2：運行 activation enabled 命令：

AS_CLI>設置 dnMode groupAndUserActivationEnabled

步驟3：在確認提示符處，輸入 Y。

對於 BroadCloud

提取工具集成在 BroadCloud 服務提供者門戶中。服務提供者管理員可以：

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

下圖顯示了服務提供者門戶。

圖 6：服務提供者門戶

圖 7：服務提供者門戶

對於 Cisco BroadWorks 和 Webex for BroadWorks

1. 提取工具在合作夥伴網路內的輔助 Cisco BroadWorks 應用伺服器上運行，並通過 OCI-P 連接。
2. 該工具從 Cisco BroadWorks 或 BroadCloud 平臺提取原始企業、組、號碼、使用者、服務、設備和軟客戶端的數據，並將這些數據輸出為轉換工具提供輸入的 XML 檔。

以下部分將介紹如何安裝和配置 Extract 工具。

先決條件

1. 將提取工具二進位檔SCP 到輔助 Cisco BroadWorks Application Server。
2. 通過 SSH 連接到輔助 Cisco BroadWorks Application Server，以配置先決條件並運行提取工具。
3. 在 conf/exportTool.yml 中配置服務提供者和組 ID 以從 Cisco BroadWorks 中提取。請參閱以下範例 YAML 代碼片段：

   ServiceProviderID-A 的 ID：- 組 ID-A1 - 組 ID-A2 - 組 ID-A3 ServiceProviderID-B：-都 

4. 確保 conf/partner.cfg 檔中的輔助 Cisco BroadWorks Application Server 使用者 ID、密碼和主機名正確無誤：

   BROADWORKS_使用者_ID = 管理員 BROADWORKS_密碼 = 管理員 BROADWORKS_主機名_= localhost 刷新_令牌 = 從令牌生成器工具複製的合作夥伴管理員刷新令牌。MIGRATION_MODE = 支援的值為 webex_for_broadworks_to_wholesale。預設值為 broadworks_to_wholesale. 用於 webex_for_broadworks_to_wholesale Webex for BroadWorks 遷移。 

   REFRESH_TOKEN 屬性對於 Webex for BroadWorks 遷移是必需的。

5. 如果輔助 Cisco BroadWorks Application Server JDK/JRE 環境路徑與檔不同，請修改 export.sh 檔中的 JDK/JRE 環境路徑：

   JAVA_主頁=/usr/local/java/java_base

運行說明

在輔助 Cisco BroadWorks Application Server 的提取工具目錄中運行以下命令：

./export.sh

終端日誌

成功匯出后，終端中提供了以下日誌：執行 BroadSoft 資料匯出工具：

 運行 BroadSoft 數據匯出工具************************************************啟動 Export Tool v：1.15.0 SP=collabmigrationtestSP_engg、Group=collabmigrationtestGRP_engg 的導出已開始 匯出 SP=collabmigrationtestSP_engg的使用者、Group=collabmigrationtestGRP_engg 的導出使用者已完成 SP=collabmigrationtestSP_engg_engg、Group=collabmigrationtestGRP_engg_engg 的導出已完成 匯出轉儲 Zip 目錄：output/20221017223452_ExportTool Export Dump Zip 檔名 ：extracted_data_1666060500618.zip 已建立名為 extracted_data_1666060500618.zip 的 Zip 檔案 ZIP 檔案建立過程已完成 匯出的檔案轉換為 ZIP 檔案 ************************************************** 

輸出

輸出 ZIP （extracted_data_<timestamp>.zip） 檔案將位於同一提取工具目錄中。使用以下命令查看和使用 Transform Tool （變換工具） 輸入的 ZIP 檔：

ls –ltr drwxr-xr-x 2 bwadmin bwadmin 4096 十月4 11：53 lib/ -rwxr-xr-x 1 bwadmin bwadmin 956719 10 月4 11：53 exportTool.jar -rwxr-xr-x 1 bwadmin bwadmin 2635 十月4 11：53 export.sh drwxr-xr-x 2 bwadmin bwadmin 4096 十月5 05：04 conf/ drwxrwxr-x 3 bwadmin bwadmin 4096 10月17日 22：34 輸出/ drwxrwxr-x 2 bwadmin bwadmin 4096 10月17日 22：34 日誌/ -rw-rw-r-- 1 bwadmin bwadmin 46341 10月17日 22：35 extracted_data_1666060500618.zip 

此轉換工具針對所有遷移運行。轉換工具可在任何電腦（包括合作夥伴的管理員筆記型電腦）上運行，並使用 Webex 公共 API。它將提取工具輸出 ZIP （extracted_data_<timestamp>.zip） 檔案作為輸入讀取，並將原始 XML 轉換為供 Provisioning 工具使用的 JSON 格式。

先決條件

下載並提取遷移工具二進位檔後，請設定以下先決條件：

1. 在 conf/partner.cfg 檔中設置 REFRESH_TOKEN（從 Token Generator Tool 複製的 Token）和 NAME_OF_MAIN_LOCATION：

   刷新_代幣=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 主_位置名稱__=主

2. （可選）在 conf/partner.cfg 檔中設置 PROVISIONING_ID（從 Partner Hub 中的範本複製）：

   預置_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   要更完整地驗證客戶電子郵件位址，您可以選擇設置 PROVISIONING_ID。
3. 如果缺少，請在 input/customers.csv 檔中配置缺失資訊（請參閱下一節）。
4. 在 input/users.csv 檔中添加最終使用者電子郵件位址。
5. 如果要配置新電話，請將使用者新電話的mac位址和電子郵件位址添加到input/newphones.csv檔中。僅當合作夥伴管理員希望在 Wholesale calling 中預配置新電話時，才需要這樣做。
6. 使用 input/cxessentials.csv 檔將 BroadWorks 呼叫中心轉換為 CxEssentials。
7. （可選）啟用 UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS 屬性，以將所有呼叫中心轉換為 CxEssentials。
8. 使用 input/locations.csv 檔支援大型企業遷移，允許管理員按位置遷移其客戶的位置
9. 當 MAC 位址在 Cisco BroadWorks 設備設定檔中不可用時，可以選擇使用 SIP REGISTER 消息的 User-Agent 報頭中的 MAC 位址。取消註釋檔 conf/partner.cfg 中的“USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes”行

填充 input/customers.csv

檔 input/customers.csv 提供 Cisco BroadWorks 或 BroadCloud 中可能缺少的數據。如果所有必填資訊都已可用，則可以將此檔留空。您不必填寫所有列，只有缺少的資訊是必需的。

下表說明瞭 input/customers.csv 中最重要的列。

運行說明

在任何操作系統中運行 Transform Tool。使用以下步驟在 Windows 和 macOS 中運行該工具：

窗戶

執行以下命令以在 Windows 中運行 Transform Tool：

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

macOS

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

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

   python3 -m venv venv 源 venv/bin/activate python3 -m pip 安裝請求 python3 -m pip 安裝請求-oauthlib 

2. 運行轉換工具：

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

客戶/用戶預檢

轉換工具對 Webex 進行 API 調用，以捕獲潛在的預配置問題。默認情況下，它將驗證客戶的位址和主要電子郵件。如果在 conf/partner.cfg 檔中指定了 PROVISIONING_ID 值，它還將驗證位置資訊。預檢查結果包含在異常報告中。

此外，在運行變換工具時，可以添加以下可選參數：

預檢查

除了為客戶資訊運行 precheck API 之外，Transform Tool 還將為訂閱者電子郵件運行 precheck API。

precheckinfo

默認情況下，異常報告中僅包含預檢查錯誤（即將阻止配置的問題）。添加此標記還將包括成功的預檢查結果（例如，如果已存在可自動附加的 Webex 組織）。

終端日誌

成功轉換後，終端中將記錄以下內容：

摘要報告可以成功遷移的 BroadWorks 企業：1 無法遷移的 BroadWorks 企業：0 個可以成功遷移的 BroadWorks 使用者：4 個無法遷移的 BroadWorks 使用者：0 台可以成功遷移的手機：3 與 Webex Calling 不兼容的電話：0 

異常報告

Transform Tool 在 output/<timestamp>/exception_report.txt 目錄中生成異常報告。您可以使用此報告來確定將影響遷移的問題，並在 Cisco BroadWorks 系統中修復這些問題。

修改使用者數據以解決異常后，使用新數據重新運行 Extract 和 Transform Tools。範例異常報告檔如下：

異常報告 2022 年 10 月 18 日星期二 08：12：09 具有通信限制功能的企業推薦：在 Control Hub ________________________________________________________________________________ collabmigrationtestGRP 中手動配置傳出呼叫方案_engg 

輸出

輸出 JSON （customer.json） 檔將位於 output/<timestamp>/<groupid> 目錄中。範例 customer.json 檔如下所示：

{ “客戶”： { “provisioningId”： “!!!!!!!!替換為__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”： “工程組 - 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” }， “訂閱者”： [ { “amareswaranvel+benjaminjack@gmail.com”： { “訂閱者”： { “customerId”： “!!!!!!!!替換為__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”： “!!!!!!!!!替換為_PERSONID_!!!!!!!!“， ”product“： ”DMS Cisco 7861“， ”mac“： ”CC98914EAAD7“ } ] } }， { ”amareswaranvel+lucasoliver@gmail.com“： { ”subscriber“： { ”customerId“： ”!!!!!!!!!替換為_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”： “!!!!!!!!!替換為_PERSONID_!!!!!!!!“， ”product“： ”DMS Cisco 6821“， ”mac“： ”5486BCAE7E45“ } ] } }， { ”amareswaranvel+leojackson@gmail.com“： { ”訂閱者“： { ”customerId“： ”!!!!!!!!替換為_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”： “!!!!!!!!!替換為__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”： “!!!!!!!!!替換為_PERSONID_!!!!!!!!“， ”product“： ”DMS Cisco 8811“， ”mac“： ”F87B204E4066“ } ] } } ]， ”auto_attendants“： []， ”“： []，hunt_groups ”call_queues“： []， ”“call_parks： []， ”“： []， ”“： []， ”call_pickups“： []， ”“： []， ”paging_groupsvoice_portals“： [ { ”name“： ”自動語音門戶“， ”firstName“： ”自動“， ”lastName“： ”語音門戶“， ”languageCode“： “en_us”， “phoneNumber”： “+15205551105”， “分機”： “1105” } ]， “shared_call_appearances”： []， “business_communicator_desktop_to_upgrade_to_webex_app”： []， “PC 通信 - 工程設備配置檔” ]， “connect_client_to_upgrade_to_webex_app”： []， “位置”： []， “webex_for_broadworks_info”： { “使用者”： [ { “id”： “Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5” } ]， “hydra_orgId“： ”Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg“， ”hydra_customer_config_id“： ”Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk“ } }

預配置工具可以在任何計算機上運行，通常是（合作夥伴的管理員筆記型電腦）並使用 Webex 公共 API。它讀取轉換工具輸出 JSON （customer.json） 檔案作為輸入，並在 Webex Wholesale RTM 解決方案中預配置客戶、位置、號碼、使用者、服務和設備。

先決條件

在 Provisioning Tool 目錄中設定以下先決條件：

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. 下載並解壓縮遷移工具二進位檔后，在 MAC 和 provisioning_tool.bat for Windows 的 provisioning_tool.sh中設置 JAVA_HOME 環境變數。
3. partner.cfg 檔：
   • 設置 WHOLESALE_PROVISIONING_ID 和 REFRESH_TOKEN（從 Token Generator 工具複製的 Token）。合作夥伴管理員必須聯繫其客戶團隊以獲取 PROVISIONING_ID：

     批發_供應_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 刷新_令牌=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

   • 如果合作夥伴不想向使用者發送歡迎電子郵件，請將ALLOW_ADMIN_INVITE_EMAILS 設置為 false。默認值為 true。

4. 使用 Webex for BroadWorks 遷移的 WEBEX4BWKS_EMAIL_SUBJECT 屬性，為 Webex for BroadWorks 訂閱者發送更改密碼請求電子郵件主題。
5. 使用 Webex for BroadWorks 遷移的 WEBEX4BWKS_EMAIL_BODY 屬性向 Webex for BroadWorks 訂閱者發送更改密碼請求電子郵件正文。

對於 BroadCloud 遷移，同一區域：

1. 該工具會跳過號碼、設備和共用呼叫外觀預置。
2. 該工具使用分機和臨時分機創建使用者和虛擬使用者。

對於 BroadCloud 遷移另一個區域：

1. 該工具將預置號碼、設備和共用呼叫外觀。
2. 該工具創建具有實際電話號碼和分機號的使用者和虛擬使用者。
   所有歐洲 BroadCloud 遷移都遷移到另一個區域。

運行說明

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

窗戶

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

要預置單個客戶：provision.bat -input=<Transform-Tool-Output-Customer-JSON-File-Path>要預置多個客戶：provision.bat -input=<Transform-Tool-Timestamp-Output-Directory-Path> 

macOS

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

預置單個客戶：./transform.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>預置多個客戶：./transform.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path> 

Webex for BroadWorks 遷移的先決條件

合作夥伴管理員必須更新其 BroadWorks 加入範本，才能使用 Webex for BroadWorks 共存功能。請參閱下圖：

更新 Webex for BroadWorks 載入範本以支援遷移後，請請求 Cisco 客戶團隊在合作夥伴級別啟用「已啟用批發合作夥伴混合」功能切換。這將允許在預配置期間將批發軟體包添加到現有 Webex for BroadWorks 客戶組織。

使用附加參數運行 provisioning 工具。

準備階段： 是預設階段，管理員可以將 BroadWorks 用戶預配置為批發訂閱者，並繼續使用 Webex for BroadWorks 使用者。

維護階段： 是管理員可以將批發許可證分配給現有 Webex for BroadWorks 使用者的第二個階段。您必須使用參數 maintenance 執行預置工具。

遷移後階段： 是管理員可以將 BroadWorks 完全轉換為 Wholesale 的最後階段。您必須使用參數 postmigration 運行供應工具。

終端日誌

以下是成功設定時終端中的紀錄：

工具名稱：Provisioning Tool 版本：1.15.0 ********** 已開始處理檔 ：input/customer.json **************** 預置客戶 正在等待客戶 external_id_engg_grp1 完成預置... 等待客戶 external_id_engg_grp1 完成預置... 客戶 external_id_engg_grp1 狀態 ：設定設定號碼 設定 使用者設定 使用者功能 設定 問候語 設定 計劃 設定 裝置 設定 分享呼叫顯示 設定自動助理 設定呼叫佇列 設定尋線組 設定組設定組尋呼 設定呼叫暫留 設定呼叫代答 設定語音門戶 ********** 已完成的檔案 ：輸入/customer.json **************** 

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

輸出

Provisioning Tool 在 output/<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 for BroadWorks

對於 Cisco BroadWorks 和 Webex for BroadWorks 遷移，該工具在合作夥伴網路內的輔助 Cisco BroadWorks 應用程式伺服器上運行，並通過 OCI-P 連接到 AS。它使用轉換工具輸出 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 Application Server。
2. 通過 SSH 連接到輔助 Cisco BroadWorks Application Server，以配置先決條件並運行設備行動工具。

先決條件

1. 在 conf/partner.cfg 文件中設置 REFRESH_TOKEN（從 Token Generator Tool 複製的 Token）：

   刷新_代幣=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. 確保 conf/deviceMoveTool.conf 文件中的輔助 Cisco BroadWorks Application Server 使用者 ID、密碼和主機名正確無誤：

   BROADWORKS_使用者_ID = 管理員 BROADWORKS_密碼 = 管理員 BROADWORKS_ 主機名_= 本地主機 

3. 要重新發送啟動電子郵件，您需要在 conf/partner.cfg 檔中設置 RESEND_INVITATION_EMAILS=true。

   如果管理員希望在遷移期間向使用者發送邀請電子郵件，則應取消註釋 conf/partner.cfg 檔中的“RESEND_INVITATION_EMAILS=true”屬性。否則，該屬性應保持不變。

4. 驗證 devicemove.sh

   JAVA_HOME=/usr/local/java/ 中的 JDK/JRE 環境路徑是否正確java_base

5. 管理員可以使用 input 目錄中的 locations.csv 檔來遷移特定組，而不是企業下的所有組。

Polycom 電話

要將Polycom電話從 Cisco BroadWorks 移至批發呼叫，合作夥伴管理員必須在 Cisco BroadWorks 的每個 Polycom 設備範本的系統級別創建新的身份/設備配置檔類型檔。參考圖 14 並上傳自定義檔 device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg。上傳新設備檔后，請確保新創建的檔存在於 Group 級別。此外，請確保檔 migration_%BWMAC ADDRESS%.cfg 不會與系統中的任何現有文件衝突）。

它由設備行動工具在內部使用。

Polycom 電話的遷移過程：

1. 設備行動工具將設備級別的檔案 %BWMACADDRESS%.cfg 替換為 polycom_vvx2.cfg。此檔案引用 migration_%BWMACADDRESS%.cfg。
2. 在組級別或設備級別重新生成設備配置檔。
   在組級別或設備級別操作取決於檔 device-move-tool/conf/partner.cfg 中參數 deviceLevelRebuild 的配置。
3. 設備移動工具要求 Cisco BroadWorks Application Server 在組級別或設備級別重新啟動電話。
4. 重新啟動請求后，Polycom 電話下載並處理 process.cfg% BWMACADDRESS%，它要求 Polycom 電話下載並處理 migration_%BWMACADDRESS%.cfg，這會將 device.prov.serverName 設置為 https://plcm.sipflash.com.
   https://plcm.sipflash.com 對於美國區域，其他區域具有不同的 URL。
5. Polycom 電話從 https://plcm.sipflash.com Webex Calling DMS 下載 %BWMACADDRESS%.cfg 並由 Webex Calling DMS 管理。

圖 14：身份/設備配置檔類型檔添加

運行說明

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

設備移動工具從設備移動工具目錄中的輔助 Cisco BroadWorks Application Server 運行：

對於設備移動單個客戶：./devicemove.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path> ./devicemove.sh -input=/tmp/customername.json對於設備移動多個客戶：./devicemove.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path> ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json 此外，設備移動工具支援從 1.35.0 版本遷移單個/特定手機。使用以下命令： ./devicemove.sh -integration -input= <Transform-Tool-Output-Customer-JSON-File-Path> -macaddress=4CBC4883A6F8,48256741CBE9 

終端日誌

以下是成功執行裝置行動工具進行設備移移時終端中的紀錄：

工具名稱：裝置移動工具版本：1.15.0 設備工具已啟動... 移轉的有效裝置 ：|-------------------------------------------------------------------------------------------------------------------設備類型 | Mac | 版本|電子郵件 | ------------------------------------------------------------------------------------------------------------------- | 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 | ------------------------------------------------------------------------------------------------------------------- 您要遷移所有這些設備_嗎？| |（[是]或[否]是 為 DMS 上傳設備配置檔 Cisco MPP LC 重建設備進程已啟動 重建設備進程 成功完成 重新啟動進程已啟動 重啟進程成功完成 修改組 collabmigrationtestGRP_engg 下 Business Communicator 的配置檔 啟動 webex 電話號碼 為客戶組織啟動的進程 ID ：85ea1d6f-ff9e-41a1-843f-7362aaf12b4c 客戶組織 ID 的啟動 webex 電話號碼過程已完成：85ea1d6f-ff9e-41a1-843f-7362aaf12b4c 停用 broadworks 電話號碼 組 ID 的進程已啟動 ：collabmigrationtestGRP_engg 停用 broadworks 電話號碼 groupId 的流程已完成 ：collabmigrationtestGRP_engg 設備遷移已完成 

輸出

設備遷移後，設備已連線並準備好撥打/接聽電話。請參閱圖 15 以檢視裝置狀態的範例：

圖 15：裝置狀態

設備遷移後，號碼已啟動。請參閱圖 16 以查看哪些號碼處於活動狀態的範例：

圖 16：活躍號碼

一次必須為一個企業執行 revert 操作。

對於 BroadCloud 運營商

BroadCloud 合作夥伴的還原過程如下：

1. 向 Cisco TAC 提交票證以請求設備恢復。
2. 在還原模式下執行裝置行動工具：
   • 電話號碼將從 Webex Calling 中取消分配，只留下具有分機的用戶和服務。
   • Webex Calling 中的電子郵件地址將恢復為臨時電子郵件位址。
   • 電話將從 Webex Calling 中刪除。
   • 電話號碼、用作alternatedId的電子郵件地址和電話將在 BroadCloud 中重新創建。
   • 手機將重新啟動。
3. 合作夥伴管理員必須將 PSTN 電話號碼移回 BroadCloud 運營商。

對於 Cisco BroadWorks 和 Webex for BroadWorks

Cisco BroadWorks 和 Webex for BroadWorks 的還原過程如下：

1. 向 Cisco TAC 提交票證以請求設備恢復。
2. 在輔助 BroadWorks Application Server 上以恢復模式運行設備行動工具，以恢復設備遷移。這會將 DMS URL 設置回 Cisco BroadWorks 中設備配置檔的服務提供者 DMS URL，並重新啟動電話號碼。
3. Webex Calling 團隊在 Webex Calling 的設備設定檔中將 DMS URL 設置回服務提供者 DMS URL。
4. 合作夥伴管理員必須通過 Control Hub 門戶停用或刪除 Webex Calling 中的電話號碼。
5. 合作夥伴管理員必須將 PSTN 電話號碼移回 Cisco BroadWorks。

在還原模式下運行設備行動工具的說明

請按照以下步驟在還原模式下運行裝置行動工具：

在設備移動工具目錄內的輔助 Cisco BroadWorks Application Server 中運行以下命令：

還原配置檔

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

還原數位

./devicemove.sh -input= <transform-tool-output-customer-JSON-file-path> -revertNumbers

終端日誌

成功運行設備行動工具進行還原操作后，我們將在終端中獲得以下日誌：

還原配置檔

工具名稱：裝置移動工具版本：1.15.0 已啟動設備工具以進行還原過程... 可從 Webex Calling 移回 BroadWorks 的設備：- ------------------------------------------------------------------------------------------------------------------- | 設備類型 | Mac | 版本|電子郵件 | ------------------------------------------------------------------------------------------------------------------- | 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 | ------------------------------------------------------------------------------------------------------------------- 是否要將這些設備從 Webex Calling 移回 BroadWorks_| |？（是、Y、否、N）：是 為 DMS 上傳設備設定檔 Cisco MPP LC 重建設備進程已啟動 重建設備進程 成功完成 重啟過程已啟動 重啟過程 成功完成 裝置遷移已完成以進行取消配置過程 

還原數位

工具名稱：裝置移動工具版本：1.15.0 是否要繼續將數位還原到 Broadworks？（[Y]es 或 [N]o）：Y [+15205551101， +15205551102， +15205551103， +15205551104， +15205551105， +15205551106， +15205551107， +15205551108， +15205551109， +15205551110] 開始還原 為 groupId 啟動 broadworks 電話號碼進程已啟動：collabmigrationtestGRP_engg 為 groupId 完成啟動 broadworks 電話號碼的過程 ：collabmigrationtestGRP_engg 設備遷移還原過程已成功完成