安装

您可以使用单个命令安装 NetQ,也可以使用多个命令执行各个步骤。通常,强烈建议使用单命令选项。但是,当安装过程失败时,各个命令对于排除故障可能很有用。有关分步说明,请参阅适用于您的部署模型的安装页面

只有在引导物理服务器或 VM 后,才能使用这些命令。请参阅netq bootstrap


netq install cluster activate-job

在配置和安装初始服务器集群(主节点和两个工作节点)后,激活 NetQ 实例。激活需要一个配置密钥,可以从支持部门获得。

或者,使用 netq install cluster full 使用单个命令执行此操作和 NetQ 安装的所有其他步骤。

语法

netq install cluster activate-job
    config-key <text-opta-key>

必需参数

参数描述
activate-jobNA激活 NetQ 实例
config-key<text-opta-key>使用此唯一密钥激活 NetQ

选项

使用示例

cumulus@switch:~$ netq install cluster activate-job config-key ju8Kl4IhZ3cucHJvZDEubmV0cPk3vW11bHVzbmV0d29ya3MuY29cB3ag
  • netq install cluster full

netq install cluster bundle

为本地 HA 规模集群部署安装 NetQ 软件。在您的节点上运行此命令,指定您使用 netq install cluster config generate 命令创建的集群配置 JSON 文件。

语法

netq install cluster bundle
    bundle <text-bundle-url>
    <text-cluster-config>

必需参数

参数描述
bundle<text-bundle-url>在此位置安装 NetQ 软件包;您必须指定完整路径
NA<text-cluster-config>指定集群配置 JSON 文件

选项

使用示例

cumulus@<hostname>:~$ netq install cluster bundle /mnt/installables/NetQ-4.12.0.tgz /tmp/cluster-install-config.json
  • netq install cluster config generate

netq install cluster config generate

在您的节点上运行此命令,以生成 JSON 模板,您可以使用该模板指定 VM 的集群配置属性,作为高可用性规模集群部署的一部分。

语法

netq install cluster config generate 
    [<text-config-json-file>]

必需参数

选项

选项描述
NA<text-config-json-file>在此位置生成文件;您必须指定完整路径

使用示例

cumulus@netq-server:~$ netq install cluster config generate
2024-10-28 17:29:53.260462: master-node-installer: Writing cluster installation configuration template file @ /tmp/cluster-install-config.json
  • netq install cluster bundle

netq install cluster full

为本地服务器集群部署安装 NetQ 软件。在您的节点上运行此命令。您必须具有主节点、两个工作节点、虚拟 IP 地址和 NetQ 软件包的主机名或 IP 地址才能运行该命令。

NVIDIA Application Hub 获取软件发行包。

语法

netq install cluster full
    (interface <text-opta-ifname>|ip-addr <text-ip-addr> [<text-ipv6-addr>])
    bundle <text-bundle-url>
    [config-key <text-opta-key>]
    [pod-ip-range <text-pod-ip-range>]
    [service-ip-range <text-service-ip-range>]
    workers <text-worker-01> <text-worker-02>
    [workers-ipv6 <text-worker-ipv6-01> <text-worker-ipv6-02>] 
    cluster-vip <text-cluster-vip> 
    [ipv6]
    [s3-access-key <text-s3-access-key> s3-secret-key <text-s3-secret-key>]

必需参数

参数描述
interface<text-opta-ifname>安装服务器集群,其中主节点使用此接口与工作节点上的 NetQ 代理通信
ip-addr<text-ip-addr>,<text-ipv6-addr>安装服务器集群,其中主节点使用此 IPv4 或 IPv6 地址与工作节点上的 NetQ 代理通信
bundle<text-bundle-url>在此位置安装 NetQ 软件包;您必须指定完整路径
workers<text-worker-01> <text-worker-02>使用这些 IPv4 地址安装工作节点
cluster-vip<text-cluster-vip>从用于您的主节点和工作节点的同一子网中指定虚拟 IP 地址

