目录

简介

先决条件

要求

使用的组件

版本要求

概述

设置和配置步骤

步骤1:生成Artifactory API密钥

第二步：在Cloud Connect上配置Artictory URL和API密钥

第三步：从板载VOS节点到协调控制节点

第4步：将Windows节点加入协调控制节点

第5步：更新inventory.conf文件

第6步：验证入网节点以进行协调

简介

本文档介绍配置Contact Center Enterprise Orchestration的步骤。

先决条件

要求

Cisco 建议您了解以下主题：

- 统一联络中心企业版(UCCE)12.x

- 套装联络中心企业版(PCCE)12.x

- 思科语音门户(CVP)12.x

- Finesse 12.x

- 思科统一情报中心(CUIC)12.x

- 虚拟语音浏览器(VVB)12.x

使用的组件

本文档中的信息基于以下软件版本：

- 云连接12.6(1)ES3

- UCCE 12.5(1)

- Finesse 12.5(1)

- CUIC 12.5(1)

- CVP 12.5(1)

- VVB 12.5(1)

注意：在本文档中，CUIC是指同时驻留安装和独立安装的CUIC、实时数据(LD)和身份服务器(IDS)。仅当指令特定于子组件时，才会引用该组件。

本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的网络处于活动状态，请确保您了解所有命令的潜在影响。

版本要求

UCCE/PCCE 12.5(1)（任一）

- ES66（ES55是在安装ES66之前必须安装的产品）

- UCCE 12.5(2)MR

UCCE/PCCE 12.6(1)

- 无额外要求

云连接版本：12.6(1)

- ES3

Finesse、CUIC、VVB:12.5(1)

- ucos.orchestration.enable-12.5.1.cop.sgn

- ucos.keymanagement.cop.sgn

Finesse、CUIC、VVB:12.6(1)

- ucos.keymanagement.cop.sgn

CVP 12.5(1)

- ES23

CVP 12.6(1)

- 无额外要求

Cloud Connect升级特别说明。

注意：将Cloud Connect从12.5升级到12.6时，必须首先安装ucos.keymanagement.cop.sgn。如果升级未完成，则升级失败。

注：将Cloud Connect从12.5升级到12.6时，必须将磁盘从146GB增加到246GB。如果在升级之前错过此步骤，请执行以下步骤：

第1步：停止Cloud Connect服务器。

第2步：将vSphere中的磁盘扩展到246GB。

第3步：启动Cloud Connect服务器。

VOS自动扩展分区。这可确保下载的更新不会导致公共分区出现空间不足的情况。

概述

云连接12.6(1)以后支持CCE协调。

Cloud Connect服务器版本12.6(1)在以下情况下支持协调：

- CCE 12.5 ES/COP和Windows更新可以从12.6 Cloud Connect服务器协调

- 从12.6 Cloud Connect服务器可协调CCE 12.5到12.6软件升级

设置和配置步骤

步骤1:生成Artifactory API密钥

1. 使用您的CCO用户名和密码登录https://devhub-download.cisco.com/console/。

2. 在控制台页面上选择Manage Download Key（管理下载密钥），如图所示。

3. 点击Generate Key选项以生成API密钥。“管理下载密钥”(Manage Download Key)页面中提供了“查看和撤销密钥”(View and Revoke Key)选项。

4. 选择“复制”按钮将API密钥复制到剪贴板。

注：用于生成API密钥的CCO ID必须具有必要的软件升级授权。您使用的CCO ID必须具有有效的SWSS（服务合同）或Flex订用才能获得必要的授权。

注意：您必须每六个月登录https://devhub-download.cisco.com/console一次，以延长API密钥的有效性。

第二步：在Cloud Connect上配置Artictory URL和API密钥

- 思科将所有软件产品托管在基于云的工厂中，Cloud Connect服务器使用该工产品来下载和通知新的更新。

- 必须使用思科托管软件Artifactory URL、存储库名称和API密钥配置Cloud Connect服务器。

1.运行命令utils image-repository set以配置artifactory下载，如映像所示。

a.提供工厂URL:https://devhub-download.cisco.com/binaries。

b.提供artfactory存储库名称ent-platform-release-external。

c.粘贴您生成的API密钥。出于安全原因，API密钥显示为星号。

2.运行命令utils image-repository show以查看Cloud Connect服务器中配置的Artictory URL、存储库名称和API密钥，如映像中所示。

