Release 2.x‎ > ‎Install - Reference‎ > ‎

2.1: Service OIM11g Weblogic

This document will cover the deployment of Project OpenPTK 2.1 using the Oracle Identity Manager 11g, deployed to Weblogic.

Prerequisites

The following tasks must be completed ...

  1. Complete the maven setup processes detailed on Setup using Maven page
  2. Oracle Identity Manager 11g has successfully been installed.
    • This document uses:
      • a server with the following hostname: oim11g
      • a login on the server of: oracle
  3. Download the entire Project OpenPTK source distribution from http://java.net/projects/openptk
  4. Create a "staging" directory on the server running Weblogic. This document uses the following staging directory:
    • /home/oracle/openptk

Each installation of Oracle Identity Manager 11g will have a specific oimclient.jar file depending on the which update and/or patch set is install.

You MUST obtain the oimclient.jar file from the deployment that will be configured to work with the Project OpenPTK deployment.

Warning
  1. If the oimclient.jar file is not properly install (see below), you will get "Class Not Found" errors.
  2. If you have the WRONG oimclient.jar file, you may be seeing "Incompatible Class" errors or other unpredictable errors.

The jar file is located here: <IDM_HOME>/server/client/oimclient.jar

Update maven repository

The build process will not complete successfully unless the oimclient.jar file installed into the local maven repository.  Follow this procedure if the maven repository needs to be update.

You need to copy the oimclient.jar from the OIM 11g deployment.
  1. Copy the oimclient.jar file from the OIM 11g server location: ${IDM_HOME}/server/client/oimclient.jar to a local directory.
  2. Run the following command to add the oimclient.jar file to your local Maven repository.  
    • Notice: This example is for OIM 11g version 11.1.1.3.0 If you are using a different version you can update the version option.
      • If the version number is different, the maven pom.xml file will need to updated to match the correct version
mvn install:install-file -DgroupId=com.oracle.iam -DartifactId=oracle-iam-oimclient -Dpackaging=jar -Dversion=11.1.1.3.0 -DgeneratePom=true -Dfile=oimclient.jar
 
Notice: 
The oimclient.jar file is NOT packaged with the openptk-server.war file that is generate.  The oimclient.jar is ONLY used to support the compiling of the OIMClient Java classes.

Build and Distribute

After the OpenPTK Project has been "checked out" the following steps need to be completed:

From the top level directory, containing the pom.xml

  1. run the mvn command:
    • mvn install -P server,srvc-oim11g
  2. Copy the war file to the server running Weblogic
    • scp ./projects/OpenPTK/Server/target/openptk-server.war oracle@oim11g:/home/oracle/openptk
 % cd trunk/openptk
% mvn install -P server,srvc-oim11g
...
[INFO] -------------------------------------------------------------
[INFO] Reactor Summary:
[INFO]
[INFO] OpenPTK ................................. SUCCESS [0.840s]
[INFO] OpenPTK-Base ............................ SUCCESS [16.992s]
[INFO] OpenPTK-Client .......................... SUCCESS [5.374s]
[INFO] OpenPTK-Framework ....................... SUCCESS [5.522s]
[INFO] OpenPTK-Servlet ......................... SUCCESS [1.591s]
[INFO] OpenPTK-Taglib .......................... SUCCESS [2.012s]
[INFO] OpenPTK-Plugin-MimeUtil ................. SUCCESS [1.550s]
[INFO] OpenPTK-Plugin-SendEmail ................ SUCCESS [1.108s]
[INFO] OpenPTK-Plugin-Templates ................ SUCCESS [0.990s]
[INFO] OpenPTK-Service-OIMClient ............... SUCCESS [1.837s]
[INFO] OpenPTK-Server .......................... SUCCESS [5.899s]
[INFO] --------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] --------------------------------------------------------------
[INFO] Total time: 44.009s
[INFO] Finished at: Thu Mar 29 21:25:10 CDT 2012
[INFO] Final Memory: 17M/81M
[INFO] --------------------------------------------------------------

% scp projects/OpenPTK/Server/target/openptk-server.war  oracle@oim11g:/home/oracle/openptk

Configure

Log into the server where the war file has been copied to:

  1. Expand the war file
  2. edit the configuration files
  3. Copy the oimclient.war file
  1. ssh into the server
  2. Change to the directory containing the war file
  3. make a sub-directory called openptk-server
  4. Change to the sub-directory
  5. Expand the war file
 
% ssh oracle@oim11g
% cd /home/oracle/openptk
% mkdir openptk-server
% cd openptk-server
% jar xvf ../openptk-server.war
  1. ssh into the server
  2. Change to the directory containing the war file
  3. Change to the sub-directory WEB-INF/lib
  4. Copy oimclient.jar to this directory
 
% ssh oracle@oim11g
% cd /home/oracle/openptk/openptk-server
% cd WEB-INF/lib
% cp <IDM_HOME>/server/client/oimclient.jar .
Clear Text Password This procedure stores the password for the Admin user in OIM 11g in clear text. This technique should only be used for testing. Follow the Encrypting Password procedure for a production deployment.

