对于 BroadCloud

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

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

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

图 6：服务提供商门户

图 7：服务提供商门户

CSV 提取请求

发起 CSV 提取请求

1. 下载客户 CSV

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

2. 编辑客户列表

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

3. 上传并提交

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

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

使用位置 CSV 发起客户提取请求

1. 选择客户和下载位置

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

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

2. 编辑位置文件

   管理员可以编辑 CSV 以仅包含他们希望提取的位置。

3. 上传并提交

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

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

发起针对所有客户的提取请求

1. 点击 提交 ，对当前服务提供商下的 所有客户 及其所有位置 发起提取请求。

适用于 Cisco BroadWorks 和 Webex 的 BroadWorks

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

下一节将解释如何安装和配置提取工具。

必要条件

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

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

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

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

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

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

   JAVA_HOME=/usr/local/java/java_base

运行说明

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

./export.sh

终端日志

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

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

输出

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

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

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

必要条件

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

1. _在_​_​_​ conf/partner.cfg 文件：

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. （可选_）在 conf/partner.cfg 文件：

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   为了更全面地验证客户电子邮件地址，您可以选择设置 PROVISIONING_ID。
3. 配置缺失的信息 input/customers.csv 如果缺失，请检查文件（请参阅下一部分）。
4. 在 input/users.csv 文件。
5. 如果需要配置新手机，请将用户新手机的 mac 地址和电子邮件地址添加到 input/newphones.csv 文件。仅当合作伙伴管理员想要在批发呼叫中配置新电话时才需要这样做。
6. 使用以下方式将 BroadWorks 呼叫中心转换为 CxEssentials input/cxessentials.csv 文件。
7. 或者，启用 UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS 属性以将所有呼叫中心转换为 CxEssentials。
8. 使用 input/locations.csv 文件支持大型企业迁移，允许管理员按位置迁移客户的位置
9. 当 Cisco BroadWorks 设备配置文件中没有 MAC 地址时，可以选择启用 SIP REGISTER 消息的 User-Agent 标头中的 MAC 地址。取消注释行“USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes" 在文件中 conf/partner.cfg
10. 网络服务器同步功能允许管理员在同一区域迁移期间配置电话号码、MAC 地址和用户电子邮件地址。要启用它，请在 conf/partner.cfg中设置 USE_NS_SYNC=yes 。

    如果禁用 NS 同步，将跳过电话号码和设备配置，用户将获得临时电子邮件地址。

11. 可选择启用属性 ANALOG_USER_TYPE_ENABLE_CALL_WAITING、ANALOG_USER_TYPE_ENABLE_MUSIC_ON_HOLD 和 ANALOG_USER_TYPE_DISABLE_T38 来配置呼叫等待、等待音乐，并为所有模拟类型用户禁用 T38 设置。

填满 input/customers.csv

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

下表解释了 input/customers.csv.

填满 input/users.csv

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

运行说明

在任何操作系统中运行转换工具。使用以下步骤在 Windows 和 macOS 中运行该工具：

Windows

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

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

macOS

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

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

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

2. 运行转换工具：

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

Customer/user 预检

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

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

预检

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

预检信息

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

终端日志

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

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

异常报告

Transform Tool 在 output/<timestamp>中生成异常报告 /exception_report.txt 目录。您可以使用此报告来识别影响迁移的问题并在 Cisco BroadWorks 系统中修复这些问题。

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

Exception Report
Tue Oct 18 08:12:09 2022

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

输出

输出 JSON (customer.json) 文件将在 output/<timestamp>中可用 /<groupid> 目录。示例 customer.json 文件如下：

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

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

必要条件

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

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

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

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

4. 使用 Webex for BroadWorks 迁移的 WEBEX4BWKS_EMAIL_SUBJECT 属性向 Webex for BroadWorks 订阅者发送更改密码请求电子邮件主题。
5. 使用 Webex for BroadWorks 迁移的 WEBEX4BWKS_EMAIL_BODY 属性向 Webex for BroadWorks 订阅者发送更改密码请求电子邮件正文。
6. 网络服务器同步功能允许管理员在同一区域迁移期间配置电话号码、MAC 地址和用户电子邮件地址。要启用它，请在 conf/partner.cfg中设置 USE_NS_SYNC=yes 。

   如果禁用 NS 同步，将跳过电话号码和设备配置，用户将获得临时电子邮件地址。

对于 BroadCloud 迁移同一区域：

