Your Shopping Cart Is Empty!
If you already have an account, Sign in.
If you already have an account, Sign in.
Categories
This has been observed in NSO versions 5.x and 6.x, particularly when integrating with Cisco Software Download (CCO) via REST API or package manager workflows.
Confirm if the file matches the current timeline.
ncs set-log-level com.cisco.ncs.imagemanagement DEBUG ncs tail -f /var/log/ncs/imagedownload.log
is a known issue typically encountered in Cisco Catalyst Center (formerly DNA Center) during Software Image Management (SWIM) operations. While the main software image may download successfully, the associated ISSU Compatibility Matrix (comp_matrix.xml) fails due to this metadata error. Review of Error NCSW10301
The error occurs when the Cisco Catalyst Center Image Repository downloads a software image alongside its companion . This has been observed in NSO versions 5
From the Catalyst Center UI, navigate to . Select Import Image and opt for Via Source URL .
: Sporadic issues with external provider APIs used for the download feature. Failed Metadata Download
The system cross-checks all cloud payloads against a database of Known Good Values (KGV). If this database is outdated, metadata transactions fail: Go to > Settings > Integrity Verification . Review the status of your local KGV file.
: Manually import the file into the Catalyst Center Image Repository. This skips the metadata transaction requirement. While the main software image may download successfully,
This guide breaks down why this metadata transaction failure occurs and outlines actionable steps to resolve it. Root Causes of the Error
Use a secure file transfer protocol to move the image from your local computer or a local server to the switch's bootflash. Using SCP or SFTP is highly recommended for speed and security:
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:
Open a secure web browser and navigate directly to the Cisco Software Central portal. Select Import Image and opt for Via Source URL
It queries Cisco.com to pull the target image metadata, containing the file size, checksum, and an explicit transaction ID ( meta_trans_id ).
The system throws the invalid metadata_trans_id fault string due to the following background triggers:
The error message contains several clues pointing to the root cause. When a switch initiates a direct download, it establishes a secure connection to Cisco’s software download repositories, initiates a transaction ID ( trans-id ), and requests a metadata file detailing the target image's attributes (like size, checksum, and version).
The platform's internal microservices sometimes fail to pass correct proxy configurations during metadata synchronization calls. While the actual image binary might download via standard routing paths, the specific metadata handshake can bypass the configured corporate proxy, causing an immediate timeout or dropped connection at the firewall. Immediate Workarounds
From the NCS administrative CLI or GUI:
