The Paradox of Choice

Oracle Net database names resolution is a highly-scalable, centralized alternative to tnsnames.ora files. Lots of companies have older versions but the installation of the current version ODSM can be frustrating, daunting, and frankly impossible with the limited documentation available.  Plenty of Oracle documents describe how to install and configure ODSM, Identity Manager, SOA, and SSO. But all of the documents cover such a broad range of options that it’s incredibly easy to get side-tracked or fooled.

Chapter 8 of Oracle® Fusion Middleware Installation Guide for Oracle Identity Management 11g Release 1 (11.1.1.7.0) document E12002-12 describes the installation and configuration process for each option.  This article boils it down to what you need for this ODSM on a new server.

Component Downloads

The complete installation of ODSM for Linux consists of only two downloads:

  • WebLogic 10.3.6
  • Oracle Identity Manager OIM 11g Patch Set 6, Oracle part #V37386-04

This installation does not require the extra schemas included in the Repository Creation Utility.  An installer for the single schema we’ll need for names resolution is included in the OIM installer.

Java Installation

The WLS server and database both contain their own complete, compatable versions of Java.  You need a copy of JRE 1.6.0 to install the WLS server, so the reference the java home in your Oracle database binaries during the WLS installation.  I installed a stand-alone Java home to reduce reduce reliance on the database home.  It’s up to you.

Repository Database

Each ODSM installation requires a separate Oracle 11g database for the LDAP repository.  Build the database before you start the ODSM installation.

There are no extraordinary parameters required for the database and the overhead can be quite small.  As a result, this is one case where you should consider installing the database and ODSM application on the same host (!).  In our environment we stood up a cluster of ODSM servers on a handful of independent VMs.  LDAP replication within the ODSM application server precludes the need for database backups, high availability, and dedicated DR instances.  Simple and robust.

Note: The ODSM installation connects to the repository database as sys/sysdba so you must have a working password file (orapwd) for the repository database, even if the database and ODSM server are on the same machine.

WebLogic Server

After the repository database is ready, install WLS 10.3.6.  WLS is possibly the simplest installation in the Oracle catalog.

  • Download WLS 10.3.6
  • Ensure that you have a complete JRE installation
  • Create your Middleware home directory, typically located under $ORACLE_BASE\Middleware
  • Invoke the installer with java -jar wls1036_generic.jar and follow the prompts

Install and Configure ODSM

ODSM server installation and configuration both run as a single OUI event.  Instantiate OUI from Disk 1 of the installation media, with a simple runInstaller.  JRE paths and 64-bit flags are not required for the Linux installation.

Screen

Field

Action

Welcome ​Next button ​Click-through
Install Software Updates ​Radio button ​Select Skip Software Updates
​Select Installation Type Radio button ​Select Install and Configure
​Prerequisite Checks No issues should be reported
​Select Domain ​ ​ Radio button ​Select Create New Domain
​User name & password Weblogic username and password
​Domain Name IDMDomain (default)
​Specify Installation Location ​ ​ ​ ​Accept all defaults
​Oracle Home Directory ​Accept default Oracle_IDM1
​Weblogic Server ​WLS in wlserver_10.3
​Instance location ​asinst_1
​Security Update Your credentials
​Configure Components ​This is the most important step of all:Un-check everything except Oracle Inventory Directory

Management Components are required

​Configure Ports ​Auto Port Configuration
​Specify Schema Database Create SchemaConnect string = hostname:port:SID

Login as sys; installer adds sysdba internally

​Enter OID Passwords
​LDAP configuration Accept default settings for LDAP settings
​Installation Sumary Radio button ​Review and then press Finish
​Manual tasks during installation ​Another terminal ​Partway through installation you are required to execute a root scriptOpen a second terminal to watch the configuration log. The GUI doesn’t provide much feedback during configuration but a lot happens
​Save the installation summary file
Type: Install and ConfigureLocation: /oraclebase/Middleware/Oracle_IDM1
Disk Space
Required: 2200 MB
Available: 90024 MB
Free After Install: 87764 MB
Applications Selected For Install
Oracle Internet Directory
Oracle Directory Integration Platform
Oracle Virtual Directory
Oracle Identity Federation
Oracle HTTP Server
Oracle Directory Service Manager
Enterprise Manager
Applications Selected For Configuration
Oracle Internet Directory
Enterprise Manager
Oracle Directory Service Manager
Middleware Home Location : /oraclebase/Middleware
Oracle Instance Location : /oraclebase/Middleware/asinst_1
Oracle Instance : asinst_1
Domain Option : Create Domain
Domain Name : IDMDomain
Domain Home : /oraclebase/Middleware/user_projects/domains/IDMDomain
Domain Host Name : <yours>
Domain Port : 7001
Weblogic Console : http://<yourhostname>:7001/console
Weblogic User Name : weblogic
Automatic Port Detection : true
Enterprise Manager :
http://<yourhostname>:7001/em
Enterprise Manager Agent
http://<yourhostname>:5162/emd/main
Oracle Internet Directory
SSL Port : 3131
Non SSL Port : 3060
Database : <Your connect string>
Oracle Directory Services Manager :
http://<yourhostbame>:7005/odsm/faces/odsm.jspx

Finally, test all of the URLs and find another document about configuring and working with the ODSM LDAP tree.