Monitoring with MRTG
Home Page Up Ayecka SR1 TelliCast software RAMdisk Next steps eToken Help! DVB-S2 tests SR1 updates Monitoring with MRTG

 

Using MRTG with EUMETCast

Most of this information related to the Ayecka SR1 receiver, which has excellent monitoring capabilities, but some of the throughput and TelliCast loss monitoring can be dome with any receiver.  

For the success using the commands below, please be sure to update your SR1 software to the current version (1.05b243).  I have presented the configuration files as a base file, to which you can add the include files as you desire and as your expertise in using MRTG builds.

Please be careful when copying and pasting the examples below - sometime a very long line will wrap and produce errors from MRTG.

There is information on other EUMETCast monitoring with MRTG here.

Back to DVB-S2 testing information
Back to DVB-S2 SNMP information
Back to performance graphs

 

Base MRTG file

Assign the directories to suit your own system.  In the example below, I have split the configuration files into a base file (MRTG.CFG) and several include files (of type .INC).  The include files, together with any Perl scripts (file type .PL), can all live in the same directory, such as C:\Tools\mrtg\bin\.

I suggest putting the HTML and Image files into a common directory so that you can easily upload them to your Web server on the Internet.  Note also that you may need to create the LogDir, HtmlDir and ImageDir directories yourself - MRTG may not do it for you.  Look for any error messages the first time you run MRTG.  If you are already running a local Web server its /mrtg/ directory might be a suitable choice, if it has one.

Leave the "Timezone[_]: UTC" as reporting world-wide is in UTC and not local time.

Note that if you are running the older 1.05b232 software you will need the  SingleRequest: Yes  line in the MRTG configuration file.  It is not needed for the more recent 1.05b243 software which supports SNMP "bulk" requests. 

# This file is mrtg.cfg in the "bin" diretcory

# Assign these directories to suit your own system
LogDir:   C:/Tools/mrtg/logs
HtmlDir:  C:/Tools/mrtg/html
ImageDir: C:/Tools/mrtg/html
# Settings for all statistics gathered
RunAsDaemon: Yes
Interval: 5
# These are default values. For a 600 pixel image
# we want 500 graph points. Confusing, isn't it?

XSize[_]: 500
Timezone[_]: UTC
TimeStrPos[_]: RU
TimeStrFmt[_]: %Y-%b-%d
SnmpOptions: timeout => 15
# Settings for the Ayecka SR1 DVB-S2 receiver

# The following line needed for 1.05b232 software
SingleRequest: Yes
# NoMib2: Yes
# Now add include files as you wish, for example:

# A file for monitoring the local PC network:
Include: alta.inc

# and files for monitoring the Ayecka SR1 box
Include: sr1-snr.inc
Include: sr1-link-margin.inc
Include: sr1-dual-link-margin.inc
Include: sr1-level.inc
Include: sr1-ber.inc
Include: sr1-traffic.inc
Include: sr1-frames.inc
Include: tellicast-molde.inc

Running MRTG

These notes are written on the assumption that you are extending an existing MRTG installation on your PC at add some EUMETCast monitoring.  There are more notes on other MRTG monitoring such as CPU and memory usage here.  Once you have MRTG downloaded and expended into a directory such as C:\Tools\, you should find directories including:

  C:\Tools\MRTG
  C:\Tools\MRTG\bin
  C:\Tools\MRTG\lib
  C:\Tools\MRTG\images

The configuration file is named mrtg.cfg, and should be edited in notepad.  There's a sample just above.  To keep the file relatively clean, I have used the "include" ability to add monitoring for the various parameters I need.  Using Include files means that if you edit and break something you can just comment out the Include file while you sort out the problem.  To run Perl, I suggest you create a small script which runs the Perl interpreter with the main ~107 kB mrtg file as a parameter, and that file itself need a parameter to tell it where to find its configuration file, so you end up with a command like:

  perl mrtg mrtg.cfg

I find it helpful to see that I have tried to start MRTG, but I want to run it minimised, so I end up with a command file like:

REM  File:  C:\Tools\MRTG\bin\Start-MRTG.cmd

TIMEOUT 4

START "Run MRTG" /D C:\Tools\MRTG\bin\ /MIN perl mrtg mrtg.cfg

EXIT

where the TIMEOUT command allows me to see on the screen that the command has been started, and using the START command allows me to run MRTG minimised.  You will have your own preferred way for doing this.  If you need to change anything you will need to restart MRTG, by using right-click, Close on the minimised command window.
 

Network throughput for multiple adapters on your PC

Network I/O is really what MRTG was designed for, so it's the basic use of the software.  You can read all about MRTG here, but here are some brief notes.  You will need to install and enable SNMP on your PC for monitoring of the PC to work.  First, an include file for monitoring a single network connection on a PC.

