lcm

netq lcm add cl-image

将 Cumulus Linux 映像（.bin 文件）添加到生命周期管理存储库。映像必须与您要升级的交换机的版本、架构和 ASIC 供应商相匹配。有关详细说明，请参阅升级 Cumulus Linux。

语法

netq lcm add cl-image <text-cl-image-path>

必需参数

参数	值	描述
cl-image	<text-cl-image-path>	从此位置添加 Cumulus Linux .bin 文件。您必须指定完整路径，包括文件名。

选项

无

示例用法

cumulus@switch:~$ netq lcm add cl-image /path/to/download/cumulus-linux-4.2.0-mlnx-amd64.bin

netq lcm show cl-images
netq lcm upgrade cl-image
netq lcm del cl-image
netq lcm add netq-image

netq lcm add credentials

配置您计划使用 NetQ 生命周期管理功能管理的所有交换机的访问凭据。您可以选择使用用户名和密码进行基本身份验证，或使用 SSH 公钥/私钥身份验证。使用 SSH 密钥方法配置交换机时，您必须具有 sudoer 权限。

要获取访问配置文件的名称，请运行 netq lcm show credentials。

Cumulus Linux 的默认凭据已从 cumulus/CumulusLinux! 更改为 cumulus/cumulus，适用于 4.2 及更高版本。有关详细信息，请阅读Cumulus Linux 用户帐户。

语法

netq lcm add credentials
    profile_name <text-switch-profile-name>
    username <text-switch-username>
    (password <text-switch-password> | ssh-key <text-ssh-key>)

必需参数

参数	值	描述
profile_name	<text-switch-profile-name>	指定访问配置文件的名称
username	<text-switch-username>	指定可以配置交换机的用户的用户名
password	<text-switch-password>	指定与用户名关联的密码，以便用户可以配置交换机
ssh-key	<text-ssh-key>	指定配置交换机所需的私钥。您必须已在每个交换机上安装公钥。

选项

无

示例用法

cumulus@switch:~$ netq lcm add credentials profile_name n-2000 username cumulus password cumulus

netq lcm attach credentials
netq lcm show credentials
netq lcm del credentials

netq lcm add default-version

配置或更改 Cumulus Linux 或 NetQ 版本，以便在升级期间自动使用。此值可以在升级期间根据需要覆盖，但可以简化大多数交换机的升级过程。

语法

此命令有两种形式可用：一种用于 Cumulus Linux，另一种用于 NetQ。

netq lcm add default-version
    cl-images <text-cumulus-linux-version>

netq lcm add default-version
    netq-images <text-netq-version>

必需参数

参数	值	描述
default-version	NA	指定交换机升级的默认 Cumulus Linux 或 NetQ 版本
cl-images	<text-cumulus-linux-version>	将默认 Cumulus Linux 升级映像配置为此版本
netq-images	<text-netq-version>	将默认 NetQ 升级映像配置为此版本

选项

无

示例用法

cumulus@switch:~$ netq lcm add default-version cl-images 5.9.1

cumulus@switch:~$ netq lcm add default-version netq-images 4.12.0

netq lcm show default-version

netq lcm add netq-config

创建 NetQ 代理配置配置文件。

语法

netq lcm add netq-config 
    config-profile-name <text-config-profile> 
    access-key <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-interface-name>]

必需参数

参数	值	描述
config-profile-name	<text-config-profile>	指定配置文件的名称
access-key	<text-access-key>	NetQ 访问密钥
secret-key	<text-secret-key>	NetQ 密钥

选项

选项	值	描述
cpu-limit	<text-cpu-limit>	指定 NetQ 代理在交换机上不能超过的 CPU 资源百分比
log-level	错误、警告、信息、调试	指定日志级别
vrf	默认、mgmt、<text-config-vrf>	将 VRF 设置为默认、管理或指定自定义 VRF
wjh	启用、禁用	启用或禁用“刚刚发生”事件
inband-interface	<text-interface-name>	为带内部部署创建代理配置文件

示例用法

以下示例创建一个名为“test-set-all”的配置。代理配置为不超过 CPU 资源的 60%，日志级别设置为错误，VRF 设置为管理，并且启用了 WJH 事件。

cumulus@switch:~$ netq lcm add netq-config config-profile-name test-set-all access-key KEY secret-key SKEY cpu-limit 60 log-level error vrf mgmt wjh enable
NetQ config profile test-set-all successfully added
 
cumulus@switch:~$ netq lcm show netq-config
ID                        Name            Default Profile                VRF             WJH       CPU Limit Log Level Last Changed
------------------------- --------------- ------------------------------ --------------- --------- --------- --------- -------------------------
config_profile_d349823e2a test-set-all    No                             mgmt            Enable    60%       error     Thu Apr 20 08:38:37 2023
ae91a083ed7874d5a3c4fd09b
1e99963bda91efccecfc5421a
faa8
config_profile_3289efda36 NetQ default co Yes                            mgmt            Disable   Disable   info      Mon Apr 17 06:21:35 2023
db4065d56f91ebbd34a523b45 nfig
944fbfd10c5d75f9134d42023
eb2b

