简介面向思科ACI数据中心运维与网络工程师这是一份基于真实实验环境总结的APIC手动安装及升级实操文档覆盖从2.2版本安装到4.2.7u再到5.x版本的完整升级链路。作者在未借助原厂TAC支持的情况下独立完成部署整理了大量踩坑经验包括HFS搭建HTTP文件服务器、BIOS与TPM激活校验、CIMC引导盘调整、vKVM挂载ISO及安装过程常见卡死现象对生产环境同样有较高参考价值。资源体积仅2.1MB包含1个PDF文档方便在移动端或离线场景随时查阅目前已有578人学习下载。文档不仅给出每步操作说明还针对安装中的关键报错提供排查方向适合准备搭建或升级APIC实验环境、希望避免重复踩坑的网络工程师快速上手。1. 手动装 APIC 的完整记录从 2.2 到 5.x 是怎么硬啃下来的在一些实验环境里APIC 控制器的安装通常被认为是最省事的一环但当你面对一台被清掉系统的物理设备手上只有 ISO 镜像和一台文件服务器时事情就完全不是那么回事了。今天要拆的这份资源是一份真实的手动安装与升级 APIC 的记录包含了硬件准备、镜像验证、TPM 激活、RAID 引导调整、从 2.2.4r 一路升到 5.x 的完整操作链。中间踩过的坑比如启动过程卡死、引导盘找不到、TPM 状态不对都是实打实的现场问题。这份内容适合那些负责数据中心网络、需要独立重建 APIC 节点而不想依赖原厂支持的工程师特别是有兴趣自己动手把某个版本从底层装起来再逐级升级的场景。整个过程中有些问题看着像软件实际上卡在硬件配置上有些问题看着像网络实际上卡在镜像完整性上。如果你正准备在真实设备上做类似操作这份记录能帮你提前看清那些文档里不会写的环节。2. 安装前的关键准备版本矩阵、文件服务器与硬件状态2.1 为什么版本矩阵必须先确认跳过版本升级会出大问题APIC 控制器从旧版本跨越式升级时不是所有路径都能直接走通。某些大版本之间的跳变可能需要先升级到中间版本再继续往上升这个规则在不同硬件平台上也有差异。正式动手之前需要先去官方兼容性矩阵确认你的起点版本和终点版本之间的升级路径尤其是从 2.x 直接跳到 4.x 的场景。举个例子从 2.2.4r 升到 4.2.7u中间如果跳过了某些过渡版本可能在升级过程中出现文件系统格式不兼容或数据库迁移失败。官方给出的升级建议会按硬件平台和固件版本拆分矩阵你需要找到对应自己硬件型号的那一行确认是支持直接跳转还是必须逐级升级。这一步不做后面升级到一半卡住只能重新安装操作系统费时费力。这份资源里有一个值得注意的细节作者原本设备上是有 4.x 版本的但为了练习手动安装把系统清掉了然后从 2.2 开始重装再升级。这意味着整条路径是他实际走通的。如果你手上是 5.x 版本的 ISO不要默认可以直接降级到 2.2 再升回去降级路径通常不被支持操作前也要查矩阵确认。2.2 HFS 文件服务器搭建HTTP 方式为什么是正确选择APIC 手动安装过程中系统引导后会进入 Anaconda 安装程序此时你只有几个选择本机光驱、vKVM 映射的虚拟光驱、HTTP、SCP、NFS、CIFS。实际操作中HTTP 方式通常是最稳的因为它没有额外的认证机制和协议兼容性问题也不依赖 Windows 文件共享权限。常见做法是用 HFS 这样的轻量级 HTTP 文件服务器工具它体积小不需要安装双击就能跑起来。关键配置点是新增一个共享目录命名尽量简短比如APIC然后把 ISO 镜像放进去。之后需要确认其他机器能通过浏览器访问http://服务器IP:端口/APIC/镜像文件名这一步能提前验证路径和端口都没有问题。从实际经验看HFS 默认端口是 8080如果你机器上已经有其他服务占用了 8080需要改端口修改后在 APIC 安装引导时填写的 URL 里同步变更即可。还有一点HFS 所在机器的防火墙要放行对应端口否则安装程序下载镜像时会直接超时。你在本地浏览器确认能访问只能说明服务起来了不代表 APIC 服务器所在的网络能访问到建议从另一台机器上测试一下。2.3 CIMC 与 BIOS 版本安装 5.x 之前必须看懂的硬件条件APIC 底层运行在定制化的 Linux 系统上但硬件层面还是标准的 x86 服务器所以 CIMC带外管理接口和 BIOS 的版本会直接影响操作系统能否正常安装、能否识别所有硬盘和 TPM 模块。需要说明的是APIC 设备对 TPM可信平台模块有明确要求。APIC 5.x 版本对 TPM 的依赖比 4.x 更强某些功能模块在 TPM 未激活时会直接阻止系统启动。所以安装前要进入 BIOS 的 Advanced 选项里的 Trust Computing 子菜单检查 TPM 是否存在且状态为 Active。如果你发现选项是灰色的通常是因为没有设置 BIOS 管理员密码。解决方法是先设置 BIOS Administrator 密码然后再去配置 TPM。BIOS 版本也会影响 TPM 的可用性。老版本 BIOS 可能无法正确识别 TPM 模块。用 huu 工具升级 BIOS 是比较常见的做法半小时内能完成。如果 CIMC 版本太老建议一并升级否则后续通过 vKVM 挂载镜像时可能出现兼容性问题。不要只升级 BIOS 而不升级 CIMC两者之间存在依赖关系具体以官方固件发布说明为准。2.4 硬盘容量与 RAID 配置为什么三块盘比两块盘更保险APIC 控制器在安装时会对硬盘容量有最低要求这个要求不是单纯的“够用就行”而是安装程序会检查总可用空间。如果硬盘容量刚好卡在临界值安装过程可能会在某个 Starting 步骤卡住而且不会有明确报错。这台设备上有三块硬盘两块做 RAID 1一块做 RAID 0。实际安装时系统被装到了 RAID 1 阵列上但引导顺序默认指向了 RAID 0导致重启后找不到引导。这个现象后面会详细说这里先记住一个结论硬盘越多、容量越充裕安装程序在分区阶段的自由度就越高不容易触发奇怪的分区失败。如果生产环境要用三个 APIC 节点每个节点都建议配置同等规格的硬盘避免某个节点容量偏小导致集群安装不一致。实验环境可以灵活但生产环境不推荐用小容量盘硬撑。镜像文件本身大约 4GB 到 5GB系统安装完成后的占用远不止这些APIC 还有日志、备份、固件仓库等占用预留足够的空间可以避免后期升级时磁盘写满。3. 手动安装 APIC 全流程镜像引导、网络参数与初始化配置3.1 ISO 镜像校验MD5 不验后面全是玄学从官方渠道下载的 APIC ISO 镜像第一步必做 MD5 校验。这一步不是为了形式而是 ISO 在下载过程中如果出现损坏安装时可能表现为各种奇怪问题 — 比如引导加载到一半报文件找不到、安装程序写入分区失败、或者升级时固件包校验不通过。在 Linux 系统上校验 MD5 的方法是使用md5sum命令在 Windows 上可以用certutil两种方式都需要跟官方发布的 MD5 值进行比对。# Linux 下校验 ISO 镜像的 MD5 值 md5sum aci-apic-dk9.2.2.4r.iso # 输出示例9f2d3c8a1b5e7f0a2d4c6e8b1a3f5c7d aci-apic-dk9.2.2.4r.iso逻辑说明md5sum会读取整个文件计算出一个 128 位的哈希值并将文件名附在后面。你需要把这串哈希跟官方发布页面提供的 MD5 值做逐字符比对不能只看前几位。比对一致才说明镜像完整之后再进行安装。参数说明如果使用 Windows 系统的certutil对应命令是certutil -hashfile aci-apic-dk9.2.2.4r.iso MD5输出结果同样是一串 32 位的十六进制字符串。注意两种工具输出格式不同但哈希值本身应该是一致的。镜像校验是安装前最后一个能主动控制风险的点。如果你跳过了这步安装过程中出现文件无法解压的错误只能重新下载再从头来时间成本远超校验的几秒钟。另外下载镜像时尽量不使用断点续传工具偶尔会导致文件尾部数据不完整而 MD5 校验能帮你过滤掉这种情况。3.2 vKVM 挂载镜像与 F6 引导菜单第一个分叉点APIC 服务器通过 CIMC 的 vKVM 功能挂载 ISO 镜像挂载完成后需要重启服务器在 POST 阶段按 F6 进入引导菜单。引导菜单里会出现虚拟光驱设备通常显示为Cisco vKVM-Mapped vDVD1.22之类。选择它作为本次引导设备系统会从 ISO 镜像启动进入 CentOS 相关的引导界面。这一步有个细节F6 是按一次还是多次取决于服务器型号和 CIMC 版本。有些机器需要连续按几次才能稳定进入菜单有些只需要一次。如果你按慢了系统直接进入了本地硬盘引导需要再次重启重试。选择 vKVM 映射的虚拟光驱后屏幕上会出现一个蓝色的引导界面CentOS 引导界面这时需要回车进入默认安装选项。实际上回车之后你会看到一系列系统服务启动的日志刷屏这一步耗时可能比预期长很多尤其是通过 vKVM 挂载镜像的情况下虚拟光驱的读取速度远低于本地 SATA 或 SSD等待时间拉到 10 分钟以上也不是罕见情况。当你看到 press any key to continue 或类似提示时需要在这个窗口期内按任意键进入网络安装选项。此时你有两个选择一是直接用刚才的虚拟光驱继续安装二是切换到 HTTP 或 SCP 方式加载镜像。但如果你已经用虚拟光驱加载了 ISO一般不需要再切换到 HTTP。然而如果虚拟光驱加载失败了系统会提示你选择其他方式。这部分的实操逻辑是这样的作者在这个步骤选择的是 HTTP 方式因为镜像文件已经放在了 HFS 文件服务器上。这个选择有他的道理vKVM 的虚拟光驱在某些操作系统版本下存在驱动兼容性问题读取大文件时容易卡死而 HTTP 方式基于网络下载稳定性反而更好。3.3 网络安装参数配置Static IP、网关、URL 的填写规则当引导程序进入网络安装参数配置界面时你需要填入一组网络信息这组信息决定了 APIC 能否从文件服务器下载镜像。特别注意此处的静态 IP 是用于安装环境的临时 IP不是最终 APIC 管理 IP两者可能不同。常见配置示例如下假设文件服务器 IP 是 192.168.1.105端口 8080Static IP: 192.168.1.222/24 Gateway: 192.168.1.1 Network Interface: eth0 URL: http://192.168.1.105:8080/APIC/aci-apic-dk9.2.2.4r.iso逻辑说明Static IP 格式是IP/掩码这里用 CIDR 表示法/24等于 255.255.255.0。网关需要跟文件服务器在同一个网段否则跨网段访问可能因路由缺失而失败。网卡默认选择 eth0如果你不确定哪个网卡接入了正确的网络可以在 CIMC 上查看网卡 MAC 地址与交换机侧学习到的 MAC 进行比对。URL 的格式是http://服务器IP:端口/共享目录/镜像文件名注意镜像文件名的大小写必须与文件服务器上的实际文件名完全一致。参数说明这里的 IP 地址只是举例你需要替换成自己环境里的实际地址。避免使用 DHCP因为安装程序在下载镜像时需要稳定的 IP 连接DHCP 分配过程中可能出现租约问题或 DNS 解析失败直接使用静态 IP 最可靠。回车之后安装程序会通过 HTTP 下载镜像并自动启动安装。这一步的进度条可能长时间不动需要留意网络流量来确认下载是否还在进行。如果在文件服务器上能看到持续的流量说明下载正常如果长时间无流量多半是 IP 或 URL 填写错误可以回到上一步修改。3.4 安装过程中的 TPM 相关报错能装不代表能过安装过程中如果弹出一个关于 TPM 的报错说明 TPM 模块没有正确激活。这个报错不是在引导阶段出现而是在安装程序检测硬件配置时出现具体表现为安装进程中断并提示 TPM 设备不可用或状态不正确。这个报错的实际含义是APIC 安装程序要求 TPM 处于 Active 状态而你在 BIOS 里看到的状态可能是 Enabled 或者 No State。Enabled 和 Active 是两回事Enabled 只是 TPM 在 BIOS 层面被启用但还没有被初始化。需要进入 BIOS 的 Trust Computing 子菜单执行工厂重置或激活操作让 TPM 进入 Active 状态。如果 BIOS 里 TPM 选项是灰色不可配置基本可以断定是 BIOS 管理员密码未设置。APIC 设备的 BIOS 默认没有管理员密码此时 TPM 配置项会被锁定。设置一个简单的 BIOS 管理员密码建议设置为password便于记忆保存重启后再进入 Trust ComputingTPM 选项就能配置了。激活 TPM 后重启进入安装程序这一步报错不会再出现。需要注意的是TPM 激活操作在某些平台上会导致 BitLocker 类功能需要恢复密钥但服务器上一般没有启用这类功能不用太担心。3.5 系统初始化参数配置实验环境 vs 生产环境的差异系统安装完成后APIC 会进入初始化配置阶段此时需要在命令行界面输入一系列参数包括但不限于管理 IP、网关、主机名、控制器名称、集群配置等。如果你只装一个节点可以配置为独立模式如果要构建集群需要配置三个节点的 Fabric 名称、Spine/Leaf 角色信息等。生产环境与实验环境的配置差异主要在于管理 IP 地址规划实验环境可以随便用一段私有地址生产环境需要与现有网络规划一致包含正确的掩码、网关、DNS、NTP 服务器集群节点数实验环境单节点够用生产环境至少三个节点并且每个节点的管理 IP 需要在同一网段且能互通NTP 时间同步实验环境可以忽略生产环境必须配置否则集群间的证书认证和日志时间戳会出现偏差初始化配置完成后系统会重启并加载 APIC 的应用程序这个过程可能持续 10 到 15 分钟。等到命令行界面返回登录提示符说明基础系统已经起来了。此时可以通过浏览器访问https://管理IP登录 APIC Web 界面用户名和密码由初始化配置时设置。4. 避坑手册安装过程中的 5 个常见问题与处理方法4.1 安装卡在 Starting Terminate Plymouth Boot Screen现象系统引导后停留在 Plymouth 启动画面10 分钟无进展等待数小时依旧如此只能强制重启。这个坑在不同机器上可能表现为卡在 Starting Anaconda NetworkManager configuration 或 Starting Dump dmesg to /var/log/dmesg。原因分析这个问题的本质是安装程序在初始化某些硬件时阻塞可能原因包括 TPM 未激活、硬盘容量不足、或虚拟光驱读取异常。网上的建议有修改内核引导参数inst.rzam0、关闭网络管理等实测效果有限。真正能确认有效的措施是提前激活 TPM 并保证硬盘容量在建议值以上。解决办法按照前文步骤进入 BIOS设置管理员密码进入 Trust Computing 菜单确认 TPM 状态为 Active。同时确认 CIMC 的固件版本不要过老必要时升级 CIMC在引导参数中追加inst.rzam0可以避免某些内存分配问题可一并尝试。如果上述操作都做完仍然卡住换一块更大的硬盘试试有时候 300GB 以下容量的盘会触发分区异常。4.2 重启后找不到引导设备现象安装过程显示完成并提示重启重启后黑屏或提示 No boot device found。在 CIMC 的引导设置里当前引导盘指向了容量较小的 RAID 0 阵列而系统实际安装在 RAID 1 阵列上。原因分析安装程序在分区时会把系统引导放在它认为合适的磁盘上。当多块硬盘存在多个 RAID 阵列时BIOS 的引导顺序默认指向排序靠前的设备不一定是安装目标盘。就这台设备而言三块硬盘做成两组阵列后BIOS 里默认的引导盘是 RAID 0而系统引导文件在 RAID 1 上。解决办法进入 CIMC 的 BIOS 引导配置界面将 RAID 1 阵列设置为第一引导设备。保存设置后重启会看到 RAID 1 阵列的引导分区被正确识别系统可以正常启动。如果你后续还要升级 BIOS 或更换硬件记得重新检查引导顺序。4.3 HTTP 方式下载镜像时速度极慢甚至断流现象在安装引导界面选择了 HTTP 方式后下载进度长时间停留在某个百分比或直接报连接超时错误。多次重试仍然失败。原因分析HTTP 文件服务器本身没问题但安装程序通过虚拟网络接口下载时MTU 或防火墙策略可能阻断大包传输。另外HFS 默认的传输线程数有限多个并发连接时可能互相争抢带宽。解决办法检查文件服务器所在机器的防火墙放行 8080 端口或禁用防火墙确认交换机端口 MTU 设置为 1500不要开启 jumbo frame如果文件服务器上跑了多个服务建议临时停掉其他占用带宽的进程。还有一种可能就是 URL 中文件名打错了哪怕大小写不对HTTP 服务器也会返回 404但安装程序可能将其误报为网络超时此时需要在文件服务器上查看访问日志确认请求到达。4.4 升级到 5.x 时本地方式上传镜像卡死现象在 APIC Web 界面上传 5.x 版本 ISO 镜像时界面卡住不动上传进度条不走刷新页面也无济于事只能重新操作。原因分析APIC 的 Web 界面上传功能处理大文件时容易出问题5.x 镜像文件比其他版本更大浏览器上传时内存占用和连接稳定性都有挑战。作者在实战中发现本地方式上传镜像会卡死改用 HTTP 文件服务器方式则顺利。解决办法使用 HTTP 文件服务器方式上传。具体操作为在 APIC 的 Firmware Repository 中选择通过 URL 添加固件填入类似http://192.168.1.105:8080/APIC/aci-apic-dk9.5.x.iso的地址让 APIC 从文件服务器直接拉取镜像。要注意确保文件服务器仍然在线且 APIC 能路由到文件服务器的 IP 地址。4.5 确认 TPM 状态Enabled 不等于 Active现象BIOS 里 Trust Computing 子菜单显示 TPM 为 Enabled但系统安装时仍然报 TPM 相关错误无法继续。原因分析TPM 的 Enabled 状态仅仅代表它是“打开”的但还没有完成初始化操作。APIC 要求的是 Active即 TPM 已经被激活。简单说Enabled 是硬件层面允许使用 TPMActive 是 TPM 内部已经完成了所有者建立等初始化步骤。解决办法在 Trust Computing 菜单中找到 TPM Activation 或类似选项将其设置为 Activate。如果找不到该选项查看当前 TPM 状态通常会有 Clear/Reset 相关操作执行后设置为 Active。操作完成后需要保存设置并重启重启后回到 BIOS 再次确认状态为 Active再进入系统安装。5. 从 2.2.4r 到 5.x 的升级路径验证与 UI 操作技巧5.1 上传固件HTTP 方式远超本地方式手动安装完成 2.2.4r 后下一步就是升级。进入 APIC Web 界面找到 Admin 菜单下的 Download Tasks 或 Firmware Management。上传固件有两种方式本地文件上传和 URL 上传。实际评测下来URL 模式是更稳定的一条路特别适合大文件版本。你只需要在 URL 字段输入http://192.168.1.105:8080/APIC/aci-apic-dk9.4.2.7u.isoAPIC 就会从文件服务器拉取镜像。上传完成后需要在 Firmware Repository 里看到对应的版本条目确认文件大小与本地 ISO 一致这一步能间接校验传输过程的完整性。如果在 Repository 里看不到多半是 URL 超时或文件服务器路径不对建议检查文件服务器日志。5.2 控制器升级逐级升级与单次升级的取舍APIC 版本升级路径是有限的你需要先确认当前版本到目标版本之间是否可以直接升级。以 2.2.4r 到 4.2.7u 为例这个升级可以一次完成但如果你的起点版本太老可能需要先升到某个中间版本再升到目标版本。这个中间版本的编号与官方升级矩阵一致。在 Controller Firmware 一栏中选择目标版本点击 Upgrade 按钮APIC 会开始升级流程。此时界面会展示升级进度但注意升级过程中 APIC 会重启多次页面会暂时无法访问这属于正常现象。你不用反复刷新页面应该耐心等待一般需要 30 到 60 分钟。如果页面长时间打不开可以通过 ping 管理 IP 来判断系统是否已经恢复。5.3 升级到 5.x 版本的特有注意点5.x 版本的升级有一个与之前不同的地方不要使用本地方式上传镜像否则会卡死。这是我实测后得到的结论。不过在 URL 方式下整个升级流程反而更顺畅可能是因为 5.x 的镜像文件更大对上传通道更敏感。升级完成后首先确认 Web 界面能正常登录其次在 Fabric 相关的系统信息里核对版本号确实变为 5.x。升级到 5.x 后如果还想继续升级到更新版本也需要查兼容性矩阵确认不要默认 APIC 可以无限跨版本升级。5.x 对底层的系统组件要求更高升级前确认 CIMC 和 BIOS 都是较新版本能避免很多兼容性报错。5.4 升级后的验证清单不只是看版本号登录 Web 界面确认版本号显示正确界面功能菜单完整检查 Fabric 节点状态确认节点处于 Active 状态没有出现故障告警查看系统日志确认没有升级过程中遗留的异常错误检查 NTP 同步状态升级后系统重启可能影响时间同步需要确认时间正确检查备份配置APIC 升级后建议手动触发一次配置备份优先确保配置可恢复从那以后我每次处理 APIC 升级都会强制走一遍升级前的检查清单包括 MD5 比对、固件兼容性查询、TPM 状态确认。这套流程看起来多花了几分钟但实际上省下的时间和精力往往多得多。希望这份手动安装与升级的具体记录能帮你在今后的实验或生产部署中少走一些弯路。本文还有配套的精品资源点击获取 
长河君 · 2026/10/15 21:53:47 · 阅读 1.2k 从2.2到5.x：APIC控制器手动安装与升级避坑实录
简介面向思科ACI数据中心运维与网络工程师这是一份基于真实实验环境总结的APIC手动安装及升级实操文档覆盖从2.2版本安装到4.2.7u再到5.x版本的完整升级链路。作者在未借助原厂TAC支持的情况下独立完成部署整理了大量踩坑经验包括HFS搭建HTTP文件服务器、BIOS与TPM激活校验、CIMC引导盘调整、vKVM挂载ISO及安装过程常见卡死现象对生产环境同样有较高参考价值。资源体积仅2.1MB包含1个PDF文档方便在移动端或离线场景随时查阅目前已有578人学习下载。文档不仅给出每步操作说明还针对安装中的关键报错提供排查方向适合准备搭建或升级APIC实验环境、希望避免重复踩坑的网络工程师快速上手。1. 手动装 APIC 的完整记录从 2.2 到 5.x 是怎么硬啃下来的在一些实验环境里APIC 控制器的安装通常被认为是最省事的一环但当你面对一台被清掉系统的物理设备手上只有 ISO 镜像和一台文件服务器时事情就完全不是那么回事了。今天要拆的这份资源是一份真实的手动安装与升级 APIC 的记录包含了硬件准备、镜像验证、TPM 激活、RAID 引导调整、从 2.2.4r 一路升到 5.x 的完整操作链。中间踩过的坑比如启动过程卡死、引导盘找不到、TPM 状态不对都是实打实的现场问题。这份内容适合那些负责数据中心网络、需要独立重建 APIC 节点而不想依赖原厂支持的工程师特别是有兴趣自己动手把某个版本从底层装起来再逐级升级的场景。整个过程中有些问题看着像软件实际上卡在硬件配置上有些问题看着像网络实际上卡在镜像完整性上。如果你正准备在真实设备上做类似操作这份记录能帮你提前看清那些文档里不会写的环节。2. 安装前的关键准备版本矩阵、文件服务器与硬件状态2.1 为什么版本矩阵必须先确认跳过版本升级会出大问题APIC 控制器从旧版本跨越式升级时不是所有路径都能直接走通。某些大版本之间的跳变可能需要先升级到中间版本再继续往上升这个规则在不同硬件平台上也有差异。正式动手之前需要先去官方兼容性矩阵确认你的起点版本和终点版本之间的升级路径尤其是从 2.x 直接跳到 4.x 的场景。举个例子从 2.2.4r 升到 4.2.7u中间如果跳过了某些过渡版本可能在升级过程中出现文件系统格式不兼容或数据库迁移失败。官方给出的升级建议会按硬件平台和固件版本拆分矩阵你需要找到对应自己硬件型号的那一行确认是支持直接跳转还是必须逐级升级。这一步不做后面升级到一半卡住只能重新安装操作系统费时费力。这份资源里有一个值得注意的细节作者原本设备上是有 4.x 版本的但为了练习手动安装把系统清掉了然后从 2.2 开始重装再升级。这意味着整条路径是他实际走通的。如果你手上是 5.x 版本的 ISO不要默认可以直接降级到 2.2 再升回去降级路径通常不被支持操作前也要查矩阵确认。2.2 HFS 文件服务器搭建HTTP 方式为什么是正确选择APIC 手动安装过程中系统引导后会进入 Anaconda 安装程序此时你只有几个选择本机光驱、vKVM 映射的虚拟光驱、HTTP、SCP、NFS、CIFS。实际操作中HTTP 方式通常是最稳的因为它没有额外的认证机制和协议兼容性问题也不依赖 Windows 文件共享权限。常见做法是用 HFS 这样的轻量级 HTTP 文件服务器工具它体积小不需要安装双击就能跑起来。关键配置点是新增一个共享目录命名尽量简短比如APIC然后把 ISO 镜像放进去。之后需要确认其他机器能通过浏览器访问http://服务器IP:端口/APIC/镜像文件名这一步能提前验证路径和端口都没有问题。从实际经验看HFS 默认端口是 8080如果你机器上已经有其他服务占用了 8080需要改端口修改后在 APIC 安装引导时填写的 URL 里同步变更即可。还有一点HFS 所在机器的防火墙要放行对应端口否则安装程序下载镜像时会直接超时。你在本地浏览器确认能访问只能说明服务起来了不代表 APIC 服务器所在的网络能访问到建议从另一台机器上测试一下。2.3 CIMC 与 BIOS 版本安装 5.x 之前必须看懂的硬件条件APIC 底层运行在定制化的 Linux 系统上但硬件层面还是标准的 x86 服务器所以 CIMC带外管理接口和 BIOS 的版本会直接影响操作系统能否正常安装、能否识别所有硬盘和 TPM 模块。需要说明的是APIC 设备对 TPM可信平台模块有明确要求。APIC 5.x 版本对 TPM 的依赖比 4.x 更强某些功能模块在 TPM 未激活时会直接阻止系统启动。所以安装前要进入 BIOS 的 Advanced 选项里的 Trust Computing 子菜单检查 TPM 是否存在且状态为 Active。如果你发现选项是灰色的通常是因为没有设置 BIOS 管理员密码。解决方法是先设置 BIOS Administrator 密码然后再去配置 TPM。BIOS 版本也会影响 TPM 的可用性。老版本 BIOS 可能无法正确识别 TPM 模块。用 huu 工具升级 BIOS 是比较常见的做法半小时内能完成。如果 CIMC 版本太老建议一并升级否则后续通过 vKVM 挂载镜像时可能出现兼容性问题。不要只升级 BIOS 而不升级 CIMC两者之间存在依赖关系具体以官方固件发布说明为准。2.4 硬盘容量与 RAID 配置为什么三块盘比两块盘更保险APIC 控制器在安装时会对硬盘容量有最低要求这个要求不是单纯的“够用就行”而是安装程序会检查总可用空间。如果硬盘容量刚好卡在临界值安装过程可能会在某个 Starting 步骤卡住而且不会有明确报错。这台设备上有三块硬盘两块做 RAID 1一块做 RAID 0。实际安装时系统被装到了 RAID 1 阵列上但引导顺序默认指向了 RAID 0导致重启后找不到引导。这个现象后面会详细说这里先记住一个结论硬盘越多、容量越充裕安装程序在分区阶段的自由度就越高不容易触发奇怪的分区失败。如果生产环境要用三个 APIC 节点每个节点都建议配置同等规格的硬盘避免某个节点容量偏小导致集群安装不一致。实验环境可以灵活但生产环境不推荐用小容量盘硬撑。镜像文件本身大约 4GB 到 5GB系统安装完成后的占用远不止这些APIC 还有日志、备份、固件仓库等占用预留足够的空间可以避免后期升级时磁盘写满。3. 手动安装 APIC 全流程镜像引导、网络参数与初始化配置3.1 ISO 镜像校验MD5 不验后面全是玄学从官方渠道下载的 APIC ISO 镜像第一步必做 MD5 校验。这一步不是为了形式而是 ISO 在下载过程中如果出现损坏安装时可能表现为各种奇怪问题 — 比如引导加载到一半报文件找不到、安装程序写入分区失败、或者升级时固件包校验不通过。在 Linux 系统上校验 MD5 的方法是使用md5sum命令在 Windows 上可以用certutil两种方式都需要跟官方发布的 MD5 值进行比对。# Linux 下校验 ISO 镜像的 MD5 值 md5sum aci-apic-dk9.2.2.4r.iso # 输出示例9f2d3c8a1b5e7f0a2d4c6e8b1a3f5c7d aci-apic-dk9.2.2.4r.iso逻辑说明md5sum会读取整个文件计算出一个 128 位的哈希值并将文件名附在后面。你需要把这串哈希跟官方发布页面提供的 MD5 值做逐字符比对不能只看前几位。比对一致才说明镜像完整之后再进行安装。参数说明如果使用 Windows 系统的certutil对应命令是certutil -hashfile aci-apic-dk9.2.2.4r.iso MD5输出结果同样是一串 32 位的十六进制字符串。注意两种工具输出格式不同但哈希值本身应该是一致的。镜像校验是安装前最后一个能主动控制风险的点。如果你跳过了这步安装过程中出现文件无法解压的错误只能重新下载再从头来时间成本远超校验的几秒钟。另外下载镜像时尽量不使用断点续传工具偶尔会导致文件尾部数据不完整而 MD5 校验能帮你过滤掉这种情况。3.2 vKVM 挂载镜像与 F6 引导菜单第一个分叉点APIC 服务器通过 CIMC 的 vKVM 功能挂载 ISO 镜像挂载完成后需要重启服务器在 POST 阶段按 F6 进入引导菜单。引导菜单里会出现虚拟光驱设备通常显示为Cisco vKVM-Mapped vDVD1.22之类。选择它作为本次引导设备系统会从 ISO 镜像启动进入 CentOS 相关的引导界面。这一步有个细节F6 是按一次还是多次取决于服务器型号和 CIMC 版本。有些机器需要连续按几次才能稳定进入菜单有些只需要一次。如果你按慢了系统直接进入了本地硬盘引导需要再次重启重试。选择 vKVM 映射的虚拟光驱后屏幕上会出现一个蓝色的引导界面CentOS 引导界面这时需要回车进入默认安装选项。实际上回车之后你会看到一系列系统服务启动的日志刷屏这一步耗时可能比预期长很多尤其是通过 vKVM 挂载镜像的情况下虚拟光驱的读取速度远低于本地 SATA 或 SSD等待时间拉到 10 分钟以上也不是罕见情况。当你看到 press any key to continue 或类似提示时需要在这个窗口期内按任意键进入网络安装选项。此时你有两个选择一是直接用刚才的虚拟光驱继续安装二是切换到 HTTP 或 SCP 方式加载镜像。但如果你已经用虚拟光驱加载了 ISO一般不需要再切换到 HTTP。然而如果虚拟光驱加载失败了系统会提示你选择其他方式。这部分的实操逻辑是这样的作者在这个步骤选择的是 HTTP 方式因为镜像文件已经放在了 HFS 文件服务器上。这个选择有他的道理vKVM 的虚拟光驱在某些操作系统版本下存在驱动兼容性问题读取大文件时容易卡死而 HTTP 方式基于网络下载稳定性反而更好。3.3 网络安装参数配置Static IP、网关、URL 的填写规则当引导程序进入网络安装参数配置界面时你需要填入一组网络信息这组信息决定了 APIC 能否从文件服务器下载镜像。特别注意此处的静态 IP 是用于安装环境的临时 IP不是最终 APIC 管理 IP两者可能不同。常见配置示例如下假设文件服务器 IP 是 192.168.1.105端口 8080Static IP: 192.168.1.222/24 Gateway: 192.168.1.1 Network Interface: eth0 URL: http://192.168.1.105:8080/APIC/aci-apic-dk9.2.2.4r.iso逻辑说明Static IP 格式是IP/掩码这里用 CIDR 表示法/24等于 255.255.255.0。网关需要跟文件服务器在同一个网段否则跨网段访问可能因路由缺失而失败。网卡默认选择 eth0如果你不确定哪个网卡接入了正确的网络可以在 CIMC 上查看网卡 MAC 地址与交换机侧学习到的 MAC 进行比对。URL 的格式是http://服务器IP:端口/共享目录/镜像文件名注意镜像文件名的大小写必须与文件服务器上的实际文件名完全一致。参数说明这里的 IP 地址只是举例你需要替换成自己环境里的实际地址。避免使用 DHCP因为安装程序在下载镜像时需要稳定的 IP 连接DHCP 分配过程中可能出现租约问题或 DNS 解析失败直接使用静态 IP 最可靠。回车之后安装程序会通过 HTTP 下载镜像并自动启动安装。这一步的进度条可能长时间不动需要留意网络流量来确认下载是否还在进行。如果在文件服务器上能看到持续的流量说明下载正常如果长时间无流量多半是 IP 或 URL 填写错误可以回到上一步修改。3.4 安装过程中的 TPM 相关报错能装不代表能过安装过程中如果弹出一个关于 TPM 的报错说明 TPM 模块没有正确激活。这个报错不是在引导阶段出现而是在安装程序检测硬件配置时出现具体表现为安装进程中断并提示 TPM 设备不可用或状态不正确。这个报错的实际含义是APIC 安装程序要求 TPM 处于 Active 状态而你在 BIOS 里看到的状态可能是 Enabled 或者 No State。Enabled 和 Active 是两回事Enabled 只是 TPM 在 BIOS 层面被启用但还没有被初始化。需要进入 BIOS 的 Trust Computing 子菜单执行工厂重置或激活操作让 TPM 进入 Active 状态。如果 BIOS 里 TPM 选项是灰色不可配置基本可以断定是 BIOS 管理员密码未设置。APIC 设备的 BIOS 默认没有管理员密码此时 TPM 配置项会被锁定。设置一个简单的 BIOS 管理员密码建议设置为password便于记忆保存重启后再进入 Trust ComputingTPM 选项就能配置了。激活 TPM 后重启进入安装程序这一步报错不会再出现。需要注意的是TPM 激活操作在某些平台上会导致 BitLocker 类功能需要恢复密钥但服务器上一般没有启用这类功能不用太担心。3.5 系统初始化参数配置实验环境 vs 生产环境的差异系统安装完成后APIC 会进入初始化配置阶段此时需要在命令行界面输入一系列参数包括但不限于管理 IP、网关、主机名、控制器名称、集群配置等。如果你只装一个节点可以配置为独立模式如果要构建集群需要配置三个节点的 Fabric 名称、Spine/Leaf 角色信息等。生产环境与实验环境的配置差异主要在于管理 IP 地址规划实验环境可以随便用一段私有地址生产环境需要与现有网络规划一致包含正确的掩码、网关、DNS、NTP 服务器集群节点数实验环境单节点够用生产环境至少三个节点并且每个节点的管理 IP 需要在同一网段且能互通NTP 时间同步实验环境可以忽略生产环境必须配置否则集群间的证书认证和日志时间戳会出现偏差初始化配置完成后系统会重启并加载 APIC 的应用程序这个过程可能持续 10 到 15 分钟。等到命令行界面返回登录提示符说明基础系统已经起来了。此时可以通过浏览器访问https://管理IP登录 APIC Web 界面用户名和密码由初始化配置时设置。4. 避坑手册安装过程中的 5 个常见问题与处理方法4.1 安装卡在 Starting Terminate Plymouth Boot Screen现象系统引导后停留在 Plymouth 启动画面10 分钟无进展等待数小时依旧如此只能强制重启。这个坑在不同机器上可能表现为卡在 Starting Anaconda NetworkManager configuration 或 Starting Dump dmesg to /var/log/dmesg。原因分析这个问题的本质是安装程序在初始化某些硬件时阻塞可能原因包括 TPM 未激活、硬盘容量不足、或虚拟光驱读取异常。网上的建议有修改内核引导参数inst.rzam0、关闭网络管理等实测效果有限。真正能确认有效的措施是提前激活 TPM 并保证硬盘容量在建议值以上。解决办法按照前文步骤进入 BIOS设置管理员密码进入 Trust Computing 菜单确认 TPM 状态为 Active。同时确认 CIMC 的固件版本不要过老必要时升级 CIMC在引导参数中追加inst.rzam0可以避免某些内存分配问题可一并尝试。如果上述操作都做完仍然卡住换一块更大的硬盘试试有时候 300GB 以下容量的盘会触发分区异常。4.2 重启后找不到引导设备现象安装过程显示完成并提示重启重启后黑屏或提示 No boot device found。在 CIMC 的引导设置里当前引导盘指向了容量较小的 RAID 0 阵列而系统实际安装在 RAID 1 阵列上。原因分析安装程序在分区时会把系统引导放在它认为合适的磁盘上。当多块硬盘存在多个 RAID 阵列时BIOS 的引导顺序默认指向排序靠前的设备不一定是安装目标盘。就这台设备而言三块硬盘做成两组阵列后BIOS 里默认的引导盘是 RAID 0而系统引导文件在 RAID 1 上。解决办法进入 CIMC 的 BIOS 引导配置界面将 RAID 1 阵列设置为第一引导设备。保存设置后重启会看到 RAID 1 阵列的引导分区被正确识别系统可以正常启动。如果你后续还要升级 BIOS 或更换硬件记得重新检查引导顺序。4.3 HTTP 方式下载镜像时速度极慢甚至断流现象在安装引导界面选择了 HTTP 方式后下载进度长时间停留在某个百分比或直接报连接超时错误。多次重试仍然失败。原因分析HTTP 文件服务器本身没问题但安装程序通过虚拟网络接口下载时MTU 或防火墙策略可能阻断大包传输。另外HFS 默认的传输线程数有限多个并发连接时可能互相争抢带宽。解决办法检查文件服务器所在机器的防火墙放行 8080 端口或禁用防火墙确认交换机端口 MTU 设置为 1500不要开启 jumbo frame如果文件服务器上跑了多个服务建议临时停掉其他占用带宽的进程。还有一种可能就是 URL 中文件名打错了哪怕大小写不对HTTP 服务器也会返回 404但安装程序可能将其误报为网络超时此时需要在文件服务器上查看访问日志确认请求到达。4.4 升级到 5.x 时本地方式上传镜像卡死现象在 APIC Web 界面上传 5.x 版本 ISO 镜像时界面卡住不动上传进度条不走刷新页面也无济于事只能重新操作。原因分析APIC 的 Web 界面上传功能处理大文件时容易出问题5.x 镜像文件比其他版本更大浏览器上传时内存占用和连接稳定性都有挑战。作者在实战中发现本地方式上传镜像会卡死改用 HTTP 文件服务器方式则顺利。解决办法使用 HTTP 文件服务器方式上传。具体操作为在 APIC 的 Firmware Repository 中选择通过 URL 添加固件填入类似http://192.168.1.105:8080/APIC/aci-apic-dk9.5.x.iso的地址让 APIC 从文件服务器直接拉取镜像。要注意确保文件服务器仍然在线且 APIC 能路由到文件服务器的 IP 地址。4.5 确认 TPM 状态Enabled 不等于 Active现象BIOS 里 Trust Computing 子菜单显示 TPM 为 Enabled但系统安装时仍然报 TPM 相关错误无法继续。原因分析TPM 的 Enabled 状态仅仅代表它是“打开”的但还没有完成初始化操作。APIC 要求的是 Active即 TPM 已经被激活。简单说Enabled 是硬件层面允许使用 TPMActive 是 TPM 内部已经完成了所有者建立等初始化步骤。解决办法在 Trust Computing 菜单中找到 TPM Activation 或类似选项将其设置为 Activate。如果找不到该选项查看当前 TPM 状态通常会有 Clear/Reset 相关操作执行后设置为 Active。操作完成后需要保存设置并重启重启后回到 BIOS 再次确认状态为 Active再进入系统安装。5. 从 2.2.4r 到 5.x 的升级路径验证与 UI 操作技巧5.1 上传固件HTTP 方式远超本地方式手动安装完成 2.2.4r 后下一步就是升级。进入 APIC Web 界面找到 Admin 菜单下的 Download Tasks 或 Firmware Management。上传固件有两种方式本地文件上传和 URL 上传。实际评测下来URL 模式是更稳定的一条路特别适合大文件版本。你只需要在 URL 字段输入http://192.168.1.105:8080/APIC/aci-apic-dk9.4.2.7u.isoAPIC 就会从文件服务器拉取镜像。上传完成后需要在 Firmware Repository 里看到对应的版本条目确认文件大小与本地 ISO 一致这一步能间接校验传输过程的完整性。如果在 Repository 里看不到多半是 URL 超时或文件服务器路径不对建议检查文件服务器日志。5.2 控制器升级逐级升级与单次升级的取舍APIC 版本升级路径是有限的你需要先确认当前版本到目标版本之间是否可以直接升级。以 2.2.4r 到 4.2.7u 为例这个升级可以一次完成但如果你的起点版本太老可能需要先升到某个中间版本再升到目标版本。这个中间版本的编号与官方升级矩阵一致。在 Controller Firmware 一栏中选择目标版本点击 Upgrade 按钮APIC 会开始升级流程。此时界面会展示升级进度但注意升级过程中 APIC 会重启多次页面会暂时无法访问这属于正常现象。你不用反复刷新页面应该耐心等待一般需要 30 到 60 分钟。如果页面长时间打不开可以通过 ping 管理 IP 来判断系统是否已经恢复。5.3 升级到 5.x 版本的特有注意点5.x 版本的升级有一个与之前不同的地方不要使用本地方式上传镜像否则会卡死。这是我实测后得到的结论。不过在 URL 方式下整个升级流程反而更顺畅可能是因为 5.x 的镜像文件更大对上传通道更敏感。升级完成后首先确认 Web 界面能正常登录其次在 Fabric 相关的系统信息里核对版本号确实变为 5.x。升级到 5.x 后如果还想继续升级到更新版本也需要查兼容性矩阵确认不要默认 APIC 可以无限跨版本升级。5.x 对底层的系统组件要求更高升级前确认 CIMC 和 BIOS 都是较新版本能避免很多兼容性报错。5.4 升级后的验证清单不只是看版本号登录 Web 界面确认版本号显示正确界面功能菜单完整检查 Fabric 节点状态确认节点处于 Active 状态没有出现故障告警查看系统日志确认没有升级过程中遗留的异常错误检查 NTP 同步状态升级后系统重启可能影响时间同步需要确认时间正确检查备份配置APIC 升级后建议手动触发一次配置备份优先确保配置可恢复从那以后我每次处理 APIC 升级都会强制走一遍升级前的检查清单包括 MD5 比对、固件兼容性查询、TPM 状态确认。这套流程看起来多花了几分钟但实际上省下的时间和精力往往多得多。希望这份手动安装与升级的具体记录能帮你在今后的实验或生产部署中少走一些弯路。本文还有配套的精品资源点击获取