- 首頁
- /
- 文章
從 BroadWorks、Webex for BroadWorks 和 BroadCloud 過渡到 Wholesale RTM 解決方案的移轉工具
以最少的預先設定執行移轉。輕鬆執行指令。管理員 可以在佈建後檢閱其資料,並在 移轉。它支援自動升級至適用於 UC-One 的 Webex 應用程式用戶端。
概觀
本文件旨在提供有關使用工具從 Cisco BroadWorks、Webex for BroadWorks 和 BroadCloud 移轉至 Wholesale 和 Webex Calling 的詳細指示。本文件涵蓋一組移轉工具,旨在幫助將現有的 Cisco BroadWorks、Webex for BroadWorks 和 BroadCloud 客戶移轉至 Wholesale Route-to-Market 解決方案。
移轉工具旨在促進從 BroadWorks 到 Wholesale 服務的完整轉換。它們不是為在同一個客戶組織內長期共存兩種服務而設計的。
移轉影響
移轉後的影響如下:
管理員
移轉後,管理員必須:
- 開始使用 Partner Hub 和 Control Hub 而非 CommPilot 來設定功能。
- 重新設定不屬於移轉的任何功能。
在移轉工具完成後,您需要手動移轉未自動移轉的功能。
使用者
受支援的功能在移轉後的工作方式應該與移轉前相同。移轉後,必須在 Webex 上重新設定移轉不支援的 Webex Calling 功能:
- 使用者將失去其通話記錄和訊息記錄。
- 使用者將失去所有個人主要線路設定和自訂,且必須在移轉後重新設定這些設定。範例包括快速撥號。
- 使用者必須在首次登入時重設其存取碼和密碼。
- 使用 UC-One 用戶端的使用者在第一次登入時需要升級至 Webex 應用程式。
移轉工具架構
移轉工具架構包含四種不同的工具:
- 擷取工具— 從 Cisco BroadWorks 擷取企業、群組、號碼、使用者、服務、電話和軟體用戶端。BroadCloud 合作夥伴必須在服務提供者入口網站中提交擷取請求。
- 轉換工具— 將擷取工具擷取的資訊轉換為可編輯的 JSON 檔案。
- 佈建工具— 使用來自轉換工具的 JSON 輸出檔案來佈建客戶、位置、號碼、使用者、服務和電話Webex 公用 API 。
- 裝置移動工具— 使用轉換工具 JSON 輸出檔案來重建設定檔並重新啟動電話,在 Wholesale RTM 解決方案中啟動號碼,以及在 Cisco BroadWorks 中停用電話號碼。
- 此工具支援在 Cisco BroadWorks 中回復電話和軟體用戶端設定檔以及重新啟用號碼。
- BroadCloud 合作夥伴必須在服務提供者入口網站中提交移轉請求。
下圖表示四個工具如何透過與 Cisco BroadWorks 通訊、公用 API 進行通訊,以及在管理員啟動移轉任務後將指標上傳至 Webex 服務以供將來分析,從而依序運作。

