感谢您的反馈。

配置工具将自动创建支持的电话并将其分配给用户。Webex Calling 在 “设备移动 工具支持” 列中标记为 “是” 的电话也将自动从思科 BroadWorks 或 BroadCloud 移至设备移动工具运行Webex Calling 时移动。 该列中标记为 “否” 的电话需要手动 干预才能更改 Cisco BroadWorks 设备模板或电话 本身中的 DMS URL。

最后一列提供了手机型号到 文件 transform-tool/input/newphones.csv 的 “设备类型” 列的映射。 （有关 newphones.csv 的更多信息，请参阅本文 的转换工具部分）。

在 开始运行迁移工具之前，合作伙伴管理员至少运行一次此令牌生成器实用工具。 在合作伙伴 账户加入批发 RTM 解决方案后，运行此工具是一次性活动。 此工具允许合作伙伴 管理员通过 Web 浏览器登录，以获取更新迁移工具 的合作伙伴配置文件所需的唯一令牌。

先决条件

在计算机上安装 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，使用合作伙伴管理员凭据登录以获取令牌并复制该令牌以供进一步使用。

下面给出了用户界面插图以供参考：

图 3：使用以下方式登录 Cisco Webex

图 4：凭据窗口

图 5：代币生成

在 辅助 BroadWorks 服务器中运行数据提取和设备移动工具之前，请配置以下步骤。

启用 OCI-P 连接

设备移动工具通过 OCI-P 命令与 BroadWorks 通信，要启用 OC I-P 连接，请使用以下步骤：

步骤 1：使用 CLI 配置常规设置。

在 CLI 中运行以下命令以切换到常规设置目录：

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

在 CLI 中运行以下命令以获取当前的常规设置：

AS_CLI/Applications/OpenClientServer/GeneralSettings> get
clientPort = 2208
clientPortEnabled = true
secureClientPort = 2209
secureClientPortEnabled = true
systemDomain = <>

如果您的设置与上述设置不符，请使用 s et 命令重新配置您的 设置。

第 2 步：使用 CLI 配置 OCI 代理。

将目录更改为 OCI 代理：

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

如果您的设置与上述设置不符，请使用 s et 命令重新配置您的 设置。

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

验证开放客户端服务器已部署并处于活动状态

如果二级应用服务器尚未部署或尚未启动，请使用以下命令在辅助应用服务器上 部署和启动 开放客户端服务器。

步骤 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：服务提供商门户

CSV 提取请求

启动 CSV 提取 请求

1. 下载客户 CSV

   单击 “ 启动 CSV 提取请求” 部分右上角的 “下载客户 CSV” 链接。

2. 编辑客户名单

   管理员可以编辑此 CSV 文件，使其仅包括 需要为其执行数据提取的客户。

3. 上传并提交

   编辑后，上传修改后的 CSV。

   单击 “提交” 以启动对列出的客户 及其关联位置的提取请求。

向具有位置的客户发起提取请求 CSV

1. 选择客户和下载地点

   从下拉列表中选择客户。

   从 “查看 客户” → “站点” 选项卡 → “将 位置导出为 CSV” 下载相应的 locations.csv。

2. 编辑位置文件

   管理员可以编辑 CSV，使其仅包含他们想要提取的地点。

3. 上传并提交

   上传编辑后的 locations.csv，然后点击提交。

   提取请求中将仅包含所选客户的指定地点。

为所有客户发起提取请求

1. 单击 “提交”，向当前服务提供商下的所有客户 及其所有地点发起提取请求。

适用于思科 BroadWorks 和适用于 BroadWorks 的 Web

1. 提取工具在 合作伙伴网络内的辅助思科 BroadWorks 应用服务器上运行，并通过 OCI-P 连接。
2. 该工具从思科 BroadWorks 或 BroadCloud 平台提取原始企业、群组、数字、用户、服务、设备和软 客户数据，并将这些数据输出到为转换工具提供输入的 XML 文件中。

