Installing Rational Asset Manager Eclipse client by using Eclipse update manager

Rational Asset Manager has an Eclipse client which you can use to find and download assets and interact with the repository from Eclipse. You can install the IBM® Rational® Asset Manager Eclipse features into an existing of Eclipse IDE by using the Eclipse update manager and downloading the features from the Rational Asset Manager server, a method that insures that the versions of Rational Asset Manager on your Eclipse client and on the server are compatible.

Before you begin

You can use the Rational Asset Manager Eclipse client with a Rational Asset Manager server of the same release version and one release version prior to that. Release versions include the original release and its fix packs. For example, you can use a Rational Asset Manager Eclipse client of version 7.1.1 with a Rational Asset Manager server of versions 7.1.1, 7.1.0, and 7.1.0.1.

Your Eclipse IDE must meet the software requirements before you can install the Rational Asset Manager Eclipse client into it. See Software requirements for detailed requirements. You must also know the URL for accessing the Rational Asset Manager server using the web client.

Note: These instructions are for Eclipse 3.4. The process for installing new software is slightly different in each version of Eclipse and in different applications that are built on Eclipse. For example, in Eclipse 3.5 the update manager is located in Help > Install New Software. In general, the wizard to install new software is usually under the Help menu.

Procedure

  1. Start Eclipse.
  2. Click Help > Software Updates.
  3. In the Software Updates and Add-Ons window, click the Available software tab.
  4. Click Add site.
  5. Provide the Update site details:
    1. Open the Rational Asset Manager web client, and then click the Help icon and Extensions.
    2. On the Extensions page, in the Eclipse Client Plug-in section, copy the URL listed next to Update site.

      If the Rational Asset Manager server is only available on an https protocol, the Eclipse client will not be able to use the update site. To resolve this, refer to the topic Adding the server public certificate to the Eclipse client.

    3. In Eclipse, in the Add Site window, paste the Update Site URL into the Location field.
    4. Click OK
  6. Expand the Rational Asset Manager update site that you just added and select the features to install. Typically, select all of the features, with the following exceptions:
    • If the Eclipse client you are using has IBM Rational Team Concert™ installed, from the Rational Asset Manager integrations with Rational Team Concert category, select the version of the Rational Team Concert Client integration that matches your version of Rational Team Concert. Do not select more than one.
    • If the Eclipse client you are using does not have Rational Team Concert installed, do not select any Rational Asset Manager Eclipse RTC Client integration feature.
    • If you are upgrading a Rational Asset Manager v7.2.0.1 or earlier Eclipse client, select the Required for existing 7.2.0.1 or earlier clients > Rational Asset Manager Common - Obsolete feature.
    • If you are installing into a Rational Software Architect v8.0 client, from the Rational Asset Manager Eclipse Client category, clear the EPF Richtext Feature feature.
    • If you are installing the Rational Asset Manager Eclipse client into IBM Rational Team Concert, you can clear these features, which should already be installed:
      • IBM Rational common user assistance
      • IBM Rational common user assistance resources

      The above two IBM Rational common user assistance features have similar names, but they have different content and are both required for the help system.

  7. After you have selected the features to install, click Install.
  8. In the Install window, review and accept all of the license agreements and click Next.
  9. Click Finish.
  10. If you see an error that says An error occurred while collecting items to be installed - Unpack facility not configured, you must restart Eclipse with a command to use a Java JRE that can unpack the files at the update site:
    1. Locate a Java JRE on your file system. For example, C:\Program Files\IBM\Java\jre\bin or C:\Program Files\Java\jre\bin.
    2. Launch Eclipse with the -vm argument that points to the location of the JRE. For example, eclipse.exe -vm C:\Program Files\IBM\Java\jre\bin.
    3. Try the install procedure again, starting at step 2.
  11. When the installation finishes, restart Eclipse.

Results

To verify that the installation was successful, open the Asset Management perspective; click Window > Open Perspective > Other and then select Asset Management from the list. Click OK.
Feedback