The Traffic Analyzer Port (TRFA)

Revised for CPX 4.7.0.
Configuration of the Traffic Analyzer Port (TRFA)
Statistics of the Traffic Analyzer Port (TRFA)

Http pages for IP traffic analisys (TRFA)

Http pages for IP traffic analisys (TRFA)


The Traffic Analyzer (TRFA) port accumulates and shows a traffic for one or more IP interfaces. It provides the following features:

Configuration of the Traffic Analyzer Port (TRFA) top

The Traffic Analyzer ports is identified by the mnemonic "TRFA" and it is provided with the parameters described in this section.

Here are examples on how to display the TRFA port parameters. Displayed values are the default ones:

[11:47:16] ABILIS_CPX: D P PO:TRFA

PO:916 - Not Saved (SAVE CONF), Not Refreshed (INIT) --------------------------
TRFA   ------------------------------------------------------------------------
       LOG:DS        ACT:NO        max-addresses:100    max-png:5      BAK:YES    
       WDIR:C:\APP\TRFA\                   

To activate changes made on the parameters displayed by low case characters, it is needed to restart the system; on the contrary for activating changes made on upper case parameters it is enough to execute the initialization command INIT PO:.
Changes made on LOG: parameter are immediately active.

The "Not Saved (SAVE CONF)" message is displayed every time the port configuration is modified but not saved with the SAVE CONF command.

The "Not Refreshed (INIT)" message is displayed every time the port configuration is modified but not refreshed with the INIT PO: command.

Detail of the TRFA port parameters


LOG: Events logging activation and generation of alarm signals
DS NO, D, S, A, L, T, ALL, +E

Usually this parameter makes possible to activate/deactivate logging functionalities of meaningful events of the port as well as the detection and signalling of alarms in case of critical events.

The following table shows the available options and the related functionalities usable by the parameter:

Option Meaning
D Recording of the driver state changes and/or the meaningful events in Debug Log
S Recording of the driver state changes and/or the meaningful events in the System Log
A Periodic detection of possible alarms. The detected alarms can be displayed the command ALARM VIEW or by the analogous command available on the UTILITY of the LCD display on the front panel
L On alarm detection, acoustic signal generation plus a message on the LCD display. This function depends on activation of alarms detection by the "A" option
T Generation by the Agent SNMP of Abilis CPX of SNMP traps corresponding to any change of the driver state and/or occurring of meaningful events

Beside the already described options the following values are also allowed:

Option Meaning
NO It means that all the logging functionalities, alarms detection and generation, above mentioned, are disabled.
ALL It means that all the logging functionalities, alarms detection and generation, above mentioned, are enabled.
+E This option added to one or more of the previous ones, extends its (their) set of meaningful events.
The value "ALL+E" activates all the options and extends the set of meaningful events.
The value "NO+E" is meaningless so it is ignored.

Options can be combined together.

Some examples:

By using the characters "+" and "-" as prefix of one or more options is possible to add or delete one or more functionalities without setting from the scratch the value of the parameters.

Some examples:

warning! The changes made on this parameter are immediately activated, without the need of initialization commands.


ACT: Runtime activation/deactivation of TRFA
NO NO, YES

This parameter allows to run-time activate/deactive TRFA functionalities.

When it is set to "NO", the port is running but saving traffic information is disabled.

When it is set to "YES", the port is running and the TRFA driver performs its activities, i.e. saving traffic information is enabled.


max-addresses: Maximum number of pair IPP + IP address in the address table
1000 2..65535

This parameter defines the maximum number of pair "IP port,IP address" in the TRFA address table.

The actual size of the internal database, as well as other relevant parameters, must are calculated by the driver using the present parameter, the TRFA-MODE: parameter and the IP-RESERVE: parameter.


max-png: Maximum number of PNG shell objects
5 1..20

This parameter defines the maximum number of PNG shell objects. This objects will be used creating PNG files for TRFA's HTML information page.

warning! If you have a lot of interfaces with active TRFA and TRFA's HTML information page is created too slowly, then increase this value. Each PNG shell object gets about 400K memory.


BAK: Back-up file creation enable/disable
YES NO, YES

This parameter activates the creation of a back-up copy of data files.

When it is set to "YES", the before replacing a ".DAT" file the TRFA driver makes a backup copy in a file with ".BAK" extension.

When it is set to "NO", the ".DAT" file is not backed-up.


WDIR: Directory where traffic data files are stored.
C:\APP\TRFA\ from 1 up to 128 ASCII extended characters [32..255]

