+

Search Tips   |   Advanced Search

Update a stand-alone resource adapter archive

Use the resource adapter archive (RAR) update wizard to update the stand-alone RAR files to a newer version. The application server uses the classes and other code that comprise a resource adapter archive to support the resource adapters configured.

A resource adapter must be installed on the application server, and you must have a new version of the resource adapter that is compatible with the old version. We can create the RAR file with an assembly tool, or the vendor for the resource adapter can provide the new version. If the new version of a RAR file is not compatible with the old version of the resource adapter, an update is not possible.

The Java Connector Architecture (JCA) Version 1.6 specification adds support for Java annotations in RAR modules. For more information on annotation support and metadata, see the topic JCA 1.6 support for annotations in RAR modules.

Update a RAR file when you determine that a resource adapter or a set of resource adapters needs to be updated with a different version. Different versions of resource adapters can include different settings, so updating the adapter might be beneficial if you require a certain set of configuration options.

It is the choice to update the resource adapter for all the nodes in a cell or all the nodes in a cluster. If some of the nodes are earlier than Version 7.0, the RAR update is not supported until those nodes are migrated to Version 7.0. Updates to JCA 1.6 adapters are only applicable to a v8.5 node.

If we prefer to have more than one version of a resource adapter active in a given Java Virtual Machine (JVM), the update wizard does not provide the option of creating another version and keeping the old. In this case, create an isolated resource adapter and configure it accordingly. Refer to the topic on configuring a resource adapter for more information.

  1. Save all configuration changes.

  2. Back up the configuration settings with the backupConfig tool. The backupConfig tool is located in the app_server_root/bin directory. Read the topic on the backupConfig command for more information about how to use this command.

  3. Synchronize any of the nodes to update.

  4. Ensure that the node agents are running if they are associated with the resource adapter that you are updating.

  5. Stop any servers containing the RAR file that is updated.

    We must stop all the servers in the node or cluster to which the RAR file is associated.Refer to the topic, Administering applications and their environment, for information about how to stop or start an application server.

  6. Click Resources > Resource Adapters > Resource Adapters.

  7. Select the check box next to the RAR file to update, and click Update RAR.

  8. Installation path for the RAR file, and click Next.

    • If the RAR file is located on the same workstation as your browser, select Local file system, and browse to find the file.

    • If the RAR file is located on the server workstation where the application server is installed, select Remote file system, and specify the fully qualified path to the file.

  9. Review the configuration information provided for the RAR file. The following information is displayed for the RAR file:

    • Name

    • Current RAR version

    • New RAR version

    • Scope

    • Any existing copies of the resource adapter. The resource adapters with an asterisk (*) are copies of the resource adapter and must also be updated at the same time.

    Click Next when we are finished.

  10. Optional: Edit any properties that were added by the new version of the resource adapter. We can also edit these properties after completing the update.

    1. Select a resource in the list to edit the new properties. Only resources with new properties are included in the list.

    2. Edit the resource properties. Use the table provided to set the values for new properties of the selected resource.

      • Select the Set for all check box to apply the property value to all the resources of the same type.

      • Click the Reset to Default button to reset all the properties to the default values defined in the RAR file. This property reset only affects the selected resource.

    3. Click Next.

  11. Review the summary panel, and click Finish when we are satisfied with the configuration settings. When you click Finish, all the configuration changes are saved automatically. To revert to an older version of the resource adapter perform the update process again, and specify the older version of the RAR file.

  12. Restart the servers containing the updated RAR file.


What to do next

If we are not satisfied with the results, and you backed up the configuration with backupConfig tool, use the restoreConfig tool to restore the backup configuration. Read the topic on the restoreConfig command for more information about how to use this command.


Subtopics


Related concepts

  • Relational resource adapters and JCA


    Related tasks

  • JCA 1.6 support for annotations in RAR modules
  • Administer data access applications
  • Configure resource adapters
  • Install a resource adapter archive
  • Install resource adapters embedded within applications
  • Configure new J2C resource adapters

    Resource adapters collection

  • restoreConfig command
  • backupConfig command