IBM Support

Rational Automation Framework Fix Pack 3 ( for 3.0.1

Downloadable files


IBM Rational Automation Framework (RAF) has been made generally available and contains fixes to version 3.0.1 including all predecessor fix packs.

Download Description

Table of Contents
Sections Description

The Change history section provides an overview on what is new in this release with a description of any new functions or enhancements when applicable.

The How critical is this fix section provides information related to the impact of this release to allow you to assess how your environment may be affected.

The Prerequisites section provides important information to review prior to the installation of this release.

The Download package section provides the direct link to obtain the download package for installation in your environment.

The Installation instructions section provides the installation instructions necessary to apply this release into your environment.

The Known side effects section contains a link to the known problems (open defects) identified at the time of this release.

Supporting Documentation
Document Description

Click to review the detailed system requirements information for a complete list of hardware requirements, supported operating systems, prerequisites and optional supported software, with component-level details and operating system restrictions.

IBM Knowledge Center provides an entry point to product documentation. You can view, browse, and search online information related to the product.

Click to review a complete list of the defects (APARs) resolved in this release including a list of resolved defects for the entire version family.


Prerequisites include:

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

Back up the following items before installing this release:
Note: These are the default directories:

  • Installation directory for Rational Automation Framework
    • 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 Installation overview>section of the IBM Knowledge Center.

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 3.0.1.

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, review 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.

Download package

The following sections provide detailed information related to this release.

Click the FC link below to obtain the release from Fix Central.

Important: Confirm the target directory when extracting the files

The extraction tool included in Windows operating systems by default extracts the contents of each .zip file to <current directory of the .zip file>/<name of .zip file>. (For example, the contents of C:\temp\ are extracted into C:\temp\myfile.) As a result, the contents each file that you extract are in separate directories and you will not be able to install the product. Ensure that you extract the contents of each .zip file into the same directory.

When you extract the contents of the compressed files, ensure that you preserve the directory structure of the extracted contents.

How critical is this fix?

Impact Assessment
Impact Description

This is a maintenance release. It contains fixes for client-reported and internally found defects.


Regression: An error in the Maintenance Delivery Vehicle (MDV) that produces incorrect or unexpected behavior causing a supported feature to stop functioning as designed.
This includes:

  • Coding errors that cause a regression
  • Documentation or packaging problems that cause a regression
  • Errors reported in a new function delivered in a MDV that cause a regression

Incomplete: An error in the MDV has not regressed, but does not work as designed.
This includes:

  • Fixed APARs which did not solve the original problem but did not break anything new
  • APARs reporting documentation errors, such as readme errors, that cause problems applying an MDV but do not lead to a regression

  • Regression and incomplete APARs are considered fix-in-error or MDV-in-error
  • Definitions above apply only to valid APARs that result in product fixes (APARs returned as working-as-designed are not assessed for being fix-in-error)
  • Issues in major releases due to new functionality do not apply in this definition

There are no known regressions to report.

Problems solved

Defects resolved

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 defects were not resolved in this release:

There are no known issues to report.

Open defects

Review the following list of open defects for Rational Automation Framework on the IBM Support Portal.

Review technote 1461170: Open APARs for Rational products available on the Web for information on how to configure your MyNotifications subscription account and subscribe to the APARs you are interested in following.

The following issues are known to affect this release:

RAF creating a new SIBus data store using default values instead of expected values

The main issue is that the wsadmin scripting engine can not update the sibus messaging engine name. Thus it creates a default name when the message engine is created, but it's not able to properly update the schema. For more information, see PM76528: was_common_configue_sibus_all does not properly update Messaging bus entries when run in execute mode.

These are WAS limitations, and RAF can only work on it with following work around:

Change messaging engine's name in sib.xml before run WAS_COMMON_CONFIGURE_SIBUS_MESSAGINGENGINES or WAS_COMMON_CONFIGURE_SIBUS_ALL in execute mode.

For example: To modify SIBDatastore info:


<SIBMessagingEngine .... name="Node01.server1- SIBUS2">
<SIBDatastore <default_values> >


<SIBMessagingEngine .... name="Node01.server1- SIBUS2_new">
<SIBDatastore <new_values>>

Note: Only change the name of SIBMessagingEngine, not <RAF_MessagingEngineScope> part.


was_common_deploy_install_app fails on WebSphere Application Server v8.5.5 when changing the 'initial parameter of a Web module'.

This is caused by a known issue in WebSphere Application Server v8.5.5: PM93960: ADMINAPP.EDIT CAN GENERATE A NULLPOINTEREXCEPTION.

The fix is delivered to WebSphere Application Server v8.5.5.2 and higher version.

Workaround: Install WebSphere Application Server V8.5.5 Fix Pack 2 or Fix Pack 3


Java SDK installation updated: The version of the Java SDK installed with the product has been updated for each operating system.

  • Windows, Linux, AIX, and z/os systems: version 7R1 SR1
  • Solaris and HP-UX Itanium (64-bit) systems: version 7 SR6
  • HP-UX PA-RISC systems: 6 version SR16


New was_common_configure_configuration action: This action imports all supported all configuration types at all supported scopes (entire cell). This action is only valid when executed from the cell scope. It will start a single wsadmin session and query for all supported config types at all supported scopes (cell, cluster, node, server) and write out the configuration data found into its corresponding scope. See the Action Reference for more information.


Actions that use long-running wsadmin commands are not supported on Windows systems: You cannot use was_common_configure_setup_lr_wsadmin to set up the use of long-running wsadmin commands on Windows systems.


Integration with Rational Asset Manager and Rational Team Concert: default values are not provided to the configuration editor. The file is supposed to supply default values to the configuration editor. The editor currently does not recognize the file.

Workaround: default values are now stored in XML files. Edit them to provide default values to the configuration editor.

  • Rational Team Concert:
  • Rational Asset Manager

For example, to specify a default value for AM_ANT_COMMAND, use an entry like the following entry and substitute the desired value for defaultValue.

<question name="AM_ANT_COMMAND" ... defaultValue="defaultValue">


Template directory not copied when creating a custom template.

Workaround: Use the Eclipse UI when creating custom templates. If you do not use the Eclipse UI, you need to manually copy the referenced template to a subdirectory under the custom template.


New location for configuration definition file: The former location of the configuration properties file ( was the following directory:


Beginning with Rational Automation Framework Version, a second copy of the file was placed in the following directory:


Beginning with Version 3.0.1, only one copy of the configuration definition file is supported. That copy is the one located in the /user/preserve/envgen directory.


Cannot stop server1 during execution of RAFW_WAS_Admin_Agent_Uninstall_Helper_Library step

This note applies when {WAS_VERSION} is any of V7.0, V8.0, or V8.5.

When you install an Administrative Agent topology using RAFW_WAS_{WAS_VERSION}_Admin_Agent_Install_Library, a default application server named server1 is created on each managed node in the cell. The server1 server is not included in the Rational Automation Framework environment. It cannot be configured using actions.

Workaround: Stop and delete server1 manually before running RAFW_WAS_Admin_Agent_Uninstall_Helper_Library.


Administrative Agent installation plan fails when no application server is defined

This note applies when {WAS_VERSION} V7.0, V8.0, or V8.5.

The installation plan RAFW_WAS_{WAS_VERSION}_Admin_Agent_Install_Library for the WebSphere Application Server administrative agent fails if no application servers were defined for the managed nodes in the cell during definition of a new configuration for the Administrative Agent.

Workaround: Ddisable steps for the application servers before running RAFW_WAS_ _Admin_Agent_Install_Library

  • RAFW_WAS_Admin_Agent_Uninstall_Helper_Library: disable the "Stop servers" step.
  • RAFW_WAS_Admin_Agent_Install_Helper_Library: disable the "Create servers" and "Start servers" steps.

Note: You should avoid creating a configuration that does not contain at least one application server.


Cluster member in WebSphere Application Server version 6.1, 7.0, 8.0, and 8.5 is set to the wrong SERVER_TYPE after upgrade from Rational Automation Framework and regeneration.

After upgrade, when you regenerate the configuration, the SERVER_TYPE is set to APPLICATION_SERVER. It should be APPLICATION_SERVER_MEMBER.

Workaround: Edit the configuration manually, then regenerate.


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.


Custom templates fully supported for WebSphere Application Server and WebSphere Portal only: For any other middleware products, you might see errors due to mismatched token names between the user-created templates and the product templates.

The automated creation of custom templates is not available at all for WebSphere Application Server Liberty profile.

Workaround: For products other than WebSphere Application Server and WebSphere Portal, use product templates and customize the configuration definitions manually.


Clusters cannot recognize custom node types: The problem is that nodes define what types of servers you can create on them. Clusters define what types of nodes their servers go onto. Servers are located on nodes, but are managed by clusters. Thus existing cluster types don't recognize custom nodes and won't allow you to create servers on them. The custom nodes are not even available in the configuration editor to add to a cluster.

For this release, do not use custom node types if you want servers on those nodes to be clustered. Instead, add custom questions for the standard node types.


Java 7 required for alternate application servers: If you use WebSphere Application Server or your own copy of Tomcat as your application server, you might not be able to launch the Rational Automation Framework console.

Upgrade to a version of WebSphere Application Server or Tomcat that includes Java 7.


The Rational Automation Framework integration with Rational Asset Manager is not available on AIX: Version 3.0.1 of Rational Automation Framework does not support Rational Asset Manager integration on the AIX platform.


Creating a virtual system pattern from a template results in pattern for unintended part: The VSP generator chooses parts based on the way those parts identify themselves. If, for example, a new image is an extension of a WebSphere Application Server image, but still identifies itself as the WebSphere Application Server part, Rational Automation Framework might use the new image rather than the intended WebSphere Application Server part.

Workaround: Instead of generating a VSP, use the same interface to generate a custom script package based on the template. You can then manually create a VSP in the IBM Workload Deployer and add the custom script package as well as the Cleanup, Import, and Integration script packages. Alternatively, you can edit the generated VSP, remove the incorrect image, and replace it with the appropriate one.


VSP generation fails due to missing script package: When generating a virtual system pattern from a template, you might see the following error message:

CRWSE0307E No matches for script package with name AMC Xxxxxx Script Package

You must have the following script packes in the IBM PureApplication System catalog:

  • AMC Cleanup Script Package
  • AMC Import Script Package
  • AMC Integration Script Package

If any packages are missing, upload them from the following location on the framework server:


The following files are available:

  • (contains AMC Integration Script Package)

After all three script packages are displayed in the catalog, generate the VSP again.


Rational Automation Framework script packages are supported only on Linux and AIX: Rational Automation Framework script packages are not supported when attached to Windows based images.


WebSphere Application Server 8.5.5 supported as automation target: You can use all existing WebSphere Application Server 8.5 actions with WebSphere Application Server 8.5.5.


Microsoft Windows Server 2012 support: Microsoft Windows Server 2012 (W2K12) is supported as a platform for WebSphere Application Server 8.5 target systems.


Fix pack support: The current release supports the following fix packs for IBM WebSphere Application Server and IBM HTTP Server: 70027, 8003, 8004, 8005, 8501.


RAFW_EnvironmentGenerationWizard automation plan no longer created: Due to extensive changes in the generation process, this plan is no longer needed.  The plan was not commonly used, in any case. Existing copies of the plan are not deleted when you upgrade from a version earlier than 3.0.1, but the plan is no longer created if you freshly install version 3.0.1.


User change logging suppressed in Tomcat logs: The user change function in the automation engine is being invoked frequently enough that logging the activity was causing very large log files. If you wish to restore those messages, comment out the following line in the RAFW_HOME/server/tomcat/conf/ file:

Use a number sign (#) as the comment character.


-genCloudPattern option no longer supported in rafwEnvBuild: With the current release, you use the Eclipse client to generate virtual system patterns (VSPs). The -genCloudPattern option has been removed from rafwEnvBuild.


Default OS_RAFW_HOME changed: In previous releases, the default value for OS_RAFW_HOME on UNIX and Linux target systems (such as AIX_RAFW_HOME) was /opt/RAFW. With the new release, the value is now /tmp/RAFW. The value for Windows target systems has not changed. You can change this default value by editing the file on the framework server in the RAFW_HOME path.


Resolving conflicts in template creation: When you use the Eclipse client to create a template from a configuration definition, the new template must pass a number of validation steps. The template can fail validation if any of the following conditions apply:

  • You select more than one scope of the same type
  • You select files from a second scope of the same type as the selected scope, even if that second scope is not itself selected
  • You select child scopes (such as  nodes and application servers) from a second scope of the same type as the selected scope, even if that second scope is not itself selected


Property name change for WebSphere Application Server Liberty profile: If you are using a WebSphere Application Server Liberty profile configuration properties file that was created in a previous version of Rational Automation Framework, you must make a manual change to the file before you regenerate the configuration definition file.

Open the configuration properties file (RAFW_HOME/user/preserve/envgen/ in an editor. Change the name of the LIBERTY_ENVIRONMENT property to ENVIRONMENT. Change the name of the LIBERTY_PROFILE_NAME property to CONFIGURATION.

Save the properties file and regenerate the configuration definition.


Generation process for new configurations creates four automation plans: With this release, when you create a configuration definition from scratch, the generator not only creates the RAFW_env_config plan to create the live configuration on the target system, but also creates the same three automation plans that are generated for an existing configuration:  RAFW_env_config_compare, RAFW_env_config_execute, and RAFW_env_config_import.


Configuration editor questions reorganized for ND managed nodes: The information center topic named "Configuration reference for managed nodes" lists a number of configuration editor questions for each managed node under the heading Questions for Stand-alone Server. Prior to release, these questions were reformatted. There are now two sections, one named Application Servers on this node and the other named Proxy Servers defined on this node.

For each application server on the node, provide a name in the Server name field.

For each proxy server, provide a server name in the Server name field and select a template from the WebSphere Proxy Server template list.


Problems validating the Rational Asset Manager repository URI: The Rational Asset Manager repository URI does not require the context root for the Rational Asset Manager GUI.  This is different from the Rational Team Concert repository URI which does require the context root.

For example, if your Rational Asset Manager server is at and your Rational Asset Manager web services are, then specify as the value for the repository URI.


Configuration not checked into source control because of "ambiguous workspace": Due to a problem with Rational Team Concert, if you accept the default value when creating a workspace, duplicate workspaces might be created. If two or more workspaces exist with the same name, regardless of who created them, the configuration is not checked in and a message that reads "Ambiguous workspace/stream" is written to the log.

Workaround: Do not use the default value when creating a Rational Team Concert workspace.


Rational Asset Manager and Rational Team Concert integrations not available on Windows: You can use Rational Asset Manager or Rational Team Concert to store configuration definitions for a Rational Automation Framework server on UNIX or Linux systems only.  The integrations with Rational Asset Manager and Rational Team Concert are not available for a Rational Automation Framework server running on Windows.


Use "-product" option when creating Liberty profile through the command line wizard: When creating a configuration definition for WebSphere Liberty profile through the command line wizard, do not use the Liberty profile option in the product list. For new configurations, the definition is created in the wrong directory. For existing configurations, the wizard fails.

Workaround: Start the rafwEnvBuild command with the "-product liberty" option.


Can't add WebSphere Application Server nodes to WebSphere Service Registry and Repository clusters: When you create a configuration definition for a WebSphere Service Registry and Repository cell, you can add only WebSphere Service Registry and Repository nodes to a cluster. At this time, you cannot add WebSphere Application Server or other types of nodes to the clusters.


Warnings in log after running integrateToBF: When you run integrateToBF createAll on a new installation of Rational Automation Framework, you might see "Missing required parameter 'env.uuid'" warnings in the catalina log file. You can ignore these warning messages.


Concurrent imports of the same cell cause deadlock: If you have two configuration definitions based on the same WebSphere Application Server cell, do not run the import automation plans from both configurations at the same time. Doing so can create a situation where neither plan completes.


Configure actions excluded for standalone servers: The following two configure actions are not included in the was_common_configure_all action for WebSphere Application Server cells with a standalone server:


The problem is related to the base installation code for WebSphere Application Server. If you have a cell with a standalone server that you created using WebSphere Application Server Network Deployment installation code, you can run these two actions separately after the was_common_configure_all action completes.


False positive result of configuration storage automation plans: When you run one of the "get" or "put" automation plans for either Rational Team Concert or Rational Asset Manager, the plan may fail while indicating success. These plans determine their success or failure using text filters to find specific strings within the command output. If none of these strings match, then the command is deemed successful. It is possible that the command was unsuccessful, and either returned an unexpected string or possibly no string at all.

When running a configuration storage automation plan, scan the output and verify that no errors were reported.


Administrative agent questions displayed for Network Deployment cells: When creating a WebSphere Application Server version 7.0, 8.0, or 8.5 configuration definition in the Rational Automation Framework console, it is possible to specify a “Standalone” cell type, answer “Yes” for administrative agent, and then change the cell type to “Network Deployment. “ In this case, the administrative agent setting remains "Yes".

Do not change from “Standalone” to “Network Deployment” if you have already set the administrative agent to “Yes”. If you have already made this change, delete the configuration definition and reenter the information.


Date does not change after VSP update: If you update a VSP from a template, but do not remove the VSP from IBM Workload Deployer and reload it, your changes show up in IBM Workload Deployer, but the displayed date of the VSP does not change.

No workaround is required, because the VSP is updated correctly.


The VSP generator creates a VSP with the wrong WebSphere Application Server version: When you generate a VSP from a template, the VSP in IBM Workload Deployer might have a different version of WebSphere Application Server than the template.

Edit the VSP in IBM Workload Deployer to replace the Operating System part with one that contains the correct version of WebSphere Application Server.


Generating with rafEnvBuild from older configuration properties files results in missing or incorrect values: Version 3.0.1 added a scope data file to the generation process. If you generate an older configuration properties file using the command line, that file is not available and errors can result.

Open the file in the configuration editor and generate it there.


Installing the Rational Automation Framework server from the launchpad console fails: The Rational Automation Framework installation process uses three ISO images: two for the server and one for the client. If you start the server installation process from one of the ISO images using launchpad and then select Install or Upgrade IBM Installation Manager, you might find that nothing happens.

You must extract the contents of both server ISO images into a common directory and then run launchpad from that directory.


Framework server fails to start due to missing password: If you upgraded from Rational Automation Framework version or earlier, you might not be able to start the framework server.

Edit {RAFW_HOME}/buildforge.propeties. Add a BF_ROOT_PASSWORD property and set it to the Rational Build Forge root user password. If you don't know the root password, and BF_USERNAME is set to root, you can copy the value from BF_PASSWORD to BF_ROOT_PASSWORD. Save the buildforge.propeties file and restart the framework server.


Configuration properties files can be lost during upgrades: If you upgrade from a version of Rational Automation Framework earlier than, configuration properties files ( are not copied from the old location (the RAFW_HOME/work directory) to the new location (the RAFW_HOME/user/preserve/envgen directory).

The preferred workaround is to back up the RAFW_HOME/work directory before you upgrade, and then copy the contents to the RAFW_HOME/user/preserve/envgen directory after the upgrade.

If you have already upgraded and lost your properties files, use the existing configuration option of the configuration editor to recreate the missing configuration definitions.


was_common_configue_sibus_all does not properly update Messaging bus entries: When you run was_common_configue_sibus_all in execute mode, the attributes are imported, but any changes to the sib.xml file are not propagated to WebSphere Application Server when executed.

Workaround: Delete the messaging engine and recreate it with the desired datasource attributes.


Possible confusion over name of was_common_configure_security_ssl action: The was_common_configure_security_ssl action corresponds to Security > SSL certificate and key management > SSL configurations in the WebSphere Application Server console. If you want the action that corresponds to Security > SSL certificate and key management > Dynamic outbound endpoint SSL configurations, which you use to import, execute, or work with changes, use the was_common_configure_security_global action.


WebSphere Application Server administrative console permits invalid characters in passwords: You can include the "$" and "&" characters in a password that you create through the WebSphere Application Server administrative console. However, if you then use that password in the Rational Automation Framework configuration editor, or any other process that uses a SOAP connection, the password will not be recognized.

The best workaround is to not create a password that uses invalid characters. You can still use a password with some invalid characters (such as "$" and "&") by prefacing them with a backslash, or by enclosing the entire password in single quotes.


The was_common_configure_start_cluster action times out: The was_common_configure_start_cluster action times out if the cluster fails to start within 30 minutes. This can be caused by a cluster that is simply very slow to start.

Workaround: Use the was_common_configure_ripple_start_cluster action instead. This action cycles through all the servers in the cluster, stopping and restarting each one in turn so that at least one server is available at all times to handle processing.


Eclipse client uses system browser to create configuration definition: In previous releases, the Eclipse client used an internal browser to display the Environment Generation wizard. With the current release, configuration definitions are created in the new console interface. When you click "Create Configuration Environment" in the Eclipse client, the console is displayed in the system browser rather than the internal Eclipse browser.

Change history

What's new

No new features or functions.

Click the link in the Download Options column:

Download RELEASE DATE LANGUAGE SIZE(Bytes) Download Options
What is Fix Central(FC)?
RAF downloads and fixes 26 Sep 2014 English 1 FC

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, HP-UX, Linux, Solaris, Windows, iOS, z/OS

Reference #: 4038245

Modified date: 26 September 2014