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

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

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

必要条件

在计算机上安装 Java 8、11、17 或 21。Java 可以从许多来源获取，包括：

• https://learn.microsoft.com/en-us/java/openjdk/download
• https://aws.amazon.com/corretto/
• https://www.oracle.com/java/technologies/downloads/#java21

下载完成后，解压迁移工具二进制文件。

运行说明

在令牌生成器目录下的终端中运行以下命令：

Windows：

token_generator.bat

macOS：

./token_generator.sh

输出：

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

在终端的网页浏览器中打开 URL，使用合作伙伴管理员凭据登录以获取 TOKEN，并复制该 TOKEN 以备后续使用。

用户界面示意图如下所示，供您参考：

图 3：使用 Cisco Webex 登录

图 4：凭据窗口

图 5：代币生成

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

启用 OCI-P 连接

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

步骤 1: 使用命令行界面配置常规设置。

在命令行界面 (CLI) 中运行以下命令，切换到 GeneralSettings 目录：

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

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

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

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

步骤 2: 使用 CLI 配置 OCI 代理。

将目录更改为 OCI Proxy：

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

运行以下命令行界面获取当前设置。您应该看到以下内容：

AS_CLI/Applications/OpenClientServer/OCIProxy> get
enabled = true
enabledLoginLevelScreening = false
enableResponseCaching = false
responseCacheDurationHours = 24
responseCacheRenewPeriodMins = 30
messageQueueCapacity = 50
messageQueueTimeoutSeconds = 1800

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

步骤 3: 使用 CLI 配置 OCI Provisioning。

切换到 Provisioning 目录：

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

运行以下命令以获取当前的 OCI 配置设置：

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

第四步: 在命令行界面 (CLI) 中运行以下命令，以验证您的配置是否正确。

 AS_CLI/Maintenance/ManagedObjects> get broadworks and check
that your output looks OK.
See below for sample output:
AS_CLI/Maintenance/ManagedObjects> get broadworks
BroadWorks Managed Objects
==========================
* Server:
Identity..............: AS
Version...............: Rel_21.sp1_1.551
Administrative State..: Unlocked
* Applications:
Name Version Deployed Administrative State Effective State
=========================================================================================
ExecutionAndProvisioning 21.sp1_1.551 true Unlocked Unlocked
FlashPolicy 21.sp1_1.551 false Unlocked Stopped
OpenClientServer 21.sp1_1.551 true Unlocked Unlocked
WebContainer 21.sp1_1.551 true Unlocked Unlocked
4 entries found.
* Hosted Applications:
Name Version Context Path Deployed
==================================================================
CommPilot 21.sp1_1.551 / true
DeviceManagementFiles 21.sp1_1.551 /DeviceManagement true
JWSFiles 21.sp1_1.551 /FileRepos true
MediaFiles 21.sp1_1.551 /media true
OCIFiles 21.sp1_1.551 /ocifiles true
5 entries found.

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

如果尚未部署或启动，请使用以下命令在辅助应用程序服务器上部署并启动 Open Client Server。

步骤 1: 使用以下 CLI 命令部署服务器：

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

步骤 2: 使用以下命令启动服务器：

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

启用号码激活

在命令行界面 (CLI) 中执行以下命令以激活号码：

步骤 1: 运行号码激活命令：

AS_CLI> cd SubscriberMgmt/NumberActivation

步骤 2: 运行激活启用命令：

AS_CLI> set dnMode groupAndUserActivationEnabled

步骤 3: 在确认提示处，输入 Y。

对于 BroadCloud

提取工具已集成到 BroadCloud 服务提供商门户中。服务提供商管理员可以：

1. 每次请求最多可提交 50 位客户的数据提取请求。
   一天内，同一客户的提取请求不能提交超过 10 次。
2. 自请求提交之日起 28 天内，您可以下载提取的数据文件（ZIP 格式）。

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

图 6：服务提供商门户

图 7：服务提供商门户

CSV提取请求

发起 CSV 提取请求

1. 下载客户 CSV 文件

   点击 “ 发起CSV 提取请求 ”部分右上角的“下载客户 CSV ”链接。

2. 编辑客户列表

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

3. 上传并提交

   编辑完成后，上传修改后的CSV文件。

   点击 提交 以发起对所列客户及其关联位置的提取请求。

发起提取包含位置信息的客户 CSV 文件的请求

1. 选择客户和下载位置

   从下拉菜单中选择一位客户。

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

2. 编辑位置文件

   管理员可以编辑 CSV 文件，只包含他们想要提取的位置信息。

3. 上传并提交

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

   提取请求中只会包含所选客户的指定位置。

发起所有客户的提取请求

1. 点击 提交 以发起提取请求，请求内容为当前服务提供商下的所有客户 和所有位置。

适用于 Cisco BroadWorks 和 Webex for BroadWorks

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

接下来的章节将介绍如何安装和配置提取工具。

必要条件

1. 通过 SCP 将提取工具二进制文件传输到辅助 Cisco BroadWorks 应用服务器。
2. 通过 SSH 连接到辅助 Cisco BroadWorks 应用服务器，配置先决条件并运行提取工具。
3. 配置服务提供商和组 ID 以从 Cisco BroadWorks 中提取 conf/exportTool.yml. 请参考以下 YAML 代码片段示例：

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

4. 请确保辅助 Cisco BroadWorks 应用服务器的用户 ID、密码和主机名正确无误。 conf/partner.cfg 文件：

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.
   

   对于 Webex for BroadWorks 迁移， REFRESH_TOKEN 属性是必需的。

5. 修改 JDK/JRE 如果是辅助 Cisco BroadWorks 应用服务器，则需要在 export.sh 文件中指定环境路径。 JDK/JRE 环境变量路径与文件路径不同：

   JAVA_HOME=/usr/local/java/java_base

运行说明

在辅助 Cisco BroadWorks 应用服务器上，从提取工具目录运行以下命令：

./export.sh

终端日志

导出成功后，终端中会显示以下日志：运行 BroadSoft 数据导出工具：

 Running BroadSoft Data Export Tool
************************************************
Starting Export Tool v: 1.15.0
Export started for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Exporting users for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export users completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed
Export Dump Zip Directory : output/20221017223452_ExportTool
Export Dump Zip File name :extracted_data_1666060500618.zip
Zip file with the name extracted_data_1666060500618.zip has been created
ZIP file creation process completed 
Exported files converted as ZIP file
**************************************************

输出

输出的 ZIP (extracted_data_<timestamp>.zip) 文件位于同一提取工具目录中。使用以下命令查看和使用变换工具输入的 ZIP 文件：

ls –ltr
drwxr-xr-x 2 bwadmin bwadmin   4096 Oct  4 11:53 lib/
-rwxr-xr-x 1 bwadmin bwadmin 956719 Oct  4 11:53 exportTool.jar
-rwxr-xr-x 1 bwadmin bwadmin   2635 Oct  4 11:53 export.sh
drwxr-xr-x 2 bwadmin bwadmin   4096 Oct  5 05:04 conf/
drwxrwxr-x 3 bwadmin bwadmin   4096 Oct 17 22:34 output/
drwxrwxr-x 2 bwadmin bwadmin   4096 Oct 17 22:34 logs/
-rw-rw-r-- 1 bwadmin bwadmin  46341 Oct 17 22:35 extracted_data_1666060500618.zip

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

必要条件

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

1. 在以下位置设置刷新_令牌（令牌从_令牌生成器工具复制_）和主位置_名称 conf/partner.cfg 文件：

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. （可选）在以下位置设置 PROVISIONING_ID（从合作伙伴中心的模板复制）： conf/partner.cfg 文件：

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   为了更完整地验证客户电子邮件地址，您可以选择设置 PROVISIONING_ID。
3. 配置缺失的信息 input/customers.csv 文件（见下一节）缺失时。
4. 添加最终用户的电子邮件地址。 input/users.csv 文件。
5. 如果需要配置新手机，请将用户新手机的 MAC 地址和电子邮件地址添加到系统中。 input/newphones.csv 文件。只有当合作伙伴管理员想要在批发呼叫中配置新电话时才需要这样做。
6. 通过使用以下方式将 BroadWorks 呼叫中心转换为 CxEssentials： input/cxessentials.csv 文件。
7. （可选）启用 UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS 属性，将所有呼叫中心转换为 CxEssentials。
8. 使用 input/locations.csv 该文件支持大型企业迁移，允许管理员按位置迁移其客户的位置。
9. 如果 Cisco BroadWorks 设备配置文件中没有 MAC 地址，则可以选择启用从 SIP REGISTER 消息的 User-Agent 标头中使用 MAC 地址。取消注释该行 USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes 在文件中 conf/partner.cfg
10. 您可以选择启用以下属性：ANALOG_USER_TYPE_ENABLE_CALL_WAITING、ANALOG__USER_[] TYPE ENABLE_MUSIC_ON_HOLD 和 ANALOG_USER_TYPE_DISABLE_T38，以配置所有模拟类型用户的呼叫等待、保持音乐和禁用 T38 设置。

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

    此功能不适用于从 BroadCloud 到 Wholesale 的迁移。