This parameter defines the location of the directory where traffic data files are stored. It cannot be empty. It must be a physical full path in DOS notation, i.e. starting with a drive letter in the range ['A'..'Z'] and ending with the backslash ('\'). The maximum accepted working directory string length is 128 characters. Case is preserved and spaces are allowed, but strings holding spaces must be written between quotation marks (E.g.: "C:\My dir\").

Statistics of the Traffic Analyzer Port (TRFA) top

Example on how to show state and statistics of the TRFA port through the command D S:

[11:10:58] ABILIS_CPX: D S PO:TRFA

PO:916 ------------------------------------------------------------------------
TRFA   STATE:ACTIVE    ACTIVE-STATE:NORMAL    BACKUP-STATE:NORMAL    EVENT: 82   
       ------------------------------------------------------------------------
       ---ARRAY---|---PERC----|----CUR----|---PEAK----|----MAX----|----OVR----|
       ACTIVE     |          0|          0|          0|        100|          0|
       BACKUP     |          0|          0|          0|        100|          0|
       ------------------------------------------------------------------------
       - Send/Receive statistics ----------------------------------------------
       -----------|---TOTAL---|---SUCC----|---FAIL----|---INACT---|-OVERFLOW--|
       REQUESTS   |         64|         64|          0|          0|          0|
       ------------------------------------------------------------------------

Example on how to show extended statistics of the TRFA port through the command D SE:

[11:11:13] ABILIS_CPX: D SE PO:TRFA

PO:916 ------------------------------------------------------------------------
TRFA   --- Cleared 000:00:00:45 ago, on 25/03/2004 at 17:38:12 ----------------
       -----------|---TOTAL---|---SUCC----|---FAIL----|---INACT---|-OVERFLOW--|
       REQUESTS   |        129|        129|          0|          0|          0|
       ------------------------------------------------------------------------

The information "Cleared DDD:HH:MM:SS ago, at DD/MM/YYYY HH:MM:SS", referred by the extended statistics, shows the elapsed time from the last reset of the statistics (by the format "days:hours:minutes:seconds") and date/time of its execution (by the format "day/month/year" and "hours:minutes:seconds").

Details of the state fields and statistics of the TRFA port (TRFA)

STATE:ACTIVE NORMAL NORMAL EVENT:247
STATE: Current state of the TRFA port
INACTIVE, DOWN, ACTIVE, ERR

It shows the current state of the TRFA port driver.

Driver States Description Values shown in:
System Log Events Log Display LCD
TRFA INACTIVE The parameter ACT: is set to "NO".     in
DOWN The parameter ACT: is set to "YES", but TRFA service does not work correctly.     dn
ACTIVE The parameter ACT: is set to "YES".     RD
ERR Software error. Contact Abilis CPX assistance.     NA


ACTIVE-STATE: Current status of the active address array
NORMAL, WARNING, DANGER, OVERFLOW, ERR

It shows the current status of the active address array.

States Description
NORMAL Active address array is loaded less than 60%.
WARNING Active address array is loaded less than 75% but more than 60%.
DANGER Active address array is loaded less than 100% but more than 75%.
OVERFLOW Active address array is loaded on 100%.
ERR Software error. Contact Abilis CPX assistance.


BACKUP-STATE: Current status of the active traffic array
NORMAL, WARNING, DANGER, OVERFLOW, ERR

It shows the current status of the active traffic array.

States Description
NORMAL Active traffic array is loaded less than 60%.
WARNING Active traffic array is loaded less than 75% but more than 60%.
DANGER Active traffic array is loaded less than 100% but more than 75%.
OVERFLOW Active traffic array is loaded on 100%.
ERR Software error. Contact Abilis CPX assistance.


EVENT: Number of seconds to reach next event
0 - 4.294.967.295

It shows the number of seconds to reach next event.


ARRAY Address/Traffic array
ACTIVE, BACKUP

Identify the array to which the information are pertinent.


PERC Percentage of use the active address/backup array
0 - 100

It shows the percentage of use the active address/backup array.


CUR Currently record saved in the active address/backup array
0 - 4.294.967.295

It shows the currently record saved in the active address/backup array.


PEAK Maximum number of simultaneously record in the active address/backup array
0 - 4.294.967.295

It shows the maximum number of simultaneously record in the active address/backup array.


MAX Actual size of the active address/backup array
0 - 4.294.967.295

It shows the actual size of the active address/backup array.


OVR Number of requests that were discarded because active address/backup array is overflow
0 - 4.294.967.295

It shows the number of requests that were discarded because active address/backup array is overflow.


TOTAL Total number of requests
0 - 4.294.967.295

It shows the total number of received requests.


SUCC Number of requests that were successfully executed
0 - 4.294.967.295

It shows the number of requests for which the traffic tracing was successfully executed.


FAIL Number of requests that were not satisfied
0 - 4.294.967.295

It shows the number of requests tfor which the traffic tracing was unsuccessful.


INACT Number of requests for which the traffic tracing was not activated
0 - 4.294.967.295

It shows the number of requests for which the traffic tracing was not activated.


OVERFLOW Number of failures due to an address overflow
0 - 4.294.967.295

It shows the number of failures due to an address overflow.

printPrint this page