圖 1. 移轉工具
需求
在執行移轉工具之前,合作夥伴必須符合下列需求:
- 合作夥伴和合作夥伴管理員帳戶必須加入 Wholesale RTM 解決方案。在預售階段,合作夥伴無需加入 Wholesale RTM 解決方案即可執行擷取工具。
- 合作夥伴必須檢查移轉前檢查清單,以確保符合所有需求。
- 需要 Cisco BroadWorks 系統管理員憑證才能執行擷取和裝置移動工具。這不適用於 BroadCloud 合作夥伴。
- 必須在維護時段期間從次要 Cisco BroadWorks 應用程式伺服器執行擷取和裝置移動工具,以將風險降至最低。BroadCloud 合作夥伴將從服務提供者入口網站執行裝置移動工具。
- 檢閱清單支援的 Webex Calling 裝置。
- 檢閱清單不受支援的 Webex Calling 裝置。
- 合作夥伴必須要求其在 Cisco 的帳戶團隊取得電話和裝置支援的韌體版本。
- UC-One 用戶端必須升級至以下版本:
- Desktop Communicator 用戶端必須為 22.9.12 版或更高版本
- Mobile Connect 用戶端必須為 3.9.14 或更高版本。
- 管理員的機器必須具有:
- 佈建工具需要 JDK/JRE 1.8。
- MAC 和 Linux 機器需要 Python 3.10.5 或更高版本才能使用轉換工具。
- 客戶必須具有有效的帳單地址,並且最終使用者必須在 Cisco BroadWorks 中設定公司電子郵件地址。如果未設定這些值,則合作夥伴管理員必須聯絡其客戶以取得這些值。在執行轉換工具之前,必須將這些詳細資料新增至 CSV(逗點分隔值)檔案。範例 CSV 檔案隨轉換工具提供。
移轉計劃
移轉計劃分為 3 個階段:
- 準備
- 使用擷取工具取得使用者資料的副本
- 使用權杖產生器工具產生權杖
- 使用轉換工具來格式化使用者資料
- 佈建
- 使用擷取工具取得最新的使用者資料
- 使用轉換工具來格式化使用者資料
- 使用佈建工具佈建使用者
- 移轉
- 使用裝置移動工具移轉裝置
- 無裝置移轉 [透過 Control Hub 啟用電話號碼]
如果合作夥伴管理員沒有要從 Cisco BroadWorks 移至 Wholesale 的裝置,則無需執行裝置移動工具。合作夥伴管理員可以使用下面的公開鏈結,直接透過 Control Hub 入口網站啟用電話號碼。有關更多資訊,請參閱在 Control Hub 中管理電話號碼。
如果合作夥伴管理員透過 Control Hub 啟用其電話號碼,則可以選擇停用 Cisco BroadWorks 中的電話號碼。
功能已自動移轉至 Wholesale Calling
這些使用者功能由移轉工具自動移轉:
- 語音留言設定和自訂問候語(語音留言、個人化名稱音訊和使用者的 PIN 碼不會移轉)
- 替代號碼
- BroadWorks Anywhere
- 忙線指示燈欄位
- 呼叫者 ID(自訂名稱和電話號碼)
- 插撥
- 呼叫轉接設定(始終轉接呼叫/忙線/無人接聽/無法接通)
- 通話攔截
- 請勿打擾
- 傳真設定
- 遠端辦公室
- 共用通話外觀
- 同時響鈴個人(包括排程和選擇性準則)
- 通話通知(包括排程和選擇性準則)
- 拒絕匿名通話
- 選擇性拒絕呼叫
- 選擇性呼叫轉接
- 導向呼叫代接和插話
- 插話豁免
- 按下以講話
- 隱私權
這些群組功能由移轉工具自動移轉:
- 自動語音應答
- 僅一層
- 自訂問候語
- 呼叫轉接設定(總是、忙線、選擇性)
- 替代號碼
- 假日功能表在 Webex 中不可用
- 選擇性拒絕呼叫
- Cisco BroadWorks Call Center Standard 和 BroadCloud 呼叫佇列:
- 基本組態
- 自訂問候語
- 代理和監督人員
- 呼叫轉接設定(總是、忙線、選擇性)
- 替代號碼
- 待話期間背景音樂
- 呼叫駐留
- 呼叫代接
- 群組搜尋
- 來電轉接設定(總是、忙線、選擇性、無法接通)
- 替代號碼
- 位置代碼(每個位置或群組一個)
- 傳呼群組
- 排程(僅限群組級別,不會移轉企業排程)
- 語音入口網站
- 待話期間背景音樂
支援的裝置
佈建工具將自動建立支援的電話並將其指定給 Webex Calling 中的使用者。當裝置移動工具執行時,「裝置移動工具支援」欄中標示為「是」的電話也將自動從 Cisco BroadWorks 或 BroadCloud 移至 Webex Calling。在該欄中標示為「否」的電話需要手動干預才能變更 Cisco BroadWorks 裝置範本或電話本身中的 DMS URL。
最後一欄提供電話機型與檔案轉換工具/輸入/newphones.csv 的「裝置類型」欄的對應。(請參閱轉換工具 有關 newphones.csv 的更多資訊)。
電話機型 |
在裝置移動工具中受支援 |
newphones.csv 中的裝置類型 |
---|---|---|
Cisco MPP 6821 |
是 |
DMS Cisco 6821 |
Cisco MPP 6841 |
是 |
DMS Cisco 6841 |
Cisco MPP 6851 |
是 |
DMS Cisco 6851 |
Cisco MPP 6861 |
是 |
DMS Cisco 6861 |
Cisco MPP 6871 |
是 |
DMS Cisco 6871 |
Cisco MPP 7811 |
是 |
DMS Cisco 7811 |
Cisco MPP 7821 |
是 |
DMS Cisco 7821 |
Cisco MPP 7832 |
是 |
DMS Cisco 7832 |
Cisco MPP 7841 |
是 |
DMS Cisco 7841 |
Cisco MPP 7861 |
是 |
DMS Cisco 7861 |
Cisco MPP 8811 |
是 |
DMS Cisco 8811 |
Cisco MPP 8832 |
是 |
DMS Cisco 8832 |
Cisco MPP 8841 |
是 |
DMS Cisco 8841 |
Cisco MPP 8845 |
是 |
DMS Cisco 8845 |
Cisco MPP 8851 |
是 |
DMS Cisco 8851 |
Cisco MPP 8861 |
是 |
DMS Cisco 8861 |
Cisco MPP 8865 |
是 |
DMS Cisco 8865 |
Cisco MPP 8875 |
是 |
DMS Cisco 8875 |
Cisco ATA191 |
是 |
DMS Cisco 191 |
Cisco ATA192 |
是 |
DMS Cisco 192 |
Polycom VVX101 |
是 |
DMS Polycom VVX101 |
Polycom VVX150 |
是 |
DMS Polycom VVX150 |
Polycom VVX201 |
是 |
DMS Polycom VVX201 |
Polycom VVX250 |
是 |
DMS Polycom VVX250 |
Polycom VVX301 |
是 |
DMS Polycom VVX301 |
Polycom VVX311 |
是 |
DMS Polycom VVX311 |
Polycom VVX350 |
是 |
DMS Polycom VVX350 |
Polycom VVX401 |
是 |
DMS Polycom VVX401 |
Polycom VVX411 |
是 |
DMS Polycom VVX411 |
Polycom VVX450 |
是 |
DMS Polycom VVX450 |
Polycom VVX501 |
是 |
DMS Polycom VVX501 |
Polycom VVX601 |
是 |
DMS Polycom VVX601 |
Polycom Trio 8300 |
是 |
DMS Polycom Trio8300 |
Polycom Trio 8500 |
是 |
DMS Polycom Trio8500 |
Polycom Trio 8800 |
是 |
DMS Polycom Trio8800 |
Polycom SoundStation 5000 |
是 |
DMS Polycom SSIP5000 |
Polycom SoundStation 6000 |
是 |
DMS Polycom SSIP6000 |
Yealink T33G |
是 |
DMS Yealink T33G |
Yealink T41S |
是 |
DMS Yealink T41S |
Yealink T42S |
是 |
DMS Yealink T42S |
Yealink T43U |
是 |
DMS Yealink T43U |
Yealink T46U |
是 |
DMS Yealink T46U |
Yealink T46S |
是 |
DMS Yealink T46S |
Yealink T48S |
是 |
DMS Yealink T48S |
Yealink T48U |
是 |
DMS Yealink T48U |
Yealink T53W |
是 |
DMS Yealink T53W |
Yealink T54W |
是 |
DMS Yealink T54W |
Yealink T57W |
是 |
DMS Yealink T57W |
Yealink T58V |
是 |
DMS Yealink T58V |
Yealink CP920 |
是 |
DMS Yealink CP920 |
Yealink CP960 |
是 |
DMS Yealink CP960 |
Yealink W52B |
是 |
DMS Yealink W52P |
Yealink W56B |
是 |
DMS Yealink W56P |
Yealink W60B |
是 |
DMS Yealink W60P |
Yealink W70B |
是 |
DMS Yealink W70P |
Yealink CP925 |
是 |
DMS Yealink CP925 |
Yealink CP965 |
是 |
DMS Yealink CP965 |
不受支援的裝置
如果客戶使用 Wholesale RTM 解決方案不支援的裝置,則這些裝置不符合移轉條件。在這種情況下,您有以下選項:
- 移轉之前,請在 Cisco BroadWorks 上佈建新電話。
- 將舊電話保留在 Cisco BroadWorks 中,使用者必須安裝 Webex 應用程式才能撥打和接聽電話。
Wholesale Calling 套件
移轉工具具有一組預設值,可用於為訂閱者選取 Wholesale Calling 套件。如果稍後需要其他套件,則可以由合作夥伴管理員在 Control Hub 中變更這些套件。
Cisco BroadWorks 移轉套件組態
從 Cisco BroadWorks 移轉的所有訂閱者將預設使用 Webex Calling 套件。如果未指定呼叫等待或語音郵件的訂閱者需要 Webex 語音套件,則可以在轉換工具的 partner.cfg 檔案中透過取消註解 USE 行來啟用此功能_WEBEX_語音_套件。
Webex for BroadWorks 移轉套件對應
Webex for BroadWorks 套件會自動對應至 Wholesale Calling 套件。這是不可設定的。
Webex for BroadWorks 套件 |
Wholesale 通話套件 |
---|---|
軟體電話 |
Webex 語音 |
基本 |
Webex Calling |
標準 |
Webex 套件 |
高級 |
Webex 套件 |
BroadCloud 移轉套件對應
根據工作站類型從 BroadCloud Carrier 對應套件移轉。可在轉換工具的組態檔 conf/ 中設定預設對映rialto_station_type_to_wholesale_package.csv。
BroadCloud 電訊廠商工作站類型 |
Wholesale 通話套件 |
---|---|
基本 |
Webex 語音 |
會議室 |
Webex 語音 |
傳訊 |
Webex 語音 |
標準 |
Webex 語音 |
主管 |
Webex 套件 |
所有其他工作站類型 |
Webex 語音 |
將 BroadWorks 或 BroadCloud 使用者帳戶轉換為 Webex Calling 工作區
Webex 工作區是許多人共用的電話,例如:例如:會議室、倉庫或大廳中的電話。此類電話可以在 Webex Calling 中設定為 Webex 工作區,而不是 Webex 使用者。提供了一個選項,可在移轉過程中自動將使用者帳戶從 Cisco BroadWorks 或 BroadCloud Carrier 轉換為工作區。
步驟:
- 在檔案中transform_tool/input/users.csv,指定「common_area 」套件,以將其轉換為工作區。
- 範例:bwuser@domain,,,common_area
- (僅適用於 BroadCloud)若要將特定工作站類型的所有使用者帳戶轉換為工作區,請將項目新增至轉換工具/conf/rialto_station_type_to_wholesale_package .csv 並將 Wholesale 套件設定為「common_area_calling 」。
- 範例:conference_room_v2,common_area_calling
- 執行轉換工具。
- 執行佈建工具。
- 開啟新建立的客戶組織的 Control Hub 並設定 SIP 網域(請參閱圖 2,在 Control Hub 中設定 SIP 網域)。
- 再次執行佈建工具。這會建立工作區並為其指定電話。
限制:
使用者功能的組態(例如,呼叫轉接、請勿打擾)不會自動移轉至工作區。

