anchor.diff:  :nofooter:
   :markup-in-source: attributes+
   
  -== How to upload a file
  +== Multiple ways to upload files
  +
  +There are two supported technologies with the help of which files can be uploaded to DSP:
  +
  +1. tus.io
  +2. https://www.globus.org/[Globus]
  +
  +tus.io had always been the default way of uploading files. Getting started with it is relatively simple and requires
  +minimal configuration on users part. But uploading data through tus.io may seem slow, especially with large files.
  +This is due to infrastructure limitations which prevent tus uploads from getting high transfer speeds.
  +
  +If users wish to upload large data sets quickly then they should look into utilizing DSP's Globus file uploading support.
  +At EBI, Globus is among a few other supported technologies that allow for high speed file transfers.
  +The process for uploading files this way is slightly complicated and may even be impossible for individuals who
  +operate under strict organizational policies. For such users, it is advised that they upload their data using the first method.
  +
  +== Method#1 : How to upload a file
   
   1. Generate a new JWT (API) token to use with the file upload request. See above.
   2. Use the command line interface of the installed python client to send your file upload request.
  
positive.code: <<ref_file_upload.adoc#_how_to_get_a_list_of_files_by_a_given_submission,files>> APIs to see if DSP was able to locate
  the files or not.
  
  NOTE: Calling the notify endpoint will remove the files from user's Globus directory and move them to an internal staging area.
  Users are hereby advised not to get confused if they notice files disappearing from their Globus directory. If in doubt, use
  DSP's files API to see whether or not it appears in the list of files DSP has identified for a particular submission.
  
  === Share removal upon completion
  
  DSP automatically deletes the share as soon as it's last registered submission gets completed. If there are any files
  present in the directory at that time then they are deleted as well.
  
  NOTE: Users are advised to start uploading files after they have registered their submission by calling the share request endpoint.
  
negative.code: === Response
  include::{snippets}/create-globus-share/http-response.adoc[]
  
  NOTE: 1# Globus shares are a limited resource. The upload process has been specifically designed this way so that the shares
  are only created when there is data to be uploaded as part of the submission. In addition to that, to keep number of shares small,
  DSP *reuses* user's existing shares for all of their submissions that are still open i.e. that have the status DRAFT.
  
  NOTE: 2# Users may think that it is ok to request a share just once but that is not the case. This share request REST API not
  only creates a share but also *registers* a submission with the new or a pre-existing share. If a submission is not registered
  