佈建工具將自動建立支援的電話並將其指定給 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

輸出：

Tool Name: Token Generator Tool
Version: 1.13.0
Load the URL in your web browser: 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> get
enabled = true
enabledLoginLevelScreening = false
enableResponseCaching = 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 Description
========================
127.0.0.1 local as

步驟 4 ：在 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. 以 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 片段：

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

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.
   MIGRATION_MODE = Supported values are webex_for_broadworks_to_wholesale. The default value is broadworks_to_wholesale. Use webex_for_broadworks_to_wholesale for Webex for BroadWorks migrations.
   

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

5. 如果次要 Cisco BroadWorks 應用程式伺服器 JDK/JRE 環境路徑不同於 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. 設定 REFRESH_ TOKEN（從權杖產生器工具複製的權杖）和 NAME_的_主要_conf/partner.cfg 檔案中的位置：

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

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

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   若要更完整地驗證客戶電子郵件地址，您可以選擇性地設定_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 中）
10. 網路伺服器同步功能可讓管理員在同一地區移轉中佈建期間佈建電話號碼、MAC 位址和使用者電子郵件地址。若要啟用，請設定USE_NS_SYNC=yes 在conf/partner.cfg。

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

填寫輸入/customers.csv

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

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

執行指示

在任何作業系統中執行轉換工具。使用下列步驟在 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=

客戶/使用者預先檢查

轉換工具對 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 ）檔案將在輸出/<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. 下載並解壓縮移轉工具二進位檔案後，設定 JAVA_ HOME 環境變數provisioning_tool.sh（適用於 MAC 和provisioning_tool適用於 Windows 的 .bat。
3. partner.cfg 檔案：
   • 設定 Wholesale_佈建_ID 和 REFRESH_ TOKEN（從權杖產生器工具複製的權杖）。合作夥伴管理員必須聯絡其帳戶團隊以獲取_ID：

     WHOLESALE_PROVISIONING_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 訂閱者傳送變更密碼請求電子郵件內文。
6. 網路伺服器同步功能可讓管理員在同一地區移轉中佈建期間佈建電話號碼、MAC 位址和使用者電子郵件地址。若要啟用，請設定USE_NS_SYNC=yes 在conf/partner.cfg。

   如果停用 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 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 的最後階段。您必須使用參數執行佈建工具移轉後。

終端機記錄檔

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

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

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

輸出

佈建工具會在輸出/<external_id> /*.成功/錯誤 個檔案。檢閱輸出成功和錯誤日誌以驗證成功佈建。

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

圖 8：合作夥伴中心

圖 9：Control Hub

圖 10：裝置

圖 11：通話

適用於 BroadCloud

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

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

網路伺服器同步功能允許管理員在設定USE_NS_SYNC=yes 在conf/partner.cfg。移轉後，會在 Webex Calling 位置中啟用裝置和電話號碼。

管理員可以透過設定ROLLBACK_TO_BROADCLOUD=true 在conf/partner.cfg 檔案，這會在移轉後將裝置移回 BroadCloud。它支援使用 NS 同步進行相同和不同區域的移轉，但僅適用於成功的移轉。對於失敗的 TAC，管理員必須在請求還原之前提升 Cisco TAC。

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

圖 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（從權杖產生器工具複製的權杖）：

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

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 應用程式伺服器執行：

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

輸出

裝置移轉後，裝置已上線並準備好撥打/接聽電話。請參閱圖 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

終端機記錄檔

成功執行裝置移動工具以進行還原操作時，我們將在終端機中獲得以下日誌：

還原設定檔

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