EEM upgrade fails FATAL CheckUpgradeAction - Exception during upgrade check java.lang.Exception: The installer cannot perform upgrade iGateway from Linux 2.4 to Linux 2.6 mode

Document ID : KB000033549
Last Modified Date : 14/02/2018
Show Technical Document Details

Problem:

While trying to upgrade EEM 8.4.411 to EEM 12.51, you will get the following error:

FATAL CheckUpgradeAction - Exception during upgrade check

java.lang.Exception: The installer cannot perform upgrade iGateway from Linux 2.4 to Linux 2.6 mode

 

Environment:

All supported Unix/Linux OS platforms

 

Resolution:

There are some third party sponsors that use iGateway (other than EEM). Because of this, when you attempt to upgrade EEM, the installer can throw an exception and exit. The third party sponsor for Workload Automation AE is the Command Sponsor.  

To resolve this error, you can:

(1)    Migrate your EEM policies to an instance that has a compatible iGateway

(2)    Uninstall and upgrade the third party sponsor then upgrade EEM

According to the Implementation Guide, if the iGateway built on Linux 2.6 kernel version is already installed, you can install or upgrade the Command Sponsor. This also means you can upgrade EEM from r8.4 to r12.51. If the iGateway built on Linux 2.4 kernel version is already installed, you cannot install or upgrade the Command Sponsor. You also cannot upgrade EEM to r12.51.

To verify if iGateway built on Linux 2.6 kernel version is installed, check for the existence of the $IGW_LOC/igw.linux_k26 file. If you do not see this file, then your iGateway was on the Linux 2.4 kernel version. You will have to uninstall the Command Sponsor, iGateway and all other iGateway plug-ins.

For complete instructions on how to uninstall and resinstall the Command Sponsor and iGateway (so that iGateway is built on the Linux 2.6 kernel version), review the Upgrade Considerations documentation.

 

Additional Information:

EEM/iGateway comes with few default sponsors which are required for. These sponsors can be seen within the list of .conf files in the iTechnology directory ($IGW_LOC). The following command shows the list of default conf files for the EEM r8.4 installation:

 

>:/opt/CA/SharedComponents/iTechnology # ls *.conf

Eiam.conf

iAuthority.conf

iPoz.conf

logDepot.conf

Spin.conf

iControl.conf

igateway.conf

 

The Command Sponsor requires a .conf file called the AutoSysCommandISponsor.conf. When the Command Sponsor is installed, this file will appear in the $IGW_LOC directory.