IBM Support

Rational Host Access Transformation Services 8.0.0.2 release information

Release Notes


Abstract

The release information for IBM Rational Host Access Transformation Services 8.0.0.2 contains information about new functionality, pointers to important documentation and provides a list of known problems.

Content

This release information includes the following content about Rational Host Access Transformation Services version 8.0.0.2:



About this release

Rational Host Access Transformation Services version 8.0.0.2 includes the following extensions:
  • Apache Geronimo

With HATS V8.0.0.2 you can develop, test, and deploy HATS web applications targeted
for the Apache Geronimo web application server with the Tomcat web container.
For detailed information about Apache Geronimo, including documentation and downloads,
see Welcome to Apache Geronimo.

Below is a summary of how to install Apache Geronimo and configure Rational Software
Delivery Platform (Rational SDP) to enable creating HATS web applications targeted for Apache Geronimo servers:

Download and install the Apache Geronimo server with the Tomcat web container:
  1. Download Apache Geronimo from Downloads
  2. Install the server by extracting the .zip or .tar files.
  3. Run the server from a command line window by changing the directory to geronimo_home/bin and entering the command: geronimo run

The Geronimo Eclipse Plugin (GEP) provides integration between Eclipse, its Web Tools Platform (WTP) project, and Geronimo that enables you to utilize WTP features to develop, test, and deploy applications for the Apache Geronimo server using Rational SDP.

Install the Geronimo Eclipse Plugin (GEP):
  1. Follow the instructions at Installing Geronimo Eclipse Plugin.
  2. GEP v2.2 includes server adapters for v1.1.x, v2.0.x, v2.1.x, and v2.2 Apache Geronimo servers.

Configure Geronimo as a target server in Rational SDP for HATS web applications:

  1. On the Rational SDP menu bar, click Window > Preferences.
  2. In the left panel, expand Server.
  3. Click on Runtime Environments.
  4. In the Server Runtime Environments panel, click Add.
  5. In the New Server Runtime Environment dialog, expand the Apache folder.
  6. Select the appropriate version of the Apache Geronimo server.
  7. Optional. Select the Create a new local server box to create a new Geronimo server on your workspace Servers tab. Doing this step enables you to test your Geronimo application within the Rational SDP local test environment using the Run on Server, Debug on Server, and Profile on Server functions.
  8. Click Next to go to the panel where you point to your local Geronimo server. In the Application server installation Directory field enter the root folder where you extracted the Geronimo server files. For example, if you extracted your Geronimo server zip to a folder named C:\geronimo-tomcat6-javaee5-2.1.7, enter this value in the installation directory field.
  9. Click Finish.
  10. Click OK to close the Preferences panel.

After following these steps, you can create HATS applications within Rational SDP targeted for Apache Geronimo servers.

For information about which releases of Apache Geronimo are supported, see Rational Host Access Transformation Services V8.0 - Detailed System Requirements.

For up-to-date support considerations, see Rational Host Access Transformation Services 8.0 - Known issues and workarounds.


  • Android devices

With HATS V8.0.0.2 you can create web applications that extend access to your host applications from Android devices.

For information about which mobile web browsers are supported, see Rational Host Access Transformation Services V8.0 - Detailed System Requirements.

For up-to-date support considerations, see Rational Host Access Transformation Services 8.0 - Known issues and workarounds.


  • Google Chrome

HATS web browser support is extended to include Google Chrome. This includes support for HATS web and portlet applications. WebFacing applications are not supported.

For information about which releases of Google Chrome are supported, see Rational Host Access Transformation Services V8.0 - Detailed System Requirements.

For up-to-date support considerations, see Rational Host Access Transformation Services 8.0 - Known issues and workarounds.





Fixed APARs in this release


APARs that are fixed in this release are in the Fix list document.



Product documentation

For complete documentation, including installation instructions, review the Information Center.



Software and hardware requirements


Review the detailed system requirements document at
Detailed System Requirements for Rational Host Access Transformation Services 8.0



Access the software
Access the Rational Host Access Transformation Services 8.0 Download document.


Installation information

This section describes how to install IBM Rational Host Access Transformation

