When the ZTP process isn’t behaving as expected, there are some basics that should be checked regularly.
ZTP Server is continually being enhanced and improved and its entirely possible that the issue you’ve encountered has already been addressed, either in the documentation such as Tips and tricks, or in the code, itself. Therefore, we strongly encourage anyone experiencing difficulty to reproduce the issue on the latest release version before opening an issue or requesting support. See Upgrading.
Check whether ZTP has been disabled on the switch:
Many errors are simply due to typos or other syntax issues in config files. It is good practice to use the –validate option to ztps and to paste configs in to http://yamllint.com/ to ensure they are well-formed YAML:
[user@ztpserver]$ ztps -–validate-config
Before requesting support, it is important to perform the following steps to collect sufficient data to reduce information requests and enable timely resolution.
If not already recorded in the logs, please execute ztps --version and specify whether your installation was from source (github), pip, RPM, or a packer-ztpserver canned VM.
The location of server-side logs may vary depending on your specific environment.
- If running ZTP Server via Apache, check the VirtualHost definition for CustomLog and ErrorLog entries, otherwise, look in the default Apache logs. On Fedora, those will be in /var/log/httpd/
- If running the standalone ztps binary, a good choice for debugging, please include the --debug option. Using ztps --debug 2>&1 | tee ztpserver.log will log the output to both the screen and a file.
Ensure the bootstrap client is configured to log to syslog or XMPP via /usr/share/ztpserver/bootstrap/bootstrap.conf and include that output. Attempting to collect client side logs from the console frequently results in missing information due to scroll buffers or line length.