Home > Networking Solutions > Enterprise/Data Center Networking Solutions > Enterprise SONiC Networking Solutions > Guides > Zero Touch Deployment of Open Dell Switches with SONiC > Problem solving and troubleshooting
Dell highly recommends having a serial console connection available on the switch. This will ensure the best possible monitoring capabilities during all ZTP stages. The following information explains how to connect the console to the RS232 port and how to connect to the microUSB port.
Problem | Possible causes | Possible solutions |
No space left on switch | Too many operating systems installed. | Remove specific NOS or all NOSes with ONIE Uninstall OS |
ONIE keeps on starting its discovery loop and execution loop | Discovery image could not be requested from webserver. | Check if discovery name is on webserver is correct Check if discovery name is reachable in webserver root Check if webserver is up Check if you can fetch image in a web browser |
Firmware image timeout | Management VRF is configured in your initial configdb json file, which prevents the curl process on SONiC from reaching the webserver. Curl does not follow IP routing in the management VRF and thus has no IP routing available in the global table. | Disable management vrf global; "MGMT_VRF_CONFIG": { "vrf_global": { "mgmtVrfEnabled": "false" } }, |
Firmware download aborts unexpected | No space left on switch. | Remove specific NOS or all NOSes with ‘ONIE Uninstall OS’ |
Failure on requesting ztp json file, firmware, configdb or provisioning script | Availability or reachability of files on webserver. | Check logging of webserver requests Check file rights on webserver Are files available on webserver Start webserver if not started |
Errors on processing ztp json file, configdb json or provisioning script | Wrong json syntax or unknown key/values. | Check correctness of files. Use a json lint checker for valid json Use github SONiC ztp repo for key/value options (see Chapter Error! Reference source not found.) |
Switch gets wrong IP address | MAC-address specified in dhcpd.conf on DHCP server configured in wrong IP subnet. | Configure correct mgmt eth mac-address on DHCP server config |
Switch gets no IP address | DHCP server is down or an incorrect mac-address is specified in dhcpd.conf on DHCP server. | Configure correct mgmt eth mac-address on DHCP server config Start DHCP server if not started |
DHCP server will not start | Subnet declaration is incorrectly configured. | Check DHCP server log during start |
Switch cannot reach webserver IP | Wrong IP address in ZTP URL provided in dhcpd.conf on DHCP server or no option routers are configured. | Check ZTP URL IP address Check option routers IP address in dhcpd.conf |
ZTP unsuccessfully finished | Errors in processing scripts. | Check command ‘ztp status’ output which ztp json plugin failed and check syntax correctness. Use github SONiC ztp repo for key/value options and syntax (See chapter Error! Reference source not found. for the reference link) |
Multiple failures on ZTP json file processing | Syntax error. | Start with one plugin and if successful, add one by one. We recommend starting with the configdb-json plugin. |