Professional Documents
Culture Documents
R360-Installation Guide PDF
R360-Installation Guide PDF
Installation Guide
Version 1.0.R160817
Mobileum, Inc.
2880 Lakeside Drive, Suite #135
Santa Clara, CA 95054 USA
Phone: +1-408-486-3701
Fax: +1-408-520-4589
www.mobileum.com
LEGAL INFORMATION
2016 Mobileum, Inc. All rights reserved. This document is subject to change. This document and the information herein are
provided for the sole use of the intended recipient(s) and for information purposes only. This document contains contents
which are the confidential and proprietary information of Mobileum and/or its licensors. Mobileum may have patents, patent
applications, trademarks, copyrights, or other intellectual property rights covering the subject matter hereof. Unless
specifically set forth in a separate written agreement signed by Mobileum, the furnishing of this document does not give you
any license to these patents, trademarks, copyrights, or other intellectual property. Mobileum, the names of its products,
services, and their respective logos are registered trade or service marks of Mobileum, Inc. This document may not be
modified, reproduced, or transmitted in any form or by any means, electronic or mechanical, for any purpose, without
Mobileums prior written permission. Mobileum, Inc. makes no warranty, express or implied, with this document or the
information contained herein.
Revision History
Date
Revision No.
Description
Aug-25-2016
01
Initial release.
For detailed information on the additions, modifications, and
deprecations made to this release, refer to the Whats New in
This Guide section on page 171.
Contents
Preface ............................................................................................................................. vi
iv
Importing R360-1.0-js-reports.zip file and configuring permissions for the reports module....... 123
Configuring IPProbe platform component for packet data support.................................................. 127
Configuring IPProbe platform component for SIP support............................................................ 133
Configuring IPProbe platform component for Diameter support..................................................... 140
Configuring VIPTracker ................................................................................................... 149
Configuring APPPARAMS database table................................................................................ 150
Adding or Enabling a New Home in R360............................................................................... 150
Configuring R360 for Roamer List Application.......................................................................... 151
Modifying GetImsiList.sh................................................................................... 151
Configuring Roamer List Application Parameters in Database......................................... 152
Modifying imaslight.properties for R360 EasyToUseSMS trace ........................................ 153
Configuring Parameters in APPPARAMS Table........................................................... 153
Configuring Group Level Access Parameters in Database.............................................. 153
Configuring Default Groups and Users with Different Access Rights for Tracer..................... 154
List of Tables
TABLE 1 HOW THIS GUIDE I S O RGANIZED ...................................................................................................... VI
TABLE 2 RELATED D OCUMENTS..................................................................................................................... VII
TABLE 3 DOCUMENT CONVENTIONS............................................................................................................. VIII
TABLE 4 R360 CONVENTIONS ....................................................................................................................... IX
TABLE 5 ABBREVIATIONS AND ACRONYMS ...................................................................................................... IX
TABLE 6 PRE-I NSTALLATION CHECKLIST ........................................................................................................ 15
TABLE 7 I NSTALLATION PACKAGES................................................................................................................ 16
TABLE 8 SQL COMMANDS TO CREATE THE R360 SCHEMA ........................................................................... 26
TABLE 9 PARAMETERS IN THE STATSWRITER.CFG FILE .................................................................................... 40
TABLE 10 PARAMETERS IN THE STATSWRITER_2.CFG FILE.............................................................................. 55
TABLE 11 PARAMETERS IN THE TXNWRITER.CFG FILE..................................................................................... 69
TABLE 12 PARAMETERS IN THE RQMALERTER.PROPERTIES FILE ...................................................................... 87
TABLE 13 PARAMETERS IN THE RQMAGGREGATOR.PROPERTIES FILE .............................................................. 96
TABLE 14 PARAMETERS IN THE RQMSCCPAGGREGATOR.PROPERTIES FILE ..................................................... 101
TABLE 15 FIELDS IN THE RQMDETAILAGGREGATOR.PROPERTIES FILE ............................................................ 105
TABLE 16 PARAMETERS IN THE CSV FILES .................................................................................................. 110
TABLE 17 PARAMETERS IN THE SDS_SERVICE_CO NFIG DATABASE TABLE............................................... 115
TABLE 18 EXAMPLES OF HOST NAMES AND THEIR IDS................................................................................ 116
TABLE 19 EXAMPLES OF HOST ALLIANCE NAMES, THEIR IDS, AND HOST IDS............................................... 116
TABLE 20 EXAMPLES OF ENTRIES IN THE RQM _USER DATABASE TABLE ........................................................ 116
TABLE 21 PARAMETERS IN THE RQMUPLOAD.PROPERTIES FILE .................................................................... 117
TABLE 22 EXAMPLE OF THE HOST ID AND ADDRESS IN THE RQM_TRACEHOST DATABASE TABLE ............ 121
TABLE 23 DETAILS OF THE CARRIER ID AND TRACE HOST ............................................................................ 122
TABLE 24 FIELDS IN THE EDIT DATA SOURCE PAGE ...................................................................................... 126
TABLE 25 PARAMETERS IN THE IPPROBE.CFG FILE FOR PACKET DATA SUPPORT ........................................... 127
TABLE 26 PARAMETERS IN THE IPPROBE.CFG FILE FOR SIP SUPPORT........................................................... 134
TABLE 27 PARAMETERS IN THE IPPROBE.CFG FILE FOR DIAMETER SUPPORT ................................................ 141
TABLE 28 DETAILS OF THE SNMP_URI_LIST PARAMETER IN THE APPPARAMS DATABASE TABLE ................ 150
TABLE 29 PARAMETERS IN THE G ETI MSILIST.SH FILE................................................................................... 151
TABLE 30 PARAMETERS IN THE APPPARAMS TABLE FOR APPID S823 (ROAMER LIST) ............................. 152
TABLE 31 PARAMETERS IN THE APPPARAMS TABLE FOR APPIDS S824 AND S825 .................................. 153
TABLE 32 PARAMETERS IN THE APPAUTHO RIZATION TABLE FOR APPIDS S824 AND S822 ................... 153
TABLE 33 LOG IN DETAILS FOR ACCESS TO TRACES...................................................................................... 154
TABLE 34 PARAMETERS IN THE COORDINATOR.PROPERTIES FILE .................................................................. 157
TABLE 35 ADDITIONS ................................................................................................................................ 171
Preface
Important
Effective February 24, 2014, Roamware, Inc. has been renamed to Mobileum,
Inc. However, this document may contain references to Roamware, particularly in
program artifacts, product and platform component names, and so on.
This preface describes the purpose of and intended audience for the Roaming 360 (R360)
Installation Guide. It also describes how this guide is organized, publications related to this
guide, conventions used across this guide, and how to contact Mobileum, if required.
Intended Audience
This guide is intended for IT administrators, telecommunications engineers, and other
operations and maintenance staff who are responsible for installing, configuring, and
managing the R360 applications.
T AB L E 1 HO W T H I S G U I D E I S O R G AN I Z E D
Chapter
Description
Deploying R360 on
vii
Chapter
Description
C onfiguring R360 on
Hadoop on page 156
Roaming Replicator
Handling in the R360
Application on page 167
Related Documents
Table 2 on page vii lists and describes the other documents related to this guide. These
documents are specific to the prerequisite operating systems, databases, and Mobileum
platform components and modules.
T AB L E 2 RE L ATE D DO C U ME N TS
Item
Description
Database Documentation
Oracle Database 10g
viii
Document Conventions
Table 3 on page viii describes the conventions used in all Mobileum product documentation.
T AB L E 3 DO C U ME N T C O N V E N TI O N S
Convention
Description
Italics
Emphasis
Quotes
Bold
GUI text
User input
{ F i x ed W id t h }
F i x e d W i dt h
Program codes
File extensions
Function names
C LI text
Sample outputs
F i x e d W i dt h Bo l d
Link
URL links
E-mail addresses
R360 Conventions
As mentioned in the Typographic Conventions, { T e x t_ t o _c u s to m is e } indicates a
placeholder for something that you must customize depending on the module and the
component you are installing.
ix
The following list enumerates the various placeholders you will encounter during the R360
installation process.
T AB L E 4 R360 C O N V E N TI O N S
This
Represents
{ M o b il e u m_ C D RO M }
The root directory for all the Mobileum SDS installable files. By
default, this would be the root directory of the Mobileum SDS
C D-ROM.
{ I n s ta l l _H o m e}
{ R o a mw a r e_ H o me }
The root directory for all the installed Mobileum SDS files. For
example, / o p t / Ro a m wa r e .
The directory for all the installed Tomcat files.
{ T o m ca t _ Ho m e }
For example,
/ o p t /R o a mw a r e/ r o am w a re / ad m i n/ j a ka r t a- t o mc a t6.1.20.
The directory for all the installed Oracle Software.
{ O r a cl e _ Ho m e }
For example, / e x p o rt / h om e / or a cl e .
The directory for all the installed M y S Q L files.
{ M y S QL _ H om e }
For example, / u s r / lo c a l/ m y sq l .
{ L D _ Li b r ar y _ pa t h }
{ A N T _H o m e}
The directory from where the shared libraries are picked up.
Directory where ANT software is installed.
For example, /o p t / Ro a m wa r e /a p a ch e - an t - 1. 6 .1 / b in .
Represents
CL
C ancel Location
IDD
IMSI
IRDB
ISUP
MSISDN
MSRN
PSI
SIO
UL
Update Location
Documentation Support
To provide feedback on documentation, send e-mail to docsupport@mobileum.com.
Customer Support
If you have any problems with, questions on, or feedback about Mobileum products, send email to customer.support@mobileum.com.
1
Preparing for Installation
Preparing for the installation of the R360 application involves verifying that the target system
complies with the prescribed hardware, software, and network requirements. Then, perform
the required pre-installation tasks. Finally, complete the provided pre-installation checklist
and verify that you have the correct installation packages.
This chapter contains the following topics:
In this mode, the R360 application is deployed only on the Mobileum SDS platform
component along with the respective configurations required by the R360 application for its
effective functioning.
To deploy the R360 application in this mode, refer to the following sections:
Hadoop-based
deployment mode
1.
2.
Additional Hadoop components Oozie services, Zoo Keeper services, and Hue services
12
The following MapReduce (MR) and Pig jobs are scheduled to run from the DataNodes:
Figure 1 on 12 shows a typical Mobileum Wisdom platform where the components are
deployed.
FI G U R E 1 C O MP O N E N TS DE P L O YME N T I N TH E M O B I L E U M W I S D O M P L ATF O R M
NameNode
NameNode
DataNodes
Following MR and Pig Jobs will be
scheduled on the DataNodes:
1. Master Pig Job
2. Roamer Duration MR & Pig Jobs
3. Current Roamer Pig Job
4. Registration MR & Pig Jobs
DataNode 2
DataNode 1
To deploy the R360 application in this mode, refer to the following sections:
13
1.
2.
3.
4.
Installation Prerequisites
Before installing the R360 application, you must ensure that the system where you want to
install the R360 application meets the hardware, software, network prerequisites listed in the
below section.
This section contains the following topics:
Hardware Prerequisites
For hardware prerequisites, contact your accounts Mobileum Professional Services
Organization (PSO) representative.
Software Prerequisites
Before installing the R360 application, be sure to install the software listed below. These
must be installed on the same target system where you want to install the R360 application.
Important
The Mobileum application labels, mentioned below, are subject to change. Refer to
R360 1.0 Release Notes for the latest label information. Send an e-mail to
Mobileum Support (customer.support@mobileum.com) to get the release notes.
Oracle 10g
The R360 application depends on Oracle 10g to run. The R360 schema must be created
in the Mobileum SDS database (Oracle). Oracle 10g is installed during the Mobileum SDS
installation.
Mobileum SDS (iMAS) 6.0 label R150702 or above. For installation instructions, refer
to Mobileum SDS 6.0 Installation Guide.
Mobileum SDS 7.0 label R150702 or above. For installation instructions, refer to
Mobileum SDS 7.0 Installation Guide.
IRDB 6.0 label R130602 or above. For installation instructions, refer to IRDB 6.0
Installation Guide.
DKProbe 5.1 label R90601 or above. For installation instructions, refer to Mobileum
Probe DK 5.1 Installation Guide.
Indexer 1.0 label R150402 or above. For installation instructions, refer to Indexer 1.0
Installation Guide.
IPProbe 6.0, label R150706 or above, will be needed for packet data reports. For
installation instructions, refer to IPProbe 6.0 Installation Guide.
14
a.
b.
Take backup of w e b ap p s folder and install iMAS applications of SDS 7.0 (SDSApps-7.0.zip).
JasperReports Server Addon (JRSAddon) 1.0 latest release to generate and view
the R360 application's reports. This package includes the WAR file to install the
JasperReports Server application. This package also contains other files and scripts to
customize the JasperReports Server application for Mobileum.
For more information about installing and customizing the JasperReports Server
application, refer to JasperReports Server 1.0 Installation and Customization Guide for
Roamware.
Note
The following additional software are required only in case of Hadoop-based R360
deployment:
For more information about installing R360 on a Hadoop cluster, refer to the
Deploying R360 on Wisdom Platform section on page 28.
Adobe Reader 7.0 or later for viewing the JasperReports Server applications reports in
the PDF format.
Pre-Installation Tasks
Be sure to complete the following pre-installation tasks:
{ R o a mw a r e_ H o me }
This is usually / o p t / r oa m w ar e
{ R o a mw a r e_ H o me } / lo g s
15
components (listed in the Software Prerequisites section on page 13) are installed. The
Web server gets installed along with the platform components.
Pre-Installation Checklist
Mobileum recommends that you complete the following checklist before you proceed with the
installation and setup of the R360 application.
T AB L E 6 P R E - I N S TAL L ATI O N C H E C K L I S T
Item
Example Entry
Software
Operating System
So la ri s 10
Distribution
En te rp ri se E d it io n
Service Pack
SP 3
Username
ro am wa re
Password
ro am wa re
Database
Type
Or ac le 1 0g
TNS Name
rw ds n
Host Name
rw ds n
Port
15 21
Service ID
or cl db 1
Username
or ac le
Password
or ac le
Configured Privileges:
CR EA TE T AB LE
CR EA TE T YP E
CR EA TE I ND EX
CR EA TE M AT ER I AL IZ ED
VI EW
CR EA TE V IE W
AL TE R TA BL E
DR OP T AB LE
DR OP T YP E
CR EA TE P RO CE D UR E
RE FE RE NC ES
DM L Pr iv il eg e s
Your Entry
16
Item
Example Entry
RE SO UR CE P ri v il eg es
CO NN EC T Pr iv i le ge s
AL TE R EX TE NT
PA RA ME TE RS
CR EA TE T AB LE S PA CE
UN LI MI TE D TA B LE SP AC E
DR OP T AB LE SP A CE
MA TE RI AL IZ ED VI EW
Your Entry
Application Server
Software Development Kit
JD K 1. 7
Dialogic Software
GC T 5. 03
Scripting language
Pe rl 5 .8 .5 w i th t he
re qu ir ed m od u le s
Database Client
Or ac le D at ab a se
Cl ie nt
Installation Packages
The R360 application includes two separate Solaris packages. Verify that the product
installation disc contains the following packages:
T AB L E 7 I N S TAL L ATI O N P AC K AG E S
Package
Description
RW AR R3 60 -1 .0 - <B ui ld nu mb er > so l1 0- oc i1 0g - sp ar c. pk g. gz
RW AR R3 60 AP PS - 1. 0<B ui ld nu mb er > -s ol 10 -o ci 10 g sp ar c. pk g. gz
2
Installing the R360 Application
Note
Before installing the R360 application, be sure to install the prerequisite software
and complete the pre-installation checklist. For more information, refer to the
Preparing for Installation chapter on page 11.
2.
3.
Execute database scripts to create the R360 applications database schema. This schema
provides the required database storage and retrieval mechanisms for the R360
application.
For more information, refer to the C reating the R360 schema section on page 25.
4.
C onfigure the R360 application after installation. For example, you must modify specific
shell scripts, configuration files, properties file, and so on.
18
For more information, refer to the C onfiguring the R360 Application section on page
38.
5.
For Hadoop-based R360 deployment, you must deploy the R360 application on the
Wisdom platform or Hadoop cluster.
For more information about installing R360 on the Mobileum Wisdom platform, refer to
the Deploying R360 on Wisdom Platform section on page 28.
6.
Start Mobileum SDS 7.0 components and the R360 application. You must also log into
Mobileum SDS Administrator Studio as r 3 6 0 .
For more information, refer to the Verifying the Installation on page 159.
For Hadoop-based R360 deployment only, you must deploy the R360
application on the Wisdom platform or Hadoop cluster. For this, you must
perform additional steps apart from the steps listed in this chapter. For more
information about installing R360 on the Mobileum Wisdom platform, refer to
the Deploying R360 on Wisdom Platform section on page 28.
To install the R360 application, decompress and execute the installation package. This installs
the required prepopulated configurations (prepops) and stored procedures. This section tells
you how to install the R W A R R 3 6 0 package on Solaris.
Next, ensure that you have verified your environment against the pre-requisites
listed in the Installation Prerequisites section on page 13.
Finally, verify that you have the correct installation packages (refer to the
Installation Packages section on page 16).
Ensure that the r o a m w a r e login ID exists. If it does not exist, then create a
new ID for the r o a m w a r e user. This login ID should belong to a group called
roamware.
19
1.
In the machine where the Mobileum SDS platform components are installed, login as the
r o a m w a r e user.
Depending on the target operating system, use one of the following network protocols
for logging:
2.
3.
4.
5.
Warning
Do not use the s u - command.
6.
C opy the R W A R R3 6 0 package from the Mobileum SDS installation disk to the current
directory by running the following command:
c p / {M o b il e u m_ i n st a l la t io n _ di s c }/ R W AR R 3 60 - 1. 0 - <B u i ld n u mb e r >s o l 1 0- o c i1 0 g -s p a rc . p kg . gz .
7.
8.
9.
10. When prompted, specify and confirm the required installation directory.
If the specified directory does not exist, the package installer prompts you to create the
directory.
20
Note
The installation directory that you specify at this point will be referred to as the
{ I n s t a l l _ H o m e } directory.
Note
Henceforth, the { I n st a l l_ H o me } / Ro a m wa r e directory will be referred to as
{ R o a m w a r e _ H o m e} .
12. Be sure to verify the installation directory structure. It must look like Figure 2 on page
21:
21
FI G U R E 2 DI R E C TO R Y S TR U C TU R E AF TE R TH E RWARR360 P AC K AG E I S I N S TAL L E D
22
1.
In the machine where the Mobileum SDS platform components are installed, login as the
super user, s u .
Depending on the target operating system, use one of the following network protocols
for logging:
Warning
Do not use the "s u - " command.
2.
C opy the R W A R R3 6 0 AP P S package from the Mobileum SDS installation disk to the
current directory by running the following command:
c p / {M o b il e u m_ i n st a l la t io n _ di s k }/ R W AR R 3 60 A PP S - 1. 0 < B u i ld n u mb e r >- s o l1 0 - oc i 10 g - sp a r c. p k g. g z .
3.
4.
5.
6.
Note
Later in this guide, this installation directory is referred to as { I n s t al l _ H o m e } .
7.
23
8.
Be sure to verify the installation directory structure. It must look like Figure 3 on page
24.
Note
This directory structure may contain some additional folders if other Mobileum
products are also installed.
24
FI G U R E 3 DI R E C TO R Y S TR U C TU R E AF TE R TH E RWARR360APP S P AC K AG E I S I N S TAL L E D
25
9.
Once both the packages are installed, ensure that the b u i l d . xm l file exists in the
{ R o a m w a r e _ H o m e} / t em p / r3 6 0 directory.
C omplete the installation by creating the R360 database schema. This schema provides the
required database storage and retrieval mechanisms for the R360 application. Creating the
schema involves creating tablespaces and tables and executing stored procedures and
prepopulated configurations (pre-pops).
Before you begin with the Mobileum R360 schema creation procedure, ensure that you have
performed the following requirements:
Use the appropriate sizing sheet to calculate the maximum size for each table in the
schema.
Ensure that these tablespaces are created before you begin with R360 1.0 database
table creation.
Tablespaces should be distributed across disks so that the database load is balanced
among the disks.
From the table scripts, find information regarding mapping of tables to tablespaces.
Ensure that the tablespaces are in place and table scripts appropriately modified with the
tablespace names before creating them.
Ensure that the tables used by the application should not be created in the system
tablespace, or should not clash with the existing tablespaces used by other installed
software.
26
Ensure that the database instance used for R360 is same as the one created for
Mobileum SDS. For more information about installing and configuring Oracle 10g, refer
to Mobileum SDS 6.0 Installation Guide.
Important
Modify or verify the datafile path in following tablespace-related SQL script:
d a t a ba s e /o r a cl e / ta b l es / r3 6 0 _d b _ ts _ c re a t io n .s q l
d a t a ba s e /o r a cl e / ta b l es / rq m _ db _ t s_ c r ea t i on . sq l
At the command prompt, log into the system where the R360 application is installed.
Go to the { R o a m w a r e _ H o m e} / d at a b as e /r 3 6 0/ o r ac l e directory.
3.
Log into the Oracle database using the appropriate username and password.
Note
The login name and the password used here are same as the one used while
creating the Mobileum SDS database instance while installing Oracle 10g for
Mobileum SDS. For more information, refer to Mobileum SDS 6.0 Installation Guide.
4.
Description
@ r q m _c r e at e _ sc h e ma . s ql
@ r q m _c r e at e _ sc h e ma _ 6 2. s ql
@ r q m _c r e at e _ sc h e ma _ 6 3. s ql
{R oa mw ar e_ Ho m e} /d at ab as e/ r 36 0
/oracle/ta bl e s directory.
@ r 3 6 0_ c r ea t e _s c h em a . sq l
Note
Run the following command from the Oracle command prompt to configure the
JasperReports Server database tables d i m _ ti m e and d i m _ t im e _ ho u r ly .
D E C L AR E
st a r t_ d a te VA R C HA R 2 (5 0 ) ;
en d _ da t e
BEGIN
VA R C HA R 2 (5 0 ) ;
27
st a r t_ d a te := ' 01 / 0 1/ 2 0 08 ' ;
en d _ da t e : = ' 3 1 /1 2 / 20 1 8 ' ;
SP _ R QM _ P op u la t e _D i m _T i m e ( s ta r t_ d a te ,
e n d _ da t e );
END;
/
5.
Ensure that all the stored procedures created in the database are valid.
6.
At the SQL prompt, type e x i t and press ENTER to exit SQL Plus.
3
Deploying R360 on Wisdom Platform
Important
These steps are required only in the case of Hadoop-based R360 deployment.
Deploying R360 on Wisdom platform (Hadoop file system) involves the following steps:
1.
2.
Install the R360 application in local file system of the NameNode as per steps provided in
the Installing the R360 Application section on page 17.
3.
4.
5.
Note
While deploying R360, please observe all exceptions, errors, and warnings. To
troubleshoot these issues, contact the Mobileum Engineering team.
29
2.
Oozie Services
Hue Services
C heck if the following Hadoop-related ports are accessible from the base or Name Node
machine:
C loudera Manager: 7 1 8 0
Namenode: 8 0 2 0
Job Tracker: 8 0 3 2
Hue : 8 8 8 8
2.
2.
3.
30
Disable the . g z parameter that compresses the MR and Pig job outputs. To disable this
parameter, perform the following steps:
a.
b.
c.
d.
2.
3.
4.
Ensure that sufficient disk space is available for Hadoop services (such as Yarn and
ZooKeeper) logs (default path is / v a r /l o gs ).
5.
2.
3.
4.
5.
If MapReduce jobs are running, the cleanup activity will be triggered by the m a p r e d
user.
Execute the following command from the m a p r e d user:
s u d o - u hd f s h d f s d f s - ch m o d 1 7 77 / tm p / lo g s
Note: This step is required only if the m a p r e d user is unable to access the
/ t e m p / l o g s directory. Verify whether the m a p r e d user has access to the
/ t e m p / l o g s directory.
31
In the C loudera Manager home page, click Oozie and then click the Configuration tab.
2.
3.
< p r o pe r t y>
< n a m e> o o zi e . ac t i on . f s. g lo b . ma x < /n a m e>
< v a l ue > 5 00 0 < /v a l ue >
< d e s cr i p ti o n >
M a x i mu m nu m b er o f g l ob b ed f il e s .
< / d e sc r i pt i o n>
< / p r op e r ty >
4.
5.
C loudera Manager prompts to restart some processes and deploy configuration. Confirm
the action.
The o o z i e user must have password-less SSH access. Also, the o o z i e user
must have access to the {H A D O O P _R O A MW A R E_ H O ME } directory on HDFS and
the { R O A M W A R E _ H O M E} directory on the local file system.
Install the Wisdom platform and the R360 application using the same operating
system user, preferably h d fs user.
32
Perform the following steps to deploy R360 components, MR and Pig jobs, and other Hadoop
components on the Hadoop Distributed File System (HDFS) cluster.
2.
3.
4.
In the
{ R o a mw a r e_ H o me } / sc r i pt s /o p e ra t i on s / r3 6 0 /c o mm o n /c o p yC a c he D a ta . s
h file, modify the following parameters to include the site-specific cache data:
D B U S ER = r oa m w ar e
D B U S ER P A SS W O RD = r oa m w ar e
D B S C HE M A =r w d b
5.
6.
In the
{ R o a m w a r e _ H o m e} / s cr i p ts / op e r at i o ns / r 36 0 / Co p y_ T o _F r o m_ H D FS . s h
file, add the following lines at the beginning (after the initial commented lines):
e x p o rt R OA M W AR E _ HO M E =/ o pt / R oa m w ar e /
e x p o rt H AD O O P_ R O AM W A RE _ HO M E =/ o p t/ R o am w a re /
7.
In the
{ R o a m w a r e _ H o m e} / s cr i p ts / op e r at i o ns / r 36 0 / co m mo n / se t U pO o z ie . s h
file, perform the following steps:
a.
Important
C ontact Mobileum PSO representative before modifying the value of these
parameters.
j o b T ra c k er = n od e 2 .r o a mw a re . c om : 8 03 2
m a p r ed u c e_ u s er = h df s
n a m e No d e =h d f s: / / no d e 2. r oa m w ar e . co m : 80 2 0
b.
Set the value of the m a s t e r _s t a rt _ d at e parameter in the < Y Y Y Y - M M D D > T < H H : M M > Z format.
NOTE: This format is based on the output received from the d a t e - u command. If
the output of the d a t e - u command is T u e J a n 5 1 0 : 0 0 : 0 0 U T C 2 0 1 6 ,
then set the value of the m a s t e r _s t a rt _ d at e parameter as 2 0 1 6 - 01 05T10:00Z.
33
c.
d.
If the Wisdom platform and the R360 application are deployed with the
operating system user other than o o z i e , then please set the value of the
m a p r e d u c e _ u s e r parameter to that user ID in the s e t U p O o zi e . sh file.
Set the registration start time as 3 : 0 0 A M (local time), as it will run once in a
day.
Set the weekly start date and time as next Monday's 5 : 0 0 A M (your local
time), as it will run every Monday.
Set the monthly start date and time as 7 : 0 0 A M on the first day of the next
month (local time), as it will run on the 1st of every month.
8.
9.
Open the
{ R o a mw a r e_ H o me } / bi n a ri e s/ r 3 60 / c on f i g/ w o rk f lo w / Ma s t er C o or d i na t o
r F l o w / c o o r d i n at o r .x m l file and set the desired frequency of the flows.
Example, for running the Oozie flow once every 25 minutes, configure the frequency
parameter as shown below:
f r e q ue n c y= " $ {c o o rd : m in u te s ( 25 ) }
Note
The default frequency is one hour, i.e., the Master workflow will run once every
one hour.
The Registration workflow will run once in a day, the Weekly flow once in a
week, and the Monthly flow once in a month.
10. In { R o a m w a r e _ H o m e} / s cr i pt s / op e r at i o ns / r 36 0 / wo r kf l o w/ R u nO o z ie . s h
file, change the value of below parameters
O O Z I E_ S E RV E R _H O S TN A M E= h tt p : // < O oz i e s e r ve r h o s tn a m e>
O O Z I E _ S E R V E R _ PO R T =< p o rt >
34
[ r e g is t r at i o n]
i n p u t. d i r= $ H AD O O P_ R O AM W AR E _ HO M E /l o g s/ r 3 60 / st a t s/ r e gi s t ra t i on / M
R w o r ki n g
o u t p ut . d ir = $ HA D O OP _ R OA M WA R E _H O M E/ l o gs / r 36 0 /s t a ts / r eg i s tr a t io n /
M R t e mp
[ m a x ti m e st a m p]
i n p u t. d i r= $ H AD O O P_ R O AM W AR E _ HO M E /l o g s/ r 3 60 / tr a c es / s um m a ry / o ff l i
ne1
o u t p ut . d ir = $ HA D O OP _ R OA M WA R E _H O M E/ l o gs / r 36 0 /s t a ts / o ut p u tm a x t im e s ta m p
12. In the { R o a m w a r e _ H o m e} / b in a r ie s / r3 6 0/ c o nf i g /r o a me r d ur a ti o n c o n f i g . p r o p e r ti e s file, modify the values of following parameters:
[ M A P PE R _ MA P ]
a l l r ec t y pe . i np u t .d i r =$ H AD O O P_ R O AM W A RE _ H OM E /l o g s/ r 3 60 / s ta t s /d u r
a t i o n/ M R wo r k in g
[ J O B _M E T AD A T A_ C O MM O N ]
o u t p ut . d ir = $ HA D O OP _ R OA M WA R E _H O M E/ l o gs / r 36 0 /s t a ts / d ur a t io n / MR o u
tput
13. Run the
{ R o a m w a r e _ H o m e} / s cr i p ts / op e r at i o ns / r 36 0 / De p lo y R 36 0 O nH a d oo p . sh
script.
Note: Verify that the C o p y _T o _ Fr o m _H D F S. s h script is configured properly in the
cron tab.
14. Provide read and write permissions to the newly created $ H A D O OP _ R OA M W AR E _H O M E
directory in Oozie web by following the below steps:
a.
b.
c.
d.
C lick Submit.
In the
{ R O M WA R E _H O M E} / s cr i p ts / op e r at i o ns / r 36 0 / co m mo n / up d a te M e ta d a t
a . s h file, configure the following variables:
35
D B U S ER = r 36 0 d ev
D B U S ER P A SS W O RD = r 36 0 d ev
D B S C HE M A =r w d b
b.
19. In the
{ R O M WA R E _H O M E} / s cr i p ts / op e r at i o ns / r 36 0 / co m mo n / Co p y _T o _ Fr o m _H D F
S _ d a i l y . s h file, configure R O AM W A RE _ H OM E and H A D O O P _R O A MW A R E_ H OM E
variables as per site configuration.
Set the C o p y _ T o _ F r o m _H D FS _ d ai l y .s h script in cron to run after the registration
job completion time.
1.
Open
{ R O A MW A R E_ H O ME } / bi n a ri e s/ r 3 60 / c on f i g/ w o rk f lo w / Ma s t er C o or d i na t o
r F l o w / c o o r d i n at o r .x m l file and set the desired frequency in the f r e q u e n cy
parameter.
For example, for running the Oozie flow once every 20 minutes configure as shown:
f r e q ue n c y= " $ {c o o rd : m in u te s ( 20 ) }
2.
Note
Perform the following changes by logging on to the h d f s user.
3.
In the s e t u p O o z i e . s h file, update the time in daily from 3AM GMT to 1AM GMT.
For example,
# D a i ly C o or d i na t o rS t a rt t im e
r e g i st r a ti o n _s t a rt _ d at e =2 0 1 6- 0 7 -0 9 T 01 : 0 0Z
Redoplyment of
Oozie flow
4.
Set the value of the m a s t e r _s t a rt _ d at e parameter in the < Y Y Y Y - M M D D > T < H H : M M > Z format.
NOTE: This format is based on the output received from the d a t e - u command. If
the output of the d a t e - u command is T u e J a n 5 1 0 : 0 0 : 0 0 U T C 2 0 1 6 ,
36
Set the monthly start date and time as 7 : 0 0 A M on the first day of the next
month (local time), as it will run on the 1st of every month.
5.
To update the Oozie flow, modify the flow start time in the
{ R o a m w a r e _ H o m e} / s cr i p ts / op e r at i o ns / r 36 0 / co m mo n / se t U pO o z ie . s h
file.
6.
Kill all running Oozie jobs, if any, by performing the following steps:
7.
8.
9.
a.
b.
c.
d. C lick Kill.
Run the
{ R o a m w a r e _ H o m e} / s cr i p ts / op e r at i o ns / r 36 0 / wo r kf l o w/ R u nO o z ie . s h
script.
If any changes are made to the
{ R o a m w a r e _ H o m e} / s cr i p ts / op e r at i o ns / r 36 0 / co m mo n / se t U pO o z ie . s h
file, then perform the steps 5 to 7.
You must configure the alerts wake up hour to a time after the following workflows and
SPs have run:
a.
Daily workflow.
b.
c.
i.
ii.
10. In the
{ R O A M W A R E _ H O M E} / b in a r ie s /r 3 6 0/ c o nf i g /r q m al e rt e r .p r o pe r t ie s file,
configure the following parameter:
a l e r ts . w ak e u p. h o ur = 4
11. Restart the Alerter component.
C reate the R360 database schema as mentioned in the C reating the R360 schema
section on page 25.
2.
37
Note
For Hadoop-based R360 deployment, you must run only instance 2 of the
Statswriter binary. For instructions about running this instance, refer to the
Starting statswriter_2 section on page 160.
4
Configuring the R360 Application
To configure the R360 application, you must modify the i m a s li g h t. p r op e r ti e s,
s t a t s w r i t e r . c fg , s t a t s2 w r it e r .c f g , t x n w r i te r . cf g ,
r q m a l e r t e r . p r op e r ti e s , r q m a g g re g a to r .p r o pe r t ie s ,
r q m s c c p a g g r e g at o r .p r o pe r ti e s , r q m d e t a i l a gg r e ga t o r. p r op e rt i e s, and
i n d e x e r . c f g files.
Then, configure the IPProbe platform component for providing packet data, SIP and Diameter
support for the R360 application.
This chapter contains the following topics:
C onfiguring IPProbe platform component for packet data support on page 127
39
2.
m e n u .s t y le = 2
3.
In the Services section of the file, modify the values of the following parameters as
described:
a u t h en t i ca t i on = s 55
c h a n ge p a ss w o rd = s 56
h t t p .m e n u. a p p= s 5 4
4.
2.
3.
40
2.
T AB L E 9 P AR AME TE R S I N TH E S TATS W R I TE R . C F G F I L E
Parameter
Description
lo g. ty pe
0 - File Logging
1 - System Logging
2 - Socket Logging
Default value: 0
lo g. sy sl og .f a ci li t
y
lo g. sy sl og .o p ti on
lo g. di r
/o pt /R oa mw ar e /l og s/ St at sW r it er
lo g. fi le
Specifies the prefix for the names of the log file. For
example, if you specify, statswriter , the first log file
will be created with the name statswriter.l og and
if it reaches its maximum size, a backup of the existing file
is created with the convention statswriter.<d at e time>.log , based on the current date and time. This
parameter is used when log.type is set to 0 (File
logging).
Default value: statswriter
lo g. le ve l
1 - Fatal
2 - Error
3 - Warning
4 - Info
5 - Debug
41
Parameter
Description
Default value: 5
The value of log level depends on the system load. If the
system is running at lower load levels, then the value
should be set to 4 . However, if the load is too high, then
the value should be set to 3 or 2 .
lo g. ma x. si ze
lo g. sh ow .f il e .l in e
lo g. sh ow .m il l is ec
lo g. le ve l. co n so le
Specifies the severity level of the error logs that you wish
to view on the console. Possible options are:
1 - Fatal
2 - Error
3 - Warning
4 - Info
5 - Debug
Default value: 5
lo g. do nt .u se . sy s. l
oc al ti me
function is used
function is used
da ta ba se .p oo l s
{p oo ln am e} .d b .n am e
{p oo ln am e} .d b .u se r
42
Parameter
Description
{p oo ln am e} .d b .p as s
wo rd
{p oo ln am e} .d b .m in .
co nn
{p oo ln am e} .d b .m ax .
co nn
{p oo ln am e} .d b .p as s
wo rd .e nc ry pt
{p oo ln am e} .d b .t yp e
{p oo ln am e} .a l ia s
{p oo ln am e} .d b .h os t
{p oo ln am e} .d b .p or t
sn mp .m an ag er . ad dr e
ss
sn mp .m an ag er . po rt
sn mp .m an ag er . ur i. l
is t
sn mp .m an ag er . ur i. li st =1 72 . 16 .1 29 .2 6: 1
62 , 17 2. 16 .1 2 9. 27 :1 62
Note: If snmp.manage r. ur i .l is t is enabled,
snmp.manag er . ad dr es s and
snmp.manag er . po rt is ignored.
sn mp .a ge nt .p o rt
sn mp .r ea d. co m mu ni t
y
sn mp .w ri te .c o mm un i
ty
sn mp .t ra p. v2 . mo du l
43
Parameter
Description
e. id
version V2.
Default value: 3.0
sn mp .p er l. sc r ip t. i
nc pa th
/o pt /R oa mw ar e /s cr ip ts /o pe r at io ns /r 36 0
sn mp .p er l. sc r ip t
/o pt /R oa mw ar e /s cr ip ts /o pe r at io ns /r 36 0
/s ta ts wr it er - sn mp .p l
sn mp .t ra pfi le .r eq ui re d
sn mp .t ra pfi le .p re fi x
sn mp .t ra pfi le .e xt n
sn mp .t ra pfi le .d ir ec to r y
/o pt /R oa mw ar e /l og s/ St at sW r it er /t ra p
sn mp .t ra pfi le .r ot at io n .t yp e
whichever is earlier
disk space)
Default value: 1
sn mp .t ra pfi le .m ax .s iz e
sn mp .t ra pfi le .r ot at e. a t
sn mp .u se .x 73 3 .t ra p
s
sn mp .t ra p. se q nu m. e
na bl e
rq m. st at sw ri t er .i n
st an ce id
44
Parameter
Description
Default value: 1
Note: A new instance of StatsWriterStats2Writer
collects data and performs calculations specific to the
Roamer Trend reports. The ID for this instance is 2 and is
configured in the stats2writer .c fg file. For
configuration details in the stats2writer. cf g file,
refer to the Modifying the statswriter_2.cfg file section on
page 54.
st at s. wr it er . so ur c
e. di r
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es /s um ma r
y/ of fl in e
st at s. wr it er . fi le .
pa tt er n
st at s. wr it er . po ll .
in te rv al
st at s. wr it er . ma x. s
ec on ds .w it ho u t. td r
.f il es
st at s. wr it er . po st .
pr oc es s. ac ti o n
st at s. wr it er . fa il .
pr oc es s. ac ti o n
Default value: 1
st at s. wr it er . ba ck u
p. di r
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es /s um ma r
y/ of fl in e1
st at s. wr it er . wo rk i
ng .d ir
/o pt /R oa mw ar e /l og s/ r3 60 /s t at sw ri te r/ w
or ki ng
st at s. wr it er . er ro r
.d ir
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es /s um ma r
y/ er ro r
Section: StatsWriter Common-related information
45
Parameter
Description
rq m. ve rs io n
th re ad .h ea lt h .r ep o
rt .p or t
st at sw ri te r. c on .c a
ch e. en ab le d
sy st em .p ar am . ca ch e
.e na bl ed
sy st em .p ar am . ta bl e
.n am e
sy st em .p ar am . re fr e
sh .t im er
rq m. vl r. st at s .r eq u
ir ed
rq m. vl rz on e. s ta ts .
re qu ir ed
op er at io n. mo d e
0 Single threaded
Default value: 0
Section: StatsWriter ISUP Stats-related information
rq m. is up .r oa m in g. h
as h. si ze
Specifies the size of the hash which stores the R360 ISUP
roaming data.
rq m. is up .i nt e rc on n
ec t. ha sh .s iz e
Specifies the size of the hash which stores the R360 ISUP
interconnect data.
rq m. is up .c ap a ci ty .
ha sh .s iz e
Specifies the size of the hash which stores the R360 ISUP
capacity data.
rq m. is up .l oc a l. cc
46
Parameter
Description
Default value: 63
20 host networks
10 host alliances
30 partner alliances
rq m. ro am er .t r en d. u
ni qu er oa me r. h as h. s
iz e
rq m. ro am er .t r en d. c
ur re nt ro am er . ha sh .
si ze
rq m. ro am er .d u ra ti o
n. ha sh .s iz e
rq m. ro am er tr e nd .u n
iq ue ro am er .d a il y. p
er si st en t. ha s h. si z
e
rq m. ro am er tr e nd .u n
iq ue ro am er .m o nt hl y
.p er si st en t. h as h. s
iz e
rq m. ro am er tr e nd .c u
rr en tr oa me r. p er si s
te nt .h as h. si z e
rq m. ro am er du r at io n
.p er si st en t. h as h. s
iz e
rq m. pe rs is te n t. ha s
47
Parameter
Description
h. fi le .p at h
/o pt /R oa mw ar e /l og s/ St at sW r it er /I ms iS t
or e
rq m. pe rs is te n t. ha s
h. fi le .m ax si z e
rq m. pe rs is te n t. ha s
h. fi le .u pd at e in te r
va l
rq m. ro am er du r at io n
.t im eo ut
Specifies the time period (in seconds) for which R360 waits
between receiving a CL for a subscriber from the previous
location and the consecutive UL for the same subscriber
from a new location.
Default value: 30
co un tr y. un iq u e. ou t
ro am er .i ms il i st .r e
qu ir ed
co un tr y. un iq u e.
ou tr oa me r. im s il is t
.p re fi x
co un tr y. un iq u e. ou t
ro am er .i ms il i st .
ex tn
co un tr y. un iq u e. ou t
ro am er .i ms il i st .d i
re ct or y
Default value:
/o pt /R oa mw ar e /l og s/ r3 60 /i m si li st s
co un tr y. un iq u e. ou t
ro am er .i ms il i st .o f
fl in e. di re ct o ry
/o pt /R oa mw ar e /l og s/ r3 60 /i m si li st s/ of f
li ne
co un tr y. un iq u e. ou t
ro am er .i ms il i st .r o
ta ti on .t yp e
whichever is earlier
disk space)
48
Parameter
Description
maximum size is reached
Default value: 4
Note: As these files contains daily unique IMSI list, do not
change the rotation type. This must be 4 (at end of day).
co un tr y. un iq u e. ou t
ro am er .i ms il i st .r o
ta te .a t
co un tr y. un iq u e. ou t
ro am er .i ms il i st .b u
ff er .s iz e
ne tw or k. un iq u e. ou t
ro am er .i ms il i st .r e
qu ir ed
ne tw or k. un iq u e. ou t
ro am er .i ms il i st .p r
ef ix
ne tw or k. un iq u e. ou t
ro am er .i ms il i st .e x
tn
ne tw or k. un iq u e. ou t
ro am er .i ms il i st .d i
re ct or y
Default value:
/o pt /R oa mw ar e /l og s/ r3 60 /i m si li st s
ne tw or k. un iq u e. ou t
ro am er .i ms il i st .o f
fl in e. di re ct o ry
/o pt /R oa mw ar e /l og s/ r3 60 /i m si li st s/ of f
li ne
ne tw or k. un iq u e. ou t
ro am er .i ms il i st .r o
ta ti on .t yp e
whichever is earlier
disk space)
Default value: 0
Note: As these files contains daily unique IMSI list, do not
change rotation type. This must be 4 (at end of day).
ne tw or k. un iq u e. ou t
ro am er .i ms il i st .b u
ff er .s iz e
49
Parameter
Description
ne tw or k. un iq u e. in r
oa me r. im si li s t. re q
ui re d
ne tw or k. un iq u e. in r
oa me r. im si li s t. pr e
fi x
ne tw or k. un iq u e. in r
oa me r. im si li s t. ex t
n
ne tw or k. un iq u e. in r
oa me r. im si li s t. di r
ec to ry
Default value:
/o pt /R oa mw ar e /l og s/ r3 60 /i m si li st s
ne tw or k. un iq u e. in r
oa me r. im si li s t. of f
li ne .d ir ec to r y
/o pt /R oa mw ar e /l og s/ r3 60 /i m si li st s/ of f
li ne
ne tw or k. un iq u e. in r
oa me r. im si li s t. ro t
at io n. ty pe
whichever is earlier
disk space)
Default value: 0
Note: As these files contains daily unique IMSI list, so do
not change rotation type. This must be 4 (at end of day).
ne tw or k. un iq u e. in r
oa me r. im si li s t. bu f
fe r. si ze
rq m. ma p. si gn a li ng .
ha sh .s iz e
Specifies the size of the hash for the R360 map signaling
report.
Default value: 100
rq m. ma p. si gn a li ng .
im si .s ta ts .e n ab le d
rq m. ma p. si gn a li ng .
im si .s ta ts .h a sh .s i
ze
Specifies the size of the hash for the R360 map signaling
report.
Specifies the size of the hash which stores the IMSI wise
MAP Transaction data.
Default value: 30000
50
Parameter
Description
rq m. ro am in g. s ms .h a
sh .s iz e
Specifies the size of the hash which stores the SMS report
roaming data.
rq m. in te rc on n ec t. s
ms .h as h. si ze
Specifies the size of the hash which stores the SMS report
interconnect data.
rq m. sm s. to ps e nd er .
ha sh .s iz e
Specifies the size of the hash which stores the SMS report
roaming data.
rq m. sm s. to ps m sc .h a
sh .s iz e
Specifies the size of the hash which stores the SMS report
interconnect data.
rq m. sm s. to pc n tr y. h
as h. si ze
Specifies the size of the hash which stores the SMS report
interconnect data.
rq m. sm sc .f ra u d. ha s
h. si ze
Specifies the size of the hash which stores the R360 SMSC
fraud data.
Default value: 30000
rq m. al ph an um e ri c. f
ra ud .h as h. si z e
rq m. vo ic e. fr a ud .h a
sh .s iz e
Specifies the size of the hash which stores the R360 voice
fraud data.
Default value: 30000
rq m. mo ni to re d .f ra u
d. ha sh .s iz e
rq m. ca me l. ro a mi ng .
vo ic e. ha sh .s i ze
Specifies the size of the hash which stores the R360 C amel
roaming voice data.
Default value: 30000
rq m. ve rs io n. c ap ab i
li ty .h as h. cl e ar .c o
un t
rq m. ve rs io n. c ap ab i
li ty .p er si st e nt .h a
sh .f il e. pa th
/o pt /R oa mw ar e /l og s/ r3 60 /s t at sw ri te r/ i
ms is to re
rq m. ve rs io n. c ap ab i
li ty .p er si st e nt .h a
sh .f il e. ma xs i ze
rq m. ve rs io n. c ap ab i
li ty .p er si st e nt .h a
51
Parameter
Description
sh .f il e. up da t ei nt e
rv al
Default value: 60
rq m. ve rs io n. c ap ab i
li ty .d tl s. ha s h. cl e
ar .c ou nt
rq m. ve rs io n. c ap ab i
li ty .d tl s. pe r si st e
nt .h as h. fi le . pa th
/o pt /R oa mw ar e /l og s/ r3 60 /s t at sw ri te r/ i
ms is to re
rq m. ve rs io n. c ap ab i
li ty .d tl s. pe r si st e
nt .h as h. fi le . ma xs i
ze
rq m. ve rs io n. c ap ab i
li ty .d tl s. pe r si st e
nt .h as h. fi le . up da t
ei nt er va l
rq m. st at s. fi l e. re q
ui re d
rq m. st at s. fi l e. pr e
fi x
rq m. st at s. fi l e. ex t
n
rq m. st at s. fi l e. di r
ec to ry
/o pt /R oa mw ar e /l og s/ r3 60 /s t at s
rq m. st at s. fi l e. of f
li ne .d ir ec to r y
/o pt /R oa mw ar e /l og s/ r3 60 /s t at s/ of fl in e
rq m. st at s. fi l e. ro t
at io n. ty pe
Default value: 5
rq m. st at s. fi l e. ma x
.s iz e
rq m. st at s. fi l e. ro t
at e. in te rv al
52
Parameter
Description
Default value: 5
rq m. st at s. fi l e. ro t
at e. at
tx n. re co rd ty p es
tx n. re co rd ty p e. po s
re co rd ty pe .< r ec or d
Ty pe >. nu mF ie l ds
re co rd ty pe .< r ec or d
Ty pe >. fi el d. < Fi el d
Id >. ke y
re co rd ty pe .< r ec or d
Ty pe >. fi el d. < Fi el d
Id >. ty pe
1 Int"
2 Long
3 Float
4 C har
5 String
6 Date
7 Double
rq m. vi pt ra ck e r. st a
ts .h as h. si ze
VIP Tracker Alerts will be written to files, which will be processed by Alerter and it will
53
Parameter
Description
vi pt ra ck er .a l er tf i
le .r eq ui re d
vi pt ra ck er .a l er tf i
le .p re fi x
vi pt ra ck er .a l er tf i
le .e xt n
vi pt ra ck er .a l er tf i
le .d ir ec to ry
/o pt /R oa mw ar e /l og s/ r3 60 /a l er te r/ vi pt r
ac ke r
vi pt ra ck er .a l er tf i
le .o ff li ne .d i re ct o
ry
vi pt ra ck er .a l er tf i
le .r ot at io n. t yp e
/o pt /R oa mw ar e /l og s/ r3 60 /a l er te r/ vi pt r
ac ke r/ of fl in e
Specifies the rotation mechanism for Viptracker Alerter
files.
Possible options are:
whichever is earlier
disk space)
Default value: 3
vi pt ra ck er .a l er tf i
le .m ax .s iz e
vi pt ra ck er .a l er tf i
le .r ot at e. at
vi pt ra ck er .a l er tf i
le .i nt er va l
vi pt ra ck er .a l er tf i
le .b uf fe r. si z e
rq m. vi pt ra ck e r. dt l
.e na bl ed
rq m. vi pt ra ck e r. dt l
.s ta ts .h as h. s iz e
co s. im si .c ac h e. si z
e
54
Parameter
Description
rq m. dt l. en ab l ed
rq m. ro am in g. s ms .d t
l. ha sh .s iz e
Specifies the size (in bytes) of the hash file which stores
the R360 SMS Service Reports data.
rq m. in te rc on n ec t. d
tl .s ms .h as h. s iz e
Specifies the size (in bytes) of the hash file which stores
the R360 interconnect SMS Service Reports data.
rq m. is up .r oa m in g. D
tl .h as h. si ze
Specifies the size (in bytes) of the hash file which stores
the R360 Voice Service Reports data.
Default value: 300000
rq m. is up .i nt e rc on n
ec t. Dt l. ha sh . si ze
Specifies the size (in bytes) of the hash file which stores
the R360 interconnect Voice Service Reports data.
Default value: 300000
rq m. ca me l. ro a mi ng .
vo ic e. dt l. ha s h. si z
e
Specifies the size (in bytes) of the hash file which stores
the R360 C AMEL Voice Service Reports data.
Default value: 300000
rq m. si p. re g. h as h. s
iz e
S Specifies the size (in bytes) of the hash which stores the
SIP registration data.
rq m. si p. ca ll . ha sh .
si ze
Specifies the size (in bytes) of the hash which stores the
SIP calls data.
rq m. si p. in tl c al l. h
as h. si ze
Specifies the size (in bytes) of the hash which stores the
SIP international calls data.
rq m. si p. ms g. h as h. s
iz e
Specifies the size (in bytes) of the hash which stores the
SIP messages data.
3.
55
2.
Description
lo g. ty pe
0 - File Logging
1 - System Logging
2 - Socket Logging
Default value: 0
lo g. sy sl og .f a ci li t
y
lo g. sy sl og .o p ti on
lo g. di r
/o pt /R oa mw ar e /l og s/ St at sW r it er
lo g. fi le
Specifies the prefix for the names of the log file. For
example, if you specify, statswriter , the first log file
will be created with the name statswriter.l og and
if it reaches its maximum size, a backup of the existing file
is created with the convention statswriter.<d at e time>.log , based on the current date and time. This
parameter is used when log.type is set to 0 (File
logging).
Default value: statswriter
lo g. le ve l
1 - Fatal
2 - Error
3 - Warning
4 - Info
5 - Debug
Default value: 5
The value of log level depends on the system load. If the
system is running at lower load levels, then the value
should be set to 4 . However, if the load is too high, then
the value should be set to 3 or 2 .
lo g. ma x. si ze
lo g. sh ow .f il e .l in e
56
Parameter
Description
source file, from which the message was logged, should be
mentioned. This is used to trace any problems in the
software and needs to be mentioned while reporting a
problem. Possible options are:
lo g. sh ow .m il l is ec
lo g. le ve l. co n so le
Specifies the severity level of the error logs that you wish
to view on the console. Possible options are:
1 - Fatal
2 - Error
3 - Warning
4 - Info
5 - Debug
Default value: 5
lo g. do nt .u se . sy s. l
oc al ti me
da ta ba se .p oo l s
{p oo ln am e} .d b .n am e
{p oo ln am e} .d b .u se r
{p oo ln am e} .d b .p as s
wo rd
{p oo ln am e} .d b .m in .
co nn
{p oo ln am e} .d b .m ax .
co nn
{p oo ln am e} .d b .p as s
wo rd .e nc ry pt
57
Parameter
Description
{p oo ln am e} .d b .t yp e
{p oo ln am e} .a l ia s
{p oo ln am e} .d b .h os t
{p oo ln am e} .d b .p or t
sn mp .m an ag er . ad dr e
ss
sn mp .m an ag er . po rt
sn mp .m an ag er . ur i. l
is t
sn mp .m an ag er . ur i. li st =1 72 . 16 .1 29 .2 6: 1
62 , 17 2. 16 .1 2 9. 27 :1 62
Note: If snmp.manage r. ur i .l is t is enabled,
snmp.manag er . ad dr es s and
snmp.manag er . po rt is ignored.
sn mp .a ge nt .p o rt
sn mp .r ea d. co m mu ni t
y
sn mp .w ri te .c o mm un i
ty
sn mp .t ra p. v2 . mo du l
e. id
sn mp .p er l. sc r ip t. i
nc pa th
/o pt /R oa mw ar e /s cr ip ts /o pe r at io ns /r 36 0
sn mp .p er l. sc r ip t
/o pt /R oa mw ar e /s cr ip ts /o pe r at io ns /r 36 0
/s ta ts wr it er - sn mp .p l
58
Parameter
sn mp .t ra pfi le .r eq ui re d
Description
Specifies whether the trap file is required or not.
Possible options are:
sn mp .t ra pfi le .p re fi x
sn mp .t ra pfi le .e xt n
sn mp .t ra pfi le .d ir ec to r y
/o pt /R oa mw ar e /l og s/ St at sW r it er /t ra p
sn mp .t ra pfi le .r ot at io n .t yp e
whichever is earlier
disk space)
Default value: 1
sn mp .t ra pfi le .m ax .s iz e
sn mp .t ra pfi le .r ot at e. a t
sn mp .u se .x 73 3 .t ra p
s
sn mp .t ra p. se q nu m. e
na bl e
rq m. st at sw ri t er .i n
st an ce id
st at s. wr it er . so ur c
e. di r
Default value: 2
Default value:
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es /s um ma r
y/ of fl in e1
st at s. wr it er . fi le .
pa tt er n
59
Parameter
Description
st at s. wr it er . po ll .
in te rv al
st at s. wr it er . ma x. s
ec on ds .w it ho u t. td r
.f il es
st at s. wr it er . po st .
pr oc es s. ac ti o n
Default value: 1
st at s. wr it er . fa il .
pr oc es s. ac ti o n
Default value: 1
st at s. wr it er . ba ck u
p. di r
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es /s um ma r
y/ hi st or y
st at s. wr it er . wo rk i
ng .d ir
/o pt /R oa mw ar e /l og s/ r3 60 /s t at sw ri te r/ w
or ki ng
st at s. wr it er . er ro r
.d ir
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es /s um ma r
y/ er ro r
Section: StatsWriter Common-related information
rq m. ve rs io n
th re ad .h ea lt h .r ep o
rt .p or t
st at sw ri te r. c on .c a
ch e. en ab le d
60
Parameter
Description
sy st em .p ar am . ca ch e
.e na bl ed
sy st em .p ar am . ta bl e
.n am e
sy st em .p ar am . re fr e
sh .t im er
rq m. vl r. st at s .r eq u
ir ed
rq m. vl rz on e. s ta ts .
re qu ir ed
op er at io n. mo d e
0 Single threaded
1 Each shared object executes in a separate
thread
Default value: 0
Section: StatsWriter ISUP Stats-related information
rq m. is up .r oa m in g. h
as h. si ze
Specifies the size of the hash which stores the R360 ISUP
roaming data.
rq m. is up .i nt e rc on n
ec t. ha sh .s iz e
Specifies the size of the hash which stores the R360 ISUP
interconnect data.
rq m. is up .c ap a ci ty .
ha sh .s iz e
Specifies the size of the hash which stores the R360 ISUP
capacity data.
rq m. is up .l oc a l. cc
20 host networks
10 host alliances
30 partner alliances.
61
Parameter
Description
rq m. ro am er .t r en d. u
ni qu er oa me r. h as h. s
iz e
rq m. ro am er .t r en d. c
ur re nt ro am er . ha sh .
si ze
rq m. ro am er .d u ra ti o
n. ha sh .s iz e
rq m. ro am er tr e nd .u n
iq ue ro am er .d a il y. p
er si st en t. ha s h. si z
e
rq m. ro am er tr e nd .u n
iq ue ro am er .m o nt hl y
.p er si st en t. h as h. s
iz e
rq m. ro am er tr e nd .c u
rr en tr oa me r. p er si s
te nt .h as h. si z e
rq m. ro am er du r at io n
.p er si st en t. h as h. s
iz e
rq m. pe rs is te n t. ha s
h. fi le .p at h
/o pt /R oa mw ar e /l og s/ St at sW r it er /I ms iS t
or e
rq m. pe rs is te n t. ha s
h. fi le .m ax si z e
rq m. pe rs is te n t. ha s
h. fi le .u pd at e in te r
va l
rq m. ro am er du r at io n
.t im eo ut
Specifies the time period (in seconds) for which R360 waits
between receiving a CL for a subscriber from the previous
location and the consecutive UL for the same subscriber
from a new location.
Default value: 30
62
Parameter
Description
the data received in the consecutive UL, R360 increments
the appropriate exit counts for the visited networks and
countries.
If the consecutive UL arrives after this specified time
interval, then R360 considers it as a new UL for a new
registration attempt.
Default value: 120
co un tr y. un iq u e. ou t
ro am er .i ms il i st .r e
qu ir ed
co un tr y. un iq u e.
ou tr oa me r. im s il is t
.p re fi x
co un tr y. un iq u e. ou t
ro am er .i ms il i st .
ex tn
co un tr y. un iq u e. ou t
ro am er .i ms il i st .d i
re ct or y
Default value:
/o pt /R oa mw ar e /l og s/ r3 60 /i m si li st s
co un tr y. un iq u e. ou t
ro am er .i ms il i st .o f
fl in e. di re ct o ry
/o pt /R oa mw ar e /l og s/ r3 60 /i m si li st s/ of f
li ne
co un tr y. un iq u e. ou t
ro am er .i ms il i st .r o
ta ti on .t yp e
whichever is earlier
disk space)
Default value: 4
Note: As these files contains daily unique IMSI list, do not
change the rotation type. This must be 4 (at end of day).
co un tr y. un iq u e. ou t
ro am er .i ms il i st .r o
ta te .a t
co un tr y. un iq u e. ou t
ro am er .i ms il i st .b u
ff er .s iz e
63
Parameter
Description
ne tw or k. un iq u e. ou t
ro am er .i ms il i st .r e
qu ir ed
ne tw or k. un iq u e. ou t
ro am er .i ms il i st .p r
ef ix
ne tw or k. un iq u e. ou t
ro am er .i ms il i st .e x
tn
ne tw or k. un iq u e. ou t
ro am er .i ms il i st .d i
re ct or y
Default value:
/o pt /R oa mw ar e /l og s/ r3 60 /i m si li st s
ne tw or k. un iq u e. ou t
ro am er .i ms il i st .o f
fl in e. di re ct o ry
/o pt /R oa mw ar e /l og s/ r3 60 /i m si li st s/ of f
li ne
ne tw or k. un iq u e. ou t
ro am er .i ms il i st .r o
ta ti on .t yp e
whichever is earlier
disk space)
Default value: 0
Note: As these files contains daily unique IMSI list, do not
change rotation type. This must be 4 (at end of day).
ne tw or k. un iq u e. ou t
ro am er .i ms il i st .b u
ff er .s iz e
ne tw or k. un iq u e. in r
oa me r. im si li s t. re q
ui re d
ne tw or k. un iq u e. in r
oa me r. im si li s t. pr e
fi x
ne tw or k. un iq u e. in r
oa me r. im si li s t. ex t
n
ne tw or k. un iq u e. in r
oa me r. im si li s t. di r
Default value:
64
Parameter
Description
ec to ry
/o pt /R oa mw ar e /l og s/ r3 60 /i m si li st s
ne tw or k. un iq u e. in r
oa me r. im si li s t. of f
li ne .d ir ec to r y
/o pt /R oa mw ar e /l og s/ r3 60 /i m si li st s/ of f
li ne
ne tw or k. un iq u e. in r
oa me r. im si li s t. ro t
at io n. ty pe
whichever is earlier
disk space)
Default value: 0
Note: As these files contains daily unique IMSI list, so do
not change rotation type. This must be 4 (at end of day).
ne tw or k. un iq u e. in r
oa me r. im si li s t. bu f
fe r. si ze
rq m. ma p. si gn a li ng .
ha sh .s iz e
Specifies the size of the hash for the R360 map signaling
report.
Default value: 100
rq m. ma p. si gn a li ng .
im si .s ta ts .e n ab le d
rq m. ma p. si gn a li ng .
im si .s ta ts .h a sh .s i
ze
Specifies the size of the hash for the R360 map signaling
report.
Specifies the size of the hash which stores the IMSI wise
MAP Transaction data.
Default value: 30000
rq m. ro am in g. s ms .h a
sh .s iz e
Specifies the size of the hash which stores the SMS report
roaming data.
rq m. in te rc on n ec t. s
ms .h as h. si ze
Specifies the size of the hash which stores the SMS report
interconnect data.
rq m. sm s. to ps e nd er .
ha sh .s iz e
Specifies the size of the hash which stores the SMS report
roaming data.
Default value: 30000
rq m. sm s. to ps m sc .h a
sh .s iz e
Specifies the size of the hash which stores the SMS report
interconnect data.
Default value: 9000
65
Parameter
Description
rq m. sm s. to pc n tr y. h
as h. si ze
Specifies the size of the hash which stores the SMS report
interconnect data.
Default value: 9000
rq m. sm sc .f ra u d. ha s
h. si ze
Specifies the size of the hash which stores the R360 SMSC
fraud data.
rq m. al ph an um e ri c. f
ra ud .h as h. si z e
rq m. vo ic e. fr a ud .h a
sh .s iz e
Specifies the size of the hash which stores the R360 voice
fraud data.
Default value: 30000
rq m. mo ni to re d .f ra u
d. ha sh .s iz e
rq m. ca me l. ro a mi ng .
vo ic e. ha sh .s i ze
Specifies the size of the hash which stores the R360 C amel
roaming voice data.
Default value: 30000
rq m. ve rs io n. c ap ab i
li ty .h as h. cl e ar .c o
un t
rq m. ve rs io n. c ap ab i
li ty .p er si st e nt .h a
sh .f il e. pa th
/o pt /R oa mw ar e /l og s/ r3 60 /s t at sw ri te r/ i
ms is to re
rq m. ve rs io n. c ap ab i
li ty .p er si st e nt .h a
sh .f il e. ma xs i ze
rq m. ve rs io n. c ap ab i
li ty .p er si st e nt .h a
sh .f il e. up da t ei nt e
rv al
rq m. ve rs io n. c ap ab i
li ty .d tl s. ha s h. cl e
ar .c ou nt
rq m. ve rs io n. c ap ab i
li ty .d tl s. pe r si st e
nt .h as h. fi le . pa th
/o pt /R oa mw ar e /l og s/ r3 60 /s t at sw ri te r/ i
ms is to re
rq m. ve rs io n. c ap ab i
li ty .d tl s. pe r si st e
nt .h as h. fi le . ma xs i
ze
rq m. ve rs io n. c ap ab i
li ty .d tl s. pe r si st e
66
Parameter
Description
nt .h as h. fi le . up da t
ei nt er va l
Default value: 60
rq m. st at s. fi l e. re q
ui re d
rq m. st at s. fi l e. pr e
fi x
rq m. st at s. fi l e. ex t
n
rq m. st at s. fi l e. di r
ec to ry
/o pt /R oa mw ar e /l og s/ r3 60 /s t at s
rq m. st at s. fi l e. of f
li ne .d ir ec to r y
/o pt /R oa mw ar e /l og s/ r3 60 /s t at s/ of fl in e
rq m. st at s. fi l e. ro t
at io n. ty pe
Default value: 5
rq m. st at s. fi l e. ma x
.s iz e
rq m. st at s. fi l e. ro t
at e. in te rv al
rq m. st at s. fi l e. ro t
at e. at
tx n. re co rd ty p es
67
Parameter
Description
tx n. re co rd ty p e. po s
re co rd ty pe .< r ec or d
Ty pe >. nu mF ie l ds
re co rd ty pe .< r ec or d
Ty pe >. fi el d. < Fi el d
Id >. ke y
re co rd ty pe .< r ec or d
Ty pe >. fi el d. < Fi el d
Id >. ty pe
1 Int"
2 Long
3 Float
4 C har
5 String
6 Date
7 Double
rq m. vi pt ra ck e r. st a
ts .h as h. si ze
VIP Tracker Alerts will be written to files, which will be processed by Alerter and it will
send alerts as per configurations.
vi pt ra ck er .a l er tf i
le .r eq ui re d
vi pt ra ck er .a l er tf i
le .p re fi x
vi pt ra ck er .a l er tf i
le .e xt n
vi pt ra ck er .a l er tf i
le .d ir ec to ry
/o pt /R oa mw ar e /l og s/ r3 60 /a l er te r/ vi pt r
ac ke r
vi pt ra ck er .a l er tf i
le .o ff li ne .d i re ct o
ry
/o pt /R oa mw ar e /l og s/ r3 60 /a l er te r/ vi pt r
68
Parameter
Description
ac ke r/ of fl in e
vi pt ra ck er .a l er tf i
le .r ot at io n. t yp e
whichever is earlier
disk space)
Default value: 3
vi pt ra ck er .a l er tf i
le .m ax .s iz e
vi pt ra ck er .a l er tf i
le .r ot at e. at
vi pt ra ck er .a l er tf i
le .i nt er va l
vi pt ra ck er .a l er tf i
le .b uf fe r. si z e
rq m. vi pt ra ck e r. dt l
.e na bl ed
rq m. vi pt ra ck e r. dt l
.s ta ts .h as h. s iz e
co s. im si .c ac h e. si z
e
rq m. dt l. en ab l ed
rq m. ro am in g. s ms .d t
l. ha sh .s iz e
Specifies the size (in bytes) of the hash file which stores
the R360 SMS Service Reports data.
Default value: 300000
rq m. in te rc on n ec t. d
tl .s ms .h as h. s iz e
Specifies the size (in bytes) of the hash file which stores
the R360 interconnect SMS Service Reports data.
Default value: 300000
rq m. is up .r oa m in g. D
tl .h as h. si ze
Specifies the size (in bytes) of the hash file which stores
the R360 Voice Service Reports data.
Default value: 300000
69
Parameter
Description
rq m. is up .i nt e rc on n
ec t. Dt l. ha sh . si ze
Specifies the size (in bytes) of the hash file which stores
the R360 interconnect Voice Service Reports data.
rq m. ca me l. ro a mi ng .
vo ic e. dt l. ha s h. si z
e
rq m. si p. re g. h as h. s
iz e
S Specifies the size (in bytes) of the hash which stores the
SIP registration data.
Default value: 30000
rq m. si p. ca ll . ha sh .
si ze
Specifies the size (in bytes) of the hash which stores the
SIP calls data.
Default value: 30000
rq m. si p. in tl c al l. h
as h. si ze
Specifies the size (in bytes) of the hash which stores the
SIP international calls data.
Default value: 30000
rq m. si p. ms g. h as h. s
iz e
Specifies the size (in bytes) of the hash which stores the
SIP messages data.
Default value: 30000
3.
2.
Modify the parameters, if required, according to their descriptions given below in the
table.
T AB L E 11 P AR AME TE R S I N TH E TX N W R I TE R . C F G F I L E
Parameter
Description
lo g. ty pe
0 - File Logging
1 - System Logging
70
Parameter
Description
2 - Socket Logging
Default value: 0
lo g. sy sl og .f a ci li ty
lo g. sy sl og .o p ti on
lo g. di r
/o pt /R oa mw ar e /l og s/ r3 60 /t x nw ri te r
lo g. fi le
Specifies the prefix for the name of the log file. For
example, if you specify, T x n Wr i t er , the first log file
will be created with the name T x n W r it e r .l o g and if it
reaches its maximum size, a backup of the existing file is
created with the convention TxnWriter.<dat etime>.log , based on the current date and time. This
parameter is used when log.type is set to 0 (File
logging).
Default value: TxnWriter
lo g. le ve l
1 - Fatal
2 - Error
3 - Warning
4 - Info
5 - Debug
Default value: 3
The value of log level depends on the system load. If the
system is running at lower load levels, then the value
should be set to 4 . However, if the load is too high, then
the value should be set to 3 or 2 . Level 5 is used for
testing and debugging.
lo g. ma x. si ze
lo g. sh ow .f il e .l in e
lo g. le ve l. co n so le
71
Parameter
Description
1 - Fatal
2 - Error
3 - Warning
4 - Info
5 - Debug
Default value: 3
The value of log level depends on the system load. If the
system is running at lower load levels, then the value
should be set to 4 . However, if the load is too high, then
the value should be set to 3 or 2 . Level 5 is used for
testing and debugging.
lo g. sh ow .m il l is ec
lo g. bi nd .p or t
lo g. do nt .u se . sy s.
lo ca lt im e
function is used
da ta ba se .p oo l s
{p oo ln am e} .d b .n am e
{p oo ln am e} .d b .u se r
Specifies the user name for logging into the database for
the corresponding database pool.
{p oo ln am e} .d b .p as sw
or d
{p oo ln am e} .d b .m in .c
on n
{p oo ln am e} .d b .m ax .c
on n
{p oo ln am e} .d b .p as sw
or d. en cr yp t
Default value: 2
Default value: 4
72
Parameter
Description
Default value: no
{p oo ln am e} .d b .t yp e
{p oo ln am e} .d b .a li as
sn mp .m an ag er . ad dr es
s
sn mp .m an ag er . po rt
sn mp .m an ag er . ur i. li
st
sn mp .m an ag er . ur i. li st =1 72 . 16 .1 29 .2 6:
16 2, 1 72 .1 6. 1 29 .2 7: 16 2
Note: If snmp.manage r. ur i .l is t is enabled,
snmp.manag er . ad dr es s and
snmp.manag er . po rt is ignored.
sn mp .a ge nt .p o rt
sn mp .r ea d. co m mu ni ty
sn mp .w ri te .c o mm un it
y
sn mp .t ra p. v2 . mo du le
.i d
sn mp .p er l. sc r ip t
/o pt /R oa mw ar e /s cr ip ts /o pe r at io ns /r 36
0/ tx nw ri te r- s nm p. pl
sn mp .t ra pfi le .r eq ui re d
Default value: no
73
Parameter
Description
sn mp .t ra pfi le .p re fi x
sn mp .t ra p- fi l e. ex tn
sn mp .t ra pfi le .d ir ec to r y
/o pt /R oa mw ar e /l og s/ r3 60 /t x nw ri te r/ tr
ap s
sn mp .t ra pfi le .r ot at io n .t yp e
whichever is earlier
disk space)
Default value: 4
sn mp .t ra pfi le .m ax .s iz e
sn mp .t ra pfi le .r ot at e. i nt er va
l
sn mp .t ra pfi le .r ot at e. a t
sn mp .h ea rt be a t. tr ap
.
in te rv al
ev en t- lo g. re q ui re d
ev en t- lo g. pr e fi x
ev en t- lo g. ex t n
ev en t- lo g. di r ec to ry
74
Parameter
Description
log files are stored.
Default value:
/o pt /R oa mw ar e /l og s/ r3 60 /e v en tl og s
ev en tlo g. ro ta ti on . ty pe
whichever is earlier
disk space)
Default value: 1
ev en t- lo g. ma x .s iz e
Specifies the maximum size after which the event log file
is rotated. This parameter is applicable only if eventlog.rotati on . ty pe is set to either 1 or 3 .
Default value: 5120000
ev en tlo g. ro ta te .i n te rv al
ev en t- lo g. ro t at e. at
ev en tlo g. bu ff er .s i ze
op er at io n. mo d e
1 - R360
2 - R360 ISUP
4 - R360 ITUP
8 - R360 C AP
Sum of the values for a combination of the abovementioned modes. For example, if you want to run R360
in the R360 + R360 ISUP modes, then you need to
specify 1+2 = 3
Default value: 1
th re ad .h ea lt h .r ep or
t. po rt
75
Parameter
Description
my .i ns ta nc e. i d
ho st .c c
ma p. me sg .p oo l .t hr es
ho ld
ca p. me sg .p oo l .t hr es
ho ld
is up .m es g. po o l. th re
sh ol d
in te rh om e. en a bl ed
ro am pr ob e. nu m .p ro be
s
ro am pr ob e. pr o be .( x)
.h os t
ro am pr ob e. pr o be .( x)
.p or t
ro am pr ob e. pr o be .( x)
.t im eo ut
ro am pr ob e. pr o be .( x)
.r et ry in te rv a l
ro am pr ob e. pr o be .( x)
.s io
ro am pr ob e. us e s. re du
nd an t. pr ob e
76
Parameter
ro am pr ob e. us e s. PC R
Description
Specifies whether the transmission of messages on the
roaming links is PCR-based or not. Possible options are
true and false.
Default value: false
ro am pr ob e. us e s. an si
.m tp 3
ro am pr ob e. us e s. an si
.t ca p
ro am pr ob e. us e s. an si
.s cc p
ro am pr ob e. nu m .m ap .d
ec od er s
ro am pr ob e. nu m .c am el
.d ec od er s
Default value: 2
Default value: 0
Note: If camel mode is not enabled, then keep this value
as 0 .
ro am pr ob e. sc c p. pr in
t. an al ys is
ro am pr ob e. tc a p. pr in
t. an al ys is
ro am pr ob e. ma p .p ri nt
.a na ly si s
ro am pr ob e. mt p 2. tr ac
e
ro am pr ob e. nu m .i su p.
de co de rs
ro am pr ob e. nu m .t up .d
ec od er s
no .m es g. fr om . pr ob e.
wa it .p er io d
77
Parameter
Description
Default value: 5
nu m. ac ti ve .s m
sm .h as h. ar ra y s
tc ap .e ve nt .p o ol .s iz
e
is up .e ve nt .p o ol .s iz
e
it up .e ve nt .p o ol .s iz
e
sm .d ef au lt .t i me ou t.
pe ri od
is up .s m. de fa u lt .t im
eo ut
it up .s m. de fa u lt .t im
eo ut
sm .m ax .t im eo u t. pe ri
od
is up .s m. ma x. t im eo ut
Default value: 10
Default value: 10
Default value: 10
Default value: 30
Specifies the maximum timeout period for the ISUP State
Machine.
Default value: 30
it up .s m. ma x. t im eo ut
sm .s te p. ti me . in te rv
al
is up .s m. st ep . ti me .i
nt er va l
it up .s m. st ep . ti me .i
nt er va l
is up .s ta te ma c hi ne .c
ou nt
it up .s ta te ma c hi ne .c
ou nt
ma p. mt p2 .p oo l .t ra p.
cl ea r. th re sh o ld
is up .m tp 2. po o l. tr ap
78
Parameter
Description
.c le ar .t hr es h ol d
pool trap.
Default value: 1000
it up .m tp 2. po o l. tr ap
.c le ar .t hr es h ol d
is up .s ta r. va l ue
is up .h as h. va l ue
is up .s ta ck .d e pl oy ed
is up .f la vo r
1 - ITUT
2 - ANSI
Default value: 1
is up .t xn .p oo l .s iz e
is up .d et ai lf i le .r eq
ui re d
is up .d et ai lf i le .p re
fi x
is up .d et ai lf i le .e xt
n
is up .d et ai lf i le .d ir
ec to ry
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es
is up .d et ai lf i le .o ff
li ne .d ir ec to r y
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es /h is to
ry
is up .d et ai lf i le .r ot
at io n. ty pe
whichever is earlier
disk space)
79
Parameter
Description
Default value: 5
is up .d et ai lf i le .m ax
.s iz e
is up .d et ai lf i le .r ot
at e. in te rv al
is up .d et ai lf i le .r ot
at e. at
is up .d et ai lf i le .o ff
li ne .d ir ec to r y. is da
yw is e
is up .d et ai lf i le .b uf
fe r. si ze
ma p. tx n. po ol . si ze
tx nw ri te r. ma p .m on it
or ed .m sg s
1, 2, 5, 7, 9, 11 , 13 ,1 5, 17 ,1 8, 2 0, 22 ,2 4, 26
,3 0, 34 ,3 6, 38 , 40 ,4 2, 44 ,4 6, 4 8, 50 ,5 2, 54
,5 6, 58 ,6 0, 62 , 63 ,6 4, 65 ,6 6, 6 7, 68 ,6 9, 70
,7 1, 72 ,7 3, 74 , 75 ,7 6, 77 ,7 8, 7 9, 80 ,8 1, 82
,8 3, 84 ,8 5
ma p. de ta il fi l e. re qu
ir ed
ma p. de ta il fi l e. pr ef
ix
ma p. de ta il fi l e. ex tn
ma p. de ta il fi l e. di re
ct or y
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es
ma p. de ta il fi l e. of fl
in e. di re ct or y
80
Parameter
Description
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es /h is to
ry
ma p. de ta il fi l e. ro ta
ti on .t yp e
whichever is earlier
disk space)
Default value: 5
ma p. de ta il fi l e. ro ta
te .a t
ma p. de ta il fi l e. ma x.
si ze
ma p. de ta il fi l e. ro ta
te .i nt er va l
ma p. de ta il fi l e. of fl
in e. di re ct or y .i sd ay
wi se
ma p. bu ff er .s i ze
ca p. tx n. po ol . si ze
ca p. de ta il fi l e. re qu
ir ed
ca p. de ta il fi l e. pr ef
ix
ca p. de ta il fi l e. ex tn
ca p. de ta il fi l e. di re
ct or y
81
Parameter
Description
ca p. de ta il fi l e. of fl
in e. di re ct or y
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es /h is to
ry
ca p. de ta il fi l e. ro ta
ti on .t yp e
whichever is earlier
disk space)
Default value: 5
ca p. de ta il fi l e. ro ta
te .a t
ca p. de ta il fi l e. ma x.
si ze
ca p. de ta il fi l e. ro ta
te .i nt er va l
ca p. de ta il fi l e. of fl
in e. di re ct or y .i sd ay
wi se
ca p. de ta il fi l e. bu ff
er .s iz e
is .a ns i. ne tw o rk
ma st er fi le .r e qu ir ed
ma st er fi le .p r ef ix
ma st er fi le .e x tn
ma st er fi le .d i re ct or
y
82
Parameter
Description
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es
ma st er fi le .o f fl in e.
di re ct or y
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es /a rc hi
ve
ma st er fi le .r o ta ti on
.t yp e
whichever is earlier
disk space)
Default value: 5
ma st er fi le .m a x. si ze
ma st er fi le .r o ta te .i
nt er va l
ma st er fi le .r o ta te .a
t
ma st er fi le .b u ff er .s
iz e
ma st er fi le .m y ev en tl
og .d at e. fo rm a t
%H:%M:%S
ms us ta ts .r eq u ir ed
ms us ta ts .f il e .d ir ec
to ry
/o pt /R oa mw ar e /l og s/ r3 60 /m s us ta ts
ms us ta ts .f il e .o ff li
ne .d ir ec to ry
/o pt /R oa mw ar e /l og s/ r3 60 /m s us ta ts /o ff
li ne
ms us ta ts .f il e .u pd at
e. in te rv al
rq m. sc cp .s ta t .r eq ui
83
Parameter
Description
re d
rq m. sc cp .s ta t .h os t.
gt .p ar ti al
are maintained
rq m. sc cp .s ta t .p ar tn
er .g t. pa rt ia l
rq m. sc cp .c ou n t. du mp
.p er io d
rq m. sc cp .s ta t .h as h.
si ze
sc cp st at du mp .r eq ui re d
sc cp st at du mp .p re fi x
sc cp st at -d um p .e xt n
Specifies the prefix for the SCCP stat dump files name.
Default value: rqmstats.sccp
Specifies the extension for the SCCP stat dump file.
Default value: log
sc cp st at du mp .d ir ec to r y
/o pt /R oa mw ar e /l og s/ r3 60 /s t at s
sc cp st at du mp .r ot at io n .t yp e
whichever is earlier
disk space)
Default value: 1
sc cp st at du mp .m ax .s iz e
84
Parameter
Description
3.
Default value: 5242880
sc cp st at du mp .r ot at e. i nt er va
l
sc cp st at du mp .r ot at e. a t
sc cp st at du mp .b uf fe r. s iz e
Specifies the buffer size for the SCCP stat dump file.
Default value: 20
im si .c ac he .s i ze
ms is dn .c ac he . si ze
ms rn .c ac he .s i ze
vl r. ca ch e. si z e
tx nw ri te r. co n .r es ca
n. in te rv al
tx nW ri te r. ro a me r. ha
sh .u pd at e. th r ea ds
tx nW ri te r. ro a me r. qu
eu e. si ze
tx nW ri te r. ro a me r. da
ta .p er si st en t .h as h.
fi le .p at h
/o pt /R oa mw ar e /l og s/ r3 60 /t x nw ri te r/ im
si st or e
tx nW ri te r. ro a me r. da
ta .p er si st en t .h as h.
fi le .m ax si ze
tx nW ri te r. ro a me r. da
ta .p er si st en t .h as h.
fi le .u pd at ei n te rv al
nw .u se .g t. pr e fi x
85
Parameter
Description
this entry in the configuration file.
Note: This is an optional parameter.
vl r. ma pp in g. r eq ui re
d
vl r. ma pp in g. s cr ip t
/o pt /R oa mw ar e /s cr ip ts /a pp s /r 36 0/ vl rm
ap pi ng .p l
vl r. ma pp in g. i nc pa th
pm /r fc ,/ op t/ R oa mw ar e/ sc ri p ts /p er lpm /r 36 0
vl r. ma pp in g. r ef re sh
.i nt er va l
im si .m ap pi ng . re qu ir
ed
im si .m ap pi ng . sc ri pt
/o pt /R oa mw ar e /s cr ip ts /a pp s /r 36 0/ im si
ma pp in g. pl
im si .m ap pi ng . in cp at
h
pm /r fc ,/ op t/ R oa mw ar e/ sc ri p ts /p er lpm /r 36 0
im si .m ap pi ng . re fr es
h. in te rv al
co s. ca ch e. re q ui re d
un ha nd le dm sg _ fi le .r
eq ui re d
un ha nd le dm sg _ fi le .p
86
Parameter
Description
re fi x
un ha nd le dm sg _ fi le .e
xt n
un ha nd le dm sg _ fi le .d
ir ec to ry
op t/ Ro am wa re / lo gs /r 36 0/ tr a ce s/ su mm ar
y
Note: This is a mandatory and read-write parameter.
un ha nd le dm sg _ fi le .o
ff li ne .d ir ec t or y
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es /s um ma
ry /i nd ex er hi s to ry
Note: This is a mandatory and read-write parameter.
un ha nd le dm sg _ fi le .r
ot at io n. ty pe
0 No rotation.
Default value: 5
Note: This is a mandatory and read-write parameter.
un ha nd le dm sg _ fi le .m
ax .s iz e
un ha nd le dm sg _ fi le .r ot at io n .t yp e
parameter is set to 1 or 3 .
un ha nd le dm sg _ fi le .r
ot at e. in te rv a l
87
Parameter
Description
un ha nd le dm sg _ fi le .r ot at io n .t yp e
parameter is set to 2 or 3 .
un ha nd le dm sg _ fi le .r
ot at e. at
unhandledm sg _ fi le .r ot at io n .t yp e
parameter is set to 4 .
un ha nd le dm sg _ fi le .b
uf fe r. si ze
un ha nd le dm sg _ fi le .m
ye ve nt lo g. da t e. fo rm
at
%H:%M:%S
2.
Modify the parameters, if required, according to their descriptions given below in the
table.
T AB L E 12 P AR AME TE R S I N TH E R Q MAL E R TE R . P R O P E R TI E S F I L E
Parameter
Description
lo g. fi le
/o pt /R oa mw ar e /l og s/ r3 60 /a l er te r/ al er
te r. lo g
lo g. le ve l
1 - Fatal
2 - Error
88
Parameter
Description
3 - Warning
4 - Info
5 - Debug
Default value: 5
lo g. si ze
Specifies the size of the log file after which a new log file
is created.
Default value: 5120000
rq ma le rt er
Po st gr eS QL
Or ac le
de fa ul t
po ol s
{p oo ln am e} .d r iv er
{p oo ln am e} .u r l
{p oo ln am e} .u s er
{p oo ln am e} .m a xc on ns
{p oo ln am e} .i n it co nn
s
{p oo ln am e} .t i me ou t
{p oo ln am e} .e n t
{p oo ln am e} .s p ec if ic
en cr yp ti on en a bl ed
ma na ge r. po rt
ma na ge r. ip .a d dr es s
tr ap .v er si on
89
Parameter
Description
tr ap .v 2. gr ou p
re ad .c om mu ni t y
wr it e. co mm un i ty
tr ap .c om mu ni t y
ag en t. po rt
tr ap -f il e. re q ui re d
tr ap -f il e. pr e fi x
tr ap -f il e. di r ec to ry
/o pt /R oa mw ar e /l og s/ r3 60 /a g gr eg at or /t
ra ps
tr ap -f il e. ex t n
tr ap fi le .r ot at io n .t yp e
whichever is earlier
disk space)
Default value:4
tr ap -f il e. ma x .s iz e
tr ap fi le .r ot at e. i nt er va
l
90
Parameter
Description
Default value: 60
tr ap -f il e. ro t at e. at
sn mp .r hi no .s c ri pt
/o pt /R oa mw ar e /b in ar ie s/ r3 6 0/ co nf ig /s
nm p_ al er te r. j s
Specifies the port for the SMTP server
se nd er .l og in . na me
se nd er .p as sw o rd
sm tp .h os t. na m e
sm tp .h os t. po r t
sn mp .m an ag er . ve rs io n= 2
sn mp .m y. li st e n. po rt =1 23 45
sn mp .m an ag er . li st =1 72 .1 6. 1 29 .1 46 :1 62 ,1 7 2. 16 .1 29 .7 8: 1 62
(c om ma s ep ar a te d IP v al ue s o f yo ur S NM P M an ag er h os t s,
yo ur l ap to p, de sk to p IP s )
C onfigure the same port in relay_trap.pl file available in the
{Roamware_ Ho m e} /s cr ip ts /o p er at io ns directory.
my $ mg rV er si o n = $ ab st ra c t- >
ge t( 's nm p' ,' s nm p. ma na ge r. v er si on ', 1) ;
my $ li st en Po r t =$ ab st ra ct - >
ge t( 's nm p' ,' s nm p. my .l is te n .p or t' ,1 23 45 ) ;
St ar t re la y_ t ra p. pl , us in g p er l.
Pe rl r el ay _t r ap .p l
C onfigure the following in alerter property file:
[S NM P]
ma na ge r. po rt = 12 34 5
ma na ge r. ip .a d dr es s= 17 2. 16 . 13 1. 84
tr ap .v er si on = 2
91
Parameter
Description
tr ap .v 2. gr ou p =3
re ad .c om mu ni t y= pu bl ic
wr it e. co mm un i ty =p ub li c
tr ap .c om mu ni t y= pu bl ic
ag en t. po rt =1 6 17 2
Section: Alerts-related information
re po rt .a le rt s .e ma il
tr ue
fa ls e
re po rt .a le rt s .s ms
tr ue
fa ls e
re po rt .f or ce d .m od e
tr ue
fa ls e
al er ts .w ak eu p .h ou r
ci md 2
SM PP
uc p
fi le
de fa ul tp oo l
de fa ul tp oo l
92
Parameter
Description
de fa ul tp oo l. e nt
de fa ul tp oo l. s pe ci fi
c
sm sc .e nt
sm sc .s pe ci fi c
ho st
po rt
mi ni mu mc ou nt
ma xi mu mc ou nt
sy si d
pa ss wo rd
sm sc ty pe
or ig in at or
tr y. ag ai n
ba ck up .p oo ln a me
su pp or t. as yn c .s ub mi
t
nu m. al lo we d. a sy nc .s
ub mi t
ms g. li st en er
ke ep .a li ve
93
Parameter
Description
SMSC . Possible options are yes and no .
Default value: yes
sm sc .t im eo ut
bi nd ty pe
on ly t ra ns mi t
on ly r ec ei ve
bo th t ra ns mi t a nd r ec ei ve
hu ng .s es si on . ti me ou
t
ma x. th re ad s. p er .c on
n
se t. me ss ag e. c la ss .t
yp e
Default value: 40
sm sc .t im eo ut
lo gi n. sl ee p
or ig in at or .t o n
0 - Unknown
1 - International
2 - National
3 - Network Specific
4 - Subscriber Number
5 - Alphanumeric
6 - Abbreviated
or ig in at or .n p i
94
Parameter
Description
0 - Unknown
1 - ISDN (E163/E164)
2 - Data (X.121)
3 - Telex (F.63)
re ce iv er .t on
re ce iv er .n pi
de bu g. on sc re e n
re ce iv er .t im e ou t
in te rf ac e. ve r si on
co mm s. ti me ou t
wa it .d el et e. r es po ns
e
wa it .e nq ui re . re sp on
se
sm sd ir
95
Parameter
Description
Note: This option is kept solely for testing purposes in
lab.
in pu t. di r
er ro r. di r
hi st or y. di r
fi le .p at te rn
po ll .i nt er va l
wr it e- al er tfi le .r eq ui re d
Default value: no
wr it e- al er tfi le .p re fi x
wr it e- al er tfi le .e xt n
wr it e- al er tfi le .d ir ec to r y
Default value:
/o pt /R oa mw ar e /l og s/ r3 60 /a l er te r/ wr it
ea le rt s
wr it e- al er tfi le .r ot at io n .t yp e
space quickly).
96
Parameter
Description
Default value: 3
wr it e- al er tfi le .m ax .s iz e
wr it e- al er tfi le .r ot at e. i nt er va
l
wr it e- al er tfi le .r ot at e. a t
3.
Modifying the
rqmaggregator.properties file
To modify the rqmaggregator.properties file
1.
2.
Modify the parameters, if required, according to their descriptions given below in the
table.
Description
lo g. fi le
lo g. le ve l
Default value:
/ o p t /R o a mw a r e/ l o gs / r 36 0 /a g g re g a to r / ag g r e
g a t o r. l o g
1 - Fatal
97
Parameter
Description
2 - Error
3 - Warning
4 - Info
5 - Debug
Default value: 5
The value of log level depends on the system load. If the
system is running at lower load levels, then the value
should be set to 4 . However, if the load is too high, then
the value should be set to 3 or 2 . Level 5 is used for
testing and debugging.
lo g. si ze
Specifies the size of the log file after which a new log file
is created.
Default value: 5120000
de fa ul t
Po st gr eS QL
Or ac le
de fa ul t
po ol s
va lu e.
{p oo ln am e} .d r iv er
{p oo ln am e} .u r l
{p oo ln am e} .u s er
{p oo ln am e} .m a xc on ns
{p oo ln am e} .i n it co nn
s
{p oo ln am e} .t i me ou t
{p oo ln am e} .e n t
{p oo ln am e} .s p ec if ic
en cr yp ti on en a bl ed
wo rk er .p oo l. s iz e
in st an ce .i d
98
Parameter
Description
used in SNMP traps.
Default value: 1
ma na ge r. po rt
ma na ge r. ip .a d dr es s
tr ap .v er si on
tr ap .v 2. gr ou p
re ad .c om mu ni t y
Default value: 3
wr it e. co mm un i ty
tr ap .c om mu ni t y
ag en t. po rt
tr ap -f il e. re q ui re d
tr ap -f il e. pr e fi x
tr ap -f il e. di r ec to ry
/o pt /R oa mw ar e /l og s/ r3 60 /a g gr eg at or /t
ra ps
tr ap -f il e. ex t n
tr ap fi le .r ot at io n .t yp e
whichever is earlier
99
Parameter
Description
disk space)
Default value:4
tr ap -f il e. ma x .s iz e
tr ap fi le .r ot at e. i nt er va
l
tr ap -f il e. ro t at e. at
sn mp .r hi no .s c ri pt
/o pt /R oa mw ar e /b in ar ie s/ r3 6 0/ co nf ig /s
nm p_ ag gr eg at o r. js
Section: Configuring multiple SNMP managers-related information
In alerter and aggregator, the manager port is the same as defined in
[s nm p]
sn mp .m an ag er . ve rs io n= 2
sn mp .m y. li st e n. po rt =1 23 45
sn mp .m an ag er . li st =1 72 .1 6. 1 29 .1 46 :1 62 ,1 7 2. 16 .1 29 .7 8: 1 62
(c om ma s ep ar a te d IP v al ue s o f yo ur S NM P M an ag er h os t s,
yo ur l ap to p, de sk to p IP s )
C onfigure the same port in relay_trap.pl file available in
{Roamware_ Ho m e} /s cr ip ts /o p er at io ns directory.
[S NM P]
100
Parameter
Description
ma na ge r. po rt = 12 34 5
ma na ge r. ip .a d dr es s= 17 2. 16 . 13 1. 84
tr ap .v er si on = 2
tr ap .v 2. gr ou p =3
re ad .c om mu ni t y= pu bl ic
wr it e. co mm un i ty =p ub li c
tr ap .c om mu ni t y= pu bl ic
ag en t. po rt =1 6 17 2
Section: R360Reports-related information
ba d. di r
Default value:
/o pt /R oa mw ar e /l og s/ r3 60 /s t at s/ ba d
in pu t. di r
/o pt /R oa mw ar e /l og s/ r3 60 /s t at s/ of fl in
e
er ro r. di r
/o pt /R oa mw ar e /l og s/ r3 60 /s t at s/ er ro r
hi st or y. di r
/o pt /R oa mw ar e /l og s/ r3 60 /s t at s/ hi st or
y
fi le .p at te rn
er ro rf il e. pr e fi x
re po rt s. li st
1, 2, 4, 5, 6, 7, 8 ,9 ,1 1, 12 ,1 3, 1 4, 17 ,1 8, 19
,2 0, 21 ,2 2, 23 , 24 ,2 5, 26
db .u pd at e. in t er va l
101
Parameter
Description
re po rt .( x) .c l as s
co m. ro am wa re . ap p. rq m. re po r ta gg re ga to
rs.RQMGene ri c Ag gr eg at or is the value for the
DIAMETER specific parameter report.26.clas s .
3.
Modifying the
rqmsccpaggregator.properties file
To modify the rqmsccpaggregator.properties file
1.
2.
Modify the parameters, if required, according to their descriptions given below in the
table.
T AB L E 14 P AR AME TE R S I N TH E R Q MS C C P AG G R E G ATO R . P R O P E R TI E S F I L E
Parameter
Description
lo g. fi le
/o pt /R oa mw ar e /l og s/ r3 60 /a g gr eg at or /a
gg re ga to r_ sc c p. lo g
lo g. le ve l
1 - Fatal
2 - Error
3 - Warning
4 - Info
5 - Debug
Default value: 5
The value of log level depends on the system load. If the
system is running at lower load levels, then the value
should be set to 4 . However, if the load is too high, then
the value should be set to 3 or 2 . Level 5 is used for
testing and debugging.
lo g. si ze
Specifies the size of the log file after which a new log file
is created.
Default value: 5120000
102
Parameter
Description
de fa ul t
Po st gr eS QL
Or ac le
de fa ul t
po ol s
va lu e.
{p oo ln am e} .d r iv er
{p oo ln am e} .u r l
{p oo ln am e} .u s er
{p oo ln am e} .p a ss wo rd
{p oo ln am e} .m a xc on ns
{p oo ln am e} .i n it co nn
s
{p oo ln am e} .t i me ou t
{p oo ln am e} .e n t
{p oo ln am e} .s p ec if ic
en cr yp ti on en a bl ed
wo rk er .p oo l. s iz e
in st an ce .i d
ma na ge r. po rt
ma na ge r. ip .a d dr es s
tr ap .v er si on
103
Parameter
Description
Default value: 2
tr ap .v 2. gr ou p
re ad .c om mu ni t y
wr it e. co mm un i ty
tr ap .c om mu ni t y
ag en t. po rt
tr ap -f il e. re q ui re d
tr ap -f il e. pr e fi x
tr ap -f il e. di r ec to ry
op t/ Ro am wa re / lo gs /r 36 0/ ag g re ga to r/ tr
ap s
tr ap -f il e. ex t n
tr ap fi le .r ot at io n .t yp e
whichever is earlier
disk space)
Default value: 4
tr ap -f il e. ma x .s iz e
tr ap fi le .r ot at e. i nt er va
l
104
Parameter
Description
3.
Default value: 60
tr ap -f il e. ro t at e. at
sn mp .r hi no .s c ri pt
/o pt /R oa mw ar e /b in ar ie s/ r3 6 0/ co nf ig /s
nm p_ ag gr eg at o r. js
Section: R360Reports-related information
ba d. di r
Default value:
/o pt /R oa mw ar e /l og s/ r3 60 /s t at s/ sc cp _b
ad
in pu t. di r
/o pt /R oa mw ar e /l og s/ r3 60 /s t at s/ sc cp _o
ff li ne
er ro r. di r
/o pt /R oa mw ar e /l og s/ r3 60 /s t at s/ sc cp _e
rr or
hi st or y. di r
/o pt /R oa mw ar e /l og s/ r3 60 /s t at s/ sc cp _h
is to ry
fi le .p at te rn
er ro rf il e. pr e fi x
re po rt s. li st
db .u pd at e. in t er va l
105
Parameter
Description
happen. This way the number of db updates can be
controlled.
Default value: 15
re po rt .( x) .c l as s
3.
Modifying the
rqmdetailaggregator.properties file
To modify the rqmdetailaggregator.properties file
1.
2.
Modify the parameters, if required, according to their descriptions given below in the
table.
T AB L E 15 FI E L D S I N TH E R Q MD E TAI L AG G R E G ATO R . P R O P E R TI E S FI L E
Parameter
Description
lo g. fi le
/o pt /R oa mw ar e /l og s/ r3 60 /a g gr eg at or /a
gg re ga to r_ de t ai l. lo g
lo g. le ve l
1 - Fatal
2 - Error
3 - Warning
4 - Info
5 - Debug
Default value: 5
lo g. si ze
Specifies the size of the log file after which a new log file
is created.
Default value: 5120000
106
Parameter
Description
de fa ul t
Po st gr eS QL
Or ac le
de fa ul t
po ol s
{p oo ln am e} .d r iv er
{p oo ln am e} .u r l
{p oo ln am e} .u s er
{p oo ln am e} .p a ss wo rd
{p oo ln am e} .m a xc on ns
{p oo ln am e} .i n it co nn
s
{p oo ln am e} .t i me ou t
{p oo ln am e} .e n t
{p oo ln am e} .s p ec if ic
en cr yp ti on en a bl ed
wo rk er .p oo l. s iz e
in st an ce .i d
ma na ge r. po rt
ma na ge r. ip .a d dr es s
tr ap .v er si on
107
Parameter
Description
Default value: 2
tr ap .v 2. gr ou p
re ad .c om mu ni t y
wr it e. co mm un i ty
tr ap .c om mu ni t y
ag en t. po rt
tr ap -f il e. re q ui re d
tr ap -f il e. pr e fi x
tr ap -f il e. di r ec to ry
/o pt /R oa mw ar e /l og s/ r3 60 /a g gr eg at or /t
ra ps
tr ap -f il e. ex t n
tr ap fi le .r ot at io n .t yp e
whichever is earlier
disk space)
Default value:4
tr ap -f il e. ma x .s iz e
tr ap fi le .r ot at e. i nt er va
l
108
Parameter
Description
3.
Default value: 60
tr ap -f il e. ro t at e. at
sn mp .r hi no .s c ri pt
/o pt /R oa mw ar e /b in ar ie s/ r3 6 0/ co nf ig /s
nm p_ ag gr eg at o r. js
Section: R360Reports-related information
ba d. di r
Default value:
/o pt /R oa mw ar e /l og s/ r3 60 /s t at s/ de ta il
_b ad
in pu t. di r
/o pt /R oa mw ar e /l og s/ r3 60 /s t at s/ de ta il
_o ff li ne
er ro r. di r
/o pt /R oa mw ar e /l og s/ r3 60 /s t at s/ de ta il
_e rr or
hi st or y. di r
/o pt /R oa mw ar e /l og s/ r3 60 /s t at s/ de ta il
_h is to ry
fi le .p at te rn
er ro rf il e. pr e fi x
re po rt s. li st
db .u pd at e. in t er va l
109
Parameter
Description
controlled.
Default value: 15
re po rt .( x) .c l as s
3.
Also, refer to the release notes corresponding to the build number of the
RWARR360APPS package.
2.
3.
4.
Ensure that following logs folder of indexer should use the logs folder created by R360
1.0 installation as follows:
m a s t er . s ou r c e. d i r= / o pt / Ro a m wa r e /l o g s/ r 3 60 / tr a c es / s um m a ry / h is t o
ry
m a s t er . b ac k u p. d i r= / o pt / Ro a m wa r e /l o g s/ r 3 60 / tr a c es / s um m a ry / i nd e x
e r h i st o r y
m a s t er . e rr o r .d i r =/ o p t/ R oa m w ar e / lo g s /r 3 6 0/ i nd e x er / e rr o r
l o g . di r = /o p t /R o a mw a r e/ l og s / r3 6 0 /i n d ex e r
s n m p .t r a p- f i le . d ir e c to r y= / o pt / R oa m w ar e / lo g s/ r 3 60 / i nd e x er
i n d e xe r . gi g a ba s e .d b . di r =/ o p t/ R o am w a re / l og s /r 3 6 0/ i n de x e r/ D B
i n d e xe r . gi g a ba s e .d b . of f li n e .d i r =/ o p t/ R o am w ar e / lo g s /r 3 6 0/ i n de x e
r / o f fl i n e
i n d e xe r . se a r ch . r es u l t. d ir = / op t / Ro a m wa r e /l o gs / r 36 0 / in d e xe r / se a r
c h _ r es u l t
m a s t er . w or k i ng . d ir = / op t /R o a mw a r e/ l o gs / r 36 0 /i n d ex e r /w o r ki n g
110
m a s t er . w or k i ng . e rr o r .d i r= / o pt / R oa m w ar e / lo g s/ r 3 60 / i nd e x er / w or k i
n g _ e rr o r
5.
Modify other entries as required. Refer to Indexer Installation Guide for more details.
6.
Modifying
COMMONTRACEPARAMS in CSV
files
To modify COMMONTRACEPARAMS across the CSV files
The c s v P r o p e r t i es folder under R O A M W A RE _ HO M E consists of some CSV files for
different trace applications like MAP Trace, ISUP Trace, CAP Trace, etc which is used to send
search queries to Indexer.
For example: r q m - c ap r m ng v o ic e .c s v , r q m - a l p h a f r a u d. c s v
The first column in these C SV files uniquely identifies a particular application and contains the
name of the application or service for which all the corresponding Indexer GUI parameters
belong to. This name will be same as the file name. In case one application needs to show 2
different trace reports, then it will use 2 unique CSV files with different column values for first
column.
For example, if R360 needs to show ISUP trace and C AMEL trace separately, then it will
maintain two different CSV files.
For example: r q m - i su p t ra c e .c s v and r q m - ca p t ra c e .c s v .
Note
For changes in the configurations of the r q m - tr a c e. c s v and r q m d i a s i g n . c s v files, refer to the CSV files that are present in the
{ R o a mw a r e_ H o me } / pa t c ht e mp / R WA R R 36 0 A PP S 1 0< B ui l d Nu m b er > / re l o
c / R o a m w a r e / t e mp / r 36 0 directory. Also, refer to the release notes
corresponding to the build number of the RWARR360APPS package.
These C SV files contain some parameters which need to be modified before Indexer is
queried:
T AB L E 16 P AR AME TE R S I N TH E CSV FI L E S
Parameter
Description
RPC Section in CSV files: This section is same as the RPC configuration section for any
RPC client and connects to the Indexer RPC server.
111
Parameter
Description
rp c. se rv er s
rp c. se rv er .1 . na me
rp c. se rv er .1 . ho st
rp c. se rv er .1 . po rt
rp c. se rv er .1 . mo du le
se ar ch .r es ul t .d ir
tr ac e. fi le .d i r
ma x. re co rd s
se ar ch .r es ul t .d at e.
fo rm at
qu er y. 1. rp c. s er ve r.
mo du le id
1.
For more information about other parameters, refer to Indexer Installation guide. Do not
make any changes in other parameters.
2.
Restart the Indexer application after performing the above changes in the C SV file and
the I n d e x e r . c f g file to implement the changes.
About reportmetadata.xml
Note
This section is only for informational purpose and you do not have to modify
anything in this XML file.
112
Description
id
1 RoamerTendReport
2 RoamerDurationReport
4 RoamingVoiceReport
5 InterconnectVoiceReport
9 MapSignallingReport
11 VoiceFraudReport
12 MonitoredNumberFraud
13 SMSC MismatchFraud
14 AlphaNumericMsisdnFraud
15 SccpReport
16 TrafficSteering
17 C urrentRoamerReport
18 TopSenderSMSReport
19
20
21
22
TopSMSCReport
TopC ountrySMSReport
"PacketData
PacketFraud
23 VIPTrackerReport
24 SubscriberDetailReport
25 - "SIPReports"
26 DiameterReports
na me
6 - C amel Report
7 RoamingSMSReport
8 InterconnectSMSReport
ta bl es
id
pa rt ia ln am e
pa rt it io ne d
gr an ul ar it y
1 Hourly
2 Daily
3 Monthly
113
Attributes
Description
ag gr eg at es
1 Hourly
2 Daily
3 Monthly
nu mf ie ld s
co lu mn na me
co lu mn ty pe
1 Integer
2 C haracter
3 Date
4 Hex
ke yf ie ld
di re ct io nf ie l d
up da te op er at i on s
0 - Do nothing
Except for creating and dropping partitioned tables, R360 EOD process also:
Updates the Voice capacity busy hour table by calculating the busiest hour from the
voice capacity daily tables.
Aggregates the partitioned as well as non partitioned hourly data and updates daily,
weekly and monthly tables from it.
Updates Version capability observed flag if the last updated observed date is older
than 30 days.
114
R360 EOD has the support for parallel execution with multiple instances. Example to
execute db-eod-runner.pl with input arguments:
Here, argument name 1 is the instance ID. For R360, we need to configure EOD with 3
instances:
. / d b -e o d -r u n ne r . pl S ta t sW r i te r 1 1
. / d b -e o d -r u n ne r . pl S ta t sW r i te r 1 2
. / d b -e o d -r u n ne r . pl S ta t sW r i te r 1 3
Note
Run the d b - e o d - r u n n e r. p l once manually before adding it in the cron job.
Before executing EOD script, execute below mentioned SQL commands to provide
privileges to DB user for creating views and tables through stored procedure
Remember that these privileges should be given by another DB user and not the
one who needs privileges.
Run the r q m _ m a p _ m a s t er _ v ie w s .s q l file after executing the EOD manually
to create the views.
R360 database housekeeping (DB EOH) configuration: Use the d b - e o d r u n n e r . p l script to call the S P _ R QM _ E OD stored procedure. For details on using this
script, refer to Mobileum SDS 6.0 Installation Guide.
This stored procedure will periodically update hourly tables of Dashboards. This SP will
populate hourly data in dashboard tables upto previous to previous hour. For example if
this SP is executed on 3:15 then it will populate data upto 2:00.
115
Description
rq m. sa mp li ng c ou nt
rq m. se nd ps ic o un t
rq m. ps it im eo u t
rq m. in tr au lc l ti me
Specifies the time (in seconds) for which the system should
send the Intra UL-CL message.
Default value: 5
Host Network The user will be able to administer data related to a specific or a list of
host networks and view reports related to a specific or a list of host networks
Host alliance The user will be able to view reports related to a specific host alliance (a
collection of host networks)
These users need to be provisioned in the R360 system with their access privileges. Refer
Mobileum SDS Users Guide section User management on how to setup new users.
C reate the same user in BusinessObjects using the BusinessObjects documentation.
Associate this user to a specific home network using the Mobileum Manage User Homes GUI
module. For more information about this GUI module, refer to Mobileum SDS 6.0 Users
Guide.
Note
The above step is important and required for even a single home deployment.
116
Host ID
Vodafone Mumbai
332
Vodafone Gujarat
156
Vodafone Chennai
470
Vodafone Rajasthan
183
Vodafone UP
163
Vodafone MP
5585
Host Alliance Id
Host ID
Vodafone West
332
183
Vodafone North
156
163
T AB L E 20 EX AMP L E S O F EN TR I E S I N TH E R Q M _ U S E R DATAB AS E T AB L E
Host Name
Host Type
Host ID
mumbaiuser
332
chennaiuser
470
westuser
westuser
332
westuser
183
117
Configuring RQMUpload
The RQMUploader consists of the following process to be configured:
SQL Loader
This process runs through the R u n Up l o ad e r. s h script. We need to run this process
through C RONJOB. This SQL Loader process writes into the following database tables:
R Q M _ VE R C AP A B IL I T Y_ S T AT S
R Q M _ VE R C AP B I LT Y _ DT L S _S T AT S
R Q M _ MS U _ DL Y _ ST A T S
Note
The standard recommended frequency of execution for this process is once in a
day.
Modifying rqmupload.properties
To modify rqmupload.properties
1.
2.
Modify the parameters, if required, according to their descriptions given below in the
table.
Warning
Ensure that the configuration parameters are tuned for production environment.
3.
T AB L E 21 P AR AME TE R S I N TH E R Q MU P L O AD . P R O P E R TI E S FI L E
Parameter
Description
118
Parameter
Description
co nf ig .r ef re s h. in
te rv al
en cr yp ti on en a bl ed
lo g. fi le
Specifies the prefix for the names of the log file. For
example, if you specify, dataupload , the first log file will
be created with the name dataupload.log and if it
reaches its maximum size, a backup of the existing file is
created with the convention dataupload.<da te -
ti me >
.log , based on the current date and time.
lo g. le ve l
1 - Fatal
2 - Error
3 - Warning
4 - Info
5 - Debug
Default value: 5
The value of log level depends on the system load. If the
system is running at lower load levels, then the value should
be set to 4 . However, if the load is too high, then the value
should be set to 3 or 2. Level 5 is used for testing and
debugging.
lo g. ma xs iz e
de fa ul t
Po st gr eS QL
Or ac le
de fa ul t
po ol s
{p oo ln am e} .d r iv er
{p oo ln am e} .u r l
{p oo ln am e} .u s er
119
Parameter
Description
{p oo ln am e} .p a ss wo
rd
{p oo ln am e} .m a xc on
ns
{p oo ln am e} .i n it co
nn s
{p oo ln am e} .t i me ou
t
{p oo ln am e} .e n t
{p oo ln am e} .s p ec if
ic
Default value: 1
Default value: 1
or ac le .u rl
sq ll dr .m et ho d s
ot he rp ar am et e rs
ro ws
re ad si ze
bi nd si ze
co nc ur re nt .s q ll dr
.s es si on s
mu lt it hr ea di n g
120
Parameter
Description
Default value: true
pa ra ll el
st re am si ze
Specifies the size (in bytes) of the direct path stream buffer.
Default value: 256000
ba dF il eD ir
co nt ro lF il eD i r
sq ll dr Lo gF il e Di r
di sc ar dM ax
er ro rs
fi le sT oU pl oa d
msu
VerC apability
VerC apbiltyDtls
co nt ro lF il e
in Fi le Di r
ar ch iv eD ir
fa il ed Di r
fi le Na me St ar t eW it
h
fi le Ex te nt io n
Modifying RunUploader.sh
To modify RunUploader.sh
1.
2.
Note
Refer the following cronjob entry to configure this R u n U pl o a de r . sh :
121
0 1 * * *
/ o p t /R o a mw a r e/ s c ri p t s/ o pe r a ti o n s/ r 3 60 / R un U pl o a de r . sh > >
/ l o g s/ r u nu p l oa d e r. l o g
The above log file path needs to be changed as per the site setup.
TRACEHOST
212
http://192.168.38.9:8080
The HOSTID above is nothing but the networkID (in IRDB_NetworkMaster) of the deploying
network. Set the IP and port of the iMAS instance which hosts the JSP page for doing the
Indexer queries.
In case of a multi host deployment, ensure that there are multiple entries, one for each host
of the setup, with the corresponding iMAS IP set in TRACEHOST. As discussed earlier, the
iMAS IP/Port can be the same for all hosts or they may be different per host.
Modifying
RQM_CARRIER_TRACEHOST
A table similar to the above is needed to be populated for deployments with ISUP. The
international voice report of R360 provides an option to drill down to detailed traces for
individual carriers. In this case, it is possible that detailed traces for individual carriers might
be in different locations or all on the same location. The R Q M _C A R RI E R _T R AC E H OS T should
contain an entry for every carrier configured in the system (refer to the Carrier
C onfiguration section in R360 1.0 Administration Guide). For each new carrier defined from
the C arrier Configuration UI, R360 generates a unique carrier ID internally (table
r q m _ c a r r i e r _ m as t e r) . The below table should contain an entry for all the carriers
configured in this table.
122
T AB L E 23 DE TAI L S O F TH E C AR R I E R ID AN D T R AC E HO S T
CARRIERID
TRACEHOST
http://192.168.38.9:8080/tracermain.jsp?processname=showTracerTxns
http://192.168.38.9:8080/tracermain.jsp?processname=showTracerTxns
http://192.168.38.9:8080/tracermain.jsp?processname=showTracerTxns
http://192.168.38.9:8080/tracermain.jsp?processname=showTracerTxns
Note
In cases where there are multiple applications deployed on the same TOMCAT
server and each application has its own C ATALINA_HOME, then the application
folder name should precede the t r a c e r ma i n .j s p . For example if R360 and
NTR are deployed respectively under / o p t /R o a mw a re / t om c a t4 . 1 . 2 4 / w e b a p p s/ R O OT / r 36 0 and / o p t / Ro a m wa r e /t o m ca t 4 . 1 . 2 4 / w e b a p p s/ R O OT / n tr , then the URL should be modified to
h t t p :/ / 1 92 . 1 68 . 3 8. 9 . 80 8 0/ r 3 60 / t ra c e ma i n .j s p? p r oc e s sn a m e
= s h o wT r a ce r T xn s
The same should also be taken care of while configuring the APPPARAMS table
described in an earlier section.
2.
Be sure that the G l o b a l C u st o m iz a t io n . zi p filefrom the R W A R J R SA d d on - 5. 5< B u i l d n u m b e r > - b i n . z i p package is extracted to the Tomcat folder.
3.
Extract the R Q M _ N T R _ R3 6 0 _C u s to m i za t i on s .z i p file from the R W A R R 3 60 A P PS 1 . 0 - < B u i l d n u m be r > -s o l 10 - oc i 1 0g - s pa r c .p k g .g z package to the Tomcat
folder.
Restart Tomcat server.
4.
5.
Import the R 3 6 0 - 1 . 0- j s -r e p or t s .z i p file from the R W A R R 36 0 A PP S - 1. 0 < B u i l d n u m b e r > -s o l 10 - o ci 1 0g - s pa r c .p k g .g z package into Jasper.
For information on importing this file, refer to the Importing R360-1.0-js-reports.zip file
and configuring permissions for the reports module section on page 123.
6.
123
2.
Modify the permissions of the imported reports module in the JasperReports Server GUI.
For more information, refer to the Modifying permissions of reports module section on
page 124.
3.
Modify the data source that the reports module is connecting to from the JasperReports
Server GUI. For more information, refer to the Modifying reports data source section
on page 125.
Important
Before importing a new R 3 6 0 -1 . 0 -j s -r e p or t s .z i p file in to the
JasperReports Server application, be sure to check whether the R360 folder is
present in the JasperReports Servers repository. If the R360 folder is already
present, then you must delete this folder before importing the R 3 6 0- 1 . 0- j sr e p o r t s . z i p file.
To check if the R360 folder is already present, perform the following:
In JasperReports Server GUIs menu bar, click Repository under the View
menu.
From the left navigation pane, click Public and then click Mobileum.
C heck if the R360 folder is present under Mobileum. If present, then delete the
folder.
124
Login to JasperReports Server GUI, using the standalone JasperReports Server URL, as
superuser.
The JasperReports Server homepage appears.
2.
3.
4.
5.
6.
C lick Import.
To modify permissions
1.
Login to JasperReports Server GUI, using the standalone JasperReports Server URL, as
superuser.
The JasperReports Server homepage appears.
2.
3.
4.
From the left navigation pane, first expand the Public > Mobileum > R360 folders.
Then, right click on R360 and select Permissions.
The Permissions pop-up window appears.
5.
125
FI G U R E 4 RE P O R TS MO D U L E P E R MI S S I O N S
6.
C lick Apply.
Login to JasperReports Server GUI, using the standalone JasperReports Server URL, as
superuser.
The JasperReports Server homepage appears.
2.
3.
4.
From the left navigation pane, click the Public > Mobileum > R360 > Data Source
folder.
The data sources available for R360 appear in the right pane.
126
FI G U R E 5 R360 D ATA S O U R C E S
5.
FI G U R E 6 R360 E D I T D ATA S O U R C E P AG E
6.
T AB L E 24 FI E L D S I N TH E ED I T DATA S O U R C E P AG E
Field name
Description
JD BC D ri ve r
The database driver that the R360 application uses to connect to the
Oracle database.
Default value: oracle.jdbc.dr iv er . Or ac le Dr iv er
UR L
The URL that the R360 application uses to connect to the database.
The following URL format is supported:
127
Field name
Description
Pa ss wo rd
7.
8.
C lick Save.
{Roamware_ Ho m e} /b in ar ie s/ i pp ro be /c on fi g directory.
Refer to the IPProbe 6.0 Installation guide for the basic configuration of the IPProbe platform
component.
2.
Description
ap p. li b. gt p. e xt n
.1 .n am e
op t/ Ro am wa re / li bs /l ib gt pt x nw ri te r. 6. 2. s
o
128
Parameter
Description
ap p. li b. gt p. e xt n
.1 .f un c
ap p. li b. gt p. e xt n
.1 .c fg pr ef ix
gt pt xn wr it er . ms g
.a ll oc at or .s i ze
gt pt xn wr it er . ms g
.a ll oc at or .h w m. p
er ce nt
gt pt xn wr it er . ms g
.a ll oc at or .l w m. p
er ce nt
Default value: 70
Default value: 60
gt pt xn wr it er . de t
ai lf il e. re qu i re d
gt pt xn wr it er . de t
ai lf il e. pr ef i x
gt pt xn wr it er . de t
ai lf il e. ex tn
gt pt xn wr it er . de t
ai lf il e. di re c to r
y
gt pt xn wr it er . de t
ai lf il e. of fl i ne .
di re ct or y
gt pt xn wr it er . de t
ai lf il e. ro ta t io n
.t yp e
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es /d et ai l
Default value:
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es /d et ai l/ h
is to ry
Type of rotation to be used for the trace file.
Possible options are:
quickly)
Default value: 2
gt pt xn wr it er . de t
ai lf il e. ma x. s iz e
gt pt xn wr it er . de t
ai lf il e. ro ta t e. i
nt er va l
129
Parameter
Description
gt pt xn wr it er . de t
ai lf il e. ro ta t e. a
t
gt pt xn wr it er . de t
ai lf il e. of fl i ne .
di re ct or y. is d ay w
is e
gt pt xn wr it er . de t
ai lf il e. bu ff e r. s
iz e
gt pt xn wr it er . ma s
te rf il e. re qu i re d
gt pt xn wr it er . ma s
te rf il e. pr ef i x
gt pt xn wr it er . ma s
te rf il e. ex tn
gt pt xn wr it er . ma s
te rf il e. di re c to r
y
gt pt xn wr it er . ma s
te rf il e. of fl i ne .
di re ct or y
gt pt xn wr it er . ma s
te rf il e. ro ta t io n
.t yp e
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es /s um ma ry
Default value:
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es /s um ma ry /
of fl in e
quickly)
Default value: 2
gt pt xn wr it er . ma s
te rf il e. ma x. s iz e
gt pt xn wr it er . ma s
te rf il e. ro ta t e. i
nt er va l
gt pt xn wr it er . ma s
te rf il e. ro ta t e. a
t
Time (in the HHMM (24-hour) format) at which the master file
is rotated.
gt pt xn wr it er . ma s
130
Parameter
Description
te rf il e. bu ff e r. s
iz e
gt pt xn wr it er . ma s
te rf il e. my ev e nt l
og .d at e. fo rm a t
gt pt xn wr it er . tc p
.a na ly si s. re q ui r
ed
%H:%M:%S
co s. ca ch e. re q ui r
ed
ap p. li b. gt p. n am e
ap p. li b. gt p. f un c
ap p. li b. gt p. c fg p
re fi x
ap p. li b. gt p. d ev i
ce .n um
ap p. li b. gt p. d ev i
ce .1 .t yp e
file.
2 : Adapter
Input
network adapter.
Default value: 1
ap p. li b. gt p. d ev i
ce .1 .n am e
ap p. li b. gt p. d ev i
ce .1 .f il te r
131
Parameter
Description
For example, udp and (port 2123 or port 2152)
Default value: (udp and (port 2123 or port
21 52 o r po rt 33 86 o r (i p[ 6 :2 ] & 0x 1f ff
!= 0 )) ) or ( v la n an d ud p a nd ( po rt 2 12 3
or p or t 21 52 or p or t 33 86 or ( ip [6 :2 ] &
0x 1f ff ! = 0) ) )
Note: To catch fragmented IP packets without applying a
port filter, use the expression (ip[6:2] & 0x1fff !=0) as an 'or'
condition.
For example, udp and (port 2123 or port 2152 or port 3386
or (ip[6:2] & 0x1fff != 0))
For fragmented packets, the allowed port list is configured
separately.
ap p. li b. gt p. d ev i
ce .1 .t im eo ut . ms e
c
ap p. li b. gt p. d ev i
ce .1 .p oo l. si z e
Device pool (and queue size) and watermarks for the queue.
This pool size must be equal to pool sizes of application
libraries like GTP Writer.
Default value: 10000
ap p. li b. gt p. d ev i
ce .1 .q ue ue .l w m. p
er ce nt
ap p. li b. gt p. d ev i
ce .1 .q ue ue .h w m. p
er ce nt
ap p. li b. gt p. d ev i
ce .1 .i pf ra g. e na b
le
Device pool (and queue size) and watermarks for the queue.
This pool size must be equal to pool sizes of application
libraries like GTP Writer.
Default value: 50
Device pool (and queue size) and watermarks for the queue.
This pool size must be equal to pool sizes of application
libraries like GTP Writer.
Default value: 75
Determines whether the application is expecting IP fragments
to arrive.
Possible options are:
ap p. li b. gt p. d ev i
ce .1 .i pf ra g. m ax .
si mu lt an eo us . tr a
ns ac ti on s
132
Parameter
ap p. li b. gt p. d ev i
ce .1 .i pf ra g. t im e
ou t
ap p. li b. gt p. d ev i
ce .1 .s na pl en
Description
Timeout for clearing incomplete fragmented transactions in
seconds.
Default value: 15
The frame size which is captured by l i b p c a p.
The minimum and maximum values of this parameter must
be 1514 and 65535 respectively.
Default value: 1514
gt pp ca p. fi le . pa t
te rn
gt pp ca p. po ll . in t
er va l
gt pp ca p. po st . pr o
ce ss .a ct io n
Value (in integer format) that indicates the post action of the
GTPTxnWriter application after processing files successfully.
The following values are supported:
Default value: 1
gt pp ca p. fa il . pr o
ce ss .a ct io n
files.
to a different directory.
files."
Default value: 1
gt pp ca p. so ur c e. d
ir
/o pt /R oa mw ar e /l og s/ ip pr ob e /d um ps /i np ut /
gt p
gt pp ca p. ba ck u p. d
ir
/o pt /R oa mw ar e /l og s/ ip pr ob e /d um ps /p ro ce s
se d
gt pp ca p. er ro r .d i
r
/o pt /R oa mw ar e /l og s/ ip pr ob e /d um ps /e rr or
gt pp ca p. ma x. s ec o
nd s. wi th ou t. t dr .
fi le s
133
Parameter
Description
raised.
Default value: 900
Note
Manually update the data for the following fields in which packet data p c a p files
are processed for running or uploading packet data calls and for inroamer or
outroamer.
C urrently, external GUI interface is not supported to update the following table:
IRDB_GSN_IP_RANGES
(
N E TW O R KI D
NU M B ER ( 5)
N O T N U LL ,
R A NG E _ ID
NU M B ER ( 5)
N O T N U LL ,
I P _A D D RE S S
VA R C HA R 2( 4 0 B Y T E) ,
C I DR
NU M B ER ( 3) ,
I P VE R S IO N
NU M B ER ( 1)
D E FA U L T 4 ,
S T AT U S
NU M B ER ( 1)
D E FA U L T 1 ,
L A ST _ U PD A T ED
DA T E ,
U P DA T E D_ B Y
VA R C HA R 2( 5 0 B Y T E)
3.
You have successfully modified the IPProbe.cfg file to configure the IPProbe platform
component for packet data support in the R360 application.
134
Note
For more information about the how the IPProbe platform component handles SIP
messages, refer to IPProbe 6.0 Installation Guide.
The R360 application has its own extension library for the SIP reports, which requires to be
plugged on top of the IPProbe platform component. To configure the IPProbe platform
component for supporting the SIP messages in the R360 application, you must modify the
IPProbe.cf g file of the IPProbe platform component.
The IPProbe.cfg file is located at the
{Roamware_ Ho m e} /b in ar ie s/ i pp ro be /c on fi g directory.
2.
Description
ap p. li b. si p. e xt n. 1. n
am e
/o pt /R oa mw ar e /l ib s/ li bs ip t xn wr it er
.s o
ap p. li b. si p. e xt n. 1. f
un c
ap p. li b. si p. e xt n. 1. c
fg pr ef ix
si pt xn wr it er . ms g. al l
oc at or .s iz e
si pt xn wr it er . ms g. al l
oc at or .h wm .p e rc en t
si pt xn wr it er . ms g. al l
Default value: 70
135
Parameter
Description
oc at or .l wm .p e rc en t
above-mentioned allocator.
Default value: 60
si pt xn wr it er . de ta il f
il e. re qu ir ed
si pt xn wr it er . de ta il f
il e. pr ef ix
si pt xn wr it er . de ta il f
il e. ex tn
si pt xn wr it er . de ta il f
il e. di re ct or y
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es /d et
ai l
si pt xn wr it er . de ta il f
il e. of fl in e. d ir ec to r
y
si pt xn wr it er . de ta il f
il e. ro ta ti on . ty pe
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es /d et
ai l/ hi st or y
The type of rotation to be used for the trace file.
Possible options are:
disk quickly)
si pt xn wr it er . de ta il f
il e. ma x. si ze
si pt xn wr it er . de ta il f
il e. ro ta te .i n te rv al
si pt xn wr it er . de ta il f
il e. ro ta te .a t
si pt xn wr it er . de ta il f
il e. of fl in e. d ir ec to r
y. is da yw is e
si pt xn wr it er . de ta il f
il e. bu ff er .s i ze
si pt xn wr it er . ma st er f
il e. re qu ir ed
136
Parameter
Description
Default value: true
si pt xn wr it er . ma st er f
il e. pr ef ix
si pt xn wr it er . ma st er f
il e. ex tn
si pt xn wr it er . ma st er f
il e. di re ct or y
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es /s um
ma ry
si pt xn wr it er . ma st er f
il e. of fl in e. d ir ec to r
y
si pt xn wr it er . ma st er f
il e. ro ta ti on . ty pe
/o pt /R oa mw ar e /l og s/ r3 60 /t r ac es /s um
ma ry /o ff li ne
The type of rotation to be used for the master file.
Possible options are:
disk quickly)
si pt xn wr it er . ma st er f
il e. ma x. si ze
si pt xn wr it er . ma st er f
il e. ro ta te .i n te rv al
si pt xn wr it er . ma st er f
il e. ro ta te .a t
si pt xn wr it er . ma st er f
il e. bu ff er .s i ze
si pt xn wr it er . ma st er f
il e. my ev en tl o g. da te .
fo rm at
%H:%M:%S
co s. ca ch e. re q ui re d
137
Parameter
Description
ap p. li b. si p. n am e
/o pt /R oa mw ar e /l ib s/ li bs ip w ri te r. 6.
0. so
ap p. li b. si p. f un c
ap p. li b. si p. c fg pr ef i
x
ap p. li b. si p. d ev ic e. n
um
ap p. li b. si p. d ev ic e. 1
.t yp e
PC AP file.
2 : Adapter
Input
Mode - To probe
Default value: 1
ap p. li b. si p. d ev ic e. 1
.n am e
ap p. li b. si p. d ev ic e. 1
.f il te r
ap p. li b. si p. d ev ic e. 1
.t im eo ut .m se c
138
Parameter
Description
Note:
Default value: 10
ap p. li b. si p. d ev ic e. 1
.p oo l. si ze
ap p. li b. si p. d ev ic e. 1
.q ue ue .l wm .p e rc en t
ap p. li b. si p. d ev ic e. 1
.q ue ue .h wm .p e rc en t
ap p. li b. si p. d ev ic e. 1
.i pf ra g. en ab l e
Default value: T r u e
ap p. li b. si p. d ev ic e. 1
.i pf ra g. ma x. s im ul ta n
eo us .t ra ns ac t io ns
ap p. li b. si p. d ev ic e. 1
.i pf ra g. ti me o ut
ap p. li b. si p. d ev ic e. 1
.s na pl en
si pp ca p. fi le . pa tt er n
si pp ca p. po ll . in te rv a
l
139
Parameter
Description
Default value: 5
si pp ca p. po st . pr oc es s
.a ct io n
Default value: 1
si pp ca p. fa il . pr oc es s
.a ct io n
failed files.
Default value: 1
si pp ca p. so ur c e. di r
/o pt /R oa mw ar e /l og s/ ip pr ob e /d um ps /i
np ut
si pp ca p. ba ck u p. di r
/o pt /R oa mw ar e /l og s/ ip pr ob e /d um ps /p
ro ce ss ed
si pp ca p. er ro r .d ir
/o pt /R oa mw ar e /l og s/ ip pr ob e /d um ps /e
rr or
si pp ca p. ma x. s ec on ds .
wi th ou t. td r. f il es
si pw ri te r. nu m .p ro ce s
so r. th re ad s
si pw ri te r. ma x .s im ul t
an eo us .s es si o ns
140
Parameter
si pw ri te r. ma x .s im ul t
an eo us .s es si o ns .h wm .
pe rc en t
Description
The higher water mark percentage of session pool that
the SIPTxnWriter application simultaneously handles.
Default value: 80
Note: The value of this field varies from 0 to 100 . It
is recommended to set the value as 80 .
si pw ri te r. ma x .s im ul t
an eo us .s es si o ns .l wm .
pe rc en t
si pw ri te r. ma x .s im ul ta ne ou s .s es si on
s.hwm.perc en t field..
si pw ri te r. ma x .t ra ns a
ct io n. ti me ou t .s ec
si pw ri te r. ma x .s es si o
n. ti me ou t. se c
si pw ri te r. ma x .r eg is t
ra ti on .c ac he . si ze
si pw ri te r. ma x .r eg is t
ra ti on .c ac he . ti me ou t
3.
You have successfully modified the IPProbe.cfg file to configure the IPProbe platform
component for SIP support in the R360 application.
141
To support the Diameter-related reports in the R360 application, you must configure the
IPProbe platform component. The IPProbe platform component uses the Diameter messages
for creating, modifying, and terminating Diameter sessions.
The R360 application has its own extension library for the Diameter reports, which requires
to be plugged on top of the IPProbe platform component. To configure the IPProbe platform
component for supporting the Diameter messages in the R360 application, you must modify
the IPProbe.cf g file of the IPProbe platform component.
The IPProbe.cfg file is located at the
{Roamware_ Ho m e} /b in ar ie s/ i pp ro be /c on fi g directory.
2.
Default Value
Syntax
Access
Status
Description
Mandat
ory
ap p. li b
.d ia .e x
tn .1 .n a
me
op t/ Ro am
wa re /l ib
s/ li bd ia
ev tp ub li
sh er .6 .0
.s o
String
ReadWrite
ap p. li b
.d ia .e x
tn .1 .f u
nc
D i a E vt P u b
l i s h er _ G e
t A p p Ex t n
String
ReadWrite
Mandat
ory
ap p. li b
.d ia .e x
tn .1 .c f
gp re fi x
d i a e vt p u b
String
ReadWrite
Mandat
ory
di at xn w
ri te r. m
sg .a ll o
ca to r. s
iz e
1 0 0 0 00
Integer
ReadWrite
Mandat
ory
di at xn w
ri te r. m
sg .a ll o
ca to r. h
wm .p er c
en t
70
Integer
ReadWrite
Mandat
ory
142
Parameter
Default Value
Syntax
Access
Status
Description
di at xn w
ri te r. m
sg .a ll o
ca to r. l
wm .p er c
en t
60
Integer
ReadWrite
Mandat
ory
di at xn w
ri te r. d
et ai lf i
le .r eq u
ir ed
tr ue
Boolean
ReadWrite
Mandat
ory
di at xn w
ri te r. d
et ai lf i
le .p re f
ix
di a
String
ReadWrite
Mandat
ory
di at xn w
ri te r. d
et ai lf i
le .e xt n
de ta il
String
ReadWrite
Mandat
ory
di at xn w
ri te r. d
et ai lf i
le .d ir e
ct or y
/ o p t /R o a m
w a r e /l o g s
/ r 3 6 0/ t r a
c e s / de t a i
l
String
ReadWrite
Mandat
ory
di at xn w
ri te r. d
et ai lf i
le .o ff l
in e. di r
ec to ry
/ o p t /R o a m
w a r e /l o g s
/ r 3 6 0/ t r a
c e s / de t a i
l / h i st o r y
String
ReadWrite
Mandat
ory
di at xn w
ri te r. d
et ai lf i
le .r ot a
ti on .t y
pe
Integer
ReadWrite
Mandat
ory
is reached
di at xn w
ri te r. d
et ai lf i
le .m ax .
si ze
5 2 4 2 88 0
Integer
ReadWrite
Mandat
ory
di at xn w
ri te r. d
et ai lf i
Integer
ReadWrite
Mandat
ory
143
Parameter
Default Value
Syntax
Access
Status
Description
di at xn w
ri te r. d
et ai lf i
le .r ot a
te .a t
00 01
Integer
ReadWrite
Mandat
ory
di at xn w
ri te r. d
et ai lf i
le .o ff l
in e. di r
ec to ry .
is da yw i
se
tr ue
Boolean
ReadWrite
Mandat
ory
di at xn w
ri te r. d
et ai lf i
le .b uf f
er .s iz e
Integer
ReadWrite
Mandat
ory
le .r ot a
te .i nt e
rv al
di at xn w
ri te r. m
as te rf i
le .r eq u
ir ed
tr ue
Boolean
ReadWrite
Mandat
ory
di at xn w
ri te r. m
as te rf i
le .p re f
ix
di aM as te
r
String
ReadWrite
Mandat
ory
di at xn w
ri te r. m
as te rf i
le .e xt n
lo g
String
ReadWrite
Mandat
ory
di at xn w
ri te r. m
as te rf i
le .d ir e
ct or y
/o pt /R oa
mw ar e/ lo
gs /r 36 0/
tr ac es /s
um ma ry
String
ReadWrite
Mandat
ory
di at xn w
ri te r. m
as te rf i
le .o ff l
in e. di r
ec to ry
/o pt /R oa
mw ar e/ lo
gs /r 36 0/
tr ac es /s
um ma ry /o
ff li ne
String
ReadWrite
Mandat
ory
di at xn w
ri te r. m
as te rf i
le .r ot a
ti on .t y
pe
Integer
ReadWrite
Mandat
ory
144
Parameter
Default Value
Syntax
Access
Status
Description
interval, whichever is earlier
di at xn w
ri te r. m
as te rf i
le .m ax .
si ze
52 42 88 0
Integer
ReadWrite
Mandat
ory
di at xn w
ri te r. m
as te rf i
le .r ot a
te .i nt e
rv al
Integer
ReadWrite
Mandat
ory
di at xn w
ri te r. m
as te rf i
le .r ot a
te .a t
00 01
Integer
ReadWrite
Mandat
ory
di at xn w
ri te r. m
as te rf i
le .b uf f
er .s iz e
Integer
ReadWrite
Mandat
ory
di at xn w
ri te r. m
as te rf i
le .m ye v
en tl og .
da te .f o
rm at
%Y -% m- %d
%H :% M: %S
String
ReadWrite
Mandat
ory
Mandat
ory
/o pt /R oa
mw ar e/ li
bs /l ib di
aw ri te r.
6. 0. so
String
ap p. li b
.d ia .f u
nc
Di aW ri te
r_ Ge tA pp
String
ReadWrite
Mandat
ory
ap p. li b
.d ia .c f
gp re fi x
di aw ri te
r
String
ReadWrite
Mandat
ory
ap p. li b
Integer
Read-
Mandat
ap p. li b
.d ia .n a
me
ReadWrite
145
Parameter
Default Value
Syntax
.d ia .d e
vi ce .n u
m
ap p. li b
.d ia .d e
vi ce .1 .
ty pe
Integer
Access
Status
Description
Write
ory
ReadWrite
Mandat
ory
ap p. li b
.d ia .d e
vi ce .1 .
na me
di ap ca p
String
ReadWrite
Mandat
ory
ap p. li b
.d ia .d e
vi ce .1 .
fi lt er
po rt
38 68 o r
(v la n
an d po rt
38 68 )
String
ReadWrite
Mandat
ory
ap p. li b
.d ia .d e
vi ce .1 .
ti me ou t
.m se c
10
Integer
ReadWrite
Mandat
ory
ap p. li b
.d ia .d e
vi ce .1 .
po ol .s i
ze
10 00 0
Integer
ReadWrite
Mandat
ory
146
Parameter
Default Value
Syntax
Access
Status
Description
ap p. li b
.d ia .d e
vi ce .1 .
qu eu e. l
wm .p er c
en t
50
Integer
ReadWrite
Mandat
ory
ap p. li b
.d ia .d e
vi ce .1 .
qu eu e. h
wm .p er c
en t
75
Integer
ReadWrite
Mandat
ory
ap p. li b
.d ia .d e
vi ce .1 .
ip fr ag .
en ab le
fa ls e
Boolean
ReadWrite
Mandat
ory
ap p. li b
.d ia .d e
vi ce .1 .
ip fr ag .
ma x. si m
ul ta ne o
us .t ra n
sa ct io n
s
Integer
ReadWrite
Mandat
ory
ap p. li b
.d ia .d e
vi ce .1 .
ip fr ag .
ti me ou t
15
Integer
ReadWrite
Mandat
ory
ap p. li b
.d ia .d e
vi ce .1 .
sn ap le n
15 14
Integer
ReadWrite
Mandat
ory
di ap ca p
.f il e. p
at te rn
pc ap
String
ReadWrite
Mandat
ory
di ap ca p
.p ol l. i
nt er va l
Integer
ReadWrite
Mandat
ory
di ap ca p
.p os t. p
ro ce ss .
ac ti on
Integer
ReadWrite
Mandat
ory
147
Parameter
Default Value
Syntax
Access
Status
Description
different directory.
di ap ca p
.f ai l. p
ro ce ss .
ac ti on
Integer
ReadWrite
Mandat
ory
/o pt /R oa
mw ar e/ lo
gs /i pp ro
be /d um ps
/i np ut /d
ia
String
ReadWrite
Mandat
ory
/o p t / R o a mw
a r e / lo g s /
i p p r ob e / d
u m p s /p r o c
essed
String
ReadWrite
Mandat
ory
di ap ca p
.e rr or .
di r
/o pt /R oa
mw ar e/ lo
gs /i pp ro
be /d um ps
/e rr or
String
ReadWrite
Mandat
ory
di ap ca p
.m ax .s e
co nd s. w
it ho ut .
td r. fi l
es
90 0
Integer
ReadWrite
Mandat
ory
di ap ca p
.s ou rc e
.d ir
di ap ca p
.b ac ku p
.d ir
di aw ri t
er .t ra n
sp or t. t
yp e
tc p, sc tp
String
ReadWrite
Mandat
ory
SC TP
TC P
di aw ri t
er .s ct p
fr ag .m a
x. si mu l
ta ne ou s
.t ra ns a
ct io ns
10
Integer
ReadWrite
Mandat
ory
di aw ri t
er .s ct p
fr ag .t i
30
Integer
ReadWrite
Mandat
ory
148
Parameter
Default Value
Syntax
Access
Status
Description
the old packets are discarded.
me ou t
di aw ri t
er .m ax .
tc p. st r
ea ms
10
Integer
ReadWrite
Mandat
ory
di aw ri t
er .t cp .
se gm en t
at io n. t
im eo ut
20 00
Integer
ReadWrite
Mandat
ory
di aw ri t
er .a pp i
ds .t o. t
ra ck
16 77 72 51
String
ReadWrite
Mandat
ory
di aw ri t
er .1 67 7
72 51 .c o
mm an ds .
to .t ra c
k
31 6- 32 3
String
ReadWrite
Mandat
ory
diawriter. ap p id s. to .t ra ck
parameter) as a comma-separated list or
a range.
For example, for S6a application ID
16777251 following are the command
codes for various S6a messages:
32 1
The above codes can be configured in the
following ways:
As comma-separated values -
31 6, 31 7, 31 8, 3 19 ,3 20 ,3 21
As a range - 316-321
Note:
di aw ri t
er .n um .
pr oc es s
or .t hr e
ad s
Integer
ReadWrite
Mandat
ory
di aw ri t
er .m ax .
10 00 0
Integer
ReadWrite
Mandat
ory
149
Parameter
Default Value
Syntax
Access
Status
Description
simultaneously handle.
si mu lt a
ne ou s. t
ra ns ac t
io ns
di aw ri t
er .m ax .
si mu lt a
ne ou s. t
ra ns ac t
io ns .h w
m. pe rc e
nt
80
di aw ri t
er .m ax .
si mu lt a
ne ou s. t
ra ns ac t
io ns .l w
m. pe rc e
nt
60
di aw ri t
er .m ax .
tr an sa c
ti on .t i
me ou t. m
se c
10 00 0
ReadWrite
Mandat
ory
Integer
ReadWrite
Mandat
ory
si pw ri te r. ma x .s im ul ta ne ou s .
sessions.h wm . pe rc en t field..
3.
Integer
ReadWrite
Mandat
ory
You have successfully modified the IPProbe.cfg file to configure the IPProbe platform
component for Diameter support in the R360 application.
Configuring VIPTracker
To configure VIPTracker
1.
2.
C onfigure CoS (class of subscriber) for individual or group of subscribers using CoS
C onfiguration module of SDS 7.0. For details refer Mobileum SDS 7.0 Users Guide.
C onfigure thresholds for different KPIs of VIPTracker for configured C oS, using "COS
Threshold Configuration" module. Refer R360 1.0 Administration Guide.
3.
4.
150
Note
SDS C oS Configuration supports configuring CCNDC or MCCMNC to configure all the
MSISDNs or IMSIs of particular network. But, for VIP Tracker n R360, all the
subscribers of network cannot be VIP subscribers and R360 will not support this.
You can configure a maximum of 500K subscribers for VIPTracker.
C onfigure "snmp_uri_list" parameter in APPPARAMS table for following APPID with SNMP
Agent details of below mentioned binaries.
PARAMNAME
PARAMVALUE
S832
sn mp _u ri _l is t
S30007
sn mp _u ri _l is t
2.
3.
Add new users for the new homes and associate them with respective home networks.
4.
151
C onfiguring Default Groups and Users with Different Access Rights for Tracer on page
154
Modifying GetImsiList.sh
Note
G e t I m s i L i s t . s h script uses / u sr / l oc a l /b i n /d a t e - d command for date
related operations. Ensure that u s r / l oc a / bi n / da t e exists; if it does not exist
then install it.
To modify GetImsiList.sh
1.
2.
Modify the parameters, if required, according to their descriptions given below in the
table.
T AB L E 29 P AR AME TE R S I N TH E G E T I MS I L I S T . S H FI L E
Parameter
Description
UN IQ UE _I MS I_ L IS T_ ON
LI NE _D IR
co un tr y. un iq u e. ou tr oa me r. i ms il is t. di
rectory in statswrite r. cf g .
Default value:
/o pt /R oa mw ar e /l og s/ r3 60 /i m si li st s/
UN IQ UE _I MS I_ L IS T_ OF
FL IN E_ DI R
co un tr y. un iq u e. ou tr oa me r. i ms il is t. of
fline.dire ct o ry in statswrit er .c fg .
Default value
/o pt /R oa mw ar e /l og s/ r3 60 /i m si li st s/ of
fl in e/
152
Parameter
Description
CU RR EN T_ IM SI _ LI ST _D
IR
/o pt /R oa mw ar e /l og s/ r3 60 /s t at sw ri te r/
im si st or e/
CU RR EN T_ IN RO A ME R_ FI
LE _N AM E_ PR EF I X
CU RR EN T_ OU TR O AM ER _F
IL E_ NA ME _P RE F IX
IN RO AM ER _N W_ F IL E_ NA
ME _P RE FI X
ne tw or k. un iq u e. in ro am er .i m si li st .p re
fix in statswrite r. cf g .
Default value: network_unique _i nr o am er
OU TR OA ME R_ NW _ FI LE _N
AM E_ PR EF IX
ne tw or k. un iq u e. ou tr oa me r. i ms il is t. pr
efix in statswrit er .c fg .
Default value: network_unique _o ut r oa me r
OU TR OA ME R_ CT R Y_ FI LE
_N AM E_ PR EF IX
co un tr y. un iq u e. ou tr oa me r. i ms il is t. pr
efix in statswrit er .c fg .
Default value country_unique _ ou tr oa me r
3.
Description
cv sf il eP at h
Specifies the path of the directory where roamer list output files
(UI search output files) will be generated.
sh el lS cr ip tP a th
/o pt /R oa mw ar e /s cr ip ts /o pe r at io ns /r 36 0/ G e
tI ms iL is t. sh
153
2.
Note
Modify the path in the below-mentioned parameter, if required.
[RQM]
r q m - sm s - tr a c e- t e mp l a te d i r = /o p t /R o a mw a r e/ r o am w ar e s ds / r un t i me / w eb a pp s / S8 2 5 /t e m pl a t es / e
n/
Description
Pa th
Specify the IP address and port of your Tomcat server where the
tracer is installed or running.
Description
154
Parameter
Description
rq m. ma p. ms gl i st
Specify the list of MAP messages for which group have access
to see the summary level trace.
Possible options are 1, 2, 3, 4, 5, 6, 7, 8, 9,
10 , 11 , 12 , 1 3, 1 4, 1 5, 1 6 , 17 , 18 , 19 ,
20 , 21 , 22 , 2 3, 2 4, 2 5, 2 6 , 27 , 28 , 29
If the default value is not configured, then the application
assumes that the default value is ALL the MAP messages.
rq m. pc ap .e na b le
rq m. pc ap .m sg l is t
Specify the list of MAP messages for which the group has
access to detailed level trace.
This property is useful only if r q m . p ca p .e n a bl e is true for
the specified group. This should be the subset of the list
configured in rqm.map.msgl is t .
Possible options are 1, 2, 3, 4, 5, 6, 7, 8, 9,
10 , 11 , 12 , 1 3, 1 4, 1 5, 1 6 , 17 , 18 , 19 ,
20 , 21 , 22 , 2 3, 2 4, 2 5, 2 6 , 27 , 28 , 29
If the default value is not configured, then the application
assumes that the detail trace of all the messages will be
disabled.
tr ac e. vi ew er . cl a
ss
co m. ro am wa re . ap p. rq m. rq mt r ac e. SM ST ra ce V
iewer .
If the default value is not configured, then the application
assumes that the detailed trace will be shown in pcap.
T AB L E 33 L O G I N DE TAI L S F O R A C C E S S TO T R AC E S
Group name
Access
Default user
R360
r3 60 us er
R360View
r3 60 vi ew
R360Summma
ry
r3 60 su mm ar y
R360Restricted
r3 60 tr ac e
R360Sms
r3 60 sm s
R360SmsSum
mary
r3 60 su mm ar y
1
155
Group name
Access
Default user
R360SmsImas
Trace
r3 60 sm st ra c
e
5
Configuring R360 on Hadoop
Important
In addition to the configurations that you performed in the C onfiguring the R360
Application chapter on page 38, the following configurations are required in the
case of Hadoop-based R360 deployment.
To configure the R360 application on Hadoop cluster, you must modify certain properties files
such c o o r d i n a t o r. p r op e r ti e s . You may also configure the Oozie services by
modifying the time or frequency of the Oozie job flow.
This chapter contains the following topics:
2.
Kill all running Oozie jobs, if any by performing the following steps:
a.
b.
c.
d.
C lick Kill.
157
3.
Run the
{ R o a m w a r e _ H o m e} / s cr i p ts / op e r at i o ns / r 36 0 / wo r kf l o w/ R u nO o z ie . s h
script.
4.
2.
T AB L E 34 P AR AME TE R S I N TH E C O O R D I N ATO R . P R O P E R TI E S F I L E
Parameter
Description
HA DO OP _R OA MW A RE
_H OM E
ho st No de Na me
ma pr ed uc e. jo b .u
se r. na me
st ar t_ da te
en d_ da te
Jo bT ra ck er
na me No de
oo zi e. us e. sy s te
m. li bp at h
158
Parameter
Description
sharelib.
us er .n am e
User name with which you have installed the Wisdom and R360
master processes.
For example, hdfs
oo zi e. co or d. a pp
li ca ti on .p at h
hd fs :/ /n od e1 : 80 20 /$ HA DO OP _ RO AM WA RE _H OM E /
wo rk sp ac es /m a st er _c oo rd in a to r
wf _a pp li ca ti o n_
pa th
hd fs :/ /n od e1 : 80 20 /$ HA DO OP _ RO AM WA RE _H OM E /
wo rk sp ac es /n e w_ r3 60 _w is do m
r3 60 _w is do m_ w or
k_ pa th
hd fs :/ /n od e1 : 80 20 /$ HA DO OP _ RO AM WA RE _H OM E /
wo rk sp ac es /r 3 60 _w is do m
ma x_ ts _w or k_ p at
h
hd fs :/ /n od e1 : 80 20 /$ HA DO OP _ RO AM WA RE _H OM E /
wo rk sp ac es /m a x_ ts _m r
ro am er _d ur _w o rk
_p at h
hd fs :/ /n od e1 : 80 20 /$ HA DO OP _ RO AM WA RE _H OM E /
wo rk sp ac es /r o am er _d ur at io n
un iq ue _r oa me r _w
or k_ pa th
hd fs :/ /n od e1 : 80 20 /$ HA DO OP _ RO AM WA RE _H OM E /
wo rk sp ac es /u n iq ue _r oa me r
RD _M R_ Di r
$R OA MW AR E_ HO M E/ sc ri pt s/ op e ra ti on s/ r3 60 / r
oa me rd ur at io n /
TS _U pd at e_ Co m ma
nd
$R OA MW AR E_ HO M E/ sc ri pt s/ op e ra ti on s/ r3 60 / c
om mo n/
TS _s cr ip t_ pa t h
$R OA MW AR E_ HO M E/ sc ri pt s/ op e ra ti on s/ r3 60 / c
om mo n/
3.
6
Verifying the Installation
Now that you have configured the R360, it is time to start R360. Starting R360 consists of
the following steps:
Checkpoint
Before starting R360, ensure that the prerequisite components are up and running.
Starting TxnWriter
Now that you have configured the TxnWriter, it is time to start it.
To start TxnWriter
1.
2.
3.
4.
160
Note
If Watchdog is deployed for R360, then it will automatically start the TxnWriter.
Starting StatsWriter
Now that you have configured the StatsWriter, it is time to start it.
To start StatsWriter
1.
2.
3.
4.
Note
If Watchdog is deployed for R360, then it will automatically start the StatsWriter.
Starting statswriter_2
You must start the new instance of statswriter to enable certain other R360-related services.
To start statswriter_2
1.
2.
Starting RQMAlerter
Now that you have configured the RQMAlerter, it is time to start it.
To start RQMAlerter
1.
2.
161
Starting RQMAggregator
Now that you have configured the RQMAggregator, it is time to start it.
To start RQMAggregator
1.
2.
Starting RQMSCCPAggregator
Now that you have configured the RQMSCCPAggregator, it is time to start it.
To start RQMSCCPAggregator
1.
2.
Starting RQMDetailAggregator
Now that you have configured the RQMDetailAggregator, it is time to start it.
To start RQMDetailAggregator
1.
2.
162
You must use the r 3 6 0 account to log in to R360 SDS Administrator Studio for the first
time. Use the following out-of-the-box credentials to log in:
Username: r 3 6 0
Password: r 3 6 0 us e r @1 2 3
1.
2.
< h o s t n a m e > with the host name or the IP address of the system where the R360
SDS Administrator Studio is deployed
< p o r t > with the port number on which the R360 SDS Administrator Studio is
listening. This is usually for 8080 for Apache Tomcat.
Username: r 3 6 0
Password: r 3 6 0 us e r @1 2 3
4.
Since this is a first-time login, you will be prompted to change the password. After you
change the password, the login page appears again.
5.
Log in now with the r 3 6 0 u s e r username and the new password you set in step 4.
The landing page of the R360 SDS Administrator Studio appears.
Note
For more information about the various administrative roles supported by the R360
application, refer to the Supported Administrative Roles section of R360 1.0
Administration Guide.
7
Stopping R360
Stopping R360 consisting of the following steps:
Stopping TxnWriter
It is recommended that you stop R360 properly before you shut down the machine. This
ensures that all the related processes are closed in the appropriate order.
To stop TxnWriter
1.
2.
Run M e n u . p l .
3.
4.
Stopping StatsWriter
To stop StatsWriter
164
1.
2.
Run M e n u . p l .
3.
4.
Stopping RQMAlerter
To stop RQMAlerter
1.
2.
Stopping RQMAggregator
To stop RQMAggregator
1.
2.
Stopping RQMSCCPAggregator
To stop RQMSCCPAggregator
1.
165
2.
Go to the { R o a m w a r e _ H o m e} / s cr i p ts / op e r at i o n/ r 3 60 d i r e c t o r y a n d
r u n t h e S t o p R Q M S C C P A g gr e ga t o r. s h file.
Stopping RQMDetailAggregator
To stop RQMDetailAggregator
1.
2.
A
Post Installation Checklist
Ensure the following after R360 is installed:
C heck that the view R Q M _ US E R contains the entry for the required user for the required
network or networks (and zone and nodes if applicable).
R Q M _ T R A C E H O S T table contains at least one entry for the corresponding host ID.
All the directory structures (source directory, offline directory, history directory) for all
the binaries (including indexer) are as mentioned in the configuration sections of the
corresponding binaries in the Installation Guide.
c s v P r o p e r t i e s file are pointing to correct IP, port (same as indexer port), search
output file and trace file path.
B
Roaming Replicator Handling in the
R360 Application
R360 1.0 gives the ability to provide reports to the sponsored network in a Roaming
Replicator (RR) arrangement for the Roaming Replicator sponsored partner networks. For
example, suppose STC Saudi Arabia is the sponsoring network, Viva Bahrain is the sponsored
network and Vodafone UK is the partner network of STC with whom Viva Bahrain does not
have any direct roaming, but roaming via STC where STC is the sponsoring network. When
the feed from Roaming Replicator is provided to R360 installed in Viva Bahrain, then R360
can provide the reports to Viva Bahrain regarding the roaming performance with respect to
Vodafone UK. Below is a schematic representation of how this can be achieved.
e
ob
Pr
ed
fe
of
e
th
ct
re
di
RR in sponsored
network
Partner network
g
in
am
ro
Sponsored
network
ner
ork
netw
dt
R an
en R
twe
p be
art
he p
Ta
In the above example, R360 is installed in the sponsored network. The sponsored network
would have its own direct roaming with select partners. The feed from this direct roaming
partner should be obtained through the regular probing mechanism. For the roaming with RR
sponsored networks, the feed should be obtained by placing a tap between RR and the
partner network, or between RR and the sponsored network. This can be through a normal
probing mechanism or, if Mobileum RR and smart STP is installed, by publishing the MTP2
feed from SmartSTP to R360. If the input is being taken between RR and roaming partner,
then care should be taken to filter out the GTs for other sponsored networks of the RR
168
arrangement, else there will be a lot of unwanted load on the R360 installed in the sponsored
network.
RR does a translation of sponsored network GTs to sponsor network GTs (reserved for RR)
and sponsored network IMSIs to sponsor network IMSIs (based on the IMSI range reserved
in RR for the sponsored network), to enable roaming between the sponsored network and the
RR partner network. R360 will need to know these translations to derive the correct IMSI and
GT, and hence the correct host and partner network based on/from where the feed has been
taken to R360.
For this purpose, the mappings between dummy and actual GTs and IMSIs need to be
somehow published to R360 and made known in R360 for it to take the correct action based
on the same. In case the RR is Mobileum RR, then these mappings are maintained in a simple
text files. If it is some other vendor RR, then the mappings could reside in a configuration file
like Mobileum RR or in some database or some other source. Irrespective of the source where
the mappings are maintained, R360 provides a flexible mechanism to read these mappings
via a Perl script. The Perl script shipped with the package has the capability to read the
mappings from the Mobileum RR configuration file. If the source of mappings is not a file and
some other source, then the Perl script will need to be modified accordingly at the site. The
script can also periodically refresh its mappings based on a refresh interval.
Mobileum RR maintains the IMSI and GT mappings in configuration files. The IMSI
mappings are fairly static, however the GT mappings are dynamic and get updated based
on any new node that is discovered by RR. These mapping files need to be periodically
made available to R360 in a specified folder (as configured in the Perl script).
2.
The frequency of FTP can be decided based on the changes to the GT mapping file
observed in a given day. If the changes are fairly huge, then the frequency of FTP can be
higher (for example every hour). On the other hand if RR has been up and running for a
fairly long time, then the mappings would be fairly exhaustive and there would be very
few incremental mappings created every day. In that case the frequency of FTP can be
set to once or twice a day. It is important to note that until the updated mappings are
known to R360, R360 would ignore such records. In other words, the statistics for that
interim period would be lost. However, once the mappings are known to R360, it will
start capturing the statistics correctly.
3.
In case of Mobileum RR mapping files, the mappings are maintained both ways, forward
and reverse. Depending on where the feed is taken from/for R360, the Perl script should
be customized to read either the forward mappings (sponsored to sponsor) or the
reverse mappings (sponsor to sponsored). This can be done by a simple check on the
C C -NDC of the sponsored network to identify the mappings of the sponsored network
where R360 is being installed.
C
Enabling VAM in the R360 Application
This section deals with enabling various VAMs of the R360 application.
To enable VAM
1.
2.
3.
Enable C AP VAM
4.
5.
C onfigure and run IPProbe with GTPTxnWriter. Refer to the C onfiguring IPProbe
platform component for packet data support section on page 127.
Run the following SQL file if the Packet Data VAM is in scope along with the Fraud
Report VAM:
d a t a ba s e /o r a cl e / pr e p op s /r q m _e n a bl e _ pa c k et d at a f ra u d .s q l
Run the following SQL file if the ISUP VAM is in scope along with the Fraud Report
VAM:
d a t a ba s e /o r a cl e / pr e p op s /r q m _e n a bl e _ is u p fr a ud . s ql
170
6.
7.
Packet Data High Usage Report in Packet Data folder if PACKET DATA VAM is
in scope.
Perform the steps provided in the Add SDS7.0 CoS Configuration Module section.
Restart txnwriter, statswriter, IPProbe (if enabled), Alerter binaries along with
Tomcat server.
D
Whats New in This Guide
This section summarizes the additions, modifications, and deprecations made in each release
to the process of installing and configuring the R360 application, and provides pointers about
additional information. Where appropriate, it discusses the enhancements made to this
document itself.
This section contains the following topic:
R160817 Initial release on page 171
Additions
Table 35 on page 171 lists and describes the additions made in this release of R360 1.0.
T AB L E 35 A D D I TI O N S
Topic
Description
172
Topic
Description
platform
steps.
For details, refer to the Installing and verifying Mobileum
Wisdom platform on page 29.
Modifying permissions of
reports module
Modifications
No modifications have been made in this release of the R360 application.
Deprecations
No deprecations have been made in this release of the R360 application.
Documentation Enhancements
No document-specific enhancement has been made in this release of the R360 application.
However, details about additions, modifications, and deprecations made in this release are
documented appropriately, as discussed in the previous sections.
End of Document