# File alta.inc

#---------------------------------------------------------------
# PC Alta - normal LAN network traffic
#---------------------------------------------------------------

Target[Alta]: /192.168.0.1:public@127.0.0.1
MaxBytes[Alta]: 125000000
Options[Alta]: unknaszero, growright
Title[Alta]: Traffic Analysis for Realtek PCIe GBE on Motherboard
PageTop[Alta]: <H1>PC Alta - House LAN Traffic Analysis</H1>
<TABLE>
<TR><TD>Interface:</TD><TD>Realtek PCIe GBE Family Controller on motherboard</TD></TR>
<TR><TD>Max Speed:</TD><TD>1 Gbits/s Ethernet</TD></TR>
</TABLE>

#---------------------------------------------------------------

You can also use the network number, but using the IP address is easier as it doesn't change as the network number can.

.
.
Target[Alta]: 10:public@127.0.0.1
.
.

In the above case, the network interface number (10) was derived by running the  cfgmaker  program supplied with the MRTG distribution.

MRTG will need to know either the IP address of the adapters, or the network number assigned to the adapters.  Typically in the installations we are using for TelliCast the IP addresses will be fixed, and the network numbers may vary when devices are added or removed or when a major Windows update takes place.

To find the network interface numbers easily, you can use the command: route print /4.  Here is an edited sample output:

C:\Users\David>route print /4
===========================================================================
Interface List
 21...6c fd b9 00 6f 42 ......Realtek PCI GBE Family Controller
 10...20 cf 30 c7 bb 49 ......Realtek PCIe GBE Family Controller

You can see that this PC has two network adapters, and you would need to distinguish between the numbers 10 and 21.  You should already know the IP addresses, but if not you can enter the command:  ipconfig, or, for more detail:  ipconfig /all.  Here's the edited output:

C:\Users\David>ipconfig

Ethernet adapter EUMETCast SR1:

   Connection-specific DNS Suffix  . :
   IPv4 Address. . . . . . . . . . . : 192.168.10.104
   Subnet Mask . . . . . . . . . . . : 255.255.255.0
   Default Gateway . . . . . . . . . :

Ethernet adapter House LAN:

   Connection-specific DNS Suffix  . :
   IPv4 Address. . . . . . . . . . . : 192.168.0.1
   Subnet Mask . . . . . . . . . . . : 255.255.255.0
   Default Gateway . . . . . . . . . : 192.168.0.10

and from:  ipconfig /all

C:\Users\David>ipconfig /all

Ethernet adapter EUMETCast SR1:

   Connection-specific DNS Suffix  . :
   Description . . . . . . . . . . . : Realtek PCI GBE Family Controller
   Physical Address. . . . . . . . . : 6C-FD-B9-00-6F-42
   DHCP Enabled. . . . . . . . . . . : No
   Autoconfiguration Enabled . . . . : Yes
   IPv4 Address. . . . . . . . . . . : 192.168.10.104(Preferred)
   Subnet Mask . . . . . . . . . . . : 255.255.255.0
   Default Gateway . . . . . . . . . :
   NetBIOS over Tcpip. . . . . . . . : Enabled

Ethernet adapter House LAN:

   Connection-specific DNS Suffix  . :
   Description . . . . . . . . . . . : Realtek PCIe GBE Family Controller
   Physical Address. . . . . . . . . : 20-CF-30-C7-BB-49
   DHCP Enabled. . . . . . . . . . . : No
   Autoconfiguration Enabled . . . . : Yes
   IPv4 Address. . . . . . . . . . . : 192.168.0.1(Preferred)
   Subnet Mask . . . . . . . . . . . : 255.255.255.0
   Default Gateway . . . . . . . . . : 192.168.0.10
   DNS Servers . . . . . . . . . . . : 8.8.8.8
                                       208.67.222.222
   NetBIOS over Tcpip. . . . . . . . : Enabled

You can see that I renamed the adapters so that the one connected to the house LAN was more obvious, and that is the PICe controller on IP 192.168.0.1,  and the controller on network number 10 is the adapter connected to the SR1 traffic port.  So either of the following methods could be used to specify monitoring of that networks:

Target[Alta-house-LAN]: 10:public@127.0.0.1
.
.

Target[Alta-EUMETCast-LAN]: 21:public@127.0.0.1
.
.

 

Target[Alta-house-LAN]: /192.168.0.1:public@127.0.0.1
.
.

Target[Alta--EUMETCast-LAN]: /192.168.10.104:public@127.0.0.1
.
.

  

Monitoring the traffic accepted by your PC from the SR1

Here is an example to monitor the traffic accepted by your PC from the SR1.  This will be less than the traffic sent from your SR1 as the traffic will be limited to just those channels you have selected in the channel configuration file.

