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
sample_inventoriesdirectory 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 of
cp-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
--diffoption and redirect the output to a file. For more information about the flag, see Ansible Playbook Options.
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
-vvvoption to enable debug logging and redirect the output to a file:
When using Ansible 2.11 or higher:
ansible-playbook -vvv -i hosts.yml confluent.platform.all > failure.txt
When using Ansible 2.10 or 2.0:
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.
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
error_logs/directory and its contents
The output of the following GIT commands as a text file. Run the command from the root of
cp-ansibleto show any changes made to the