Services (HATS) Fix Pack V8.0.0.2, which contains all fixes available since HATS Version V8.0 was first released. This fix pack is provided as an update and installed using IBM Installation Manager. The update is generally installed directly from the IBM update server; however you can also choose to download an archive file that contains the update and then use IBM Installation Manager to perform local installations. The following sections describe how to install this update.

Installation prerequisites
Update installation instructions
Archive download for local installation instructions
Verifying your installation
HATS project updates
Installing the HATS runtime plug-ins into your rich client platform

Installation prerequisites

Installation of this fix pack requires the following:

  • Any prior level of HATS V8.0 is installed.
  • IBM Installation Manager is installed, and it is updated to the latest level.
If either of these requirements is not satisfied, HATS will not appear in the Update installation instructions selection list.

For more information about HATS prerequisites, refer to the Rational Host Access Transformation Services V8.0 - Detailed System Requirements.

Update installation instructions

Follow the steps below to install the update. You should perform the installation using the same Windows account that originally installed the Host Access Transformation Services (HATS) V8.0 product. The account must have administrator privileges.

To install directly from the IBM update server:

  1. Start IBM Installation Manager from the Windows Start menu. By default this is under Start > All Programs > IBM Installation Manager > IBM Installation Manager.
  2. From the menu bar, select File > Preferences.
  3. Ensure that the Search service repositories during installation and updates. option is selected to allow updates from the IBM Update Server. Click OK to return to the IBM Installation Manager screen.
  4. Select the package group in which you installed IBM Host Access Transformation Services V8.0. The default is IBM Software Delivery Platform. The Installed Packages list at the bottom of the panel should show IBM® Rational® HATS 8.0 as one of the entries. Click Next.
  5. Select IBM Rational HATS 8.0 and Version 8.0.0.2 and any other required or optional updates from the list of available updates. Any updates you already have installed will be displayed in grey and will not be selectable. Click Next.

    Note: The Repository will not be as displayed but will indicate the IBM Update Server.

  6. Read and accept the license agreements for the selected updates, and then follow the remaining installation dialogs to install the selected updates.
    Note: Depending on the speed of your computer processor, the amount of RAM, and the speed of your Internet connection, the update(s) could take an extended period of time to download and install.
  7. Review your selections on the Summary panel. If you want to make any changes to your selections, click Back and make your changes. When you are ready to install the update, click Update.
  8. When the updates are complete, a message will be displayed by IBM Installation Manager informing you that updates were successfully installed. You can click View Log File to view the log file for the current Installation Manager session. When you are finished, click Finish.
  9. Exit IBM Installation Manager and start IBM Rational Host Access Transformation Services from the Windows Start menu to begin using the product. By default this is under Start > All Programs > IBM Software Delivery Platform > IBM Rational Host Access Transformation Services.

Archive download for local installation instructions

Ideally, this update should be installed directly from the IBM update server, as described in the Update installation instructions section above. However, you may also download an archive file containing the update and perform local installations. You might want to do this if:

  • You have a slow or unstable Internet connection and want to use a download manager that can resume the download.
  • You have difficulty accessing the live IBM update servers from behind a firewall.
  • You prefer to download the update and install it later.
  1. Download the HATS_8.0.0.2.zip file from the download page to your system. This download page will redirect you to the zip file stored on IBM's Download Support Portlet known as Fix Central. As you continue to download, you are prompted to log in using your IBM ID. If you do not have an ID, click register now to request one.
  2. Unzip the HATS_8.0.0.2.zip file to a temporary directory.
  3. Start IBM Installation Manager from the Windows Start menu. By default this is under Start > All Programs > IBM Installation Manager > IBM Installation Manager.
  4. From the menu bar, select File > Preferences This is where you will tell the IBM Installation Manager the location of the installation files you just extracted.
  5. Click Add Repository in the Preferences dialog.
  6. In the Add Repository panel, click Browse.
  7. In the Select a Repository panel, browse to the directory where you extracted the update installation files. Inside that directory you will see a hats\updates folder. Change to that directory, select repository.config and click Open.
  8. In the Add Repository panel, click OK.
  9. Click Test Connections in the Preferences dialog and ensure that the repository can be found.
  10. Click OK.
  11. Now that the local repository has been set, follow the instructions outlined in the Update installation instructions.

