IBM Support

Rational Automation Framework Fix Pack 5 ( for 3.0

Downloadable files


IBM Rational Automation Framework is generally available and contains fixes to all previous fix packs of version 3.0.

Download Description

Table of Contents
Sections Description
This section provides an overview of what is new in this release with a description of any new functionality or enhancements where applicable.
This section provides information related to the impact of this release to allow you to assess how your environment may be affected.
This section provides important information to review prior to the installation of this release.
This section provides the direct link to obtain the download package for installation in your environment.
This section provides the installation instructions necessary to apply this release to your environment.
This section contains a link to the known problems (open defects) identified at the time of this release.
Supporting Documentation
Document Description
Click the link to navigate to the system requirement report page. To run the report, select your Product, Version and Operating System. 
Note: Choose the parent version of your product to see the system requirements for fix pack releases.
Click to browse for the version of your product information center available on the product information library page.
Click to review the list of defects (APARs) resolved in this release and resolved in previous releases of this version (3.0.0.x).


Rational Automation Framework 3.0 or a later fix pack is a prerequisite for this fix pack.

Back up the following items before installing this fix pack:

  • Installation directory for Rational Automation Framework. These are the default directories:
    • UNIX or Linux systems: /opt/IBM/RAFServer
    • Windows systems: C:\IBM\RAFServer
  • Metadata for Installation Manager.
    • UNIX or Linux systems: /var/ibm/InstallationManager
    • Windows systems (Windows 7 or Windows 2008 and later):
      %ALLUSERSPROFILE%\IBM\Installation Manager
    • Windows systems (previous versions):
      %ALLUSERSPROFILE%\Application Data\IBM\Installation Manager

Installation Instructions

Review the install.html file in the installation package or refer to the installation guide in the Information Center (link provided below).

You can install this release of Rational Automation Framework in the following ways:

  • Install as a new product.
  • Upgrade from any previous version of 3.0.0.x.

To upgrade from Rational Automation Framework for WebSphere releases and earlier, you must first upgrade to Rational Automation Framework version 3.0, then upgrade to Rational Automation Framework version

When you install this version, an instance of IBM Rational Build Forge® version is also installed. When you upgrade from a version of Rational Automation Framework prior to, the previous version of Rational Build Forge is replaced with version For information about Rational Build Forge version, see the release notes on

Important: If you use Apache HTTP Server and have customized versions of the httpd.conf and php.ini files, then before you upgrade, back up these files. After the upgrade is complete, merge your customized files with the current files.

Installation guide English 5000000

Download package

The following sections provide detailed information related to this release.

How critical is this fix?

Impact Assessment
Impact Description
This release is a maintenance release of Rational Automation Framework version 3.0. It contains fixes for client-reported and internally-found defects.

Problems solved

Click the Fix List link in the table of contents above to review a list of the problems solved in this release.

Known side effects

The following issues are known to affect this release.

Change to configure_all composite action for WebSphere Application Server 8.5: If you installed the WebSphere Application Server version 8.5 base image (rather than the network deployment image), two actions cause exceptions:


Because of this problem, these actions have been excluded from the was_common_configure_all composite action.

Workaround: If you installed the WebSphere Application Server version 8.5 network deployment image, you can run these actions separately. Base image users cannot run these actions.


WebSphere Virtual Enterprise 7.0 and WebSphere Application Server version 8.0 or later: Rational Automation Framework does not currently support the installation of WebSphere Virtual Enterprise version 7.0 where WebSphere Application Server version 8.0 or later is installed. WebSphere Application Server 8.0 and later requires that you use IBM Installation Manager to install WebSphere Virtual Enterprise. The WebSphere Virtual Enterprise installation actions currently use IBM Update Installer.

If you attempt this installation, the following error message is displayed:

Workaround: You can install WebSphere Virtual Enterprise version 7.0 on WebSphere Application Server version 7.0 and earlier.


was_common_configure_all fails with On Demand Router server: When the action runs, the following exception is returned:

[exec] WASX7017E: Exception received while running file 
exception information: 
ADMG0007E: The configuration data type CustomProperty is not valid.

The problem is caused by a problem with WebSphere Application Server.

Workaround: Manually configure On Demand Router servers using WebSphere Application Server tools.


Dragging configuration definition to the Configuration Workspace fails for large files: If you see a copy/paste failure message when you drag a configuration definition to the Configuration Workspace in the Eclipse client, and you see an OutOfMemoryError in the log, you might have an archive file in the configuration that is larger than the Eclipse client can currently copy.

Workaround: To install an application from a large archive file, copy the archive directly to the server.


Cannot use parentheses in directory name in Windows: If you use parentheses in a directory name in the Environment Generation wizard (for example, "C:\Program Files (x86)"), the value is flagged as invalid.

Workaround: Use a short directory name instead. To get a list of short directory names, run the following command in a command prompt:

dir /x \


Missing application options when importing from WebSphere Application Server version 8.0 or later: When you run the was_common_deploy_install_app action in import mode to capture a WebSphere Application Server 8.0 or later configuration, some options might not be captured. Warning messages are generated in the following form:

CRWWA1001W Support for the deployment task 'xxx' is not implemented in the product.

Change history

Review the What's new topic in the on-line information center for a full list of what's new in the release.

Download RELEASE DATE LANGUAGE SIZE(Bytes) Download Options
Fix Pack 5 for RAF Server and Client 30 Oct 2012 US English 4091096568 HTTP

Technical support

Tab navigation

IBM Rational Software Support Communities

  • Visit the IBM Support Portal to configure your support portal experience and review FAQs, lists of known problems, fixes, and a wealth of important support information.

  • Visit developerWorks to access an online collection of tutorials, sample code, standards, forums and other resources provided by experts at IBM to assist software developers using Rational tools including access to the IBM RFE Community.

  • Visit the Jazz Community if you use a Rational product created using the Jazz platform to interact directly with the Jazz development team and other community members, download product trials and betas and track developement progress.

Helpful Hints For Obtaining Technical Assistance:

Before you contact IBM Rational Software Support, gather the background information that you need to describe the problem. When you describe 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.

If you have helpful information to diagnose or identify the problem on your system, you can provide this data by following the instructions to exchange information with IBM Technical Support.

Follow IBM Rational Client Support on Twitter | Facebook | YouTube | devWorks Blog

Document information

More support for: Rational Automation Framework

Software version:

Operating system(s): AIX, Linux, Solaris, Windows, z/OS

Software edition: All Editions

Reference #: 4033582

Modified date: 06 June 2013

Translate this page: