libOVD adapters in OIM LDAP Integration : LDAPsync – view and modify Adapter settings (bindDN and bindPassword)

This post covers steps to view and edit libOVD configuration like change binddn and password in adapter configuration.

In OIM 11.1.1.5+ libOVD is alternative to OVD for LDAPSync (integrating OIM with LDAP server like AD or OID)

In OIM 11.1.1.3, If you wish to configure LDAPSync then OVD is mandatory. From 11.1.1.5 OIM onwards, OVD is not mandatory (libOVD is used to sync data between OIM and OID).

  • libOVD configuration is created during OIM configuration stage ($ORACLE_HOME/bin/config.sh) when you select LDAPsync and LDAP server is OID, AD, or ODSEE (earlier Sun directory server).
  • LibOVD configuration is stored in directory $DOMAIN_HOME/ config/ fmwconfig/ ovd/ oim and contains information like LDAP server host, port, binddn (user to connect from OIM to OID for synchronisation).
  • By default configuration tool creates two OVD adapters (oid1 and CHANGELOG_oid1) of type LDAP. To view and change you can use WebLogic Scripting Tool (WLST) or through MBeans in FMW enterprise manager control (/em).

 

During configuration binddn used is cn=orcladmin and modifierDNFilter is set to cn=orcladmin (i.e. If DN of modifier in LDAP server is orcladmin then don’t synchronise user) because of which users updated/created in OID by cn=orcladmin are not being synchronised to OIM (If LDAPSync is configured then users created/updated/deleted in OID/AD should automatically be synchronised to OIM using scheduled Jobs “LDAP User Create and Update Reconciliation and LDAP User Delete Reconciliation” in OIM. More on issues around recon jobs in OIM in future post)

 

Managing libOVD Adapter via WLST

1. Start WLST

cd $MW_HOME/oracle_common/common/bin
./wlst.sh

2. Connect to Admin Server

connect(‘weblogic’,’welcome1′,’t3://innowave12.com:7001′)  — Here weblogic is admin user name of weblogic domain, innowave12.com is server name on which Admin Server is running and 7001 is admin server port is running

3. To list adapters for OIM

listAdapters(contextName=’oim’)

You should see output like

_______
Adapter Name : oid1
Adapter Type : LDAP 

Adapter Name : CHANGELOG_oid1
Adapter Type : LDAP

_______

 

4.  To get adapter details for adapter oid1

 getAdapterDetails(adapterName=’oid1′, contextName=’oim’)

______
wls:/ohsdomain/domainRuntime> getAdapterDetails(adapterName=’oid1′, contextName=’oim’)

DETAILS OF ADAPTER :  oid1
Adapter Type                : LDAP
Name                        : oid1

Virtual NameSpace           : dc=com
Remote NameSpace            : dc=com

LDAP Host                   : [innowave12.com : 3060] Secure                      : false
Bind DN                     : cn=orcladmin
Pass Credentials            : Always
Max size of Connection Pool : 10

________

5. To modify BindDN to oimLDAP user created during OIM-OAM integration

Update username and password in adapter oid1

modifyLDAPAdapter(adapterName=’oid1′,attribute=’BindDN’, value=’cn=oimLDAP,cn=SystemUsers,dc=com’, contextName=’oim’)

modifyLDAPAdapter(adapterName=’oid1′,attribute=’BindPassword’, value=’welcome1′, contextName=’oim’)

Update username and password in adapter CHANGELOG_oid1

modifyLDAPAdapter(adapterName=’CHANGELOG_oid1′,attribute=’BindDN’, value=’cn=oimLDAP,cn=SystemUsers,dc=com’, contextName=’oim’)

modifyLDAPAdapter(adapterName=’CHANGELOG_oid1′,attribute=’BindPassword’, value=’welcome1′, contextName=’oim’)

 Note: Realm (Domain Name) in OID in above command is “dc=com” , change this value as per your setting.

6. To modify modifierDNFilter in libOVD, open file $DOMAIN_HOME/ config/ fmwconfig/ ovd/ oim/ adapter.os_.xml and search for modifierDNFilter

Change from
!(modifiersname=cn=orcladmin)

to
!(modifiersname=cn=oimLDAP,cn=SystemUsers,dc=com)

Note: OID domain or Realm in this case is dc=com

 

Reference

About the Author Atul Kumar

Oracle ACE, Author, Speaker and Founder of K21 Technologies & K21 Academy : Oracle Gold Partner specialising in Design, Implement, and Trainings.

follow me on:

Leave a Comment:

17 comments
manin21 says December 1, 2011

Hi Atul,

I’m traying to setup LDAPSync in my OIM 11.1.1.5, as you mentioned, now IS NOT REQUIRED an OVD. I have deployed OIM without LDAPSync and now I want to enable LDAPSync (postinstallation enablement of LDAPSync) I have performed all steps from Oracle docs: http://docs.oracle.com/cd/E21764_01/doc.1111/e14308/ldapsync.htm#CHDHHJFG

but I have not succeed. When I try to create a new user in OIM I have the following error:

An error occurred while performing create user operation. Unable to get LDAP connection, and the root cause is – Failed to get connection due to initialization error with the pool: Failed to intialize and start UCP Connection pool

Looking at OIM servser output log I found the following:

Caused By: com.oracle.oim.gcp.exceptions.ResourceConnectionCreateException: javax.naming.NamingException: Config location must be a directory [Root exception is oracle.ods.virtualization.config.ConfigException: Config location must be a directory]

Help me please.

By the way, “Oracle Identity and Access Manager for Administrators” is a great work, a second edition featuring OIM 11.1.1.5 should be released

Regards
Juan

Reply
Atul Kumar says December 1, 2011

@ Juan,

I don’t think steps mentioned here are complete (it looks like libOVD related steps are missing)

Do you see ovd/oim directory under $DOMAIN_HOME/config/fmwconfig ?

can you see IT resource of type Directory Server in OIM ?

Reply
manin21 says December 1, 2011

Atul,

Thanks for your quick response, point me please where to find the libOVD steps.

under $DOMAIN_HOME/config/fmwconfig/ovd I have the following:

[oracle@oim115 ovd]$ pwd
/u01/app/oracle/product/fmw/user_projects/domains/IDMDomain/config/fmwconfig/ovd
[oracle@oim115 ovd]$ ll
total 4
drwxr-x— 2 oracle oinstall 4096 Nov 15 20:20 default

in the “default” directory there is:

oracle@oim115 ovd]$ cd default/
[oracle@oim115 default]$ ll
total 24
-rw-r—– 1 oracle oinstall 220 Mar 26 2011 adapters.os_xml
-rw-r—– 1 oracle oinstall 3104 Mar 26 2011 component_events.xml
-rw-r—– 1 oracle oinstall 5060 Mar 26 2011 provider.os_xml
-rw-r—– 1 oracle oinstall 117 Mar 26 2011 schema.user.xml
-rw-r—– 1 oracle oinstall 2841 Mar 26 2011 server.os_xml

