In automation scripts using NCS APIs, implement exponential backoff:
The error "NCSW10301: Unable to download the image from cisco.com : invalid metadata_trans_id" in Cisco Catalyst Center occurs when image downloads fail to retrieve the ISSU Compatibility Matrix. This issue, often due to API errors or the impact of Field Notice 74033, can be resolved by manually importing images through the Design > Image Repository menu. Read the full details at Cisco Community Cisco Community DNA CENTER IMAGE REPOSITORY ERROR NCSW10301
If your local connection cannot handle large image uploads to the controller, pull the image from an existing network device:
When reaching out to Cisco or checking forums for similar issues, providing details like the specific product model, software version you're trying to download, and any specific error messages (like "ncsw10301 unable to download the image from cisco.com invalid metadata trans-id") can help in getting accurate and helpful responses. In automation scripts using NCS APIs, implement exponential
To ensure a smooth resolution, check your current and confirm if your deployment is Air-gapped or has Direct Internet Access .
[Catalyst Center] ──(Outdated Trustpool)──> [Cisco.com API Cloud] = Validation Error [Update Trustpool Now] ───────────────────> [Cisco.com API Cloud] = Secure Connection Est. 1. Synchronize and Update the Controller Trustpool
The error indicates a mismatch or corruption in the metadata transaction ID ( trans-id ) associated with the image download request. This ID is used to validate the session and metadata integrity during the download process. Common causes include: To ensure a smooth resolution, check your current
# Check current time and NTP status timedatectl status ntpq -p
Then restart the image management service:
: Ensure your Cisco.com (CCO) credentials are correctly configured in the system settings and that the appliance has verified HTTPS reachability to Cisco's servers. KGV & Trustpool Updates : Verify that your Known Good Values (KGV) certificates are up to date under System > Settings Synchronize and Update the Controller Trustpool The error
The trans-id often incorporates timestamps. If NCS’s system clock drifts from Cisco’s servers (even by a few seconds), the server sees the trans-id as expired or future-dated.
While the main software image ( .bin or .tar ) might download successfully, the associated ( comp_matrix.xml )—which ensures the image is valid for the target device—fails to download or validate, resulting in this error. Root Causes of the Error
: You cannot stage newer target operating systems across your switches, routers, or wireless controllers using cloud automation.