Error "Preparing Today's log failed cause by Log file size in worker node(s) too large"
Jan 20, 2026
Access Gateway
Okta Classic Engine
Okta Identity Engine
Overview
When trying to download today's log from the Okta Access Gateway (OAG) Admin UI console, an error occurs, saying the log file size in the worker node(s) is too large.
Preparing Today's log failed
Log file size in worker node(s) too large, failed to download logs from worker(s)
Add a log forwarder or select a different date.
Applies To
- Okta Access Gateway (OAG)
Cause
Okta Access Gateway (OAG) appliance by default restricts the download logfile size to 2GB. The setting is defined in
/opt/oag/bin/logPrepareConfig.sh on each node. The mentioned error can happen in two cases: - The generated log archive on the worker node exceeds 2GB.
- The combined log archive (admin + all workers) on the admin node exceeded 2GB.
The archive for a specific date on an appliance will have all the logs from every directory under /opt/oag/logs/ . A rough estimation can be done by checking the directory size using :
du -sh /opt/oag/logs/*NOTE:
- It is recommended to use log forwarders and keep minimal logging on the cluster. For more information, refer to Manage log verbosity.
- The workaround mentioned below should only be used as a temporary solution, and the changes must be reverted once the log download is successful.
Solution
- Login to appliance shell.
- Open the config file in an editor:
sudo vi /opt/oag/bin/logPrepareConfig.sh - Increase the value of MAX_ALLOWED_LOG_SIZE based on the estimation.
- Run the steps above on all the remaining nodes in the cluster.
- Execute log download again from Admin UI.
- Revert the changes on all the nodes once the download is completed.
- Check and update log verbosity to avoid excessive logging if needed.
