diff options
| author | Seth Foster <fosterseth@users.noreply.github.com> | 2023-04-11 16:58:11 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2023-04-11 16:58:11 +0200 |
| commit | ffa3cd1fffb88cf505e41b2a2ac7841f1a2d18b9 (patch) | |
| tree | 8d71f0a58301f984b9c8a519ec7ae30102fab302 | |
| parent | Merge pull request #13827 from john-westcott-iv/remove_future_pin (diff) | |
| download | awx-ffa3cd1fffb88cf505e41b2a2ac7841f1a2d18b9.tar.xz awx-ffa3cd1fffb88cf505e41b2a2ac7841f1a2d18b9.zip | |
Add troubleshooting to execution node docs (#13826)
| -rw-r--r-- | docs/execution_nodes.md | 25 |
1 files changed, 25 insertions, 0 deletions
diff --git a/docs/execution_nodes.md b/docs/execution_nodes.md index fae93d4127..e0c318292e 100644 --- a/docs/execution_nodes.md +++ b/docs/execution_nodes.md @@ -76,3 +76,28 @@ Wait a few minutes for the periodic AWX task to do a health check against the ne ## Removing instances You can remove an instance by clicking "Remove" in the Instances page, or by setting the instance `node_state` to "deprovisioning" via the API. + +## Troubleshooting + +### Fact cache not working + +Make sure the system timezone on the execution node matches `settings.TIME_ZONE` (default is 'UTC') on AWX. +Fact caching relies on comparing modified times of artifact files, and these modified times are not timezone-aware. Therefore, it is critical that the timezones of the execution nodes match AWX's timezone setting. + +To set the system timezone to UTC + +`ln -s /usr/share/zoneinfo/Etc/UTC /etc/localtime` + +### Permission denied errors + +Jobs may fail with the following error +``` +"msg":"exec container process `/usr/local/bin/entrypoint`: Permission denied" +``` +or similar + +For RHEL based machines, this could due to SELinux that is enabled on the system. + +You can pass these `extra_settings` container options to override SELinux protections. + +`DEFAULT_CONTAINER_RUN_OPTIONS = ['--network', 'slirp4netns:enable_ipv6=true', '--security-opt', 'label=disable']`
\ No newline at end of file |