选项

选项描述
config-key<text-opta-key>使用此唯一密钥安装服务器集群
pod-ip-range<text-pod-ip-range>指定 pod 的 IP 地址范围
service-ip-range<text-service-ip-range>指定服务的 IP 地址范围
workers-ipv6<text-worker-ipv6-01> <text-worker-ipv6-02>使用这些 IPv6 地址安装工作节点
s3-access-key<text-s3-access-key>AWS S3 访问密钥 ID
s3-secret-key<text-s3-secret-key>AWS S3 密钥 ID

使用示例

cumulus@<hostname>:~$ netq install cluster full interface eth0 bundle /mnt/installables/NetQ-4.12.0.tgz workers 10.20.10.25 10.20.10.45 cluster-vip 10.20.10.254
  • netq install cluster activate-job

netq install cluster master-init

将工作节点添加到集群后,在您的主节点上运行此命令以初始化集群。

语法

netq install cluster master-init

必需参数

参数描述
master-initNA初始化集群主节点

选项

使用示例

cumulus@<hostname>:~$ netq install cluster master-init
    Please run the following command on all worker nodes:
    netq install cluster worker-init c3NoLXJzYSBBQUFBQjNOemFDMXljMkVBQUFBREFRQUJBQUFCQVFDM2NjTTZPdVVUWWJ5c2Q3NlJ4SHdseHBsOHQ4N2VMRWVGR05LSWFWVnVNcy94OEE4RFNMQVhKOHVKRjVLUXBnVjdKM2lnMGJpL2hDMVhmSVVjU3l3ZmhvVDVZM3dQN1oySVZVT29ZTi8vR1lOek5nVlNocWZQMDNDRW0xNnNmSzVvUWRQTzQzRFhxQ3NjbndIT3dwZmhRYy9MWTU1a
  • netq install cluster worker-init

netq install cluster worker-init

在主节点上初始化集群后,在每个工作节点上运行此命令。

语法

netq install cluster worker-init 
    <text-ssh-key>

必需参数

参数描述
worker-initNA初始化集群工作节点
NA<text-ssh-key>公共 SSH 密钥

选项

  • netq install cluster master-init

netq install opta activate-job

在配置和安装初始服务器或服务器集群(主节点和两个工作节点)后,激活 NetQ Collector 软件。激活需要一个配置密钥,您可以从标题为已将新站点添加到您的 NVIDIA NetQ 帐户的电子邮件中获得(发送给您的 NetQ 管理员)。

语法

netq install opta activate-job
    config-key <text-opta-key>

必需参数

参数描述
activate-jobNA激活 NetQ Collector 软件
config-key<text-opta-key>使用此唯一密钥激活 NetQ

选项

使用示例

cumulus@switch:~$ netq install opta activate-job config-key ju8Kl4IhZ3cucHJvZDEubmV0cPk3vW11bHV9f3lk0d29ya3MuY29cB3ag
  • netq install opta cluster
  • netq install opta standalone

netq install opta cluster full

为云服务器集群部署安装 NetQ 软件。您必须具有主机名、IP 地址(或服务器的接口)、虚拟 IP 地址、NetQ 软件包和配置密钥才能运行该命令。您还可以配置代理。

NVIDIA Application Hub 获取软件发行包。

从发送给您的 NetQ 管理员的标题为已将新站点添加到您的 NVIDIA NetQ 帐户的电子邮件中获取 config-key。您也可以通过 NetQ UI 在场所管理配置中获取配置密钥。

语法

netq install opta cluster full
    (interface <text-opta-ifname>|ip-addr <text-ip-addr>)
    bundle <text-bundle-url>
    config-key <text-opta-key>
    [pod-ip-range <text-pod-ip-range>]
    [service-ip-range <text-service-ip-range>]
    workers <text-worker-01> <text-worker-02>
    cluster-vip <text-cluster-vip>
    [proxy-host <text-proxy-host> proxy-port <text-proxy-port>]
    [s3-access-key <text-s3-access-key> s3-secret-key <text-s3-secret-key>]

