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

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

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

必要条件

下载后，提取迁移工具二进制文件。

在 token_generator。sh for MAC和 token_generator。bat for Windows中设置JRE/JDK环境路径。如果JAVA_HOME路径已存在，则该工具将重复使用。

• mac：Java_HOME="/Users/cisco/jdk/zulu@1.8.282/Contents/Home/"

• Windows：JAVA_HOME=C：\ a~1\Java\jre1.8.0_321

运行说明

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

Windows：

token_generator.bat

macOS：

。/token_generator。sh

输出：

工具名称：令牌生成器工具版本：1.13.0在网络浏览器中加载URL：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 /应用程序/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 /应用程序/OpenClientServer/OCIProxy

运行以下CLI以获取当前设置。您应该看到以下内容：

AS_CLI/Applications/OpenClientServer/OCIProxy> get enabled = true enabledLoginLevelScreening = false enabledResponseCaching = 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> 获取地址描述 ======================== 127.0.0.1本地为 

第4步：在CLI中运行以下命令以验证您的配置是否正确。

 AS_CLI/Maintenance/ManagedObjects>获取广播，并检查输出是否正常。有关样本输出，请参见下文：AS_CLI/维护/ManagedObjects> get broadworks BroadWorks Managed Objects ========================== *服务器：身份..............: AS版本...............: Rel_21.sp1_1.551行政国家……：已解锁*应用程序：名称版本已部署的管理状态有效状态 ========================================================================================= 执行和配置21.sp1_1.551真正解锁已解锁FlashPolicy 21.sp1_1.551 false解锁已停止OpenClientServer 21.sp1_1.551真正未锁定未锁定WebContainer 21.sp1_1.551真正解锁已找到4个条目。 *托管应用程序：名称版本上下文路径已部署 ================================================================== 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条条目。 

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

如果未部署或尚未启动，请使用下面的命令在辅助应用程序服务器上部署并启动打开客户端服务器。

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

AS_CLI/Maintenance/ManagedObjects> 部署应用程序OpenClientServer

第2步：使用此命令启动服务器：

AS_CLI/Maintenance/ManagedObjects> 启动应用程序OpenClientServer

启用数字激活

在CLI中执行以下命令以启用数字激活：

第1步：运行号码激活命令：

AS_CLI> CD订阅者Mgmt/Number激活

第2步：运行启用激活的命令：

AS_CLI>设置dnMode groupAndUserActivation

第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片段：

   服务提供者ID-A：- GroupID-A1 - GroupID-A2 - GroupID-A3服务供应商ID-B：-全部 

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

   BROADWORKS_用户_ID =管理员BROADWORKS_密码=管理员BROADWORKS_主持人_姓名=本地主持人刷新_令牌=从令牌生成器工具复制的合作伙伴管理员刷新令牌。迁移_模式=支持的值为webex_for_broadworks_to_wholesale。默认值为 broadworks_to_wholesale。使用 webex_for_broadworks_to_wholesale for Webex for BroadWorks迁移。 

   刷新_令牌 属性对于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数据导出工具：

 运行BroadSoft数据导出工具 ************************************************ 开始导出工具v：1.15.0已为SP=collabmigrationtestSP_engg、Group=collabmigrationtestGRP_engg 导出SP=collabmigrationtestSP_engg、Group=collabmigrationtestGRP_engg 已导出SP=collabmigrationtestSP_engg、Group=collabmigrationtestGRP_engg 已导出SP=collabmigrationtestSP_engg、Group=collabmigrationtestGRP_engg 已导出Dump Zip目录：输出/20221017223452_ExportTool Export Dump Zip文件名：extracted_data_1666060500618.zip Zip文件的名称extracted_data_1666060500618.zip已创建ZIP文件创建过程完成导出文件转换为ZIP文件************************************************** 

输出

在同一提取工具目录中将提供输出ZIP (extracted_data_。zip)文件。使用下面的命令查看并使用Transform Tool输入的ZIP文件：

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

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

必要条件

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

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

   刷新_令牌=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj_NAME__LOCATION=Main

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

   配置_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”中的行

填写输入/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安装请求python3 -m pip安装请求-oauthlib 

2. 运行转换工具：

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

客户/用户预检

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

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

预检查

除了为客户信息运行预检API外，Transform Tool还将为订阅者电子邮件运行预检API。

预检查信息

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

终端日志

