14 Troubleshooting the BRM Installation

Although the Oracle Communications Billing and Revenue Management (BRM) system is designed for trouble-free installation, you might encounter a problem. This chapter lists some problems other customers have encountered and describes their solutions.

For more information, see "Reference Guide to BRM Error Codes" and "Resolving Problems in Your BRM System" in BRM System Administrator's Guide.

Problems Installing the Database

For more information on errors that can occur when installing your database, see your database documentation.

Problem: Cannot Start the Oracle Listener

When you try to start the Oracle Listener, you get a ”permission denied” error.

Possible Cause

The path points to a directory for which you do not have access.


Change the permissions to the directory where the listener.ora and listener.log files are stored.

Problem: Cannot Connect to the Oracle Database as the System User

You cannot connect to the database as the system user with SQL.

Possible Causes

  • The Oracle Listener is not running.

  • Oracle cannot find a tnsnames.ora file.

  • The tnsnames.ora file does not point to a valid database.


  1. Start the Oracle Listener.

  2. Make sure the tnsnames.ora file points to your database on the specific host machine.

  3. Make sure the Oracle user's path contains the correct path to your tnsnames.ora file.

Problems Installing BRM

If you have a problem installing the BRM software or its optional components, first check the pin_setup.log file, and then the Data Manager (DM) and Connection Manager (CM) log files for possible reasons for the failure.

Problem: The Setup Script Cannot Start the CM or DM on HP-UX IA64

The pin_setup script fails when it tries to start the Connection Manager (CM) or Data Manager (DM).

Possible Cause

The manager cannot find the dld.so (HP-UX IA64) file, because the CM or DM host computer is missing the necessary C++ libraries.


Install C++ runtime libraries on the computer that will run the System Manager, and reinstall BRM. See "Overview of Hardware and Software Requirements".

Problem: HP-UX IA64 Semaphore Errors

BRM installation fails, and you receive the following error:

ORA-07279: spcre: semget error, unable to get first semaphore set.
HP-UX Error: 28: No space left on device
Additional information: 1

Possible Cause

The database host server doesn't have sufficient shared memory to perform the installation.


Set the kernel SEMMNI, SEMMNS, and SEMMAP parameters to the following values:

SEMMNI = 1000
SEMMNS = 1000
SEMMAP = 1002


If multiple applications are running on the host computer, increase the values in these parameters to handle the most demanding application's semaphore requirements.

Problem: An Error Occurred during the Move Data Process

You receive the error ”An error occurred during the move data process -132.”

Possible Cause

A BRM process is running, so the pin_setup script cannot finish executing.


Make sure you stop all existing BRM processes, and then run the pin_setup script again.

Problem: Errors Are Recorded in the Log File When dm_oracle Starts

After you install BRM and while running the pin_setup script of BRM, when the Oracle DM starts, errors are recorded in the dm_oracle.pinlog file.

Possible Cause

Cannot find the ACCOUNT_T table, as this gets created later on.


There is no solution; the error does not impact any functionality and can be ignored.

Problem: An Error Occurs in the dm_fusa.pinlog file during pin_setup of Paymentech Manager

Errors occur while running the pin_setup script of Paymentech Manager in the dm_fusa.pinlog file.

Possible Cause

The simulator is not started.


After the pin_setup of Paymentech Manager is complete, start the answer simulator to remove the errors. The simulators are in BRM_Home/bin. You start the simulator through the command line:


Problems Connecting to the Database

Conflicting settings in the pin_setup.values configuration file often cause database connection failures.

Problem: Pointer to the Wrong Database Name

The pin_setup script cannot connect to the database, and the error message in the DM log file shows that the DM is trying to connect to the incorrect database.

Possible Cause

The $MAIN_DB{'alias'} entry in the pin_setup.values file does not match the database alias.


Enter the correct name for your database; for example, pindbhostname, in the $MAIN_DB{'alias'} entry of the pin_setup.values file. Re-run the pin_setup script.

Problem: Cannot Log In to the Database

The pin_setup script cannot log in to the BRM database. The error message indicates an invalid user name or password.

Possible Cause

The $MAIN_DB{'user'} and $MAIN_DB{'password'} entries in the pin_setup.values file do not specify the correct user name and password for the BRM database. The default BRM user name and password is pin.


First, verify that you can connect to the BRM database by using the user name and password you want. If you cannot connect:

  1. Use SQL statements to set up the user and password for the BRM database.

  2. Enter the correct user name and password for the BRM database in the $MAIN_DB{'user'} and $MAIN_DB{'password'} entries in the pin_setup.values file.

  3. Re-run the pin_setup script.

Problem: Out of Memory on UNIX

The pin_setup script cannot start the DM, and the DM's error log file refers to ”bad shmget”, ”bad shmat”, or another error related to memory.

Possible Cause

There is not enough shared memory on the database server.

HP-UX IA64 Solution

Use the HP-UX SAM utility to increase the SEMMNI, SEMMNS, or SEMMAP values. For example:

SEMMNI = 1000
SEMMNS = 1000
SEMMAP = 1002


If multiple applications are running on the host computer, increase these values based on each application's shared memory requirements.

Solaris Solution

Increase the shared memory value in the /etc/system file. For example, type the following in a text editor, such as vi:

set shmsys:shminfo_shmmax=4294967295

Linux Solution

Increase the shared memory value in the /etc/sysctl.conf file. Type the following in a text editor:

  1. Log on as root.

  2. Open the /etc/sysctl.conf file.

  3. Add the following lines to the end of the file, or modify the values if these lines are already present:

    kernel.shmmax = 536870912
    kernel.shmall = 536870912
  4. Run sysctl -p from the unix prompt.