Troubleshooting
Problem
If you try to update, modify, or install additional products into an IBM Installation Manager software package that includes IBM Developer for z/OS, you might receive error messages that result in a failed installation.
These errors occur only during operations that update or modify a package. If you install multiple products into a new package simultaneously, these errors do not occur.
Examples: Using the installation of the IBM Developer for z/OS client and IBM Engineering Workflow Management - Client Extension for Eclipse 4.x into the same package group as an example, the following scenario is allowed: Install Developer for z/OS and IBM Engineering Workflow Management - Client Extension for Eclipse 4.x simultaneously. The following scenario is not allowed: (1) Install Developer for z/OS into a new package. (2) Start a second installation request to install IBM Engineering Workflow Management - Client Extension for Eclipse 4.x into the same package.
This issue might apply to other installation scenarios in which you want to install another software package into the same package group as IBM Developer for z/OS.
Symptom
The update operation fails with error messages similar to the following:
Error while loading manipulator.
org.eclipse.equinox.internal.p2.touchpoint.eclipse.LazyManipulator.loadDelegate(LazyManipulator.java:55)
org.eclipse.equinox.internal.p2.touchpoint.eclipse.LazyManipulator.getConfigData(LazyManipulator.java:108)
org.eclipse.equinox.internal.p2.touchpoint.eclipse.actions.UninstallBundleAction.uninstallBundle(UninstallBundleAction.java:74)
org.eclipse.equinox.internal.p2.touchpoint.eclipse.actions.UninstallBundleAction.execute(UninstallBundleAction.java:32)
org.eclipse.equinox.internal.p2.engine.ParameterizedProvisioningAction.execute(ParameterizedProvisioningAction.java:38)
org.eclipse.equinox.internal.p2.engine.Phase.mainPerform(Phase.java:183)
org.eclipse.equinox.internal.p2.engine.Phase.perform(Phase.java:95)
org.eclipse.equinox.internal.p2.engine.PhaseSet.perform(PhaseSet.java:47)
org.eclipse.equinox.internal.p2.engine.Engine.perform(Engine.java:75)
org.eclipse.equinox.internal.p2.engine.Engine.perform(Engine.java:44)
org.eclipse.equinox.internal.provisional.p2.director.PlanExecutionHelper.executePlan(PlanExecutionHelper.java:42)
org.eclipse.equinox.internal.provisional.p2.director.PlanExecutionHelper.executePlan(PlanExecutionHelper.java:24)
com.ibm.cic.agent.internal.core.p2.P2EngineOperation.perform(P2EngineOperation.java:183)
com.ibm.cic.agent.internal.core.p2.P2Engine.install(P2Engine.java:69)
com.ibm.cic.agent.internal.core.InstallOrderManager$EngineInstallOperation.perform(InstallOrderManager.java:564)
com.ibm.cic.agent.core.InstallTransaction.performOperation(InstallTransaction.java:76)
com.ibm.cic.agent.core.InstallTransaction.performOperations(InstallTransaction.java:118)
com.ibm.cic.agent.internal.core.Director.performEngineOperations(Director.java:1700)
com.ibm.cic.agent.internal.core.Director.doInstall(Director.java:1042)
com.ibm.cic.agent.internal.core.Director.doInstall(Director.java:959)
com.ibm.cic.agent.internal.core.Director.install(Director.java:633)
com.ibm.cic.agent.core.Agent.install(Agent.java:1768)
com.ibm.cic.agent.internal.ui.wizards.InstallWizard.performTask(InstallWizard.java:346)
com.ibm.cic.agent.internal.ui.wizards.AgentUIWizard$2.run(AgentUIWizard.java:539)
com.ibm.cic.common.ui.internal.parts.ProgressPart$ProgressJob.run(ProgressPart.java:109)
org.eclipse.core.internal.jobs.Worker.run(Worker.java:55)
org.eclipse.equinox.internal.p2.touchpoint.eclipse.LazyManipulator.loadDelegate(LazyManipulator.java:55)
org.eclipse.equinox.internal.p2.touchpoint.eclipse.LazyManipulator.getConfigData(LazyManipulator.java:108)
org.eclipse.equinox.internal.p2.touchpoint.eclipse.actions.UninstallBundleAction.uninstallBundle(UninstallBundleAction.java:74)
org.eclipse.equinox.internal.p2.touchpoint.eclipse.actions.UninstallBundleAction.execute(UninstallBundleAction.java:32)
org.eclipse.equinox.internal.p2.engine.ParameterizedProvisioningAction.execute(ParameterizedProvisioningAction.java:38)
org.eclipse.equinox.internal.p2.engine.Phase.mainPerform(Phase.java:183)
org.eclipse.equinox.internal.p2.engine.Phase.perform(Phase.java:95)
org.eclipse.equinox.internal.p2.engine.PhaseSet.perform(PhaseSet.java:47)
org.eclipse.equinox.internal.p2.engine.Engine.perform(Engine.java:75)
org.eclipse.equinox.internal.p2.engine.Engine.perform(Engine.java:44)
org.eclipse.equinox.internal.provisional.p2.director.PlanExecutionHelper.executePlan(PlanExecutionHelper.java:42)
org.eclipse.equinox.internal.provisional.p2.director.PlanExecutionHelper.executePlan(PlanExecutionHelper.java:24)
com.ibm.cic.agent.internal.core.p2.P2EngineOperation.perform(P2EngineOperation.java:183)
com.ibm.cic.agent.internal.core.p2.P2Engine.install(P2Engine.java:69)
com.ibm.cic.agent.internal.core.InstallOrderManager$EngineInstallOperation.perform(InstallOrderManager.java:564)
com.ibm.cic.agent.core.InstallTransaction.performOperation(InstallTransaction.java:76)
com.ibm.cic.agent.core.InstallTransaction.performOperations(InstallTransaction.java:118)
com.ibm.cic.agent.internal.core.Director.performEngineOperations(Director.java:1700)
com.ibm.cic.agent.internal.core.Director.doInstall(Director.java:1042)
com.ibm.cic.agent.internal.core.Director.doInstall(Director.java:959)
com.ibm.cic.agent.internal.core.Director.install(Director.java:633)
com.ibm.cic.agent.core.Agent.install(Agent.java:1768)
com.ibm.cic.agent.internal.ui.wizards.InstallWizard.performTask(InstallWizard.java:346)
com.ibm.cic.agent.internal.ui.wizards.AgentUIWizard$2.run(AgentUIWizard.java:539)
com.ibm.cic.common.ui.internal.parts.ProgressPart$ProgressJob.run(ProgressPart.java:109)
org.eclipse.core.internal.jobs.Worker.run(Worker.java:55)
Cause
IBM Installation Manager is unable to update software packages that include Eclipse-based offerings that contain the org.eclipse.equinox.launcher plug-in. This error is caused by the following symbol in the eclipse.ini file:
@launcher.dir/
IBM installation Manager is unable to resolve this symbol.
Resolving The Problem
In the eclipse.ini file, replace the @launcher.dir/ symbol with the absolute path of the folder where the Developer for z/OS version 16.0.x eclipse.exe and eclipse.ini files are located.
Note: Because Eclipse inserts the @launcher.dir/ symbol into eclipse.ini each time IBM Installation Manager updates a software package, you must replace it with the absolute path before each update operation that you request.
To find and replace the IBM Developer for z/OS installation path, do these steps:
1. Start IBM Installation Manager.
2. Select File>View Installed Packages.
3. Select the package where IBM Developer for z/OS 16.0.x is installed.
4. Copy the directory that is listed in the Installation Directory field.
5. Edit the eclipse.ini file that is in this installation directory and replace the @launcher.dir/ symbol with the installation directory path:
6. Save the eclipse.ini file.
7. Try the update operation again.
Document Location
Worldwide
[{"Type":"MASTER","Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSTRMM","label":"IBM Developer for z\/OS"},"ARM Category":[{"code":"a8m3p0000008uGIAAY","label":"IBM Developer for Z\/OS-\u003EIDz Client-\u003EInstall_Uninstall"}],"ARM Case Number":"","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"16.0.1;16.0.2;16.0.3;and future releases"},{"Type":"MASTER","Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSTQXQ","label":"IBM Developer for z\/OS Enterprise Edition"},"ARM Category":[{"code":"a8m3p0000008uGIAAY","label":"IBM Developer for Z\/OS-\u003EIDz Client-\u003EInstall_Uninstall"}],"Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"16.0.1;16.0.2;16.0.3;and future releases"},{"Type":"MASTER","Line of Business":{"code":"LOB67","label":"IT Automation \u0026 App Modernization"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSDV2W","label":"IBM Installation Manager"},"ARM Category":[{"code":"a8m3p000000PCNXAA4","label":"INSTALLATION-CONFIGURATION-MIGRATION"}],"Platform":[{"code":"PF016","label":"Linux"},{"code":"PF079","label":"Window"}],"Version":"All Versions"}]
Product Synonym
Installation Manager; Developer for z/OS; IBM IM; IDz
Was this topic helpful?
Document Information
Modified date:
14 February 2024
UID
ibm16981839