Page History

...

1. Prepare an S3 bucket, as described in Preparing to Use AWS S3 Bucket for the CLU. 

2. Consider whether you want to download a single collection or multiple collections: 

   • To download a single collection: Plan to specify the path for that collection in the command. 
   • To download multiple collections: In your file local system, use a command line editor (such as vi editor) to create a file that lists the paths for all of the DME collections you want to download, delimited by newline. Plan to use the -f option to specify that file in the command. 

3. Run the following command:
   
   

   Panel
   borderColor silver borderStyle solid
   Clipboard AllowLineWrap true (dm_download_collection_s3 [optional parameters] [DME data path] <destination S3 bucket> <destination-path> [AWS credentials file path])

   
   

   The following table describes each parameter:

   Parameter	Description
   [-D <REST-response>]	An optional parameter, specifying a path and filename in your file 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-collection-response-header.tmp in your home directory.
   [-o <output-json-file>]	An optional parameter, specifying a path and filename in your file 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-collection-response-message.json.tmp in your home directory. If the command is successful, the output file is empty.
   [-f <paths-file>] or [DME data path]	One or more paths within DME. Select one of the following methods to specify the collection or collections that you want to download: To specify multiple collections, use the -f parameter to specify a path and filename in your file local system, of a file that lists the paths for all of the DME collections you want to download, delimited by newline. To specify a single collection, specify the path for the DME collection you want to download.
   <destination S3 bucket>	The name of the destination S3 bucket.
   <destination path>	The path to and the name of the folder in the destination bucket. Do not begin the path with a slash. If the destination folder structure you specify does not already exist, DME creates it.
   [AWS credentials file path]	The location of the credentials file. 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.

...