The Traffic Analyzer (TRFA) port accumulates and shows a traffic for one or more IP interfaces. It provides the following features:
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.
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:
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.
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\").
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").
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.