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

最後一欄提供電話機型與檔案轉換工具/輸入/newphones.csv 的「裝置類型」欄的對應。（請參閱轉換工具 有關 newphones.csv 的更多資訊）。

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

下載後，解壓縮移轉工具二進位檔案。

執行指示

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

Windows：

token_generator.bat

MacOS：

./token_generator .sh

輸出：

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

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

使用者介面圖示如下所示，以供參考：

圖 3：使用 Cisco Webex 登入

圖 4：授權視窗

圖 5：權杖產生

在次要 BroadWorks 伺服器中執行擷取和裝置移動工具之前，請設定下列步驟。

啟用 OCI-P 連線

裝置移動工具透過 OCI-P 指令與 BroadWorks 通訊，若要啟用 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 = <> 

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

步驟 2 ：使用 CLI 設定 OCI Proxy。

將目錄變更為 OCI Proxy：

AS_ CLI> cd /Applications/OpenClientServer/OCIProxy

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

AS_CLI/Applications/OpenClientServer/OCIProxy> 啟用 = trueenabledLoginLevelScreencing = false enableResponseCaaging = false responseCacheDurationHours = 24 responseCacheRenewPeriodMins = 30 messageQueueCapacity = 50 messageQueueTimeoutSeconds = 1800 

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

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

切換至佈建目錄：

AS_ CLI> cd /System/NetworkAccessLists/OCI/Provisioning

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

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> get Address 說明 ======================== 127.0.0.1 本機為 

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

 AS_ CLI/Maintenance/ManagedObjects> get Broadworks 並檢查您的輸出是否正常。請參閱下面的範例輸出：AS_ CLI/Maintenance/ManagedObjects> get BroadWorks BroadWorks 受管理物件 =========================* 伺服器：身分...................：AS 版本................：Rel_ 21.sp1_ 1.551 管理州...：已解除鎖定的 * 應用程式：名稱 版本 已部署 管理狀態 生效狀態 ====================================== ============================================== ExecutionAndProvisioning 21.sp1_ 1.551 true Unlocked Unlocked FlashPolicy 21.sp1_ 1.551 false 已解除鎖定 已停止 OpenClientServer 21.sp1_ 1.551 true Unlocked Unlocked 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 /FileRepo 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 ：執行號碼啟用指令：

AS_ CLI> cd SubscriberMgmt/NumberActivation

步驟 2 ：執行啟用啟用的指令：

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 檔案，這些檔案為轉換工具提供輸入。

以下各節說明如何安裝和設定擷取工具。

先決條件

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

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

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

   BroadWorks_使用者_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_ HOME=/usr/local/java/java_base

執行指示

在解壓縮工具目錄的次要 Cisco BroadWorks 應用程式伺服器中執行下列指令：

./export.sh

終端機記錄檔

成功匯出後，終端機中會提供以下記錄：執行 BroadSoft 資料匯出工具：

 正在執行 BroadSoft 資料匯出工具 ********************************************* *** 正在啟動匯出工具 v：1.15.0 SP=collabmigrationtestSP 的匯出已開始_engg，群組=collabmigrationtestGRP_engg 匯出 SP=collabmigrationtestSP 的使用者_engg，群組=collabmigrationtestGRP_engg SP=collabmigrationtestSP 的使用者匯出已完成_engg，群組=collabmigrationtestGRP_engg SP=collabmigrationtestSP 的匯出已完成_engg，群組=collabmigrationtestGRP_engg 匯出完成的匯出傾印 Zip 目錄：輸出/20221017223452_ ExportTool 匯出傾印 Zip 檔案名稱：extracted_data_1666060500618.zip Zip 檔案，其名稱為extracted_data_1666060500618.zip 已建立 ZIP 檔案建立過程已完成 匯出的檔案轉換為 ZIP 檔案 ************************************ *****************

輸出

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

ls –ltr drwxr-xr-x 2 bwadmin bwadmin 4096 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 10 月5 05:04 conf/ drwxrwxr-x 3 bwadmin bwadmin 4096 10 月 17 日 22:34 輸出/ drwxrwxr-x 2 bwadmin bwadmin 4096 10 月 17 日 22:34 logs/ -rw-rw-r-- 1 bwadmin bwadmin 46341 10 月 17 日 22： 35extracted_data_1666060 500618.zip

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

先決條件

