Thursday, 11 October 2012

Installation of OIA 11.1.1.5.0 on Linux


1.1.          Download OIA 11.1.1.5
1.2.          Create the RBACX_HOME Environment Variable on Your Local System
export RBACX_HOME=Path to the Oracle Identity Analytics installation directory (I created /oia11g/Oracle/ folder under root)
1.3.          Create the Oracle Identity Analytics Folder Structure

mkdir -p /oia11g/Oracle/OIA_Install
unzip oia_install_package.zip -d OIA_Install

Contents of the Base OIA Directory Looks like

.indexes
folder
conf
folder
db
folder
legal
folder
rbacx.war
file
reports
folder
sample
folder

1.4.          Download the Third-Party Library Files
mkdir /oia11g/Oracle/OIA_Lib
Download the following .jar files into OIA_Lib folder
1.  ojdbc5.jar for oracle DB 11gR1
      ojdbc6.jar for oracle DB 11gR2
2.  jasper-jdt.jar from
3.  CloverETL

Convert the Downloaded CloverETL Library File to a JAR File

a.       Create a working directory named files and then open the directory:
mkdir files
cd files
b.      Check the integrity of the .zip file and then expand it:
unzip -tq ../cloverETL.rel-1-8-1.zip
unzip -q ../cloverETL.rel-1-8-1.zip
c.       Remove the log4j.properties file to prevent a file conflict in OIA:
rm log4j.properties
d.      Go to the parent directory:
cd ..
e.       Create the JAR manifest input file clover.mf, which consists of these lines:
Implementation-Version: 1.8.1
Implementation-Title: jETeL/Clover
Implementation-URL: http://download.berlios.de/cloveretl/cloverETL.rel-1-8-1.zip
Implementation-Vendor-Id: org.jetel 
f.       Create the JAR file:
jar cmf clover.mf cloverETL-1.8.1.jar -C files .
g.      Copy the cloverETL-1.8.1.jar file to the OIA_LIB folder.
4.       jxl-2.5.9.jar
5.       WSDL4J JAR
Follow these steps to extract the wsdl4j.jar file and copy it to the OIA_LIB folder.
a.       Verify the zip file was downloaded without errors:
unzip -tq wsdl4j-bin-1.6.1.zip
b.        Extract the wsdl4j.jar file:
unzip -q wsdl4j-bin-1.6.1.zip wsdl4j-1_6_1/lib/wsdl4j.jar
c.         Copy the JAR file to the OIA_LIB folder and rename it to include the version number:
mv wsdl4j-1_6_1/lib/wsdl4j.jar $OIA_LIB/wsdl4j-1.6.1.jar
d.       Clean up:
rm -fr wsdl4j-bin-1.6.1.zip wsdl4j-1_6_1/
1.5.          Create the Oracle Identity Analytics Schema on the Database Server
a.  Set ORACLE_SID
b.  Access the database using SQL*Plus
c.  Create user using below query
create user rbacxservice identified by your-database-password;
d.  Run the query
@/oia11g/Oracle/OIA_Install/db/oracle/ rbacx-1.1.1.5.0_oracle_schema.sql
Check schema using Oracle DB enterprise manager
1.6.          To Configure Oracle Identity Analytics for Standalone Deployment
  1. Create a backup copy of the original rbacx.war file.
$ cd /oia11g/Oracle/OIA_Install
$ mkdir rbacx_original
$ cp rbacx.war rbacx_original/.    
A copy of the rbacx.war file is created under /oia11g/Oracle/OIA_Install/rbacx_original.
  1. Create an rbacx_staging folder under $RBACX_HOME.
$ mkdir rbacx_staging
$ cd rbacx_staging
  1. Extract rbacx.war to rbacx_staging so that configuration changes can be made.
$ jar xvf ../rbacx.war
  1. Navigate to rbacx_staging/WEB-INF.
$ cd WEB-INF
  1. Update the log4j.properties file with the correct path for your environment.
1.      In a text editor, open the log4j.properties file located in the WEB-INF folder.
2.      Locate the following line under # File Appender.
log4j.appender.file.file=logs/rbacx.log
3.      Replace logs/rbacx.log with the full path to where the log file should be written.
For example, the line should look like this:
§  log4j.appender.file.file=/oia11g/Oracle/OIA_Install/logs/rbacx.log
                        Update the jasper.properties file.

1.      In a text editor, open the jasper.properties file located in the WEB-INF folder.
2.      Add the following line to the end of the file:
net.sf.jasperreports.compiler.classpath=/oia11g/Oracle/OIA_Install/rbacx_staging /WEB-INF/lib/jasperreports-2.0.5-javaflow.jar
6.      If you are using CloverETL, enable it in the configuration as follows:
1.      In a text editor, open WEB-INF/etl-context.xml and uncomment the etlManager bean definition.
    1. In a text editor, open WEB-INF/iam-context.xml and uncomment the etlManager bean reference in the property list of the file bean definition.
  1. Copy the downloaded third-party library files to the Oracle Identity Analytics library under the WEB-INF/lib directory.
