迁移工具，从BroadWorks、Webex for BroadWorks和BroadCloud过渡到Wholesale RTM解决方案

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

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

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

必要条件

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

在 token_generator。sh（适用于MAC）和 token_generator。bat（适用于Windows）中设置JRE/JDK环境路径。如果JAVA_ 路径已存在，该工具将重用该路径。

• MAC：JAVA HOME=_"/Users/cisco/jdk/zulu@1.8.282/Content/Home/"

• Windows：JAVA_ = C：\Progra~1\Java\jre1.8.0_321

运行说明

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

Windows：

token_generator.bat

MacOS：

。/token_generator。sh

输出：

工具名称：令牌生成器工具版本：1.13.0在Web浏览器中加载URL：http：//localhost：8080 

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

用户界面图示如下，以供参考：

图 3：使用Cisco Webex登录

图 4：凭证窗口

图 5：令牌生成

配置以下步骤，然后在辅助BroadWorks服务器中运行提取和设备移动工具。

启用OCI-P连接

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

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

在CLI中运行以下命令以更改为“常规设置”目录：

 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代理：

作为_CLI> cd /Applications/OpenClientServer/OCIProxy

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

AS_CLI/Applications/OpenClientServer/OCIProxy> get enabled = true enabledLoginLevelScreening = false enableResponseCache = false responseCache Hours = 24 responseCacheRenewPeriodMins = 30 messageQueueCapacity = 50 messageQueueTimeoutSeconds = 1800 

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

第三步：使用CLI配置OCI设置。

更改为预配置目录：

作为CLI_> cd /System/NetworkAccess /OCI/Provisiing

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

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> 获取地址说明127.0======================== 。0.1本地为 

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

 当_CLI/Maintenance/ Objects>获取broadWorks并检查输出是否正常。有关输出示例，请参阅下文：当_  I/Maintenance/ Objects>获取BroadWorks受管对象========================== *服务器：身份…………。.：作为版本……………：Rel_21.sp1_1.551行政州…：已解锁*应用程序：名称版本已部署管理状态有效状态执行=========================================================================================和预配置21.sp1_1.551 true Unlocked Unlocked FlashPolicy 21.sp1 _1.551 false Unlocked Stop OpenClientServer 21.sp1 _1.551 true Unlocked Unlocked WebContainer 21.sp1 _1.551 true Unlocked Unlocked WebContainer 21.sp1_1.551 true Unlocked Unlocked Unlocked 4个条目找到。*托管的应用程序：名称版本上下文路径部署CommPilot 21.sp1 1================================================================== 。551 / true DeviceManagement_Files 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：运行号码激活命令：

_  I>CD SubscriberMgmt/NumberActivate

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

_  I>设置dnMode groupAndUser Enabled

第三步：在确认提示处输入Y。

对于BroadCloud

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

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

下图显示了服务商门户。

图 6：服务商门户

图 7：服务商门户

适用于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以从conf/exportTool.yml中的Cisco BroadWorks提取。请参阅下面的示例YAML片段：

   ServiceProviderID-A：- GroupID-A1 - GroupID-A2 - GroupID-A3 ServiceProviderID-B：-全部 

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

     WORKS__  = ADMIN BROADWORKS_ = admin BROADWORKS_ _  = LOCALHOST REFRESH_ =合作伙伴管理员从令牌生成器工具复制的刷新令牌。迁移_ =支持的值为 webex_for_broadworks_to_wholesale。默认值为 broadworks_to_wholesale。用于webex_for_broadworks_to_wholesale bex for BroadWorks迁移。 

   对于Webex for BroadWorks迁移而言，REFRESH_令牌 属性是必需的。

5. 如果辅助Cisco BroadWorks应用程序服务器JDK/JRE环境路径与文件不同，请修改导出。SH文件中的JDK/JRE环境路径：

    _  =/usr/local/java/java_base

运行说明

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

./export.sh

终端日志

