設定工具將自動建立支援的電話號碼並將其指派給 Webex Calling 中的使用者。在「裝置遷移工具支援」欄位中標記為「是」的電話，在執行裝置遷移工具時，也會自動從 Cisco BroadWorks 或 BroadCloud 遷移到 Webex Calling。此欄位中標示為「否」的電話需要手動幹預，才能在 Cisco BroadWorks 設備範本或電話本身中變更 DMS URL。

最後一列提供了手機型號與檔案中「裝置類型」欄位的對應關係。 transform-tool/input/newphones.csv. （有關 newphones.csv 的更多信息，請參閱本文的 轉換工具 部分）。

合作夥伴管理員在開始執行遷移工具之前，至少執行一次此令牌產生器實用工具。合作夥伴帳戶加入批發 RTM 解決方案後，執行此工具只需一次。該工具允許合作夥伴管理員透過網頁瀏覽器登錄，以取得更新遷移工具的合作夥伴設定檔所需的唯一令牌。

必要條件

在電腦上安裝 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

輸出：

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

在終端機的網頁瀏覽器中開啟 URL，使用合作夥伴管理員憑證登入以取得 TOKEN，並複製該 TOKEN 以備後續使用。

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

圖 3：使用 Cisco Webex 登入

圖 4：憑證視窗

圖 5：代幣生成

在輔助 BroadWorks 伺服器上執行提取和裝置移動工具之前，請先設定下列步驟。

啟用 OCI-P 連接

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

步驟 1: 使用命令列介面配置常規設定。

