IBM Support

Rational Method Composer, Version Release Information

Release notes


IBM Rational Method Composer Version contains new features, enhancements, and fixes to the Version 7.5.2 release.


  • About this release
  • New in this release
  • APARs fixed in this release
  • System requirements
  • Installation information
  • Downloading practice libraries
  • Converting your existing processes to configuration-free
  • Floating/Token licensing
  • Known limitations, problems, and workarounds
  • Rational Asset Manager integration support
  • Localization
  • IBM Rational Software Support

  • © Copyright IBM Corporation 1987, 2012. All rights reserved. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

    About this release
    This fix pack includes new features, enhancements and fixes to the earlier version 7.5.2 release of Rational Method Composer.

    The Rational Method Composer release is available for download at the following location:

    New in this release
    Rational Method Composer v7.5.2.1 has been enhanced with the following new features.

    • A new integration with Jazz source control. The Jazz source control integration simplifies the task of managing a method library under version control. The integration uses automatic pessimistic file-locking to enable you to perform such operations as:
      • Checking in, delivering, and sharing new method plug-ins with other users in Jazz source control
      • Encapsulating changes you make to source content as outgoing change sets that others users of the integration must accept before being able to edit these resources
      • Identifying and accepting incoming changes that have been made to source content by other users. changes
      • Renaming and deleting method plug-ins
      • Locking all elements in a method plug-in, finding locked files, and releasing all locked files that have not been changed
    • Jazz Work Item Types generated in Rational Method Composer now provides a custom guidance field so process guidance links can be added
    • Provisions to model Jazz work item types and to automatically associate the correct Jazz work item types to Jazz work items that have been generated in Rational Method Composer
    • All work item creation and work item template generation follow the modeling choices authors have used to automatically associate the right Jazz work item types to generated work items.
    • In addition to the choices of selecting the initial iterations for a Jazz process template generated in Rational Method Composer, users can now choose a new Capability Pattern or Delivery Process that will be mapped to a complete project timeline
    • Provides the capability for method authors to control the ordering of process contribution
    • Three new custom attributes have been added: text, choices, and attachments
    The IBM Practices Library v7.5.2.1 has been enhanced with the following features:
      • The IBM Rational Solution for CLM has been updated for the CLM 4.0.1 release which includes user-defined types for mapping process elements to specific Rational Team Concert work item types.
      • New solution configurations have been included for:
        • Aerospace DO-178B
        • Automotive ISO-26262
        • Medical Devices
        • Aerospace and Defense - DoDAF
      For Automotive (ISO 26262) and Aerospace/Defence (DO178B) solutions, the process template included is for Rational Team Concert 3.0. Newer versions (English only) that support Rational Team Concert 4.0 have been posted here:

    APARs fixed in this release
    APARs that are fixed in this release are located in the Fixlist document at:

    System requirements
    The following sections describe the specific installation requirements for this refresh pack.

    For information about the hardware and software for Rational Method Composer, Version 7.5.x.x, see the detailed system requirements document at:

    Installation information
    For installation information including upgrade information, see the Rational Method Composer information center:

    Converting your existing processes to configuration-free
    There is a utility available for download to convert your existing library contents to configuration-free process . You can obtain the utility from the IBM support site at:

    Floating/Token licensing
    Rational Method Composer ships with a trial license key that enables you to try the product for a period of 30 or 60 days. During the trial period, the product is fully functional. You will get a warning message when the trial period is about to expire. After the expiration date, the product will not function.

    Setting up the license server
    You must have administrative privileges on the machine that you want to import license key information in Rational License Key Administrator.
    1. Install Rational Common License 8.1.0
    2. Go to Start > IBM Rational > License Key Administrator 8.1.0. License Key Administrator wizard opens.
    3. Select Import a Rational License File, click Next.
    4. Browse and select a valid license file to import, click Import.
    5. In the Confirm Import window click Import.
    6. In the File imported successfully window, click OK.
    7. In the Restart License Server window, click Yes.

    Enabling floating licenses
    Rational Method Composer supports Floating/Token licenses. You can configure a connection to one or more license servers to obtain access to floating/token license keys installed on a license server.

    Before enabling floating license, you must obtain the license server connection information from your administrator.
    1. In the IBM Installation Manager, click Manage Licenses.
    2. Select a version of a package and then select Configure Floating license support. Click Next.
    3. Read and accept the license agreement and click Next.
    4. Select Enable floating license enforcement and click the + icon to add a the license server information.
    5. Select the Single Server option.
    6. In the Name field, enter the host name of the license server.
    7. In the Port field, enter the port number of the server.
    8. Click Test Connection to verify that you can successfully connect to the server.
    9. Click OK, then click Next.
    10. In the license usage summary page, verify the product and version, click Finish.

    Known limitations, problems, and workarounds
    The following section lists the known problems in this release of Rational Method Composer and possible workarounds, if any.

    Problems with installed 3rd party plug-ins
    When installing 3rd party plug-ins like CCRC or SVN through the classic update manage (Help > Install Software) or 3rd party plug-ins like CCSCM through new extension location (Help > Manage Software Configuration), all the existing Rational Method Composer v7.5.1 feature patches can't be loaded and cause BIRT publishing and Diagram crook line issues. To solve the problem:
    1. Shutdown Rational Method Composer.
    2. Find and open the platform.xml file for editing In the Rational Method Composer installation directory (for example, c:\Program Files\IBM\RMC75\rmc\configuration\org.eclipse.update\platform.xml).
    3. Search for "". You will find a site element that contains "" in its list attribute.
    4. Replace the entire site with the following content:
      <site enabled="true" policy="USER-EXCLUDE" updateable="true" url="platform:/base/" />
    5. Open a command prompt and change to the Rational Method Composer installation directory.
    6. Run the following command to start the application: rmc.exe -clean

    To verify that the feature patches are loaded correctly, click Help > About IBM Installation Manager > Installation Details > Plug-ins. Check the version of, it must be 2.5.2.v20100805.

    Rational Method Composer floating and token licenses
    IBM Installation Manager does not handle rollbacks with floating license using Rational Common Licensing v8.1.1 to a previous version that does not have the floating license capability. If you need to rollback to a previous release, you must disable your floating license before attempting to rollback.

    The Rational Method Composer integration with Rational Synergy
    During the installation of Synergy plugin via Help -> Install Software, a duplicate conflict message is displayed. In addition, when upgrading a Rational Method Composer that includes the Rational Synergy integration, package update warnings are displayed. These warnings are harmless and can be ignored.

    The Rational Method Composer integration with Jazz source control
    In some instances, there might be extra lock being acquired for files that do not need to be changed. One example is that when a content package is added to a method plug-in, some of the configuration files will be locked, too. This is harmless and users should just release all the locked files when deliver the changes in a change set.

    User-defined types, custom relationships, and custom attributes
    Support for user-defined types, for custom relationships is currently implemented for the authoring perspective and for publishing. The following areas are not currently supported for user-defined types, custom relationships, and custom attributes:
    • CSV file report
    • Package copy across plug-in
    • Using the plug-in creation wizard tp copy a plug-in
    • The Tailoring perspective and other areas such as BIRT-based reporting

    Special character in tag file names
    Tag file names include "[" character which is a restricted character in file names for Informix that is used by Rational Synergy. As a result, these tag files cannot be placed under Rational Synergy source control. See the following technote for more information about Rational Synergy restricted characters:
    To add the .tag files under Rational Synergy source control, compress the initial .tag project and add it to Synergy. To modify the tags, reserve check out the zip file to ensure other resources are not working on the same file, extract and make the changes, re-compress and check back in to the source control.

    Exporting practices to Jazz Team Server
    There is a Export feature available in Rational Method Composer that provides the ability to export a selection of practices to an XML file that can subsequently be imported to Jazz Team Server. If you want to try the import on the Jazz side and experiment with some early capabilities within the Jazz Team Server, you can do so by downloading and installing the following items from

    RQM Workbench for CLM 3.0 M11 build (includes JTS, RTC, RRC capabilities)

    Jazz Process Authoring Application (in Jazz foundation milestone 3.0RC3).

    Publishing configuration error
    Publishing configuration of the RUP for small projects to Adobe PDF or Microsoft Word in ib.75.rup with configuration.rptlibrary generates an error message in the log file. This is a known BIRT issue (
    Also try to avoid using HTML comments (<!-- -->) in HTML table definition in your Rational Method Composer contents, as this generates errors in the log files when publishing to Microsoft Word or Adobe PDF.

    Sharing a project in Rational ClearCase
    After sharing a project in Rational ClearCase, you might get error messages when trying to edit Rational Method Composer contents. This is because the project is moved from Rational Method Composer workspace to Rational ClearCase space after sharing. The workaround for this issue is to reload the workspace library after sharing.

    Installation Manager limitation for updating RUP and Practice libraries
    When starting Rational Method Composer for the first time, the default RUP library and the Practice library are loaded. This might cause Installation Manager not to be able to update these libraries in the future because of the time flag changes in some library files. It is recommended to make a backup of your RUP and Practice libraries and load them when launching Rational Method Composer.

    IBM Rational Method Composer Security Vulnerability
    Rational Method Composer is shipped with an IBM Java that is based on Oracle Java. Oracle has released a June 2012 critical patch update (CPU) that contains security vulnerability fixes and IBM Java is affected. For more information, see:

    Uninstalling Rational Method Composer
    There is a menu option under Help > Manage Licenses > Uninstall that does not uninstall the product and must be ignored. To uninstall Rational Method Composer, Use the Uninstall feature of IBM Installation Manager.

    Search function of the published HTML sites on Firefox
    Rational Method Composer uses Java applet for the search function on the published sites. On Linux, sometimes the Java applet is not enabled on Firefox and must manually be enabled.

    For Firefox 1.5 to 3.5 on RHEL5 or SUSE10:
    1. Install JRE 5.0 or above. Assume that the JRE is installed at /opt/JRE.
    2. Go to the browser's plugin folder. On RHEL5u3, the plugin folder is /usr/lib/mozilla/plugin-wrapped. On SUSE10, the plugin folder is /usr/lib/browser-plug-ins.
    3. Create a symbolic link to the java plugin at the browser's plugin folder:
      ln -vs $(find /opt/JRE/ -name
    4. To enable Java, start Firefox and type about:plugins to ensure the java plugin is installed. Then go to edit > preferences > content tab page, check "enable java".
    For Firefox 3.6 and later:
    1. Upgrade the JRE to 6.0_10 or later.
    2. Use the following command to install the Java plugin:
      ln -vs $(find /opt/JRE/ -name

    Rational Asset Manager integration support
    This release of Rational Method Composer supports integration with Rational Asset Manager V7.5.

    To download localized IBM Practices libraries see:
    In this release of Rational Method Composer, the user interface is translated in the following languages:
    • Arabic (ar)
    • Chinese (Simplified) (zh_CN)
    • Chinese ( Traditional) (zh_TW)
    • Brazilian Portuguese (pt_BR)
    • Danish (da)
    • German (de)
    • French (fr)
    • Italian (it)
    • Spanish (es)
    • Japanese (ja)
    • Korean (ko)
    • Polish (po)
    • Russian (ru)

    In this release of Rational Method Composer, the online documentation is translated in the following languages:
    • Arabic (ar)
    • Brazilian Portuguese (pt_BR)
    • German (de)
    • French (fr)
    • Spanish (es)
    • Japanese (ja)

    IBM Rational Software Support
    IBM Rational Software Support provides you with technical assistance.
    For contact information and guidelines or reference materials that you will need when you require support, read the IBM Software Support Handbook at:

    For product news, events, and other information, visit the product home page for Rational Method Composer at:

    Before you contact IBM Rational Software Support, gather the background information that you will need to describe your problem. When describing a problem to an IBM software support specialist, be as specific as possible and include all relevant background information so that the specialist can help you solve the problem efficiently. To save time, know the answers to these questions:
    What software versions were you running when the problem occurred?
    Do you have logs, traces, or messages that are related to the problem?
    Can you reproduce the problem? If so, what steps do you take to reproduce it?
    Is there a workaround for the problem? If so, be prepared to describe the workaround.

    Document information

    More support for: Rational Method Composer

    Software version:

    Operating system(s): Linux, Windows

    Software edition: All Editions

    Reference #: 7036970

    Modified date: 11 February 2016

    Translate this page: