# Configuring Usage Audit

The Open iT Usage Audit generates a periodic report showing the number of distinct users per month per module for the past 12 months.

# Activating Usage Audit

  1. Open core_audit.oconf in C:\Program Files\OpeniT\Core\Configuration\scheduler.

  2. Locate and set active value to true to activate the task for auditing distinct application users of Open iT.

    ...
     7|    core_audit
     8|    {
    ...
    16|        active
    17|        {
    18|          type=bool
    19|          value=true
    ...
  3. Save the changes.

The generated database, audit.db will be in C:\ProgramData\OpeniT\Data\database\audit.

# Verify Report Generation

  1. In the command line, go to C:\Program Files\OpeniT\Core\bin.

  2. Run the following command to generate distinct usage report:

     openit_audit.exe <args>

    Arguments for executing openit_audit:

    Name Description
    --from start date for data parsing (YYYY-MM, YYYY/MM, YYYY)
    --to end date for data parsing (YYYY-MM, YYYY/MM, YYYY)
    --debug activate debugging mode
    --verbose activate verbose logging mode. This will not work without --debug.

    Example
    openit_audit.exe --from 2020-01 --to 2020-05 --debug --verbose
  3. Verify that C:\ProgramData\OpeniT\Data\database\audit contains the following files.

    • audit.db

    • audit.sign

    • audit_trail

  1. Open core_audit.oconf in /var/opt/openit/etc/scheduler.

  2. Locate and set active value to true to activate the task for auditing distinct application users of Open iT.

    ...
     7|    core_audit
     8|    {
    ...
    16|        active
    17|        {
    18|          type=bool
    19|          value=**true**
    ...
  3. Save the changes.

# Verify Report Generation

  1. In the command line, go to /opt/openit/bin.

  2. Run the following command to generate distinct usage report:

     openit_audit <args>

    Arguments for executing openit_audit:

    Name Description
    --from start date for data parsing (YYYY-MM, YYYY/MM, YYYY)
    --to end date for data parsing (YYYY-MM, YYYY/MM, YYYY)
    --debug activate debugging mode
    --verbose activate verbose logging mode. This will not work without --debug.

Example
   openit_audit --from 2020-01 --to 2020-05 --debug --verbose
  1. Verify that /data/database/audit contains the following files. The directory may vary depending on the declared database value upon installation.
  • audit.db

  • audit.sign

  • audit_trail

# Next Steps?

After configuring Usage Audit, you may proceed with its user interface.

   Usage Audit Reporting Interface  

We value your feedback!

Please take a few minutes to complete our survey and share your thoughts on your recent experience with our documentation.

Take survey

Close