IBM Support

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

Troubleshooting


Problem

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.

Cause

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

SOLUTION

  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).

[{"Product":{"code":"SSDV2W","label":"IBM Installation Manager"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Install","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"1.4.3;1.4.4;1.5;1.5.1;1.5.2;1.5.0.1;1.5.3;1.6;1.6.1;1.6.2","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
25 October 2021

UID

swg21635004