Driver for Oracle E-Business Suite (User Management, HR, and TCA)Implementation GuideFebruary 2014

www.netiq.com/documentation

Legal Notice

THISDOCUMENTANDTHESOFTWAREDESCRIBEDINTHISDOCUMENTAREFURNISHEDUNDERANDARESUBJECTTOTHETERMSOFALICENSEAGREEMENTORANONDISCLOSUREAGREEMENT.EXCEPTASEXPRESSLYSETFORTHINSUCHLICENSEAGREEMENTORNONDISCLOSUREAGREEMENT,NETIQCORPORATIONPROVIDESTHISDOCUMENTANDTHESOFTWAREDESCRIBEDINTHISDOCUMENTASISWITHOUTWARRANTYOFANYKIND,EITHEREXPRESSORIMPLIED,INCLUDING,BUTNOTLIMITEDTO,THEIMPLIEDWARRANTIESOFMERCHANTABILITYORFITNESSFORAPARTICULARPURPOSE.SOMESTATESDONOTALLOWDISCLAIMERSOFEXPRESSORIMPLIEDWARRANTIESINCERTAINTRANSACTIONS;THEREFORE,THISSTATEMENTMAYNOTAPPLYTOYOU.

Forpurposesofclarity,anymodule,adapterorothersimilarmaterial(Module)islicensedunderthetermsandconditionsoftheEndUserLicenseAgreementfortheapplicableversionoftheNetIQproductorsoftwaretowhichitrelatesorinteroperateswith,andbyaccessing,copyingorusingaModuleyouagreetobeboundbysuchterms.IfyoudonotagreetothetermsoftheEndUserLicenseAgreementyouarenotauthorizedtouse,accessorcopyaModuleandyoumustdestroyallcopiesoftheModuleandcontactNetIQforfurtherinstructions.

Thisdocumentandthesoftwaredescribedinthisdocumentmaynotbelent,sold,orgivenawaywithoutthepriorwrittenpermissionofNetIQCorporation,exceptasotherwisepermittedbylaw.Exceptasexpresslysetforthinsuchlicenseagreementornondisclosureagreement,nopartofthisdocumentorthesoftwaredescribedinthisdocumentmaybereproduced,storedinaretrievalsystem,ortransmittedinanyformorbyanymeans,electronic,mechanical,orotherwise,withoutthepriorwrittenconsentofNetIQCorporation.Somecompanies,names,anddatainthisdocumentareusedforillustrationpurposesandmaynotrepresentrealcompanies,individuals,ordata.

Thisdocumentcouldincludetechnicalinaccuraciesortypographicalerrors.Changesareperiodicallymadetotheinformationherein.Thesechangesmaybeincorporatedinneweditionsofthisdocument.NetIQCorporationmaymakeimprovementsinorchangestothesoftwaredescribedinthisdocumentatanytime.

U.S.GovernmentRestrictedRights:IfthesoftwareanddocumentationarebeingacquiredbyoronbehalfoftheU.S.GovernmentorbyaU.S.Governmentprimecontractororsubcontractor(atanytier),inaccordancewith48C.F.R.227.72024(forDepartmentofDefense(DOD)acquisitions)and48C.F.R.2.101and12.212(fornonDODacquisitions),thegovernmentsrightsinthesoftwareanddocumentation,includingitsrightstouse,modify,reproduce,release,perform,displayordisclosethesoftwareordocumentation,willbesubjectinallrespectstothecommerciallicenserightsandrestrictionsprovidedinthelicenseagreement.

2013NetIQCorporationanditsaffiliates.AllRightsReserved.

ForinformationaboutNetIQtrademarks,seehttps://www.netiq.com/company/legal/.

https://www.netiq.com/company/legal/

Contents

About this Book and the Library 5About NetIQ Corporation 7

1 Introduction 91.1 Driver Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101.2 How the Drivers Work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

1.2.1 Publisher Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111.2.2 Subscriber Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121.2.3 Associations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

1.3 Supported Oracle Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131.4 Key Driver Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

1.4.1 Password Synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131.4.2 Entitlements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131.4.3 Object Synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131.4.4 Driver Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131.4.5 Supported Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

1.5 Checklist for Enabling User Synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

2 Installing the Driver Files 152.1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152.2 Installing the Driver Shim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152.3 Installing the PL/SQL APIs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162.4 Updating the PL/SQL APIs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172.5 Creating a SOAP Endpoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172.6 Subscribing to the Business Events. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

3 Creating a New Driver Object 193.1 Creating the Driver Object in Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

3.1.1 Importing the Current Driver Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193.1.2 Installing the Driver Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203.1.3 Configuring the Driver Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253.1.4 Deploying the Driver Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253.1.5 Starting the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

3.2 Activating the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

4 Securing Communication 274.1 Configuring the Publisher Channel Using the KMO File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274.2 Configuring the Publisher Channel Using the Keystore File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284.3 Configuring the Subscriber Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

5 Managing the Driver 33

6 Troubleshooting the Driver 356.1 Troubleshooting Driver Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Contents 3

4 Iden

6.2 Troubleshooting Driver Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356.2.1 NDSTrace shows http connection protocol on the Publisher channel . . . . . . . . . . . . . . . . . 356.2.2 OutOfMemory Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356.2.3 The Telephone Number attribute values are not deleted on the Subscriber channel . . . . . 356.2.4 The Authentication Password is prompted when the Publisher channel is disabled

during driver creation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366.3 Increasing the memory heap size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

7 Schema Mapping 37

A Driver Properties 39A.1 Driver Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

A.1.1 Driver Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40A.1.2 Driver Object Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40A.1.3 Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40A.1.4 Startup Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41A.1.5 Driver Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41A.1.6 Global Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

A.2 Global Configuration Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43A.2.1 Password Synchronization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44A.2.2 (Conditional) Default Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45A.2.3 Entitlements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45A.2.4 Account Tracking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48A.2.5 Managed System Information . . . . . . . . . .