Network Deployment (Distributed operating systems), v8.0 > Administer applications and their environment > Administer 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 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 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 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 your adapter might be beneficial if you require a certain set of configuration options.
It is your choice to update the resource adapter for all the nodes in a cell or all the nodes in a cluster. If some of your nodes are earlier than v7.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.0 node.
If you 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.
Procedure
- Save all configuration changes.
- Back up the configuration settings with the backupConfig tool. The backupConfig tool is located in the WAS_HOME/bin directory. Read the topic on the backupConfig command for more information about how to use this command.
- Synchronize any of the nodes to update.
- Ensure that the node agents are running if they are associated with the resource adapter that you are updating.
- Stop any servers that contain 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.
- Click Resources > Resource Adapters > Resource Adapters .
- Select the check box next to the RAR file to update, and click Update RAR.
- Specify the installation path for the RAR file, and click Next.
- If your RAR file is located on the same workstation as your browser, select Local file system, and browse to find the file.
- If your 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.
- 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 you are finished.
- 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.
- Select a resource in the list to edit the new properties. Only resources with new properties are included in the list.
- 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.
- Click Next.
- Review the summary panel, and click Finish when you 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.
- Restart the servers that contain the updated RAR file.
What to do next
If you are not satisfied with the results, and you backed up the 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.
Relational resource adapters and JCA
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
Related
Resource adapters collection
restoreConfig command
backupConfig command