Installing the resource adapter on WebSphere Liberty servers

Download the IMS TM resource adapter RAR file and set up the WebSphere Application Server Liberty Profileenvironment before you install the resource adapter.

Before you begin

The following software is required:
  • IMS TM Resource Adapter Version 13 or later runtime package for WebSphere Liberty Profile
  • WebSphere Application Server Version 8.5.5.4 Liberty Profile or later, with the JCA feature installed
Prerequisites:

  1. Your WebSphere Liberty server runtime environment must be properly installed and set up.

    Download the JCA Connection Architecture 1.6 feature. For details and download options, see WebSphere Liberty for developers.

  2. Download the IMS TM resource adapter runtime component archive file for WebSphere Application Server Liberty Profile from the IMS TM resource adapter download site. Select the version of the runtime offering that you want to use, and then select the IMS TM Resource Adapter vxxxx runtime component for WebSphere Liberty Profile.

About this task

To install the IMS TM resource adapter, you need to edit the server.xml file.WebSphere Application Server Liberty Profile does not provide a graphical administrative console. In general, you can use WebSphere Application Server Developer Tools for Eclipse or a text editor to edit the server.xml file.

Procedure

To install the resource adapter, take the following steps:

  1. Open the server.xml file of your WebSphere Liberty server instance in your editor.
  2. Enable the JCA 1.6 and JNDI 1.0 features by adding these features to the <featureManager> section: 
    <featureManager>
   ...
   <feature>jca-1.6</feature>
   <feature>jndi-1.0</feature>
   ...
</featureManager>
  3. Install the IMS TM resource adapter by adding a <resourceAdapter> entry: 
    <resourceAdapter id="IMS_adapter_id" location="IMS_adapter_RAR_file_location">

    IMS_adapter_id is used to differentiate the resource adapter from other resource adapters that are installed. This value is used later when you configure the connection factory to connect to IMS.

    IMS_adapter_RAR_file_locationn is the absolute path, including the resource adapter filename, to the IMS TM resource adapter RAR file.

    The server.xml might look as follows:
    <server description="myLibertyServer">
   <!-- Enable features -->
   <featureManager>
      <feature>jsp-2.2</feature>
      <!-- Added jca-1.6 and jndi-1.0 features required by the IMS 
           TM resource adapter -->
      <feature>jca-1.6</feature>
      <feature>jndi-1.0</feature>
   </featureManager>
   
   <!-- To access this server from a remote client add a host attribute
    to the following element, e.g. host="*" -->
   <httpEndpoint id="defaultHttpEndpoint" httpPort="9080"
    httpsPort="9443" />

    <resourceAdapter id="IMSTMRA" 
     location="C:\IBM\IMS\ico1410\IBM\IMS\ICO14\V1410\JCA15\imsico1410.rar" />

</server>
    In this example, IMSTMRA is the resource adapter ID, and it points to the imsico1410.rar file.
  4. Save your changes.
  5. Start your WebSphere Libertyserver.

Results

The following J2CA7001I message is issued in the console, indicating a successful installation.
J2CA7001I: Resource adapter imsicoxxxx installed in 0.735 seconds.

What to do next

Next, you need to configure a connection factory to connect to your IMS host system.