Skip to main content

FileWave Log File Locations

The following lists the locations of log files, as well as some additional files used by FileWave across the FileWave family of products

FileWave Admin

FileWave Admin Logs

Details File Location FileWave Admin Log

Logs all FileWave Admin Connection Activity FileWaveAdmin.log, FileWaveAdmin.log.* macOS

~/Library/Application Support/FileWave/FileWaveAdmin.log

Windows

C:\ProgramData\FileWave\FileWaveAdmin.log Client Logs

Retrieved Client Logs ClientLog_$IP_$Port_$date.log macOS

~/Library/Application Support/FileWave/Client Logs/

Windows

C:\ProgramData\FileWave\Client Logs\ Server Logs

Retrieved Server Logs

FileWave Admin > Server > Get Logfile fwxserver_$timestamp.log macOS

~/Library/Application Support/FileWave/Server Logs/

Windows

C:\ProgramData\FileWave\Server Logs\

FileWave Admin Files

Details File Location FileWave Admin Settings

Settings for the local FileWave Admin App macOS

* com.filewave.FileWave Admin.plist

* com.filewave.admin.plist


Windows

* Registry macOS

~/Library/Preferences/

Windows

HKCU\Software\FileWave\FileWave Admin Exported Views

Views saved from FileWave Admin:

* Views > Export Current View Filesets Export ($date).txt macOS

~/Library/Application Support/FileWave/Exports

Windows

C:\ProgramData\FileWave\Exports

FileWave Booster

Booster Logs

Details File Location Booster Log

Global Booster activity fwbooster.log macOS/Linux

/private/var/log/fwbooster.log

Windows

C:\ProgramData\FileWave\FWBooster\fwbooster.log NATS

NATS Booster Logs macOS/Linux

* nats-booster.err.log

* nats-booster.out.log


Windows

* nats-booster.log macOS/Linux

/private/var/log/

Windows

C:\ProgramData\FileWave\FWBooster\NATS\nats-booster.log Discovery Log

Only exists when discovery configured and run macOS/Linux

* fwdiscovery.log macOS/Linux

/private/var/log/fwdiscovery.log

FileWave Client

FileWave Client Logs

Details File Location Client Logs

Global Client activity fwcld.log macOS

/var/log/fwcld.log

Windows

C:\ProgramData\FileWave\FWClient\fwcld.log Kiosk Logs

Kiosk application activity fwgui.log macOS

~/Application\ Support/FileWave/fwGUI.log

Windows

C:\ProgramData\FileWave\FWGUI.log Fileset Script Logs

Logs generated by Fileset scripts macOS

$Fileset_ID/$script_name_from_fileset.log

Windows

$Fileset_ID\$script_name_from_fileset.log macOS

/var/log/fwcld/

Windows

C:\ProgramData\FileWave\log\fwcld\ Custom Field Logs

Logs generated by Custom Fields custom_field_script.$script_type.log

e.g.

* custom_field_script.ps1.log

* custom_field_script.sh.log macOS

/var/log/fwcld/1/

Windows

C:\ProgramData\FileWave\log\fwcld\1\ Fileset Blocker Script Logs

Logs generated by Blocker Scripts blocker_script.$script_type.log

e.g.

* blocker_script.py.log

* blocker_script.bat.log macOS

/var/log/fwcld/1/

Windows

C:\ProgramData\FileWave\log\fwcld\1\ Installer (PKG / MSI) Logs

Logs generated from PKG/MSI Filesets $Fileset_ID.log macOS

/usr/local/etc/FileWaveInstallerLogfiles/

Windows

C:\ProgramData\FileWave\FileWaveInstallerLogfiles\

FileWave Client Files

Details File Location FileWave Client Settings

Settings for the FileWave Client macOS

fwcld.plist

Windows

* Registry macOS

/usr/local/etc/

Windows

HKLM\SOFTWARE\Wow6432Node\Filewave\WinClient FileWave Client Preferences

Preference file containing unique client details macOS

com.filewave.Client.plist

Windows

* client.ini macOS

/Library/Preferences/

Windows

C:\ProgramData\FileWave\ FileWave Client Certificate

Unique certificate & key per client * client.crt

* client.key macOS

/var/FileWave/

Windows

C:\ProgramData\FileWave\FWClient\ Trust Store

Store for self-signed certificates *.crt macOS

/private/var/FileWave/trust_store

Windows

C:\ProgramData\FileWave\FWClient\trust_store