必需参数

参数描述
interface<text-opta-ifname>安装服务器集群,其中主节点使用此接口与工作节点上的 NetQ 代理通信
ip-addr<text-ip-addr>安装服务器集群,其中主节点使用此 IP 地址与工作节点上的 NetQ 代理通信
bundle<text-bundle-url>在此位置安装 NetQ 软件包;您必须指定完整路径
config-key<text-opta-key>使用此唯一密钥激活软件
workers<text-worker-01> <text-worker-02>使用这些 IP 地址安装工作节点
cluster-vip<text-cluster-vip>从用于您的主节点和工作节点的同一子网中指定虚拟 IP 地址

选项

选项描述
proxy-host<text-proxy-host>使用具有此主机名或 IP 地址的代理服务器,而不是直接连接到 VM;您还必须指定端口
proxy-port<text-proxy-port>在代理服务器上使用此端口,而不是直接连接到 VM;您还必须指定代理主机
pod-ip-range<text-pod-ip-range>指定 pod 的 IP 地址范围
service-ip-range<text-service-ip-range>指定服务的 IP 地址范围
s3-access-key<text-s3-access-key>AWS S3 访问密钥 ID
s3-secret-key<text-s3-secret-key>AWS S3 密钥 ID

使用示例

cumulus@<hostname>:~$ netq install opta cluster full interface en01 bundle /mnt/installables/NetQ-4.12.0.tgz config-key CI39fo5CZ3cucHJvZDEubmV0cS5jdW11bHVzbmVp6z8ma3MuY29tGLsD workers 10.20.10.25 10.20.10.45 cluster-vip 10.20.10.254
  • netq install opta activate-job

netq install opta standalone full

在单个云服务器 (VM) 上安装 NetQ 软件。您必须具有主机名、IP 地址(或服务器的接口)、NetQ 软件包和配置密钥才能运行该命令。您还可以配置代理。

NVIDIA Application Hub 获取软件发行包。

从发送给您的 NetQ 管理员的标题为已将新站点添加到您的 NVIDIA NetQ 帐户的电子邮件中获取 config-key。您也可以通过 NetQ UI 在场所管理配置中获取配置密钥。

语法

netq install opta standalone full
    (interface <text-opta-ifname>|ip-addr <text-ip-addr>)
    bundle <text-bundle-url>
    config-key <text-opta-key>
    [pod-ip-range <text-pod-ip-range>]
    [service-ip-range <text-service-ip-range>]
    [proxy-host <text-proxy-host> proxy-port<text-proxy-port>]
    [s3-access-key <text-s3-access-key> s3-secret-key <text-s3-secret-key>]

必需参数

参数描述
interface<text-opta-ifname>在此服务器上安装 NetQ,并将此接口用作受监控交换机和主机上 NetQ 代理的通信接口
ip-addr<text-ip-addr>在此服务器上安装 NetQ,并将此 IP 地址用作与受监控交换机和主机上的 NetQ 代理通信的地址
bundle<text-bundle-url>在此位置安装 NetQ 软件包;您必须指定完整路径
config-key<text-opta-key>使用此唯一密钥激活软件

选项

选项描述
pod-ip-range<text-pod-ip-range>指定 pod 的 IP 地址范围
service-ip-range<text-service-ip-range>指定服务的 IP 地址范围
proxy-host<text-proxy-host>使用具有此主机名或 IP 地址的代理服务器,而不是直接连接到 VM;您还必须指定端口
proxy-port<text-proxy-port>在代理服务器上使用此端口,而不是直接连接到 VM;您还必须指定代理主机
s3-access-key<text-s3-access-key>AWS S3 访问密钥 ID
s3-secret-key<text-s3-secret-key>AWS S3 密钥 ID

使用示例

