How to Transfer Large Files to Atlassian

This document describes how to transfer files using Atlassian's transfer file server. Typically, this occurs during troubleshooting a complex issue in the process of tech support.

Atlassian's file service, transfer.atlassian.com, allows for the direct transmission of files to Atlassian through a web browser. This document will explain how to access this service, how to prepare your data for transmission, and how to use the transfer.atlassian.com web interface.

On this page:

How to transfer a file

  • transfer.atlassian.com has 50GB file size limit and we recommend you compress and/or split very large files. See how to compress a file and how to split a file for more info.
  • This document assumes you have an open support request.  See How to gain access for more info on how to log in.
  • You can transfer the file via your browser, or via the command line using the REST API.
  • Files that were attached to a support issue will be removed in 60 days after resolving the support issue in accordance with Support File Retention Policy.

To transfer a file via your browser:

  1. In your browser, go to transfer.atlassian.com. Follow the prompts to log in using your Atlassian account. 

  2. Your open support requests will be listed. Choose Add Attachments



  3. Follow the prompts to upload your files.



  4. Once the transfer completes successfully, check that the file size listed matches the size of the local copy of the file.



  5. Repeat steps 2 & 3 for each file that needs to be uploaded.
  6. Your support.atlassian.com issue will be updated each time a file has been uploaded. Once all your files have been uploaded, add a comment to your support ticket to let the support engineer know you're done uploading files. 

To transfer a file using via the command line:

  1. After logging in to transfer.atlassian.com, choose Auth Tokens in the header to generate an authentication token. 

  2. Use the example CURL command generated by filling the auth token you generated and your file access path to upload your file to this ticket as follows:

    curl --progress-bar -u NWMzNzcwY:xyz123 -X POST \
        -F "files[]=@/var/atlassian/confluence/export/Confluence_support_2017-10-12-13-29-42.zip" \
        -F "files[]=@/var/atlassian/confluence/export/thread_dumps.zip" \
        https://transfer.atlassian.com/api/upload/PS-12345 | tee /dev/null

 transfer.atlassian.com is available for all of your open cases, so you can use it at any time



How to get access

If you need to transfer a large file or files to Atlassian, you will need to first create a support request at support.atlassian.com. Once you've created a request, you'll be able to log in to transfer.atlassian.com and upload files against your support issue. 

How to compress data

To minimize bandwidth usage, compress the file into a .ZIP, .GZ, or .TAR.GZ file. (This will also help minimize the opportunity for your connection to drop-out in the middle of a large transfer!)

Linux

In Linux, the tar command works well for this purpose:

$ tar czf ~/jiradb.tar.gz ~/jiradb
Windows or Mac

In Windows or OS X, right clicking on a folder offers a compression mechanism.

How to split data into smaller pieces

Although transfer.atlassian.com has a file size limit 50GB, we recommend limiting files to 1GB in size. This minimizes the window of opportunity for the upload process to fail, and, (in case of a failed upload,) minimizes the time spent re-uploading the same information multiple times.

Linux or Mac

The split command will allow you to break up a file into multiple chunks of a specified size. In the example below, the compressed "jiradb" file is broken into multiple segments <= 1GB in size:

$ split -b 1073741824 ~/jiradb.tar.gz jiradb.tar.gz_
$ ls -l | grep jira
-rw-r--r--    1 user  staff  1073741824 Mar 27 12:03 jiradb.tar.gz_aa
-rw-r--r--    1 user  staff  1073741824 Mar 27 12:03 jiradb.tar.gz_ab
-rw-r--r--    1 user  staff   412536832 Mar 27 12:03 jiradb.tar.gz_ac

The "-b" argument specifies the maximum file size of each segment in bytes. (1073741824 bytes = 1GB) ~/jiradb.tar.gz is the input filename, and jiradb.tar.gz_ is the output filename. By default, the split command appends a two letter code to the end of the specified output filename to indicate the order of the segments. In this case, specifying the "jiradb.tar.gz_" filename resulted in the following sequential segments: jiradb.tar.gz_aa, jiradb.tar.gz_ab, and jiradb.tar.gz_ac. All three of these files will need to be uploaded to transfer.atlassian.com.

Be sure to review your operating system's documentation to be sure you use this tool correctly.

To merge/join the files, you may explore the example below:

$ cat jiradb.tar.gz_* > jiradb.tar.gz
$ tar -cvvzf jiradb.tar.gz .

Windows

Use HJ-Split's split function.

Last modified on Oct 31, 2019

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.