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.
To avoid problems, use the administrative console RAR update wizard. For more information, see the topic Updating a resource adapter archive.
compareResourceAdapterToRAR
The compareResourceAdapterToRAR command determines whether a resource adapter is compatible with a new RAR file. A resource adapter may be updated with a RAR only when the two are compatible.
Target object
Resource adapter Object ID - The configuration object of the resource adapter that will be compared for update.Result
The command returns true if the resource adapter is compatible with the specified RAR. It also displays the versions of the resource adapter and new RAR file. If the resource adapter is not compatible with the specified RAR, then the command returns false and provides a message explaining why they are not compatible.Required parameters
- The absolute path to a RAR file. (String, required)
Examples
Batch mode example usage:
AdminTask.compareResourceAdapterToRAR("Test Resource Adapter(cells/cell/nodes/node|resources.xml#J2CResourceAdapter_1169157308943"),
'[-rarPath "c:\tra\rar\TRA.rar"]')
getNewRAObjectProperties
The getNewRAObjectProperties command obtains the list of new properties within a RAR file that may be configured when updating a resource adapter.
Target object
Resource adapter Object ID - The configuration object of the resource adapter that will be updated.Result
You receive the list of new properties that may be configured on the resource adapter when updating a RAR.Required parameters
- The absolute path to a RAR file. (String, required)
- The type of value to return, String or “Hashtable. When returnType is “String, the command returns a String intended for input to the updateRAR command; if returnType is “Hashtable“, then the command returns a java.util.Hashtable which is intended for use with the Admin console. The returnType defaults to String. (String, optional)
Examples
findOtherRAsToUpdate
The findOtherRAsToUpdate command locates other resource adapters in the configuration that are similar to the resource adapter to be updated. The resulting resource adapters should also be updated.
Target object
Resource adapter Object ID - The configuration object of the resource adapter that is compared for update.Result
The command returns a list of resource adapter Object ID Strings that can be input as the target object of RARUpdate commands.Examples
updateRAR
The updateRAR command updates the RAR and configuration of a resource adapter at a specific scope.
Target object
Resource adapter Object ID - The configuration object of the resource adapter that is updated.Result
This command returns a message of success or failure upon completion.Required parameters
- The absolute path to the new RAR file. (String, required)
Optional parameters
- A list of [name value] pairs of new properties to set on the ResourceAdapter
implementation class. You can specify the following parameters for
this step:
- The name of the resource adapter property. (String, optional)
- The value of the resource adapter property. (String, optional)
- A list of [id name value] triplets of new properties to set on
the connection factories in the resource adapter configuration. You
can specify the following parameters for this step:
- The Java Naming and Directory Interface (JNDI) name of the connection factory. (String, optional)
- The name of the connection factory property. (String, optional)
- The value of the resource adapter property. (String, optional)
- A list of [id name value] triplets of new properties to set on
the activation specifications in the resource adapter configuration.
You can specify the following parameters for this step:
- The Java Naming and Directory Interface (JNDI) name of the activation specification. (String, optional)
- The name of the activation specification property. (String, optional)
- The value of the activation specification property. (String, optional)
- A list of [id name value] triplets of new properties to set on
the administered objects in the resource adapter configuration. You
can specify the following parameters for this step:
- The Java Naming and Directory Interface (JNDI) name of the activation specification. (String, optional)
- The name of the administered object property. (String, optional)
- The value of the administered object property. (String, optional)
Examples
Batch mode example usage:
Interactive mode example usage: