了解用户和联系人

从Control Hub执行新用户和组织联系人（组织联系人）同步，以迁移Unified CM中的用户或组织联系人。 如果您不使用现有的 Webex 方法（例如 Cisco 目录连接器、手动添加用户或使用 Control Hub 中的批量导入）来预配置用户，请使用此迁移工具。 有关更多信息，请参阅将用户添加到 Control Hub 组织的方法。

使用该表了解 Control Hub 中的用户定义：

术语

定义

用户

是组织内部人员。 他分配有电话或软客户端。 管理员管理该用户。

Workspace

是公共空间。 例如： 有设备和/或机器帐户的等候区或自助餐厅电话、会议室等。 工作空间在一个组织内，并由管理员管理。

服务号码

是适用于带或不带设备的功能的机器帐户。 例如： 寻线组、模拟访问、语音门户、VXML、RP、Meet-Me 会议、即时组呼叫、组寻呼、灵活的主持人功能、Find-me/Follow-me、呼叫中心、Broad works Anywhere 门户。 服务号码与组织关联，并由管理员管理。

个人联系人

指用户、工作空间、服务号码或组织联系人。 个人联系人由管理员管理。

组织联系人（组织联系人）

是与组织无关联的人员或联系人号码。 但是，组织内的用户或设备可以搜索该人员或联系人号码。 组织联系人被称为“标签用户”并由管理员管理。

使用Control Hub上的“将用户/联系人迁移到Webex卡”执行以下操作：

  • 使用可配置的规则将Unified CM数据库中发现的用户分类为用户和组织联系人。

  • 将组织联系人从目录服务/LDAP同步到联系人服务。

用户或组织联系人同步的优势包括：

  • 提供无缝的用户搜索体验。 将用户和联系人同步到云端后，此功能帮助 Webex 应用程序提供与 Jabber 类似的搜索功能。

  • 自动执行将用户从 Unified CM 数据库同步到 Webex 的任务。 此功能便于同步，并简化迁移任务，因为手动执行的同步过程容易出错并且很耗时。

此发行版不支持联系人同步。

必要条件

开始同步用户之前，请确保您满足以下要求：

  • 熟悉 Control Hub。

    Webex Control Hub 是 Webex 平台的管理界面。 有关更多信息，请参阅 Webex Control Hub 入门。

  • 以完全管理员权限访问。

    如果拥有完全管理员权限，您可以将一个或多个角色分配给组织中的任何用户。 确保分配具有管理员权限的用户，以便您可以迁移其余 Unified CM 用户。 有关更多信息，请参阅在 Webex Control Hub 中分配组织帐户角色。

  • 设置同步首选项。 选择转至设置。

  • 将所有Unified CM群集载入Control Hub以启用导入通用标识(CI)。

  • 使用批量管理工具 (BAT) 迁移用户。

    使用 Cisco Unified Communications Manager 应用程序中的“导入/导出”菜单迁移用户。 请参阅使用批量管理工具 (BAT) 导入用户获取详细信息。

使用批量管理工具 (BAT) 导入用户

使用 Cisco Unified Communications Manager 应用程序中的批量管理工具 (BAT) 从 Unified CM 导出用户，然后导入到 Control Hub 和 Webex 用户。 完成以下步骤以导入这些用户：

1

选择批量管理 > 导入/导出 > 导出以从当前主集群导出迁移用户的联系人列表。

将显示“导出数据”窗口。
2

在“选择要导出的项目”部分中选择全选。

3

为导出的列表数据选择文件名。 在 作业描述字段中，输入要为作业提供的描述。 Export Configuration 是默认说明。

4

单击立即运行或安排作业稍后运行。 单击提交。

5

监控导出作业的状态。 使用“批量管理”主菜单中的“作业安排程序”选项来安排和/或激活该作业。

从 Unified CM 应用程序导出 tar 文件后，请勿修改或更新该文件。

6

下载导出文件并存储，以在用户迁移完成后使用。 选择 Cisco Unified CM 即时消息和在线状态管理 > 批量管理 > 上传/下载文件。

在“上传/下载”窗口中选择 tar 文件，然后单击下载选中项。

7

将 .tar 文件解压至计算机上的任何位置（使用 tar -xvf 命令）。 将 .csv 文件解压至指定位置。 请参阅 Cisco Unified Communications Manager 批量管理指南获取详细信息。

如果您收到类似的错误： BAT TAR上传失败。 在BAT文件上传期间检测到解析报头或导入失败的错误，然后必须手动修改tar文件。 如果上传失败，请执行以下步骤：

对于Linux/Windows系统

  1. 将 .tar 文件解压至计算机上的任何位置（使用 tar -xvf 命令）。

  2. 手动修改文件并使用标准tar工具对文件进行tar。

  3. 导入文件。

对于MAC系统

  • 在MAC中使用gnutar：

    1. 在MAC中安装guntar brew install gnu-tar 。

    2. 使用guntar命令解压文件。

    3. 使用gtar -cvf<tarfilename.tar><files_to_be_included_in_tar> 修改tar文件或csv内容。

  • 在标准tar命令下使用“--no-mac-metadata”选项。

    1. 使用MAC中的标准“tar”实用程序创建tar文件 tar --no-mac-metadata-cvf <tarfilename.tar> <files_to_be_included_in_tar> 。

