升级 NetQ 代理

生命周期管理使您可以将交换机上现有 NetQ 代理升级到最新代理版本。您可以同时仅升级 NetQ 代理或同时升级 NetQ 代理和 NetQ CLI。您可以同时运行最多五个作业;但是,给定交换机一次只能出现在一个正在运行的作业中。

准备 NetQ 代理升级

在升级之前,请确保您拥有适当的文件和凭据

  1. 上传升级镜像

  2. (可选)指定默认升级版本

  3. 验证或添加交换机访问凭据

  4. (可选)创建代理配置配置文件,如下一节所述。

  1. 验证或添加交换机访问凭据

  2. 配置交换机角色以确定交换机的升级顺序。

  3. 上传 Cumulus Linux 升级镜像

  4. (可选)创建代理配置配置文件,如下一节所述。

代理配置配置文件

您可以设置配置配置文件,以指示在 Cumulus Linux 交换机上安装或升级 NetQ 时,您希望如何配置 NetQ。创建配置配置文件时,您可以调整以下代理设置

  • NetQ 代理用于与 NetQ 服务器通信的 VRF
  • 是否启用或禁用 WJH
  • 代理日志级别
  • 代理 CPU 限制

默认配置配置文件NetQ 默认配置设置为在管理 VRF 中运行并提供信息级别日志记录。WJH 和 CPU 限制均已禁用。

创建配置配置文件

在创建配置配置文件之前,请使用 UI 生成 AuthKeys。复制访问密钥和密钥到可访问的位置。

  1. 展开 菜单 并选择 管理交换机

  2. 选择 NetQ 代理配置

  3. 在 NetQ 代理配置卡上,选择 添加配置

  4. 输入配置文件名称,然后从 UI 中提供的选项中选择设置。选择 高级 以设置日志级别和 CPU 限制的值

card displaying agent configuration profile settings
  1. 输入您的 NetQ CLI 身份验证密钥,然后选择 添加

使用 netq lcm add netq-config 命令创建 NetQ 代理配置配置文件。如果您使用带内接口管理交换机,则必须使用 inband-interface 选项指定接口名称

cumulus@netq-server:~$ netq lcm add netq-config 
    config-profile-name <text-config-profile> 
    accesskey <text-access-key> 
    secret-key <text-secret-key> 
    [cpu-limit <text-cpu-limit>] 
    [log-level error | log-level warn | log-level info | log-level debug] 
    [vrf default | vrf mgmt | vrf <text-config-vrf>] 
    [wjh enable | wjh disable] 
    [inband-interface <text-inband-interface>]

执行 NetQ 代理升级

以下步骤假定您的交换机上已安装 NetQ 版本。如果未安装 NetQ,请运行交换机发现以查找所有已安装和未安装 NetQ 的 Cumulus Linux 交换机,并在发现工作流程中执行升级。

  1. 展开 菜单 并选择 管理交换机

  2. 找到“交换机”卡,然后单击 管理。选择要升级的交换机。

  3. 单击表格上方的 升级 NetQ,然后按照 UI 中的步骤操作。

  4. 验证选择用于升级的交换机数量是否符合您的预期。

  5. 输入升级作业的名称。名称最多可以包含 22 个字符(包括空格)。

  6. 查看每个交换机。如果您想更改代理配置配置文件,请单击 更改配置,然后选择要应用于所有选定交换机的备用配置文件。或者,您可以通过单击当前配置文件并选择备用配置文件,将不同的配置文件应用于每个交换机。

card displaying agent configuration profiles
  1. 查看摘要,其中指示交换机的数量和要使用的配置配置文件。如果任何一个不正确,请单击 返回 并查看您的选择。

  2. 选择要升级的 NetQ 代理版本。如果您已指定默认版本,请保留 默认 选择。否则,单击 自定义 并从列表中选择备用版本。

默认情况下,NetQ 代理和 CLI 在选定的交换机上升级。如果您想升级 NetQ CLI,请单击 高级 并将选择更改为

  1. NetQ 执行多项检查,以消除升级过程中可预防的问题。当所有预检查都通过时,单击 升级 以启动升级。

要在单个或多个交换机上升级 NetQ 代理,请运行

netq lcm upgrade netq-image 
    job-name <text-job-name> 
    [netq-version <text-netq-version>] 
    [upgrade-cli True | upgrade-cli False] 
    hostnames <text-switch-hostnames> 
    [config_profile <text-config-profile>]

以下示例创建一个名为 *upgrade-example 的 NetQ 代理升级作业。它使用 NetQ 代理版本 4.12.0 升级 spine01spine02 交换机。

cumulus@switch:~$ netq lcm upgrade netq-image job-name upgrade-example netq-version 4.12.0 hostnames spine01,spine02

分析 NetQ 代理升级结果

启动升级后,您可以在 NetQ UI 中监控进度。成功的升级用绿色 表示。失败的升级会显示错误消息,指示失败原因。

要使用 CLI 查看升级作业的进度,请运行

netq lcm show upgrade-jobs netq-image [json]
netq lcm show status <text-lcm-job-id> [json]
示例 netq lcm show upgrade-jobs