netq lcm show netq-config
netq lcm del netq-config

netq lcm add netq-image

将 NetQ 映像（.deb 软件包）添加到生命周期管理存储库。映像必须与您要升级的交换机的版本、架构和操作系统相匹配。对于每个版本的 NetQ，您都必须添加 netq-agent 和 netq-apps 软件包。有关更多信息，请参阅NetQ 和网络操作系统映像。

语法

netq lcm add netq-image <text-netq-image-path>

必需参数

参数	值	描述
netq-image	<text-netq-image-path>	从此位置添加 NetQ Debian 软件包。您需要指定完整路径，包括文件名。

选项

无

示例用法

cumulus@switch:~$ netq lcm add netq-image /path/to/download/netq-agent_4.0.0-ub18.04u33~1614767175.886b337_amd64.deb
cumulus@switch:~$ netq lcm add netq-image /path/to/download/netq-apps_4.0.0-ub18.04u33~1614767175.886b337_amd64.deb

netq lcm show netq-images
netq lcm upgrade netq-image
netq lcm del netq-image
netq lcm add cl-image

netq lcm add role

为一个或多个交换机分配或更改角色，该角色定义其在 Clos 拓扑中的位置，并影响您可以升级交换机的顺序。

语法

netq lcm add role (superspine | spine | leaf | exit)
    switches <text-switch-hostnames>

必需参数

参数	值	描述
role	超级脊、脊、叶、出口	将此角色分配给指定的交换机
switches	<text-switch-hostnames>	将指定的角色分配给具有这些主机名的交换机。使用逗号分隔列表（无空格）同时将角色分配给多个交换机。

选项

无

示例用法

cumulus@switch:~$ netq lcm add role spine switches spine01

cumulus@switch:~$ netq lcm add role leaf switches leaf01,leaf02,leaf03,leaf04

无

netq lcm add ztp-script

将 ZTP 脚本添加到您的 NetQ VM，以配置运行 Cumulus Linux 的交换机。此命令的输出提供要在 DHCP 服务器选项 239 配置中使用的 URL，以指示交换机检索脚本。

语法

netq lcm add ztp-script <text-ztp-script-path>

必需参数

参数	值	描述
ztp-script	<text-ztp-script-path>	文件路径，指定 ZTP 脚本的位置

选项

无

示例用法

cumulus@netq-server:~$ netq lcm add ztp-script /home/cumulus/ztp.sh
ZTP script ztp.sh uploaded successfully and can be downloaded from http://10.10.10.10/lcm/asset/ztp.sh
cumulus@netq-server:~$

netq lcm del ztp-script
netq lcm show ztp-scripts

netq lcm attach credentials

将访问配置文件分配给一个或多个交换机。有关分步说明，请参阅交换机管理。

要显示 profile_id，请运行 netq lcm show credentials。

要显示 hostnames，请运行 netq lcm show switches。

语法

netq lcm attach credentials 
    profile_id <text-switch-profile-id> 
    hostnames <text-switch-hostnames>

必需参数

参数	值	描述
profile_id	<text-switch-profile-id>	将具有此 ID 的访问配置文件附加到交换机
hostnames	<text-switch-hostnames>	将访问配置文件分配给此主机名

选项

无

示例用法

cumulus@switch:~$ netq lcm attach credentials profile_id credential_profile_3eddab251bddea9653df7cd1be0fc123c5d7a42f818b68134e42858e54a9c289 hostnames tor-1,tor-2
Attached profile to switch(es).

netq lcm add credentials
netq lcm detach credentials
netq lcm show credentials
netq lcm show switches

netq lcm del cl-image

从 NetQ 生命周期管理存储库中删除选定的 Cumulus Linux 映像 (.bin)。使用带有 json 选项的 netq lcm show cl-image 命令获取映像标识符。

语法

netq lcm del cl-image <text-cl-image-id>

必需参数

参数	值	描述
cl-image	<text-cl-image-id>	删除具有此标识符的 Cumulus Linux 映像

选项

无

示例用法