12. 对于 BroadCloud 迁移，要将所有消息站类型为 [] 的用户转换为 voice_mail_group，请更新 conf/rialto_station_type_to_wholesale_package.csv 文件，将 批发套餐 值替换为 voice_mail_group ，其中 Rialto 站类型 为消息的行。

    （可选）在 partner.cfg 中启用 COMMON_VOICE_MAIL_GROUP_PASSCODE 属性，以配置语音邮件组的默认 PIN 码。

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

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

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

    关键配置：

    • 常用_电话_列表_至_虚拟_分机_起始_范围

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

    • 未配置 COMMON_PHONE_LIST_TO_VIRTUAL_EXENSION_START_RANGE

      共同联系人将迁移为组织联系人（组织联系人）。

      无需额外配置。

      组织层面的联系方式仍然可用。

    • 已配置 COMMON_PHONE_LIST_TO_VIRTUAL_EXENSION_START_RANGE

      共同联系人将迁移为虚拟分机。

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

      根据联系范围的不同，虚拟分机可以在组织级别和地点级别得到支持。

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

    仅当将配置了 Dubber 的用户的通话录音设置迁移到 Webex 中的 Cisco Native Call Recording 时，才需要执行此步骤。

    要启用该选项:

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

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

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

    要将特定电话号码从迁移过程中排除，必须使用转换工具按照以下两步程序进行操作：

    • 首次运行变换工具。完成后，该工具将生成一个名为 telephone_numbers_inventory.csv 的文件，该文件位于 output/timestamp/ 目录。客户需要查看此文件，并在“删除 Tn”列中对每个应从即将进行的迁移中排除的电话号码表示“是”。
    • 使用适当的排除标志更新 telephone_numbers_inventory.csv 文件后，再次执行转换工具。更新后的文件应以下列格式作为参数传递。

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

加满 input/customers.csv

文件 input/customers.csv 提供 Cisco BroadWorks 或 BroadCloud 中可能缺失的数据。如果所有必填信息都已提供，则此文件可以留空。您不必填写所有列，只有缺失的信息是必填项。

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

加满 input/users.csv

文件 input/users.csv 提供 Cisco BroadWorks 或 BroadCloud 中可能缺失的数据。如果所有必填信息都已提供，则此文件可以留空。您不必填写所有列，只有缺失的信息是必填项。

运行说明

在任何操作系统上运行转换工具。按照以下步骤在 Windows 和 macOS 系统上运行该工具：

Windows

在 Windows 系统中，执行以下命令运行转换工具：

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

MacOS

要在 macOS 上运行转换工具，请执行以下步骤：

1. 创建虚拟环境并安装依赖项，以便使用 Python 运行转换工具：

   python3 -m venv venv
   source venv/bin/activate
   python3 -m pip install requests
   python3 -m pip install requests-oauthlib
   python3 -m pip install phonenumbers
   

2. 运行转换工具：

   ./transform.sh -extract= -customers= -users= -newphones=

Customer/user 预检

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

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

预检

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

预检信息

默认情况下，异常报告中仅包含预检查错误（即会阻止配置的问题）。添加此标志还将包括成功的预检查结果（例如，如果 Webex 组织已存在，则可以自动附加）。

终端日志

转换成功后，终端会显示以下日志：

