Enfacct

The Enfacct program extracts the accounting data from log files. The program scans the main EnFuzion log file, run log files and the enfinfo directories and stores the accounting data to the enfinfo/acct directory. The accounting data is generated every hour. The Enfacct is executed automatically by the Dispatcher within first 5 minutes of every hour.

The Enfacct program has the following options:

    enfacct \
        [ -verbose [ <file> ] ]  \
        [ -dir <directory> ] \
        [ -strict ] \
        [ -complete ] \
        [ -aggregate [ YYYY-MM-DD ] ]

The -verbose [ <file> ] option turns on verbose output. The option is useful for troubleshooting. If <file> is specified, the output is saved in the file. Otherwise, it is sent to the standard output.

-dir <directory> specifies the main Dispatcher directory. The option can be used when enfacct is started in a directory that is different from the main Dispatcher directory.

With the -strict option, Enfacct terminates if a parsing error is encountered. A parsing error might happen if the log files are modified by the user by mistake. The option is useful for troubleshooting.

With the -complete option, Enfacct does a complete parsing of log files. Any partial results are discarded. During normal operation, Enfacct performs incremental parsing of log files. The log parsing continues where the previous instance of Enfacct stopped.

With the -aggregate [ YYYY-MM-DD ] option, Enfacct does not extract new accounting data from logs, but it aggregates existing accounting data. Daily summaries are produced from hourly summaries and monthly summaries are produced from daily summaries.

Enfacct automatically deletes any hourly files that are more than 2 days old and any daily files that are more than 2 months old.

The accounting data is stored in the enfinfo/acct subdirectory in the working Dispatcher directory. There are two files for each time period. runs-* files contain accounting information about runs and nodes-* files contain accounting information about nodes.

Files for each completed hour of the current and previous day are kept in:

    <year>-<month>-<day>/runs-<year>-<month>-<day>-<hour>
    <year>-<month>-<day>/nodes-<year>-<month>-<day>-<hour>

Files for each completed day of the current and previous month are kept in:

    <year>-<month>/runs-<year>-<month>-<day>
    <year>-<month>/nodes-<year>-<month>-<day>

Files for each completed month are kept in:

    <year>/runs-<year>-<month>
    <year>/nodes-<year>-<month>