cumulus@switch:~$ netq lcm show cl-images json
[
    {
        "id": "image_cc97be3955042ca41857c4d0fe95296bcea3e372b437a535a4ad23ca300d52c3",
        "name": "cumulus-linux-4.2.0-vx-amd64-1594775435.dirtyzc24426ca.bin",
        "clVersion": "4.2.0",
        "cpu": "x86_64",
        "asic": "VX",
        "lastChanged": 1609884659654.0
    },
...
cumulus@switch:~$ netq lcm del cl-image image_cc97be3955042ca41857c4d0fe95296bcea3e372b437a535a4ad23ca300d52c3

netq lcm add cl-image
netq lcm show cl-images
netq lcm upgrade cl-image

netq lcm del credentials

删除使用生命周期管理在交换机上升级 Cumulus Linux 或 NetQ 所需的访问凭据。运行 netq show credentials 以获取配置文件 ID。有关分步示例，请参阅删除访问配置文件。

语法

netq lcm del credentials 
    profile_ids <text-credential-profile-ids>

必需参数

参数	值	描述
credentials	NA	删除用于升级交换机的访问凭据
profile_ids	<text-credential-profile-ids>	删除分配了此 ID 的配置文件

选项

无

示例用法

cumulus@switch:~$ netq lcm del credentials profile_id credential_profile_3eddab251bddea9653df7cd1be0fc123c5d7a42f818b68134e42858e54a9c289

netq lcm add credentials
netq lcm detach credentials
netq lcm show credentials

netq lcm del netq-config

删除 NetQ 配置配置文件。您可以使用 netq lcm show netq-config 获取配置配置文件 ID。

语法

netq lcm del netq-config config-profile-id <text-config-profile-id>

必需参数

参数	值	描述
config-profile-id	<text-config-profile-id>	删除具有此标识符的 NetQ 配置配置文件

选项

无

示例用法

要获取配置配置文件 ID，请运行 netq lcm show netq-config

cumulus@switch:~$ netq lcm show netq-config
ID                        Name            Default Profile                VRF             WJH       CPU Limit Log Level Last Changed
------------------------- --------------- ------------------------------ --------------- --------- --------- --------- -------------------------
config_profile_d349823e2a test-set-all    No                             mgmt            Enable    60%       error     Thu Apr 20 08:38:37 2023
ae91a083ed7874d5a3c4fd09b
1e99963bda91efccecfc5421a
faa8
config_profile_3289efda36 NetQ default co Yes                            mgmt            Disable   Disable   info      Mon Apr 17 06:21:35 2023
db4065d56f91ebbd34a523b45 nfig
944fbfd10c5d75f9134d42023
eb2b

获取配置文件 ID 后，运行删除命令

cumulus@switch:~$ netq lcm del netq-config config-profile-id config_profile_d349823e2aae91a083ed7874d5a3c4fd09b1e99963bda91efccecfc5421afaa8
NetQ config profile ID config_profile_d349823e2aae91a083ed7874d5a3c4fd09b1e99963bda91efccecfc5421afaa8 successfully deleted

您可以使用 netq lcm show netq-config 验证配置配置文件是否已删除

cumulus@switch:~$ netq lcm show netq-config
ID                        Name            Default Profile                VRF             WJH       CPU Limit Log Level Last Changed
------------------------- --------------- ------------------------------ --------------- --------- --------- --------- -------------------------
config_profile_3289efda36 NetQ default co Yes                            mgmt            Disable   Disable   info      Mon Apr 17 06:21:35 2023
db4065d56f91ebbd34a523b45 nfig
944fbfd10c5d75f9134d42023
eb2b

netq lcm add netq-config
netq lcm show netq-config

netq lcm del netq-image

从 NetQ 生命周期管理存储库中删除选定的 NetQ 映像 (.deb)。使用带有 json 选项的 netq lcm show netq-image 命令获取映像标识符。请注意，要完全删除版本，您必须同时删除 netq-agent 和 netq-apps 映像。

语法

netq lcm del netq-image <text-netq-image-id>

必需参数

参数	值	描述
netq-image	<text-netq-image-id>	删除具有此标识符的 NetQ 映像

选项

无

示例用法

cumulus@switch:~$ netq lcm show netq-image json
[
    {
        "id": "image_d23a9e006641c675ed9e152948a9d1589404e8b83958d53eb0ce7698512e7001",
        "name": "netq-agent_4.0.0-cl4u32_1609391187.7df4e1d2_amd64.deb",
        "netqVersion": "4.0.0",
        "clVersion": "cl4u32",
        "cpu": "x86_64",
        "imageType": "NETQ_AGENT",
        "lastChanged": 1609885430638.0
    },
...

cumulus@switch:~$ netq lcm del netq-image image_d23a9e006641c675ed9e152948a9d1589404e8b83958d53eb0ce7698512e7001

cumulus@switch:~$ netq lcm del netq-image image_68db386683c796d86422f2172c103494fef7a820d003de71647315c5d774f834

netq lcm add netq-image
netq lcm show netq-images
netq lcm upgrade netq-image

netq lcm del ztp-script

从您的 NetQ 服务器中删除 ZTP 脚本。使用 netq lcm show ztp-scripts 命令查看所有 ZTP 脚本的列表以及它们的脚本标识号。

语法

netq lcm del ztp-script <text-ztp-script-id>

必需参数

参数	值	描述
ztp-script	<text-ztp-script-id>	删除具有此脚本 ID 的 ZTP 脚本

选项

无

示例用法

cumulus@netq-server:~$ netq lcm show ztp-scripts json
[
    {
        "scriptId": "file_e96b2807bdb2c77c89334d03952097dd2224a25df68a6e91d6ab19fc9c265974",
        "scriptName": "ztp1.sh",
        "generatedDownloadUrl": http://10.10.10.10/lcm/asset/ztp.sh
    }
]

cumulus@netq-server:~$ netq lcm del ztp-script file_e96b2807bdb2c77c89334d03952097dd2224a25df68a6e91d6ab19fc9c265974
ZTP script ztp1.sh successfully deleted

netq lcm add ztp-script
netq lcm show ztp-scripts

netq lcm detach credentials

从交换机分离访问配置文件并恢复默认配置文件。通过运行 netq lcm show switches 获取主机名。

语法

netq lcm detach credentials 
    hostname <text-switch-hostname>

必需参数

参数	值	描述
hostname	<text-switch-hostname>	从具有此主机名的交换机分离访问凭据

选项

无

示例用法

cumulus@switch:~$ netq lcm detach credentials hostname spine-1
Detached profile from switch.

netq lcm attach credentials
netq lcm del credentials
netq lcm show credentials
netq lcm show switches

netq lcm discover

根据 IP 地址或文件搜索未安装 NetQ 的交换机。发现后，您可以将它们添加到生命周期管理存储库并升级 Cumulus Linux。要获取配置文件 ID，请运行 netq lcm show credentials。使用 netq lcm show discovery-job 命令查看此命令的结果。

语法

netq lcm discover
    (ip-range <text-ip-range> | csv-file <text-csv-file-path>)
    profile_id <text-credential-profile-id>

必需参数

参数	值	描述
ip-range	<text-ip-range>	使用此 IP 地址或在此地址范围内搜索交换机。范围可以是连续的，例如 192.168.0.24-64，也可以是非连续的，例如 192.168.0.24-64,128-190,225，但它们必须位于单个子网内。您可以在地址范围内包含最多 50 个地址。
csv-file	<text-csv-file-path>	在此 CSV 文件中搜索交换机，该文件包含网络上每个交换机的 IP 地址，以及可选的主机名和端口。如果端口为空，NetQ 默认使用交换机端口 22。它们的顺序可以任意，但数据必须与该顺序匹配。
profile_id	<text-credential-profile-id>	搜索附加到此访问配置文件的交换机

选项

无

示例用法

cumulus@switch:~$ netq lcm discover ip-range 192.168.0.24-64 profile_id credential_profile_3eddab251bddea9653df7cd1be0fc123c5d7a42f818b68134e42858e54a9c289
NetQ Discovery Started with job id: job_scan_4f3873b0-5526-11eb-97a2-5b3ed2e556db

netq lcm show discovery-job

netq lcm edit credentials

修改访问配置文件的名称、身份验证类型、用户名或密码。有关访问配置文件的更多信息，请参阅凭据和配置文件。

在编辑访问配置文件之前，运行 netq lcm show credentials 以获取配置文件的 ID。

语法

netq lcm edit credentials 
    profile_id <text-switch-profile-id> 
    [profile_name <text-switch-profile-name>] 
    [auth-type <text-switch-auth-type>] 
    [username <text-switch-username>] 
    [password <text-switch-password> | ssh-key <text-ssh-key>]

必需参数

参数	值	描述
profile_id	<text-credential-profile-id>	编辑分配了此 ID 的配置文件

选项

选项	值	描述
profile_name	<text-switch-profile-name>	更改访问配置文件的名称
auth-type	<text-switch-auth-type>	更改身份验证方法（基本或 SSH）
username	<text-switch-username>	更改可以配置交换机的用户的用户名
password	<text-switch-password>	更改与用户名关联的密码，以便用户可以配置交换机
ssh-key	<text-ssh-key>	更改配置交换机所需的私钥。您必须已在每个交换机上安装公钥。

示例用法

要获取配置文件 ID，请运行 netq lcm show credentials

cumulus@switch:~$ netq lcm show credentials
Profile ID           Profile Name             Type             SSH Key        Username         Password         Number of switches                   Last Changed
-------------------- ------------------------ ---------------- -------------- ---------------- ---------------- ------------------------------------ -------------------------
credential_profile_3 n-1000                   BASIC                           admin            **************   3                                    Fri Feb  3 21:49:10 2023
eddab251bddea9653df7
cd1be0fc123c5d7a42f8
18b68134e42858e54a9c
289

要更改配置文件的名称（在此示例中从 n-1000 更改为 n-2000），请运行

cumulus@switch:~$ netq lcm edit credentials profile_id credential_profile_3eddab251bddea9653df7cd1be0fc123c5d7a42f818b68134e42858e54a9c289 profile_name n-2000
Credential profile modified.

运行 netq lcm show credentials 以验证编辑

netq lcm show credentials
Profile ID           Profile Name             Type             SSH Key        Username         Password         Number of switches                   Last Changed
-------------------- ------------------------ ---------------- -------------- ---------------- ---------------- ------------------------------------ -------------------------
credential_profile_3 n-2000                   BASIC                           admin            **************   3                                    Tue Feb  7 16:57:46 2023
eddab251bddea9653df7
cd1be0fc123c5d7a42f8
18b68134e42858e54a9c
289

netq lcm show credentials

netq lcm install netq-image

在交换机上安装 NetQ。

语法

netq lcm install netq-image 
    job-name <text-job-name> 
    netq-version <text-netq-version> 
    upgrade-cli [True | False] 
    ips <text-ip-range> 
    cpu_arch <text-cpu-arch> 
    cl_version <text-cumulus-linux-version>
    profile_id <text-credential-profile-id> 
    [config_profile <text-config-profile>]

必需参数

参数	值	描述
job-name	<text-job-name>	安装的名称
netq-version	<text-netq-version>	以 x.z.y 格式安装此 NetQ 版本
upgrade-cli	True, False	将 NetQ CLI 作为安装的一部分升级（True）或不升级（False）
ips	<text-ip-range>	在此地址范围内的交换机上安装 NetQ。范围可以是连续的，例如 192.168.0.24-64，也可以是非连续的，例如 192.168.0.24-64,128-190,225，但它们必须位于单个子网内。您可以在地址范围内包含最多 50 个地址。
cpu_arch	<text-cpu-arch>	交换机的 CPU 架构
cl-version	<text-cumulus-linux-version>	以 x.y.z 格式安装此 CL 版本
profile_id	<text-credential-profile-id>	附加到交换机的访问配置文件

选项

选项	值	描述
config_profile	<text-config-profile>	安装后应用的配置文件

示例用法

netq lcm install netq-image job-name install55 netq-version 4.9.0 upgrade-cli True ips 192.168.0.24-64 cpu_arch x86_64 cl_version 5.8.0 profile_id credential_profile_3eddab251bddea9653df7cd1be0fc12

netq lcm discover

netq lcm show cl-images

显示生命周期管理存储库中的所有 Cumulus Linux 映像。

语法

netq lcm show cl-images
    [<text-cl-image-id>]
    [json]

必需参数

参数	值	描述
cl-images	NA	显示生命周期管理存储库中的所有 Cumulus Linux 映像

选项

选项	值	描述
NA	<text-cl-image-id>	仅显示具有此标识符的 Cumulus Linux 映像
json	NA	以 JSON 格式显示输出

示例用法

cumulus@switch:~$ netq lcm show cl-images json
[
    {
        "id": "image_cc97be3955042ca41857c4d0fe95296bcea3e372b437a535a4ad23ca300d52c3",
        "name": "cumulus-linux-4.2.0-vx-amd64-1594775435.dirtyzc24426ca.bin",
        "clVersion": "4.2.0",
        "cpu": "x86_64",
        "asic": "VX",
        "lastChanged": 1609884659654.0
    },
    {
        "id": "image_b80c410e165ea232cbeb67fd82fea79f05734cd0a32f81c148971214bd98b2e0",
        "name": "cumulus-linux-4.2.1-vx-amd64.bin",
        "clVersion": "4.2.1",
        "cpu": "x86_64",
        "asic": "VX",
        "lastChanged": 1611161189714.0
    }
]

netq lcm add cl-image
netq lcm del cl-image

netq lcm show credentials

显示访问配置文件、其关联的凭据以及分配给每个访问配置文件的交换机数量。

语法

netq lcm show credentials
    [json]

必需参数

参数	值	描述
credentials	NA	显示当前交换机访问凭据配置

选项

选项	值	描述
json	NA	以 JSON 格式显示输出

示例用法

cumulus@switch:~$ netq lcm show credentials
Profile ID           Profile Name             Type             SSH Key        Username         Password         Number of switches                   Last Changed
-------------------- ------------------------ ---------------- -------------- ---------------- ---------------- ------------------------------------ -------------------------
credential_profile_d Netq-Default             BASIC                           cumulus          **************   11                                   Fri Feb  3 18:20:33 2023
9e875bd2e6784617b304
c20090ce28ff2bb46a4b
9bf23cda98f1bdf91128
5c9
credential_profile_3 Nvl4-Default             BASIC                           admin            **************   1                                    Fri Feb  3 19:18:26 2023
5a2eead7344fb91218bc
dec29b12c66ebef0d806
659b20e8805e4ff629bc
23e
credential_profile_3 n-1000                   BASIC                           admin            **************   3                                    Fri Feb  3 21:49:10 2023
eddab251bddea9653df7
cd1be0fc123c5d7a42f8
18b68134e42858e54a9c
289

netq lcm add credentials
netq lcm attach credentials
netq lcm del credentials

netq lcm show default-version

显示为升级指定的默认 Cumulus Linux 或 NetQ 版本。

语法

此命令有两种形式可用，具体取决于您是要查看 Cumulus Linux 的默认版本还是 NetQ 的默认版本。

netq lcm show default-version 
    cl-images
    [json]

netq lcm show default-version
    netq-images
    [json]

必需参数

参数	值	描述
cl-images	NA	显示 Cumulus Linux 默认升级版本的配置
netq-images	NA	显示 NetQ 默认升级版本的配置

选项

选项	值	描述
json	NA	以 JSON 格式显示输出

示例用法

cumulus@switch:~$ netq lcm show default-version cl-images 
ID                        Name            CL Version  CPU      ASIC            Last Changed
------------------------- --------------- ----------- -------- --------------- -------------------------
image_b80c410e165ea232cbe cumulus-linux-4 4.2.1       x86_64   VX              Tue Jan 26 22:32:11 2021
b67fd82fea79f05734cd0a32f .2.1-vx-amd64.b
81c148971214bd98b2e0      in

netq lcm add default-version
netq lcm del default-version
netq lcm add cl-image
netq lcm add netq-image

netq lcm show discovery-job

显示交换机发现作业的结果，包括作业本身的摘要以及有关发现的任何交换机的信息，包括主机名、IP 地址、MAC 地址、CPU、Cumulus Linux 和 NetQ 版本、配置文件、发现状态和升级状态。

语法

netq lcm show discovery-job
    [json]

必需参数

无

选项

选项	值	描述
json	NA	以 JSON 格式显示输出

示例用法

cumulus@switch:~$ netq lcm discover ip-range 192.168.200.62
NetQ Discovery Started with job id: job_scan_c1d5e060-720e-11eb-9e30-f75bf78d6bf1

cumulus@switch:~$ netq lcm show discovery-job job_scan_c1d5e060-720e-11eb-9e30-f75bf78d6bf1
Scan COMPLETED

Summary
-------
Start Time: 2021-02-18 17:29:18.640000
End Time: 1970-01-01 00:00:00.000000
Total IPs: 1
Completed IPs: 1
Discovered without NetQ: 0
Discovered with NetQ: 1
Incorrect Credentials: 0
OS Not Supported: 0
Not Discovered: 0


Hostname          IP Address                MAC Address        CPU      CL Version  NetQ Version  Config Profile               Discovery Status Upgrade Status
----------------- ------------------------- ------------------ -------- ----------- ------------- ---------------------------- ---------------- --------------
fw2               192.168.200.62            44:38:39:00:01:8E  x86_64   4.2.0       4.0.0         []                           WITH_NETQ        NOT_UPGRADING

netq lcm discover

netq lcm show netq-config

显示所有 NetQ 配置配置文件的配置，包括名称和标识符、默认配置文件、VRF、“刚刚发生”状态、CPU 使用率限制和日志级别。

语法

netq lcm show netq-config
    [json]

必需参数

无

选项

选项	值	描述
json	NA	以 JSON 格式显示输出

示例用法

cumulus@switch:~$ netq lcm show netq-config 
ID                        Name            Default Profile                VRF             WJH       CPU Limit Log Level Last Changed
------------------------- --------------- ------------------------------ --------------- --------- --------- --------- -------------------------
config_profile_3289efda36 NetQ default co Yes                            mgmt            Disable   Disable   info      Tue Jan  5 05:25:31 2021
db4065d56f91ebbd34a523b45 nfig
944fbfd10c5d75f9134d42023
eb2b
config_profile_233c151302 CPU limit 75%   No                             mgmt            Disable   75%       info      Mon Jan 11 19:11:35 2021
eb8ee77d6c27fe2eaca51a9bf
2dfcbfd77d11ff0af92b807de
a0dd

netq lcm add netq-config
netq lcm del netq-config

netq lcm show netq-images

显示生命周期管理存储库中的所有 NetQ 映像。

语法

netq lcm show netq-images
    [<text-netq-image-id>]
    [json]

必需参数

参数	值	描述
netq-images	NA	显示生命周期管理存储库中的所有 NetQ 映像

选项

选项	值	描述
NA	<text-netq-image-id>	仅显示具有此标识符的 NetQ 映像
json	NA	以 JSON 格式显示输出

示例用法

cumulus@switch:~$ netq lcm show netq-images json
[
    {
        "id": "image_d23a9e006641c675ed9e152948a9d1589404e8b83958d53eb0ce7698512e7001",
        "name": "netq-agent_4.0.0-cl4u32_1609391187.7df4e1d2_amd64.deb",
        "netqVersion": "4.0.0",
        "clVersion": "cl4u32",
        "cpu": "x86_64",
        "imageType": "NETQ_AGENT",
        "lastChanged": 1609885430638.0
    },
    {
        "id": "image_68db386683c796d86422f2172c103494fef7a820d003de71647315c5d774f834",
        "name": "netq-apps_4.0.0-cl4u32_1609391187.7df4e1d2_amd64.deb",
        "netqVersion": "4.0.0",
        "clVersion": "cl4u32",
        "cpu": "x86_64",
        "imageType": "NETQ_CLI",
        "lastChanged": 1609885434704.0
    }
]

netq lcm add netq-image
netq lcm del netq-image

netq lcm show status

显示 Cumulus Linux 或 NetQ 映像升级作业的状态。

语法

此命令有两种形式可用：一种用于 Cumulus Linux，另一种用于 NetQ。运行 netq lcm show upgrade-jobs 以获取作业标识符。

netq lcm show status
    cl-image <text-lcm-job-id>
    [json]

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

必需参数

参数	值	描述
cl-image	<text-lcm-job-id>	显示具有此标识符的 Cumulus Linux 升级作业的状态
netq-image	<text-netq-upgrade-job-id>	显示具有此标识符的 NetQ 升级作业的状态

选项

选项	值	描述
json	NA	以 JSON 格式显示输出

示例用法

cumulus@switch:~$ netq lcm show upgrade-jobs cl-image json
[
    {
        "jobId": "job_cl_upgrade_a96e0beb59a16b085a7d2b3b5ffd6e5971870aa2903c6df86f26fa908ded2e21",
        "name": "test",
        "clVersion": "4.2.1",
        "pre-checkStatus": "COMPLETED",
        "warnings": "",
        "errors": "",
        "startTime": 1611170981846.0
    },
    {
        "jobId": "job_cl_upgrade_9c5e3b4b76f490e6531c34faf52907bda46648701b3f7c0289b96c5d76af53eb",
        "name": "UpgradeJustOne",
        "clVersion": "4.2.1",
        "pre-checkStatus": "COMPLETED",
        "warnings": "",
        "errors": "",
        "startTime": 1613595515152.0
    }
]
cumulus@switch:~$ netq lcm show status cl-image job_cl_upgrade_a96e0beb59a16b085a7d2b3b5ffd6e5971870aa2903c6df86f26fa908ded2e21
Hostname    CL Version    Backup Status    Backup Start Time         Restore Status      Restore Start Time    Upgrade Status      Upgrade Start Time
----------  ------------  ---------------  ------------------------  ------------------  --------------------  ------------------  --------------------
leaf01      4.2.0         FAILED           Wed Jan 20 19:30:12 2021  SKIPPED_ON_FAILURE  N/A                   SKIPPED_ON_FAILURE  N/A

netq lcm show upgrade-jobs

netq lcm show switches

显示有关 NetQ 监控并包含在生命周期管理存储库中的交换机的信息，包括它们的主机名、任何分配的角色、IP 和 MAC 地址、CPU 架构、Cumulus Linux 和 NetQ 版本以及 NetQ 配置和访问配置文件。按交换机上运行的 Cumulus Linux 或 NetQ 版本过滤输出。

语法

netq lcm show switches
    [cl-version <text-cumulus-linux-version>]
    [netq-version <text-netq-version>]
    [json]

必需参数

参数	值	描述
switches	NA	显示有关生命周期管理已知的交换机的信息

选项

选项	值	描述
cl-version	<text-cumulus-linux-version>	仅显示运行此 Cumulus Linux 操作系统版本的交换机
netq-version	<text-netq-version>	仅显示运行此 NetQ 版本的交换机
json	NA	以 JSON 格式显示输出

示例用法

显示运行 Cumulus Linux 5.5.0 的交换机

cumulus@switch:~$ netq lcm show switches cl-version 5.5.0
Hostname          Role       IP Address                MAC Address        CPU      CL Version  NetQ Version  Config Profile               Credential Profile                   Last Changed
----------------- ---------- ------------------------- ------------------ -------- ----------- ------------- ---------------------------- ------------------------------------ -------------------------
noc-se                       192.168.0.15              00:01:00:00:12:00  x86_64   5.5.0       4.8.0-cl4u46~ []                           Netq-Default                         Fri Feb  3 20:50:40 2023
                                                                                               1713945871.12
                                                                                               7fb0c1b
spine-1                      192.168.0.15              00:01:00:00:13:00  x86_64   5.5.0       4.8.0-cl4u46~ []                           n-2000                               Fri Feb  3 22:28:25 2023
                                                                                               1713945871.12
                                                                                               7fb0c1b

无

netq lcm show upgrade-jobs

显示所有 Cumulus Linux 或 NetQ 升级作业的历史记录，包括作业标识符和名称、Cumulus Linux 或 NetQ 版本、预检查状态、警告和错误以及作业开始时间。NetQ 升级作业还显示总体状态。

语法

此命令有两种形式可用：一种用于 Cumulus Linux，另一种用于 NetQ。

netq lcm show upgrade-jobs
    cl-image
    [json]

netq lcm show upgrade-jobs
    netq-image
    [json]

必需参数

参数	值	描述
upgrade-jobs	NA	显示升级作业历史记录
cl-image	NA	显示 Cumulus Linux 的升级作业历史记录
netq-image	NA	显示 NetQ 的升级作业历史记录

选项

选项	值	描述
json	NA	以 JSON 格式显示输出

示例用法

cumulus@switch:~$ netq lcm show upgrade-jobs netq-image 
Job ID       Name            NetQ Version  Overall Status   Pre-Check Status Warnings         Errors       Start Time
------------ --------------- ------------- ---------------- ---------------- ---------------- ------------ --------------------------
job_netq_ins Leaf01-02 to Ne 4.0.0         FAILED           COMPLETED        []               []           Thu Jan 28 19:48:10 2021
tall_7152a03 tQ330
a8c63c906631
c3fb340d8f51
e70c3ab508d6
9f3fdf5032ee
bad118cc7

netq lcm show status

netq lcm show ztp-scripts

显示 ZTP 脚本列表以及它们的脚本标识号和可以下载它们的 URL。

语法

netq lcm show ztp-scripts [<text-ztp-script-id>]
    [json]

必需参数

无

选项

选项	值	描述
ztp-scripts	<text-ztp-script-id>	仅显示具有此脚本 ID 的 ZTP 脚本
json	NA	以 JSON 格式显示输出

示例用法

cumulus@netq-server:~$ netq lcm show ztp-scripts json
[
    {
        "scriptId": "file_e96b2807bdb2c77c89334d03952097dd2224a25df68a6e91d6ab19fc9c265974",
        "scriptName": "ztp1.sh",
        "generatedDownloadUrl": http://10.10.10.10/lcm/asset/ztp.sh
    }
]

netq lcm add ztp-script
netq lcm del ztp-script

netq lcm upgrade cl-image

在网络中的一个或多个交换机上升级 Cumulus Linux。

语法

netq lcm upgrade cl-image 
    job-name <text-job-name> 
    cl-version <text-cumulus-linux-version> 
    netq-version <text-netq-version> 
    hostnames <text-switch-hostnames> 
    [run-restore-on-failure] 
    [run-snapshot-before-after]

必需参数

参数	值	描述
job-name	<text-job-name>	升级的名称
cl-version	<text-cumulus-linux-version>	以 x.y.z 格式升级到此 CL 版本
netq-version	<text-netq-version>	以 x.z.y 格式升级到此 NetQ 版本
hostnames	<text-switch-hostnames>	要升级的主机名的逗号分隔列表

选项

选项	值	描述
run-restore-on-failure	NA	如果升级失败，则恢复 Cumulus Linux 的先前版本（推荐）
run-snapshot-before-after	NA	在升级前后生成网络快照

示例用法

cumulus@switch:~$ netq lcm upgrade cl-image job-name upgrade-cl430 cl-version 4.3.0 netq-version 4.6.0 hostnames spine01,spine02

netq lcm show discovery-job

netq lcm upgrade netq-image

在网络中的一个或多个交换机上升级 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>]

必需参数

参数	值	描述
job-name	<text-job-name>	用户定义的升级名称
hostnames	<text-switch-hostnames>	要升级的主机名的逗号分隔列表

选项

选项	值	描述
netq-version	<text-netq-version>	以 x.z.y 格式升级到此 NetQ 版本
upgrade-cli	True, False	将 NetQ CLI 作为升级的一部分升级（True）
config_profile	<text-config-profile>	升级后应用的配置文件

示例用法

cumulus@switch:~$ netq lcm upgrade netq-image job-name upgrade-cl530-nq450 netq-version 4.6.0 hostnames spine01,spine02

netq lcm show upgrade-jobs netq-image

lcm

netq lcm add cl-image

语法

必需参数

选项

示例用法

相关命令

netq lcm add credentials

语法

必需参数

选项

示例用法

相关命令

netq lcm add default-version

语法

必需参数

选项

示例用法

相关命令

netq lcm add netq-config

语法

必需参数

选项

示例用法

相关命令

netq lcm add netq-image

语法

必需参数

选项

示例用法

相关命令

netq lcm add role

语法

必需参数

选项

示例用法

相关命令

netq lcm add ztp-script

语法

必需参数

选项

示例用法

相关命令

netq lcm attach credentials

语法

必需参数

选项

示例用法

相关命令

netq lcm del cl-image

语法

必需参数

选项

示例用法

相关命令

netq lcm del credentials

语法

必需参数

选项

示例用法

相关命令

netq lcm del netq-config

语法

必需参数

选项

示例用法

相关命令

netq lcm del netq-image

语法

必需参数

选项

示例用法

相关命令

netq lcm del ztp-script

语法

必需参数

选项

示例用法

相关命令

netq lcm detach credentials