Redeploying the OJMS Adapter due to “Unable to find/read file META-INF/ra.xml”

Upon startup of Oracle SOA Suite, the OC4J_SOA OPMN logs were showing errors related to my OJMS adapter:

10/01/28 19:17:50 WARNING: ApplicationStateRunning.loadConnectors Exception loading connector OjmsAdapter : Unable to find/read file META-INF/ra.xml in /u01/app/oracle/product/10.1.3/soa_1/j2ee/oc4j_soa/connectors/OjmsAdapter/OjmsAdapter archive (IO Error: No such file or directory)

Basically, the OJMS adapter is not found, which was strange since I was pretty sure it was deployed.
The oc4j-connectors.xml file was configured correctly:

<connector name="OjmsAdapter" path="OjmsAdapter.rar">

<config-property name="lookupMethod" value="resourceProvider"/>

<config-property name="esourceProviderName" value="MY_AQJMS_POOLED_DS"/>

</connector>

I am not sure why the adapter was missing, but fortunately I had a backup copy of both the adapter JAR and oc4j-ra.xml, and used the following steps to redeploy the adapter manually:

mkdir -p $ORACLE_HOME/j2ee/oc4j_soa/connectors/OjmsAdapter/OjmsAdapter
 

cp /tmp/OjmsAdapter.rar $ORACLE_HOME/j2ee/oc4j_soa/connectors/OjmsAdapter/OjmsAdapter

cd $ORACLE_HOME/j2ee/oc4j_soa/connectors/OjmsAdapter/OjmsAdapter

unzip OjmsAdapter.rar

mv $ORACLE_HOME/j2ee/oc4j_soa/connectors/OjmsAdapter/OjmsAdapter/OjmsAdapter.rar $ORACLE_HOME/j2ee/oc4j_soa/connectors/OjmsAdapter

mkdir $ORACLE_HOME/j2ee/oc4j_soa/application-deployments/default/OjmsAdapter

cp /tmp/oc4j-ra.xml $ORACLE_HOME/j2ee/oc4j_soa/application-deployments/default/OjmsAdapter

I restarted the OC4J_SOA container, and was good to go.


Applicable Versions:

• Oracle SOA Suite 10g (10.1.3.x)