EditAttachPrintable
r11 - 2013-06-20 - 15:48:30 - Main.dmmckinnYou are here: TWiki >  Deployment Web > DeploymentTroubleshooting > IntegrationsTroubleshooting > WhyAmINotAbleToInstallRAMClientOnTopOfExistingRTCClientUsingInstallationManager

new.png Why am I not able to install RAM client on top of existing package group using Installation Manager?

Authors: IntegrationsTroubleshootingTeam
Build basis: Rational Team Concert 4.0.x, Rational Asset Manager 7.5.1.2, Rational Software Architect 8.5.x, Rational Software Architect for WebSphere 8.5.x, IBM Rational Application Developer for WebSphere 8.5.x

This document describes what to do to install the IBM Rational Asset Manager (RAM) 7.5.1.x client on top of an existing IBM Installation Manager package group containing, for example, IBM Rational Team Concert client, IBM Rational Software Architect (for WebSphere) or IBM Rational Application Developer for WebSphere 8.5.x.

Initial assessment

Symptoms

  • When you install Rational Asset Manager 7.5.1.2 in the same Package Group where you previously installed IBM Rational Team Concert (RTC) 4.0.x or Rational Software Architect (for WebSphere) 8.5.x, the installation fails with the following error:

    RAM7512OnTopOfRSA851Error.jpg

    In plain text:
    Installation failed.
       Error during "complete" phase:
       CRIMA1082E: The bundle "com.ibm.ut.help.common_2.11.3.v20130228_1957" cannot be installed in this Eclipse configuration because 
       it is not equivalent to the bundle "com.ibm.ut.help.common_2.7.2.v20121004_1540" that is already installed. 

  • When you install Rational Team Concert 4.0.x or Rational Software Architect (for WebSphere) 8.5.x in the same Package Group where you previously installed Rational Asset Manager 7.5.1.2, the installation fails with the following error:

    RTC402OnTopOfRAM7.5.1.2.jpg

    In plain text:
    Installation failed.
        Error during "complete" phase:
        CRIMA1082E: The bundle "com.ibm.ut.help.common_2.7.2.v20121004_1540" cannot be installed in this Eclipse configuration because 
        it is not equivalent to the bundle "com.ibm.ut.help.common_2.11.3.v20130228_1957" that is already installed. 

Impact / Scope

  • This is affecting all the users who are trying to install RAM 7.5.1.2 on top of an existing package.

Recommended data gathering and subsequent analysis steps

Installation Manager logs

Note: Performing these steps can be time consuming. You may want to check first if a capability is disabled, as that is faster (see Possible Causes and Possible solutions).

  1. Start IBM Installation Manager
  2. Collect the installation logs with the menu: Help > Export data for Problem Analysis
  3. Save the resulting zip file to a temporary folder
  4. Uncompress the files
  5. Check what exact products are installed by opening: installed.xml
  6. Look for installation errors by opening the file: logs\index.xml
  7. Compare the date and times of the installation logs with the installation history: histories\index.xml. This helps in establishing the phase during which the installation errors occurred.

Possible causes

Installation errors

  • When installing two Eclipse-based products in the same Installation Manager Package Group, the Equinox P2 reconciler process runs. If it finds plugin versions which would invalidate the Eclipse configuration, the installation procedure will halt.

Possible solutions

  • Install RAM using the Eclipse Help > Install New Software... mechanism into your existing IBM Installation Manager package as follows:

    1. Get the URL of your RAM server Eclipse update site from the Help icon and choose Extensions.

      RamExtension.jpg

      RamExtensionEclipsePlugin.jpg

      The Extension page says the RAM eclipse is based on version 3.4 although it is compatible with Eclipse 3.6.2 and above (see Work item 88588:Extension page still says RAM's Eclipse client is based on 3.4 for further details).

    2. Point to your RAM 7.5.1.2 server Eclipse Update Site (for example: http://host:port/ram/RCPUpdateSite/)

      RAMClientInstallFromUpateSite.jpg

      Select all the options you see in the above screenshot even the RTC 3.0 client integration plugin as it is valid for version 3.0 and above.

  • Install RTC into your RAM 7.5.1.2 client using the eclipse Help > Install New Software... mechanism as follows:

    1. Download the Client for Eclipse IDE (RTC-Client-p2Repo-4.0.x.zip) you can get from the RTC downloads as shown below:

      RTCClientForEclipseIDEDownload.jpg

    2. Point to P2 installer zip you downloaded as shown below:

      RTCClientForEclipseP2Install.jpg

Related topics:

External links:

Additional contributors: FrancoisPanaget

Questions and comments:

Warning: Can't find topic Deployment.WhyAmINotAbleToInstallRAMClientOnTopOfExistingRTCClientUsingInstallationManagerComments

Edit | Attach | Printable | Raw View | Backlinks: Web, All Webs | History: r15 | r13 < r12 < r11 < r10 | More topic actions...
 
This site is powered by the TWiki collaboration platformCopyright © by IBM and non-IBM contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our Terms of Use. Please read the following disclaimer.
Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more here.