终端中关于成功转换的以下日志：

可成功迁移的BroadWorks企业：1个无法迁移的BroadWorks企业：0个可以成功迁移的BroadWorks用户：4个无法迁移的BroadWorks用户：0个可以成功迁移的电话：3个与Webex呼叫不兼容的电话：0 

异常报告

转换工具在输出//exception_report。txt 目录中生成异常报告。您可以使用此报告来确定将影响迁移的问题，并在Cisco BroadWorks系统中解决这些问题。

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

异常报告星期二10月18日08：12：09,2022有通信禁止功能的企业建议：在Control Hub中手动配置出站呼叫计划________________________________________________________________________________ 协作migrationtestGRP_engg 

输出

输出JSON (customer.json)文件将在输出// 目录中可用。样品 customer.json 文件如下：

{ "customer"： { "provisioningID"： "!!!!!!!!!!替换_与_PROVISIONINGID!!!!!!!!!!", "包"： [ "webex_calling"， "common_area_calling" ]， "externalId"： "external_id_engg_grp1"，"地址"：{"addressLine1"："100 Main Street"，"addressLine2"：""，"city"："盖瑟斯堡"，"stateOrProvince"："MD"，"zipOrPostalCode"："20877"，"country"："US" }，"customerInfo"：{"name"："Engineering Group - 1"，"primaryEmail"："amareswaranvel+engineeringgroup1@gmail.com" }，"provisioningParameters"：{"calling"：{"location"：{"name"："Main"，"address"：{"addressLine1"："100 Main Street"，"addressLine2"：""，"city"："Gaithersburg"，"stateOrProvince"："MD"，"zipOrPostalCode"："20877"，"time zone"："America/N"ew_约克”，“语言”：“en_us"、"号码"： [ "+15205551101"、 "+15205551102"、 "+15205551103"、 "+15205551104"、 "+15205551105"、 "+15205551106"、 "+15205551107"、 "+15205551108"、 "+15205551109"、 "+15205551110"]、"主号"： "+15205551101" } } } ， "broadworks_info"： { "service_provider_id"："collabmigrationtestSP_engg"， "group_id"："collabmigrationtestGRP_engg" }， "订阅者"： [ { "amareswaranvel+benjamin injack@gmail.com"： { "subscriber"： { "customerId"： "!!!!!!!!!!替换_与_自定义!!!!!!!!!!",“电子邮件”：“amareswaranvel+benjaminjack@gmail.com”，“包装”：“webex_calling"， "provisioningParameters"： { "firstName"： "Benjamin"， "lastName"： "Jack"， "primaryPhoneNumber"： "+15205551102"， "extension"： "1102" } }， "features"： [ { "/v1/people/{personId}/features/voicemail"： {"enabled"：true，“sendBusyCalls”： {“enabled”：true，“问候”：“默认” }，“sendUnansweredCalls”： {“enabled”：true，“问候”：“默认”，“numberOfRings”：3 }， "messageStorage"： { "mwiEnabled"：true，“storageType”：“EXTERNAL”，“externalEmail”：“engineering17861@mailnator.com” } } } ]，“devices”： [ {"cisUuid"： "!!!!!!!!!!替换_与_个人标识号!!!!!!!!!!",“产品”：“DMS Cisco 7861”，“mac”：“CC98914EAAD7” } ] } }，{“amareswaranvel+lucasoliver@gmail.com”：{“订阅者”：{“customerId”： "!!!!!!!!!!替换_与_自定义!!!!!!!!!!",的“电子邮件”：“amareswaranvel+lucasoliver@gmail.com”，“包装”：“webex_calling"， "provisioningParameters"： { "firstName"： "Lucas"， "lastName"： "Oliver"， "primaryPhoneNumber"： "+15205551103"， "extension"： "1103" } }， "features"： [ { "/v1/people/{personId}/features/voicemail"： {"enabled"：true，“sendBusyCalls”： {“enabled”：true，“问候”：“默认” }，“sendUnansweredCalls”： {“enabled”：true，“问候”：“默认”，“numberOfRings”：3 }， "messageStorage"： { "mwiEnabled"：true，“storageType”：“EXTERNAL”，“externalEmail”：“engineering16821@mailnator.com” } } } ]，“devices”： [ {"cisUuid"： "!!!!!!!!!!替换_与_个人标识号!!!!!!!!!!",“产品”：“DMS Cisco 6821”，“mac”：“5486BCAE7E45” } ] } }，{“amareswaranvel+leojackson@gmail.com”：{“订阅者”：{“customerId”： "!!!!!!!!!!替换_与_自定义!!!!!!!!!!",“电子邮件”：“amareswaranvel+leojackson@gmail.com”，“包装”：“webex_calling"， "provisioningParameters"： { "firstName"： "Leo"， "lastName"： "Jackson"， "primaryPhoneNumber"： "+15205551104"， "extension"： "1104" } }， "features"： [ { "/v1/people/{personId}/features/voicemail"： {"enabled"：true，“sendBusyCalls”： {“enabled”：true，“问候”：“默认” }，“sendUnansweredCalls”： {“enabled”：true，“问候”：“默认”，“numberOfRings”：3 }， "messageStorage"： { "mwiEnabled"：true，“storageType”：“EXTERNAL”，“externalEmail”：“engineeringmacpc@mailnator.com” } } } ]，“devices”： [] } }，{“amareswaranvel+owenalex@gmail.com”： {“subscriber”： {“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，“问候”：“默认” }，“sendUnansweredCalls”： {“enabled”：true，“问候”：“默认”，“numberOfRings”：3 }， "messageStorage"： { "mwiEnabled"：true，“storageType”：“EXTERNAL”，“externalEmail”：“engineering8811@mailnator.com” } } } ]，“devices”： [ {"cisUuid"： "!!!!!!!!!!替换_与_个人标识号!!!!!!!!!!", "产品"： "DMS Cisco 8811"， "mac"： "F87B  E4066" } ] } } ]， "auto_attendants"： []， "call_queues"： []， "hunt_groups“： []，“时间表”： []，“call_parks"： []， "call_pickups"： []， "paging_groups"： []， "voice_portals"： [ { "name"： "Automated Voice Portal"， "firstName"： "Automated"， "lastName"： "Voice Portal"， "languageCode"： "en_us"，"电话号码"： "+15205551105"，"分机号"："1105" }]，"shared_call_appearances"： []， "business_communicator_desktop_to_upgrade_to_webex_app"： ["PC Comm - Engg Device Profile"]， "connect_client_to_upgrade_to_webex_app"： []， "位置"： []， "webex_for_broadworks_info"： {"users"： [ {"id"： "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5" } ]， "hydra_orgId：“Y2lzY29zcGFyazovL3VzL  SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg”，“hydra_customer_config_id"： "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk" } }

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

