OTA Error Code: ssh_name_resolution_failed
Background
Section titled “Background”This OTA error occurs for Zips only, when the smart cart or dock that the user specified as a jumphost is not accessible via Tailscale. The main causes of this are either an incorrectly entered jumphost name or a connectivity issue.
Troubleshooting Steps
Section titled “Troubleshooting Steps”graph TD
verify-the-jumphost-hostname{"<small><b>Step 1</b></small><br/>Question: Verify the name entered for the smart..."}
fix-the-typo-and-retry["<small><b>Step 2</b></small><br/>Action: Fix the typo and retry the OTA deploy."]
attempt-tailscale-ssh["<small><b>Step 3</b></small><br/>Action: Please attempt to SSH into the dock o..."]
can-you-tailscale-ssh{"<small><b>Step 4</b></small><br/>Question: Can you Tailscale SSH into the dock o..."}
identify-asset-type{"<small><b>Step 5</b></small><br/>Question: There is a connectivity issue causing..."}
follow-dock-offline["<small><b>Step 6</b></small><br/>Action: Follow the Asset Offline Troubleshoo..."]
resolve-smart-cart-connectivity["<small><b>Step 7</b></small><br/>Action: Resolve the underlying WiFi or ethern..."]
escalate-to-ota-support{{"<small><b>Step 8</b></small><br/>Escalation: If you're a maintenance technician, e..."}}
verify-the-jumphost-hostname -->|No| fix-the-typo-and-retry
verify-the-jumphost-hostname -->|Yes| attempt-tailscale-ssh
attempt-tailscale-ssh --> can-you-tailscale-ssh
can-you-tailscale-ssh -->|No| identify-asset-type
can-you-tailscale-ssh -->|Yes| escalate-to-ota-support
identify-asset-type -->|Dock| follow-dock-offline
identify-asset-type -->|Smart Cart| resolve-smart-cart-connectivity
style verify-the-jumphost-hostname fill:#dbeafe,stroke:#3b82f6,color:#1e3a5f
style fix-the-typo-and-retry fill:#dcfce7,stroke:#22c55e,color:#14532d
style attempt-tailscale-ssh fill:#dcfce7,stroke:#22c55e,color:#14532d
style can-you-tailscale-ssh fill:#dbeafe,stroke:#3b82f6,color:#1e3a5f
style identify-asset-type fill:#dbeafe,stroke:#3b82f6,color:#1e3a5f
style follow-dock-offline fill:#dcfce7,stroke:#22c55e,color:#14532d
style resolve-smart-cart-connectivity fill:#dcfce7,stroke:#22c55e,color:#14532d
style escalate-to-ota-support fill:#fef3c7,stroke:#f59e0b,color:#78350f Hover or focus a block to preview it. Select the block to keep the preview open.
Resolution note
This plaintext block is ready to paste into the Resolution Note field on the ZERP issue you're working. The permalink below gives engineering review access to the full step-by-step timeline including any back-navigation; share it if the case needs a deeper look.
Permalink:
Session is too large to fit in a URL. Use Download session JSON to share the timeline out-of-band.
Did this guide help you get unblocked?
Open suggestions
There are no open suggestions.
Open pull requests
There are no open pull requests.