#---------------------------------------------------------------
#	PC Alta - network traffic from Ayecka SR1
#---------------------------------------------------------------

Target[Alta-2]: /192.168.10.104:public@127.0.0.1
MaxBytes[Alta-2]: 12500000
Options[Alta-2]: bits, unknaszero, growright, noo
Title[Alta-2]: SR1 DVB-S2 RX LAN Traffic Analysis
PageTop[Alta-2]: <H1>PC Alta - SR1 DVB-S2 RX LAN Traffic Analysis</H1>
 <TABLE>
   <TR><TD>Interface:</TD><TD>Realtek PCI GBE Family Controller</TD></TR>
   <TR><TD>Max Speed:</TD><TD>SR1 1 Gbits/s Ethernet</TD></TR>
 </TABLE>

#---------------------------------------------------------------
 
 


Monitoring
the Ayecka SR1

The following are examples with the default address for the SR1 management port, 192.168.10.99.  Change the address to the actual IP address of the remote port on the SR1 as required.  This is the port number you connect to with PuTTY or with the SR1 Controller program.

Signal to noise ratio - Es/No - SNR

# File sr1-snr.inc
#---------------------------------------------------------------
#	SR1 - receiver Es/No
#---------------------------------------------------------------

Target[SR1-snr]: 1.3.6.1.4.1.27928.101.1.1.4.4&1.3.6.1.4.1.27928.101.1.1.4.4:public@192.168.10.99
MaxBytes[SR1-snr]: 180
YTics[SR1-snr]: 6
YTicsFactor[SR1-snr]: 0.1
Factor[SR1-snr]: 0.1
Unscaled[SR1-snr]: dwmy
Title[SR1-snr]: Ayecka SR1 Es/No
Options[SR1-snr]:  gauge, nopercent, growright, unknaszero, noo
ShortLegend[SR1-snr]: dB
YLegend[SR1-snr]: Es/No: dB
LegendI[SR1-snr]: Es/No:
Legend1[SR1-snr]: Received Es/No (signal-to-noise ratio)
PageTop[SR1-snr]: <H1>Ayecka SR1 - Es/No (Edinburgh)</H1>

#---------------------------------------------------------------

 
Dual link margin

Thanks to some programming by software guru Francis Breame, we now have a better way of measuring the link margin for the two services separately.  Francis has provided a Zip file containing his program and notes regarding using it in MRTG, and you can download those notes here.  This is an extract from the first release of those notes.  I found that I could not get the Net::SNMP module (or any module) with the version of Perl I had installed perhaps a decade back, but it was fine on a recent installation of 32-bit ActiveState Perl 5.16.1.1601 as described here.  You will need to alter the directories below to meet your own local configuration.  I've slightly edited Francis's notes below to make some of the file names clearer.

Francis Breame writes:  

This Perl script generates separate link margin statistics for both the basic and high volume modcods using by EUMETCast DVB-S2, and formats them for display by MRTG.  As the modcods change unpredictably, it has to sample the vales fairly quickly, and therefore has to run continuously.   It produces a file which can then be input by MRTG.

  1. Ensure that you have a version of Perl installed (I prefer Strawberry these days - less restrictive than ActiveState - ymmv).
     
  2. Ensure that the Perl library Net::SNMP is installed using whatever the library update process is for your distribution.
     
    E.g. for ActiveState Perl, you can run ppm (Perl Package Manager), select Net::SNMP from the repository, let it download, then "Mark it for install", and finally click "Install marked items".  From Harmut in Austria.  More information: http://www.activestate.com/blog/2010/10/how-install-cpan-modules-activeperl
     
  3. Library Time::HiRes is also required, but is probably installed by default.
     
  4. Choose where in your MRTG structure you are going to install things - everything from now on goes in there.  For example, I use E:\MRTG\mib (which probably isn't strictly correct, but which I've used historically).  I'll refer to this throughout - alter all occurrences to suit your own setup.
     
  5. Download the Perl script SR1lm.pl - V0.1.5, 2015-Oct-26, (previous version 0.1.3 here).
     
  6. Create a file SR1-lm.bat containing

        start /D E:\MRTG\mib perl SR1lm.pl 192.168.0.249 -fSR1-lm.txt    (version for Active State Perl)
        start /D E:\MRTG\mib wperl SR1lm.pl 192.168.0.249 -fSR1-lm.txt    (version for Strawberry Perl)

    The /D parameter to the "start" command needs to point to where you located the script.  The IP address should point to the management port of your SR1.

    IMPORTANT: This assumes that you have the newer SR1 software version 1.05b243 installed.  If you are using 1.05b232, then you must add -o to the end of the batch command line.  This causes the script to use multiple SNMP requests.  Not using it is preferable since it reduces the chance of modcods and their associated link margins getting out of step.
     
  7. Create a shortcut in the startup menu so that the script runs at logon.  The 'Target' is E:\MRTG\mib\SR1-lm.bat and the 'Start in' directory is E:\MRTG\mib.  Again, alter these to suit your own installed location.
     
  8. To test the script, open a command window and go to E:\MRTG\mib. Enter:

    perl SR1lm.pl 192.168.0.249

    After a few minutes, you should see it saying things like
    66
    31
    1 day, 08:05:13.82
    Ayecka SR1

    If you see errors, get back to me (Francis Breame).  You can also add -d to the command line to get debug output.  Type Ctrl-C to kill it.
     
  9. Click on the Startup menu item which you created above.  If you look at E:\MRTG\mib\SR1-lm.txt, you should see changing data.
     
  10. Then update your mrtg.cfg file. (DJT - for suggested include file see below)
     
  11. Bounce MRTG and there you are (I hope!).

