配置客户端

客户端配置工作流

过程

  命令或操作 目的
步骤 1

客户端配置简介

步骤 2

在 Unified CM 中设置客户端配置参数（最高优先级）或创建和托管客户端配置文件

步骤 3

在电话配置中为桌面客户端设置参数

步骤 4

在电话配置中为移动客户端设置参数

步骤 5

配置代理设置—可选

客户端配置简介

Cisco Jabber 可以从以下来源检索配置设置：

  • 服务配置文件—您可以在 Cisco Unified Communications Manager 版本 9 和更高版本中配置 UC 服务配置文件中的一些客户端设置。用户启动客户端时，客户端会通过 DNS SRV 记录发现 Cisco Unified Communications Manager 的主群集，并自动从 UC 服务配置文件检索配置。

  • 电话配置—您可以在 Cisco Unified Communications Manager 版本 9 和更高版本的电话配置中设置一些客户端设置。除了 UC 服务配置文件中的配置之外，客户端还会从电话配置中检索设置。

  • Cisco Unified Communications Manager IM and Presence Service—您可以启用即时消息和在网状态功能，并配置某些设置，比如在网状态订阅请求。

    在“高级设置”窗口中，如果您选择 Cisco IM & Presence，客户端将从 Cisco Unified Communications Manager IM and Presence Service 检索 UC 服务。客户端不使用服务配置文件或 SSO 发现。

  • 客户端配置 — 您可以设置用户登录时应用的客户端配置参数，方法是：

    • 使用 Unified CM 设置客户端配置参数。

    • 使用包含配置参数的 XML 编辑器创建 XML 文件。然后，您可将 XML 文件托管在 TFTP 服务器上。

在 Unified CM 中设置客户端配置参数

在 Unified CM 中设置客户端配置参数并分配到服务配置文件。

对于Cisco Jabber iPhone 和 iPad 版本 以及 Cisco Jabber Android 版本，您必须设置以下参数：

  • 内部部署的目录集成。

  • 混合云部署的语音邮件服务凭证。


注

在大多数环境中，Cisco Jabber Windows 版本 和 Cisco Jabber Mac 版本 不需要任何配置即可连接到服务。只有当您需要自定义内容（例如自动更新、问题报告或用户策略和选项）时，才应设置客户端配置参数。

过程

步骤 1

定义 Jabber 配置参数

步骤 2

分配 Jabber 客户端配置到服务配置文件

定义 Jabber 配置参数

通过 Unified CM，您可以添加、搜索、显示和维护有关 UC 服务（包括 Jabber 客户端配置）的信息。

过程
步骤 1

打开 Cisco Unified CM Administration 界面。

步骤 2

选择用户管理 > 用户设置 > UC 服务。

步骤 3

选择新增。

步骤 4

选择 Jabber 客户端配置 (jabber-config.xml) 作为 UC 服务类型。

步骤 5

选择下一步。

步骤 6

在 UC 服务信息部分输入名称，请参阅"Unified CM 帮助"了解更多要求。

步骤 7

在 Jabber 配置参数部分输入参数，了解参数相关信息，请参阅最新版本的《Cisco Jabber 参数参考指南》。

步骤 8

选择保存。

分配 Jabber 客户端配置到服务配置文件

通过 Unified CM，您可以通过服务配置文件为用户分配 Jabber 客户端配置。

过程
步骤 1

打开 Cisco Unified CM Administration 界面。

步骤 2

选择用户管理 > 用户设置 > 服务配置文件。

步骤 3

选择新增或选择要为其分配 Jabber 客户端配置的现有服务配置文件。

步骤 4

在 Jabber 客户端配置 (jabber-config.xml) 配置文件部分选择要应用到配置文件的配置的名称。

步骤 5

选择保存。

创建并托管客户端配置文件

创建客户端配置文件并将其托管在 Cisco Unified Communications Manager TFTP 服务上。

对于 Cisco Jabber iPhone 和 iPad 版本 以及 Cisco Jabber Android 版本，您必须创建一个全局配置文件来设置：

  • 内部部署的目录集成。

  • 混合云部署的语音邮件服务凭证。


注

