Whitepaper on OCBRM 7.3.

1 Installation

With Oracle Linux X86_64 and Oracle DB 10G

Oracle Linux 5 (64 bit.) -->oracle database 10G (64 bit.)-->Oracle Communications Billing and Revenue Management 7.3.1 2

Table of Contents
Summary............................................................................................................ ..........................................3 Installation of oracle enterprise Linux 5 X86_64 ..........................................................................................4 Install oracle enterprise Linux X86_64 as per installation document download with software ..........4 Install following packages to install oracle database 10G 64 bit without much issues. Some of these packages are not listed by Oracle DB installation guide.......................................................................4 Install the following package after installing the above mandatory packages.....................................4 After installing the above package list the installed files/dir for confirmation ....................................5 Installation of Oracle database 10G on oracle Linux X86_64 .......................................................................5 As a root user perform the following tasks ..............................................................................................5 Set kernel parameters......................................................................................................... .................5 Run the following command to change the current kernel parameters ..............................................6 Add the following lines to the "/etc/security/limits.conf" file .............................................................6 Disable secure linux by editing the "/etc/selinux/config" file ..............................................................7

Create the new groups and users .........................................................................................................7 Create the directories in which the Oracle software will be installed..................................................7 Login as root and issue the following command ..................................................................................8 Login as oracle user and do the following ................................................................................................8 Add the following lines at the end of the ".bash_profile" file ..............................................................8 Change /etc/redhat-release entry ........................................................................................................9 Set additional soft link .................................................................................................................... ....10 Unpack oracle software and start installer.............................................................................................10 Set additional soft links for installer ...................................................................................................11 Installation of OCBRM 7.3.1................................................................................................................... .....12 Setting up user and permissions........................................................................................................ .12 Creating TNSADMIN directory ............................................................................................................ 12 Creating BRM tablespaces ....................................................................................................... ...........12 Creating the BRM user for Oracle on UNIX.........................................................................................13 3 Granting execute permission for dbms_lock......................................................................................14 Installing the Third-Party software .....................................................................................................14 Installing BRM base................................................................................................................... .........15 Target directory is /opt/portal/7.3 ................................................................................................... ..15 Installing OCBRM pipeline manager and other components ............................................................16 Observations ..................................................................................................... .........................................16

Summary

This white paper discusses the installation procedure of Oracle Communications Billing and Revenue Management 7.3.1 on Oracle Linux Release 5 of x86_64 (64 bit) with Oracle database 10G for X86_64. The installation of Oracle database 10G on Oracle Linux X86_64 and OCBRM 7.3.1 is a messy task. It has few issues discussed neither by installation guide downloaded with software nor the installation procedures on web. This white paper highlights those issues and put the answers together. This white paper can be used as trail OCBRM 7.X versions installation guide when installing for service providers on large scale servers.
4

Installation of oracle enterprise Linux 5 X86_64

Install oracle enterprise Linux X86_64 as per installation document download with software Install following packages to install oracle database 10G 64 bit without much issues. Some of these packages are not listed by Oracle DB installation guide

compat-gcc-34-c++-3.4.6-4.x86_64.rpm compat-libstdc++-33-3.2.3-61.x86_64.rpm compat-gcc-34-g77-3.4.6-4.x86_64.rpm compat-glibc-headers-2.3.4-2.26.x86_64.rpm compat-gcc-34-3.4.6-4.x86_64.rpm compat-glibc-2.3.4-2.26.x86_64.rpm compat-libf2c-34-3.4.6-4.x86_64.rpm compat-db-4.2.52-5.1.x86_64.rpm compat-libstdc++-33-3.2.3-61.i386.rpm compat-libstdc++-296-2.96-138.i386.rpm compat-libgcc-296-2.96-138.i386.rpm compat-libf2c-34-3.4.6-4.i386.rpm compat-glibc-2.3.4-2.26.i386.rpm compat-db-4.2.52-5.1.i386.rpm glibc-devel-2.3.4-2.39.i386.rpm glibc-2.3.4-2.41.src.rpm

Install the following package after installing the above mandatory packages

xorg-x11-deprecated-libs-6.8.2-1.EL.19.i386.rpm

5 After installing the above package list the installed files/dir for confirmation

[root@localhost ~]# ls -lrt /usr/X11R6/ total 12 drwxr-xr-x 2 root root 4096 Aug 17 17:18 lib

drwxr-xr-x 2 root root 4096 Aug 17 22:00 bin

Installation of Oracle database 10G on oracle Linux X86_64

As a root user perform the following tasks
Set kernel parameters Add or amend the following lines in the "/etc/sysctl.conf" file 6

