Action:

was_common_deploy_install_rar

Summary:

Installs resource adapter archive (RAR) file format to a single node. Provide -a <RAR_FILE_NAME> when calling this action to specify which RAR file should be installed.

A properties file which describes options for resource adapter deployment must be named <RAR_FILE_NAME>.properties and supplied under: <node path>/resourceAdapters/properties [1] The resource adapter RAR file to deploy is required under: <node path>/resourceAdapters/media [1]

Promote mode copies <RAR_FILE_NAME>.properties from the scope specified in the -opt parameters into the current scope passing through a filter. [7][8]

The media file given by RAR_FILE is copied from the scope specified in the -opt parameters into the current scope. [7]

Required Data:


Copy resource adapter rar file to the following location: [2]
<node path>/resourceAdapters/media [1]

Create and populate a properties file for the adapter in the following
location:
<node path>/resourceAdapters/properties [1]

Use the samples file as a template:
<RAFW_HOME>/samples/xml/was/common/resourceAdapter.properties

Enter the following values:
RAR_NAME Resource Adapter RAR file name without extension
RAR_FILE Resource Adapter RAR file path
        

Supported Modes:

execute, promote

Supported Scopes:

node

Notes:


This is an AdminTask-based action and, as such, does not support the
AdminConfig export/import features.

[1] The scope home is relative to the environment tree path:
RAFW_HOME/user/environments.

cell path: ENV_NAME/cells/CELL_NAME
cluster path: <cell path>/clusters/CLUSTER_NAME
node path: <cell path>/nodes/NODE_NAME
server path: <node path>/servers/SERVER_NAME

[2] The .rar extension is required on the RAR file to be deployed.

[3] The Node Agent must be running before installing resource adapters.

[7] Refer to the Rational Automation Framework
Information Center for more information on using
-opt to specify source scope.

[8] Refer to the Rational Automation Framework
Information Center for more information on promote mode filters.

Related Actions:


was_common_configure_start_nodeagent
was_common_configure_j2c_resource_adapters
was_common_configure_j2c_conn_factories