圖 2:在 Control Hub 中設定 SIP 網域
權杖產生器工具
合作夥伴管理員在開始執行移轉工具之前,至少會執行此權杖產生器公用程式一次。執行此工具是在合作夥伴帳戶加入 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
下載後,解壓縮移轉工具二進位檔案。
此步驟是可選的
執行指示
在權杖產生器目錄內的終端機中執行下列指令:
-
下列連接埠必須可用於執行權杖產生器工具。連接埠:8080、50009、50010、50011、50012 和 50013
-
在使用者的電腦中,必須至少開啟其中一個提及的連接埠以進行連線。
Windows:
token_generator.bat
MacOS:
./token_generator .sh
輸出:
工具名稱:權杖產生器工具版本:1.13.0 在 Web 瀏覽器中載入 URL:http://localhost:8080
在終端上的 Web 瀏覽器中開啟 URL,使用合作夥伴管理員認證登入以獲取令牌並複制令牌以供進一步使用。
使用者介面圖示如下所示,以供參考:
圖 3:使用 Cisco Webex 登入
圖 4:授權視窗
圖 5:權杖產生
BroadWorks 設定任務
在次要 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 服務提供者入口網站中。服務提供者管理員可以:
- 每個請求最多為 50 個客戶提交資料提取請求。一天內無法為同一客戶提交資料擷取請求超過 10 次。
- 以 ZIP 格式下載解壓縮的資料檔案,從請求提交之日起最多 28 天。
下圖顯示服務提供者入口網站。

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

