| 1 | [[PageOutline(2-4)]] |
| 2 | == Accounting Application == |
| 3 | |
| 4 | This {{{app_acct.fdx}}} extension aims to provide a very simple and configurable implementation of the Diameter Base Accounting application defined in RFC3588. |
| 5 | |
| 6 | It must be seen as an '''intermediary''' component: the Diameter messages are parsed, and the accounting records are stored in a database, but no further treatment is performed. The intent is that an independent application (with no knowledge of Diameter required) will then process these records, reconstruct the session information, and store it in a format suitable for a billing application for example. |
| 7 | |
| 8 | Currently, the extension stores the information in a PostgreSQL database, where a third-party application can retrieve it. |
| 9 | |
| 10 | {{{ |
| 11 | #!graphviz |
| 12 | digraph G { |
| 13 | graph [bgcolor="#E8E8E8C8"] |
| 14 | diam [ |
| 15 | shape=egg |
| 16 | label="Diameter Accounting" |
| 17 | ] |
| 18 | db [ |
| 19 | shape=box3d |
| 20 | label="PostgreSQL intermediary database" |
| 21 | ] |
| 22 | appl [ |
| 23 | shape=note |
| 24 | label="Application" |
| 25 | color=grey |
| 26 | ] |
| 27 | diam -> db [ |
| 28 | label="app_acct.fdx" |
| 29 | color=blue |
| 30 | ] |
| 31 | db -> appl [ |
| 32 | label="(outside)" |
| 33 | color=grey |
| 34 | ] |
| 35 | } |
| 36 | }}} |
| 37 | |
| 38 | {{{app_acct.fdx}}} allows easy configuration of what information is stored in the database. See the section bellow for detail. |
| 39 | |
| 40 | === Configuration === |
| 41 | |
| 42 | {{{app_acct.fdx}}} configuration file is mandatory. The complete configuration documentation can be found in the source package: [source:freeDiameter/doc/app_acct.conf.sample app_acct.conf.sample]. |
| 43 | |
| 44 | The configuration is split in two parts. The first part is dedicated to mapping the information from Diameter AVP into database fields. The second part contains the access information to the database, and a few global options for the extension. |
| 45 | |
| 46 | === Usage === |
| 47 | |
| 48 | Since the application is not resistant to database access problems, it is highly recommended (although not mandatory) that the database is located on the same host as the {{{app_acct.fdx}}} application. |
| 49 | |
| 50 | === Output === |
| 51 | |
| 52 | This application does not produce any particular output, except for entries in the database. |
| 53 | |
| 54 | === Troubleshooting === |
| 55 | |