Troubleshoot Ansible Playbooks for Confluent Platform¶
Complete the following steps if Ansible Playbooks for Confluent Platform fails:
Review the error log output from Ansible itself.
It will show the type of failure which has occurred and might indicate a misconfiguration in your inventory file. For example, if you set a file path variable to an invalid path, the logs will say “Could not find or access “ the file path, and you need to correct the variable and rerun the install.
Review your inventory file.
Validate that all variables are set correctly, with proper spacing in the inventory file. You can review
hosts_example.yml
and thesample_inventories
directory for examples.Review component log and property files.
If a component health check fails, the playbook will fetch log and property files back to the Ansible Control Node inside the
error_files/
directory at the root ofcp-ansible
. These error logs can indicate which properties are misconfigured.If the log files do not provide a clear reason for the failure, use one of the following methods to generate more info:
Rerun the playbook with the
--diff
option and redirect the output to a file. For more information about the flag, see ansible-playbook — Ansible Documentation.This outputs the differences in the playbook files and templates. With this option, sensitive information, such as passwords, certificates, and keys, are not printed in the output.
Rerun the playbook again with the
-vvv
option to enable debug logging and redirect the output to a file:ansible-playbook -vvv -i hosts.yml all.yml > failure.txt
When debug is enabled, the information in the output cannot be suppressed, including sensitive information, such as passwords, certificates, and keys. It is not recommended to use the debug mode in production environments. For details, see Logging Ansible output — Ansible Documentation.
Open a support ticket with Confluent Support and provide the following within a compressed archive file:
Your inventory file
The log files generated from the
-vvv
or--diff
option.The
error_logs/
directory and its contentsThe output of the following GIT commands as a text file. Run the command from the root of
cp-ansible
to show any changes made to thecp-ansible
source code:git status
git diff