在大多数环境中，Cisco Jabber Windows 版本 和 Cisco Jabber Mac 版本 不需要任何配置即可连接到服务。只有当您需要自定义内容（例如自动更新、问题报告或用户策略和选项）时，才创建配置文件。

开始之前

注意以下配置文件要求：

  • 配置文件名区分大小写。在文件名中使用小写字母以避免出现错误，并确保客户端可以从 TFTP 服务器检索文件。

  • 对配置文件使用 UTF-8 编码。

  • 客户端无法读取无有效 XML 结构的配置文件。检查关闭元素的配置文件结构以及正确的元素嵌套。

  • 仅在配置文件中使用有效的 XML 字符实体参考。例如，使用 & 而不是 &。如果您的 XML 包含无效字符，客户端就无法解析配置文件。

    要验证您的配置文件，请在 Microsoft Internet Explorer 中打开该文件。

    • 如果 Internet Explorer 显示整个 XML 结构，则您的配置文件是有效的。

    • 如果 Internet Explorer 仅显示部分 XML 结构，则您的配置文件可能包含无效字符或实体。

过程

  命令或操作 目的
步骤 1

指定 TFTP 服务器地址

指定您的 TFTP 服务器地址，以便客户端可以访问您的配置文件。
步骤 2

创建全局配置

为您部署中的用户配置客户端。
步骤 3

创建组配置

将不同的配置应用到不同的用户组。
步骤 4

托管配置文件

将配置文件托管在任何 TFTP 服务器上。
步骤 5

重新启动您的 TFTP 服务器

重新启动 TFTP 服务器，方可访问配置文件。

指定 TFTP 服务器地址

客户端从 TFTP 服务器获取配置文件。

过程
命令或操作 目的

指定您的 TFTP 服务器地址，以便客户端可以访问您的配置文件。
注意 

如果 Cisco Jabber 从 DNS 查询获取 _cisco-uds SRV 记录，它可以自动找到用户的主群集。因此，客户端还可以查找 Cisco Unified Communications Manager TFTP 服务。

如果您部署 _cisco SRV 记录，则无需指定您的 TFTP 服务器地址。

在电话模式中指定 TFTP 服务器
过程
命令或操作 目的

如果您在电话模式中部署客户端，则可按照以下方式提供 TFTP 服务器的地址：

  • 在启动客户端时，用户手动输入 TFTP 服务器地址。

  • 您可以在安装期间使用 TFTP 参数指定 TFTP 服务器地址。

创建全局配置

在登录过程中，客户端会从您的 TFTP 服务器下载全局配置文件。为您部署中的所有用户配置客户端。

开始之前

如果您的配置文件结构无效，客户端将无法读取您设置的值。有关详细信息，请参阅本章中的 XML 示例。

过程
步骤 1

使用任何文本编辑器创建名为 jabber-config.xml 的文件。

  • 在文件名中使用小写字母。

  • 使用 UTF-8 编码。
步骤 2

在 jabber-config.xml 中定义所需配置参数。

步骤 3

在 TFTP 服务器中托管组配置文件。

如果您的环境有多个 TFTP 服务器，则必须确保所有 TFTP 服务器上的配置文件都相同。

创建组配置

组配置文件适用于用户的子集，并且在 Cisco Jabber 桌面版本（CSF 设备）和 Cisco Jabber 移动设备版本上均受到支持。组配置文件的优先级高于全局配置文件。

如果您为用户提供 CSF 设备，请在设备配置的 Cisco 支持字段字段中指定组配置文件名。如果用户没有 CSF 设备，请在安装期间使用 TFTP_FILE_NAME 参数为每个组设置唯一的配置文件名。

开始之前

如果您的配置文件结构无效，客户端将无法读取您设置的值。有关详细信息，请参阅本章中的 XML 示例。

过程
步骤 1

使用任何文本编辑器创建 XML 组配置文件。

组配置文件可以有任何适当的名称，例如 jabber-groupa-config.xml。

步骤 2

在组配置文件中定义需要的配置参数。

步骤 3

