WAS v8.5 > Administer applications and their environment > Welcome to administering Data access resources > Administer data access applications

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 that you configure.

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) v1.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 we 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 your adapter might be beneficial if you require a certain set of configuration options.

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 your 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. Click Resources > Resource Adapters > Resource Adapters.

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

5. Specify the installation path for the RAR file, and click Next.

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

   • If wer 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.

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

7. 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 that are defined in the RAR file. This property reset only affects the selected resource.

   3. Click Next.

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

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

Subtopics

• RARUpdate command group
  Use the resource adapter archive (RAR) update wizard to upgrade the RAR module and property configuration of J2C Resource Adapters. The application server uses the classes and other code that comprise a resource adapter archive to support the resource adapters that you configure.

Related concepts:

Relational resource adapters and JCA

Related

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 using wsadmin.sh

Reference:

Resource adapters page
restoreConfig command
backupConfig command

+

Search Tips   |   Advanced Search