This guide will explain how to troubleshoot Chef Enabled VMs. Everything explained here is related to the VM itself, after deployment has occurred. If you want to troubleshoot Abiquo Chef integration (error messages in the GUI, enabling Chef integration in Abiquo, etc), please refer to the guide Troubleshooting Abiquo Chef Integration. Abiquo supplies official Abiquo/Opscode Chef enabled VM templates. Templates customized by the end user are not currently supported.
Chef enabled VMs have two important software pieces installed:
1. Opscode Chef Client
2. Abiquo Chef Agent
The Abiquo Chef agent is started when the VM boots and is responsible for launching the Opscode Chef Client after gathering the required information from the Abiquo platform (via Abiquo API).
There are two log files where info and error messages are reported by those two clients:
This log file stores information related to the Abiquo Chef agent run. Any problem related to the Abiquo Chef agent will be logged here.
This log file stores the Chef client log. Any problem related to the Chef client run (when downloading or applying recipes) will be logged here.
The Abiquo support staff will request these log files when required.
Chef client configuration
Everything required by the Opscode chef client to run is stored in '/etc/chef'. If the directory is empty or does not exist, the problem is usually related to the Abiquo Chef agent.
DHCP client leases file
The Abiquo Chef agent uses the DHCP client lease file to get the necessary info to communicate with the Abiquo API. These files are usually located in the following directories (depending on the Linux distribution):
Network interface information
Abiquo Chef agent errors are usually related to networking issues (Network interface did not get DHCP configuration, Abiquo API server unreachable, etc).
Abiquo Support staff will request the output of the following command (from within the VM) when required:
If the chef-client does not receive a correct network configuration, it will not be able to contact the DCHP Server and receive the leases file that contains the Chef runlist. If this happens, Abiquo recommends that you undeploy the virtual machine, fix the network configuration and then deploy the virtual machine again.
If a problem occurs when you first run the chef-client, the chef client will not be registered on the Chef Server. There will be a message like the following in the chef log file.
The validation key is deleted for security reasons after the first run, whether it is successful or not. Abiquo recommends that you undeploy the virtual machine, check the configuration, and then redeploy.