在命令列介面 (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

運行以下命令列介面以取得目前設定。您應該看到以下內容：

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。

切換到 Provisioning 目錄：

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

執行以下命令以取得目前的 OCI 配置設定：

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

第四步: 在命令列介面 (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.

驗證客戶端伺服器是否已部署並處於活動狀態

如果尚未部署或尚未啟動，請使用下列命令在輔助應用程式伺服器上部署並啟動 Open Client Server。

步驟 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

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

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

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

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

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

CSV擷取請求

發起 CSV 提取請求

1. 下載客戶 CSV 文件

   點擊 「 發起CSV 提取請求 」部分右上角的「下載客戶 CSV 」連結。

2. 編輯客戶列表

   管理員可以編輯此 CSV 文件，使其僅包含需要執行資料提取的客戶。

3. 上傳並提交

   編輯完成後，上傳修改後的CSV檔。

   點擊 提交 以啟動所列客戶及其關聯位置的提取請求。

發起提取包含位置資訊的客戶 CSV 檔案的請求

1. 選擇客戶和下載位置

   從下拉式選單中選擇一位客戶。

   從 查看客戶→ 網站標籤 → 將位置匯出為 CSV下載對應的 locations.csv 。

2. 編輯位置文件

   管理員可以編輯 CSV 文件，只包含他們想要提取的位置資訊。

3. 上傳並提交

   上傳編輯後的 locations.csv 文件，然後點擊 提交。

   提取請求中只會包含所選客戶的指定位置。

發起所有客戶的提取請求

1. 點擊 提交 以發起提取請求，請求內容為目前服務提供者下的所有客戶 和所有位置。

適用於 Cisco BroadWorks 和 Webex for BroadWorks

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

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

必要條件

1. 透過 SCP 將提取工具二進位檔案傳輸到輔助 Cisco BroadWorks 應用伺服器。
2. 透過 SSH 連接到輔助 Cisco BroadWorks 應用伺服器，設定先決條件並執行提取工具。
3. 設定服務提供者和群組 ID 以從 Cisco BroadWorks 中提取 conf/exportTool.yml. 請參考以下 YAML 程式碼片段範例：

   ServiceProviderID-A:
        - GroupID-A1
        - GroupID-A2
        - GroupID-A3
   ServiceProviderID-B:
                          - ALL
   

4. 請確保輔助 Cisco BroadWorks 應用伺服器的使用者 ID、密碼和主機名稱正確無誤。 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.
   

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

5. 修改 JDK/JRE 如果是輔助 Cisco BroadWorks 應用伺服器，則需要在 export.sh 檔案中指定環境路徑。 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_<timestamp>.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 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

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

必要條件

下載並解壓縮移轉工具二進位檔案後，請配置以下先決條件：

1. 在下列位置設定刷新_令牌（令牌從_令牌產生器工具複製_）和主位置_名稱 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. 如果 Cisco BroadWorks 設備設定檔中沒有 MAC 位址，則可以選擇啟用從 SIP REGISTER 訊息的 User-Agent 標頭中使用 MAC 位址。取消註解該行 USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes 在文件中 conf/partner.cfg
10. 您可以選擇啟用以下屬性：ANALOG_USER_TYPE_ENABLE_CALL_WAITING、ANALOG__USER [_] TYPE ENABLE_MUSIC_ON_HOLD 和 ANALOG_USER_[] TYPE [] DISABLE ON_[] HOLD 和 ANALOG [] USER [] TYPE DISABLE_T38，以保持音樂配置和呼叫類型。

11. 如果要設定通用網關設備，請將設備的 MAC 位址和使用者 ID 新增至… input/genericgateways.csv 文件。另外，也要說明該用戶是主要所有者還是共享用戶（用於共享通話）。只有當合作夥伴管理員計劃在批發呼叫中使用通用網關設備時才需要這樣做。

    此功能不適用於從 BroadCloud 到 Wholesale 的遷移。

12. 對於 BroadCloud 遷移，要將所有訊息站類型為 [] 的使用者轉換為 voice_mail_group，請更新 conf/rialto_station_type_to_wholesale_package.csv 文件，將 批發套餐 值替換為 voice_mail_group ，其中 Rialto 站類型 為訊息的行。

    （可選）在 partner.cfg 中啟用 COMMON_VOICE_MAIL_GROUP_PASSCODE 屬性，以配置語音郵件群組的預設 PIN 碼。

    如果 partner.cfg中未指定此屬性，則必須在 customers.csv 檔案中的 commonVoicemailGroupPassCode 欄位中為每個客戶提供此屬性。

13. 將常用聯絡人遷移到 Webex Calling

    它是企業級和網站級通用聯絡人管理的增強功能。現在可以根據配置設置，將這些聯絡人遷移為組織聯絡人（Org Contacts）或虛擬分機。以下詳細資訊將引導您完成此遷移過程。

    關鍵配置：

    • 常用_電話_列表_至_虛擬_分機_起始_範圍

      partner.cfg 檔案中引入了一個新的屬性， COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE。此屬性決定如何將共同聯絡人從 Rialto 遷移到 Webex Calling。

    • 未配置 COMMON_PHONE_LIST_TO_VIRTUAL_EXENSION_START_RANGE

      共同聯絡人將遷移為組織聯絡人（組織聯絡人）。

      無需額外配置。

      組織層面的聯繫仍然可用。

    • 已配置 COMMON_PHONE_LIST_TO_VIRTUAL_EXENSION_START_RANGE

      共同聯絡人將遷移為虛擬分機。

      每個聯絡人都會附加一個分機號碼，分機的起始範圍在 partner.cfg 的 COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE 屬性中定義。

      根據聯繫範圍的不同，虛擬分機可以在組織層級和地點層級得到支援。

14. 啟用 Webex 作為預設通話錄音供應商。

    只有當將設定了 Dubber 的使用者的通話錄音設定遷移到 Webex 中的 Cisco Native Call Recording 時，才需要執行此步驟。

    要啟用此選項：

    • 在 partner.cfg 檔案中，設定以下屬性， DEFAULT_CALL_RECORDING_VENDOR=Webex。
    • 此外，可以使用屬性 WEBEX_CALL_RECORDING_STORAGE_REGION 來配置儲存區域。

      Webex Calling 不支援 BroadCloud 的 按需 錄製選項。這些通話錄音設定不會遷移，並且會出現在異常報告中。

15. 將選定的電話號碼排除在遷移範圍之外：

    若要將特定電話號碼從遷移過程中排除，必須使用轉換工具依照以下兩步驟程序進行操作：

    • 首次運行變換工具。完成後，該工具將產生一個名為 telephone_numbers_inventory.csv 的文件，該文件位於 output/timestamp/ 目錄。客戶需要查看此文件，並在「刪除 Tn」列中對每個應從即將進行的遷移中排除的電話號碼表示「是」。
    • 使用適當的排除標誌更新 telephone_numbers_inventory.csv 檔案後，再次執行轉換工具。更新後的文件應以下列格式作為參數傳遞。

      ./transform.sh -extract=input/extracted_data_1747640608219.zip -decommissionnumbers={filepath/telephone_numbers_inventory.csv}

加滿 input/customers.csv

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

下表解釋了最重要的列 input/customers.csv.

加滿 input/users.csv

文件 input/users.csv 提供 Cisco BroadWorks 或 BroadCloud 中可能缺少的資料。如果所有必填資訊都已提供，則此文件可以留空。您不必填寫所有列，只有缺少的資訊是必填項。

運行說明

在任何作業系統上執行轉換工具。請依照下列步驟在 Windows 和 macOS 系統上執行該工具：

Windows

在 Windows 系統中，執行下列命令執行轉換工具：

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

macOS

若要在 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= -customers= -users= -newphones=

Customer/user 預檢

轉換工具會向 Webex 發送 API 請求，以發現潛在的設定問題。預設情況下，它會驗證客戶的地址和主要電子郵件地址。如果在 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

異常報告

轉換工具會在 輸出/<timestamp>內產生異常報告。 /exception_report.txt 目錄。您可以利用這份報告來識別影響遷移的問題，並在 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

輸出

輸出 JSON 檔案（customer.json）將位於 output/<timestamp>目錄下。 /<groupid> 目錄。 範例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"
    }
}