Summary Report
BroadWorks enterprises that can be successfully migrated: 1
BroadWorks enterprises that cannot be migrated: 0
BroadWorks users that can be successfully migrated: 4
BroadWorks users that cannot be migrated: 0
Phones that can be successfully migrated: 3
Phones that are not compatible with Webex Calling: 0

异常报告

转换工具会在 输出/<timestamp>内生成异常报告。 /exception_report.txt 目录。您可以利用这份报告来识别影响迁移的问题，并在 Cisco BroadWorks 系统中修复这些问题。

修改用户数据以解决异常后，使用新数据重新运行提取和转换工具。以下是异常报告示例文件：

Exception Report
Tue Oct 18 08:12:09 2022

Enterprises with Communication Barring Feature
Recommendation: manually configure the Outgoing Calling Plan in Control Hub
________________________________________________________________________________
collabmigrationtestGRP_engg

输出

输出 JSON 文件（customer.json）将位于 output/<timestamp>目录下。 /<groupid> 目录。 示例customer.json 文件内容如下：

{
    "customer": {
        "provisioningId": "!!!!!!!!!!REPLACE_WITH_PROVISIONINGID!!!!!!!!!!",
        "packages": [
            "webex_calling",
            "common_area_calling"
        ],
        "externalId": "external_id_engg_grp1",
        "address": {
            "addressLine1": "100 Main Street",
            "addressLine2": "",
            "city": "Gaithersburg",
            "stateOrProvince": "MD",
            "zipOrPostalCode": "20877",
            "country": "US"
        },
        "customerInfo": {
            "name": "Engineering Group - 1",
            "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com"
        },
        "provisioningParameters": {
            "calling": {
                "location": {
                    "name": "Main",
                    "address": {
                        "addressLine1": "100 Main Street",
                        "addressLine2": "",
                        "city": "Gaithersburg",
                        "stateOrProvince": "MD",
                        "zipOrPostalCode": "20877",
                        "country": "US"
                    },
                    "timezone": "America/New_York",
                    "language": "en_us",
                    "numbers": [
                        "+15205551101",
                        "+15205551102",
                        "+15205551103",
                        "+15205551104",
                        "+15205551105",
                        "+15205551106",
                        "+15205551107",
                        "+15205551108",
                        "+15205551109",
                        "+15205551110"
                    ],
                    "mainNumber": "+15205551101"
                }
            }
        }
    },
    "broadworks_info": {
        "service_provider_id": "collabmigrationtestSP_engg",
        "group_id": "collabmigrationtestGRP_engg"
    },
    "subscribers": [
        {
            "amareswaranvel+benjaminjack@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+benjaminjack@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Benjamin",
                        "lastName": "Jack",
                        "primaryPhoneNumber": "+15205551102",
                        "extension": "1102"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering17861@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 7861",
                        "mac": "CC98914EAAD7"
                    }
                ]
            }
        },
        {
            "amareswaranvel+lucasoliver@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+lucasoliver@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Lucas",
                        "lastName": "Oliver",
                        "primaryPhoneNumber": "+15205551103",
                        "extension": "1103"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering16821@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 6821",
                        "mac": "5486BCAE7E45"
                    }
                ]
            }
        },
        {
            "amareswaranvel+leojackson@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+leojackson@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Leo",
                        "lastName": "Jackson",
                        "primaryPhoneNumber": "+15205551104",
                        "extension": "1104"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineeringmacpc@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": []
            }
        },
        {
            "amareswaranvel+owenalex@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+owenalex@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Owen",
                        "lastName": "Alexander",
                        "primaryPhoneNumber": "+15205551101",
                        "extension": "1101"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering8811@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 8811",
                        "mac": "F87B204E4066"
                    }
                ]
            }
        }
    ],
    "auto_attendants": [],
    "call_queues": [],
    "hunt_groups": [],
    "schedules": [],
    "call_parks": [],
    "call_pickups": [],
    "paging_groups": [],
    "voice_portals": [
        {
            "name": "Automated Voice Portal",
            "firstName": "Automated",
            "lastName": "Voice Portal",
            "languageCode": "en_us",
            "phoneNumber": "+15205551105",
            "extension": "1105"
        }
    ],
    "shared_call_appearances": [],
    "business_communicator_desktop_to_upgrade_to_webex_app": [
        "PC Comm - Engg Device Profile"
    ],
    "connect_client_to_upgrade_to_webex_app": [],
    "locations": [],
