安装 NetQ 代理

验证是否已安装并配置 NTP

验证 NTP 是否正在交换机上运行，如下面的步骤所述。交换机系统时钟必须与 NetQ 设备同步，才能进行有用的统计分析。或者，您可以配置 PTP 以进行时间同步。

cumulus@switch:~$ sudo systemctl status ntp
[sudo] password for cumulus:
● ntp.service - LSB: Start NTP daemon
        Loaded: loaded (/etc/init.d/ntp; bad; vendor preset: enabled)
        Active: active (running) since Fri 2018-06-01 13:49:11 EDT; 2 weeks 6 days ago
          Docs: man:systemd-sysv-generator(8)
        CGroup: /system.slice/ntp.service
                └─2873 /usr/sbin/ntpd -p /var/run/ntpd.pid -g -c /var/lib/ntp/ntp.conf.dhcp -u 109:114

如果未安装 NTP，请在继续之前安装并配置它。

如果 NTP 未运行

• 验证 /etc/ntp.conf 文件中 NTP 服务器的 IP 地址或主机名，然后
• 使用 systemctl [enable|start] ntp 命令重新启用并启动 NTP 服务

获取 NetQ 代理软件包

Cumulus Linux 4.4 及更高版本默认包含 netq-agent 软件包。要将 NetQ 代理升级到最新版本

1. 通过取消注释或在 /etc/apt/sources.list 中添加以下行来添加存储库

cumulus@switch:~$ sudo nano /etc/apt/sources.list
...
deb https://apps3.cumulusnetworks.com/repos/deb CumulusLinux-4 netq-latest
...

deb https://apps3.cumulusnetworks.com/repos/deb CumulusLinux-4 netq-4.12

2. 将 apps3.cumulusnetworks.com 身份验证密钥添加到 Cumulus Linux

cumulus@switch:~$ wget -qO - https://apps3.cumulusnetworks.com/setup/cumulus-apps-deb.pubkey | sudo apt-key add -

验证服务软件包版本

在 Ubuntu 服务器上安装 NetQ 代理之前，请确保您安装并运行了以下软件包的最低版本

• iproute 1:4.3.0-1ubuntu3.16.04.1 all
• iproute2 4.3.0-1ubuntu3 amd64
• lldpd 0.7.19-1 amd64
• ntp 1:4.2.8p4+dfsg-3ubuntu5.6 amd64

验证服务器正在运行 lldpd

确保您正在运行 lldpd，而不是 lldpad。Ubuntu 默认不包含 lldpd；但是，安装需要它。

要安装此软件包，请运行以下命令

root@ubuntu:~# sudo apt-get update
root@ubuntu:~# sudo apt-get install lldpd
root@ubuntu:~# sudo systemctl enable lldpd.service
root@ubuntu:~# sudo systemctl start lldpd.service

安装和配置网络时间服务器

如果尚未安装和配置 NTP，请按照以下步骤操作。或者，您可以配置 PTP 以进行时间同步。

1. 在服务器上安装 NTP（如果尚未安装）。服务器必须与 NetQ 设备同步，才能进行有用的统计分析。

   root@ubuntu:~# sudo apt-get install ntp
   

2. 配置网络时间服务器。

获取 NetQ 代理软件包

要安装 NetQ 代理，您需要在每台服务器上安装 netq-agent。这可以从 NVIDIA 网络存储库获得。

要获取 NetQ 代理软件包

1. 参考并更新本地 apt 存储库。

root@ubuntu:~# sudo wget -O- https://apps3.cumulusnetworks.com/setup/cumulus-apps-deb.pubkey | apt-key add -

2. 添加 Ubuntu 存储库

root@ubuntu:~# vi /etc/apt/sources.list.d/cumulus-apps-deb-jammy.list
...
deb [arch=amd64] https://apps3.cumulusnetworks.com/repos/deb jammy netq-latest
...

root@ubuntu:~# vi /etc/apt/sources.list.d/cumulus-apps-deb-focal.list
...
deb [arch=amd64] https://apps3.cumulusnetworks.com/repos/deb focal netq-latest
...

Cumulus Linux 4.4 及更高版本默认包含 netq-agent 软件包。要在早期版本的 Cumulus Linux 上安装 NetQ 代理

1. 更新本地 apt 存储库，然后在交换机上安装 NetQ 软件。

   cumulus@switch:~$ sudo apt-get update
   cumulus@switch:~$ sudo apt-get install netq-agent
   

2. 验证您是否具有正确版本的代理。

   cumulus@switch:~$ dpkg-query -W -f '${Package}\t${Version}\n' netq-agent
   

   您应该在结果中看到版本 4.12.0 和更新 49。
   

   • Cumulus Linux 5.9.0 或更高版本：netq-agent_4.12.0-cld12u49~1731404238.ffa541ea6_amd64.deb
   • Cumulus Linux 5.8.0 或更早版本，ARM 平台：netq-agent_4.12.0-cl4u49~1731403923.ffa541ea6_armel.deb
   • Cumulus Linux 5.8.0 或更早版本，amd64 平台：netq-agent_4.12.0-cl4u49~1731404368.ffa541ea6_amd64.deb

3. 重新启动 rsyslog，以便它将日志文件发送到正确的目的地。

   cumulus@switch:~$ sudo systemctl restart rsyslog.service
   

4. 配置 NetQ 代理，如下一节所述。

要安装 NetQ 代理

1. 在服务器上安装软件包。

   root@ubuntu:~# sudo apt-get update
   root@ubuntu:~# sudo apt-get install netq-agent
   

2. 验证您是否具有正确的代理版本。

   root@ubuntu:~# dpkg-query -W -f '${Package}\t${Version}\n' netq-agent
   

   您应该在结果中看到版本 4.12.0 和更新 49。
   

   • Ubuntu 20.04：netq-agent_4.12.0-ub20.04u49~1731404061.ffa541ea6_amd64.deb
   • Ubuntu 22.04：netq-agent_4.12.0-ub22.04u49~1731404070.ffa541ea6_amd64.deb

3. 重新启动 rsyslog，以便它将日志文件发送到正确的目的地。

root@ubuntu:~# sudo systemctl restart rsyslog.service

4. 配置 NetQ 代理，如下一节所述。