配置工具通常可以在任何機器上運行（通常是合作夥伴的管理員筆記型電腦），並使用 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. 下載並解壓縮移轉工具二進位檔案後，在 MAC 的 provisioning_tool.sh 檔案中設定 JAVA_HOME 環境變量，在 Windows 的 provisioning_tool.bat 檔案中設定 JAVA [] HOME 環境變數。
3. partner.cfg 檔案：
   • 設定批發_設定_ID 和刷新_令牌（令牌從令牌產生器工具複製）。合作夥伴管理員必須聯絡其客戶團隊以取得 PROVISIONING_ID：

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • 如果合作夥伴不想向使用者發送歡迎郵件，請將 ALLOW_ADMIN_INVITE_EMAILS 設定為 false。預設值為真。

     Webex 只會傳送歡迎郵件給最終使用者。客戶管理員收不到歡迎郵件。

     位於美國和加拿大的使用者和客戶管理員會收到來自 RedSky 的單獨電子郵件通知。RedSky E911 平台會傳送此電子郵件以確認建立緊急服務客戶帳戶。這封 RedSky 電子郵件與 Webex 歡迎電子郵件是分開的，不受 Webex 電子郵件設定控制。對於美國和加拿大的批發機構，RedSky 會自動啟用為緊急服務提供者。

4. 使用 Webex for BroadWorks 遷移的 WEBEX4BWKS_EMAIL_SUBJECT 屬性，向 Webex for BroadWorks 訂閱者發送更改密碼請求電子郵件主題。
5. 使用 Webex for BroadWorks 遷移的 WEBEX4BWKS_EMAIL_BODY 屬性，向 Webex for BroadWorks 訂閱者發送更改密碼請求電子郵件正文。
6. 使用 CUSTOM_TAGS 屬性在建立客戶後新增標籤。

運行說明