1. 该工具跳过了号码、设备和共享呼叫外观的配置。
2. 该工具创建具有扩展名和临时扩展名的用户和虚拟用户。

对于 BroadCloud 迁移到另一个区域：

1. 该工具将提供号码、设备和共享呼叫外观。
2. 该工具创建具有实际电话号码和分机号的用户和虚拟用户。
   所有欧洲 BroadCloud 迁移都到另一个地区。

运行说明

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

Windows

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

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

macOS

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

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

Webex BroadWorks 迁移的先决条件

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

一旦 Webex for BroadWorks Onboarding 模板更新以支持迁移，请请求 Cisco 客户团队在合作伙伴级别启用“wholesale-partner-blending-enabled”功能切换。这将允许在配置期间将批发包添加到 BroadWorks 客户组织的现有 Webex 中。

使用附加参数运行配置工具。

准备阶段： 是默认阶段，管理员可以将 BroadWorks 用户配置为批发订户，并继续为 BroadWorks 用户提供 Webex。

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

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

终端日志

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

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

将打印一个表格，其中包含每次运行创建的位置数：

输出

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

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

图 8：Partner Hub

图 9：Control Hub

图 10：设备

图 11：呼叫

对于 BroadCloud

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

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

网络服务器同步功能允许管理员在设置 [ conf/partner.cfg中的 USE_NS_SYNC=yes 时停用 broadCloud 位置并激活 Webex Calling 位置。迁移后，设备和电话号码将在 Webex Calling 位置激活。

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

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

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

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

图 12：服务提供商门户

图 13：服务提供商门户

迁移选定位置 （可选）

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

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

图 14：将位置导出为 CSV

适用于 Cisco BroadWorks 和 Webex 的 BroadWorks

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

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

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

SCP 和 SSH

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

必要条件

1. _在 conf/partner.cfg 文件：

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   

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

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

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

   JAVA_HOME=/usr/local/java/java_base

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

Polycom 电话

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

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

Polycom 电话的迁移过程：

1. 设备移动工具将设备级别的文件 %BWMACADDRESS%.cfg 替换为 polycom_vvx2.cfg。该文件指的是 migration_%BWMACADDRESS%.cfg。
2. 在组级别或设备级别重建设备配置文件。
   作用于组级别还是设备级别取决于文件中参数deviceLevelRebuild的配置 device-move-tool/conf/partner.cfg.
3. 设备移动工具要求 Cisco BroadWorks 应用服务器在组级别或设备级别重新启动电话。
4. 重启请求后，Polycom 电话下载并处理% BWMACADDRESS%.cfg，这会要求 Polycom 电话下载并处理 migration_%BWMACADDRESS%.cfg，从而将 device.prov.serverName 设置为 https://plcm.sipflash.com.
   https://plcm.sipflash.com 对于美国地区，其他地区有不同的URL。
5. Polycom 电话从 https://plcm.sipflash.com 下载 [ %BWMACADDRESS%.cfg 并将由 Webex Calling DMS 管理。

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

运行说明

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

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

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

终端日志

成功运行设备移动工具进行设备迁移后，终端中的日志如下：

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

输出

设备迁移后，设备已上线并准备 make/receive 呼叫。参考图 15 查看设备状态的示例：

图 15：设备状态

设备迁移后，号码已激活。参考图 16 查看有效数字的示例：

图 16：活跃人数

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

对于 BroadCloud 运营商

BroadCloud 合作伙伴的恢复流程如下：

1. 向 Cisco TAC 开具一张票据，请求恢复设备。
2. 在恢复模式下运行设备移动设备工具：
   • 电话号码将从 Webex Calling 中取消分配，只为用户和服务留下分机号。
   • Webex Calling 中的电子邮件地址将恢复为临时电子邮件地址。
   • 电话将从 Webex Calling 中删除。
   • 电话号码、用作 alteredIds 的电子邮件地址和电话将在 BroadCloud 中重新创建。
   • 电话将会重新启动。
3. 合作伙伴管理员必须将 PSTN 电话号码移回 BroadCloud Carrier。

适用于 Cisco BroadWorks 和 Webex 的 BroadWorks

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

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

在恢复模式下运行设备移动工具的说明

按照以下步骤以恢复模式运行设备移动工具：

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

恢复配置文件

./devicemove.sh -input=  -revertProfiles

恢复数字

./devicemove.sh -input=  -revertNumbers

终端日志

成功运行设备移动工具进行恢复操作后，我们将在终端中获得以下日志：

恢复配置文件

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

恢复数字

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