IBM Support What's New?

The "imcl" command fails with "...unable to locate companion shared library" error

Technote (troubleshooting)


When you attempt to use the "imcl" tool of IBM Installation Manager (IM), the command is not run and the "The imcl executable launcher was unable to locate its companion shared library" error is returned.


The imcl tool uses a launcher library that is defined in the imcl.ini file.

If the path specified for this library does not match a valid directory (either because it has been manually and incorrectly modified, or because your IM installation is corrupt), or if you do not have the rights to access this directory, the imcl command will fail with the error The imcl executable launcher was unable to locate its companion shared library

Resolving the problem


  1. Make a backup copy of your imcl.ini file and call it, for example, imcl.ini.old (This file can be found in the tools directory of IM, a directory that is, by default, located in C:\Program Files\IBM\Installation Manager\eclipse\tools on Microsoft Windows and in /opt/IBM/InstallationManager/eclipse/tools on Linux.)

  2. Verify that you have the rights to access the directories mentioned in Step 4. If you do not have the rights, you need to either ask your Administrator to give you those rights or run the imcl commands with another account that does have such rights.

  3. Open the imcl.ini file

  4. Change the content of the line, if the line that comes immediately after the --launcher.library does not effectively point to an existing subdirectory of the eclipse/plugins directory of your IM installation or if the name of that subdirectory does not start with org.eclipse.equinox.launcher. The line must refer to the subdirectory of your IM eclipse/plugins directory which has a name starting with org.eclipse.equinox.launcher. If you do not find such a directory, you will have to completely reinstall IM (See Related information below).

Related information

Reinstalling IBM Installation Manager

Document information

More support for: IBM Installation Manager

Software version: 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

Operating system(s): Linux, Windows

Reference #: 1635004

Modified date: 2013-05-03