Page History

This page describes how to register multiple files. For prerequisites when using Globus with DME, refer to Preparing to Use Globus with DME or Preparing to use Amazon Web Services S3 with DME. If you want to provide metadata for each object (data file) or collection, also refer to Preparing a Metadata File for Bulk UploadRegistration.

For a video of this procedure, refer to Video of Uploading Data in Bulk from Globus via the GUI or Video of Uploading Data in Bulk from S3 via the GUI. narrated slides demonstrating these instructions, refer to upload-Globus-slides.pptx.

To register data files:

1. Log in as described in Logging In via the GUI. The Dashboard appears.
2. Select a method: 
   
   • If you are not familiar with the data destination, browse for it, as described in Browsing for Data via the GUI. Navigate to and right-click the collection where you want to register your data files. Click Add Bulk (Globus). 
   • If you are familiar with the data destination, select this method: In the left panel, click Register > Bulk (Globus).
   The top portion of the Register Bulk Data page appears.
   Image Removed

3. Include Page
   shared step - select a bulk registration method shared step - select a bulk registration method

4. Specify the data source:

   To upload data from Globus:

    

   1. Select Globus and click Select Data from Globus Endpoint. A Globus page appears. 

   2. In Globus, select an endpoint.

   3. Select the files or folders that you want to
   upload to
   1. register into DME.
   2. Click Submit. The Register Bulk Data page
   re-appears, with information about your Globus selection at the bottom of the Data Source section.
5. To upload data from S3, select S3:
   • Specify the name of the source S3 bucket.
   • Specify the path to and the name of the file or folder in the source bucket. 
   • Specify whether you are uploading a file or a folder.
   • Specify the AWS access key.
   • Specify the AWS secret access key.
   • Specify the region

   Image Removed

6. Scroll down to the remaining data source fields. 
   Image Removed

7. 1. reappears, with the Globus endpoint ID and path. (Depending on your selections in Globus, the Register Bulk Data page might also list the selected data files or folders.)

   Image Added

8. Include Page
   shared step - select metadata file shared step - select metadata file

9. Include Page
   shared step - filter panel shared step - filter panel

10. Include Page
    shared step - remaining portions of the Register Bulk Data page shared step - remaining portions of the Register Bulk Data page

11. Include Page
    shared step - dry run GUI shared step - dry run GUI

12. Include Page
    shared step - click Register shared step - click Register

    Finish specifying the data source:

    FieldInstructionsInclude CriteriaUse patterns to specify the source files to include. If you specify more than one pattern, the system considers a union of all patterns. For details, refer to Specifying Criteria for Bulk Upload.Exclude CriteriaUse patterns to specify the source files to exclude. If you specify more than one pattern, the system considers a union of all patterns. For details, refer to Specifying Criteria for Bulk Upload.Criteria Type

    Specify the type of patterns in your criteria:

    • Simple: For details, refer to Specifying Criteria for Bulk Upload.
    • RegEx: For details, refer to the following page: https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html

      Multiexcerpt include
      MultiExcerptName ExitDisclaimer nopanel true PageWithExcerpt wikicontent:Exit Disclaimer to Include

    Dry RunIf you want to preview a list of the source file(s)/folder(s) that the system would register based on what you specified in the other Data Source fields, select this option. (This option tests only the Data Source entries. It does not test the Data Destination entries.)Bulk Metadata FileIf you want to provide required metadata for each object or collection, click Choose File. Navigate to and select the prepared metadata file. (For details, refer to Preparing a Metadata File for Bulk Upload.)Scroll down to the remaining portions of the Register Bulk Data page. If you browsed to the data destination, that portion of the page has only the Collection Path field, with the path already specified.  
    Image Removed

    If the Base Path and Collection Type fields are available, specify the data destination:

    Select the base path specified by your group administrator. An information icon (Image Removed) appears next to the Base Path field and the system begins to populate values in the Collection Type field and the Collection Path field.  
    Image RemovedConsider examining the valid hierarchies for the selected base path. To do so, click the information icon next to the Base Path field. A Valid Hierarchies chart appears indicating the collection type or types allowed within each collection type. In the chart, a check mark indicates each collection in which you can register data files. 
    Image Removed

    To close the Valid Hierarchies chart, click elsewhere on the page.

13. If there is more than one collection type, select the one in which you want to upload data. For guidance on selecting a collection type, refer to your group administrator. For some collection types, the system displays a list of required metadata attributes. 
Include Pageshared step - specify collection pathshared step - specify collection pathSpecify the collection metadata. The system applies this metadata to the entire collection, not to individual files:
Include Pageshared step - add metadatashared step - add metadata

If you change your mind about adding an attribute, leave the name and value fields blank for that attribute. The system ignores a blank row. If you proceed to update the collection with a new attribute, the attribute name is permanent.

Include Pageshared step - specify attribute valuesshared step - specify attribute values

Click Register. The system checks whether it can access the objects and collections you have specified, using the data you have entered:

14. If not, the system displays an error message. 
If so, the system responds based on your selections and displays a message at the top of the Register Bulk Data page:
15. If you selected the Dry Run option, the system displays a list of the source file(s)/folder(s) that it would have registered based on what you specified in the other Data Source fields. If necessary, revise your entries and click Register again until you are satisfied with the dry run list. When you are ready to perform the registration, clear the Dry Run option and click Register again.
Otherwise, the system displays a message with the task ID of the registration request. 
16. When the system displays the task ID, consider visiting the Upload clicking that link to visit the Data Registration Task Details page to page and view the progress of the uploadregistration. If you provided a metadata file, this page indicates any difficulty processing that metadata. For instructions, refer to Viewing Upload Statusto Viewing the Details of a Registration Task.