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 libOVD is alternative to OVD for LDAPSync (integrating OIM with LDAP server like AD or OID)

In OIM, If you wish to configure LDAPSync then OVD is mandatory. From 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/ 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

2. Connect to Admin Server

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

3. To list adapters for 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’)

Adapter Type                : LDAP
Name                        : oid1

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

LDAP Host                   : [ : 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


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



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:

manin21 says December 1, 2011

Hi Atul,

I’m traying to setup LDAPSync in my OIM, 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:

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: 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 should be released


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 ?

manin21 says December 1, 2011


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
[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.


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 (


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.

manin21 says December 3, 2011


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

Best Regards

Karthick says January 11, 2012


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…

Atul Kumar says January 11, 2012

Check OIM developer guide – Customizing Oracle Identity Manager Interface

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.

Mike says October 7, 2012

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?

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).


» 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 […]

» 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 […]

» 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 […]

» 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) […]

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/$ ./ /oracle/app/product/fmw_iam/
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/
JAVA_HOME is /oracle/app/jrockit-jdk1.6.0_37
MW_HOME is /oracle/app/product/fmw_iam/
WL_HOME is /oracle/app/product/fmw_iam/
DOMAIN_HOME is /oracle/app/environments/dev/security/user_projects/domains/iam_domain
[Enter OIM admin password:]
at java.lang.ClassLoader.loadClass(
at sun.misc.Launcher$AppClassLoader.loadClass(
at java.lang.ClassLoader.loadClass(
at java.lang.Class.forName0(Native Method)
at java.lang.Class.forName(


at oracle.ods.virtualization.service.VirtualizationServiceManager.createService(
at oracle.ods.virtualization.service.VirtualizationServiceManager.getService(
at oracle.ods.virtualization.jndi.OVDContext.(
at oracle.ods.virtualization.jndi.OVDContextFactory.getInitialContext(
at javax.naming.spi.NamingManager.getInitialContext(
at javax.naming.InitialContext.getDefaultInitCtx(
at javax.naming.InitialContext.init(
at javax.naming.InitialContext.(
at oracle.iam.platformservice.utils.LDAPConfigPostSetup.(
at oracle.iam.platformservice.utils.LDAPConfigPostSetup.main(
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.

Saurabh says February 24, 2014

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

Add Your Reply