任务流程
使用“将用户或联系人迁移到Webex卡”将用户从本地部署同步到Webex Control Hub。
1

从 Webex Control Hub 中的客户视图，转至服务 > 迁移。

根据您拥有的配置类型选择一个使用案例：

  • Usecase1-目录连接器不可用，且未安装CCUC代理。

  • Usecase2-目录连接器可用，且未安装CCUC代理。

  • Usecase3-目录连接器不可用，已安装CCUC代理。

  • Usecase4-目录连接器可用，已安装CCUC代理。

2

在将用户/联系人迁移至 Webex 卡（在 Unified CM 升级实用程序下）上，单击开始。 将显示“用户/联系人同步”页面。

使用“用户/联系人同步”可一次最多同步 2 万个用户。 如果有超过 2 万个用户，您可以分批同步这些用户。

设置您的首选项
1

在Control Hub控制板中，转至更新和迁移。

2

选择用户/联系人同步磁贴，然后单击“前提条件”下的转至设置。

将显示“设置”页面。

3

为用户同步功能配置Unified CM或LDAP服务器。 从以下部分选择详细信息：

  • Unified CM最终用户列表—配置Control Hub的规则，以将Unified CM数据库中的用户识别到最终用户和联系人

    字段名

    描述

    识别联系人和用户的规则

    选中以下任何复选框以从Unified CM识别组织联系人。 该选项允许将联系人与用户分开，因为 Unified CM 用户可能同时包含用户和联系人。 您可以设置区分联系人和用户的规则：

    • 将所有记录同步为联系人。

    • 将所有记录同步为用户。

    • 自定义

    如果所选选项为“自定义”，该工具将提供将Unified CM最终用户记录分类为联系人的选项。 其余身份将被视为用户。

    请选择至少一个标识规则以继续操作。

    • 未从LDAP服务器同步到Unified CM数据库。

    • 缺少经理用户标识。

    • 未关联设备。

    • 缺少部门标识。

    • 部门标识包含一个字符串。

    • 用户标识包含一个字符串。

    导入

    选择切换开关以启用或禁用联系人或用户从Unified CM同步到Webex。

    • 导入用户-这包括从Unified CM最终用户列表中识别为用户的所有记录。 它是根据卡上设置的规则进行的。

      启用目录连接器后， 用户 将被禁用。 因此，您无法执行用户同步。

      您只能从一个来源同步用户（Unified CM或LDAP），选择为最终选择。

    • 导入联系人-这包括从Unified CM最终用户列表中识别为联系人的所有记录。 联系人包括等候区电话、寻线组、管理员配置的组织联系人。 它基于卡上设置的规则。

    选择集群

    选择要迁移联系人或用户的集群。

    定期审计

    允许持续审核Unified CM最终用户列表和Webex数据，以确保其每7天同步一次。

    设置时间-使用此字段更改默认的审核间隔

    对Unified CM上的用户和/或联系人的任何更改都会在几小时内更新到Webex。

  • LDAP服务器-选择这些设置可将LDAP服务器上的用户和联系人同步到Webex。 您可以从Unified CM和LDAP服务器同步联系人，但可以从一个来源（即Unified CM或LDAP服务器）同步用户。 选择此来源后，无法对此组织进行更改。

    您只能从一个来源同步用户（Unified CM或LDAP），选择为最终选择。

    字段名

    描述

    LDAP 定期同步

    从LDAP服务器启用或禁用同步。

    定期同步

    允许定期将所有用户和/或联系人从LDAP服务器同步到Webex。

    添加配置

    选择群集过滤器以同步联系人和/或用户。 Control Hub LDAP服务器支持群集的多个配置。 单击添加配置以配置LDAP服务器相关的配置。 Control Hub LDAP服务器使用Unified CM LDAP搜索凭证连接到LDAP服务器。

    • 簇名称-选择簇名称。

    • 配置-从两种模式中进行选择-客户使用Unified CM LDAP搜索。 使用Unified CM LDAP搜索选择允许工具提取Unified CM LDAP搜索配置以同步用户或联系人。 自定义配置允许用户定义同步设置。

      • LDAP系统-选择OpenLDAP或Microsoft AD作为源LDAP服务器。

        当我们使用元组（如Recos）时打开LDAP。

      • 同步类型-选择用户或联系人的同步类型。

        如果您已选择通过Unified CM设置进行用户同步或配置了通过目录连接器进行用户同步，则此处将无法使用用户同步选项。

      • 自定义过滤器-用户或联系人同步的自定义过滤器。

      • LDAP搜索库—用于用户或联系人同步的LDAP服务器搜索库。

        管理员最多可以添加三个以“&”分隔的搜索库。

      • UC目录服务配置文件—选择Unified CM配置的类型目录的UC服务之一。

4

单击保存并继续。 将显示“待同步”部分。

数据待同步

