This chapter covers the tasks involved in migrating an existing natively integrated 10.1.4.5 application that is currently using SOAP authentication to 11g.
Pre-requisites are as follows for migration of your existing natively integrated application:
Client should be using OAAM Shared Library for Native Integration using SOAP
Client should specify the configurable properties in bharosa_server.properties and this file should be in the Java Classpath of the client application
See Section 17.4, "Migrating Native Applications that Cannot Use OAAM Shared Library" if the Native Application cannot use the OAAM Shared Library
This native integration involves only local API calls and therefore no remote server risk engine calls. The integration embeds the processing engine for OAAM with the application and enables it to leverage the underlying database directly for processing.
To migrate the natively integrated inproc application to OAAM 11g, proceed as follows:
To use the Oracle Adaptive Access Manager Shared Library, you must refer to the shared library by adding the following entry to your WebLogic deployment descriptor file, weblogic.xml:
<library-ref>
<library-name>oracle.oaam.libs</library-name>
</library-ref>
As part of migrating the application, you must perform these steps:
Move all the configurable properties to bharosa_server.properties.
Remove/delete all other OAAM property files from the native application.
Remove/delete all old OAAM jar files.
The web application communicates with OAAM via Web Services.
Follow the procedures in this section to migrate your native SOAP application to OAAM 11g.
To use the Oracle Adaptive Access Manager Shared Library, you must refer to the shared library by adding the following entry to your WebLogic deployment descriptor file, weblogic.xml:
<library-ref>
<library-name>oracle.oaam.libs</library-name>
</library-ref>
As part of migrating the application, you must perform these steps:
Move all the configurable properties to bharosa_server.properties.
Make sure the following properties are set in bharosa_server.properties:
vcrypt.tracker.soap.useSOAPServer=true
vcrypt.soap.disable=false
bharosa.config.impl.classname=com.bharosa.common.util.BharosaConfigPropsImpl
bharosa.config.load.impl.classname=com.bharosa.common.util.BharosaConfigLoadPropsImpl
Remove/delete all other OAAM property files from the native application
Remove/delete all old OAAM jar files
For details on configuring SOAP/WebServices Access, refer to "Configuring SOAP Web Services Access" in the Oracle Fusion Middleware Administrator's Guide for Oracle Adaptive Access Manager.
The process below covers migrating your existing 10.1.4.5 Natively Integrated application that is currently using SOAP authentication to 11g.
After those files are copied, you can copy the oaam_core.jar file from the $ORACLE_HOME/oaam/cli/lib folder into your applications library directory. $ORACLE_HOME is usually the ORACLE_IDM1 folder in the Middleware Home.
All updated property files and libraries are located in the $ORACLE_HOME/oaam/cli folder. The conf/bharosa_properties folder contains the updated properties, and the lib folder contains the updated libraries.
To upgrade your existing natively integrated application, you can start by removing the contents of your existing bharosa_properties folder, and replacing them with the contents of the $ORACLE_HOME/oaam/cli/conf/bharosa_properties directory.
In 10g all client specific configuration overrides were created in the bharosa_client.properties file, now those overrides need to be created in the bharosa_server.properties file. This was typically the file modified on the server side for the same purpose. A bharosa_server.properties file that contains the contents of your old bharosa_client.properties with the addition of the following new properties needs to be created in your application's bharosa_properties folder that contains the following information:
# New Properties
vcrypt.tracker.soap.useSOAPServer=true
vcrypt.soap.disable=false
bharosa.config.impl.classname=com.bharosa.common.util.BharosaConfigPropsImpl
bharosa.config.load.impl.classname=com.bharosa.common.util.BharosaConfigLoadPropsImpl
These new properties will tell the new libraries to use the Generic SOAP implementation classes for communicating with the OAAM Server component, and instead of looking to the OAAM database to read the properties typically retrieved from the BharosaConfig class to retrieve them from the local property files.
It is noted above that these properties are to be used in addition to the existing contents of your bharosa_client.properties file which should include your soap user name, and soap keystore information. Note: If you did not have SOAP authentication setup in 10g, you will need to refer to "Setting Up Encryption" in the 10.1.4.5 Oracle Adaptive Access Manager Installation and Configuration Guide for creating a SOAP keystore for use with the new 11g environment.