受支持的电话将由配置工具自动创建并分配给在Webex呼叫中的用户。当设备移动工具运行时，在“支持设备移动工具”列中标记为“是”的电话也将自动从Cisco 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

在终端上的Web浏览器中打开URL，使用合作伙伴管理员凭据登录以获取令牌，然后复制该令牌以供进一步使用。

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

图 3：使用Cisco Webex登录

图 4：凭据窗口

图 5：令牌生成

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

启用OCI-P连接

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

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

在CLI中运行以下命令更改为GeneralSettings目录：

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

在CLI中运行以下命令以获取当前的GeneralSettings：

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

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

第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

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

第3步：使用CLI配置OCI Provisioning。

更改为Provisioning目录：

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

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

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

适用于Cisco BroadWorks和Webex for BroadWorks

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

以下部分将解释如何安装和配置提取工具。

必要条件

1. SCP提取工具二进制文件到次级Cisco BroadWorks Application Server。
2. 将SSH转至次级Cisco BroadWorks Application Server以配置先决条件并运行提取工具。
3. 配置服务提供商和组ID以从conf/exportTool.yml中的Cisco BroadWorks中提取。请参考以下示例YAML片段：

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

4. 确保conf/partner.cfg文件中次级Cisco BroadWorks应用程序服务器用户ID、密码和主机名称正确：

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

   REFRESH_TOKEN 属性对于Webex for BroadWorks迁移是强制性的。

5. 如果次级Cisco BroadWorks Application Server JDK/JRE环境路径与文件不同，请修改EXPORT.SH文件中的JDK/JRE环境路径：

   JAVA_HOME=/usr/local/java/java_base

运行说明

从提取工具目录中运行次级Cisco BroadWorks Application Server中的以下命令：

./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)文件。使用下面的命令查看并使用Transform Tool输入的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文件中设置预备_ID（从合作伙伴中心中的模板复制）：

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   要更全面地验证客户电子邮件地址，您可以选择设置预配置_ID。
3. 配置输入/customers.csv文件中的缺失信息（请参见下一部分），如果丢失。
4. 在输入/users.csv文件中添加最终用户电子邮件地址。
5. 如果要配置新电话，请将用户新电话的mac地址和电子邮件地址添加至input/newphones.csv文件。只有当合作伙伴管理员希望在批发呼叫中提供新电话时，才需要此操作。
6. 使用input/cxessentials.csv文件将BroadWorks呼叫中心转换为CxEssentials。
7. 或者，启用将_所有_呼叫中心_升级到__CX_Essentials属性，将所有呼叫中心转换为CxEssentials。
8. 使用input/locations.csv文件支持大型企业迁移，允许管理员按位置迁移客户位置
9. 在Cisco BroadWorks设备配置文件中不可用MAC地址时，可从SIP注册表消息的User-Agent头启用使用MAC地址。取消注释文件conf/partner.cfg中的“使用_MAC_地址____SIP_REGISTER=yes”中的行
10. 网络服务器同步功能允许管理员在同一区域迁移期间提供电话号码、MAC地址和用户电子邮件地址。要启用此功能，请将USE_NS_SYNC=yes 设置conf/partner.cfg。

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

填写输入/customers.csv

文件输入/customers.csv提供可能在Cisco BroadWorks或BroadCloud中丢失的数据。如果所有强制性信息都可用，则此文件可以留空。您不必填写所有列，但必须填写缺少的信息。

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

运行说明

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

Windows

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

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

macOS

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

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

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

2. 运行转换工具：

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

客户/用户预检

Transform Tool向Webex发出API呼叫，以发现潜在的配置问题。默认情况下，它将验证客户的地址和主要电子邮件。如果预设_ID值在conf/partner.cfg文件中指定，它还将验证位置信息。预检查结果包含在异常报告中。

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

预检查

除了为客户信息运行预检API外，Transform Tool还将为订阅者电子邮件运行预检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. 下载并提取迁移工具二进制文件后，在 provisioning_tool。sh for MAC和 provisioning_tool。bat for Windows中设置JAVA_HOME环境变量。
3. partner.cfg文件：
   • 设置批发_预配_ID和刷新_令牌（从令牌生成器工具复制的令牌）。合作伙伴管理员必须联系其帐户团队以获取预定_ID：

     WHOLESALE_PROVISIONING_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0
     REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 
     

   • 如果合作伙伴不想向用户发送欢迎电子邮件，则将“允许_管理员_邀请_电子邮件设置为假。默认值为TRUE。

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

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