下載並解壓縮移轉工具二進位檔案後，請設定下列先決條件：

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

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

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

   佈建_ID=YmE4MjFkZGYtYTlkNy00NDdlWODctYmNkOTM2NjUyYWQ1

   若要更完整地驗證客戶電子郵件地址，您可以選擇性地設定_ID。
3. 在 input/customers.csv 檔案中設定缺少的資訊（請參閱下一節）（如果缺少）。
4. 在 input/users.csv 檔案中新增一般使用者電子郵件地址。
5. 如果要佈建新電話，請將使用者新電話的 MAC 位址和電子郵件地址新增至 input/newphones.csv 檔案。僅當合作夥伴管理員想要在 Wholesale 通話中佈建新電話時，才需要這樣做。
6. 使用 input/cxessentials.csv 檔案將 BroadWorks 呼叫中心轉換為 CxEssentials。
7. （選用）啟用升級_全部_呼叫_中心_至_客戶體驗_ESSENTIALS 屬性，以將所有 Call Center 轉換為 CxEssentials。
8. 使用 input/locations.csv 檔案來支援允許管理員依位置移轉其客戶位置的大型企業移轉
9. 當 MAC 位址在 Cisco BroadWorks 裝置設定檔中不可用時，可以選擇從 SIP REGISTER 訊息的 User-Agent 標頭啟用 MAC 位址的使用。取消註釋行「USE_ MAC_地址_來自_SIP_ REGISTER=yes」（在檔案 conf/partner.cfg 中）

填寫輸入/customers.csv

檔案 input/customers.csv 提供 Cisco BroadWorks 或 BroadCloud 中可能遺失的資料。如果所有必填資訊都已可用，則可以將此檔案留空。您不必填寫所有欄，只有遺漏的資訊是必填的。

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

執行指示

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

視窗

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

轉換.bat -extract= -客戶= -使用者= -newphones=

macOS

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

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

   Python3 -m venv venv 來源 venv/bin/activate 

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（ customer.json ）檔案將在輸出/ / 目錄。範例customer.json 檔案如下所示：