必要条件

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

1. 在计算机上安装Java 8、11或17。Java可以从多种来源获得，包括：
   • https://learn.microsoft.com/en-us/java/openjdk/download
   • https://aws.amazon.com/corretto/
   • https://download.oracle.com/java/17/latest/jdk-17_macos-x64_bin.dmg
2. 下载并提取迁移工具二进制文件后，在 provisioning_tool。sh for MAC和 provisioning_tool。bat for Windows中设置JAVA_HOME环境变量。
3. partner.cfg文件：
   • 设置批发_预配_ID和刷新_令牌（从令牌生成器工具复制的令牌）。合作伙伴管理员必须联系其帐户团队以获取预定_ID：

     批发_预配_ID = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0 REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

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

4. 使用Webex for BroadWorks迁移的WEBEX4BWKS _电子邮件_主题属性，向Webex for BroadWorks用户发送更改密码请求电子邮件主题。
5. 使用Webex for BroadWorks迁移的WEBEX4BWKS _电子邮件_正文属性，向Webex for BroadWorks用户发送更改密码请求电子邮件正文。

对于BroadCloud迁移同一区域：

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

对于BroadCloud迁移，其他区域：

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

运行说明

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

Windows

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

为单个客户提供以下服务：provision.bat -input=提供多个客户：provision.bat -input= 

macOS

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

要提供单个客户：。/transform.sh -input=要提供多个客户：。/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的最后阶段。您必须使用参数后迁移运行配置工具。

终端日志

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

工具名称：配置工具版本：1.15.0 ********** 开始处理文件：input/customer.json **************** Provisioning客户正在等待客户 external_id_engg_grp1完成配置… 正在等待客户 external_id_engg_grp1完成配置…… 客户external_id_engg_grp1状态：预配置号码预配置用户预配置用户功能预配置问候预配置安排预配置设备预配置共享呼叫出现预配置自动助手预配置呼叫队列预配置搜索组预配置组分组预配置呼叫公园预配置呼叫采集预配置语音门户 ********** 已完成文件：输入/customer.json**************** 

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

