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
- 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 inC:\Program Files\IBM\Installation Manager\eclipse\tools
on Microsoft Windows and in/opt/IBM/InstallationManager/eclipse/tools
on Linux.)
- 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.
- Open the
imcl.ini
file
- 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 theeclipse/plugins
directory of your IM installation or if the name of that subdirectory does not start withorg.eclipse.equinox.launcher
. The line must refer to the subdirectory of your IMeclipse/plugins
directory which has a name starting withorg.eclipse.equinox.launcher
. If you do not find such a directory, you will have to completely reinstall IM (See Related information below).
Related Information
Was this topic helpful?
Document Information
Modified date:
25 October 2021
UID
swg21635004