IBM Support

Installation Manager graphical environment issues on Solaris, Linux, AIX



The Installation Manager is based on the Eclipse Rich Client Platform architecture which requires specific graphical libraries and versions to work properly.


There are a number of symptoms.

  • The Installation Manager does not start and a splash screen does not display. This symptom happens if a graphical library is not available on your Operating System.

  • The Installation Manager displays with broken icons and other parts of the user interface. The log contains multiple messages like following:

    ** (IBM Installation Manager:12807): WARNING **:
    pango-layout.c:2435: broken PangoLayout
    ** (IBM Installation Manager:12807): WARNING **:
    pango-layout.c:2435: broken PangoLayout


  • In the Modify wizard, on the Features panel, check the Show Dependencies box. If the Dependencies area is empty and displays in a new window, clicking X to close the window causes a JVM failure. The following dialog displays:

  • The application starts up and then freezes. You might need to kill the application.


The graphical environment is either not installed or not at the correct version.

Background information can be found in the Eclipse release notes:

Resolving The Problem

    The use of the graphical user interface and the associated libraries can be avoided by using the Installation Manager in silent mode with the -input <responseFile> parameter, or using the Installation Manager in console mode.

    Information about installing in silent mode and console mode is provided in the IBM Installation Manager Information Center.

    To use the Installation Manager graphical user interface for Linux and Solaris, verify that the GTK version 2.12.0 or later is installed. For AIX, verify the latest version of motif is installed.

    Verify the Installation Manager is referencing this version of the graphical environment. The environment variables $PATH and $LD_LIBRARY_PATH might have to be updated to reference the correct version of the libraries. Verify that the $DISPLAY environment variable is set to your X server.

    For example, if GTK is installed at /opt/csw, add /opt/csw/bin to $PATH and opt/csw/lib to $LD_LIBRARY_PATH.

    Example for a Bash shell:
    export PATH=/opt/csw/bin:$PATH
    export LD_LIBRARY_PATH=/opt/csw/lib:$LD_LIBRARY_PATH
    export DISPLAY=localhost::0

    How to update your Solaris version of GTK

    Note: GTK libraries have dependencies on other packages. You might need to install or update these packages as well.

    Where to get the GTK library

    Ask the system administrator for the latest version of the GTK libraries.

    How to install a GTK library

    Unzipped package file name
    Package Name

    1. Install a package.

      Execute one of the following commands:

      #pkgadd -d <package file name>


      #pkgadd -d <package file name> <package name>

      This command makes the installation process less interactive.

      Repeat the command for each package file name.

    2. Determine the package name:

      #head -2 <package file name>

      The output looks like:

      PaCkAgE DaTaStReAm
      SMCglib2 1 96594

      The first field of the second line is the package name.

    3. List installed packages:

      #pkginfo | grep SMC

    4. After all of the required packages are installed, you might need to set the LD_LIBRARY_PATH to point to the new library location.

      For example, this command line starts the Installation Manager installer for a bash shell:
      #LD_LIBRARY_PATH=/usr/local/lib ./install

      Or create a simple script. This example starts the Installation Manger:

      export LD_LIBRARY_PATH
      exec /opt/IBM/InstallationManger/eclipse/IBMIM

      After you install GTK and the dependency packages, if you receive an error message like:

      GLib: Cannot convert message: Conversion from character
      set 'UTF-8' to '646' is not supported
      No fonts found; this probably means that the fontconfig
      library is not correctly configured. You may need to
      edit the fonts.conf configuration file. More information
      about fontconfig can be found in the fontconfig(3) manual
      page and on

      Update /usr/local/etc/fonts/fonts.conf with the correct font directories and execute the commands:


    How to update your Linux version of GTK

    The package get utilities for your Linux distribution can be used to install the latest versions of the GTK libraries and the GTK library dependencies.

[{"Product":{"code":"SSDV2W","label":"IBM Installation Manager"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Install","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"}],"Version":"1.0;;;;;;1.1;;;1.1.1;1.1.2;1.2;1.2.1;1.3;1.3.1;1.3.2;1.3.3;1.3.4;;1.4;1.4.1;1.4.2;1.4.3;1.4.4;1.5;;1.5.1;1.5.2;1.5.3;1.6;1.6.1;1.6.2;1.6.3;;1.7;1.7.1;1.7.2;1.7.3;1.7.4;;;;1.8;1.8.1;1.8.2;;1.8.3","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
25 October 2021