下一节说明如何安装和配置数据提取工具。

必要条件

1. SCP 将提取工具二进制文件保存到辅助 Cisco BroadWorks 应用服务器。
2. 通过 SSH 连接到辅助 Cisco BroadWorks 应用服务器以配置 先决条件并运行提取工具。
3. 在 c onf/ExportTool.yml 中配置要从思科 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.
   

   REFRESH_TOKEN 属性对于 BroadWorks 迁移的 Webex 来说是必需的。

5. 如果辅助 Cisco BroadWorks 应用服务器 JDK/JRE 环境路径与该文件不同，请修改 export.sh 文件中的 JDK/JRE 环境路径：

   JAVA_HOME=/usr/local/java/java_base

运行说明

在辅助思科 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_ .zip）文件可在同一个提取<timestamp>工具目录中找到。 使用以下命令查看和使用 转换工具输入的 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

如果管理员在公司代理后面操作该工具，请按照以下 步骤配置和执行导出脚本。

配置和执行导出脚本的步骤

1. 打开 export.sh 文件。
2. 找到 HTTPS_PROXY_HOST 变量并将其取消注释（删除前面的 #）。

3. 将 HTTPS_PROXY_HOST 值设置为：

   HTTPS_PROXY_HOST=<proxy-host>

4. 找到 HTTPS_PROXY_PORT 变量并将其取消注释（删除前面的 #）。
5. 将 HTTPS_PROXY_PORT 值设置为：

   HTTPS_PROXY_PORT=<proxy-port>

6. 保存并关闭 export.sh 文件。
7. 打开 partner.cfg 文件并添加所需的 refresh_token。
8. 验证 partner.cfg 中是否正确配置了 BroadWorks 主机、用户名和密码。
9. 运行脚本：

   ./export.sh

订婚表格：

现在，提取工具（BroadCloud和BroadWorks）在执行过程中会自动生成一个名为 SUA.xlsx 的合并 XLSX文件。 该文件预先填 充了相关工作表中的所有可用数据，有助于简化和加快 合作伙伴完成工作。

此转换工具适用于所有迁移。 转换工具可在任何计算机上运行， 包括合作伙伴的管理员笔记本电脑，并使用 Webex Public API。 它读取 提取工具输出 ZIP（extracted_data_ .zip<timestamp>）文件作为 输入，并将原始 XML 转换为配置工具使用的 JSON 格式。

先决条件

下载并解压缩迁移工具二进制文件后，配置 以下先决条件：

1. 在 conf/partner.cfg 文件中设置 REFRESH_TOKEN（从代币生成器工具复制的代币）和 NAME_OF_MAIN_LOCATION：

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. （可选）在 conf/partner.cfg 文件中设置 PROVISIONING_ID（从 Partner Hub 中的 模板复制）：

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   要更全面地验证客户 电子邮件地址，您可以选择设置 PROVISIONING_ID。
3. 如果缺失，请配置 input/customers.csv 文件中缺失的信息（参见下一节）。
4. 在 input/users.csv 文件中添加最终用户的电子邮件地址。
5. 如果要配置新电话，请将用户新手机的 mac 地址和电子邮件地址添加到 input/newphones.csv 文件中。 仅当 合作伙伴管理员想要在批发呼叫中配置新电话时，才需要这样做。
6. 使用 input/cxessentials.csv 文件将 BroadWorks 呼叫中心转换为 CxEssentials。
7. 或者，启用 UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS 属性，将所有呼叫中心转换为 CXEssentials。
8. 使用 input/locations.csv 文件支持大型企业迁移， 允许管理员按位置迁移客户的位置
9. 如果思科 BroadWorks 设备配置文件中没有 MAC 地址，则可以选择启用使用 SIP 注册消息的用户代理标头中的 MAC 地址。 取消注释 conf/partner.cfg 文件中的 use_mac_address_from_sip_register=YE S
10. 或者，启用 ANALOG_USER_TYPE_ENABLE_TYPE_ENABLE_CALL_WAITING、ANALOG_USER_TYPE_ENABLE_ON_HOLD 和 ANAL OG_USER_TYPE_DISABLE_T38 属性，为所有模拟类型用户配置呼叫等待、音乐保留和禁用 T38 设置。

