How to enable and access Persistent Logging

How to enable and access Persistent Logging

Because logging is stored in the volatile folder, the data will be lost after a reboot or power outage.  When these logs are important to troubleshooting, Persistent Logging can be enabled to retain a copy in the event of a restart.

To enable Persistent Logging from the GUI:

  1. Log into the web interface
  2. Navigate to Auditing :: Settings
  3. Check the box for Enable Persistent Logs
  4. Optional: edit the list of Log Files: to retain
    1. Default list: dlog.log,messages,wtmp,
    2. Add additional logs as comma separated entries without spaces
  5. Click Save

To enable Persistent Logging from the CLI:

  1. Log into the CLI using SSH or console connection
  2. Navigate to the Audit related settings: cd /settings/auditing/settings/
  3. Enable Persistent Logging: set enable_persistent_logs=yes
  4. Optional: edit the list of files to retain: set persistent_log_files=dlog.log,messages,wtmp,
    1. Add additional logs as comma separated entries without spaces
  5. Save the changes: commit

To access Persistent Logs from the GUI:

  1. Log into the web interface as admin user
  2. Navigate to Access :: Table
  3. Click Console 
  4. Go to root shell: shell sudo su -
  5. Navigate to the folder: cd /var/local/LOGS
  6. Copy the file(s) to /home/admin: cp * /home/admin/
    1. Replace * with specific files if desired
  7. Return to the main GUI window
  8. Click File Manager
  9. Click home_admin
  10. Click specific files to download each

To access Persistent Logs using SCP:

You can use a graphical SCP client (i.e. WinSCP) or the basic CLI scp command.  In either case the files will be located in /var/local/LOGS.