"webex_for_broadworks_info": {
        "users": [
            {
                "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5"
            }
        ],
        "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg",
        "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk"
    }
}

配置工具通常可以在任何机器上运行（通常是合作伙伴的管理员笔记本电脑），并使用 Webex 公共 API。它读取转换工具输出的 JSON（customer.json）文件作为输入，并在 Webex Wholesale RTM 解决方案中配置客户、位置、号码、用户、服务和设备。

必要条件

在配置工具目录中配置以下先决条件：

1. 在计算机上安装 Java 8、11、17 或 21。Java 可以从许多来源获取，包括：
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://www.oracle.com/java/technologies/downloads/#java21
2. 下载并解压迁移工具二进制文件后，在 MAC 的 provisioning_tool.sh 文件中设置 JAVA_HOME 环境变量，在 Windows 的 provisioning_tool.bat 文件中设置 JAVA [] HOME 环境变量。
3. partner.cfg 文件：
   • 设置批发_配置_ID 和刷新_令牌（令牌从令牌生成器工具复制）。合作伙伴管理员必须联系其客户团队以获取 PROVISIONING_ID：

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • 如果合作伙伴不想向用户发送欢迎邮件，请将 ALLOW_ADMIN_INVITE_EMAILS 设置为 false。默认值为真。

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

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

4. 使用 Webex for BroadWorks 迁移的 WEBEX4BWKS_EMAIL_SUBJECT 属性，向 Webex for BroadWorks 订阅者发送更改密码请求电子邮件主题。
5. 使用 Webex for BroadWorks 迁移的 WEBEX4BWKS_EMAIL_BODY 属性，向 Webex for BroadWorks 订阅者发送更改密码请求电子邮件正文。
6. 使用 CUSTOM_TAGS 属性在创建客户后添加标签。

运行说明

请按照以下步骤在 Windows 和 macOS 系统上运行该工具：

Windows

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

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

MacOS

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

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

Webex for BroadWorks 迁移的先决条件

合作伙伴管理员必须更新其 BroadWorks 入职模板，以支持 Webex 与 BroadWorks 的共存功能。请参考下图：

一旦 Webex for BroadWorks Onboarding 模板更新为支持迁移，请请求 Cisco 客户团队在合作伙伴级别启用“wholesale-partner-blending-enabled”功能开关。这样一来，就可以在配置过程中将批发套餐添加到现有的 Webex for BroadWorks 客户组织中。

运行配置工具时添加一个附加参数。

准备阶段： 这是管理员可以将 BroadWorks 用户配置为批发订阅用户并继续使用 Webex for BroadWorks 的默认阶段。

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

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

终端日志

以下是配置成功后终端显示的日志：

Tool Name: Provisioning
Version: 1.51.0
Customer(s) provisioning started...
Sending create customer provisioning request for the External ID: customer.id.1
Customer provisioning request sent for the customer with the External ID: customer.id.1
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioning
Checking customer status for the External ID: customer.id.1 and the status is: provisioned
Provisioning customer's calling settings with External ID: customer.id.1
Customer's settings are updated successfully for the External ID: customer.id.1
Provisioning secondary locations for the customer with the External ID: customer.id.1 
Provisioning location's settings and features for the customer with the External ID: customer.id.1
Subscriber(s) provisioning will be started for the customer with the External ID: customer.id.1
Provisioning subscriber(s) and settings for the customer with External ID: customer.id.1
Subscriber(s) and settings provisioning completed for the customer with External ID: customer.id.1
Provisioning user agent settings for the customer with the External ID: customer.id.1
 
********** Completed File : input/customer.json ****************

系统将打印一张表格，列出每次运行创建的位置数量：

输出

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

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

合作伙伴管理员可以在合作伙伴中心和控制中心门户中验证客户配置情况。请参考合作伙伴中心和控制中心门户中的以下插图：

图 8：Partner Hub

图 9：Control Hub

图 10：设备

图 11：呼叫

配置后限制

