了解用户和联系人

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

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

术语

定义

用户

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

工作空间

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

服务号码

是适用于带或不带设备的功能的机器帐户。例如：寻线组、模拟访问、语音门户、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

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

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. 使用 install gnu-tar命令在MAC中安装 guntar。

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

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

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

    1. 使用MAC中的标准“tar”实用程序创建tar文件tar --no-mac-metadata-cvf <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 搜索配置来同步用户或 contatcs。自定义配置允许用户定义同步设置。

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

        在使用等元目录时打开 LDAP。

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

        如果已经从 Unified CM 设置选择了用户同步，或者已经配置了通过 Directory Connector 进行用户同步，则用户同步选项将在此处不可用。

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

      • 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

删除导入的数据，单击 新数据 (Import New Data)省略号图标，该图标显示在 同步 (Pending for Synchronization)页面顶部。将显示导入新数据对话框，其中包含以下选项：

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

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

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

  • 将删除所有同步日志。

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 下载用户列表。