Note 1: In the remarks from Francis Breame above he has used the file:  E:\MRTG\mib\SR1-lm.txt,  whereas in the example below my own file was in:  C:\Tools\MRTG2\bin\SR1-lm.txt.  Adapt to suit your own arrangement, of course.

Note 2: You may want to delay starting MRTG by 30 seconds or so after starting the  SR1lm.pl Perl script so that some correct data is available when Perl has its first check.  Simply add the command:  timeout 30  to the script running MRTG.  After the version of 2014-Sep-11 this should no longer be required.

2014-Sep-06, minor updates to the Perl script to eliminate some minor and infrequent errors.  No changes required to the MRTG configuration script.
2014-Sep-11, minor updates to the Perl script to prevent writing zero values until new values have been established at startup.

# File: sr1-dual-link-margin.inc

#---------------------------------------------------------------
#	SR-1 DVB-S2 receiver #1 dual link margin
#---------------------------------------------------------------

Target[SR1-dual-link-margin]: `type C:\Tools\MRTG2\bin\SR1-lm.txt`
MaxBytes1[SR1-dual-link-margin]: 100
MaxBytes2[SR1-dual-link-margin]: 100
Unscaled[SR1-dual-link-margin]: dwmy
YTics[SR1-dual-link-margin]: 5
YTicsFactor[SR1-dual-link-margin]: 0.1
Factor[SR1-dual-link-margin]: 0.1
Options[SR1-dual-link-margin]: gauge, nopercent, growright, unknaszero, nolegend
ShortLegend[SR1-dual-link-margin]: dB
YLegend[SR1-dual-link-margin]: Link margin: dB
LegendI[SR1-dual-link-margin]: Basic Service:
LegendO[SR1-dual-link-margin]: High Volume Service:
Title[SR1-dual-link-margin]: SR1 #1 Link Margins
PageTop[SR1-dual-link-margin]: <h1>Ayecka SR1 #1 - Link Margins (Edinburgh)</h1>

#---------------------------------------------------------------


 
 

Link Margin - with maximum values

(This is rendered obsolete by the dual margin method detailed above.  Only use the method below if you have problems getting the dual link margin working - the method below is better than nothing!).

# File sr1-link-margin.inc
#---------------------------------------------------------------
# SR-1 DVB-S2 receiver link margin
#---------------------------------------------------------------

Target[SR1-link-margin]: 1.3.6.1.4.1.27928.101.1.1.4.6&1.3.6.1.4.1.27928.101.1.1.4.6:public@192.168.10.99
MaxBytes[SR1-link-margin]: 120
YTics[SR1-link-margin]: 6
YTicsFactor[SR1-link-margin]: 0.1
WithPeak[SR1-link-margin]: wmy
Unscaled[SR1-link-margin]: dwmy
Title[SR1-link-margin]: Ayecka SR1 Link margin
Options[SR1-link-margin]: integer, gauge, nopercent, growright, unknaszero, noo
ShortLegend[SR1-link-margin]: .
YLegend[SR1-link-margin]: Link margin
LegendI[SR1-link-margin]: 10 x Link margin dB:&nbsp;
Legend1[SR1-link-margin]: Link margin x 10
PageTop[SR1-link-margin]: <H1>Ayecka SR1 - link margin (Edinburgh)</H1>

#---------------------------------------------------------------


Signal level

# File: sr1-level.inc
#---------------------------------------------------------------
#	SR1 - receiver signal level
#---------------------------------------------------------------