BroadCloud 迁移配置完成后， 以下操作将被阻止。 :

• CAP Portal – 添加用户或移植设备。
• SP Portal – 创建包含设备或号码的 ADD 订单。
• RSB API – 创建包含设备或号码的 ADD 订单并创建用户。使用设备或号码进行的 RSB ADD 订单将被拒绝。

对于 BroadCloud

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

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

管理员可以通过在 conf/partner.cfg 文件中设置 ROLLBACK_TO_BROADCLOUD=true 来启用自动回滚，这样在迁移后设备就会被移回 BroadCloud。它支持使用 NS Sync 进行同区域和异区域迁移，但仅限于成功迁移。对于失败的操作，管理员必须先向 Cisco TAC 提出请求，然后才能请求回滚。

在门户网站中选择迁移类型时，有两种选项可供选择：

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

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

图 12：服务提供商门户

图 13：服务提供商门户

迁移选定位置 （可选）

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

要下载可用活动站点的列表，请导航至 查看客户 → 选择客户 → 将位置导出为 CSV。

图 14：导出位置为 CSV 文件

启用断开连接号码选项

当您将同一个 SIP 中继用于 Webex Calling 和 BroadCloud Carrier 时，管理员应使用 断开号码 选项。这会将电话号码从 BroadCloud 迁移后的来电接收列表中移除。

要启用此选项，

1. 在 partner.cfg 文件中，设置_DISCONNECT NUMBERS_FROM_RIALTO = 是的。
2. 使用相同的 customer.json 文件和更新后的 partner.cfg文件重新运行迁移工具。

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

适用于 Cisco BroadWorks 和 Webex for BroadWorks

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

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

1. 从 Cisco BroadWorks 中注销设备，并在 Wholesale 中重新注册。
2. 使用 UC-One 客户端的用户首次登录时将被重定向到 Webex 应用。
3. 从 Cisco BroadWorks 中停用电话号码，或从 BroadCloud 中删除电话号码。
4. 激活批发号码。
5. 在批发业务中创建共享呼叫外观，以进行 BroadCloud 迁移。[This 此步骤仅适用于 BroadCloud migrations].

SCP 和 SSH

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

必要条件

1. 在以下位置设置刷新_令牌（令牌是从令牌生成器工具复制的令牌）： conf/partner.cfg 文件：

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

3. 要重新发送激活邮件，您需要设置 RESEND_INVITATION_EMAILS=true 在 conf/partner.cfg 文件。

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

4. 核实 JDK/JRE devicemove.sh 中的环境变量路径正确

   JAVA_HOME=/usr/local/java/java_base

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

Polycom电话

要将 Polycom 电话从 Cisco BroadWorks 迁移到 Wholesale Calling，合作伙伴管理员必须创建一个新的 Identity/Device Cisco BroadWorks 中的系统级配置文件类型 每个 Polycom 设备模板。请参考图 14 并上传自定义文件 device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg. 上传新设备文件后，请确保新创建的文件存在于组级别。同时确保文件 migration_%BWMAC ADDRESS%.cfg 与系统中任何已存在的文件不冲突）。

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

Polycom电话的迁移过程：

1. 设备移动工具会将设备级别的文件 %BWMACADDRESS%.cfg 替换为 polycom_vvx2.cfg。此文件引用 migration_%BWMACADDRESS%.cfg。
2. 在组级别或设备级别重建设备配置文件。
   在组级别或设备级别执行操作取决于文件中参数 deviceLevelRebuild 的配置。 device-move-tool/conf/partner.cfg.
3. 设备迁移工具会请求 Cisco BroadWorks 应用服务器在组级别或设备级别重启电话。
4. 重启请求发出后，Polycom 电话会下载并处理 migration_%BWMACADDRESS%% BWMACADDRESS%.cfg 文件，该文件会将 device.prov.serverName 设置为 https://plcm.sipflash.com.。
   https://plcm.sipflash.com 美国地区的网址与其他地区不同。
5. Polycom 电话从 %BWMACADDRESS%https://plcm.sipflash.com ] 下载 .cfg 文件，并将由 Webex Calling DMS 进行管理。

图 14：Identity/device 配置文件类型添加

运行说明

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

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