11. 如果要设置通用网关设备，请将设备的 MAC 地址 和用户 ID 添加到 input/genericgateways.csv 文件中。 此外，还要提及该 用户是主要所有者还是共享用户（用于共享通话）。 仅当合作伙伴管理员计划在 批发呼叫中使用通用网关设备时，才需要这样做。

    此功能不适用于 BroadCloud 到批发的 迁移。

12. 对于 BroadCloud 迁移，要将所有具有消息站 类型的用户转换为 voice_mail_group，请更新 conf/rialto_station_type_to_wholesale_package.csv 文件，将里亚托站类型发送消息的行的批发包值替换 为 voice_mail_group。

    或者，在 partner.cfg 中启用 COMMON_VOICE_MAIL_GROUP_PASSCODE 属性，为语音邮件群组配置默认 PIN 码。

    如果未在 partner.cfg 中指定此属性，则必须在 customers.csv 文件的 commonVoiceMailGroupPasscode 列下为 每位客户提供该属性。

13. 用于将常用联系人迁移到 Webex Calling

    它是管理企业和站点级常用联系人的增强功能。 根据配置设置，这些联系人现在可以迁移为组织 联系人（组织联系人）或虚拟分机。 以下是指导您完成迁移过程的详细信息。

    密钥配置：

    • COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      partner.cfg 文件中引入了一个名为 COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE 的新 属性。 此属性决定了 如何将常用联系人从 Rialto 迁移到。Webex Calling

    • 未配置 COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_R

      常用联系人将迁移为组织 联系人（组织联系人）。

      无需额外配置。

      在组织 级别仍可访问联系人。

    • 在配置了 COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_

      常用联系人将迁移为虚拟 分机。

      每位联系人将附加一个 分机号码，分机号的起始范围在 partner.cfg 的 COMMON_PHONE_LIST_TO_VIRTUAL_EXTENS ION_START_RANGE 属性中 定义。

      组织级别和地点级别均支持虚拟分机，具体取决于联系范围 。

14. 启用 Webex 的默认通话录音供应商。

    仅当将配置为 Dubber 的用户的呼叫录音设置 迁移到 Webex 中的 Cisco 本地呼叫 录音时，才需要执行此步骤。

    要启用此选项，请执行以下操作：

    • 在 partner.cfg 文件中，设置以下属性， default_call_recording_v endor=Webex。
    • 此外，使用属性 WEBEX_CALL_RECORDING_STORAGE_REGION 来配置存储区域。

      中不 支持 BroadCloud 的按需录制选项。Webex Calling 这些通话录音设置不会迁移，将 出现在异常报告中。

15. 将选定的电话号码排除在迁移范围之外：

    要将特定的电话号码排除在迁移过程中，必须使用转换工具遵循以下 两步程序：

    • 最初是第一次执行转换工具。 完成后，该工具将生成一个名为 telephone_numbers_inventory.csv 的文件，该文件位于 输出/时间戳/目录中。 客户需要查看此 文件，并在 “Drop Tn's” 列中为应排除在即将到来的迁移之外的每个电话 号码指定 “是”。
    • 使用 相应的排除标志更新 telephone_numbers_inventory.csv 文件后，将再次 执行转换工具。 更新后的文件应按 以下格式作为参数传递。

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