输出

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

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

图 8：Partner Hub

图 9：Control Hub

图 10：设备

图 11：正在呼叫

适用于BroadCloud

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

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

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

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

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

适用于Cisco BroadWorks和Webex for BroadWorks

对于Cisco BroadWorks和Webex for BroadWorks迁移，该工具在合作伙伴网络中的次级Cisco BroadWorks应用程序服务器上运行，并通过OCI-P连接到AS。它使用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文件中设置刷新_令牌（从令牌生成器工具复制的令牌）：

   刷新_令牌=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj

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

   BROADWORKS_用户_ID = ADMIN BROADWORKS_密码= admin BROADWORKS_主持人_姓名= localhost 

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

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

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

   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应用程序服务器运行：

对于设备移动单个客户： 。/devicemove.sh -input= 。/devicemove.sh -input=/tmp/customername.json对于设备移动多个客户： 。/devicemove.sh -input= ls -l /tmp/directoryofcustomers/ customer1.json customer2.json customer3.json此外，设备移动工具支持从1.35.0版本迁移单个/特定电话。使用下面的命令： 。/devicemove.sh -integration -input=  -macaddress=4CBC4883A6F8,48256741CBE9 

终端日志

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

工具名称：设备移动工具版本：1.15.0设备工具已启动… 迁移的有效设备：------------------------------------------------------------------------------------------------------------------- | 设备类型 | Mac | 版本 | 电子邮件 | ------------------------------------------------------------------------------------------------------------------- | DMS Cisco 7861 | CC98914EAAD7 | Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjaminjack@gmail.com | | DMS Cisco 6821 | 5486BCAE7E45 | Cisco-CP-6821-3PCC/11.3.7_5486bcae7e45_ | amareswaranvel+lucasoliver@gmail.com | | DMS Cisco 8811 | F87B  E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b e4066_ | amareswaranvel+owenalex@gmail.com | ------------------------------------------------------------------------------------------------------------------- 要迁移所有这些设备吗？（[Y]es或[N]o）是上传DMS的设备配置文件Cisco MPP LC Rebuild设备流程已开始Rebuild设备流程已成功完成Reboot流程已成功完成Group collabmigrationtestGRP下对Business Communicator配置文件已成功修改Group collabmigrationtestGRP_engg 启动客户组织Id的webex电话号码流程：85ea1d6f-ff9e-41a1-843f-7362aaf12b4c激活客户组织ID的Webex电话号码流程：85ea1d6f-ff9e-41a1-843f-7362aaf12b4c停用GroupId启动的broadworks电话号码流程：collabmigrationtestGRP_engg 停用已完成的GroupId电话号码流程：协作迁移testGRP_engg 设备迁移已完成 

输出

设备迁移后，设备已联机并准备拨打/接听呼叫。请参阅图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

终端日志

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

恢复配置文件

工具名称：设备移动工具版本：1.15.0为恢复过程启动设备工具… 可从Webex Calling迁移到BroadWorks的设备：- ------------------------------------------------------------------------------------------------------------------- | 设备类型 | Mac | 版本 | 电子邮件 | ------------------------------------------------------------------------------------------------------------------- | 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 | F87B  E4066 | Cisco-CP-8811-3PCC/11.3.7_f87b e4066_ | amareswaranvel+owenalex@gmail.com | ------------------------------------------------------------------------------------------------------------------- 要将这些设备从Webex Calling返回到BroadWorks吗？（是、Y、否、N）：是上传DMS的设备配置文件Cisco MPP LC重构设备流程已开始重构设备流程已成功完成重新启动流程已成功完成重新启动流程已成功完成设备迁移已成功完成取消预留流程已完成设备迁移 

恢复号码

工具名称：设备移动工具版本：1.15.0要继续将数字恢复到Broadworks吗？（[Y]或[N]o）：Y [+15205551101， +15205551102， +15205551103， +15205551104， +15205551105， +15205551106， +15205551107， +15205551108， +15205551109， +15205551110]开始重启启动组标识的宽工作电话号码流程：collabmigrationtestGRP_engg 激活已完成的GroupId电话号码流程：协作迁移testGRP_engg 设备迁移恢复流程已成功完成