Verifying your installation

You can verify that the update is installed by running View Installed Packages which is located on the Installation Manager menu bar under the File menu. You should see IBM® Rational® HATS_8.0.0.2 listed.

After installing the HATS maintenance and restarting the Rational Toolkit, the HATS projects in the current workspace are automatically updated with the new files.

HATS project files overwritten by the installation of HATS maintenance are saved. If HATS maintenance is uninstalled or disabled, HATS projects are not automatically restored to their former state. We recommend that you back up your existing HATS projects using a code repository or export them as zip files before applying HATS maintenance. See HATS project updates for more information.

If your workspace contains rich client applications, see Installing the HATS runtime plug-ins into your rich client platform for important information.

HATS project updates

The project update process creates a backup folder in the project named save_pre_8.0.0.2. This folder contains all of the files that were overwritten by the package update process. These files are saved so that you can compare and merge them with your newly installed HATS files. Do not worry if you see errors in the task view; these files are no longer used by the application. When you are satisfied that all the saved files have been compared and merged, you can delete the save_pre_8.0.0.2 folder.

Note:

If you need to roll back to this version of HATS in the future, the files in this folder are required to perform the roll back. See Removing installed maintenance for more information.

Installing the HATS runtime plug-ins into your rich client platform

After applying a HATS service update, if you have changed the target platform of your workspace (Window > Preferences > Plug-in Development >Target Platform) from the default Rational Software Delivery Platform, you are prompted to install the HATS runtime features and plug-ins into your target platform the first time you start RSDP. For example, if the target platform of your workspace is Lotus Expeditor, you are prompted to install the updated HATS runtime plug-ins into this platform. After the plug-ins are installed, you are prompted to reload the target platform using the Window > Preferences > Plug-in Development >Target Platform panel.

Applying a service update to a client

To apply a service update to a client that already has a HATS rich client application installed, follow the instructions in the HATS User's and Administrator's Guide for Exporting the HATS runtime features. This exports the updated versions of the HATS runtime features and plug-ins. To make these updates available to a client, you can either modify your existing update site to include the updated features, or you can create a new update site. See Creating an update site in the User's and Administrator's Guide for more information. Because a HATS service update does not update your rich client projects, there is no need to re-export or re-install your HATS rich client applications.

If you used the New Product Configuration wizard to create a product package that includes Eclipse, HATS runtime plug-ins, and its dependencies, you need to regenerate this package and distribute it to your client machines. Instructions for creating a new product configuration can be found in the Packaging an Eclipse client environment for distribution section of the HATS User's and Administrator's Guide. There is no automated way to update plug-ins within an Eclipse environment that was packaged using the steps provided in the HATS User's and Administrator's Guide. This is a known issue.


Uninstalling the Fix pack

You can remove installed HATS maintenance by selecting Roll Back from the

IBM Installation Manager main panel. Use the rollback feature if you have applied an update to a product package, and decide later that you want to remove the update and revert to the earlier version of the product. Installation Manager uninstalls the updated resources, and reinstalls the resources from the previous version. When you roll back to a previous version, it is restored with same features that were associated with the version.

During the rollback process, Installation Manager must access files from the earlier version of the package. By default, these files are stored on your system when you install a package. If you changed the default setting or deleted the files on the Roll Back preferences page, Installation Manager will require access to your installation repository or media. If you installed the product from a repository, you must have listed the repository from which you installed the previous version of the product in your repository preferences (File > Preferences > Repositories). To roll back your installation to a previous version:

  1. Start IBM Installation Manager from the Windows Start menu. By default this is under Start > All Programs > IBM Installation Manager > IBM Installation Manager.
  2. Click Roll Back.
  3. Select the package group in which you installed IBM Rational Host Access Transformation Services. The default is IBM Software Delivery Platform. The Installed Packages and Fixes list at the bottom of the panel should show IBM® Rational® Host Access Transformation Services V8.0.0.2 as one of the installed packages in the package group you selected. Click Next.
  4. The Roll Back Packages panel will show you the previous versions of Rational Host Access Transformation Services to which you can roll back. Select the version to which you would like to roll back. If there are no previous versions listed, you cannot roll back your installation. If you cannot roll back to a previous version without invalidating your current configuration, Installation Manager will display an error message at the top of the Packages panel and you will not be allowed to continue. If you are unable to roll back your installation, you will need to uninstall the entire IBM Rational Host Access Transformation Services product in order to uninstall Fix Pack V8.0.0.2. If you are able to roll back, click Next.
  5. Review your selections on the Summary panel. If you want to make any changes to your selections, click Back and make your changes. When you are ready to roll back the update, click Roll Back.