注意：在CLI上运行utils image-repository set命令之前，请导航到EULA URL(https://software.cisco.com/download/eula)并接受EULA。 如果未执行此操作，utils image-repository set命令将失败，并出现错误：用于生成API密钥的CCO ID不符合最终用户许可协议，请使用有效的CCO ID。

有关详细信息，请参阅Cisco Bug ID CSCvy78680。

注：这两个命令只能从Cloud Connect服务器的发布方节点执行。

当在发布方节点上执行utils image-repository set命令并成功执行结果时，映像存储库配置从发布方节点自动复制到订用方节点。

注意：可随时使用utils image-repository set CLI更改部署中的导出受限与不受限制的软件选项。

重新启动Cloud Connect服务器以强制清除和下载受限软件与无限制软件。重新启动后10分钟开始下载。

附注：有关艺人生产业务的附注：

成功配置artifactory详细信息后，工件将在服务器时间02:00 A.M.本地下载到Cloud Connect服务器。

只有在下载项目后才能执行协调操作，如补丁安装、回滚或升级。

如果在配置步骤后必须立即下载项目，则可以重新启动Cloud Connect服务器，并在重新启动后10分钟开始下载。

与业务流程相关的CLI命令的使用在下载开始时被阻止，并且此持续时间取决于要下载的对象数量。

注意：如果Cloud Connect服务器需要代理才能访问互联网，则必须安装ES3或更高版本。有关代理配置的详细信息，请参阅《UCCE安装和升级指南》。

第三步：从板载VOS节点到协调控制节点

先决条件:

- 确保满足所有系统版本要求。

- 将证书从Cloud Connect集群（Pub和Sub）导入到所有目标VOS服务器上的tomcat-trust（自签名的tomcat，CA签名的根/中间名）

要将每个Finesse、CUIC、VVB、IDS和LD系统加入到Cloud Connect服务器，请运行命令，utils system onboard initiate从相应VOS集群的发布方节点（如图所示）。

1.提供Cloud Connect发布方节点的FQDN。

2.提供Cloud Connect服务器的应用用户名。

3.提供Cloud Connect服务器的应用用户密码。

- 从VOS节点运行板载启动时，云连接服务器的发布方节点必须处于联机状态。

- 从VOS节点运行板载启动时，必须使用云连接发布方服务器的FQDN。

- 必须在所有VOS发布器（Finesse、CUIC、LD、IdS、所有VVB）上运行utils system onboard initiate命令

注：如果系统（集群）板载到Cloud Connect服务器时出现部分错误，请检查错误原因并更正错误。然后，运行utils system onboard update命令而不是utils system onboard initiate命令。

注意：仅当云连接服务器中的发布服务器和订用服务器节点均可访问时，才允许入网。

注意：如果Cloud Connect服务器损坏并重新进行安装，管理员必须从VOS节点运行utils system onboard remove ，然后运行utils system onboard initiate以重新注册VOS节点。

注：要验证/查找云连接服务器的应用用户名，请从Cloud Connect Servers的CLI上的applicationuser运行命令run sql select *。

第4步：将Windows节点加入协调控制节点

板载过程有助于在Cloud Connect节点和Windows节点之间建立无密码连接。要将基于Windows的节点加入协调控制节点，请执行以下步骤：

在Windows节点上配置SSH公钥：

a.导航到%Users%\<logonUser>\.ssh\ 并创建authorized_keys文件（如果该文件不存在）。（authorized_keys扩展名类型为“文件”，不能修改）

注意：用户不得从系统中删除，并且必须是具有域管理员或本地管理权限的域用户。

b.打开浏览器并输入Cloud Connect发布者URL:https://<CloudConnectIP>:8445/inventory/controlnode/key

c.提供您的Cloud Connect应用用户凭证。身份验证成功后，REST API响应将获取云连接公共SSH密钥。

d.将此公钥值复制到%Users%\<logonUser>\.ssh\中的authorized_keys文件中。

URL的输出示例如下所示。在输出中，仅将以ssh-rsa开头并以root@localhost结尾的部分复制到authorized_keys文件中。

{"category":"PUBLISHER","hostName":"cc125clouda.uclabservices.com","publicKey":"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDfJDl7RUZ/Umdflp5r3IqMaoV8WSrr7iLBOWindC0lGeGPYkprVW2xq6H6I8FuEjnBkrfEe8DUahVDVe783lFTb9nGdgRxAF7LR1MpKFOqOV9WRY8btYwRb0ZViO/GDupB2jBNaAj4M2EPPkKoC5OhcZrZ+4Zry/GEMd9uVwziyOh/nBxGuqg28euMiU2+G7m3qE3wo4zoJlvyOHkoM4tKzpiqqn0VdIRQ5xPhOl771AW6Rsiq4naG0f/hmVF347goavmF0O0lf1CbF4RfMoO1zxxlj+zi7RE1jl9aRMtzRmZC4uyIIQFtrZBbBbkzbk8dJo1u9A7Ds1rUcdEuc0Vv root@localhost"}

显示示例的authorized_keys文件。

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDfJDl7RUZ/Umdflp5r3IqMaoV8WSrr7iLBOWindC0lGeGPYkprVW2xq6H6I8FuEjnBkrfEe8DUahVDVe783lFTb9nGdgRxAF7LR1MpKFOqOV9WRY8btYwRb0ZViO/GDupB2jBNaAj4M2EPPkKoC5OhcZrZ+4Zry/GEMd9uVwziyOh/nBxGuqg28euMiU2+G7m3qE3wo4zoJlvyOHkoM4tKzpiqqn0VdIRQ5xPhOl771AW6Rsiq4naG0f/hmVF347goavmF0O0lf1CbF4RfMoO1zxxlj+zi7RE1jl9aRMtzRmZC4uyIIQFtrZBbBbkzbk8dJo1u9A7Ds1rUcdEuc0Vv root@localhost

e.重复步骤b、c和d以获取Cloud Connect用户公共密钥（如果Cloud Connect是HA设置）。

注意:Cloud Connect发布服务器和订用服务器公钥必须复制到单个authorized_keys文件中。发布服务器和订阅服务器条目必须位于单独的行中，并且不得在行尾使用任何额外的空格、逗号或任何特殊字符。

f.重新启动OpenSSH服务：

- OpenSSH SSH服务器

- OpenSSH身份验证代理

使用以下步骤排除SSH登录故障：

a.导航至C:\ProgramData\ssh，然后在文本编辑器中打开文件sshd_config。

b.找到此文件中开始于#日志记录的部分

c.取消对SyslogFacility和LogLevel行的注释。

d.如示例所示，将SyslogFacility更改为LOCAL0，将LogLevel更改为DEBUG

# Logging

SyslogFacility LOCAL0

LogLevel DEBUG

e.保存sshd_config文件，然后重新启动OpenSSH SSH服务器服务。

f.将日志文件写入C:\ProgramData\ssh\logs\sshd.log

第5步：更新inventory.conf文件

1.运行命令utils system inventory export将资产上传到SFTP服务器，如图所示。

a.提供SFTP服务器的IP地址或FQDN。

b.提供对SFTP服务器具有读/写访问权限的用户名。

c.提供用户的密码。

d.提供用于以UNIX/Linux格式写入清单文件的目录。

示例：/voice/ipcc/Enterprise/Orchestration

2.编辑资产以包括VOS和Windows组件。

- 语法、对齐和缩进必须与资产文件中的完全相同。

- CRLF行尾必须为UNIX样式。因此，可以使用基于Linux或基于Mac OS的编辑器创建Windows清单文件。也可以使用Notepad++之类的程序。

- 组件名称（如CVPREPORTING、ROGGER、PG等）必须为大写。

注:inventory.conf文件对缩进敏感，请参阅/使用映像和示例配置文件

可在此处下载显示正确格式的示例文件：https://github.com/CXCCSummit/Repository

VOS服务器示例如图所示：

Windows Server示例如图所示：

3.根据需要编辑清单文件中的字符串。

deploymentName:为部署提供唯一名称。

- 此名称显示在电子邮件通知的主题行中。如果未配置，则邮件通知的主题行仅包含过程类型和总体状态。

deploymentType：此字段用于升级、回滚或交换机转发过程中的兼容性检查。

支持的部署类型包括：

- UCCE-2000代理

- UCCE-4000代理

- PCCE-2000 — 代理

- PCCE-4000代理

- HCS-CC-2000 — 代理

- HCS-CC-4000 — 代理

注意：查看有关支持的部署类型的这些说明。

Cisco、Cisco和Cisco代理12000署模24000不支26000协调功能。

协调当前不支持HCS-SCC（小型联系中心）部署模式。

确保在此字段中输入的值符合支持的部署类型列表格式。部署类型区分大小写。

注意：如有必要，管理员可以根据部署类型和首选部署名称更新或编辑默认值。

4.在Cloud Connect发布方节点上运行命令utils system inventory import，以从SFTP服务器导入更新的资产，如映像所示。

a.提供SFTP服务器的IP地址或FQDN。

b.提供对SFTP服务器具有读/写访问权限的用户名。

c.提供用户的密码。

d.提供用于以UNIX/Linux格式写入清单文件的目录。

示例：/voice/ipcc/Enterprise/Orchestration

e.回答“是”以允许新的清单文件替换当前清单。

第6步：验证入网节点以进行协调

要验证VOS和Windows节点已成功入网，并要检查协调功能是否已准备好使用，请运行命令utils deployment test-connection，如图所示。