4 Installing LDAP Manager

This chapter explains how to install the Oracle Communications Billing and Revenue Management (BRM) LDAP Manager software.

Important:

LDAP Manager is an optional feature that requires a separate license.

Before you read this document, you should be familiar with BRM concepts and architecture. See "Introducing BRM" and "BRM System Architecture" in BRM Concepts, and "About LDAP Manager".

For information on customizing your BRM LDAP environment, see "Customizing Your BRM LDAP Environment".

You have to install the LDAP Manager before you can configure it. To configure the LDAP Manager, see "Configuring LDAP Manager".

System Requirements

LDAP Manager is available for the HP-UX IA64, Linux, Solaris, and AIX operating systems. For information on disk space requirements for the operating systems, see "Disk Space Requirements" in BRM Installation Guide.

Software Requirements

Before installing LDAP Manager, you must install:

Third-Party software, which includes the Perl libraries and JRE required for installing BRM components. See "Installing the Third-Party Software" in BRM Installation Guide.
BRM. See "Putting Together Your BRM System" in BRM Installation Guide.
LDAP V3 Compliant - LDAP Server.
Oracle 10g, Oracle 11g, or Oracle 12c client libraries.

Note:

While BRM does not test every available directory server, as long as you integrate with a 100 percent LDAPv3-compliant directory server, your BRM integration with that server should work.

Installing LDAP Manager

Note:

If you have already installed the product, features that are already installed cannot be reinstalled without uninstalling them first. To reinstall a feature, uninstall it and then install it again.

To install LDAP Manager:

Download the software to a temporary directory (temp_dir).
Important:
- If you download to a Windows workstation, use FTP to copy the .bin file to a temporary directory on your UNIX server.
- You must increase the heap size used by the Java Virtual Machine (JVM) before running the installation program to avoid "Out of Memory" error messages in the log file. For information, see "Increasing Heap Size to Avoid "Out of Memory" Error Messages" in BRM Installation Guide.
Go to the directory where you installed the Third-Party package and source the source.me file.

Caution:
You must source the source.me file to proceed with installation, otherwise "suitable JVM not found" and other error messages appear.

Bash shell:
```
source source.me.sh
  
```
C shell:
```
source source.me.csh
  
```
If you have a previous release of LDAP Manager installed, back up the existing BRM_Home/sys/dm_ldap/pin.conf configuration file. If you have made changes to the BRM_Home/sys/ldap.idl sample mapping file, back up this file also.

Caution:
The installation overwrites any pre-existing LDAP Manager pin.conf and ldap.idl files. If you do not back up the original files, you must manually recreate the settings in the new files to restore your original configuration.
Go to the temp_dir directory and enter this command:
```
7.5.0_LDAPMgr_platform_opt.bin
  
```
where platform is the operating system name.

Note:
You can use the -console parameter to run the installation in command-line mode. To enable a graphical user interface (GUI) installation, install a GUI application such as X Windows and set the DISPLAY environment variable before you install the software.
Follow the instructions displayed during installation. The default installation directory for LDAP Manager is opt/portal/7.5.

Note:
The installation program does not prompt you for the installation directory if BRM or LDAP Manager is already installed on the machine and automatically installs the package at the BRM_Home location.
Go to the directory where you installed the LDAP Manager package and source the source.me file:

Bash shell:
```
source source.me.sh
  
```
C shell:
```
source source.me.csh
  
```
If you backed up the original BRM_Home/sys/dm_ldap/pin.conf file in step 3, merge the contents of the backup copy into the new pin.conf file.
If you backed up the original BRM_Home/sys/ldap.idl sample mapping file, replace the newly installed file with your backup file.
Go to the BRM_Home/setup directory and run the pin_setup script.

Note:
The pin_setup script starts all required BRM processes.

Your LDAP Manager installation is now complete.

Uninstalling LDAP Manager

To uninstall LDAP Manager, run the BRM_Home/uninstaller/LDAPMgr/uninstaller.bin.