Page History

...

1. Choose whether to upload synchronously (from your file system) or asynchronously (from a Globus endpoint). 
   • To upload from your file system, plan to use the source file parameter to specify the file that you want to upload.
   • To upload from Globus, plan to use a JSON file to specify the file that you want to upload. 

2. In your file system, create a JSON file that specifies the metadata for the new data file. The contents of this file depend on the source of your data:

   • If you are uploading from your file system, specify the metadata that you want to upload. Click the following link to view the syntax:

     Code Block
     collapse true
     { "metadataEntries": [ { "attribute": "description", "value": "my-dataObject-description" }, { "attribute": "my-second-attribute-name", "value": "my-second-attribute-value" } ] }

   • If you are uploading from Globus, specify the Globus endpoint, the file path on that endpoint, and the metadata that you want to upload. Click the following link to view the syntax:

     Code Block
     collapse true
     { "source": { "fileContainerId": "globus-shared-endpoint-uid", "fileId": "file-path-on-shared-globus-endpoint" }, "metadataEntries": [ { "attribute": "description", "value": "my-file-description" }, { "attribute": "my-second-attribute-name", "value": "my-second-attribute-description" } ] }

3. Run the following command:

   Code Block
   dm_register_dataobject <description.json> <destination-path> [source-file]

   The following table describes each parameter:

   Parameter	Description
   <description.json>	A path to a file in your file system. The contents of this file depend on the source of your data: If you are uploading from your file system, specify the metadata that you want to upload. Click the following link to view the syntax: Code Block collapse true { "metadataEntries": [ { "attribute": "description", "value": "my-dataObject-description" }, { "attribute": "my-second-attribute-name", "value": "my-second-attribute-value" } ] } If you are uploading from Globus, specify the Globus endpoint, the file path on that endpoint, and the metadata that you want to upload. Click the following link to view the syntax: Code Block collapse true { "source": { "fileContainerId": "globus-shared-endpoint-uid", "fileId": "file-path-on-shared-globus-endpoint" }, "metadataEntries": [ { "attribute": "description", "value": "my-file-description" }, { "attribute": "my-second-attribute-name", "value": "my-second-attribute-description" } ] }
   <destination-path>	A path within DME, including the name of the file you intend to upload. Specify where you want the system to create the new data file.
   [source-file]	A path to a file in your file system: If you are uploading from your file system, use this parameter to specify the file that you want to upload. If you are uploading from Globus, omit this parameter.

...