請依照下列步驟在 Windows 和 macOS 系統上執行該工具：

Windows

若要在 Windows 作業系統上執行該工具，請執行下列步驟：

To provision single customer:
provision.bat -input=
To provision multiple customers:
provision.bat -input= 

macOS

若要在 macOS 上執行該工具，請執行下列步驟：

To provision single customer:
./transform.sh -input=
To provision multiple customers:
./transform.sh -input=

Webex for BroadWorks 遷移的先決條件

合作夥伴管理員必須更新其 BroadWorks 入職模板，以支援 Webex 與 BroadWorks 的共存功能。請參考下圖：

一旦 Webex for BroadWorks Onboarding 範本更新為支援遷移，請要求 Cisco 客戶團隊在合作夥伴層級啟用「wholesale-partner-blending-enabled」功能開關。這樣一來，就可以在配置過程中將批發套餐新增至現有的 Webex for BroadWorks 客戶組織。

運行配置工具時新增一個附加參數。

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

維護階段： 在第二階段，管理員可以將批發許可證指派給現有的 Webex for BroadWorks 使用者。您必須使用參數 maintenance來運行設定工具。

遷移後階段： 這是管理員可以將 BroadWorks 完全轉換為批發模式的最後階段。您必須使用參數 postmigration來執行設定工具。

終端日誌

以下是配置成功後終端顯示的日誌：

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 ****************

系統將列印一張表格，列出每次運行創建的位置數量：

輸出

