Installing the resource adapter on WebSphere Application Server

Use the WebSphere® Application Server administrative console to deploy the IMS TM resource adapter RAR file.

Before you begin

Important:
  1. If you are installing the IMS TM resource adapter archive (RAR) on a generic application server, additional class libraries might be needed for use with the IMS TM resource adapter. For class libraries that are not included in the IMS TM resource adapter installation archive, contact your product representative for the development environment of your choice for information regarding the licensing and location of any needed JAR files.
  2. When you use the Install RAR dialog to install a RAR file, the scope you define on the Resource Adapters page has no effect on where the RAR file is installed. You can install RAR files only at the node level, which you specify on the Install RAR page. To set the scope of an RAR file to a specific cluster, or server, after you install the RAR file at each node level, create a copy of the RAR file with the appropriate cluster or server scope.
Prerequisites:
  • You must have installed the IMS TM resource adapter RAR to a file system that is accessible to your WebSphere Application Server.
  • Start the WebSphere Application Server and log in to the administrative console.

About this task

To deploy the RAR on a WebSphere Application Server:

Procedure

  1. In the navigation pane in the administrative console (also known as the Integrated Solutions Console), click Resources > Resource Adapters > Resource adapters.
    Figure 1. Resource adapter configuration in WebSphere Application Server
    This figure shows the resource adapter configuration screen in the Integrated Solutions Console in WebSphere Application Server.
  2. If a RAR that you no longer want to use is already installed, delete it first. Stop and restart the WebSphere Application Server. Repeat the previous step to return to the resource adapter configuration page.
  3. In the content pane, click Install RAR.
    You might need to scroll down in the pane to locate the button.
    The Install RAR File page displays.
  4. Click Local file system or Remote file system, depending on the location of the RAR file.
    • If you choose Local file system, click Browser to locate and specify the IMS TM resource adapter RAR file that is installed, for example, install_path/IBM/IMS/ICOxx/Vxxxx/JCA15/imsxxxx.rar.
  5. Click Next.
  6. On the Configuration page, type a name for the RAR, for example, imstmravxxxx. Click OK.
  7. Optionally, create a copy of the RAR file with a different scope level. After you install the RAR file at each node level, you can create another copy of the file that has a specific server or cluster as the scope for that file. See Installing a resource adapter archive.
  8. To save your results in the master configuration, click Save at the top of the panel.

Results

The IMS TM resource adapter runtime RAR file is deployed.

You can proceed to create a connection factory for the IMS TM resource adapter.