成功导出时，终端中提供以下日志：运行BroadSoft数据导出工具：

 运行BroadSoft数据导出工具************************************************开始导出工具v：1.15.0已为SP=collabmigrationtestSP_engg 导出，Group=collabmigrationtestGRP_engg 导出用户为SP=collabmigrationtestSP_engg，Group=collabmigrationtestGRP_engg 导出用户为SP=collabmigrationtestGRP_engg 完成，Group=collabmigrationtestGRP_engg 导出为SP=collabmigrationtestGRP_engg 完成，Group=collabmigrationtestGRP_engg 导出已完成导出转储压缩目录：输出/20221017223452_ Tool Export Dump Zip文件名称：extracted_data_1666060500618.zipextracted_data_1666060500618.zip文件已创建ZIP文件创建过程完成导出文件转换为ZIP文件************************************************** 

输出

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

ls –ltr drwxr-xr-x 2 bwadmin bwadmin 4096 Oct 4 11：53 lib/-rwxr-xr-x 1 bwadmin bwadmin 956719 10月4 11：53 exportTool.jar -rwxr-xr-x 1 bwadmin bwadmin 2635 10月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 log/ -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文件中设置REFRESH_ 牌（从令牌生成器工具复制的令牌）和___ 名称：

   刷新_令牌=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj名称_主_位置_=主 

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

   预配置_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   要更全面地验证客户电子邮件地址，您可以选择设置预配置_ID。
3. 如果丢失，请在输入/customer。csv文件（请参阅下一部分）中配置丢失的信息。
4. 在输入/users。csv文件中添加最终用户的电子邮件地址。
5. 如果要预配置新电话，请将用户新电话的mac地址和电子邮件地址添加到input/newphones.csv文件。仅当合作伙伴管理员希望在 呼叫中预配置新电话时才需要此功能。
6. 使用input/cxessentials.csv文件将BroadWorks呼叫中心转换为CxEssentials。
7. （可选）启用将_所有呼叫__中心_升级_CX_精要属性以将所有呼叫中心转换为CxEssentials。
8. 使用输入/locations.csv文件支持大型企业迁移，允许管理员按位置迁移其客户的位置
9. 当MAC地址在Cisco BroadWorks设备配置文件中不可用时，可从SIP REGISTER消息的用户-代理标头使用MAC地址。取消在文件conf/partner.cfg中“_ _ _ = yes”（USE_ _ 地址）行的评论

填写输入/customer.csv

文件输入/customer.csv提供Cisco BroadWorks或BroadCloud中可能缺少的数据。如果所有必填信息都已可用，则该文件可留空。您不需要填写所有列，只需要填写缺少的信息。

下表介绍了input/customer。csv中最重要的列。

运行说明

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

窗户

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

转换。bat -extract=< -Tool- -Zip-file> -customer=< -Path-Customer-CSV> -users=< -Path-Users-CSV> -newphones=< -Path-NewPhones-CSV>

macOS

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

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

   python3 -m venv venv源venv/bin/activate python3 -m pip install request python3 -m pip install requests-oauthlib 

2. 运行转换工具：

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

客户/用户预检查

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

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

预检查

除了运行客户信息的预检API之外，转换工具还将运行订阅者电子邮件的预检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 collabmigrationtestGRP________________________________________________________________________________ 手动配置去电方案_engg 

输出

输出JSON ( 。json)文件将出现在 // 目录中。 。json 文件示例如下：