Target[SR1-dBm]: 1.3.6.1.4.1.27928.101.1.1.4.3.0&1.3.6.1.4.1.27928.101.1.1.4.3.0:public@192.168.10.99 * -1
MaxBytes[SR1-dBm]: 1500
Title[SR1-dBm]: Ayecka SR1 Level
Options[SR1-dBm]:  gauge, nopercent, growright, unknaszero, noo
ShortLegend[SR1-dBm]: dBm
YTicsFactor[SR1-dBm]: -0.1
Factor[SR1-dBm]: -0.1
YLegend[SR1-dBm]: Level: dBm
LegendI[SR1-dBm]: Level:
Legend1[SR1-dBm]: Level below 0 dBm. &nbsp; A lower plotted value means a bigger signal!
PageTop[SR1-dBm]: <H1>Ayecka SR1 - Signal Level (Edinburgh)</H1><br>Lower value means greater signal!

#---------------------------------------------------------------


Bit Error Rate - BER

# File: sr1-ber.inc
#---------------------------------------------------------------
# SR1 - receiver BER
#---------------------------------------------------------------

Target[SR1-ber]: 1.3.6.1.4.1.27928.101.1.1.4.5.0&1.3.6.1.4.1.27928.101.1.1.4.5.0:public@192.168.10.99
MaxBytes[SR1-ber]: 10000000
Title[SR1-ber]: Ayecka SR1 BER
Options[SR1-ber]:  noo, gauge, nopercent, growright, logscale, withzeroes, unknaszero
ShortLegend[SR1-ber]: E-7
YLegend[SR1-ber]: BER E-7
LegendI[SR1-ber]: BER:
Legend1[SR1-ber]: Demodulator Bit Error Rate - BER - 10E-7
PageTop[SR1-ber]: <H1>Ayecka SR1 - BER (Edinburgh)</H1>

#---------------------------------------------------------------

 

Input and output - Traffic and Management ports

Note: where a PageTop entry stretches over multiple lines, such as in the [SR1-Traffic] target below, each line after the first must be start with a space character, as the first line which does not start with a space will terminate the PageTop entry.

# File: sr1-traffic.inc
#---------------------------------------------------------------
# SR1 - "Traffic LAN" output
#---------------------------------------------------------------

Target[SR1-Traffic]: 1.3.6.1.2.1.2.2.1.16.1&1.3.6.1.2.1.2.2.1.16.1:public@192.168.10.99
MaxBytes[SR1-Traffic]: 150000000
Options[SR1-Traffic]: bits, unknaszero, growright, noo
Title[SR1-Traffic]: Ayecka SR1 Traffic LAN
PageTop[SR1-Traffic]: <H1>Ayecka SR1 - Traffic LAN (Edinburgh)</H1>
 <TABLE>
  <TR><TD>Interface:</TD><TD>Ayecka SR1 Traffic LAN</TD></TR>
  <TR><TD>Max Speed:</TD><TD>1 Gbit/s</TD></TR>
 </TABLE>

#---------------------------------------------------------------
# SR1 - "Management LAN" input and output
#---------------------------------------------------------------

Target[SR1-Management]: 1.3.6.1.2.1.2.2.1.10.2&1.3.6.1.2.1.2.2.1.16.2:public@192.168.10.99
MaxBytes[SR1-Management]: 15000000
Options[SR1-Management]: unknaszero, growright
Title[SR1-Management]: Ayecka SR1 Management LAN
PageTop[SR1-Management]: <H1>Ayecka SR1 - Management LAN (Edinburgh)</H1>
 <TABLE>
  <TR><TD>Interface:</TD><TD>Ayecka SR1 Management LAN</TD></TR>
  <TR><TD>Max Speed:</TD><TD>100 Mbit/s</TD></TR>
 </TABLE>

#---------------------------------------------------------------

 

Bad Frames and packets

# File: sr1-frames.inc
#---------------------------------------------------------------
# SR1 Bad Frames
#---------------------------------------------------------------

Target[SR1-bad-frames]: 1.3.6.1.4.1.27928.101.1.1.4.15.0&1.3.6.1.4.1.27928.101.1.1.4.15.0:public@192.168.10.99
RouterUptime[SR1-bad-frames]: public@192.168.10.99
MaxBytes[SR1-bad-frames]: 9000
YTics[SR1-bad-frames]: 6
YLegend[SR1-bad-frames]: Frames/hour
ShortLegend[SR1-bad-frames]: &nbsp
LegendO[SR1-bad-frames]: Frames/hour
Legend2[SR1-bad-frames]: SR1 bad frame rate
Options[SR1-bad-frames]: unknaszero, growright, logscale, nopercent, withzeroes, perhour, noi
Title[SR1-bad-frames]: SR1 Bad Frame Rate
PageTop[SR1-bad-frames]: <H1>Ayecka SR1 Bad Frame Rate</H1>

#---------------------------------------------------------------
# SR1 Bad Packets
#---------------------------------------------------------------