配置工具會在 輸出/<external_id>中產生成功和錯誤報告。 /*.success/error 文件。查看輸出成功和錯誤日誌，以驗證設定是否成功。

系統將在 output/consolidated_reports/ 目錄中產生一個 Provisioning_Report_*.csv 檔案。該文件包含每個實體及其設定的成功和失敗詳情，提供全面的配置報告。

合作夥伴管理員可以在合作夥伴中心和控制中心入口網站中驗證客戶配置。請參考合作夥伴中心和控制中心入口網站中的以下插圖：

圖 8：Partner Hub

圖 9：Control Hub

圖 10：裝置

圖 11：通話

配置後限制

BroadCloud 遷移配置完成後， 下列操作將會封鎖。 :

• CAP Portal – 新增使用者或移植裝置。
• SP Portal – 建立包含設備或號碼的 ADD 訂單。
• RSB API – 建立包含設備或號碼的 ADD 訂單並建立使用者。使用設備或號碼進行的 RSB ADD 訂單將被拒絕。

對於 BroadCloud

對於 BroadCloud 合作夥伴，請使用服務提供者入口網站提交號碼、裝置和共享呼叫外觀 (SCA) 遷移的遷移請求。

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

管理員可以透過在 conf/partner.cfg 檔案中設定 ROLLBACK_TO_BROADCLOUD=true 來啟用自動回滾，這樣在遷移後裝置就會被移回 BroadCloud。它支援使用 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檔案重新運行遷移工具。

如果號碼無法斷開連接，請向 Cisco TAC 提出請求。

適用於 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. 在批發業務中建立共享呼叫外觀，以進行 BroadCloud 遷移。[This 此步驟僅適用於 BroadCloud migrations].

SCP 和 SSH

1. 使用 SCP 將裝置移動工具傳輸到輔助 Cisco BroadWorks 應用伺服器。
2. 透過 SSH 連接到輔助 Cisco BroadWorks 應用伺服器，設定先決條件並執行設備遷移工具。

必要條件

1. 在下列位置設定刷新_令牌（令牌是從令牌產生器工具複製的令牌）： conf/partner.cfg 文件：

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. 請確保輔助 Cisco BroadWorks 應用伺服器的使用者 ID、密碼和主機名稱正確無誤。 conf/deviceMoveTool.conf 文件：

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. 若要重新傳送啟動郵件，您需要設定 RESEND_INVITATION_EMAILS=true 在 conf/partner.cfg 文件。

   如果管理員希望在遷移期間向使用者發送邀請電子郵件，則應取消註釋「RESEND_INVITATION_」。 EMAILS=true" 房產 conf/partner.cfg 文件。否則，該屬性應保持不變。

4. 核實 JDK/JRE devicemove.sh 中的環境變數路徑正確

   JAVA_HOME=/usr/local/java/java_base

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

Polycom電話

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

它被設備移動工具內部使用。

Polycom電話的遷移過程：

1. 裝置移動工具會將裝置層級的檔案 %BWMACADDRESS%.cfg 替換為 polycom_vvx2.cfg。此文件引用 migration_%BWMACADDRESS%.cfg。
2. 在群組層級或設備層級重建設備設定檔。
   在群組層級或裝置層級執行操作取決於檔案中參數 deviceLevelRebuild 的配置。 device-move-tool/conf/partner.cfg.
3. 裝置遷移工具會要求 Cisco BroadWorks 應用伺服器在群組層級或裝置層級重新啟動電話。
4. 重新啟動請求發出後，Polycom 電話會下載並處理 migration_%BWMACADDRESS%% BWMACADDRESS%.cfg 文件，該文件會將 device.prov.serverName 設定為 https://plcm.sipflash.com.。
   https://plcm.sipflash.com 美國地區的網址與其他地區不同。
5. Polycom 電話從 %BWMACADDRESS%https://plcm.sipflash.com ] 下載 .cfg 文件，並將由 Webex Calling DMS 管理。

圖 14：Identity/device 設定檔類型新增

運行說明

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

設備遷移工具是從輔助 Cisco BroadWorks 應用伺服器的設備遷移工具目錄中執行的：

For device move single customer:
./devicemove.sh -input=
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=
 ls -l /tmp/directoryofcustomers/
customer1.json 
customer2.json
customer3.json
Additionally, the device move tool supports migrate single/specific phone(s) from 1.35.0 release.
Use the command below:
./devicemove.sh -integration -input=  -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

輸出

設備遷移完成後，設備已上線並準備就緒。 make/receive 電話。請參考圖 15 查看設備狀態範例：

圖 15：裝置狀態

設備遷移後，部分設備已恢復正常使用。請參考圖 16，查看哪些數字處於啟動狀態的範例：

圖 16：活躍號碼

恢復操作必須一次只針對一個企業執行。

適用於 BroadCloud 電信商

管理員可以在 ROLLBACK_TO_BROADCLOUD=trueconf/partner.cfg ] 中設定 以啟用自動回滾。使用 NS Sync 將裝置在同區域或跨區域成功遷移後返回 BroadCloud。如果遷移失敗，請在要求回溯之前聯絡 Cisco TAC。

適用於 Cisco BroadWorks 和 Webex for BroadWorks

Cisco BroadWorks 與 Webex for BroadWorks 的復原流程如下：

1. 向思科技術支援中心 (TAC) 提交工單，請求恢復設備。
2. 在輔助 BroadWorks 應用伺服器上以還原模式執行裝置移動工具，以還原裝置移轉。這將把 Cisco BroadWorks 中裝置設定檔的 DMS URL 設定回服務供應商 DMS URL，並重新啟動電話號碼。
3. Webex Calling 團隊將 Webex Calling 裝置設定檔中的 DMS URL 設定回服務提供者 DMS URL。
4. 合作夥伴管理員必須透過控制中心入口網站停用或刪除 Webex Calling 中的電話號碼。
5. 合作夥伴管理員必須將 PSTN 電話號碼移轉回 Cisco BroadWorks。

以還原模式運行設備移動工具的說明

請依照以下步驟以回滾模式運作設備移動工具：

在輔助 Cisco BroadWorks 應用伺服器的裝置行動工具目錄中執行下列命令：

恢復設定檔

./devicemove.sh -input=  -revertProfiles

恢復號碼

./devicemove.sh -input=  -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