{"customer"： {"预配置Id"："！！！！！！！！！！ _使用_预配置！！！！！！！！！！"， IGID"包"：[ "webex_calling"，"common_area_calling" ]， "externalId"： "external_id_engg_grp1"， "地址"： {"addressLine1"： "100 Main Street"， "addressLine2"： ""， "城市"： "Gaithersburg"， "stateOr "： "MD"， "zipOrPostalCode"： "20877"， "country"： "US" }， "customerInfo"： {"name"： "Engineering Group - 1"， "primaryEmail"： "amareswaranvel+engineeringgroup1@gmail.com" }， "provisi "： {"calling"： {"location"： {"name"： "Main"， "address"： {"addressLine1"： "100 Main Street"， "addressLine2"： """， "city"： "Gaithersburg"， "stateOr "： "MD"， "zipOrPostalCode"： "20877"， "country"： "US" ，"时区"： "America/New_约克"，"language"："en_us"， "号码"： [ "+15205551101"， "+15205551102"， "+15205551103"， "+15205551104"， "+15205551105"， "+15205551106"， "+15205551107"， "+15205551108"， "+15205551109"， "+15205551110" ]， "main号码"： "+15205551101" } } } ， " "broadworks_info"： { "service_provider_id"： "collabmigrationtestSP_engg"，"group_id"： "collabmigrationtestGRP_engg" }， " "： [ { "amareswaranvel+benjamin injack@gmail.com"： { "subscriber"： {"customerId"： "！！！！！！！！！！ _使用_自定义ID！！！！！！！！！！"， “电子邮件”："amareswaranvel+benjamin injack@gmail.com"，"package"："webex_calling"， "provisi "： { "firstName"： "Benjamin"， "lastName"： "Jack"， "primaryPhoneNumber"： "+15205551102"， "分机"： "1102" } }， " "： [ {"/v1/people/{personId}/ /voicemail"： {" "：true， "send Calls"： { " "：true， " "： " " }， "sendUnanswerCalls"： {" "：true，“问候语”：“默认值”，“numberOf ”：3}， "message "： { "mwi "：true， "storageType"： "EXTERNAL"， "externalEmail"： "engineering17861@mailnator.com" } } } ]， "devices"： [ { "cisUuid"："！！！！！！！！！！ __  ID！！！！！！！！！！"， "product"： "DMS Cisco 7861"， "mac"： "CC98914EAAD7" } ] } ， { "amareswaranvel+lucasoliver@gmail.com"： { "subscriber"： { "customerId"： "！！！！！！！！！！ ID__  ERID！！！！！！！！！！"， "email"： "amareswaranvel+lucasoliver@gmail.com"， "package"： "webex_calling"， "provisioning "： { "firstName"： "Lucas"， "lastName"： "Oliver"， "primaryPhoneNumber"： "+1103" } }， " "： [ {"/v1/people/{personId}/ /voicemail"： { " "：true， "send Calls"： { " "：true， " "： " " }， "sendUnanswerCalls"： {" "：true，“问候语”：“默认值”，“numberOf ”：3}， "message "： { "mwi "：true， "storageType"： "EXTERNAL"， "externalEmail"： "engineering16821@mailnator.com" } } } ]， "devices"： [ { "cisUuid"： "！！！！！！！！！！ _使用_PERSONID！！！！！！！！！！"， “product”： "DMS Cisco 6821"， "mac"： "5486BCAE7E45" } }， {"amareswaranvel+leojackson@gmail.com"： {"subscriber"： {"customerId"： "！！！！！！！！！！ _使用_自定义ID！！！！！！！！！！"， "email"："amareswaranvel+leojackson@gmail.com"，"package"："webex_calling"， "provisi "： { "firstName"： "Leo"， "lastName"： "Jackson"， "primaryPhoneNumber"： "+15205551104"， "分机"： "1104" } }， " "： [ {"/v1/people/{personId}/ /voicemail"： {" "：true， "send Calls"： { " "：true， " "： " " }， "sendUnanswerCalls"： {" "：true，“问候语”：“默认值”，“numberOf ”：3}， "message "： { "mwi "：true， "storageType"： "EXTERNAL"， "externalEmail"： "engineeringmacpc@mailnator.com" } } } ]， "devices"： [] } }， { "amareswaranvel+owenalex@gmail.com"： { "subscriber"： { "customerId"："！！！！！！！！！！ __  ERID！！！！！！！！！！"， "email"： "amareswaranvel+owenalex@gmail.com"， "package"： "webex_calling"， "provisi "： { "firstName"： "Owen"， "lastName"： "Alexander"， "primaryPhoneNumber"： "+15205551101"， "extension"： "1101" } }， " "： [ {"/v1/people/{personId}/ /voicemail"： {" "：true， "send Calls"： { " "：true， " "： " " }， "sendUnanswerCalls"： {" "：true，“问候语”：“默认值”，“numberOf ”：3}， "message "： { "mwi "：true， "storageType"： "EXTERNAL"， "externalEmail"： "engineering8811@mailnator.com" } } } ]， "devices"： [ { "cisUuid"： "！！！！！！！！！！ _使用_PERSONID！！！！！！！！！！"， “product”： "DMS Cisco 8811"， "mac"： "F87B204E4066" } ] } } ]， "auto_attendants"： []，"call_queues"： []，"hunt_groups"： []， " "： []， "call_parks"： []，"call_pickups"： []，"paging_groups"： []，"voice_portals"： [ { "name"： "自动语音门户"， "firstName"： "自动"， "lastName"： "语音门户"， "languageCode"： "en_us"， "phoneNumber"： "+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"： []， "location"： []， "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。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. 下载并提取迁移工具二进制文件后，设置JAVA_HOME环境变量provisioning_tool.sh用于MAC和provisioning_tool适用于Windows的。bat。
3. partner.cfg文件：
   • 设置批发_预配置_ID和REFRESH_令牌（从令牌生成器工具复制的令牌）。合作伙伴管理员必须联系其帐户团队以获取预配置_ ：

     __  = Y2U4YWQxYmQtMWZlNy00NjRiLWExMmItMGJkODMzN2U5NmU0刷新_ = MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj 

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

4. 对于Webex for BroadWorks迁移，使用WEBEX4BWKS_ _ 主题属性为Webex for BroadWorks订阅者发送更改密码请求电子邮件主题。
5. 对于Webex for BroadWorks迁移，使用WEBEX4BWKS_ EM_ 属性发送Webex for BroadWorks订阅者的更改密码请求电子邮件正文。

对于BroadCloud迁移同一区域：

1. 工具将跳过号码、设备和共享呼叫显示设置。
2. 工具将使用分机和临时分机创建用户和虚拟用户。

对于BroadCloud迁移另一个区域：

1. 工具将预配置号码、设备和共享呼叫显示。
2. 该工具将使用实际电话号码和分机创建用户和虚拟用户。
   所有欧洲BroadCloud迁移都在另一个地区。

运行说明

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

窗户

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

要预配置单个客户：provision.bat -input=< -Tool- -Customer-JSON-File-Path>预配置多个客户：provision.bat -input= 

macOS

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

要预配置单个客户： 。/transform.sh -input=要预配置多个客户： 。/transform.sh -input= 

Webex for BroadWorks迁移的先决条件

合作伙伴管理员必须更新其适用于Webex for BroadWorks共存功能的BroadWorks加入模板。请参阅下图：

使用Webex for BroadWorks到 迁移的附加参数运行预配置工具。

准备阶段： 是缺省阶段，管理员可以将BroadWorks用户预配置为 订阅者，并继续使用Webex for BroadWorks用户。

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

迁移后阶段： 是最后阶段，管理员可以将BroadWorks完全转换为批发。您必须运行带有参数迁移后的设置工具。

终端日志

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

工具名称：设置工具版本：1.15********** 。0已开始的处理文件：input/customer.json****************预配置客户正在等待客户external_id_engg_grp1完成预配置… 正在等待客户external_id_engg_grp1完成预配置… 客户external_id_engg_grp1状态：预配置预配置号码预配置用户预配置用户功能预配置问候语预配置安排预配置设备预配置共享呼叫显示预配置自动语音应答预配置呼叫队列预配置寻线组预配置组分配预配置呼叫暂留预配置呼叫代答预配置语音门户**********已完成文件：输入/customer.json **************** 

将打印一份表格，其中显示每次运行创建的位置数：

输出

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

合作伙伴管理员可以在Partner Hub和Control Hub门户中验证客户预配置。请参阅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。它使用转换工具输出JSON ( 。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、密码和主机名正确：

     WORKS__  = ADMIN BROADWORKS_ = admin BROADWORKS_ _ = localhost 

3. 在devicemove.sh

    _  =/usr/local/java/中验证JDK/JRE环境路径是否正确java_base

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

Polycom电话

要将Polycom电话从Cisco BroadWorks移动到批发呼叫，合作伙伴管理员必须在Cisco BroadWorks的 Polycom设备模板中在系统级别创建新的标识/设备配置文件类型文件。请参阅图14并上传自定义文件device-move-tool/conf/deviceProfile/{region}/polycom_vvx.cfg。上传新设备文件后，确保新创建的文件在组级别存在。另外，请确保filemigration_%BWMAC ADDRESS%。cfg不与系统中的任何现有文件冲突)。

可供设备移动工具内部使用。

Polycom电话的迁移过程：

1. 设备移动工具将文件。cfg%BWMACADDRESS% 设备级别替换为polycom_vvx2.cfg。请注意，该文件引用migration_%BWMACADDRESS%。cfg。
2. 在组级别或设备级重新生成设备配置文件。
   在组级或设备级执行操作取决于文件device-move-tool/conf/partner。cfg中的参数deviceLevel 的配置。
3. 设备移动工具要求Cisco BroadWorks应用程序服务器在组级别或设备级别重新启动电话。
4. 重新启动请求后，Polycom电话下载并process% 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：添加身份/设备配置文件类型文件

运行说明

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

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

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

终端日志

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

工具名称：设备移动工具版本：1。15.0设备工具已启动… 用于迁移的有效设备：------------------------------------------------------------------------------------------------------------------- -------------------------------------------------------------------------------------------------------------------| 设备类型| Mac| 版本| 电子邮件| ------------------------------------------------------------------------------------------------------------------- -------------------------------------------------------------------------------------------------------------------| DMS Cisco 7861| CC98914EAAD7| Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjamin injack@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| -------------------------------------------------------------------------------------------------------------------要迁移所有这些设备吗？（[Y]es或[N]o）是上传DMS设备配置文件Cisco MPP LC重建设备进程已启动重建设备进程已成功完成重新启动进程已启动重新启动进程已成功修改组collabmigrationtest下的Business Communicator配置文件GRP_engg 激活客户组织标识的webex电话号码进程已启动：85ea1d6f-ff9e-41a1-843f-7362aaf12b4c激活客户组织标识的Webex电话号码流程：85ea1d6f-ff9e-41a1-843f-7362aaf12b4c已为组标识停用broadworks电话号码进程：collabmigrationtestGRP_engg 已为组标识停用Broadworks电话号码流程：collabmigrationtestGRP_engg 设备迁移已完成 

输出

设备迁移后，设备已上线并准备好发起/接听呼叫。请参考图15以查看设备状态的示例：

图 15：设备状态

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

图 16：号码活动中

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

对于BroadCloud运营商

BroadCloud合作伙伴的还原过程如下所示：

1. 使用Cisco TAC提交申请单以请求设备恢复。
2. 以恢复模式运行设备移动工具：
   • 电话号码将从Webex 取消分配，只保留用户和服务的分机号。
   • Webex 中的电子邮件地址将还原为临时电子邮件地址。
   • 电话将从Webex 中删除。
   • 将在BroadCloud中重新创建用作alternateIds的电话号码、电子邮件地址和电话。
   • 电话将重新启动。
3. 合作伙伴管理员必须将PSTN电话号码移回BroadCloud运营商。

适用于Cisco BroadWorks和Webex for BroadWorks

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

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

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

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

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

还原配置文件

./devicemove.sh -input= < -Tool- -Customer-JSON-File-Path> -revertProfile

还原号码

./devicemove.sh -input= < -Tool- -Customer-JSON-File-Path> -revertNumbers

终端日志

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

还原配置文件

工具名称：设备移动工具版本：1。15。0恢复过程的设备工具已启动… 可以从Webex 移回BroadWorks的设备：- -------------------------------------------------------------------------------------------------------------------| 设备类型| Mac| 版本| 电子邮件| ------------------------------------------------------------------------------------------------------------------- -------------------------------------------------------------------------------------------------------------------| DMS Cisco 7861| CC98914EAAD7| Cisco-CP-7861-3PCC/11.3.7_cc98914eaad7_ | amareswaranvel+benjamin injack@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| -------------------------------------------------------------------------------------------------------------------要将这些设备从Webex 移回到BroadWorks吗？（是，Y，否，N）：是正在上传DMS的设备配置文件Cisco MPP LC重建设备进程已开始重建设备进程已成功完成重新启动进程已开始重新启动进程已成功完成设备迁移已完成取消部署流程 

还原号码

工具名称：设备移动工具版本：1.15.0要继续将号码恢复到Broadworks吗？（[Y]或[N]o）：[+15205551101、+15205551102、+15205551103、+15205551104、+15205551105、+15205551106、+15205551107、+15205551108、+15205551109、+15205551100]已为组标识启动恢复激活Broadworks电话号码过程：collabmigrationtestGRP_engg 为组标识激活Broadworks电话号码流程已完成：collabmigrationtest_engg GRP设备迁移还原过程已成功完成