Adapter deployment follows the JCA specification.
The references refer to chapter 10 of the document J2EE Connector Architecture Specification, Final Version 1.0.
You can download this document at java.sun.com/j2ee/connector.
Third-party adapters are deployed as follows:
A bundled deployment scenario of the Adapter Framework with a third-party adapter is not supported.
The JCA specification allows two mechanisms for the ConnectionFactory JNDI lookup, based on a serializable class or on a referenceable class. Although the Adapter Framework only uses one of the two classes, you must adhere to the JCA specification and implement both.
There is an example for each of the mechanisms described below:
More information: com.sap.aii.adapter.sample.ra.rarin SAPXIAF<SP>_<HF>.sca
<SP> stands for Support Package number; <HF> stands for hotfix number.
Not supported at present.
More information: sample_ra.sdain SAPXIAF<SP>_<HF>.sca
The following deployment options are available:
SUM is part of the Software Logistics Toolset shipment and is available as a download at:
You can find the SUM documentation on SAP Service Marketplace at: . .A valid SCA for a resource adapter consists of the following files in the SCA:
File Name | Use |
---|---|
RAR file |
|
MANIFEST.MF with path META-INF |
Contains the version numbers and the provider names. More information: SAPXIAF<SP>_<HF>.sca, MANIFEST.MF |
SAP_MANIFEST.MF with path META-INF |
Contains version numbers, content, and component names, similar to a catalog. The Software Update Manager (SUM) uses the information to manage deployment information in its database. More information: SAPXIAF<SP>_<HF>.sca, SAP_MANIFEST.MF |
The SAP NetWeaver migration controller only accepts SCA files.
This is relevant if you have already shipped an adapter with a previous release.
You can deploy the RAR file immediately, without having to use any other tools.
SAP may provide tools in the future that enable you to convert RAR files to SCA files without the SAP-specific deployment descriptors being created automatically.
Read SAP Note 1004000 to find out whether such tools are available.