When you roll back HATS, HATS projects are not automatically restored to their previous level. See Manually restoring your workspace for more information.

Manually restoring your workspace

Following a roll back of installed HATS maintenance, to manually restore your workspace to the state before HATS maintenance was installed, follow these steps:

  1. Shut down Rational Toolkit.
  2. Restore your HATS projects by copying the files in the save_pre_8.0.0.2 folder back to their original locations.
  3. Restore your HATS EAR projects:
    1. Copy RSDP_shared_dir/plugins/com.ibm.hats_8.0.x\product.xml to the following locations:
      1. Each HATS EAR project
      2. Each RCP runtime extension project, if you have rich client applications
      3. Each HATS web application linked to a WebFacing application for interoperability
        Note: The product.xml file must be renamed to hats_product.xml.
      where RSDP_shared_dir is the shared directory under the installed RSDP product, and 8.0.x.x is the version you want to restore. The default for RSDP_shared_dir is C:\Program Files\IBM\SDPShared.
    2. Copy the following files from RSDP_shared_dir/plugins to the root of each EAR project, where 8.0.x.x refers to the target version of the HATS rollback:
      • com.ibm.hats.core_8.0.x.x/lib/bidibean.jar
      • com.ibm.hats.core_8.0.x.x/lib/hatscommon.jar
      • com.ibm.hats.core_8.0.x.x/lib/hatsruntime.jar
      • com.ibm.hats.core_8.0.x.x/lib/hodwel.jar
      • com.ibm.hats.core_8.0.x.x/lib/ibmjlog.jar
      • com.ibm.hats.core_8.0.x.x/lib/HatsService.jar
      • com.ibm.hsrendering_8.0.x.x/hsrendering.jar
      • com.ibm.eNetwork.beans.HOD_11.x.x.x/habeansnlv2.jar
      • com.ibm.etools.iseries.wfcommon_1.x.x.x/runtime/WFCommon.jar
      • com.ibm.etools.hasslite_1.0.x.x/hasslite.jar
      • com.ibm.hostsim_8.0.0.x/hostsim.jar
  4. Reset the maintenance flag in the HATS preferences file:
    1. Edit the RSDP_shared_dir\plugins\com.ibm.hats_8.0.x\product.xml. Copy the build date to the system clipboard. The build date is included in the <date> tag under the <build> tag.
    2. Edit the workspace_dir\.metadata\.plugins\org.eclipse.core.runtime\.settings\com.ibm.hats.prefs file, where workspace_dir is your workspace folder. The default for workspace_dir is C:\Documents and Settings\user\IBM\rationalsdp\workspace.
      Replace the value for the projectBuildDate keyword with the date you copied from the <date> tag under the <build> tag in the product.xml file.
    3. Save the file.




Known problems


For up-to-date support considerations, see Rational Host Access Transformation Services 8.0 - Known issues and workarounds.





IBM Rational Software Support

Tab navigation

IBM Rational Software Support Communities

  • Support Portal: Click the Support Portal tab above to begin configuring your support portal experience to review FAQs, lists of known problems, fixes, and a wealth of important support information.
  • developerWorks: Click the developerWorks tab above 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.
  • Jazz Community: Click the Jazz Community tab above if you are using one of the Rational tools created using the Jazz platform to interact directly with the Jazz development teams and other community members, download product trials and betas and track development 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.


[{"Product":{"code":"SSXKAY","label":"IBM Host Access Transformation Services"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"Documentation","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF012","label":"IBM i"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z\/OS"}],"Version":"8.0.0.2","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
02 August 2018

UID

swg27024555