Updated 2021-01-14

Using Globus to Transfer Files

Note

If you are looking for instructions on using the globus-url-copy command line tool, please visit the globus-url-copy Command Line Tool page.

Why use Globus?

  • PACE provides free access
  • Has a graphical web-based interface
  • Provides the option to encrypt files
  • Secure file transfer handles even protected data like HIPAA regulated data
  • Automatically resumes file transfer if system goes offline once it comes back online
  • Globus is the fastest and most effecient file transfer option, especially for large transfers

Step 1: Making an account

  • Georgia Tech already provides accounts, so all you have to do is sign in with your Gatech information
  • Go to https://www.globus.org/ and click Log In
  • Search for and select "Georgia Institute of Technology", you will then be taken to the Gatech login page
  • After logging in with your GT credentials, you will be redirected to the main file transfer screen

Step 2: Installing the Globus Personal Client

  • The Globus Connect Personal Client is how Globus will have access to your files
  • After installing the personal client, you will have to set up your computer as an endpoint to allow files to be transfered to and from it
  • Log in to Globus then follow these well documented guides on how to install the Globus Personal Client and set up an endpoint:

  • The above guides should also cover how to setup your personal endpoint (also referred to as a collection). A personal endpoint is simply your personal computer that you want to share files from. You should see a screen such as the one below during the globus connect personal setup:

Screenshot

  • Tip: By default globus will only have access to a very limited number of folders on your computer (usually only /documents). To make more folders accesible to globus, right click the globus connect personal icon, then select options and click the + sign to add folder paths.

Screenshot

Note

Linux Tips: - Linux is a bit tricky, after using tar to extract the files, if ./globusconnect & gives errors about tcllib, skip to the part of the guide titled "How to Install Globus Connect Personal for Linux Using the Command Line" and follow that. Try ./globusconnectpersonal -start & if ./globusconnect & doesnt work - Linux: Globus also has a standalone command line tool, globus-cli which needs to be installed on Linux if you are installing the personal client through the command line

Step 3: Set Endpoints for transfer

Important

Make sure the Globus Personal Client is running on your computer

  • After you have setup your personal endpoint and globus personal connect, Log into globus, and you will be taken to the main file manager screen

Screenshot

  • To set up your computer as one endpoint:
  • Click on the Collection Bar at the top
  • Click on "Your Collections"
    • if you set up your endpoint correctly following the documentation linked above, the endpoint you created should show up
    • select it and you should be taken back to the file manager page, with your computer's files available to transfer showing up on the left

Screenshot

  • Next, set the cluster as the other endpoint:
  • Click "Transfer or Sync to" which should shift the panel view to the right
  • Select "collection" bar on the right (next to the collection bar you just used on the left)
  • Search for "PACE"
    • PACE Phoenix: For file transfer between the Phoenix Cluster, select the 'PACE Phoenix' tile which should be green
    • PACE Hive: For file transfer between the Hive Cluster, select the 'PACE Hive' tile which should also be green

Screenshot

  • You will be prompted for a authentication, with the domains where you have access. Click on Continue

Authentication required

  • After you click continue, options for identification will be displayed. Select your email to continue with your PACE credentials.
  • You will be presented with the usual GT authentication. Follow the prompts and enter your password and duo information. Select Allow for the prompts.
  • Your cluster account and all your files on the cluster should now show up, ready for file transfer

Screenshot

  • You can now transfer files between your account on the cluster and your personal computer

Tip

After the first time setting the endpoints, they will be saved under recent, so you can easily select them. The Globus Personal Client must be running before setting any endpoints

Transfer files and folders

  • Select the folder / file you want to transfer
  • Select Transfer or Sync to... on the menu in the middle
  • Select the folder you want to transfer to
  • Select one of the Start button at the bottom of the screen, with the arrow direction corresponding to the direction of transfer (i.e personal machine to cluster or cluster to personal machine)
  • Status of the transfer can be viewed in Activity located in the menu on the left (click on top left corner if it isnt shown")
  • Globus should send you an email when the transfer is complete
  • Example: Here I have selected the win-library folder on my laptop and my data folder on the cluster
  • Transfer from my laptop to the cluster: To transfer the win-library folder to the cluster, I would select the start arrow in the bottom left
  • Transfer from the cluster to my laptop: To transfer my data folder from the cluster to my laptop, I would select the start arrow in the bottom right

Screenshot

Using Globus Recap

Warning

Always make sure the Globus Personal Client is running before you go to transfer files

  1. Start globus personal client (using its program gui if on Windows or Mac)
    • On linux, navigate to where you installed the globuspersonalclient files, cd globuspersonalclient-x.y.z (x.y.x is version number) and then run ./globusconnectpersonal -start &
  2. Log into Globus, you should then be directed to the main file manager page. Other pages including activity page and endpoint manager are available in the drop down menu on the left (click top left if the menu is not visible)
  3. To set your personal machine as an endpoint, click on the "collection" bar on the top left (on file manager page), select your personal computer name (personal endpoint name you made). It should be under "recents" or in "your collections". To set the cluster as the other endpoint, click on the collection bar on the top right, search for PACE -> select PACE Phoenix or PACE Hive. Log in with your GT username and password. Endpoints should also show up in your recent endpoints.
  4. You can now transfer files and folders as you wish. Monitor transfer status with the Activity tab
  5. When you are done transfering files, logout of globus online, and logout of the personal client on you computer. For linux to logout run globus logout