Cisco ACI APIC手动安装与升级实战：避坑指南

简介面向思科ACI运维与网络工程师的《APIC手动安装及升级》PDF文档聚焦APIC控制器从零安装到高版本升级的完整路径。内容源于作者在实验环境中独立摸索的真实记录不依赖原厂TAC支持清晰还原了HTTP文件服务器搭建、CIMC与BIOS状态确认、TPM激活、镜像校验以及安装阶段常见的启动卡死、引导盘识别错误等易错点。文档还对比了本地上传与HTTP上传两种固件分发方式给出了从2.2.4r到4.2.7u、再到5.x的升级版本路径并针对生产环境与实验环境的差异给出提醒。整个压缩包共包含1个PDF文件大小约2.1MB内容紧凑且可直接对照查阅已有578人下载学习适合准备部署或升级ACI APIC的中高级网络工程师作为动手前的避坑参考。1. APIC手动安装一周血泪踩坑才装通的控制器某实验环境里有一台APIC控制器原本跑着4.x版本一次误操作把系统引导干掉了。找原厂TAC是一条路但实验环境我更想自己摸一遍结果这一摸就是一周。Cisco ACI APIC手动安装这件事网上资料分散官方文档又把几个关键条件一笔带过真正卡人的是vKVM挂载、HTTP文件服务器、TPM激活、RAID引导盘这几个环节。我前后重装了十几次光一个Starting Terminate Plymouth Boot Screen就挂了一整晚等不到结果。这篇安装记录写给正在重装APIC的开发者也写给准备做版本升级的运维把参数、顺序、报错一次讲透照着走能少熬几个夜。2. 装前准备HTTP文件服务器、固件版本与TPM激活一样都别省APIC手动安装之所以容易失败多数不是安装过程本身的问题而是前置条件没满足。文件服务器用的是HTTP还是NFS、BIOS版本够不够、镜像MD5有没有校验、TPM有没有激活任何一项不对后面都会以各种诡异的方式翻车。所以第一步别急着挂ISO先把这些基础项逐条过一遍。2.1 文件服务器必须走HTTPHFS轻量级搭建APIC共享目录安装APIC时ISO镜像不放在本机而是通过引导程序从外部服务器拉取。文件服务器是NFS、CIFS还是HTTP看起来差别不大实际影响很大。我一开始用NFS方式挂载安装程序读到一半就没反应反复试了两三次都卡在同一个位置换成HTTP后一次就通了。HTTP是无状态协议连接建立简单镜像传输过程中不容易被额外的服务依赖拖住APIC安装引导对HTTP的兼容也最稳。文件服务器不用搭得很重HFS这个轻量级程序就够用。它在Windows下运行双击启动后在界面里新增一个名为APIC的虚拟目录把镜像文件放进去HTTP访问能打开就算通了。HFS默认监听8080端口访问地址类似http://192.168.1.105:8080/APIC/。配置参数整理如下。配置项推荐值说明服务器IP192.168.1.105与APIC管理地址同网段保证路由可达端口8080HFS默认端口注意防火墙放行共享目录APICHFS里新增的虚拟目录名大小写敏感镜像URLhttp://192.168.1.105:8080/APIC/aci-apic-dk9.2.2.4r.iso安装引导时要填写的完整地址注意一点共享目录名和镜像文件名的大小写在URL里必须与实际情况完全一致。APIC的CentOS引导对路径匹配是严格校验的大小写不对会直接报403或者拉不到文件。搭建完成后先在浏览器里把http://192.168.1.105:8080/APIC/打开能看到镜像文件列表再往下走不要等到安装引导时才验证那会儿定位问题就麻烦了。2.2 CIMC与BIOS版本4.1不影响上5.x建议升HuuAPIC底层是Cisco UCS C系列的硬件远程管理依赖CIMC底层引导依赖BIOS。我手上这台C220M4的CIMC固件版本很低显示Firmware Version 2.0(3i)BIOS原本是4.1。考虑到后面要升到5.x我用Huu镜像把BIOS升到了4.4版本号为C220M4.4.1.2c.0.0202211901。实测装4.2版本时BIOS保持4.1也可以正常安装不影响结果但目标如果是5.x建议CIMC和BIOS一起用Huu升级整个过程大约半小时能全部完成。组件初始版本升级后版本必备性CIMC Firmware2.0(3i)2.0(3i)或更高上5.x建议一并升级BIOS4.14.4C220M4.4.1.2c.0.0202211901装4.2时4.1够用BIOS升级最好放在装APIC系统之前做免得系统装完再去动固件又要多一次重启。把Huu镜像挂到CIMC虚拟光驱里进入升级维护界面后按提示刷新半小时内完成期间一定不要断电升级失败的话CIMC本身可能起不来那就真的进退两难了。2.3 镜像下载与MD5校验2.2.4r到4.2.7u的版本路径镜像版本路径需要提前确认不能想升哪个就升哪个。我这次的路径是先把APIC恢复到2.2.4r再升级到4.2.7u最后上5.x。跨版本跳跃在两三代以上容易出兼容问题官方版本兼容矩阵页也建议按顺序走这一步查文档花不了几分钟值得做。下载ISO后先做MD5校验。我见过有人跳过校验直接挂载装到一半报错还以为是安装方式问题其实是镜像文件本身损坏。校验命令很简单。md5sum aci-apic-dk9.2.2.4r.iso # 输出示例a1b2c3d4...逐位对比官网给出的MD5值对比时注意大小写MD5值不匹配就重新下载千万别拿一个无法确定完整性的镜像当后备。这步算是我吃了不少亏后的条件反射镜像校验是后面所有安装动作的前提宁可多花几分钟重新下载也不要在安装到一半时才怀疑人生。2.4 TPM激活BIOS里那个最容易被忽略的开关TPM在APIC安装里扮演的角色很容易被忽略但它和安装卡死、安装中途报错直接相关。进入BIOS的Advanced菜单找到Trust ComputingTPM开关就在里面必须确保Current Status显示为Active。如果进去发现配置项是灰色的说明BIOS没有设置administrator密码安全配置处于锁定状态。先到BIOS里把administrator密码设置好密码我一般放password方便后面反复进出再回到Trust Computing配置TPM确认状态变成Active。BIOS密码这个细节第一次折腾时我卡了很久一度以为硬件不支持TPM其实只是密码没设。设完密码后TPM的开关从灰色变成可配置激活后保存退出。这里建议把TPM状态记录下来后面安装如果报TPM相关错误可以少走弯路。TPM不active的影响不一定在开机时暴露有时是系统下载完镜像开始校验时才报那时再回头改BIOS等于整个安装流程白走一遍。3. 手动安装APIC 2.2.4rvKVM挂载到初始化配置的完整流程前置条件全部就绪后进入正式安装。整个流程分四段引导挂载、网络参数、RAID引导盘、初始化配置。每一段都有独立的坑按顺序走完APIC 2.2.4r才能顺利跑起来。3.1 引导安装F6进入boot menu选择vDVD先在CIMC远程控制台挂载DVD镜像把2.2.4r的ISO映射到虚拟光驱。映射完成后APIC重启开机时按F6进入boot menu选择Cisco vKVM-Mapped vDVD1.22从虚拟光驱引导。这里要注意F6的时机进入boot menu之前别松开按键错过就要再来一次重启。选择引导项后能看到CentOS引导界面此时直接回车。接下来屏幕会变成蓝色等待界面第一次装的时候我以为系统卡死了等了十分钟差点重启。实际上这一步是在初始化硬件和扫描磁盘尤其是有多块RAID卷时耗时会更长。蓝屏等待期间不要做任何操作让它自己跑等下一步提示出现再继续。后面我会专门讲这个阶段真正的卡死点长什么样和正常等待的区别在哪。3.2 网络安装参数Static IP、网关与HTTP URL关键项蓝屏阶段结束后屏幕下方会出现类似press any key to con...的提示意思是引导程序准备进入外部镜像拉取模式支持HTTP、SCP等方式。要在30秒内按任意键否则会用默认方式继续等提示消失再按就没有用了。按任意键后会进入参数配置环节配置项按顺序填写不要跳。Static IP : 192.168.1.222/24 Gateway : 192.168.1.1 NIC : eth0 Method : http URL : http://192.168.1.105:8080/APIC/aci-apic-dk9.2.2.4r.isoStatic IP填APIC自己的管理地址必须与HTTP文件服务器同网段/24这种掩码格式不能漏网关填交换机上的网关地址要和IP同一网段否则镜像拉取跨不了三层。网卡用默认的eth0不要试图改成其他接口实验环境通常就这一个管理口。方式选http而不是scp省去认证过程不容易在中途断开。URL就是之前文件服务器上镜像的完整链接端口、目录名、文件名一个都不能错写错一个字符就是404到时候还得重来。回车后系统开始自动下载镜像并安装整个过程比较长可以观察屏幕日志。如果过程中出现TPM相关报错基本可以断定是TPM没激活到位回到BIOS确认Current Status是否为Active再重新走安装不要在这个节点反复重试浪费一晚上。3.3 RAID引导盘系统装在RAID1上CIMC默认引导盘要改安装过程顺利完成后系统提示重启这时候也藏着这周踩过的最隐蔽的一个坑。我服务器的存储配置是三块硬盘其中两块组RAID1一块组RAID0。手动安装时引导程序把系统写到了RAID1虚拟盘上但CIMC里配置的boot drive默认指向的是RAID0那块一百来G的盘结果重启后直接提示找不到引导设备。第一次看到这个报错我以为安装失败了又重装了一遍系统结果还是一样最后才意识到是引导盘设置的问题。解决办法是进CIMC的存储设置把RAID1虚拟盘设为boot drive设备保存后重启。这个操作在CIMC里是图形界面找到启动设备配置把启动顺序改成RAID1卷优先重启后就能看到系统引导了。这个坑提醒我APIC手动安装完成后一定要检查CIMC里的boot drive配置而不是盲目怀疑安装过程。安装程序选引导盘的逻辑跟CIMC默认启动项不一定一致装完先确认引导指向能省掉一次完全不必要的重装。3.4 初始化配置实验环境单节点与生产环境三节点差异引导加载完成系统进入初始化阶段屏幕提示回车确认。APIC的初始配置包括Controller ID、Fabric Name、管理IP、网关等参数。实验环境只有一台控制器很多参数可以按默认走生产环境标准部署是三台APIC组成集群Controller ID、Fabric Name必须三台统一规划管理IP也要避开业务网段。配置项实验环境生产环境建议Controller ID1分别设置为1/2/3Fabric Name自定义名称三台保持一致Management IP192.168.1.222/24规划独立管理网段Gateway192.168.1.1管理网段网关POD ID1默认配置完成后系统自动拉起服务等控制台回到可登录状态浏览器访问https://192.168.1.222能看到APIC登录页面就算安装成功。到这里2.2.4r版本已经跑起来了接下来开始升级4.2.7u。4. APIC升级到4.2.7uFirmware Repository上传与Controller Upgrade系统重装完成后Web界面里还是2.2.4r。手动安装只是第一步真正的生产使用至少要在4.2以上所以继续升级到4.2.7u。升级动作都在Web界面的Firmware管理模块里完成顺序是上传固件、确认仓库、发起控制器升级、等待重启。4.1 上传固件Upload Firmware的本地提交与HTTP方式登录APIC Web界面进入Admin菜单找到Download Tasks在空白区域右键选择Upload Firmware。这里有本地提交和HTTP路径两种选择。本地方式是把4.2.7u的ISO文件从你的电脑直接传上去走浏览器上传通道适合文件服务器没开的时候应急。HTTP方式则是填一个URL让APIC自己去拉走的是后台下载通道。4.2这代本地方式还能正常用后面到5.x就要注意了本地方式容易卡死最好统一走HTTP。上传开始后任务列表里能看到进度。ISO文件有好几个G取决于网络环境可能需要等待一段时间。上传期间不要关闭浏览器标签也不要切到其他用户操作同一个任务。完成后在Firmware Repository里就能看到4.2.7u条目版本名、上传时间都会列出来。如果上传任务长时间没有进度先看APIC到文件服务器的网络通不通再从APIC侧ping一下文件服务器IP两层都通问题基本出在文件名或目录大小写。提示Firmware Repository是升级动作的唯一版本来源Controller Upgrade只能从这里选版本上传没成功就看到仓库里没数据先回来检查上传任务。4.2 Controller Upgrade4.2.7u版本升级实操仓库里有了4.2.7u后找到Controller Firmware节点右键选择Controller Upgrade弹出升级对话框在版本列表里选4.2.7u点击Upgrade Now立即执行。升级任务会立刻进入运行状态。整个过程分几个阶段先把镜像分发到控制器本地接着做配置备份然后重启控制器加载新版本。升级期间APIC会重启一次属于正常现象不要看到Web界面断连就去手动重启设备。重启完成后APIC会重新拉起服务Web界面逐步恢复访问。这个升级动作操作的顺序不要乱先后顺序整理如下。步骤操作位置动作1Admin → Download Tasks右键Upload Firmware上传4.2.7u2Firmware Repository确认4.2.7u出现在版本列表3Controller Firmware右键Controller Upgrade4升级对话框选择4.2.7u并Upgrade Now4.3 升级状态跟踪重启期间该看什么、不该做什么升级发起后Download Tasks或升级任务面板会显示整体进度包括镜像下载、配置备份、控制器重启等阶段。每个阶段耗时不短中间控制台会频繁出现服务重启。这段时间最忌讳的是手动干预比如断电、重启、关闭浏览器任一动作都可能导致控制器状态不一致严重的话得重新上传固件再走一遍。等待期间可以观察vKVM控制台的日志输出如果停在某个位置超过较长时间先判断是正常的服务拉起还是卡死。APIC控制器服务全起来通常要十几分钟只要控制台还在持续打日志就耐心等。如果升级任务直接显示失败不要立刻重新发起Controller Upgrade先打开任务详情看失败原因常见的是磁盘空间不足或镜像下载不完整把根因处理掉再重试才有意义。升级完成后输入https://192.168.1.222登录后确认版本号更新到4.2.7u控制器状态为Active这轮升级就正式完成了。5. APIC安装升级避坑指南三个Starting卡死点与引导盘问题手动安装和升级APIC遇到的问题很多不是一次性报错而是卡在某个位置不动或者重启后找不到引导排查起来费时间。这章把踩过的坑按现象、原因、解决的顺序列清楚遇到同类问题可以直接对照。5.1 安装卡死三个Starting挂起现象安装引导过程中屏幕会停在Starting Terminate Plymouth Boot Screen、Starting Anaconda NetworkManager configuration、Starting Dump dmesg to /var/log/dmesg这几个Starting提示中的任意一个10分钟没有下文等多久都不会再动。原因网上常见的改inst.rzam0、在引导命令行里改参数这些方法我都试过没有效果。多方验证下来比较可信的方向有两个TPM没有正确激活或者硬盘容量不足。单独激活TPM后我重新测试依然会卡死怀疑需要TPM加磁盘容量同时满足才能稳定通过。我实验室的APIC是三块硬盘两块组RAID1一块组RAID0容量并不宽裕系统安装时对临时空间的要求不低。解决先把TPM在BIOS里激活为Active再把硬盘容量做大最好每块盘都是500GB起步多配几块。如果条件允许可以试试TPM激活加扩容同时操作。这个坑在安装阶段出现频率最高建议在挂ISO之前就把这两项准备好而不是等到卡死之后再去猜原因。5.2 引导盘丢失CIMC默认启动设备与RAID1不一致现象系统安装完成、重启后屏幕提示找不到引导设备无法进入系统看着就像是安装失败了一样。原因安装程序把引导写在了RAID1虚拟盘上但CIMC里配置的boot drive指向的是RAID0那块一百来G的盘。启动时CIMC按自己配置的顺序去引导从RAID0没找到系统就报找不到引导。我一开始误判成安装失败重复装了两遍才反应过来。解决进CIMC存储设置把RAID1虚拟盘设为boot drive保存后重启。这个操作不会影响RAID数据只是修改启动优先级。可以在重启前先确认一下boot drive的指向避免重启后再折腾一轮。这个坑最容易让人做无用功因为安装日志完全正常问题出在CIMC的启动配置上。5.3 5.x升级上传卡死本地方式不行HTTP方式稳现象升级到5.x版本时用本地方式上传ISO上传开始后不久进度就不再变化任务挂起没有下文刷新任务列表也看不到成功状态。原因高版本固件上传对本地浏览器上传通道的兼容性不好连接被挂住重试多次结果一样。本地方式在4.2这代还能正常用到了5.x就成了高风险操作。我一开始还以为是浏览器问题换了浏览器还是卡最后换回HTTP方式才顺利传完。解决改用HTTP文件服务器方式上传把ISO地址填给APIC让它直接从HTTP服务器拉取。这也是为什么前面强调文件服务器不要装完就拆后面升级还要靠它。如果HTTP也没反应先确认APIC到文件服务器的路由和防火墙8080端口要从APIC侧能访问。这个坑的教训是能走HTTP的固件上传就不要图省事走本地。5.4 TPM灰色不可配置先设BIOS administrator密码现象BIOS的Advanced → Trust Computing页面里TPM开关是灰色鼠标无法操作Current Status也无法修改。原因BIOS没有设置administrator密码安全配置锁定TPM相关选项不被允许修改。这是BIOS层面的保护机制并不是硬件不支持TPM很多人在这一步误判成服务器型号不支持直接跳过TPM配置结果安装阶段卡死找不到原因。解决先在BIOS里设置administrator密码简单放password也够实验用保存退出后重新进入Trust ComputingTPM开关就能操作了。设置完成后确认Current Status显示为Active再离开。这个坑很容易被忽略而TPM状态不对又会引发安装过程卡死属于连环坑配置顺序上一定要把BIOS密码放在TPM激活之前。6. 装完怎么验证从Web版本号到集群状态的确认方法APIC装完或者升级完不能只看一眼版本号就算结束。控制器重启后服务拉起有延迟我习惯按固定顺序过三遍确认系统真正进入可用状态。第一遍先看Web界面。浏览器打开https://192.168.1.222能正常出现登录页并完成登录说明控制器Web服务已经起来了。登录后看Dashboard右上角的版本号升级后应显示4.2.7u或目标5.x版本如果还是旧版本号说明升级没有实际生效需要回去看任务状态。紧接着打开System → Controllers确认控制器状态是Active不是Out-of-Service也不是Standby。第二遍用CLI确认。SSH登录APIC执行版本查看命令apic1# version # 输出中的 Software Version 与升级目标一致 apic1# show version # 查看更详细的系统固件信息部分版本支持该命令如果show version在当前版本不识别用version命令就够了。APIC的命令集每个大版本都会调整命令不存在时报错是正常的不要硬套网络设备的习惯以Web界面信息为准。第三遍看集群健康。单节点的实验环境Fabric健康分数不一定是满分但只要没有红色告警、控制器没有进入服务中断状态就算正常。生产环境的话还要登录其他两个APIC节点确认三台控制器的版本一致、集群同步正常。健康分数和控制器状态都确认完再去做业务配置也不迟。这套验证动作我坚持了很长时间后来总结成四步清单MD5校验、TPM状态确认、HTTP服务器连通性、RAID引导盘指向。每次手动装APIC前强制把清单过一遍再开始动安装流程这习惯帮我少熬了不知道多少夜的待机等待希望帮到你。本文还有配套的精品资源点击获取