Target[SR1-bad-packets]: 1.3.6.1.4.1.27928.101.1.1.4.16.0&1.3.6.1.4.1.27928.101.1.1.4.16.0:public@192.168.10.99
RouterUptime[SR1-bad-packets]: public@192.168.10.99
MaxBytes[SR1-bad-packets]: 9000
YTics[SR1-bad-packets]: 6
YLegend[SR1-bad-packets]: Packets/hour
ShortLegend[SR1-bad-packets]: &nbsp
LegendO[SR1-bad-packets]: Bad packets/hour
Legend2[SR1-bad-packets]: SR1 bad packet rate
Options[SR1-bad-packets]: unknaszero, growright, logscale, nopercent, withzeroes, perhour, noi
Title[SR1-bad-packets]: SR1 Bad Packet Rate
PageTop[SR1-bad-packets]: <H1>Ayecka SR1 Bad Packet Rate</H1>

#---------------------------------------------------------------


TelliCast statistics

Here is the extra code for collecting TelliCast statistics - here for a PC named "Molde".  You could use the Include: MRTG directive to add it to an existing data collection configuration.  The program TelliCastStats.exe and the Perl script used by the two targets below may be obtained here.  Note the back quotes (` - top-left on my keyboard) round the program and its argument.
 
# File: tellicast-molde.inc

#---------------------------------------------------------------
# TelliCast losses - Molde
#---------------------------------------------------------------

Target[Tellicast-Molde-lost]: `perl TelliCastLost.pl`
MaxBytes[Tellicast-Molde-lost]: 1000000
Options[Tellicast-Molde-lost]: unknaszero, growright, logscale, nopercent, withzeroes, perhour, noi
YLegend[Tellicast-Molde-lost]: Packets / hour
ShortLegend[Tellicast-Molde-lost]: packets / hour
LegendO[Tellicast-Molde-lost]: Lost packets
Title[Tellicast-Molde-lost]: TelliCast Lost Packets - on Win-10/64 PC Molde
Legend2[Tellicast-Molde-lost]: Lost packets
PageTop[Tellicast-Molde-lost]: <H1>TelliCast Lost Packets - on Win-10/64 PC Molde</H1>

#---------------------------------------------------------------
# TelliCast statistics - Molde
#---------------------------------------------------------------

Target[Tellicast-Molde]: `TelliCastStats Molde:8100`
MaxBytes[Tellicast-Molde]: 1000000
Options[Tellicast-Molde]: unknaszero, growright, logscale, nopercent, withzeroes, perhour
YLegend[Tellicast-Molde]: Packets / hour
ShortLegend[Tellicast-Molde]: packets / hour
LegendI[Tellicast-Molde]: Recovered packets
LegendO[Tellicast-Molde]: Missed packets
Title[Tellicast-Molde]: TelliCast Statistics - on Win-10/64 PC Molde
Legend1[Tellicast-Molde]: Recovered Data Packets
Legend2[Tellicast-Molde]: Missed Data Packets before FEC
PageTop[Tellicast-Molde]: <H1>TelliCast Statistics - on Win-10/64 PC Molde</H1>

#---------------------------------------------------------------
# File TelliCastLost.pl
if ($ARGV[0] == "") {$ARGV[0] = "127.0.0.1:8100";}
$pkt_str = `TelliCastStats $ARGV[0] -all`;
$recovered = (split(/\n/,$pkt_str))[0];
$missed = (split(/\n/,$pkt_str))[1];
$lost = ($missed - $recovered);
print "$lost\n";
print "$lost\n";
print "0\n";
print "0\n";

Lost Basic Service packets

Missed and recovered Basic Service packets

If PC Molde was also running the High Volume Service, you would need a second MRTG entry with sections named, for example, [Tellicast-Molde-HVS] and [Tellicast-Molde-lost-HVS], and a second Perl script for port 8200.  Here's an example from my PC Lund, an HVS-only receiver PC.

Lost High Volume Service packets

Missed and recovered High Volume Service packets

Please note that there is a new version of the TelliCastStat.exe program which allows you to specify the port number as part of the node name.  This is provided for the new TelliCast client which by default uses port 8100 for the Basic Service, or 8200 for the high-volume service.  When upgrading to the new client, be sure to (a) download the new TelliCastStats.exe program, (b) edit your MRTG.cfg (or the include file), and (c) edit the Perl script.
 

Monitoring with the BDADataEx software

If you are using a TBS unit with the BDADataEx software it is possible to monitor some of the signal reception statistics, but this is not possible with the TBS IP Tool program.  The author of the BDADataEx software - CrazyCat - has provided a program which allows monitoring of this software, and the program is called SignalEx.exe, and can be downloaded here (more recent local copy here).  It is rather like my own software for the DVB World boxes.  The Google English translation of the page is here.  The SignalEx.exe program needs to be placed in your MRTG bin directory.  My thanks to CrazyCat for making the SignalEx and BDADataEx programs available.

My settings for the BDADataEx software are here.

My own tests are still at an early stage, and it appears that the only parameters I can currently monitor with the TBS5925 I have under test are the "strength" and "quality" percentage parameters, which are not in any sort of absolute units but may provide a useful indication of trends.  The required include files follow, for a PC named "Stamsund" or "Molde".  You will want to add one or more of these include lines to your mrtg.cfg master.

# Files for monitoring a BDADataEx installation

# These work for a TBS5925 and TBS6903
Include: stamsund-dvbdataex.inc
Include: stamsund-dvbdataex-rflevel.inc
Include: stamsund-dvbdataex-snr.inc
Include: stamsund-dvbdataex-ber.inc

Signal Strength & Quality

# File: stamsund-dvbdataex.inc

#---------------------------------------------------------------
#	DVBDataEx receiver signal level
#---------------------------------------------------------------

Target[stamsund-dvbdataex-level]: `signalex.exe level`
MaxBytes[stamsund-dvbdataex-level]: 100
Title[stamsund-dvbdataex-level]: DVBDataEx Signal Strength
Options[stamsund-dvbdataex-level]: integer, gauge, nopercent, growright, unknaszero, noo
ShortLegend[stamsund-dvbdataex-level]: %
YLegend[stamsund-dvbdataex-level]: Strength %
LegendI[stamsund-dvbdataex-level]: Strength:
Legend1[stamsund-dvbdataex-level]: Strength (percent)
PageTop[stamsund-dvbdataex-level]: <H1>DVBDataEx - Signal Strength</H1>

#---------------------------------------------------------------
#	DVBDataEx receiver signal quality
#---------------------------------------------------------------

Target[stamsund-dvbdataex-quality]: `signalex.exe quality`
MaxBytes[stamsund-dvbdataex-quality]: 100
Title[stamsund-dvbdataex-quality]: DVBDataEx Signal Quality
Options[stamsund-dvbdataex-quality]:  integer, gauge, nopercent, growright, unknaszero, noo
ShortLegend[stamsund-dvbdataex-quality]: %
YLegend[stamsund-dvbdataex-quality]: Quality %
LegendI[stamsund-dvbdataex-quality]: Quality:
Legend1[stamsund-dvbdataex-quality]: Quality (percent)
PageTop[stamsund-dvbdataex-quality]: <H1>DVBDataEx - Signal Quality</H1>


#---------------------------------------------------------------

RF Level, SNR & BER

# File: molde-dvbdataex-rflevel.inc

#---------------------------------------------------------------
# DVBDataEx receiver signal level
#---------------------------------------------------------------

Target[molde-dvbdataex-rflevel]: `signalex.exe rflevel` * -1
MaxBytes[molde-dvbdataex-rflevel]: 100
Title[molde-dvbdataex-rflevel]: DVBDataEx Signal RFLevel
Options[molde-dvbdataex-rflevel]: gauge, nopercent, growright, unknaszero, noo
ShortLegend[molde-dvbdataex-rflevel]: dBm
YTicsFactor[molde-dvbdataex-rflevel]: -1
Factor[molde-dvbdataex-rflevel]: -1
YLegend[molde-dvbdataex-rflevel]: RF level: dBm
LegendI[molde-dvbdataex-rflevel]: RF level:
Legend1[molde-dvbdataex-rflevel]: Level below 0 dBm. &nbsp; A lower plotted value means a bigger signal!
PageTop[molde-dvbdataex-rflevel]: <H1>DVBDataEx - Signal RF level</H1><br>Lower value means greater signal!

#---------------------------------------------------------------

# File: molde-dvbdataex-snr.inc

#---------------------------------------------------------------
# DVBDataEx receiver signal snr
#---------------------------------------------------------------

Target[molde-dvbdataex-snr]: `signalex.exe snr`
MaxBytes[molde-dvbdataex-snr]: 200
Title[molde-dvbdataex-snr]: DVBDataEx Signal/Noise Ratio
Options[molde-dvbdataex-snr]: gauge, nopercent, growright, unknaszero, noo
ShortLegend[molde-dvbdataex-snr]: dB
YTicsFactor[molde-dvbdataex-snr]: 0.1
Factor[molde-dvbdataex-snr]: 0.1
YLegend[molde-dvbdataex-snr]: SNR dB
LegendI[molde-dvbdataex-snr]: SNR:
Legend1[molde-dvbdataex-snr]: SNR (dB)
PageTop[molde-dvbdataex-snr]: <H1>DVBDataEx - Signal/Noise Ratio</H1>

#---------------------------------------------------------------

# File: molde-dvbdataex-ber.inc

#---------------------------------------------------------------
# DVBDataEx receiver signal ber
#---------------------------------------------------------------

Target[molde-dvbdataex-ber]: `signalex.exe ber`
MaxBytes[molde-dvbdataex-ber]: 10000000
Title[molde-dvbdataex-ber]: DVBDataEx BER
Options[molde-dvbdataex-ber]: noo, gauge, nopercent, growright, logscale, withzeroes, unknaszero
ShortLegend[molde-dvbdataex-ber]: E-7
YTicsFactor[molde-dvbdataex-ber]: 0.1
YLegend[molde-dvbdataex-ber]: BER E-7
LegendI[molde-dvbdataex-ber]: BER:
Legend1[molde-dvbdataex-ber]: Demodulator Bit Error Rate - BER * 10E-7
PageTop[molde-dvbdataex-ber]: <H1>DVBDataEx - BER</H1>

#---------------------------------------------------------------

 

Monitoring the Novra S300N

Information kindly provided by Thorsten Miglus in Germany.

I have written a script to retrieve the SNR for use with MRTG.  You can publish this on your Web Page.  With the script cmcs.exe is used available on the Novra Web Page.  Users have to set the cmcs path, ip address and password of their receiver.

Filename: snr.cmd

@echo off
cls
set cmcspath=C:\Tools\novra\cmcs
set ip=192.168.3.100
set password=Novra-S2
set tmppath=%temp%
set cmcslog=%tmppath%\cmcs.log
%cmcspath%\cmcs -ip %ip% -pw %password% -csv1status %cmcslog% >NUL 2>NUL
for /F "tokens=11 delims=," %%i in (%cmcslog%) do set snr=%%i
del %cmcslog%
set point=%snr:~1,1%
if %point% == . (set snr=%snr:~0,1%%snr:~2,1%) else (set 
snr=%snr:~0,2%%snr:~3,1%)
echo %snr%
echo 0

Then use this include file with mrtg.cfg:

#---------------------------------------------------------------
# S300N - receiver Es/No
#---------------------------------------------------------------
Target[snr]: `snr.cmd`
MaxBytes[snr]: 18 0
YTics[snr]: 6
YTicsFactor[snr]: 0.1
Factor[snr]: 0.1
Unscaled[snr]: dwmy
Title[snr]: Novra S300N Es/No
Options[snr]: gauge, nopercent, growright, unknaszero, noo
ShortLegend[snr]: dB
YLegend[snr]: Es/No: dB
LegendI[snr]: Es/No:
Legend1[snr]: Received Es/No (signal-to-noise ratio)
PageTop[snr]: <H1>Novra S300N - Es/No (Naila)</H1>


Uploading the data for publication

You will now see why I put the HTML and Images into the same separate directory - they are all the files you need to upload to your Web server!  You can alter those directories without losing any log files when you restart MRTG.  I actually use WS_FTP Pro for uploading as it allows me just to upload changed files, but the supplied Windows FTP command will work as does MoveItFreely (which is perhaps a little more reliable).  You might need to add FTP Client to Windows using the Control Panel, Add Windows Features method.  You may also need to see whether Passive or Active FTP works best for you.

http://www.ipswitchft.co.uk/moveit-managed-file-transfer/file-transfer/clients/moveit-freely

Other programs recommended on the basis of experience actually using them include:

  • John Say recommends: Daisy AutoBackup/FTP - Web page
      
  • Giuseppe Cico comments: I'm using FtpVoyager (http://www.serv-u.com/ftpvoyager.asp) from the beginning.  I found it useful for "synchronise" and other features shortly described in my article in GEO #16 - December 2007.
     
  • Arne van Belle uses Autover 2.1.1 from http://beanland.net.au/autoverHe writes: It scans a folder for changes and backups these to FTP. Switch off zipping and versioning and only transfer *.png and *.html files.

I schedule a batch file to run every 15 minutes.  Here is a sample batch file for MoveItFreely named e.g. upload-mrtg.cmd:

REM  Change directory to where the files for uploading live
PUSHD C:\Tools\mrtg\html
REM  Perform the upload
C:\Tools\MoveItFreely\FTPs -n -s:C:Tools\MoveItFreely\upload.ftp
REM  Back to our original directory
POPD
EXIT

The "-n" stops the program from asking for user-name and password every time.  The "-s:<filename>" says where the commands are to be read from.  Sample FTP commands file - C:\Tools\MoveItFreely\upload.ftp - you will need to customise this for your particular Web server.

open ftp.your-web-server.com
user <user> <pass>
cd /htdocs/mrtg/
lcd \Tools\mrtg\html
prompt

type ascii
mput *.html
type binary
mput *.png

quit

You can use the Task Scheduler to run the upload-mrtg.cmd file every 15 minutes.  I see I have also played with wput - can't recall whether it was any better or worse!

http://wput.sourceforge.net/
 

 

Back to DVB-S2 information.

 
Copyright © David Taylor, Edinburgh   Last modified: 2017 Feb 24 at 10:24