Cells highlighted in yellow indicate files that are unique per client. These files should not be included when copying or migrating clients from one machine to another. To de-personalise a device, without removing the FileWave Client, some files would require editing, whilst others would need to be removed. If it was felt this was a requirement, consider contacting support to assist with this process.

FileWave Imaging Server (IVS)

IVS Logs

Details File Location Django Imaging Server Logs

Django logs for requests regarding Serial numbers, names etc. made by netbooted clients filewave_imaging_server*.log /imaging/logs/ Windows Image Upload Logs

Captured Windows image uploads fwadmin.log /imaging/logs/fwadmin.log Windows Image Upload Logs

Captured Windows image uploads fwadmin-dlog.log /var/log/fwadmin-dlog.log Messages Logs

Netboot/PXE Queries & Responses,TFTP transfers, NFS Mounts dnsmasq Log <var/log/messages Apache Imaging Server Logs

Apache logs for requests regarding Serial numbers, names etc. made by netbooted clients netboot_*.log /imaging/logs/ Client Imaging Logs

Client logs - indicating progress of imaging operation of netbooted clients $Serial/$Mac-$Date /imaging/logs/ FileWave Client Log

IVS FileWave Client Log fwcld.log /var/log/fwcld.log

FileWave Server

FileWave Server Logs

Details File Location Apache Logs

Server Apache logs * access_log, access_log.*

* error_log, error_log.*

* forensic_log

* httpd.pid /usr/local/filewave/apache/logs/ Apache Exporter Logs

Server Apache Exporter Logs * apache_exporter.out.log

* apache_exporter.err.log /usr/local/filewave/log/ Alert Manager Logs

Server Alert Manager logs * alertmanager.out.log

* alertmanager.err.log /usr/local/filewave/log/ FileWave Admin Audit Logs

Audit logs from FileWave Admin audit.log /usr/local/filewave/log/audit.log

FileWave Dotenv file

 

Environment variable like configs across services.

*.env /usr/local/etc/filewave/.env Django Logs

Server Django logs * filewave_django.log, filewave_django.log.*

* filewave_django_vpp.log

* filewave_django_classroom.log /usr/local/filewave/log/ LDAP Logs

Logs from LDAP fwldap.log, fwldap.log.* /private/var/log/ Software Update Logs

Software Update logs fwsu.log /private/var/log/fwsu.log FWX Process Logs

Various fwx process logs * fwxadmin.log

* fwxother.log

* fwxserver.log /private/var/log/ Migration Logs

Server migration logs fwxserver-migration-* /var/log/fwxserver-migration-* Grafana Logs * grafana.log

* grafana.out.log /usr/local/filewave/log/ Installer Logs

Linux installer logs install.log /private/var/log/install.log mtail Logs

Server mtail logs * mtail.out.log

* mtail.err.log /usr/local/filewave/log/ NATS Logs

NATS logs * nats-server.out.log

* nats-server.err.log

* nats-server-jwt.out.log

* nats-server-jwt.err.log /usr/local/filewave/log/ Web Admin Logs * node_exporter.out.log

* node_exporter.err.log

* task_executor.log /usr/local/filewave/log/ Postgres Exporter Logs * postgres_exporter.out.log

* postgres_exporter.err.log /usr/local/filewave/log/ Postgres Database Logs postgresql-$day.log /usr/local/filewave/fwxserver/DB/pg_data/pg_log/*.log Prometheus Logs * prometheus_pushprox.out.log

* prometheus_pushprox.err.log

* prometheus.out.log

* prometheus.err.log

* redis_exporter.out.log

* redis_exporter.err.log

* redis.out.log

* redis.err.log

* redis.log /usr/local/filewave/log/ FileWave Server Logs request_errors.log /usr/local/filewave/log/ SQL Logs sql.log /usr/local/filewave/log/ Update Controller Logs

Removed in FileWave 14.10 * update_controller_access.log

* update_controller.log /usr/local/filewave/log/ Client Monitor client-monitor.log /usr/local/filewave/log/ FileWave Log Messages task_executor.log /usr/local/filewave/log/ Scheduler Log Messages huey.log /usr/local/filewave/log/

Additional Logging

All of the above will default to standard log level. There are 3 levels of logging available:

    10 – Standard Log Level

    99 – Debug Log Level

    101 – Trace Log Level

    The level of logging may be set as per our guide:

    How to set FileWave Server components to debug mode