fs.suid_dumpable = 1 fs.aio-max-nr = 1048576 fs.file-max = 6815744 kernel.shmall = 2097152 kernel.shmmax = 536870912 kernel.shmmni = 4096 # semaphores: semmsl, semmns, semopm, semmni kernel.sem = 250 32000 100 128 net.ipv4.ip_local_port_range = 9000 65500 net.core.rmem_default=4194304 net.core.rmem_max=4194304 net.core.wmem_default=262144 net.core.wmem_max=1048586 /sbin/sysctl -p oracle oracle oracle oracle oracle

Run the following command to change the current kernel parameters Add the following lines to the "/etc/security/limits.conf" file 7

soft nproc 2047 hard nproc 16384 soft nofile 1024 hard nofile 65536 soft stack 10240

Disable secure linux by editing the "/etc/selinux/config" file

SELINUX=disabled

Create the new groups and users

groupadd -g 501 oinstall groupadd -g 502 dba groupadd -g 503 oper groupadd -g 504 asmadmin groupadd -g 506 asmdba groupadd -g 505 asmoper useradd -u 502 -g oinstall -G dba,asmdba,oper oracle passwd oracle
Create the directories in which the Oracle software will be installed 8

mkdir -p /opt/app/oracle/product/10.2.0/db_1 chown -R oracle:oinstall /opt chmod -R 775 /opt

Login as root and issue the following command

xhost +<machine-name>

Login as oracle user and do the following

Add the following lines at the end of the ".bash_profile" file 9

# Oracle Settings TMP=/tmp; export TMP TMPDIR=$TMP; export TMPDIR ORACLE_HOSTNAME=<your host name>; export ORACLE_HOSTNAME ORACLE_UNQNAME=PINDB; export ORACLE_UNQNAME ORACLE_BASE=/opt/app/oracle; export ORACLE_BASE ORACLE_HOME=$ORACLE_BASE/product/10.2.0/db_1; export ORACLE_HOME ORACLE_SID=PINDB; export ORACLE_SID PATH=/usr/sbin:$PATH; export PATH PATH=$ORACLE_HOME/bin:$PATH; export PATH NLS_LANG=American_America.UTF8;export NLS_LANG LD_LIBRARY_PATH=$ORACLE_HOME/lib:/lib:/usr/lib; export LD_LIBRARY_PATH CLASSPATH=$ORACLE_HOME/jlib:$ORACLE_HOME/rdbms/jlib; export CLASSPATH
Change /etc/redhat-release entry

This is very important change .Otherwise oracle universal installer fails with the error
Checking operating system version: must be redhat-3, SuSE-9, redhat-4, UnitedLinux-1.0, asianux-1 or asianux-2

Set the value to Red Hat Enterprise Linux AS release 4 (Nahant Update 4)
Set additional parameters 10

LD_LIBRARY_PATH=$LD_LIBRARY_PATH: /usr/X11R6/lib/ export LD_LIBRARY_PATH LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$ORACLE_HOME/lib32 export LD_LIBRARY_PATH

Set additional soft link

Oracle installer fails with oracle network configuration issue if we dont set this link. Goto /usr/lib ln s /usr/X11R6/lib/libXp.so.6 libXp.so.6

Unpack oracle software and start installer

Create a database called PINDB. Goto /home/oracle (or oracle user home directory where software downloaded) gunzip 10201_database_linux_x86_64.cpio.zip cpio -idmv < 10201_database_linux_x86_64.cpio goto /home/oracle/database ./runInstaller

11 Set additional soft links for installer

Oracle 10G installer has a bug in setting some of important soft links. Oracle universal installer fails in configuration file creation if we dont create these soft links. When oracle universal installer fails in network configuration or any other configuration then open a new terminal and create these soft links. Restart the failed step. Normally OUI fails in Network configuration Assistant step. cd into $ORACLE_HOME/bin then type: ln -s $ORACLE_HOME/lib/libnjni10.dylib $ORACLE_HOME/lib/libnjni10 , then ENTER then type: ln -s $ORACLE_HOME/lib/libclntsh.dylib $ORACLE_HOME/lib/libclntsh.dylib.10.1
12

Installation of OCBRM 7.3.1

Check general installation guidelines like software and hardware requirements in OCBRM installation guide .This white paper only discusses the important parts of installations and the highlights the parts where there are bollocks.Assume we are under bash shell. Setting up user and permissions

su root useradd d /home/pin chown R pin /opt chmod R 775 /opt cp /home/oracle/.bash_profile /home/pin/