$ cp $OIA_LIB/* WEB-INF/lib
  1. Make the following changes if there are multiple instances of Oracle Identity Analytics, standalone or clustered, on the same subnet.
1.      Navigate to rbacx_staging/WEB-INF directory.
2.      In a text editor, open application-context.xml, find bean ID commManager, and examine the constructor-arg value.
3.      Set the constructor-arg value with a unique instance name—for example, value="OIA-Instance-1".
4.      In a text editor, open search-context.xml, find bean ID searchConfiguration, and examine the constructor-arg value.
5.      If the deployment is standalone, constructor-arg defaults to a value of 0, which is specified as value="0".
  1. Run the following commands from the rbacx_staging folder to repack the newly modified rbacx.war file.
$ cd /oia11g/Oracle/OIA_Install/rbacx_staging
$ jar cvfM ../rbacx.war .
The new rbacx.war file is located in /oia11g/Oracle/OIA_Install.
  1. Copy the jdbc.properties file for your database to the Oracle Identity Analytics conf directory, located as follows.
cd /oia11g/Oracle/OIA_Install/conf
cp oracle/jdbc.properties .
  1. In a text editor, open the jdbc.properties file and edit the following lines, substituting $SERVER_NAME and $PORT_NUMBER with the host name and connectivity port of the target database.
For Oracle Database:
# JDBC driver URL
jdbc.url=jdbc:oracle:thin:@orclfmw.example.com:1521:idm11gdb
The default port number for JDBC connectivity on the Oracle server is 1521 and it is assumed that the default SID is rbacx.
1.      If you are using a database user name other than the default rbacxservice user name, change the jdbc.username value in the jdbc.properties file to the user name that you created. Otherwise, go to the next step.

                        In the jdbc.properties file, add the following line:
jdbc.password=YourClearTextDatabasePassword
Now encrypt the database password by typing the following command at a command line:


#java -jar ../rbacx_staging/WEB-INF/lib/vaau-commons-crypt.jar  -encryptProperty -cipherKeyProperties ./cipherKey.properties -propertyFile ./jdbc.properties -propertyName jdbc.password
     
The password is encrypted and stored as jdbc.password.encrypted.
  1. Delete the rbacx_staging folder.
$ cd /oia11g/Oracle/OIA_Install
$ rm -rf rbacx_staging
                        Do the following:
                a. Go to the following location and open iam.properties in a text editor.
/oia11g/Oracle/OIA_Install/conf
                 b. Edit the following lines, replacing $RBACX_HOME with the path to the directory where Oracle Identity Analytics is installed:
com.vaau.rbacx.iam.file.import.completeLocation=$RBACX_HOME/import/complete
com.vaau.rbacx.iam.file.import.schemaLocation=$RBACX_HOME/import/schema
com.vaau.rbacx.iam.file.import.dropLocation=$RBACX_HOME/import/in
com.vaau.rbacx.etl.import.dropLocation=$RBACX_HOME/import/etl/in
com.vaau.rbacx.etl.import.graphsLocation=$RBACX_HOME/import/etl/graphs
com.vaau.rbacx.etl.import.completeLocation=$RBACX_HOME/import/etl/complete
com.vaau.rbacx.etl.import.outputLocation=$RBACX_HOME/import/in
com.vaau.rbacx.iam.file.export.dropLocation=$RBACX_HOME/export/etl/in
com.vaau.rbacx.iam.file.export.schemaLocation=$RBACX_HOME/export/schema
com.vaau.rbacx.etl.export.dropLocation=$RBACX_HOME/export/etl/in
com.vaau.rbacx.etl.export.graphsLocation=$RBACX_HOME/export/etl/graphs
com.vaau.rbacx.etl.export.completeLocation=$RBACX_HOME/export/etl/complete
com.vaau.rbacx.etl.export.outputLocation=$RBACX_HOME/export/out

1.7.          If you intend to install OIM and OIA in the same WLS domain you'll note that OIA won’t deploy due to class loading issues


Follow these steps to resolve:
 1. Extract the OIA WAR file

 2. Remove stax-api jar file from OIA WAR

 rm /oia11g/Oracle/rbacx_staging/WEB-INF/lib/stax-api-1.0.1.jar

 3. Create /oia11g/Oracle/rbacx_staging /WEB-INF/weblogic.xml to configure WLS to give classes inside the WAR file priority when attempting to load classes
<?xml version="1.0" encoding="UTF-8"?>
<weblogic-web-app xmlns="http://www.bea.com/ns/weblogic/90"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.bea.com/ns/weblogic/90
http://www.bea.com/ns/weblogic/90/weblogic-web-app.xsd">
<container-descriptor>
<prefer-web-inf-classes>true</prefer-web-inf-classes>
</container-descriptor>
</weblogic-web-app>
4. Recreate the war file or deploy the extracted war directory on to WLS.


1.8.          Deploying on Web Logic
 



cd /oia11g/Oracle/OIA_Install
mkdir rbacx_staging
cd rbacx_staging
jar xvf ../rbacx.war

1.      Startup Admin Server and browse to Admin console
 

2.      Select Deployments --> install
 3.      Provide the rbacx_staging path as showing below
 4.      Ensure you click 'Install this deployment as an application' and click next
 5.       Select the Install This Deployment as an Application oia11gion and choose oia_server1 as app server to be deployed on, click Next. 
 6.      On the Oia11gional Settings page, do the following:

a.       Ensure that the deployment is named rbacx.
b.      Under Security, select DDOnly: Use Only Roles and Policies That Are Defined in This Deployment.
c.       Under Source Accessibility, select Use the Defaults Defined by the Deployment’s Targets.
      d.      Click Next.
7.      Login to OIA using http://hostname:potr/rabcx_staging



 

No comments:

Post a Comment