16. 或者，将 ALLOW_RESTRICT_BY_PARTNER_MODE 属性设置为关，以允许 客户管理员在 Control Hub 中修改合作伙伴定义的设置。
17. 用于将手机号码（BroadWorks 移动）从 BroadCloud 迁移到 Webex Calling

    本节概述了将 BroadWorks移 动（客户手机号码）功能从 BroadCloud （移动网络集成）迁移到批发 Webex Calling（Webex Go 移动网络运营商）的情况。

    先决条件-在开始 迁移流程之前，合作伙伴管理员必须联系思科客户 团队，进行云连接 PSTN (CCP) 供应商和自定义运营商列表 (CCL) 的配置。

    在 partner.cfg 文件中添加了一个名为 ASS IGN_MOBILE_NUMBERS_TO_USERS 的新属性。 启用此属性可允许向 用户分配和迁移手机号码。

    • 此功能仅支持 BroadCloud 到批发的迁移。
    • 与BroadCloud不同，在批发Webex中，最终用户可以拥有手机 号码或PSTN号码（不能两者兼而有之）。
    • 将手机号码分配给用户后，其主 PSTN 号码将成为其次要（备用）号码。
    • 对于正在 转换为工作空间或虚拟线路的用户，无法迁移手机号码。
    • 在批发 Webex 中分配手机号码后， 它将在 Control Hub 中显示为激活。 此状态并不 意味着该号码可以立即准备接听电话。 只有在迁移完全 完成后，呼叫 功能才可用。
    • 最终用户在呼叫用户门户 (CUP) 中 配置的移动电话集成设置不会迁移。 迁移后，当拨打电话号码、手机号码或分机 号时，用户的所有设备都会响铃。

18. 要在客户迁移期间有选择地配置包裹数量限制， 请在 input/package_quantity.csv 文件中指定每个包的数量。 配置的包裹数量必须大于或等于分配给 用户/工作空间的包数量。

    目前，Webex for B roadWorks 向批发迁移不支持包数量限制。

    运行转换工具时，将更新后的文件作为输入 参数提供：。<extract_zip_file>/transform.sh-extract=-packagelimits=input/package_quantity.csv 。

19. 将多个客户的站点从 Broadworks/BroadCloud 迁移到批发中的单个客户 Webex Calling
    • T ransform 工具中引入了一种新的运行时模式——ConsolidatedMigration，以支持将多个客户站点从 B roadcloud/Broadworks 迁移到单一批发客户组织下的 Webex 批发平台。 启用此模式后，该工具会将多个客户站点 合并为一个批发客户组织

      -consolidatedMigration

    • 还有其他可选参数可以与 -ConsolidatedMigration 一起给出，例如

      -targetEnterpriseId={rialtoCustomerId | broadWorksEnterpriseId} -consolidatedExternalId={wholesaleCustomerExternalId}

    • 如果给出 了-targetEnterpriseID 且该 ID 存在于提取 工具输出文件中，则它将用于创建批发 客户组织；如果找不到 ID，则该工具将使用提取工具输出文件中的任何可用客户详细信息。
    • 如果给出了-ConsolidatedExternalID，它将为客户设置 ExternalID；如果未给出，则 该工具将退回到使用现有流程获取外部 ID。
    • <timestamp>合并的 JSON (customer.json) 文件将在 out put/ /consolidated 目录中可用。

填充 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=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

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=<Extract-Tool-Output-Zip-file> -customers=<Input-Path-Customers-CSV> -users=<Input-Path-Users-CSV> -newphones=<Input-Path-NewPhones-CSV>

客户/用户预检

转换工具向 Webex 发出 API 调用，以发现潜在的配置问题。 默认情况下，它将验证客户的地址和主电子邮件。 如果在 conf/partner.cfg 文件中指定了 PRO VISIONING_ID 值，它还将验证位置信息。 预检结果包含在异常报告中。

此外，运行转换 工具时可以添加以下可选参数：

预先检查

除了运行客户信息的预检查 API 外，转换工具还 将为订阅者电子邮件运行预检查 API。

precheckinfo

默认情况下，异常报告中仅包含 预检查错误（即会阻止配置的问题）。 添加此标志还将包括成功的预检结果 （例如，如果已经存在可以自动连接的 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

异常报告