将组配置文件添加到适用的 CSF 设备。

  1. 打开 Cisco Unified CM 管理界面。

  2. 选择设备 > 电话。

  3. 查找并选择组配置所应用的适当 CSF 设备。

  4. 在电话配置窗口中，浏览到产品特定配置布局 > 桌面客户端设置。

  5. 在 Cisco 支持字段字段中，输入 configurationfile=group_configuration_file_name.xml。例如，输入 configurationfile=groupa-config.xml。

    注 

    如果您在除默认目录以外位置的 TFTP 服务器上托管组配置文件，就必须指定路径和文件名，例如 configurationfile=/customFolder/groupa-config.xml。

    请勿添加多个组配置文件。客户端仅使用 Cisco 支持字段字段中的第一个组配置。

  6. 选择保存。

步骤 4

在 TFTP 服务器中托管组配置文件。

托管配置文件

您可将配置文件托管在任何 TFTP 服务器上，使其成为配置文件的主机。但是，我们建议将配置文件托管在设备配置文件所在的 Cisco Unified Communications Manager TFTP 服务器上。

过程
步骤 1

打开 Cisco Unified Communications Manager 上的 Cisco Unified OS Administration 界面。

步骤 2

选择软件升级 > TFTP 文件管理。

步骤 3

选择上传文件。

步骤 4

在上传文件部分中选择浏览。

步骤 5

在文件系统中选择配置文件。
步骤 6

请勿在上传文件部分的目录文本框中指定任何值。

您应将目录文本框留空，以使配置文件处在 TFTP 服务器的默认目录中。

步骤 7

选择上传文件。

重新启动您的 TFTP 服务器

您必须先重新启动 TFTP 服务器，客户端方可访问配置文件。

过程
步骤 1

打开 Cisco Unified Communications Manager 上的 Cisco Unified Serviceability 界面。

步骤 2

选择工具 > 控制中心 - 功能服务。

步骤 3

从 CM 服务部分中选择 Cisco Tftp。

步骤 4

选择重新启动。

此时会显示一个窗口，提示您确认重新启动。
步骤 5

单击确定。

将会显示 Cisco Tftp 服务重新启动操作成功状态。

步骤 6

选择刷新以确保 Cisco Tftp 服务成功启动。

下一步做什么

要验证您的 TFTP 服务器是否提供配置文件，请在任何浏览器中打开该配置文件。通常，您可访问位于以下 URL 地址的全局配置文件：http://tftp_server_address:6970/jabber-config.xml

配置文件

有关 jabber-config 配置文件结构、组元素、参数和示例的详细信息，请参阅《Cisco Jabber 参数参考指南》。

在电话配置中为桌面客户端设置参数

客户端可以从 Cisco Unified Communications Manager 上的以下位置检索电话配置中的配置设置：

企业电话配置

适用于整个群集。


注

对于仅具有 IM and Presence Service 功能（仅 IM）的用户，您必须在"企业电话配置"窗口中设置电话配置参数。

通用电话配置文件配置

适用于设备组，并且优先于群集配置。

Cisco Unified 客户端服务框架 (CSF) 电话配置

适用于各 CSF 桌面设备，并且优先于组配置。

电话配置中的参数

下表列出了您可以在电话配置的产品特定配置布局部分设置的配置参数，以及从客户端配置文件映射对应的参数：

桌面客户端设置配置 说明
视频呼叫

启用或禁用视频功能。

已启用（默认值）
用户可以发送和接收视频通话。
已禁用
用户无法发送或接收视频呼叫。
限制 

此参数仅适用于 CSF 设备配置。

要在文件传输中屏蔽的文件类型

限制用户传输特定的文件类型。

将文件扩展名设置为值，例如 .exe。

使用分号分隔多个值，例如 

.exe;.msi;.rar;.zip
自动在电话控制中启动
当客户端第一次启动时，可为用户设置电话类型。在初始启动后，用户可以更改电话类型。然后，客户端保存用户首选项，并在后续启动时使用。
已启用
使用桌面电话设备进行呼叫。
已禁用（默认值）
使用软件电话 (CSF) 设备进行呼叫。
Jabber Windows 版本软件更新服务器 URL

指定包含客户端更新信息的 XML 文件的 URL。客户端使用此 URL 从您的 Web 服务器检索 XML 文件。