圖 7:服務提供者入口網站
適用於 Cisco BroadWorks 和 Webex for BroadWorks
- 擷取工具在合作夥伴網路內的次要 Cisco BroadWorks 應用程式伺服器上執行,並透過 OCI-P 連線。
- 該工具從 Cisco BroadWorks 或 BroadCloud 平台提取原始企業、群組、號碼、使用者、服務、裝置和軟體用戶端的資料,並將此資料輸出到 XML 檔案,這些檔案為轉換工具提供輸入。
以下各節說明如何安裝和設定擷取工具。
先決條件
- 將擷取工具二進位檔案 SCP 傳送至次要 Cisco BroadWorks 應用程式伺服器。
- SSH 至次要 Cisco BroadWorks 應用程式伺服器以設定先決條件並執行擷取工具。
- 在 conf/exportTool.yml 中設定要從 Cisco BroadWorks 擷取的服務提供者和群組 ID。請參閱以下範例 YAML 片段:
服務提供者 ID-A:- GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B:- 所有
- 確保 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 移轉是必要的。 - 如果次要 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 格式。
先決條件
下載並解壓縮移轉工具二進位檔案後,請設定下列先決條件:
- 設定 REFRESH_ TOKEN(從權杖產生器工具複製的權杖)和 NAME_的_主要_conf/partner.cfg 檔案中的位置:
重新整理_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 名稱_的_主要_LOCATION=主要
- 選擇性地設定 PROVISIONING_ conf/partner.cfg 檔案中的 ID(從 Partner Hub 中的範本複制):
佈建_ID=YmE4MjFkZGYtYTlkNy00NDdlWODctYmNkOTM2NjUyYWQ1
若要更完整地驗證客戶電子郵件地址,您可以選擇性地設定_ID。 - 在 input/customers.csv 檔案中設定缺少的資訊(請參閱下一節)(如果缺少)。
- 在 input/users.csv 檔案中新增一般使用者電子郵件地址。
- 如果要佈建新電話,請將使用者新電話的 MAC 位址和電子郵件地址新增至 input/newphones.csv 檔案。僅當合作夥伴管理員想要在 Wholesale 通話中佈建新電話時,才需要這樣做。
- 使用 input/cxessentials.csv 檔案將 BroadWorks 呼叫中心轉換為 CxEssentials。
- (選用)啟用升級_全部_呼叫_中心_至_客戶體驗_ESSENTIALS 屬性,以將所有 Call Center 轉換為 CxEssentials。
- 使用 input/locations.csv 檔案來支援允許管理員依位置移轉其客戶位置的大型企業移轉
- 當 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 中最重要的欄。
欄名稱 |
規則 |
---|---|
ID |
在 Cisco BroadWorks 企業模式中:
在 BroadWorks 服務提供者模式中,這是 Cisco BroadWorks 群組 ID。 在 BroadCloud 中,這是 Rialto 客戶 ID。 |
externalId |
這是一個與合作夥伴的內部識別碼相符的識別碼。此欄在 Webex 合作夥伴組織中必須是唯一的。此欄是可選的,轉換工具將自動產生唯一識別碼。 此欄不適用於企業內的群組。 |
客戶名稱 |
對於企業,此欄用作 Webex 客戶名稱欄位。 對於企業內的群組,此欄會用作位置名稱。位置名稱在企業中必須是唯一的。 |
主要電子郵件 |
用作 Webex 客戶管理員的電子郵件地址。 對於企業內的群組,此欄是可選的。 |
「地址」欄 |
對於企業,地址用作帳單地址和第一個位置地址。 對於企業內的群組,該位址用作位置位址。 |
timezone |
請參閱本文的時區部分。 |
語言 | 請參閱Webex 支援的語言。 |
預設語音信箱固定 |
請參閱設定語音郵件 PIN 。 |
執行指示
在任何作業系統中執行轉換工具。使用下列步驟在 Windows 和 macOS 中執行該工具:
視窗
執行下列指令以在 Windows 中執行轉換工具:
轉換.bat -extract= -客戶= -使用者= -newphones=
macOS
執行下列步驟以在 macOS 上執行轉換工具:
- 建立虛擬環境並安裝相依性以使用 Python 執行轉換工具:
Python3 -m venv venv 來源 venv/bin/activate
- 執行轉換工具:
./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_for_broadworks_info ` JSON 屬性僅適用於 Webex for BroadWorks 移轉。`broadcloud_info ` JSON 內容僅適用於 BroadCloud 移轉。
佈建工具
佈建工具可以在任何機器(通常是合作夥伴的管理員膝上型電腦)上執行,並使用 Webex 公用 API。它會讀取轉換工具輸出 JSON( customer.json )檔案作為輸入,並在 Webex Wholesale RTM 解決方案中佈建客戶、位置、號碼、使用者、服務和裝置。
先決條件
在佈建工具目錄中設定下列先決條件:
- 在電腦上安裝 Java 8、11、17 或 21。可從許多來源獲取 Java,包括:
- 下載並解壓縮移轉工具二進位檔案後,設定 JAVA_ HOME 環境變數provisioning_tool.sh(適用於 MAC 和provisioning_tool適用於 Windows 的 .bat。
- partner.cfg 檔案:
- 設定 Wholesale_佈建_ID 和 REFRESH_ TOKEN(從權杖產生器工具複製的權杖)。合作夥伴管理員必須聯絡其帳戶團隊以獲取 PROVISIONING_ ID:
批發_佈建_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5nmU0 REFRESH_ TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
-
設定允許_管理員_邀請_EMAILS 為 false,如果合作夥伴不想向使用者傳送歡迎電子郵件。預設值為 true。
- 設定 Wholesale_佈建_ID 和 REFRESH_ TOKEN(從權杖產生器工具複製的權杖)。合作夥伴管理員必須聯絡其帳戶團隊以獲取 PROVISIONING_ ID:
- 使用 WEBEX4BWKS_電子郵件_Webex for BroadWorks 移轉的 SUBJECT 屬性,用於傳送 Webex for BroadWorks 訂閱者的變更密碼請求電子郵件主旨。
- 使用 WEBEX4BWKS_電子郵件_Webex for BroadWorks 移轉的 BODY 屬性,用於為 Webex for BroadWorks 訂閱者傳送變更密碼請求電子郵件內文。
對於 BroadCloud 移轉相同的地區:
- 該工具會跳過號碼、裝置和共用通話外觀佈建。
- 該工具會建立具有分機號和臨時分機號的使用者和虛擬使用者。
對於 BroadCloud 移轉,其他地區:
- 該工具將佈建號碼、裝置和共用通話外觀。
- 該工具使用實際電話號碼和分機來建立使用者和虛擬使用者。所有歐洲 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 指令以移轉裝置和軟體用戶端。
成功操作後,裝置移動工具將:
- 從 Cisco BroadWorks 取消註冊裝置並在 Wholesale 中註冊裝置。
- 使用 UC-One 用戶端的使用者將在首次登入時重新導向至 Webex 應用程式。
- 從 Cisco BroadWorks 停用電話號碼或從 BroadCloud 移除電話號碼。
- 在 Wholesale 中啟動號碼。
- 在 Wholesale 中為 BroadCloud 移轉建立共用通話外觀。[此步驟僅適用於 BroadCloud 移轉]。
SCP 和 SSH
- SCP 裝置移動工具至次要 Cisco BroadWorks 應用程式伺服器。
- SSH 至次要 Cisco BroadWorks 應用程式伺服器以設定先決條件並執行裝置移動工具。
先決條件
- 設定 REFRESH_ conf/partner.cfg 檔案中的 TOKEN(從權杖產生器工具複製的權杖):
重新整理_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
- 確保 conf/deviceMoveTool.conf 檔案中的次要 Cisco BroadWorks 應用程式伺服器使用者 ID、密碼和主機名稱正確無誤:
BroadWorks_使用者_ID = 管理員 BROADWORKS_密碼 = 管理員 BROADWORKS_主機_NAME = 本地主機
- 若要重新傳送啟用電子郵件,您需要設定 RESEND_邀請_conf/partner.cfg 檔案中的 EMAILS=true。
如果管理員希望在移轉期間向其使用者傳送邀請電子郵件,他們應該取消註解「RESEND_邀請_EMAILS=true" 屬性(在 conf/partner.cfg 檔案中)。否則,該屬性應保持不變。
- 驗證 devicemove.sh 中的 JDK/JRE 環境路徑是否正確
JAVA_ HOME=/usr/local/java/java_base
- 管理員可以使用輸入目錄中的 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 電話的移轉程序:
- 裝置移動工具會取代檔案%BWMACADDRESS%.cfg(在裝置層級)polycom_vvx 2.cfg。此檔案是指migration_%BWMACADDRESS%.cfg。
- 在群組層級或裝置層級重建裝置設定檔。在群組層級或裝置層級執行動作取決於檔案 device-move-tool/conf/partner.cfg 中參數 deviceLevelRebuild 的組態。
- 裝置移動工具會要求 Cisco BroadWorks 應用程式伺服器在群組層級或裝置層級重新啟動電話。
- 要求重新啟動後,Polycom 電話會下載並處理% BWMACADDRESS%.cfg,要求 Polycom 電話下載並處理migration_%BWMACADDRESS%.cfg,將 device.prov.serverName 設定為https://plcm.sipflash.com.https://plcm.sipflash.com 對於美國地區,其他地區具有不同的 URL。
- 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 合作夥伴的還原程序如下:
- 使用 Cisco TAC 開立報修單以請求裝置還原。
- 在還原模式下執行裝置移動工具:
- 電話號碼將從 Webex Calling 取消指定,從而僅保留具有分機號的使用者和服務。
- Webex Calling 中的電子郵件地址將還原為臨時電子郵件地址。
- 電話將從 Webex Calling 中刪除。
- 電話號碼、用作替代 ID 的電子郵件地址和電話將在 BroadCloud 中重新建立。
- 電話將重新啟動。
- 合作夥伴管理員必須將 PSTN 電話號碼移回 BroadCloud Carrier。
適用於 Cisco BroadWorks 和 Webex for BroadWorks
Cisco BroadWorks 和 Webex for BroadWorks 的還原程序如下:
- 使用 Cisco TAC 開立報修單以請求裝置還原。
- 在次要 BroadWorks 應用程式伺服器上以還原模式執行裝置移動工具,以還原裝置移轉。這會將 DMS URL 設定回 Cisco BroadWorks 中裝置設定檔的服務提供者 DMS URL,並重新啟動電話號碼。
- Webex Calling 團隊在 Webex Calling 的裝置設定檔中將 DMS URL 設定回服務提供者 DMS URL。
- 合作夥伴管理員必須透過 Control Hub 入口網站停用或刪除 Webex Calling 中的電話號碼。
- 合作夥伴管理員必須將 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 裝置移轉還原程序已成功完成
附錄
大型企業移轉
具有許多位置的大型企業無法在單個維護時段內移轉所有位置。本節所述的功能允許合作夥伴一次移轉幾個位置。
步驟
使用下列步驟為大型企業規劃分階段移轉:
- 從 BroadWorks 或 BroadCloud 擷取企業資料。
- 對擷取的資料執行不含位置選項的轉換工具。
- 尋找建議同時移入的位置區段exception_report.txt 以計劃移轉階段以獲取有關位置相依性的更多資訊,請檢查功能代理清單檔案(請參閱下面的轉換工具)。
- 透過修改來產生 input/locations.csvlocations_to_be_edited .csv。
- 使用位置選項再次執行轉換工具。
- 檢查exception_report.txt 以識別目前階段的任何位置相依性問題。
- 根據需要修正位置相依性問題(透過修改 locations.csv)。
- 重新執行轉換工具以產生目前階段的customers.json。
- 為每個 customer.json 執行佈建工具。
- 在維護時段內,執行裝置移動工具。
- 對下一個階段重複步驟 4 - 10。
轉換工具
為了達到逐步移轉大型企業中的位置的目標,如上所述,新檔案位置.csv 新增為選用輸入( -locations=輸入/locations.csv )(在執行轉換工具時)。
location.csv 包含特定於位置的資料。它會覆寫在 input/customers.csv 中找到的資料,該資料目前包含企業資料和位置資料。
下表列出了位置.csv :
說明 |
值 |
預設值 |
強制 |
BroadWorks 中的對應 |
BroadCloud 中的地圖 | |
---|---|---|---|---|---|---|
企業 ID |
唯一企業 ID |
是 |
服務提供者 ID |
Rialto 客戶 ID | ||
位置 ID |
位置 ID,在企業中是唯一的 |
是 |
群組 ID |
Rialto 網站 ID | ||
移轉狀態 |
此位置是否已移轉? |
已移轉,dont_migrate ,正在移轉 |
移轉 |
否 | ||
名字 |
此位置的名稱。 將其保留為空以使用 locationId。 |
否 | ||||
timezone |
否 | |||||
語言 |
否 | |||||
address1 |
否 | |||||
address2 |
否 | |||||
城市 |
否 | |||||
state |
否 | |||||
郵遞區號 |
郵遞區號 |
否 | ||||
國家 |
2 個字母的代碼 |
否 |
可以從預先填寫的locations_to_be_edited.csv(在大型企業上執行轉換工具時)。進一步閱讀以查看範例。
執行轉換工具時,locations.csv 是可選輸入,因此如果選項 -locations=input/locations.csv 不存在,則轉換工具的行為將與以前相同。
新的輸出檔案
轉換工具有 5 個新的輸出檔案:
- locations_to_be_edited.csv – 預先填入要移轉的大型企業的所有位置資訊。
範例:
locationId,enterpriseId,移轉狀態,名稱,時區,語言,address1,address2,城市,州/省,郵遞區號,國家auto_mig_ent_grp1,auto_mig_ent ,,auto_mig_ent_grp 1,,,100 Main Street,,蓋瑟斯堡,MD,20877,USauto_mig_ent_grp 2、auto_mig_ent ,,auto_mig_ent_grp 2,,,101 Main Street,,蓋瑟斯堡,MD,20877,美國auto_mig_ent_grp3、auto_mig_ent ,,auto_mig_ent_grp 3,,,102 Main Street,,蓋瑟斯堡,MD,20877,US
合作夥伴/客戶可以使用它來產生位置.csv,以控制特定階段要移轉的位置(並根據需要更新位置的資訊)。
範例:位置.csv 從上述產生locations_to_be_edited.csv
locationId,enterpriseId,移轉狀態,名稱,時區,語言,address1,address2,城市,州/省,郵遞區號,國家auto_mig_ent_grp1,auto_mig_ent ,已移轉,auto_mig_ent_grp 1,,,100 Main Street,,蓋瑟斯堡,MD,20877,USauto_mig_ent_grp 2、auto_mig_ent ,移轉,auto_mig_ent_grp 2,,,101 Main Street,,蓋瑟斯堡,MD,20877,美國auto_mig_ent_grp3、auto_mig_ent ,dont_migrate ,auto_mig_ent_grp 3,,,102 Main Street,,蓋瑟斯堡,MD,20877,US
這位置.csv表示:此階段,位置auto_mig_ent_grp1 個已移轉,位置auto_mig_ent_grp2 正在移轉,且不移轉位置auto_mig_ent_grp3.
- hunt_group_agents.csv ,call_center_agents_supervisors .csv ,paging_group_originators_targets .csv ,blf_monitored_elements .csv – 4 個檔案具有相同用途:產生對應功能agents/supervisors/originator/targets/的完整清單monitored_elements (如果移轉位置對其他位置具有相依性)。
它們具有幾乎相同的格式(第三欄名稱因功能而異),如下所示(auto_mig_ent_grp 2 的上述階段的群組搜尋代理清單):
範例:以下內容來自hunt_group_agents.csv
功能名稱,功能位置,代理,位置 Sarah Rodriguez,auto_mig_ent_grp 2、agent_michael @domain.com,auto_mig_ent_grp 1 Sarah Rodriguez,auto_mig_ent_grp 2、agent_sally @domain.com,auto_mig_ent_grp 1
如果執行轉換工具時位置選項不存在,則上述 4 個檔案將產生搜尋群組/呼叫中心/呼叫群組/忙線燈欄位的代理/監督員/發起者/目標/的完整清單。monitored_elements 適用於整個企業,可用於規劃分階段移轉。
中的新區段 exception_report
為大型企業執行分階段移轉時,將有一些新的區段exception_report.txt 是否存在未滿足的位置相依性。
範例:以下新區段適用於位置auto_mig_ent_grp位置中有 2 個群組搜尋 Sarah Rodriguez 的代理auto_mig_ent_grp3 個未移轉且不會在此階段移轉的項目。
位置之間的相依性 - 群組搜尋 名稱 位置 代理 代理的位置 註釋________________________________________________________________________________________________________________ 薩拉·羅德里格茲auto_mig_ent_grp2agent_william @domain.comauto_mig_ent_grp尚未移轉位於不同位置的 3 個代理 Sarah Rodriguezauto_mig_ent_grp 2agent_melody @domain.comauto_mig_ent_grp尚未移轉位於不同位置的 3 個代理
以下新增章節就如何在移轉階段對位置進行分組提出建議。
建議同時移動的位置:
位置auto_mig_ent_grp1 個依賴於位置auto_mig_ent_grp2、auto_mig_ent_grp 3 位置auto_mig_ent_grp2 依賴於位置auto_mig_ent_grp3
如果在執行轉換工具時位置選項不存在,建議同時移動的位置部分會列出所有位置相依性,以便為規劃提供便利。
使用位置選項(即,對於移轉階段)執行轉換工具時,建議同時移動的位置部分僅列出當前階段的位置相依性。
佈建工具
對於大型企業,佈建工具可以照常執行。
裝置移動工具
裝置移動工具可以針對 customer.json 中的位置子集執行。以新增具有兩欄的新的選用 locations.csv 檔案來實現此目的。
External_id |
位置名稱 |
---|---|
外部 ID 值 |
位置名稱/群組名稱 |
- 這是一個選用檔案,如果未提供或提供了空值,它將移轉所有位置。
- 如果提供了位置名稱及其各自的external_Id,則只會移轉那些位置。
指令如下:
./devicemove.sh -input=<input_path >/customer.json -locations=<input_path >/Location_names .csv
時區
美國:
"timeZones":["America/Adak","America/Anchorage","America/Chicago","America/Denver","America/Los_安吉利斯","美洲/北美洲ew_約克","美洲/鳳凰城","太平洋/檀香山"]
加拿大:
"timeZones":["美洲/日awson_小溪","美洲/埃德蒙頓","美洲/哈利法克斯","美洲/蒙特利爾","美洲/雷吉納","美洲/南t_Johns","美洲/溫哥華","美洲/溫尼伯"]
澳洲:
"timeZones":["Australia/Adelaide","Australia/Brisbane","Australia/Broken_ Hill","澳洲/達爾文","澳洲/霍巴特","澳洲/Lord_豪","澳洲/珀斯","澳洲/雪梨"]
法國:
"timeZones":["歐洲/巴黎"]
葡萄牙:
"timeZones":["Atlantic/Azores","歐洲/里斯本"]}
英國:
"timeZones":["歐洲/倫敦"]
義大利:
"timeZones":["歐洲/羅馬"]