Cannot launch utilities version 24.x on AIX - UnsatisfiedLinkError or invalid magic number

Products

• CA Automic Workload Automation - Automation Engine

Issue/Introduction

You get some UnsatisfiedLinkError on a new AIX 7.3 with Java 17 while trying to launch the 24.x utilties to load the Automation Engine Database.

The required AIX LibC 8 libraries have not been installed yet on the system as explained here or the LIBPATH variable has not been updated accordingly to include the folder where they are installed (by default /opt/freeware/lib64)

Example of some errors on a system where some old c runtime libraries (with extension .a) had been copied to the bin folder:

-bash-5.2$ ./ucybdbld.sh
Exception in thread "main" java.lang.UnsatisfiedLinkError: /opt/CA/jdk-11.0.24+8-jre/lib/libfontmanager.so: /opt/CA/jdk-11.0.24+8-jre/lib/libfontmanager.a, LIBPATH=/opt/CA/jdk-11.0.24+8-jre/lib/server:/opt/CA/jdk-11.0.24+8-jre/lib:/opt/CA/jdk-11.0.24+8-jre/lib/jli:/opt/CA/jdk-11.0.24+8-jre/../lib:/opt/CA/AWA/Utility/bin:/lib:/opt/CA/oracle_client/instantclient_19_24, LD_LIBRARY_PATH= :    0509-022 Cannot load module /opt/CA/jdk-11.0.24+8-jre/lib/libfontmanager.a.
        0509-026 System error: A file or directory in the path name does not exist.
        at java.base/java.lang.ClassLoader$NativeLibrary.load0(Native Method)

Or

-bash-5.2$ ./ucybdbld.sh
Exception in thread "main" java.lang.UnsatisfiedLinkError: /opt/CA/jdk-11.0.24+8-jre/lib/libfontmanager.so: /opt/CA/jdk-11.0.24+8-jre/lib/libfontmanager.a, LIBPATH=/opt/CA/jdk-11.0.24+8-jre/lib/server:/opt/CA/jdk-11.0.24+8-jre/lib:/opt/CA/jdk-11.0.24+8-jre/lib/jli:/opt/CA/jdk-11.0.24+8-jre/../lib:/opt/CA/AWA/Utility/bin:/lib:/opt/CA/oracle_client/instantclient_19_24, LD_LIBRARY_PATH= :    0509-022 Cannot load module /opt/freeware/lib/libfreetype.a(libfreetype.so.6).
        0509-150   Dependent module /opt/CA/AWA/Utility/bin/libgcc_s.a(shr.o) could not be loaded.
        0509-103   The module has an invalid magic number.

Environment

OS: AIX 7.x and superior

Automation Engine 24.0.0 and superior

Cause

New compiler being used on AIX ppc64 since version 24.0.0, explained in the check for incompatibilities between 21.0.x and 24.x 

Please note that the extension of the libraries delivered for AIX PPC64 is now .so instead of .a compared to previous 21.x and older versions:

 

Resolution

Please install the required LibC 8 gcc runtime libraries for AIX as mentioned in the documentation and set the LIBPATH accordingly:

• For AIX 64 bit, make sure you are using version 8 LibC runtime system libraries (libgcc8, libgomp8, libstdc++8); otherwise AIX does not work. For detailed information on how to install/upgrade the package, please refer to the official IBM C and C++ compilers documentation.

  You can use the dnf install libgcc8, dnf install libgomp8, and dnf install libstdc++8 commands to install them.

  Make sure you update the LIBPATH with the path of the runtime libraries (by default /opt/freeware/lib64).

Additional Information

Example of the LIBPATH definition on an AIX with Oracle as Database:

LIBPATH=.:/opt/freeware/lib64:$AUTOMIC/bin:$ORACLE_HOME/lib:/usr/lib:/lib:$LIBPATH; export LIBPATH