Missing Configuration for Integration between OIM and ORM with JBOSS

I was facing an error after doing the integration between Oracle Identity Manager and Oracle Role Manager where OIM installed on Linux server and ORM in Windows server, here is a snapshot from the log

03:39:40,216 WARN  [IntegrationUtilities] No plugin configuration files found in /oracle/idm-home/jboss-4.2.3/bin/c:\ORMINT_HOME\/config
03:39:40,217 ERROR [TASK] Class/Method: SchedulerBaseTask/run encounter some problems: {1}
java.lang.NullPointerException
    at oracle.iam.rm.imframework.scheduledTasks.ScheduledIntegrationTask.init(ScheduledIntegrationTask.java:135)
    at com.thortech.xl.scheduler.tasks.SchedulerBaseTask.run(Unknown Source)
    at com.thortech.xl.scheduler.core.quartz.QuartzWrapper$TaskExecutionAction.run(Unknown Source)
    at Thor.API.Security.LoginHandler.jbossLoginSession.runAs(Unknown Source)
    at com.thortech.xl.scheduler.core.quartz.QuartzWrapper.execute(Unknown Source)
    at org.quartz.core.JobRunShell.run(JobRunShell.java:203)
    at org.quartz.simpl.SimpleThreadPool$WorkerThread.run(SimpleThreadPool.java:520)

I faced this error before when I installed OIM on windows, but for a quick way to solve the problem I moved ORMINT_HOME (ORM Integration Library location on OIM server) to the default location C:\ORMINT_HOME but after we changed OIM server to be Linux server, I had to face that issue again.

I tried to find if someone faced that issue before or not I didn't find help, even I opened Service Request on Metalink but without any help. That's because ORM is a new product and there are only few implementations for it (by the way I am not a fan for that system).

The solution for this error is very simple but not mentioned in documentation, there is a system property that needs to be added to JBoss and it will be used by OIM for integration purposes with ORM. That property is ORMINT_ROOT_DIR and it will be added with a value to properties-service.xml file (you can find it under /server/default/deploy )

<attribute name="Properties">
      ORMINT_ROOT_DIR=/oracle/idm-home/ORMINT_HOME
<\attribute>

Oracle Identity Manager installation tips

I will not be able to post right now the complete installation steps for Oracle Identity Manager with JBoss as the application server, because it will take a lot of time, but I will add some tips here to be be taken in consideration during OIM installation.

- If you are using Sun JVM and JBoss, you need to make one more modification in run.bat (JBoss starting Batch) ro JAVA_OPTS parameter which is -XX:MaxPermSize=256m

set JAVA_OPTS=%JAVA_OPTS% -Xms256m -Xmx1024m -XX:MaxPermSize=256m

- When you start JBoss and you want it to listen (or bind) to any available IP, run JBoss starting batch like this

run.bat -b 0.0.0.0

- After installing OIM Design Console, take copy from log4j.jar from inside JBoss and rename it to log4j-1.2.8.jar then replace log4j-1.2.8.jar from inside OIM Design Console installation directory.

- Take care when installing JBoss in your development or testing machine, some applications my be using JBoss ports like MS Exchange uses 1099 and 1098, Oracle UCM uses 4444 and 4445, and of course Apache Tomcat. So you need to change JBoss ports, to do that take a look at the following page which explains to you which files you will change

http://www.thedance.net/~roth/TECHBLOG/jbossports.html

If you want to know which applications is using your machine's ports, download ActivePorts program from the following link

http://download.cnet.com/Active-Ports/3000-2651_4-29653.html?tag=mncol

If you changed 1099 port after you have installed OIM, you should change it too in xlconfig.xml for OIM Server and OIM Design Console. Also If you changed 8080 port after you have installed OIM, you should change it too in xlconfig.xml for Design Console.

- To deploy SMPL WebService, take a look at the following link

http://download.oracle.com/docs/cd/E14899_01/doc.9102/e14763/spml.htm#BEIDGDGE

Also note you need in this case to download apache commons-discovery library and add it to [jboss_install_dir]/server/default/lib