Installation Manager graphical environment issues on Solaris, Linux, AIX

Technote (troubleshooting)


The Installation Manager is based on the Eclipse Rich Client Platform architecture. This architecture 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:

  • Eclipse Project Release Notes release
  • Eclipse Project Release Notes release 3.6.2
  • 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

      Download and install the latest version of GTK and the libraries that GTK depends on from

      The above web-site is recommended by Oracle Solaris, see the statement about the Oracle Solaris companion CD:

      How to install a GTK library

      Unzipped package file name
      Package Name
      atk-1.18.0-sol8-sparc-local SMCatk
      cairo-1.4.10-sol8-sparc-local SMCcairo
      expat-2.0.1-sol8-sparc-local SMCexpat
      fontconfig-2.8.0-sol8-sparc-local SMCfontc
      freetype-2.4.2-sol8-sparc-local SMCftype
      glib-2.25.13-sol8-sparc-local SMCglib2
      gtk+-2.12.0-sol8-sparc-local SMCgtk
      jpeg-8a-sol8-sparc-local SMCjpeg
      libgcc-3.4.6-sol8-sparc-local SMClgcc
      libiconv-1.9.2-sol8-sparc-local SMCliconv
      libintl-3.4.0-sol8-sparc-local SMClintl
      libpng-1.2.44-sol8-sparc-local SMClibpng
      pango-1.18.2-sol8-sparc-local SMCpango
      render-0.8-sol8-sparc-local SMCrender
      renderproto-0.9.3-sol8-sparc-local SMCrenpro
      tiff-3.9.4-sol8-sparc-local SMCtiff
      xrender-0.8.3-sol8-sparc-local SMCxrend
      zlib-1.1.3-sol8-sparc-local SMCzlib

      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.

    Rate this page:

    (0 users)Average rating

    Add comments

    Document information

    More support for:

    IBM Installation Manager

    Software 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

    Operating system(s):

    AIX, Linux, Solaris

    Reference #:


    Modified date:


    Translate my page

    Machine Translation

    Content navigation