AIX libraries required by Configuration Manager in Content Platform Engine (CPE) and in Content Management Interoperability Service (CMIS)

Configuration Manager requires GTK2+ libraries. These libraries are not installed by default. You must install a minimum version of gtk2-2.20 and its dependency libraries on your system before you run Configuration Manager.
 

Resolving the problem

To use Configuration Manager's graphical user interface, the GTK2+ RPM and dependencies, as well as the gtk2+ version GTK2-2.20 or greater and its dependencies, must be available on the AIX server.

In addition,

• In Content Platform Engine 5.5.6 and earlier, the LIBPATH must include the following:

  LIBPATH=/opt/freeware/lib:/usr/lib:$LIBPATH export LIBPATH

• In Content Platform Engine 5.5.7 and later, the LIBPATH must include the following:

  LIBPATH=/opt/freeware/lib:/usr/lib:/opt/IBM/FileNet/ContentEngine/_cejvm/lib/icc:$LIBPATH
  export LIBPATH

There are two ways to install the RPM packages. Choose one of the following methods to install the required libraries and dependencies.

Method 1: Download the gtk2+ and the dependency RPMs from the following AIX toolbox link and then run each RPM.

https://www.ibm.com/developerworks/aix/library/aix-toolbox/alpha.html
Required Dependencies packages for gtk2+ are as follows:

libffi-3.2.1-1.aix6.1.ppc.rpm
glib2-2.52.2-1.aix6.1.ppc.rpm
gettext-0.19.8.1-1.aix6.1.ppc.rpm
ncurses-6.1-1.aix6.1.ppc.rpm
libXrender-0.9.8-1waixX11.aix6.1.ppc.rpm
fontconfig-2.11.95-3.aix6.1.ppc.rpm
libXft-2.3.2-3waixX11.aix6.1.ppc.rpm
atk-2.20.0-3.aix6.1.ppc.rpm
libpng-1.6.27-2.aix6.1.ppc.rpm
freetype2-2.8-1.aix6.1.ppc.rpm
lzo-2.10-1.aix6.1.ppc.rpm
pixman-0.34.0-1.aix6.1.ppc.rpm
cairo-1.14.6-2waixX11.aix6.1.ppc.rpm
harfbuzz-1.2.7-2.aix6.1.ppc.rpm
pango-1.40.1-2waixX11.aix6.1.ppc.rpm
intltool-0.51.0-2.aix6.1.noarch.rpm
gdk-pixbuf-2.35.1-2waixX11.aix6.1.ppc.rpm
rpm -ivh shared-mime-info-1.6-2.aix6.1.ppc.rpm
libxcb-1.12-2waixX11.aix6.1.ppc.rpm
xcb-proto-1.12-1.aix6.1.ppc.rpm

After installing the dependency packages, install gtk2-2.24.30-2waixX11.aix6.1.ppc.rpm

Method 2: Install the “yum” package manager tool on your AIX server and then run “yum install gtk2”. This process installs gtk2+ and its dependency packages.

Verify the environment variable LIBPATH contains a path to the installed libraries. For example: LIBPATH=/opt/freeware/lib:/usr/lib

Known Issue with glib2-2.56.1-3

If the requisite libraries were installed using the "yum" package, Configuration Manager might still fail with the following error stack in the CMUI log due to a known issue with glib2-2.56.1-3.  Verify which version of the glib2 is installed to ensure it is version glib2-2.56.1-2 or lower. 

There is a known issue with glib2-2.56.1-3.

!ENTRY org.eclipse.osgi 4 0 2021-05-13 06:46:06.737
!MESSAGE Application error
!STACK 1
java.lang.UnsatisfiedLinkError: Could not load SWT library. Reasons:
        /opt/IBM/FileNet/ContentEngine/tools/configure/configuration/org.eclipse.osgi/269/0/.cp/libswt-pi-gtk-4629.a (  0509-130 Symbol resolution failed for /opt/freeware/li
b/libgdk_pixbuf-2.0.a[libgdk_pixbuf-2.0.so.0] because:
        0509-136   Symbol strcmp (number 203) is not exported from
                   dependent module /opt/freeware/lib/libgmodule-2.0.a[libgmodule-2.0.so.0].
        0509-022 Cannot load module /opt/IBM/FileNet/ContentEngine/tools/configure/configuration/org.eclipse.osgi/269/0/.cp/libswt-pi-gtk-4629.a.
        0509-026 System error: Cannot run a file that does not have a valid format.
        0509-192 Examine .loader section symbols with)
        swt-pi-gtk (Not found in java.library.path)
        /.swt/lib/aix/ppc64/libswt-pi-gtk-4629.a (      0509-130 Symbol resolution failed for /opt/freeware/lib/libgdk_pixbuf-2.0.a[libgdk_pixbuf-2.0.so.0] because:
        0509-136   Symbol strcmp (number 203) is not exported from
                   dependent module /opt/freeware/lib/libgmodule-2.0.a[libgmodule-2.0.so.0].
        0509-022 Cannot load module /.swt/lib/aix/ppc64/libswt-pi-gtk-4629.a.
        0509-026 System error: Cannot run a file that does not have a valid format.
        0509-192 Examine .loader section symbols with the
                 'dump -Tv' command.)
        /.swt/lib/aix/ppc64/libswt-pi-gtk.a (   0509-022 Cannot load module /.swt/lib/aix/ppc64/liblibswt-pi-gtk.a.so.
        0509-026 System error: A file or directory in the path name does not exist.)

        at org.eclipse.swt.internal.Library.loadLibrary(Library.java:327)
        at org.eclipse.swt.internal.Library.loadLibrary(Library.java:236)
        at org.eclipse.swt.internal.gtk.OS.<clinit>(OS.java:28)
        at org.eclipse.swt.internal.Converter.wcsToMbcs(Converter.java:63)
        at org.eclipse.swt.internal.Converter.wcsToMbcs(Converter.java:54)
        at org.eclipse.swt.widgets.Display.<clinit>(Display.java:139)
        at org.eclipse.ui.internal.Workbench.createDisplay(Workbench.java:779)
        at org.eclipse.ui.PlatformUI.createDisplay(PlatformUI.java:160)
        at com.ibm.ecm.configmgr.app.ce.rcp.Application.start(Application.java:84)
        at org.eclipse.equinox.internal.app.EclipseAppHandle.run(EclipseAppHandle.java:196)
        at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.runApplication(EclipseAppLauncher.java:134)
        at org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.start(EclipseAppLauncher.java:104)
        at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:388)
        at org.eclipse.core.runtime.adaptor.EclipseStarter.run(EclipseStarter.java:243)
        at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
        at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:90)
        at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:55)
        at java.lang.reflect.Method.invoke(Method.java:508)
        at org.eclipse.equinox.launcher.Main.invokeFramework(Main.java:673)
        at org.eclipse.equinox.launcher.Main.basicRun(Main.java:610)
        at org.eclipse.equinox.launcher.Main.run(Main.java:1519)

Resolving the Issue

To resolve the issue, consult your AIX administrator.

For a tutorial on installing and configuring GKT2 on AIX servers, refer to the following tutorial: https://developer.ibm.com/tutorials/installing-and-configuring-gtk-on-aix/