Editing the openptk.xml file

  1. Change to the directory WEB-INF/classes
  2. Locate the Property Elements related to oim11g and update the value to match your OIM 11g deployment.
    • oim11g.url
    • oim11g.user.name
    • oim11g.user.password
  3. Locate the <Contexts> Element. Find the <Property> Element that related to context.default and update the value to:
    • User-Oracle-OIMClient
  4. Ensure that the <Context> is enabled.
    • Locate the <Context id="User-Oracle-OIMClient">
    • The enabled Argument must be set to true
  5. Set the default Context for the server Client
    • Locate the <Client id="sever"> Element, in the <Clients> section
    • Set the sub-Element <Contexts ...> default value to: User-Oracle-OIMClient
    • Ensure that User-Oracle-OIMClient is one of the <Context ...> elements of <Contexts>
  6. Set the default Context for the uml Client
    • Locate the <Client id="uml"> Element, in the <Clients> section
    • Set the sub-Element <Contexts ...> default value to: User-Oracle-OIMClient
    • Ensure that User-Oracle-OIMClient is one of the <Context ...> elements of <Contexts>
Warning
If the openptk_client.properties is not correct, the interface can not connect to the server. Logins will fail

Editing the openptk_client.properties file

  1. Locate the openptk.connection.uri property ... this file is under the WEB-INF/classes folder/directory

% cd WEB-INF/classes

% vi openptk.xml

<Property name="oim11g.url"           value="t3://oim11g:7002" />
<Property name="oim11g.user.name"     value="xelsysadm" />
<Property name="oim11g.user.password" value="Passw0rd" />


<Contexts>    
   <Properties>
      <Property name="context.default" value="User-Oracle-OIMClient" />


<Context id="User-Oracle-OIMClient" enabled="true"  ... >


<Client id="openptkserver">
   <Authenticators>
      <Authenticator id="Employees-IdPass-LDAP"/>
      <Authenticator id="Employees-IdPass-JDBC"/>
      <Authenticator id="Employees-IdPass-Oracle"/>
      <Authenticator id="OpenPTK-config"/>
   </Authenticators>
   <Contexts default="User-Oracle-OIMClient">
      <Context id="Employees-Oracle-JDBC"  />
      <Context id="Employees-MySQL-JDBC"  />
      <Context id="Employees-OpenDS-JNDI" />
      <Context id="User-Oracle-OIMClient" />
   </Contexts>
</Client>


<Client id="uml" secret="WeacAymEnZqP34gDQuNfDsHE">
   <Authenticators>
      <Authenticator id="Employees-IdPass-LDAP"/>
      <Authenticator id="Employees-IdPass-JDBC"/>
      <Authenticator id="Employees-IdPass-Oracle"/>
      <Authenticator id="Anonymous"/>
   </Authenticators>
   <Contexts default="User-Oracle-OIMClient">
      <Context id="Employees-Oracle-JDBC"  />
      <Context id="Employees-MySQL-JDBC"  />
      <Context id="Employees-OpenDS-JNDI" />
      <Context id="User-Oracle-OIMClient" />
   </Contexts>
</Client>

% vi openptk_client.properties

openptk.connection.uri=http://localhost:7001/openptk-server

Deploy Server

Log into the Weblogic Admin Interface and deploy the OpenPTK Server from the expanded directory.

  1. Select Deployments from the left-menu
  2. Click the Install button (you may have to select Lock and Edit first, if Production Mode)
  3. Navigate to the /home/oracle/openptk directory
  4. Select the Radio-Button for the (open directory)
  5. Click Next

  1. Select the Radio-Button Install this deployment as an application
  2. Click Next

  1. From the list of Servers
    • ONLY check AdminServer
  2. Click Next

  1. In the Security section
    • Make sure DD Only is selected
  2. In the Source accessibility section:
    • Make sure I will make deployment accessible from the following location is selected
    • The Location field need to be set to /home/oracle/openptk/openptk-server
  3. Click Next

  1. In the Additional configuration section
    • Select the Yes ... Radio button
  2. Click Finish
v2.0: Install Service OIM11g Weblogic
  1. Click Save
  2. If Weblogic is in production mode, you will need to:
    • Click the Activate Changes Button on the left
v2.0: Install Service OIM11g Weblogic
  1. Select Deployments from the left-menu
  2. Locate the OpenPTK-Server row in the table (may have click next)
    • The State column should say Prepared
  3. Check the box in front of the name OpenPTK-Server
  4. Select the Drop-Down Menu Start
  5. Select the Menu Item Servicing all requests
v2.0: Install Service OIM11g Weblogic
  1. Click Yes

  1. Select Deployments from the left-menu
  2. Locate the OpenPTK-Server row in the table (may have click next)
    • The State column should say Active

Test

Log into the the Server User Interface ... must be a SYSTEM user.

Open browser, goto OpenPTK: http://oim11g:7001/openptk-sever

  1. Login using openptkserver / password

  1. Select the Context Tab
  2. Select the User-Oracle-OIMClient Context

  1. Select the subjects URI link

The first ten (10) users are returned from the SEARCH operation
Click on one of the Subject URI links to READ the individual entry