显示使用 BAT 文件从 Unified CM 最终用户列表中导入的用户或联系人。 该数据是按所选的首选项分类的。

1

在“待同步”部分中，选择以下选项之一：

  • 拖放 tar 文件。
  • 浏览至 tar 文件所在的位置，选择文件，然后单击打开。

注： tar 文件包含 CSV 文件集合。

文件上传成功后，屏幕上将显示以下身份详细信息：

身份

描述

导入总数

显示使用 BAT 文件从 Unified CM 导入的身份总数。 此身份显示活动的 CM 用户。

要同步的联系人

显示待同步到 Webex 的联系人总数。 此身份数量包括已从查看列表中删除的联系人或同步失败的联系人。

联系人已在 Webex 中

显示已同步到 Webex 的联系人总数。

要同步的用户

显示待同步到 Webex 的用户总数。 此身份数量包括已从查看列表中删除或同步失败的用户。

用户已在 Webex 中

显示已同步到 Webex 的用户总数。

2

单击导入新数据以删除导入的文件。 如果您上传了错误的文件或想要更新身份详细信息，可以删除导入的文件。 有关详细信息，请参阅导入新数据。

3

单击查看以进行同步。 通过“查看以进行同步”页面，您可以在开始同步前查看用户和联系人详细信息列表。 您可以在用户同步前修复标记的错误。

导入新数据
如果您上传了错误的文件或想要更新身份详细信息，可以选择删除导入的文件。 您还可以删除任何暂挂的迁移任务或删除失败报告。 删除数据后，您可以重新上传文件，然后继续。
1

要删除导入的数据，单击导入新数据省略号图标（显示在待同步页面顶部）。 将显示导入新数据对话框，其中包含以下选项：

确保您知晓您的操作的后果。 此操作无法撤销。

  • 将删除所有先前导入的数据。

  • 将删除所有未同步的记录。

  • 将删除所有同步日志。

2

选中所有三个选项，然后单击删除。

删除按钮仅在您选中所有选项后启用。

3

删除数据后，上传包含更新的数据的文件，然后单击查看以进行同步。

同步前查看用户数据
在开始同步前，请查看数据。 使用搜索字段搜索身份，然后根据过滤器对它们排序。
1

在待同步部分中，单击查看以进行同步。 将显示同步前查看用户页面。

2

查看错误详细信息并修复错误。 错误分类如下：

错误

描述

无效电子邮件

无效的电子邮件标识是指不完整或重复的标识。 无法同步带无效电子邮件标识的用户。 请修复电子邮件标识中的错误，或者删除联系人详细信息。 您可以在摘要页面中修复无效的电子邮件标识。

用户已在 Webex 中

已在 Webex 中且无法再次同步的用户。 您必须从摘要页面中删除详细信息。

缺少电话号码/分机号

无法同步没有电话号码或分机号的用户，并且修复此错误不是必需的。 您无法从 Control Hub 中添加缺少的电话号码或分机号详细信息，因此将删除这些用户。

3

在查看用户页面中，单击操作以执行以下任务：

  • 导出这些行： 选择此选项以导出所有可用记录。
  • 导入已更新的文件： 如果您要查看更新的文件详细信息，请选择此选项。
  • 重设用户列表：如果要清除现有用户列表的详细信息，然后再次在摘要页面上更新，请选择此选项。
4

单击下一步。 显示同步前查看联系人页面。

如果更改了显示名称，您必须更新 Unified CM 联系人详细信息。 使用 Unified CM 中 Control Hub 中的更新记录导出列表来导入更改。

5

在同步前查看联系人页面中，您可以执行同一组任务，例如搜索、排序、编辑设置和更改用户/联系人规则。

6

单击下一步。

将显示摘要页面。

查看摘要数据

“摘要”页面列出了所选用户和联系人的错误和警告消息。 它还为您提供所需的建议和解决方案来解决这些问题。 请解决错误，然后继续。 但是，您可以忽略警告。

注： 您还可以删除有错误的身份（用户或联系人），然后继续。 删除的身份会重新添加到未同步的列表。

要解决用户错误，请单击查看错误并选择从同步列表中删除。

使用从同步列表中删除选项从“摘要”页面删除用户时，Control Hub 上的“用户同步次数”不会更新。

1

您可以查看这些无效身份的数量：

  • 电子邮件标识无效的用户。

  • 用户在 Webex 中且无法同步。

  • 缺少电话号码/分机号的用户。

更新“设置”页面后，查看向导中的用户和组织联系人详细信息会恢复。

导出更新的记录 - 我们建议在对记录进行任何更改后更新 Unified CM 联系人列表。 单击导出列表下载更新的记录，并在 Unified CM 中手动更新记录。

2

单击开始同步。

“同步身份”进度条在同步期间显示，同步完成前您无法执行任何操作。 同步操作完成后，最新同步标签页会显示用户同步次数。

将显示日志页面，其中包含同步摘要。

3

从日志页面查看同步的状态。 此页面显示已同步的用户以及失败的原因（如果有）。

4

单击导出 csv 下载用户列表。