IBM Support

Installation Manager fails to start without warning



You run #./install or #./IBMIM to start IBM Installation Manager. The # prompt returns. Installation Manager is not started. There are no error messages.


This issue occurs when there are required system libraries that cannot be located. Installation Manager cannot start without these libraries. In some cases, the graphical environment (GTK) is not installed on the system, or the missing library is in an inaccessible location.

Resolving The Problem

To work around this issue:

1. Open the .log file:

  • Log file used when installing Installation Manager:
  • Log file used by Installation Manager:
2. View the contents of the file.
3. Search for the library on the file system.
4. Use ldd to determine why the library is not loaded.

Example of locating a missing library

1. Find the .log file in /var/ibm/InstallationManager/pluginState/.metadata/.log

2. View the contents of the file using the command:
#more  /var/ibm/InstallationManager/pluginState/.metadata/.log

Example content from the log file:

java.lang.UnsatisfiedLinkError: no swt-pi-gtk-3346 or swt-pi-gtk in swt.library.path, java.library.path or the jar file
at org.eclipse.swt.internal.Library.loadLibrary(
at org.eclipse.swt.internal.Library.loadLibrary(
at org.eclipse.swt.internal.gtk.OS.<clinit>(
at org.eclipse.swt.internal.Converter.wcsToMbcs(
at org.eclipse.swt.internal.Converter.wcsToMbcs(
at org.eclipse.swt.widgets.Display<clinit>(
at org.eclipse.ui.internal.Workbeanch.createDisplay(

This log entry indicates that the swt-pi-gtk-3346 library cannot be found or loaded.

3. Search for the library on the file system using the command:

#find / -name *swt-pi-gtk-3346*

The swt-pi-gtk-3346 library is distributed with Installation Manager and is listed in an Installation Manager installation directory:

bash-2.03# pwd
bash-2.03# find . -name *swt-pi-gtk-3346*

4. Use ldd to determine why the library is not loaded:

bash-2.03# pwd <Enter>
bash-2.03# ldd ./configuration/org.eclipse.osgi/bundles/285/1/.cp/ <Enter> =>   (file not found) =>   (file not found) =>  /usr/openwin/lib/ =>  /usr/openwin/lib/ =>   /usr/openwin/lib/ =>     /usr/lib/ =>        /usr/lib/ =>   /usr/lib/ =>    /usr/lib/ =>    /usr/lib/

In the example, there are two libraries missing: and
  • You must have the correct version of GTK/Motif installed on your system to run Installation Manager in UI mode. Contact your system administrator for help.
  • Try to find the missing .so files on the file system by using the following command:
    #find / -name <library file name> 2>&-
    If you find the files, you can use:  #export LD_LIBRARY_PATH=<the directory with the libraries>

If setting the LD_LIBRARY_PATH environment variable solves the problem, contact your system administrator for a permanent solution.

If you do not have the GTK libraries available, you can install and use Installation Manager silently.

To install Installation Manager in silently, run the command:
Administrator: #./install --launcher.ini silent-install.ini
Nonadministrator: $./userinst --launcher.ini silent-user-install.ini

[{"Product":{"code":"SSDV2W","label":"IBM Installation Manager"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"General information","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"}],"Version":"1.4","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
25 October 2021