Thanks again for the help.

Regards
Juan

Reply
manin21 says December 1, 2011

I can see “Directory Server” IT Resource in OIM, also I have customized this IT Resource to my OID environment as described in step 5 of 10.1 Enabling Postinstallation LDAP Synchronization (http://docs.oracle.com/cd/E21764_01/doc.1111/e14308/ldapsync.htm#CHDGEGHJ)

Regards
Juan

Reply
Atul Kumar says December 3, 2011

@ manin21,
Check my above posts again, you are missing oim folder inside ovd in $DOMAIN_HOME/config/fmwconfig

In my view steps mentioned in guide to configure LDAPSync after installation are not complete.

creation of linOVD step is missing from doc. Please contact Oracle Support to update doc with libOVD step for ldapSync after installation.

Reply
manin21 says December 3, 2011

Atul,

Thanks for your valuable help. I will open a SR in order to achieve our goal.

Best Regards
Juan

Reply
Karthick says January 11, 2012

HI,

Can you tell me how to change background colour and text font in OIM Administration and user console.

Tell suggest me the answer soon…please…

Reply
Atul Kumar says January 11, 2012

Check OIM developer guide
http://docs.oracle.com/cd/E17904_01/doc.1111/e14309/uicust.htm#OMDEV2742 – Customizing Oracle Identity Manager Interface

Reply
Karthick says January 11, 2012

I read that guide.from that i found that wanna change in Xellerate.css…

I tried to change in Xellerate.css but it doesnt reflect in login page.I think in Xellerate.css modified wrongly.May i know where i need to need change the modifications.

Can you suggest me please.

Reply
Mike says October 7, 2012

Atul,
I think what you did the modifications such as changing BindDn to cn=oimLDAP from cn=orladmin , which we could do the same via the Directory Server in the IT Resource from the OIM admin concole, correct for oim11.1.1.5.x?
Thanks,
Mike

Reply
Atul Kumar says October 8, 2012

@ Mike,
Yes, you are right we should change this via IT Resource from OIM Admin console (I’ve not tested this).

Atul

Reply
» Account Lock in OIM OAM OAAM, OID & WebLogic 11g because of Failed Login Attempts Online Apps DBA: One Stop Shop for Apps DBA’s says October 9, 2012

[…] OAAM. Users between OIM & OID are synced using libOVD or OVD . More on libOVD in OIM here and here d) OIM is used for password reset and account unlock More on How account lock/unlock should […]