在基于混合云的部署中，您应该使用Cisco Webex管理工具配置自动更新。

问题报告服务器 URL

指定可让用户提交问题报告的自定义脚本的 URL。

在电话配置中为移动客户端设置参数

客户端可以从 Cisco Unified Communications Manager 上的以下位置检索电话配置中的配置设置：

  • Cisco iPhone 版双模 (TCT) 配置 — 适用于各个 TCT 设备，并且优先于组配置。

  • 平板电脑版 Cisco Jabber (TAB) 配置 — 适用于各个 TAB 设备，并且优先于组配置。

电话配置中的参数

下表列出了您可以在电话配置的产品特定配置布局部分设置的配置参数，以及从客户端配置文件映射对应的参数：

桌面客户端设置配置 说明
视频呼叫

启用或禁用视频功能。

已启用（默认值）
用户可以发送和接收视频通话。
已禁用
用户无法发送或接收视频呼叫。
限制 

此参数仅适用于 CSF 设备配置。

要在文件传输中屏蔽的文件类型

限制用户传输特定的文件类型。

将文件扩展名设置为值，例如 .exe。

使用分号分隔多个值，例如 

.exe;.msi;.rar;.zip
自动在电话控制中启动
当客户端第一次启动时，可为用户设置电话类型。在初始启动后，用户可以更改电话类型。然后，客户端保存用户首选项，并在后续启动时使用。
已启用
使用桌面电话设备进行呼叫。
已禁用（默认值）
使用软件电话 (CSF) 设备进行呼叫。
Jabber Windows 版本软件更新服务器 URL

指定包含客户端更新信息的 XML 文件的 URL。客户端使用此 URL 从您的 Web 服务器检索 XML 文件。

问题报告服务器 URL

指定可让用户提交问题报告的自定义脚本的 URL。

代理设置的可选配置

您的客户端可能会使用代理设置连接到服务。

对这些 HTTP 请求使用代理时，以下限制适用：

  • 不支持代理身份认证。

  • 支持绕过列表中的通配符。

  • Cisco Jabber 支持使用 HTTP 连接的 HTTP 请求的代理，但使用 HTTPS 连接时不支持代理。

  • 不支持 Web 代理自动发现 (WAPD)，必须禁用。

如有必要，请按照以下适用于您的客户端类型的步骤配置代理设置。

配置 Cisco Jabber Windows 版本 的代理设置

在 Internet 属性的局域网 (LAN) 设置中配置 Windows 代理设置。

过程
步骤 1

选择连接选项卡，然后选择局域网设置。

步骤 2

使用以下选项之一配置代理：

  • 要使用自动配置，请指定 .pac 文件 URL。
  • 对于代理服务器，指定一个明确的代理地址。

配置 Cisco Jabber Mac 版本 的代理设置

在系统首选项中配置 Mac 的代理设置。

过程
步骤 1

选择系统首选项 > 网络

步骤 2

从列表中选择您的网络服务，然后选择高级 > 代理。

步骤 3

使用以下选项之一配置代理：

  • 要使用自动配置，请指定 .pac 文件 URL。
  • 对于代理服务器，指定一个明确的代理地址。

配置 Cisco Jabber iPhone 和 iPad 版本的代理设置

使用以下方法之一在 iOS 设备的 Wi-fi 设置中配置代理设置：

过程
步骤 1

选择 Wi-Fi > HTTP 代理 > 自动并指定 .pac 文件 URL 作为自动配置脚本。

步骤 2

选择 Wi-Fi > HTTP 代理 > 手动并指定明确的代理地址。

配置 Cisco Jabber Android 版本 的代理设置

过程

使用以下方法之一在 Android 设备的 Wi-fi 设置中配置代理设置：

  • 在Wi-Fi > 修改网络 > 显示高级选项 > 代理设置 > 自动选项卡中，将 .pac 文件 URL 指定为自动配置脚本。
    注 

    此方法仅适用于安装了 Android OS 5.0 及更高版本的设备和 Cisco DX 系列设备。

  • 在Wi-Fi 网络 > 修改网络 > 显示高级选项 > 代理设置 > 自动选项卡中，指定明确的代理地址。