IBM Support

Update or rollback fails after using the Eclipse Software Updates option to install third party software

Troubleshooting


Problem

You use IBM Installation Manager to install IBM Eclipse based packages. You then use the Eclipse Software Updates option to install third party software for these packages. When you use Installation Manager to update or rollback a package, a failure occurs.

Symptom

You update or rollback a package using Installation Manager. The update or rollback fails in one of the following phases:

  • Reconciling configuration with eclipse
  • Initializing eclipse
  • Complete for eclipse
  • Validation of eclipse

The Installation Manager log file reports the failure as one of the following:
  • Eclipse p2 reconciler returned with error status=13, check for possible logs in C:/Program Files/IBM/SDP/configuration for more information.
  • Eclipse initialize returned with error status=-1.
  • Validation of Eclipse installation configuration failed because it references features or bundles in its "platform.xml" file that do not exist.

Cause

This issue can occur when:

1. Third party Eclipse features or plugins are installed using Software Updates that take precedence over the features or plugins installed using Installation Manager. Eclipse uses the native p2 component to install. Installation Manager modifies the platform.xml file and then uses the p2 reconciler to synchronize the results. For example, a plugin installed using Software Updates has version dependencies. These dependencies conflict with the content required when updating a product in Installation Manager. The conflict results in a 'Reconciling configuration with eclipse' phase failure.

2. Software Updates accesses Eclipse update sites to locate newer versions of features or plugins. These newer version might conflict with the Installation Manager based Eclipse packages. In addition, optional features or plugins are installed aggressively - see  Eclipse Bug 247099 - Ability to disable greedy behavior of optional dependencies causing problems.

Resolving The Problem

Do not use the Eclipse Software Update option to install new versions of features and plugins that are located in IBM Eclipse based packages. You must use Installation Manager to update IBM Eclipse based packages to a newer version.

To work around this issue, disable the Eclipse update sites before you install third party software.

To disable the Eclipse update sites:
1. Launch the product.
2. Go to Help > Software Updates...
3. Select the Available Software tab.
4. Click Manage Sites button. There are sites listed that are checked. These sites are the Eclipse update sites.
5. Uncheck all the sites.
6. Click OK


To install third party software
1. Launch the product.
2. Go to Help > Software Updates...
3. Select the Available Software tab.
4. Click Add Site...
5. Enter the location of the update site and click OK.
6. Check the update site if it is not checked.
7. Click Close
8. Install the third party software

If the third party software requires the installation of other products, add only the sites associated with the requirements. Try to avoid adding sites from download.eclipse.org.

NOTE: Try to install only categorized features from the third party software. Installing uncategorized features can cause issue to occur during an update or rollback.

If issues still occur with an update or rollback of a package installed by Installation Manager, uninstall the third party software. Then run the update or rollback in Installation Manager.

[{"Product":{"code":"SSDV2W","label":"IBM Installation Manager"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"General information","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"1.2;1.2.1;1.3;1.3.1;1.3.2;1.3.3","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSRTLW","label":"Rational Application Developer for WebSphere Software"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":null,"Platform":[{"code":"PF033","label":"Windows"},{"code":"PF016","label":"Linux"}],"Version":"7.5;7.5.1;7.5.2;7.5.3;7.5.4;7.5.5","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SS4JCV","label":"Rational Software Architect for WebSphere Software"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":null,"Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"7.5;7.5.1;7.5.2;7.5.3;7.5.4;7.5.5","Edition":"","Line of Business":{"code":"LOB15","label":"Integration"}},{"Product":{"code":"SS5JSH","label":"Rational Software Architect RealTime Edition"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":null,"Platform":[{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.5.2;7.5.3;7.5.4;7.5.5","Edition":"","Line of Business":{"code":"","label":""}},{"Product":{"code":"SS4JE2","label":"Rational Software Architect Standard Edition"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":null,"Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"7.5;7.5.1;7.5.2;7.5.3;7.5.4;7.5.5","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}},{"Product":{"code":"SSCLKU","label":"Rational Software Modeler"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":null,"Platform":[{"code":"PF033","label":"Windows"},{"code":"PF016","label":"Linux"}],"Version":"7.5;7.5.1;7.5.2;7.5.3;7.5.4;7.5.5","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}},{"Product":{"code":"SSMMM5","label":"Rational Performance Tester"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":null,"Platform":[{"code":"PF033","label":"Windows"},{"code":"PF016","label":"Linux"},{"code":"PF002","label":"AIX"}],"Version":"8.0;8.0.0.1;8.0.0.2;8.0.0.3;8.1;8.1.0.1;8.1.0.2;8.1.0.3","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSJMXE","label":"IBM Rational Functional Tester"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":null,"Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"8.0;8.0.0.1;8.0.0.2;8.0.0.3;8.1;8.1.0.1;8.1.0.2;8.1.0.3","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
25 October 2021

UID

swg21415770

Page Feedback