對於 BroadCloud

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

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

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

圖 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 的 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 公共 API。它讀取提取工具輸出 ZIP（extracted_data_<timestamp>.zip）檔案作為輸入，並將原始 XML 轉換為配置工具使用的 JSON 格式。

先決條件

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

1. _<a id="x2"><a id="x3"><a id="x4">在</a></a></a> conf/partner.cfg 文件：___

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. （可選_）在 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. 網路伺服器同步功能可讓管理員在同一區域遷移期間設定電話號碼、MAC 位址和使用者電子郵件位址。要啟用它，請在 conf/partner.cfg中設定 USE_NS_SYNC=yes 。

    如果停用 NS 同步，將跳過電話號碼和裝置配置，使用者將獲得臨時電子郵件地址。

11. 可選擇啟用屬性 ANALOG_USER_TYPE_ENABLE_] CALL_WAITING、ANALOG_USER_] TYPE_ENABLE_MUSIC_ON_HOLD 和 ANALOG_USER_TYPE_DISABLE [] ON [] HOLD 和 ANALOG [] USER [] TYPE [] DISABLE_等待 T38 配置並呼叫所有模擬類型。

填滿 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 呼叫以捕獲潛在的配置問題。預設情況下，它將驗證客戶的地址和主要電子郵件。_如果在 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

異常報告

Transform Tool 在 output/<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 和 Windows 的 provisioning_tool.bat 中設定 JAVA_HOME 環境變數。
3. partner.cfg 檔案：
   • 設定 WHOLESALE_PROVISIONING_ID 和 REFRESH_TOKEN（從令牌產生器工具複製的令牌）。合作夥伴管理員必須聯絡其客戶團隊以取得 PROVISIONING_ID：

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=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 訂閱者發送更改密碼請求電子郵件正文。
6. 網路伺服器同步功能可讓管理員在同一區域遷移期間設定電話號碼、MAC 位址和使用者電子郵件位址。要啟用它，請在 conf/partner.cfg中設定 USE_NS_SYNC=yes 。

   如果停用 NS 同步，將跳過電話號碼和裝置配置，使用者將獲得臨時電子郵件地址。

對於 BroadCloud 遷移同一區域：

1. 該工具跳過了號碼、裝置和共享呼叫外觀的配置。
2. 該工具創建具有擴展名和臨時擴展名的用戶和虛擬用戶。

對於 BroadCloud 遷移到另一個區域：

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

運行說明

使用下列步驟在 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 BroadWorks 遷移的先決條件

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

一旦 Webex for BroadWorks Onboarding 範本更新以支援遷移，請要求 Cisco 客戶團隊在合作夥伴層級啟用「wholesale-partner-blending-enabled」功能切換。這將允許在配置期間將批發包新增至 BroadWorks 客戶組織的現有 Webex 中。

使用附加參數運行配置工具。

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

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

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

終端日誌

以下是成功配置後終端機中的日誌：

Tool Name: Provisioning Tool
Version: 1.15.0
 
********** Started Processing File : input/customer.json ****************
 
Provisioning Customer
Waiting for customer external_id_engg_grp1 to complete provisioning...
Waiting for customer external_id_engg_grp1 to complete provisioning...
 
Customer external_id_engg_grp1 status : provisioned
Provisioning Numbers
Provisioning Users
Provisioning User Features
Provisioning Greetings
Provisioning Schedules
Provisioning Devices
Provisioning Shared Call Appearances
Provisioning Auto Attendants
Provisioning Call Queues
Provisioning Hunt Groups
Provisioning Group Pagings
Provisioning Call Parks
Provisioning Call Pickups
Provisioning Voice Portal
 
********** Completed File : input/customer.json ****************

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

輸出

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

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

圖 8：Partner Hub

圖 9：Control Hub

圖 10：裝置

圖 11：通話

對於 BroadCloud

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

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

網路伺服器同步功能允許管理員在設定 [ conf/partner.cfg中的 USE_NS_SYNC=yes 時停用 broadCloud 位置並啟動 Webex Calling 位置。遷移後，設備和電話號碼將在 Webex Calling 位置啟動。

管理員可以透過在 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

適用於 Cisco BroadWorks 和 Webex 的 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 遷移。[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 文件。

   如果管理員希望在遷移期間向其使用者發送邀請電子郵件，則應取消註釋「重新發送_邀請_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 電話下載並處理% BWMACADDRESS%.cfg，這會要求 Polycom 電話下載並處理 migration_%BWMACADDRESS%.cfg，從而將 device.prov.serverName 設定為 https://plcm.sipflash.com.
   https://plcm.sipflash.com 對於美國地區，其他地區有不同的URL。
5. Polycom 電話從 https://plcm.sipflash.com 下載 [ %BWMACADDRESS%.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 營運商

BroadCloud 合作夥伴的復原流程如下：

1. 向 Cisco TAC 開立一張票據，請求恢復設備。
2. 在恢復模式下運行設備移動設備工具：
   • 電話號碼將從 Webex Calling 中取消分配，只為使用者和服務留下分機號碼。
   • Webex Calling 中的電子郵件地址將恢復為臨時電子郵件地址。
   • 電話將從 Webex Calling 中刪除。
   • 電話號碼、用作 alteredIds 的電子郵件地址和電話將在 BroadCloud 中重新建立。
   • 電話將會重新啟動。
3. 合作夥伴管理員必須將 PSTN 電話號碼移回 BroadCloud Carrier。

適用於 Cisco BroadWorks 和 Webex 的 BroadWorks

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 應用程式伺服器中執行以下命令：

恢復設定檔

./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