转换工具在 output/ /exception_report.txt <timestamp>目录中生成异常报告。 您可以使用此报告来 确定将影响迁移的问题，并在 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

输出

<timestamp><groupid>输出 JSON (customer.json) 文件将在 output//目录中可用。 示例 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 Public 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 文件：
   • 设置 WHOLESA_PROVISIONING_ID 和 REFRESH_TOKEN（从代币生成器工具复制的代币）。 合作伙伴管理员必须联系其账户团队以获取 PROVISION ING_ID：

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • 如果合作伙伴不想向用户发送欢迎电子邮件，则将 SEND_SUBSCRIBERS_WELCOME_EMAIL 设置为 false。 默认值为 true。

     Webex 只会向最终用户发送欢迎邮件。客户管理员收不到欢迎邮件。

     位于美国和加拿大的用户和客户管理员会收到来自 RedSky 的单独电子邮件通知。RedSky E911 平台发送此电子邮件以确认创建紧急服务客户帐户。这封 RedSky 电子邮件与 Webex 欢迎电子邮件是分开的，不受 Webex 电子邮件设置控制。对于美国和加拿大的批发机构，RedSky 会自动启用为紧急服务提供商。

4. 使用 Webex for BroadWorks 迁移的 WEBEX 的 WEBEX4BWKS_EMAIL_SUBJECT 属性向适用于 BroadWorks 订阅者的 Webex 发送更改密码请求电子邮件主题。
5. 使用 Webex for BroadWorks 迁移的 WEBEX 的 WEBEX4BWKS_EMAIL_BODY 属性，向适用于 BroadWorks 订阅者的 Webex 发送更改密码请求电子邮件正文。
6. 创建客户后，使用 CUSTOM_ TAGS 属性添加标签。
7. 要申请批发折扣，合作伙伴管理员必须在开始迁移之前联系思科客户 团队。

   partner.cfg 中添加了一个名为 APPLY_WHOLESALE_DISCOUNTS 的新属性。 启用此属性可向用户和 工作空间应用折扣。

8. （可选）显式配置 PSTN 连接

   要为迁移期间设置的所有位置（ 包括主位置）指定 PSTN 连接，请在 partner.cfg 文件中添加以下属性：

   PSTN_CONFIGURATION=<PSTN Connection ID or exact PSTN Connection Display Name>

   如果未配置该属性或已注释掉该属性，则配置工具将使用 默认的 PSTN 连接选择过程。

运行说明

使用以下步骤 在 Windows 和 macOS 中运行该工具：

Windows

执行以下步骤 ，在 Windows 操作系统上运行该工具：

To provision single customer:
provision.bat -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
provision.bat -input=<Transform-Tool-Timestamp-Output-Directory-Path> 

macOS

执行以下步骤在 macOS 上运行该工具：

To provision single customer:
./transform.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
To provision multiple customers:
./transform.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>

Webex 进行 BroadWorks 迁移的先决条件

合作伙伴 管理员必须更新其 Webex 的 BroadWorks 入门模板才能使用 BroadWorks 共存功能。 参考下图：

更新适用于 BroadWorks 的 Webex 入门模板以 支持迁移后，请思科客户团队在合作伙伴级别启用 “启用批发合作伙伴混合” 功能。 此设置允许配置工具 在配置期间自动向现有 Webex for BroadWorks 客户添加批发软件包。

使用其他 参数运行配置工具。

准备阶段：这是默认阶段，管理员可以将 BroadWorks 用户 配置为批发订阅者，然后继续使用面向 BroadWorks 用户的 Webex。

维护阶段：是管理员 可以将批发许可证分配给现有 Webex for BroadWorks 用户的第二阶段。 必须使用参数维护来运行 配置工具。

迁移后 阶段：这是管理员可以将 BroadWorks 完全转换为批发版的最后阶段。 迁移后必须使用参数运行配置工具。

终端日志

以下是成功 配置时终 端中的日志：

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