Creating TNSADMIN directory Create a directory called TNSADMIN and create listener.ora, tnsnames.ora and sqlnet.ora. Set TNS_ADMIN environment parameter. Set this in .bash_profile for permanent setup. TNS_ADMIN=/home/pin/TNSADMIN ;export TNSADMIN Creating BRM tablespaces Create a directory for the tablespaces, such as /opt/app/oradata/pindb. This directory is referred to as table_location. Connect to the Oracle database with SQL*Plus: % sqlplus system/manager@DatabaseAlias 13 Create the data, index, and temporary tablespaces, making sure: Data tablespaces are at least 600 MB with an extent (next) size of 64 KB. Index tablespaces are at least 400 MB with an extent size of 64 KB. Temporary tablespaces are at least 100 MB with an extent size of 64 KB. Creating the BRM user for Oracle on UNIX

Connect to the Oracle database with SQL*Plus: % sqlplus system/manager@DatabaseAlias

Create the Oracle user pin, grant the user the resource to connect to Oracle with the username pin, and allow pin access to the pin00 and PINTEMP tablespaces.
SQL> create tablespace pin00 datafile 'table_location/pin00.dbf' size 600M reuse autoextend on default storage( initial 64K next 64K pctincrease 0 ); Tablespace created. SQL> create tablespace pinx00 datafile 'table_location/pinx00.dbf' size 400M reuse autoextend on default storage( initial 64K next 64K pctincrease 0 ); Tablespace created. SQL> create temporary tablespace PINTEMP tempfile 'table_location/PINTEMP.dbf' size 100M reuse autoextend on maxsize unlimited storage(initial 64K next 64K pctincrease 0); --This temp tablespace creation has a syntax problem.Check for correct syntax accordingly . Tablespace created. 14

SQL> create user pin identified by password; User created. SQL> grant resource, connect to pin; Grant succeeded. SQL> alter user pin default tablespace pin00; User altered. SQL> alter user pin temporary tablespace PINTEMP; User altered. SQL>exit.
Granting execute permission for dbms_lock

Log in to your database as user SYS: % sqlplus "sys/password@databaseAlias as sysdba" where: password is the Oracle database user password. databaseAlias is the Oracle database alias. Grant execute privileges to pin SQL> grant execute on dbms_lock to pin;
Installing the Third-Party software 15

Target directory is /opt/portal/ThirdParty Create a dir temp user /home/pin. Download 7.3.1_ThirdParty_linux_32_opt.bin into /home/pin/temp. Goto /home/pin/temp. Run 7.3.1_ThirdParty_linux_32_opt.bin. After the installation completes, the installation program displays a message reminding you to execute the source command: source source.me.sh To finish the installation, click Finish.
Installing BRM base

Target directory is /opt/portal/7.3 Download 7.3.1_Portal_Base_linux_32_opt.bin into /home/pin/temp . Go to /home/pin/temp Run 7.3.1_Portal_Base_linux_32_opt.bin Follow default installation steps. Source source.me.sh Here there is a bug. source.me.sh will corrupt existing environment variables. Follow these steps to overcome this issue. Goto /opt/poral/7.3 Cp source.me.sh source.me.sh.orig Change the source.me.sh to the following. TPSOURCE=/opt/portal/ThirdParty;export TPSOURCE PIN_HOME=/opt/portal/7.3;export PIN_HOME
16

PIN_LOG_DIR=/opt/portal/7.3/var;export PIN_LOG_DIR LIBRARYEXTENSION=.so;export LIBRARYEXTENSION LIBRARYPREFIX=lib;export LIBRARYPREFIX PERL5LIB=$PERL5LIB:$PIN_HOME/lib;export PERL5LIB PATH=$PATH:$PIN_HOME/bin;export PATH LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$PIN_HOME/lib;export LD_LIBRARY_PATH SHLIB_PATH=$PIN_HOME/lib;export SHLIB_PATH LIBPATH=$TPSOURCE/perl/5.8.0/bin:$PIN_HOME/bin: $PIN_HOME/lib;export LIBPATH Execute source source.me.sh
Installing OCBRM pipeline manager and other components

Once Oracle database is installed successfully and OCBRM installed on it .Installation of pipeline manager and other OCBRM 7.3.1 components are absolutely as per the installation document provide with OCBRM 7.3.1 documentation .

Observations

OCBRM requires 64 bit operating system . OCBRM 7.3.1 wont support oracle database version 11G. OCBRM 7.4 version supports oracle database version 11G but it needs 32 bit oracle database libraries for its dm_oracle component .These 32 bit libraries wont be import with oracle database 11G 64bit .