This chapter describes basic start, stop, and configuration tests for Oracle Communications Billing and Revenue Management (BRM) Pipeline Manager.
To test Pipeline Manager, follow the procedures in these sections:
Note:
To perform a test start and stop of the Pipeline Manager database, contact your database administrator.Using Pipeline Configuration Manager to Configure Pipeline Manager
Testing Single and Multiple Pipeline Rating with BRM
Important:
After testing basic pipeline operation, see "Configuring Pipeline Manager" and "Optimizing Pipeline Manager Performance" in BRM System Administrator's Guide for more information on configuration and tuning.You start Pipeline Manager by using one of the following methods:
The pin_ctl utility. See "Starting a Component by Using the pin_ctl Utility" in BRM System Administrator's Guide.
The ifw command from the Pipeline_home directory:
% Pipeline_home/bin/ifw -r RegistryFile
where RegistryFile is your registry file name.
Important:
When Pipeline Manager cannot establish a connection with the Pipeline Manager database (most likely because the database is down), you receive an error message and the Pipeline Manager startup is canceled.For more information on parameters used with the ifw command, see "Starting and Stopping Pipeline Manager Manually" in BRM System Administrator's Guide.
If there are startup issues, the system stops and sends notifications to the process log and stdout.
Note:
The path and file name of the process log are defined in the ProcessLog section of the startup registry.You stop Pipeline Manager by using the pin_ctl utility, or a semaphore. See "Starting and Stopping the BRM System" and "Starting and Stopping Pipeline Manager Manually" in BRM System Administrator's Guide.
To test Pipeline Manager without database access:
Go to the system directory.
Source the source.me.sh for the shell:
% source source.me.sh
Note:
The source.me.sh is for a bash shell. If you use a C shell, enter source.me.csh.Go to the Pipeline_home directory.
Start Pipeline Manager with the simple.reg registry file:
bin/ifw -r Pipeline_home/samples/simple/simple.reg
The system starts without a database connection and two sample EDR files are processed.
To confirm that the sample EDR files are processed, go to the Pipeline_home/samples/simple/data/out directory and open the output file.
If an error occurs:
An output reject file is created in the Pipeline_home/samples/simple/data/rej directory.
The input file is moved to the err directory. You can find it in the Pipeline_home/samples/simple/data/err directory.
Stop Pipeline Manager. See "Starting and Stopping the BRM System" in BRM System Administrator's Guide.
To test Pipeline Manager with database access:
Go to the system directory.
Source the source.me.sh for the shell:
source source.me.sh
Note:
The source.me.sh is for a bash shell. If you use a C shell, enter source.me.csh.Open the Pipeline_home/samples/simple/simple.reg file by using a text editor such as vi.
In the ifw.DataPool.PrefixDescData section:
Comment out the Source parameter entry with the File value and uncomment the entry with the Database value.
Be sure that the DataConnection parameter is set to ifw.Datapool.Login.
Be sure that the DBC module is configured with values for the UserName, PassWord, and DataBaseName parameters.
See "Database Connect (DBC)" in BRM Configuring Pipeline Rating and Discounting.
Save the file.
Start Pipeline Manager with the simple.reg registry file.
bin/ifw -r Pipeline_home/samples/simple/simple.reg
If you previously tested Pipeline Manager without a database connection, move the done EDR files from the /samples/simple/data/done directory to the /samples/simple/data/out directory and rename the file to *edr.
The system is running without a database connection; and it processes two sample EDR files.
To confirm that the sample EDR files are processed, go to the Pipeline_home/samples/simple/data/out directory and open the output file.
If an error occurs:
An output reject file is created in the Pipeline_home/samples/simple/data/rej directory.
The input file is moved to the err directory.
You can find it in the Pipeline_home/samples/simple/data/err directory.
Stop Pipeline Manager.
See "Starting and Stopping the BRM System" in BRM System Administrator's Guide.
This test uses the whole range of Pipeline Manager functions. To perform a wireless test run:
Important:
All steps in this section are required. This procedure uses a sample wireless price plan, pipeline registry file, and CDR. For your implementation, you must perform these steps using either your custom price plan and registry file or the samples.Go to the system directory.
Source the source.me.sh for the shell:
source.me.sh
Note:
The source.me.sh is for a bash shell. If you use a C shell, enter source.me.csh.Run the Pipeline_home/conf/pricingdata/Oracle/insertWIRELESS_SAMPLE.pl script.
insertWIRELESS_SAMPLE.pl
This script loads the sample wireless price plan configuration into your Pipeline Manager database.
Note:
If you ran this script in a previous test, you do not have to run it again.Open a sample wireless registry file.
For single pipeline testing: Pipeline_home/conf/wireless.reg.
Tip:
To isolate potential problems, perform a single pipeline test first.Be sure that the DBC module is configured with values for the UserName, PassWord, and DataBaseName parameters.
See Database Connect (DBC) in BRM Configuring Pipeline Rating and Discounting.
Start Pipeline Manager.
For single pipeline testing, use the wireless.reg registry file:
bin/ifw -r conf/wireless.reg
Create sample CDRs.
See "Creating a Sample CDR File".
Important:
Use the file naming format teststring.edr, where string is any string. The CDRs must match your BRM data (service, origin, timestamps).Stop Pipeline Manager.
See "Starting and Stopping the BRM System" in BRM System Administrator's Guide.
Your sample CDR must be formatted using:
Plain ASCII
Semi-colon-separated
One record per line
All lines, including the last record, must end with a NL (new line) character.
service-code;a-number;b-number;start-time;duration;vol-sent;vol-recieved;callclass;cell-id;apn
Table 20-1 describes CDR field formats and restrictions:
| Field | Description and Format |
|---|---|
|
service-code |
The service code. Maximum length: 3 characters. The following service code values are predefined in the sample rate plan:
|
|
a-number |
The call's originating number. Maximum length: 40 characters. Sample value: 00491729183333 |
|
b-number |
The call's target number. Maximum length: 40 characters. Sample value: 004941067600 |
|
start-time |
The call start time. Format: YYYYMMDDHHMISS Sample values: 20011114184510 (for '14.11.2001 18:45:10') |
|
duration |
The call duration in seconds. Maximum length: 11 digits. Sample value: 300 (for 5 minutes) |
|
vol-sent |
The number of bytes sent in the call. Maximum length: 11 digits. Sample value: (1024 for 1 KB) |
|
vol-received |
The number of bytes received in the call. Maximum length: 11 digits. Sample value: (1024 for 1 KB) |
|
(Optional) callclass |
The class of call. Maximum length: 5 characters. The following call class values are predefined in the sample rate plan:
|
|
apn |
The access point name for the call. Maximum length: 64 characters. Sample use: specifying the URL for GPRS |
Example 20-2 Sample CDR Records
TEL;00491729183333;004941067600;20011114184510;300;0;0;;; TEL;00491729183333;004941067600;20011114184510;300;0;0;Mail;47113; TEL;00491729183333;004941067600;20011114184510;300;0;0;Conf;98765; TEL;00491729183333;004941067600;20011114184510;300;0;0;MOC;238476; TEL;00491732410;004941067600;20011114184300;300;0;0;NORM;123456; TEL;00491732411;004941067600;20011114184300;270;0;0;NORM;123456; TEL;00491732412;004941067600;20011114184300;110;0;0;NORM;123456; DAT;00491732413;004941067600;20011114184300;50;0;0;NORM;123456; FAX;00491732414;004941067600;20011114184300;12;0;0;NORM;123456; TEL;00491732415;004941067600;20011114184300;1;0;0;NORM;123456; SMS;00491732416;004941067600;20011114184300;63;0;0;NORM;123456; TEL;00491732417;004941067600;20011114184300;37;0;0;NORM;123456; TEL;00491732418;004941067600;20011114184300;132;0;0;NORM;123456; TEL;00491732419;004941067600;20011114184300;60;0;0;NORM;123456; GPR;00491732410;0049;20011114184510;300;78965;5054;;001121;hamburg.portal.com
If you cannot start Pipeline Manager, it can be due to the following problems or errors:
Note:
Error messages are written into the process log file and into the pipeline log files. For more information on pipeline log files, see "About Pipeline Manager Log Files" in BRM System Administrator's Guide.The user environment is not set correctly.
Solution: Correct the errors in the environment settings.
The registry contains errors.
Solution: Check the registry for type errors, missing brackets, missing or incorrect entries, and so on.
Note:
Registry entries are case-sensitive.Paths are missing.
Solution: Create the missing paths according to the definition in the startup registry.
A lock file already exists.
Solution: If the BRM framework has not been stopped correctly, a lock file already exists. Delete the lock file and then stop and restart Pipeline Manager framework.
The database is not opened/the listener has not been started.
Solution: Open the database and start the listener.
The database entries contain errors.
Solution: Check the created database schemes.