+

Search Tips   |   Advanced Search

RARUpdate command group


Use the resource adapter archive (RAR) update wizard to upgrade the RAR module and property configuration of J2C Resource Adapters. The appserver 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 admin console RAR update wizard.

See the topic Updating a resource adapter archive.

The RARUpdate command group contains the following commands:

 

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

-rarPath

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

-rarPath

The absolute path to a RAR file. (String, required)

-returnType

The type of value to return, "String" or "Hashtable". When returnType is "String", the command returns a String inteded 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

Batch mode example usage:

 

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 will be compared for update.

Result The command returns a list of resource adapter Object ID Strings that may be input as the target object of RARUpdate commands.

Examples

Batch mode example usage:

 

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 will be updated.

Result This command returns a message of success or failure upon completion.

Required parameters

-rarPath

The absolute path to the new RAR file. (String, required)

Optional parameters

-ResourceAdapterProps

A list of [name value] pairs of new properties to set on the ResourceAdapter implementation class. We can specify the following parameters for this step:

-name

The name of the resource adapter property. (String, optional)

-value

The value of the resource adapter property. (String, optional)

-ConnectionFactoryProps

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:

-id

The JNDI name of the connection factory. (String, optional)

-name

The name of the connection factory property. (String, optional)

-value

The value of the resource adapter property. (String, optional)

-ActivationSpecProps

A list of [id name value] triplets of new properties to set on the activation specifications in the resource adapter configuration. We can specify the following parameters for this step:

-id

The JNDI name of the activation specification. (String, optional)

-name

The name of the activation spec property. (String, optional)

-value

The value of the activation spec property. (String, optional)

-AdminObjectProps

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:

-id

The JNDI name of the activation specification. (String, optional)

-name

The name of the administered object property. (String, optional)

-value

The value of the administered object property. (String, optional)

Examples

Batch mode example usage:

Interactive mode example usage:





 

Related tasks


Updating a resource adapter archive