2 Installing Collections Manager

This chapter explains how to install the Oracle Communications Billing and Revenue Management (BRM) Collections Manager software. Installation includes both client and server components.


Collections Manager Reports are installed separately. See "Installing BRM Reports" in BRM Reports.

Before you read this chapter, you should be familiar with BRM concepts and architecture. See "Introducing BRM", "BRM System Architecture" in BRM Concepts, and "Understanding Collections Manager".

Installing Server Components

The BRM Collections Manager server components include opcodes, utilities, and storable classes. You install these components in the BRM_Home directory.

System Requirements

The Collections Manager server components are supported on the HP-UX IA64, Solaris, Linux, and AIX operating systems. For information on disk space requirements for these operating systems, see "Disk Space Requirements" in BRM Installation Guide.

Software Requirements

Before installing the BRM Collections Manager server components, you must install:

Installing BRM Collections Manager Server Components


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 BRM Collections Manager server components:

  1. Download the software to a temporary directory (temp_dir).


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

  2. Go to the directory where you installed the Third-Party package and source the source.me file.


    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
  3. Go to the temp_dir directory and enter this command:


    where platform is the operating system name.


    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.
  4. Follow the instructions displayed during installation. The default installation directory for Collections Manager is opt/portal/7.5.


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

    Bash shell:

    source source.me.sh

    C shell:

    source source.me.csh
  6. Go to the BRM_Home/setup directory and run the pin_setup script.


    The pin_setup script starts all required BRM processes.
  7. If your event tables are partitioned, run the partition_utils utility with the -o update parameter from the BRM_Home/apps/partition_utils directory:

    perl partition_utils.pl -o update

    For more information, see "Updating Partitions" and "partition_utils" in BRM System Administrator's Guide.

  8. Start all BRM processes. See "Starting and Stopping the BRM System" in BRM System Administrator's Guide.

Your Collections Manager installation is now complete.

Configuring the pin_bill_day Script to Run Collections

To run collections automatically, you need to edit the pin_bill_day script.

  1. Open the pin_bill_day script in a text editor. The script is located in BRM_Home/bin.

  2. Find the Collections Manager section of the script. If the following lines are commented out, remove the comment marks:

    cd ${PINDIR}/apps/pin_collections
  3. Save and close the file.

Uninstalling BRM Collections Manager Server Components

To uninstall BRM Collections Manager, run the BRM_Home/uninstaller/CollectionsMgr/uninstaller.bin.

Installing BRM Collections Manager Client Components

BRM Collections Manager includes two client applications:

  • Collections Configuration

  • Collections Center

The client applications are supported on Windows platforms only. You can install them in multiple locations, in any combination. Neither application requires the other.

System Requirements

You can install the client applications on Windows.

Hardware Requirements

Table 2-1 shows the disk space required by client applications to download, extract, and install the software:

Table 2-1 Disk Space Requirements

Application Required Space (MB)

Collections Configuration


Collections Center



Collections Configuration and Collections Center require the Java Runtime Environment (JRE). It is included in both application packages and is approximately 50 MB. When the JRE gets installed with a BRM client application, it is not installed again.

Software Requirements

Before installing BRM Collections Manager, you must install:

Installation Procedures

You install the BRM Collections Manager client components in the same way that you install other BRM clients. Both components are installed separately. See "Installing BRM Client Applications on Windows" in BRM Installation Guide.

Uninstalling BRM Collections Manager Client Components

To uninstall BRM Collections Configuration, choose Start - Programs -  Portal - Uninstall Collections Configurations and answer the prompts.

To uninstall BRM Collections Center, choose Start - Programs -  Portal - Uninstall Collections Center and answer the prompts.

What's Next?

After you install BRM Collections Manager, you need to set it up. See "Setting Up Collections Manager".