将打印一张表格，其中包含为每次运行创建的地点数量：

输出

配置工具在 output/ /*.success/ <external_id>error 文件中生成成功和错误报告。 查看输出成功和错误 日志以验证配置是否成功。

系统将在输出/consolidated_reports/ 目录中生成 provisioning_report_*.csv 文件。 该文件包含每个实体及其设置的成功 和失败详细信息，提供全面的配置 报告。

配置工具还会在 output/consolidated_reports/ 目录中生成一个 provision ing_statistics_*. csv 文件。 此报告包含 成功和未成功配置的客户、地点、用户、设备和群组 功能的数量。

合作伙伴管理员可以在合作伙伴中心和 Control Hu b 门户中验证客户配置。 请参阅 Partner Hub 和 Control Hub 门户中的以下插图：

图 8：合作伙伴中心

图 9：控制集线器

图 10：设备

图 11：呼叫

配置后限制

BroadCloud 迁移的配置完成后，将 阻止以下操作：

• CAP 门户 — 添加用户或移植的设备。
• SP 门户 — 使用设备或号码创建 ADD 订单。
• RSB API — 使用设备或号码创建 ADD 订单并创建用户。 使用设备或号码下达的 RSB ADD 订单将被拒绝。

BroadCloud 向批发迁移 — 设备注册限制

对于将客户从同一 区域内的BroadCloud迁移到批发的合作伙伴管理员，可以在运行配置工具后在批发中添加设备。 但是，只有在相应位置的 迁移（设备移动）完成后， 这些设备才有资格注册到 Webex 平台。

此限制不适用于：

• 客户从 Broadworks/W4b 迁移到批发。
• BroadCloud 向批量迁移到不同地区。

推荐指南

为避免设备注册问题，请先完成位置级别设备迁移， 然后尝试将设备注册到 Webex 平台以进行同区域 BroadCloud 到批发迁移。

适用于BroadCloud

对于 BroadCloud 合作伙伴，使用 服务提供商门户提交号码、设备和共享 呼叫出现 (SCA) 迁移的迁移请求。

在服务提供商门户中，迁移 请求最多可以包含 50 个客户。 一 天内最多可以提交 10 个请求。

管理员可以通过在 conf/partner.cfg 文件中设置 roll back_to_broadcloud=True 来启用自动回滚，该文件将在迁移后将设备移回 BroadCloud。 它支持使用 NS Sync 进行相同和 不同区域的迁移，但仅适用于成功迁移。 对于失败 的，管理员必须Cisco TAC在请求 回滚之前提出。

有两个选项可用于在门户中选择迁移类型：

• 迁移 — 选择此选项可发起迁移号码、 设备和共享呼叫出现 (SCA) 的请求。
• 设备状态-选择此选项可在 BroadCloud 和 Calling 上查看设备的当前状态。

下图显示了服务提供商门户。

图 12：服务提供商门户

图 13：服务提供商门户

迁移 所选位置（可选）

要开始迁移 customer.json 文件中列出的特定 位置子集，请在您的请求中附上一个 locations.csv 文件。 此 CSV 应仅列出您打算迁移 的位置。

要下载可用活动站点列表，请导航至查看 客户 → 选择客户 → 以 CSV 格式导出地点。

图 14：将位置导出为 CSV

启用 “ 断开连接号码” 选项

当您为 BroadCloud 运营商使用相同的 Webex Calling SIP 中继时，管理员应使用 “断开连接号码” 选项。 这 会使电话号码在迁移到BroadCloud后无法接听来电。

要启用此选项，

1. 在 partner.cfg 文件中，将 DISCONNECT_NUMBERS_FROM_RIALTO 设置为 yes。
2. 使用相同的 cu stomer.json 文件和更新后的 partner.cfg 重新运行迁移工具。

如果号码无法断开连接，请提出 Cisco TAC 请求。

适用于思科 BroadWorks 和适用于 BroadWorks 的 Web

对于思科 BroadWorks 和 Webex for BroadWorks 迁移，该工具在合作伙伴网络中的辅助思科 BroadWorks 应用服务器 上运行，并通过 OCI-P 连接到 AS。 它使用转换工具输出 JSON (customer.json) 文件 作为输入，并运行 OCI-P 命令来迁移设备和软客户端。

成功 操作后，设备移动工具将：

1. 从思科 BroadWorks 注销设备并在 Wholesale 中注册它们。
2. 使用 UC-One 客户端的用户将在首次登录时重定向到 Webex 应用程序。
3. 停用思科 BroadWorks 的电话号码或从 BroadCloud 中删除电话号码。
4. 在批发中激活号码。
5. 在批发模式下为 BroadCloud 迁移创建共享呼叫外观。 [此步骤仅 适用于 BroadCloud 迁移]。

6. 如果管理员在公司代理后面操作该工具，请按照 以下步骤配置和执行配置脚本。

   配置程序

   1. 打开 devicemove.sh 文件。
   2. 找到 PROXY_HOST 变量并取消其注释（删除 devicemove.sh 的前导 #）。

   3. 将 PROXY_HOST 值设置为：

      PROXY_HOST=<proxy-host>

   4. 找到 PROXY_PORT 变量并取消其注释（删除 devicemove.sh 的前导 #）。

   5. 将 PROXY_PORT 值设置为：

      PROXY_PORT=<proxy-port>

   6. 请找到 PROXY_SCHEME 变量并取消其注释（删除 devicemove.sh 的前导 #）。 此步骤是可选的；如果仍保留注释，则 PROXY_SCHEME 的默认值将为 HTTP。

   7. 将 PROXY_SCHEME 值设置为：

      PROXY_SCHEME=<proxy-scheme>

   8. 保存并关闭 devicemove.sh 文件。
   9. 打开 partner.cfg 文件并添加所需的 refresh_token。
   10. 验证 partner.cfg 中是否正确配置 了 BroadWorks 主机、用户名和密码

   11. 运行脚本：

       ./devicemove.sh

SCP 和 SSH

1. SCP 将设备移动工具移至辅助 Cisco BroadWorks 应用服务器。
2. 通过 SSH 连接到辅助 Cisco BroadWorks 应用服务器以配置先决条件 并运行设备移动工具。

必要条件

1. 在 conf/partner.cfg 文件中设置 REFRESH_TOKEN（从代币生成器工具复制的代币）：

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

2. 确保 conf/ deviceMovetool.conf 文件中的辅助 Cisco BroadWorks 应用服务器用户 ID、密码和主机 名正确：

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. 要重新发送激活电子邮件，你需要在 conf/partner.cfg 文件中设置 send_subscribers_welcome_email=True。

   如果管理员希望在迁移期间向用户发送邀请电子邮件， 则应取消注释 conf/partner.cfg 文件中的 “send_subscribers_welcome_email=True” 属性。 否则，该属性应保持不变。

4. 验证 devicemove.sh 中的 JDK/JRE 环境路径是否正确

   JAVA_HOME=/usr/local/java/java_base

5. 管理员可以使用输入目录中的 locations.csv 文件来迁移 特定群组，而不是企业下的所有群组。

宝利通手机

要将 Polycom 电话从 Cisco BroadWorks 移至 Wholes ale Calling，合作伙伴管理员必须在 Cisco BroadWorks 的每个 Polycom 设备模板中创建新的 系统级身份/设备配置文件类型文件。 参考图 14 并上传自定义文件 device-move-tool/conf/devicePro file/ {region} /polycom_vvx.cfg。 上传 新设备文件后，确保新创建的文件存在于群组级别。 还要确保 文件 migration_%bwmac 地址%.cfg 不与系统中的任何现有文件冲突）。

它由设备移动工具 内部使用。

宝利通手机的迁移过程：

1. 设备移动工具将设备级别的文件 %bwmacAddress%.cfg 替换为 polycom_vvx2.cfg。 此文件指的是 migration_%bwmacAddress%.cfg。
2. 在组级别或设备级别重建设备配置文件。
   在组级别或设备级别执行操作取决于文件 device-move-tool/conf/partner.cfg 中参数 deviceLevelRebuild 的 配置。
3. 设备移动工具要求 Cisco BroadWorks 应用服务器在 组级别或设备级别重新启动电话。
4. 请求重启后，宝利通手机下载并处理% bwmacAddress%.cfg，它 要求宝利通手机下载并处理 Migration_%bwmacAddress%.cfg，它将设备.prov.ServerName 设置为 https://plcm.sipflash.com。
   https://plcm.sipflash.com 对于美国地区，其他地区的 网址不同。
5. 宝利通手机从 https://plcm.sipflash.com 下载 %bwmacAddress%.cfg，将由 DMS 管理。 Webex Calling

图 14：添加身份/设备配置文件类型文件

运行说明

有两种调用 DMT 的方法，第一种是一次通过单个客户调用，另一种是同时调 用多个客户。

设备移动工具从设备移动工具 目录中的 辅助 Cisco BroadWorks 应用服务器运行：

For device move single customer:
./devicemove.sh -input=<Transform-Tool-Output-Customer-JSON-File-Path>
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=<Transform-Tool-Timestamp-Output-Directory-Path>
 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= <Transform-Tool-Output-Customer-JSON-File-Path> -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：活跃的数字

如果管理员在公司代理后面 操作该工具，请按照以下步骤配置和执行 devicemove 脚本。

配置和执行 devicemove 脚本的步骤

1. 打开 devicemove.sh 文件。
2. 找到 HTTPS_PROXY_HOST 变量并将其取消注释（删除前面的 #）。

3. 将 HTTPS_PROXY_HOST 值设置为：

   HTTPS_PROXY_HOST=<proxy-host>

4. 找到 HTTPS_PROXY_PORT 变量并将其取消注释（删除前面的 #）。
5. 将 HTTPS_PROXY_PORT 值设置为：

   HTTPS_PROXY_PORT=<proxy-port>

6. 保存并关闭 devicemove.sh 文件。
7. 打开 partner.cfg 文件并添加所需的 refresh_token。
8. 验证 partner.cfg 中是否正确配置了 BroadWorks 主机、用户名和密码。
9. 运行脚本：

   ./devicemove.sh

一次只能对一个企业执行还原操作。

适用于BroadCloud运营商

管理员可以在 conf/partner.cfg 中设置 rollback_to_broadcloud=True 以启用自动回滚。 使用 NS Sync 在相同或跨区域成功迁移设备后，这会将设备返回到 BroadCloud。 如果 迁移失败，Cisco TAC请在请求回滚之前与其联系。

适用于思科 BroadWorks 和适用于 BroadWorks 的 Web

思科 BroadWorks 和 Webex for BroadWorks 的恢复流程如下：

1. 使用开票Cisco TAC请求设备恢复。
2. 在辅助 BroadWorks 应用程序服务器上以还原模式运行设备移动工具 ，以恢复设备迁移。 这会将思科 BroadWorks 中设备配置文件的 DMS 网址设置回服务提供商 DMS 网址，并重新激活电话号码。
3. 该Webex Calling团队将 DMS URL 设置回设备 配置文件中的服务提供商 DMS 网址。Webex Calling
4. 合作伙伴管理员必须Webex Calling 通过 Control Hub 门户停用或删除中的电话号码。
5. 合作伙伴管理员必须将 PSTN 电话号码移回思科 BroadWorks。

在还原模式下运行设备移动工具的说明

按照以下步骤在还原模式下运行设备移动工具：

在 设备移动工具目录内的辅助 Cisco BroadWorks 应用服务器中运行以下命令：

还原配置文件

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -revertProfiles

还原数字

./devicemove.sh -input= <Transform-Tool-Output-Customer-JSON-File-Path> -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