Retrying a Failed or Canceled Download via the CLU

Sometimes a download fails due to network issues or other issues. Sometimes, you might decide to cancel a download in progress, as described in Viewing the Details of a Download Task. In these cases, consider the following steps: 

1. Check the status of your task, as described in Viewing Download Status. Copy the ID of the task that you want to retry.

2. Run one of the following commands: 

   dm_download_dataobject-retry [optional parameters] <task ID> <endpoint type> <Aspera credentials file> <AWS credentials file>

   dm_download_collection-retry [optional parameters] <task ID> <endpoint type> <Aspera credentials file> <AWS credentials file>

   dm_download_list-retry [optional parameters] <task ID> <endpoint type> <Aspera credentials file> <AWS credentials file>

   
   

   The following table describes each parameter:

   Parameter	Description
   [-D <REST-response>]	An optional parameter, specifying a path and filename in your local system. The system always creates a response file: If you specify this parameter, the system saves the response from the server to the specified file in the specified location. If you omit this parameter, the system saves the file as download-dataobject-response-header.tmp in your home directory.
   [-o <output-json-file>]	An optional parameter, specifying a path and filename in your local system. The system always creates an output file: If you specify this parameter, the system saves the output to the specified file in the specified location. If you omit this parameter, the system saves the output as download-dataobject-response-message.json.tmp in your home directory. If the command is successful, the output file is empty.
   <task ID>	Specify the ID of the task you want to retry.
   <endpoint type>	Specify the type of the endpoint: globus for Globus s3 for AWS S3 bucket aspera for dbGaP
   <Aspera credentials file>	If downloading to an Aspera endpoint, specify the full path of the Aspera credentials file in your local system.
   <AWS credentials file>	If downloading to an S3 endpoint, specify the full path of the AWS credentials file in your local system. If your credentials file is in the default location, as noted in Preparing to Use AWS S3 Bucket for the CLU, you can omit this parameter.

The following example retries the specified Globus task.