Retrieval action failed - Source file does not exist

Products

• CA Release Automation - Release Operations Center (Nolio)
• CA Release Automation - DataManagement Server (Nolio)

Issue/Introduction

A deployment is started in ROC, then immediately fails the first step.  Error states that artifact distribution has failed.  The following is then found in the nolio_dm_all.log:

[StageExecutorTask-30] ERROR (com.nolio.releasecenter.services.release.execution.engine.ArtifactPackageDistributionServiceImpl:552) - Artifact [ [YourArtifactName]'ver. [YourArtifactVersion]'] download to retrieval agent [AgentName] failed [Retrieval action failed - Source file does not exist - /PathToYourFile/FileName]

Environment

Release Automation - All versions

Cause

This problem occurs when the file artifact does not exist in the path specified. 

Resolution

This error can be resolved by verifying the path to the file artifact, making any changes as needed:

1. In ROC, navigate to Artifacts --> Artifact Management.
2. Select the artifact definition.
3. Select the artifact version.
4. Verify that the type selected for "Artifacts Source" is correct.
5. Verify the full path given for the artifact. This is likely incorrect when the above error occurs. 
   
   • Ensure the path given is on the correct server.
   • Navigate to artifact location manually and verify each folder of the path, checking for possible typos.
6. Verify all other fields for the artifact (which will vary depending on the artifact type).
7. After saving any changes, retest the deployment.