For device move single customer:
./devicemove.sh -input=
 ./devicemove.sh -input=/tmp/customername.json
 For device move multiple customers:
./devicemove.sh -input=
 ls -l /tmp/directoryofcustomers/
customer1.json 
customer2.json
customer3.json
Additionally, the device move tool supports migrate single/specific phone(s) from 1.35.0 release.
Use the command below:
./devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9

终端日志

以下是设备迁移工具成功运行后终端中的日志：

Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started...
Valid Devices for migration :
-------------------------------------------------------------------------------------------------------------------
|    Device Type |          Mac |                                 Version |                                 Email |
-------------------------------------------------------------------------------------------------------------------
| DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com |
| DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ |  amareswaranvel+lucasoliver@gmail.com |
| DMS Cisco 8811 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ |     amareswaranvel+owenalex@gmail.com |
-------------------------------------------------------------------------------------------------------------------
Do you want to migrate all these devices? ([Y]es or [N]o) 
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Modifying profiles for Business Communicator under group collabmigrationtestGRP_engg
Activate webex phone numbers process started for customer org Id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Activate webex phone numbers process completed for customer org id : 85ea1d6f-ff9e-41a1-843f-7362aaf12b4c
Deactivate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Deactivate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Completed

输出

设备迁移完成后，设备已上线并准备就绪。 make/receive 电话。请参考图 15 查看设备状态示例：

图 15：设备状态

设备迁移后，部分设备已恢复正常使用。请参考图 16，查看哪些数字处于激活状态的示例：

图 16：活跃号码

恢复操作必须一次只针对一个企业执行。

适用于 BroadCloud 运营商

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

适用于 Cisco BroadWorks 和 Webex for BroadWorks

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

1. 向思科技术支持中心 (TAC) 提交工单，请求恢复设备。
2. 在辅助 BroadWorks 应用服务器上以还原模式运行设备移动工具，以还原设备迁移。这将把 Cisco BroadWorks 中设备配置文件的 DMS URL 设置回服务提供商 DMS URL，并重新激活电话号码。
3. Webex Calling 团队将 Webex Calling 设备配置文件中的 DMS URL 设置回服务提供商 DMS URL。
4. 合作伙伴管理员必须通过控制中心门户停用或删除 Webex Calling 中的电话号码。
5. 合作伙伴管理员必须将 PSTN 电话号码迁移回 Cisco BroadWorks。

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

请按照以下步骤以回滚模式运行设备移动工具：

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

恢复配置文件

./devicemove.sh -input=  -revertProfiles

恢复号码

./devicemove.sh -input=  -revertNumbers

终端日志

成功运行设备移动工具进行回滚操作后，终端将显示以下日志：

恢复配置文件

Tool Name: Device Move Tool
Version: 1.15.0
Device Tool Started for Revert Process...
Devices that can be moved back from Webex Calling to BroadWorks:
- -------------------------------------------------------------------------------------------------------------------
|    Device Type |          Mac |                                 Version |                                 Email |
-------------------------------------------------------------------------------------------------------------------
| DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com |
| DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ |  amareswaranvel+lucasoliver@gmail.com |
| DMS Cisco 8811 | F87B204E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b204e4066_ |     amareswaranvel+owenalex@gmail.com |
-------------------------------------------------------------------------------------------------------------------
Do you want to move back these devices from Webex Calling to BroadWorks? (Yes, Y, No, N): 
yes
Uploading Device Profiles for DMS Cisco MPP LC
Rebuild Device Process Started
Rebuild Device Process Completed Successfully
Reboot Process Started
Reboot Process Completed Successfully
Device Migration Completed for Deprovision Process

恢复号码

Tool Name: Device Move Tool
Version: 1.15.0
Do you want to continue reverting numbers to Broadworks ?  ([Y]es or [N]o): 
Y
[+15205551101, +15205551102, +15205551103, +15205551104, +15205551105, +15205551106, +15205551107, +15205551108, +15205551109, +15205551110]
Starting revert
Activate broadworks phone numbers process started for groupId : collabmigrationtestGRP_engg
Activate broadworks phone numbers process completed for groupId : collabmigrationtestGRP_engg
Device Migration Revert process Completed Successfully