对于BroadCloud迁移同一区域：

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

对于BroadCloud迁移，其他区域：

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

运行说明

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

Windows

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

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

macOS

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

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

Webex for BroadWorks迁移的先决条件

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

更新了Webex for BroadWorks入职模板以支持迁移后，请请求Cisco帐户团队在合作伙伴级别启用“批发-合作伙伴-混合”功能。这将允许在配置期间将批发包添加到现有Webex for BroadWorks客户组织。

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

准备阶段： 默认阶段，管理员可以将BroadWorks用户作为批发用户提供BroadWorks用户，并继续使用Webex for BroadWorks用户。

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

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

终端日志

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

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

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

输出

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

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

图 8：Partner Hub

图 9：Control Hub

图 10：设备

图 11：正在呼叫

适用于BroadCloud

对于BroadCloud合作伙伴，请使用服务提供商门户提交号码、设备和SCA迁移的迁移请求。

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

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

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

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

图 12：服务提供商门户网站

图 13：服务提供商门户网站

适用于Cisco BroadWorks和Webex for BroadWorks

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

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

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

SCP和SSH

1. SCP设备将工具移至次级Cisco BroadWorks应用程序服务器。
2. 将SSH转至次级Cisco BroadWorks应用程序服务器，以配置先决条件并运行设备移动工具。

必要条件

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

   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文件中设置RESEND_邀请_EMAILS=true。

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

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

   JAVA_HOME=/usr/local/java/java_base

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

Polycom电话

要将Polycom电话从Cisco BroadWorks移动到批发呼叫，合作伙伴管理员必须在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. 在组级或设备级重建设备配置文件。
   在组级或设备级操作取决于文件device-move-tool/conf/partner.cfg中的参数deviceLevelRebuild的配置。
3. 设备移动工具要求Cisco BroadWorks应用程序服务器在组级或设备级重新启动电话。
4. 重新启动请求后，Polycom电话下载并处理% BWMACADDRESS%。cfg，要求Polycom电话下载并处理 migration_%BWMACADDRESS%。cfg，将device.prov.serverName设置为 https://plcm.sipflash.com.
   https://plcm.sipflash.com 对于美国地区，其他地区有不同的URL。
5. Polycom电话从 %BWMACADDRESS%https://plcm.sipflash.com 下载。cfg，并将由Webex呼叫DMS管理。

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

运行说明

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

设备移动工具由设备移动工具目录中的次级Cisco BroadWorks应用程序服务器运行：

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

终端日志

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

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

输出

设备迁移后，设备已联机并准备拨打/接听呼叫。请参阅图15以查看设备状态示例：

图 15：设备状态

设备迁移后，号码已激活。请参阅图16，了解哪些数字处于活动状态的示例：

图 16：数字处于活动状态

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

适用于BroadCloud运营商

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

1. 使用Cisco TAC打开标签以请求设备恢复。
2. 在恢复模式下运行设备移动工具：
   • 电话号码将不会从Webex呼叫分配，因此用户和服务仅具有分机号。
   • Webex呼叫中的电子邮件地址将恢复为临时电子邮件地址。
   • 电话将从Webex呼叫中删除。
   • 电话号码、电子邮件地址和电话将在BroadCloud中重现。
   • 电话将重新启动。
3. 合作伙伴管理员必须将PSTN电话号码移回BroadCloud Carrier。

适用于Cisco BroadWorks和Webex for BroadWorks

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

1. 使用Cisco TAC打开标签以请求设备恢复。
2. 在次级BroadWorks Application Server上以恢复模式运行设备移动工具，以恢复设备迁移。这将将DMS URL设置回Cisco BroadWorks中的设备配置文件服务提供商DMS URL，并重新激活电话号码。
3. Webex呼叫团队将DMS URL重置为Webex呼叫中的设备配置文件中的服务提供商DMS URL。
4. 合作伙伴管理员必须通过Control Hub门户网站停用或删除Webex呼叫中的电话号码。
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