Reply
» OIM User Creation : An Error occurred while performing create user operation. Unable to get LDAP connection Online Apps DBA: One Stop Shop for Apps DBA’s says October 25, 2012

[…] OIM User Creation : An Error occurred while performing create user operation. Unable to get LDAP connection Posted in October 25th, 2012 byAtul Kumar in identity_manager This post covers an issue that I encountered on Oracle Identity Manager (OIM) while creating new user in OIM. Error I received on screen was “Error occurred while performing create user operation. Unable to get LDAP connection, and the root cause is – null“.  OIM during installation or later can be integrated with LDAP server using LDAPSync . More on LDAP Sync here, here, and here […]

Reply
» Your account is locked. You can unlock your account by going to Forgot Password Online Apps DBA: One Stop Shop for Apps DBA’s says November 20, 2012

[…] using LDAPSync (OIM should be configured with LDAPSync enabled. More on LDAPSync here, here, and here). This process will also clear two attributes obLockoutTime, and obLoginTryCount (OAM will then […]

Reply
» User not synced from OID (LDAP) to OIM (LDAPsync) : Account Locked in OAM is not locked in OIM Online Apps DBA: One Stop Shop for Apps DBA’s says December 5, 2012

[…] byAtul Kumar in oam, oid, OIM When you enable LDAPSync (More on LDAPSYnc here, here, and here ) in OIM 11g (LDAPSync is mandatory to integrate OIM with OAM for SSO), users updated in LDAP (OID) […]

Reply
Saurabh says February 24, 2014

Hi Atul,

When i am going for Ldap Sync i am getting below error.

oracle@orgxdevidam01:/oracle/app/product/fmw_iam/11.1.2.0/iam/server/ldap_config_util$ ./LDAPConfigPostSetup.sh /oracle/app/product/fmw_iam/11.1.2.0/iam/server/ldap_config_util
For running the Utilities the following environment variables need to be set
APP_SERVER is weblogic
OIM_ORACLE_HOME is /oracle/app/product/fmw_iam/11.1.2.0/iam
JAVA_HOME is /oracle/app/jrockit-jdk1.6.0_37
MW_HOME is /oracle/app/product/fmw_iam/11.1.2.0
WL_HOME is /oracle/app/product/fmw_iam/11.1.2.0/wlserver_10.3
DOMAIN_HOME is /oracle/app/environments/dev/security/user_projects/domains/iam_domain
[Enter OIM admin password:]
java.lang.ClassNotFoundException: oracle.as.jmx.framework.standardmbeans.spi.JMXFrameworkProviderImpl
at java.net.URLClassLoader$1.run(URLClassLoader.java:202)
at java.net.URLClassLoader.findClass(URLClassLoader.java:190)
at java.lang.ClassLoader.loadClass(ClassLoader.java:306)
at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:308)
at java.lang.ClassLoader.loadClass(ClassLoader.java:247)
at java.lang.Class.forName0(Native Method)
at java.lang.Class.forName(Class.java:247)

….

at oracle.ods.virtualization.service.VirtualizationServiceManager.createService(VirtualizationServiceManager.java:64)
at oracle.ods.virtualization.service.VirtualizationServiceManager.getService(VirtualizationServiceManager.java:48)
at oracle.ods.virtualization.jndi.OVDContext.(OVDContext.java:193)
at oracle.ods.virtualization.jndi.OVDContextFactory.getInitialContext(OVDContextFactory.java:47)
at javax.naming.spi.NamingManager.getInitialContext(NamingManager.java:667)
at javax.naming.InitialContext.getDefaultInitCtx(InitialContext.java:288)
at javax.naming.InitialContext.init(InitialContext.java:223)
at javax.naming.InitialContext.(InitialContext.java:198)
at javax.naming.directory.InitialDirContext.(InitialDirContext.java:83)
at oracle.iam.platformservice.utils.LDAPConfigPostSetup.(LDAPConfigPostSetup.java:221)
at oracle.iam.platformservice.utils.LDAPConfigPostSetup.main(LDAPConfigPostSetup.java:139)
Obtained LDAP Connection…..
UsernamePasswordLoginModule.initialize(), debug enabled
UsernamePasswordLoginModule.login(), username xelsysadm
UsernamePasswordLoginModule.login(), URL t3://orgxdevidam01:7003
Authenticated with OIM Admin…..
Obtained Scheduler Service…..
Successfully Enabled Changelog based Reconciliation schedule jobs.
Successfully Updated Changelog based Reconciliation schedule jobs with last change number : 0

i am using libOVD. I ran this script after i restarted my OIM server.

Reply
Saurabh says February 24, 2014

Earlier it was prompting for OID Ldap admin password. And now after i did a reinstallation..it is not prompting

Reply
Add Your Reply