Problem

When trying to upgrade an appliance running Oracle Linux to API Gateway package 7.4.0 the following error is seen

# yum upgrade AxwayAPIGateway-appliance
Loaded plugins: security
Skipping security plugin, no data
Setting up Upgrade Process
Resolving Dependencies
Skipping security plugin, no data
--> Running transaction check
---> Package AxwayAPIGateway-appliance.x86_64 0:7.4.0-1 set to be updated
--> Finished Dependency Resolution
Dependencies Resolved
================================================================================
 Package Arch Version Repository Size
================================================================================
Updating:
 AxwayAPIGateway-appliance x86_64 7.4.0-1 kingsofsoa 418 M
Transaction Summary
================================================================================
Install 0 Package(s)
Upgrade 1 Package(s)
Total download size: 418 M
Is this ok [y/N]: y
Downloading Packages:
AxwayAPIGateway-appliance-7.4.0-1.x86_64.rpm | 418 MB 04:06
Running rpm_check_debug
Running Transaction Test
Finished Transaction Test
Transaction Test Succeeded
Running Transaction
 Updating : AxwayAPIGateway-appliance 1/2
Error unpacking rpm package AxwayAPIGateway-appliance-7.4.0-1.x86_64
error: unpacking of archive failed on file /opt/Axway/apigateway/docs/user_guide: cpio: rename
Failed:
 AxwayAPIGateway-appliance.x86_64 0:7.4.0-1
Complete!

Resolution

The old API Gateway package should be removed before an attempt is made to install the new package version. Make sure that the old version is backed for any configuration upgrade that may be required.

yum erase AxwayAPIGateway-appliance

then proceed with the installation

yum install AxwayAPIGateway-appliance