Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Functional overview and debugging information sources

What to include when reporting an issue

...

  • the Detailed View of the all the related Application Log Entries which include success and failure messages

  • if possible, a database dump would be very useful.

The configuration building process failed

...

  • AtheosGateway Controller Logs. Their location and an example are given below.

  • AtheosGateway Controller command Control files. Their location and an example are given below.

...

  • Any messages exchanged between the POI and AtheosGateway. Their location and an example are given below.

  • The Atheos Gateway logs. Their location and an example are given below.

...

The application log can be access using the Atheos UI under System Admin. >> Application Logs. The detailed view of an Application Log Entry related to a Security Violation looks like:

...

AtheosGateway Controller Logs

This log is located generally on each AtheosGateway instances in the directory /var/log/amadis. Its file name is AtheosGWController.log. The content of this log among other things will contains lines like

Code Block
2020-03-30 18.05.02 I Processing file 20200330-180408-b512706d-8e2f-4487-89b5-8b3bdb6d2950
2020-03-30 18.05.02 I Deploying CARNET11
2020-03-30 18.06.01 I Processing file 20200330-180408-b512706d-8e2f-4487-89b5-8b3bdb6d2950
2020-03-30 18.06.01 I Deploying CARNET11
2020-03-31 14.12.01 I Processing file 20200331-141110-3db95d3d-a886-4995-b222-7e90fcc98fa0
2020-03-31 14.12.01 I Deploying CARNET11
2020-03-31 14.12.01 I Processing file 20200331-141135-037a8b67-378f-4672-aa41-cda294667530
2020-03-31 14.12.01 I Deploying CARNET11
2020-03-31 18.43.01 I Processing file 20200331-184231-ffaf8164-8381-453c-953b-5306f5ca947b
2020-03-31 18.43.01 I Deploying CARNET11
AtheosGateway Controller command files

AtheosGateway Control Files

The processed command files are listed in the AtheosGateway Controller Logs. The processed files are stored in the directory /home/amadis/control/attic or may still be in the /home/amadis/control directoryif the issue prevented from moving it into the attic sub-directory.

Find the files related to the POI having an issue and include them to the incident report.

This file is a JSON file without any formatting. A typical file starts with:

Code Block
{"version":1,"actions":[{"action":"DeployPOI","payload":{"version":"2021-03-10 18:04:22","profileData":{"version":"2021-03-10 18:04:22","profileId":"3","templateE0":"df140004434f5252\ndf15000356414c\ndf16000156\
n","templateE1":"9f4000056000f0a001\ndf1200026672\ndf670004fc020000\ndf17000101\ndf18000101\ndf40002aa000000003008ca000000003008da0000000030096a0000000040002a0000000420002a0000000420003\ndf490015a000000003008ca0
000000040002a0000000420002\n9f330003e0b8c8\n9f1a00020250\ndf34

Messages exchanged between the POI and AtheosGateway

The Atheos Gateway logs