h pmr

********************************************************************************
*******
pmr[agfkwop3] [-g <mofilter>|<mogroup>] [-z <mogroup>] [-r <report(s)>] [-l <zip
file>|<directory>] [-w <webdirectory>] [-i <iubCellModule-file>] [-f <formulafil
e>] [-c <configfile>] [-m <minushours>] [-p <plushours>] [-s <startdate>[.<start
time>]] [-e <enddate>[.<endtime>]] [-o <outputFormat>] [-t <thresholdfile>] [|<u
nix-cmds>]
********************************************************************************
*******
Produce PM KPI reports, based on counter values in statistics ROP files and form
ulas in CPI documentation.
Report choice:
*************
- if the command "pmrg" is used then all available reports are printed.
- if the option "-r" is used then it is possible to specify which reports to pr
int. Eg: pmr -r 1,3,5-10,12 ---> reports 1,3,5,6,7,8,9,10,12 are printed
- if the option "f" is used then the ropfiles are simply fetched and stored in
a zipfile. The zipfile is called <node>_ropfile.zip and its location is <logdir>
/pmfiles/<nodeaddress>/<date_time> . Another location can be specified by runnin
g: pmrf <directory>. The zipfile can then be used for offline processing with th
e "-l" option.
- otherwise, the ROP files are fetched and a menu is printed, prompting the use
r to enter a report number, or "x" to exit the pmr menu.
Options:
********
- The "a" option is for fetching all available ROP files from the node.
- The "f" option is for fetching and saving the ROP files to a zipfile, which w
ill be called <node>_ropfiles.zip. No reports are printed. In case of CPP nodes,
a file containing MO data needed for certain reports is included.
- The "ff" option is same as "f" but the MO data file is not included which mak
es the collection quicker. This option is used when collecting a DCG since MO da
ta will already be available in the MO dump.
- The "g" option is for printing all available reports, the menu will not be sh
own.
- The "k" option is for keeping the counters marked with the suspected faulty t
ag "<sf>TRUE</sf>", without this option they are discarded.
- The "w" option is for generating a web report in table and graph format. The
"-w" switch can be used to specify the location of the webpage. Currently works
best with Firefox, avoid IE.
- The "o" option is for printing official KPI reports, using the KPI names of t
he CPI. Currently available for RNC only.
- The "p" option is for generating PNG files, using GnuPlot.
- The "3" option is for printing 3GSIM instantaneous counters from /c/3gsim/sta
ts
MO filtering:
*************
- The option "-z <mogroup>" can be used to save the MOs printed by a report int
o a MO group.
Example: to save the MOs printed by the RNC report "Worst 20 cells for RRC", run
"pmr -r <report> -z <mogroup>".
- The option "-g" can be used to calculate KPIs for a smaller group of MOs inst
ead of all. The processing time will be quicker and it is then possible to filte
r results on smaller groups of resources. Example:
>> "pmr -g tdmterm" will show KPIs based on TdmTermGrp counters only
>> "pmr -g cellmod8" will show KPIs based on counters of cells belonging to mod

ule 8 only (where cellmod8 is a MO group created with the command "ma iubmod8 iu
blink module =8$" and "ma cellmod8 iubmod8 reserved")
- The option "-g" can also be used to exclude certain MOs from the reports, by
using the exclamation mark (!) as a negative filter.
Example: to exclude the MOs printed in the report "Worst 20 cells for RRC", run
"pmr -r <report> -z worstcellsgroup", then "pmr -g !worstcellsgroup".
Threshold file:
**************
To check that the KPIs are within certain criteria, a threshold file can be spec
ified with the option "-t".
Example of threshold file and syntax explanation can be found at moshell/example
s/pm_files/thresholds.txt.
Any KPI that are outside the the criteria specified in the threshold file will b
e marked in red or purple, depending on the severity.
Generate Web report:
*******************
Example:
>> "pmrwg" : all reports will be saved to a web page in a default chosen locati
on which is printed at the end of the pmr printout
>> "pmrw -r 1-10,14 -w /home/user/public_html/RNC14" : reports 1-10 and 14 are
saved to a web page located under /home/user/public_html/RNC14
Each pmr report in the web page shows up as a table and in some cases a graph is
also generated. Currently works best with Firefox, avoid IE.
Generate PNG files:
*******************
The option "p" can be used to generate PNG files, using GnuPlot. The GnuPlot pac
kage can be installed from cygwin "select packages" window: Graphics > gnuplot
(** Note : you may have to do a new re-install of cygwin to get gnuplot working)
Example:
>> pmrp -m 24
For RNC, it is recommended to run the plot on selected cell by using MO group. E
xample:
>> ma myrbs iublink=1234 reservedby
>> pmrp -m 24 -g myrbs
Suspected faulty counters:
*************************
If some ROP files contain counters marked with the "suspected faulty" tag (<sf>T
RUE</sf>) then they are silently discarded unless the user has given the option
"k" (pmrk) in which case the suspected faulty counter values will be kept. To id
entify which counter values are marked with the suspected faulty tag, the comman
d "pmxs" can be used.
Online/Offline:
**************
a) online
To use pmr online (ie when connected to a node) just skip the "-l" option.
The function will check if there are any new XML files on the node, download any
new XML files to the workstation as long as their timestamp is within the times
pan specified by the "-m/-p/-s/-e" options, get some MO configuration data and p
rint the menu.
b) offline
To run pmr offline, specify the location of the ROP files with the "-l" option.
The location can be a folder or a zipfile produced by the pmrf command. Refer to
the "Offline mode" chapter for more info.
Time options:

*************
If the command "pmra" is used then all ROP files are fetched. Otherwise, the ROP
files of the last hour are fetched.
The "-m" and "-p" options are used for specifying the timespan that the reports
should cover, in hours or parts of hours.
The timespan is relative to the node's current date/time if online, and relative
to the most recent file timestamp if offline.
Example:
>> "pmr -m 5" will show statistics for the last 5 hours.
>> "pmr -m 5 -p 3" will show statistics starting 5 hours ago and 3 hours from t
hen on (ie: up to 2 hours ago).
>> "pmr -m 0.25" will show statistics for the last 15 minutes
>> "pmr -m 0.5" will show statistics for the last 30 minutes
By default the timespan is for the last 1 hour.
The "-s" and "-e" options are used for specifying an absolute timespan. The time
stamp should be in the format yyyymmdd[.hhmm]
Example:
>> pmr -s 20050705 -e 20050710
>> pmr -s 20050705.1000
>> pmr -s 20050705.1000 -e 20050705.1915
Piping:
*******
It is possible to pipe each report into some unix commands. The pipe is done at
the "Your Choice" prompt, after the menu listing all the reports.
Example:
- to view report 4 and sort it numerically on the third column, type: 4 | sor
t -k3 -n
- to view report 5 and grep for lines matching "205", type:
5 | gre
p 205
- to view report 3 and reverse sort it numerically on the fourth column, type:
3 | sort -k4 -n -r
If more reports are deemed necessary (eg reports for other kind of nodes) please
contact finn.magnusson@ericsson.com to get these included.
Output format:
*************
The output format can be specified with the "-o" option.
By default, the output is text but it is also possible to specify the following
formats:
- csv
: Comma separated
- html
: HTML
- htmltab : HTML tables only (use for embedding into a web page)
Note: HTML reports are best generated with the option "w", e.g. "pmrw". See desc
ription further up.
IubCellModule file:
*******************
This file is only needed when offline, when printing reports aggregated on Iub/M
odule/AtmPort/Subrack level.
If ROP files have been collected with "pmrf" then the file is automatically incl
uded with the ROP files and will be used when parsing the ROP files offline. Oth
erwise, the path of the file can also be specified with the option "-i".
This file contains the following printouts:
get ^aal5tpvcctp= vcltpid
get ^unisaaltp= aal5tpvcctpid
get ^nbapcommon= unisaaltpref

get ^iublink=
rncmoduleref
get ^utrancell= iublinkref
get device=
spmreference
get ^ipaccesshostet= ipInterfaceMoRef
get ^sctp= rpuid
pr ^(ipinterface|pluginunit|atmport|vpltp|vcltp|ethernetswitchport|ethernetswitc
hmoduleport|internalethernetport|gigabitethernet)=
Handling of duplicated counter instances:
*****************************************
Counter instances that are defined in several PM scanners will be reported by CP
P as duplicated entries in the ROP files.
This can lead to unexpected results, such as counters with doubled values.
Usually the pmr/pmx commands can successfully ignore the duplicated counter entr
ies but only when all the processed ROP files have the same type of counter dupl
ication.
Unexpected values will occur when some of the processed ROP files have a duplica
tion while other dont.
Therefore it is highly recommended to make sure that none of the counters are de
fined in several scanners at the same time.
The commands pgets and pmxs will show if there are any duplicated counter instan
ces in the PM scanners.