{ "customer": { "provisioningId": "!!!!!!!REPLACE_有_PROVISIONINGID!!!!!!!!!!", "packages": [ "webex_calling ", "common_area_calling " ], "externalId": "external_id_engg_grp 1", "address": { "addressLine1": "100 Main Street", "addressLine2": "", "city": "蓋瑟斯堡", "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": "Gaithersberg", "stateOrProvince": "MD", "zipOrPostalCode": "20877", "country": "US" }, "timezone": "America/New_約克", "語言": "en_us ", "數字": [ "+15205551101", "+15205551102", "+15205551103", "+15205551104", "+15205551105", "+15205551106", "+15205551107", "+152055515110", "9+1520551018" ", "+15205551110" ], "mainNumber": "+15205551101" } } } }, "broadworks_info ": { "service_provider_id ": "collabmigrationtestSP_engg ", "group_id ": "collabmigrationtestGRP_engg " }, "subscribers": [ { "amareswaranvel+benjaminjack@gmail.com": { "subscriber": { "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": { "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_有_人員 ID!!!!!!!!!!", "product": "DMS Cisco 7861", "mac": "CC98914EAAD7" } ] } }, { "amareswaranvel+lucasoliver@gmail.com": { "subscriber" : { "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": { "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_有_人員 ID!!!!!!!!!!", "product": "DMS Cisco 6821", "mac": "5486BCAE7E45" } ] } }, { "amareswaranvel+leojackson@gmail.com": { "subscriber" : { "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": { "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_有_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_有_人員!!!!!!!!!!", "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": "+15205551105", "extension": "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（ 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適用於 Windows 的 .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 作業系統上執行該工具：

若要佈建單個客戶：Provision.bat -input=若要佈建多個客戶：Provision.bat -input= 

macOS

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

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

Webex for BroadWorks 移轉的先決條件

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

Webex for BroadWorks 上線範本更新為支援移轉後，請要求 Cisco 帳戶團隊在合作夥伴層級啟用「 Wholesale-partner-blending-enabled」功能切換。這將允許在佈建期間將 Wholesale 套件新增至現有 Webex for BroadWorks 客戶組織。

使用其他參數執行佈建工具。

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

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

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

終端機記錄檔

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

工具名稱：佈建工具版本：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：服務提供者入口網站

適用於 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. 在 Wholesale 中啟動號碼。
5. 在 Wholesale 中為 BroadCloud 移轉建立共用通話外觀。[此步驟僅適用於 BroadCloud 移轉]。

SCP 和 SSH

1. SCP 裝置移動工具至次要 Cisco BroadWorks 應用程式伺服器。
2. SSH 至次要 Cisco BroadWorks 應用程式伺服器以設定先決條件並執行裝置移動工具。

先決條件

1. 設定 REFRESH_ conf/partner.cfg 檔案中的 TOKEN（從權杖產生器工具複製的權杖）：

   重新整理_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BroadWorks_使用者_ID = 管理員 BROADWORKS_密碼 = 管理員 BROADWORKS_主機_NAME = 本地主機

3. 若要重新傳送啟用電子郵件，您需要設定 RESEND_邀請_conf/partner.cfg 檔案中的 EMAILS=true。

   如果管理員希望在移轉期間向其使用者傳送邀請電子郵件，他們應該取消註解「RESEND_邀請_EMAILS=true" 屬性（在 conf/partner.cfg 檔案中）。否則，該屬性應保持不變。

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

   JAVA_ HOME=/usr/local/java/java_base

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

Polycom 電話

若要將 Polycom 電話從 Cisco BroadWorks 移至 Wholesale Calling，合作夥伴管理員必須在 Cisco BroadWorks 的系統層級建立新的身分/裝置設定檔類型檔案每個 Polycom 裝置範本。請參閱圖 14 並上傳自訂檔案device-move-tool/conf/deviceProfile/{region}/polycom_vvx .cfg 。上傳新的裝置檔案後，請確保新建立的檔案存在於群組層級。同時確保該檔案migration_%BWMAC ADDRESS%.cfg 不會與系統中的任何現有檔案衝突）。

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

Polycom 電話的移轉程序：

1. 裝置移動工具會取代檔案%BWMACADDRESS%.cfg（在裝置層級）polycom_vvx 2.cfg。此檔案是指migration_%BWMACADDRESS%.cfg。
2. 在群組層級或裝置層級重建裝置設定檔。
   在群組層級或裝置層級執行動作取決於檔案 device-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 -input= ./devicemove.sh -input=/tmp/customername.json 對於裝置移動多個客戶：./devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json 此外，裝置移動工具支援從 1.35.0 版本移轉單一/特定電話。使用以下指令：./devicemove.sh -integration -input= -macaddress=4CBC4883A6F8,48256741CBE9 

終端機記錄檔

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

工具名稱：裝置移動工具版本：1.15.0 裝置工具已啟動... 可移轉的有效裝置：-------------------------------------------------- -------------------------------------------------- ---------------| 裝置類型| 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+owenalex@gmail.com| -------------------------------------------------- -------------------------------------------------- --------------- 要移轉所有這些裝置嗎？（[Y]es 或 [N]o）yes 正在上傳 DMS 的裝置設定檔 Cisco MPP LC 已開始重建裝置程序 已成功完成重建裝置程序 重新啟動程序已開始 已成功完成重新啟動程序 正在修改群組 CollabmigrationtestGRP 下的 Business Communicator 設定檔_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 中刪除。
   • 電話號碼、用作替代 ID 的電子郵件地址和電話將在 BroadCloud 中重新建立。
   • 電話將重新啟動。
3. 合作夥伴管理員必須將 PSTN 電話號碼移回 BroadCloud Carrier。

適用於 Cisco BroadWorks 和 Webex for BroadWorks

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

1. 使用 Cisco TAC 開立報修單以請求裝置還原。
2. 在次要 BroadWorks 應用程式伺服器上以還原模式執行裝置移動工具，以還原裝置移轉。這會將 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 應用程式伺服器中執行以下指令：

還原設定檔

./devicemove.sh -input= -revertProfiles

還原號碼

./devicemove.sh -input= -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+owenalex@gmail.com| -------------------------------------------------- -------------------------------------------------- --------------- 要將這些裝置從 Webex Calling 移回 BroadWorks 嗎？（是，Y，否，N）：是 正在上傳 DMS 的裝置設定檔 Cisco MPP LC 重建裝置程序已開始 重建裝置程序已成功完成 重新啟動程序已開始 重新啟動程序已成功完成 裝置移轉已完成取消佈建程序 

還原號碼

工具名稱：裝置移動工具版本：1.15.0 要繼續將號碼恢復為 Broadworks 嗎？（[Y] 或 [N] o）：是 [+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +1520555works 已啟動群組電話號碼] 協作移轉測試GRP_engg 已為 groupId 啟動 BroadWorks 電話號碼程序：協作移轉測試GRP_engg 裝置移轉還原程序已成功完成