cumulus@<hostname>:~$ netq install opta standalone full interface en01 bundle /mnt/installables/NetQ-4.12.0.tgz config-key CI39fo5CZ3cucHJvZDEubmV0cS5jdW11bHVzbmVp6z8ma3MuY29tGLsD
  • netq install opta activate-job

netq install patch

使用压缩文件包(而不是完整安装或升级)安装集中的软件修复程序。在 NetQ 设备或 VM 上根据需要运行此命令。

语法

netq install patch
    <text-tarball-name>

必需参数

参数描述
NA<text-tarball-name>在此位置安装 tarball 中包含的软件补丁;您必须指定完整路径

选项

使用示例

cumulus@<hostname>:~$ netq install patch /mnt/installables/NetQ-4.0.0-patch.tgz
  • netq upgrade

netq install standalone activate-job

在安装软件后激活 NetQ 实例。激活需要一个配置密钥,可以从支持部门获得。

或者,使用 netq install standalone full 使用单个命令执行此操作和 NetQ 安装的所有其他步骤。

语法

netq install standalone activate-job
    config-key <text-opta-key>

必需参数

参数描述
activate-jobNA激活 NetQ 实例
config-key<text-opta-key>使用此唯一密钥激活 NetQ

选项

使用示例

cumulus@switch:~$ netq install standalone activate-job config-key ju8Kl4IhZ3cucHJvZDEubmV0cPk3vW11bHVzbmV0d29ya3MuY29cB3ag
  • netq install standalone full

netq install standalone full

在本地单服务器部署中的 NetQ VM 上安装 NetQ 软件。您必须具有服务器的主机名或 IP 地址以及 NetQ 软件包才能运行该命令。配置密钥是可选的。

NVIDIA Application Hub 获取软件发行包。

语法

netq install standalone full 
    (interface <text-opta-ifname>|ip-addr <text-ip-addr> [<text-ipv6-addr>]) 
    bundle <text-bundle-url> 
    [ipv6] 
    [config-key <text-opta-key>]
    [pod-ip-range <text-pod-ip-range>]
    [service-ip-range <text-service-ip-range>]
    [s3-access-key <text-s3-access-key> s3-secret-key <text-s3-secret-key>]

必需参数

参数描述
fullNA安装具有 NetQ 软件的服务器,自动运行所有初始化和配置命令
interface<text-opta-ifname>在此服务器上安装 NetQ,并将此接口用作受监控交换机和主机上 NetQ 代理的通信接口
ip-addr<text-ip-addr>,<text-ipv6-addr>在此服务器上安装 NetQ,并将此 IPv4 或 IPv6 地址用作与受监控交换机和主机上的 NetQ 代理通信的地址
bundle<text-bundle-url>在此位置安装 NetQ 软件包;您必须指定完整路径

选项

选项描述
ipv6NA使用 IPv6 地址安装 NetQ
config-key<text-opta-key>使用此唯一密钥激活软件
pod-ip-range<text-pod-ip-range>指定 pod 的 IP 地址范围
service-ip-range<text-service-ip-range>指定服务的 IP 地址范围
s3-access-key<text-s3-access-key>AWS S3 访问密钥 ID
s3-secret-key<text-s3-secret-key>AWS S3 密钥 ID

使用示例

cumulus@<hostname>:~$ netq install standalone full interface eth0 bundle /mnt/installables/NetQ-4.12.0.tgz
  • netq install standalone activate-job

netq install update-opta-ssl-setting

替换或更新 OPTA 上用于 agent-OPTA 连接的 TSL/SSL 设置。

语法

netq install update-opta-ssl-setting 
    ssl-cert <text-ssl-cert-file> 
    ssl-key <text-ssl-key-file>

必需参数

参数描述
update-opta-ssl-settingNA更新 OPTA 上用于 agent-opta 连接的 TLS/SSL 设置
ssl-cert<text-ssl-cert-filel>TLS/SSL 证书文件绝对路径
ssl-key<text-ssl-key-filel>TLS/SSL 私钥文件绝对路径

选项