简介：面向思科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 文件服务器必须走HTTP：HFS轻量级搭建APIC共享目录

安装APIC时，ISO镜像不放在本机，而是通过引导程序从外部服务器拉取。文件服务器是NFS、CIFS还是HTTP，看起来差别不大，实际影响很大。我一开始用NFS方式挂载，安装程序读到一半就没反应，反复试了两三次都卡在同一个位置，换成HTTP后一次就通了。HTTP是无状态协议，连接建立简单，镜像传输过程中不容易被额外的服务依赖拖住，APIC安装引导对HTTP的兼容也最稳。

文件服务器不用搭得很重，HFS这个轻量级程序就够用。它在Windows下运行，双击启动后在界面里新增一个名为APIC的虚拟目录，把镜像文件放进去，HTTP访问能打开就算通了。HFS默认监听8080端口，访问地址类似http://192.168.1.105:8080/APIC/。配置参数整理如下。

注意一点：共享目录名和镜像文件名的大小写，在URL里必须与实际情况完全一致。APIC的CentOS引导对路径匹配是严格校验的，大小写不对会直接报403或者拉不到文件。搭建完成后，先在浏览器里把http://192.168.1.105:8080/APIC/打开，能看到镜像文件列表再往下走，不要等到安装引导时才验证，那会儿定位问题就麻烦了。

2.2 CIMC与BIOS版本：4.1不影响，上5.x建议升Huu

APIC底层是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升级，整个过程大约半小时能全部完成。

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 Computing，TPM开关就在里面，必须确保Current Status显示为Active。如果进去发现配置项是灰色的，说明BIOS没有设置administrator密码，安全配置处于锁定状态。先到BIOS里把administrator密码设置好，密码我一般放password，方便后面反复进出，再回到Trust Computing配置TPM，确认状态变成Active。

BIOS密码这个细节，第一次折腾时我卡了很久，一度以为硬件不支持TPM，其实只是密码没设。设完密码后，TPM的开关从灰色变成可配置，激活后保存退出。这里建议把TPM状态记录下来，后面安装如果报TPM相关错误，可以少走弯路。TPM不active的影响不一定在开机时暴露，有时是系统下载完镜像开始校验时才报，那时再回头改BIOS，等于整个安装流程白走一遍。

3. 手动安装APIC 2.2.4r：vKVM挂载到初始化配置的完整流程

前置条件全部就绪后，进入正式安装。整个流程分四段：引导挂载、网络参数、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.iso

Static 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也要避开业务网段。

配置完成后系统自动拉起服务，等控制台回到可登录状态，浏览器访问https://192.168.1.222，能看到APIC登录页面就算安装成功。到这里2.2.4r版本已经跑起来了，接下来开始升级4.2.7u。

4. APIC升级到4.2.7u：Firmware 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 Upgrade：4.2.7u版本升级实操

仓库里有了4.2.7u后，找到Controller Firmware节点，右键选择Controller Upgrade，弹出升级对话框，在版本列表里选4.2.7u，点击Upgrade Now立即执行。升级任务会立刻进入运行状态。

整个过程分几个阶段：先把镜像分发到控制器本地，接着做配置备份，然后重启控制器加载新版本。升级期间APIC会重启一次，属于正常现象，不要看到Web界面断连就去手动重启设备。重启完成后，APIC会重新拉起服务，Web界面逐步恢复访问。这个升级动作操作的顺序不要乱，先后顺序整理如下。

4.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.rzam=0、在引导命令行里改参数，这些方法我都试过，没有效果。多方验证下来，比较可信的方向有两个：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 Computing，TPM开关就能操作了。设置完成后确认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前强制把清单过一遍，再开始动安装流程，这习惯帮我少熬了不知道多少夜的待机等待，希望帮到你。

本文还有配套的精品资源，点击获取