Use the resource adapter archive (RAR) update wizard to
update 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.
Before you begin
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. You 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.
About this task
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 Version 7.0, the RAR
update is not supported until those nodes are migrated to Version 7.0.
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, you need to 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 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.
- 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.
You
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 .
- 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 that is 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. You 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
that is 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 you must 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 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.