对ACS 5.x升级或打补丁时收到的“Manifest file not found in the bundle”错误进行故障排除

简介

本文档介绍在升级Cisco Secure Access Control System (ACS) 5.x版时收到“Manifest file not found in the bundle”错误时的各种解决方案。所有已知解决方案都在本文档中介绍。

先决条件

要求

Cisco建议您具备Cisco Secure ACS的基础知识。

使用的组件

本文档不限于ACS 5.x的特定软件或硬件版本。

本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的网络处于活动状态，请确保您了解所有命令的潜在影响。

问题

ACS升级或补丁安装失败，如下所示：

    ACS-VM/admin# application upgrade ACS_5.5.0.46.0.tar.gz software_repository
    Do you want to save the current configuration ? (yes/no) [yes] ? yes
    Generating configuration...
    Saved the running configuration to startup successfully
    

% Manifest file not found in the bundle

    ACS-VM/admin# 

解决方案1 -使用正确的命令

使用CLI在ACS中安装累积补丁程序的正确命令是：

acs patch install patch-name repository repository-name

如果使用了patch install patch-name repository-name命令，则会出现错误。因此，请确保使用正确的命令安装修补程序。

解决方案2 -升级捆绑包损坏

升级捆绑包或补丁文件损坏将导致错误。

确保文件下载正确，并在下载后检查文件的MD5校验和。为此，请使用本地计算机上的任何MD5应用程序，并将输出与Cisco下载页面上显示的MD5校验和进行比较。

可以在Microsoft Windows计算机上使用MD5检查器或WinMd5等应用程序来获取MD5校验和。Mac OSX具有内置的MD5校验和实用程序。要检查文件的MD5，请完成以下步骤：

1. 在Mac上启动终端应用。
2. 输入md5 file-path以计算文件的MD5校验和。

将指针悬停在升级捆绑包上以显示MD5校验和，如下图所示：

如果MD5校验和不匹配，请再次从cisco.com下载文件。确保使用FTP存储库执行升级。TFTP基于UDP，传输此类庞大文件不可靠。通过FTP将文件放到FTP服务器上时，请确保以二进制模式传输该文件，因为ASCII模式会破坏该文件。

解决方案3 - ACS上的空间不足

如果ACS硬盘驱动器(HDD)上的空间不足，也会出现此错误。应用程序升级会利用存储的数据分区。当升级开始时，升级捆绑包将传输到ACS，ACS将该文件存储在存储数据下。如果存储的数据没有足够的空间来保存文件或提取文件，则会显示错误。

要确定/storeddata分区是否具有足够的空间，请登录到ACS的CLI，然后输入以下命令：

1. show tech-support <enter>
2. /df -h <enter>（在—More—提示符处）

输出如下所示：

ACS-VM/admin# sh tech

###################################################
Application Deployment Engine(ADE) - 2.1.1.136
Technical Support Debug Info follows...
###################################################
*****************************************
Displaying startup-config...
*****************************************
!
hostname ACS-VM
!
ip domain-name CISCOLAB.LOCAL
!
ipv6 enable
!

/df -h

...skipping
df -h output...
Filesystem            Size  Used Avail Use% Mounted on
/dev/mapper/smosvg-rootvol
                      7.7G  232M  7.1G   4% /
/dev/mapper/smosvg-altrootvol
                     1008M   34M  924M   4% /altroot
/dev/sda1              99M   21M   74M  22% /boot
none                  2.0G     0  2.0G   0% /dev/shm
/dev/mapper/smosvg-home
                     1008M   34M  924M   4% /home
/dev/mapper/smosvg-localdiskvol
                       63G  234M   60G   1% /localdisk
/dev/mapper/smosvg-optvol
                      347G   49G  281G  15% /opt
/dev/mapper/smosvg-recvol
                     1008M   34M  924M   4% /recovery
/dev/sda3             981M   18M  914M   2% /storedconfig
/dev/mapper/smosvg-storeddatavol
                      

4.9G  3.0G  1.7G  65% /storeddata

/dev/mapper/smosvg-tmpvol
                      7.7G   52M  7.3G   1% /tmp
/dev/mapper/smosvg-usrvol
                      7.7G  646M  6.7G   9% /usr
/dev/mapper/smosvg-varvol
                      9.7G   97M  9.1G   2% /var

storeddata中的可用空间至少应为升级捆绑包大小的两倍。否则，升级很有可能失败。 

要清除存储数据分区中的空间，请向思科技术支持中心(TAC)提交支持请求。

注意：仅具有至少500 GB硬盘空间的虚拟机支持升级，如《ACS 5.5安装和升级指南》中所述。

存储的数据分区被分配固定百分比的硬盘空间。在较小的硬盘中，分配的空间小于平均升级捆绑包大小的两倍，因此此类设备不能以这种方式升级。您需要将服务器重新映像至新版本，并从旧版本恢复配置备份。每个ACS版本的升级指南中提到了以这种方式升级的受支持升级路径。