思科设备代理

尽管安装设备系统代理的首选方法是通过 Apstra GUI，但 您可以从 CLI 手动安装 Apstra 代理。只有在极少数情况下，才需要手动安装代理，这需要更多的工作并且容易出错。在手动安装代理之前，您应该深入了解各种设备状态、配置阶段和代理操作。如需帮助，请联系 瞻博网络支持。

注意：

您还可以使用 Apstra ZTP 在交换机上自动启动和安装代理和必备组件配置。与手动安装代理相比，使用 Apstra ZTP 更简单、更容易获得大规模支持。

为 Cisco 设备手动安装代理涉及以下步骤：

• 更新 guestshell 磁盘大小、内存和 CPU，然后启用/重新启动 guesthell。
• 安装设备代理。
• 更新 aos.config 文件。
• 启动服务。

谨慎：

Cisco GuestShell 未分区为 Apstra 的唯一性。如果还有其他应用程序托管在来宾地狱上，则来宾外壳中的任何更改都可能影响它们。

谨慎：

“Bootstrap”或“Pristine”配置中的命令可能会干扰在交换矩阵部署期间添加的 Apstra 配置。

如果配置的 NX-OS“系统巨型”值低于 Apstra 使用的 MTU，则 Apstra MTU 命令将失败。

按以下顺序配置设备：VRF、NXAPI、GuestShell、创建管理 VRF。为了允许代理与服务器之间的通信，Apstra 的设备代理使用 VRF 名称 management。确保这些行显示在正在运行的配置中。

1. 运行以下命令以调整磁盘空间、内存和 CPU 的大小：
2. 如果未启用 guestshell，请运行命令 guestshell enable 以激活更改。
3. 如果已启用 guestshell，请运行命令 guestshell reboot 以重新启动 shell 并激活更改。
4. 运行命令 switch# show guestshell detail 并验证来宾外壳是否已激活。

您可以从 Apstra 服务器通过 HTTPS 复制安装代理。下载后，确认您下载的副本的 MD5sum 与 Apstra 存储的内容匹配。

注意：

要检索代理文件，Cisco 设备使用 HTTPS 连接到 Apstra 服务器。在继续操作之前，请确保此连接正常工作。

Apstra 随代理一起从 Apstra 服务器提供。我们可以将其 /volatile复制到 或 volatile: 文件系统位置。Apstra 还在 Apstra Server 的文件夹中附带了一个 md5sum 文件 /home/admin 。

替换 aos_server_ip 变量和 aos_version 下面的运行文件。（要从 Apstra GUI 检查 Apstra 服务器版本，请导航到 平台>关于）。

验证文件是否已正确下载。

注意：

我们建议您运行命令 copy running-config startup-config 以保存最新更改，以防出现任何问题。

从思科NX-OS交换机访客地狱中，运行命令以安装代理，如下所示：

安装代理之后和启动服务之前，请更新 aos.conf 文件，使其连接到服务器。

配置位于 的 /etc/aos/aos.conf思科 NX-OS 设备代理配置文件。有关参数，请参阅 Apstra 设备代理配置文件 。

更新文件后，运行命令 service aos start 以启动 Apstra 设备代理。

当 Apstra 设备代理与 Apstra 通信时，它会使用“设备密钥”来标识自身。对于思科 NXOS 交换机，设备密钥是管理接口“eth0”的 MAC 地址。

从 Apstra GUI 的左侧导航菜单中，导航到设备 >托管设备。当代理启动并运行时，它会显示在此列表中，并且可以按照标准过程使用 GUI 确认并分配给蓝图。

如果出于某种原因（更改蓝图、重新部署、从备份还原设备等）需要重置 Apstra 代理，最好清除 Apstra 代理元数据，重新注册设备，然后重新部署到蓝图。

要卸载代理，请先使用 GUI 按照标准过程取消部署代理，然后将其从蓝图中取消分配。您也可以从“受管理设备”页面将其完全删除。

要从NX-OS中删除Apstra软件包，请销毁来宾地狱。仅当没有其他应用程序在使用 guesthell 时才执行此操作：

Apstra 设备代理会安装一些事件管理器小程序来协助遥测。这些可以安全地移除

C9K-172-20-65-5（配置）# 无事件管理器小程序 AOS_PROTO_VSH_LAUNCH C9K-172-20-65-5（配置）# 无事件管理器小程序 AOS_STATS_VSH_LAUNCH C9K-172-20-65-5（配置）# 无事件管理器小程序 aos_bgp_applet C9K-172-20-65-5（配置）# 无事件管理器小程序 aos_ifdown_applet C9K-172-20-65-5（配置）# 无事件管理器小程序aos_ifup_applet

Apstra 代理在 NXOS guestshell 下运行，与底层 bash 和 Linux 环境进行交互。这是一个内部 Linux 容器 （LXC），Apstra 在其中运行。在LXC下，Apstra利用NXAPI和其他方法直接与NXOS通信。出于安全原因，Cisco 将大部分 LXC 接口与 NXOS 设备的其余部分分开，因此我们必须使用访客 shell bash 提示符来执行更多故障排除命令。

确认访客外壳已在NX-OS上运行 Apstra 代理在 NXOS 访客外壳下运行，以与底层 bash 和 Linux 环境进行交互。这是一个内部 Linux 容器 （LXC），Apstra 在其中运行。我们正在检查以确保来宾外壳已激活并正在运行。

显示已注册的服务

• 确认 Apstra 的网络可访问性
• 确认代理安装
• 检查 Apstra 代理是否正在运行
• 检查 /etc/aos 中是否存在文件
• 在 /var/log/aos 中检查 Apstra 数据
• 确定 Apstra 代理版本
• DNS 解析失败
• Apstra 服务需要很长时间才能在思科 NX-OS 上启动
• Apstra 停止和故障无差错 （MGMT VRF）
• 验证NX-OS访客外壳中的MGMT VRF