Overview
There are many different ways to access or transfer your data from your ASU Research Computing (ASURC) account from or to elsewhere. One very convenient way is to use Globus.
Before Globus may be used, certain objects affiliated with your account and linked to paths on the filesystem, called collections, must be created. These collections are generated from ASURC “Managed Mapped Collections.”
Currently, five classes of collections may be created. These collections then allow for transferring data to or from your Agave Home directory, Scratch directory, project-based storage directory, legacy mounted storage directory, or your /wiki/spaces/RC/pages/201490433
This page outlines the steps necessary to create the collections from the five managed endpoints.
Globus may make subtle changes to the setup process that date this configuration guide. We host workshops for setting up Globus every two months (^^Educational Opportunities and Workshops) and are more than happy to schedule a one-on-one meeting to assist in the setup. Our weekly office hours are also an excellent resource for any technical assistance.
Configuring Globus
Sign into globus.org using ASU CILogin
Click
Collections
from the left navigation barSearch all endpoints for
ASURC Agave
. This involves filling out a search bar in the upper right of the web view.The five relevant managed mapped collection results will come up like in figure 1 below, and clicking on a collection will produce a new webview detailing the specific collection. Note that the Note that the figure and this text are hyperlinks to the search results.
After selecting a managed mapped collection, view, select the
Collections
tab, and then select theAdd a Guest Collection
button from the interface. The following subitem names are shortcut links directly to the new collection creation pages:ASURC Agave Scratch: for access to
/scratch
mountsASURC Agave Home: for access to
/home
mountsASURC Agave Google Drive: for access to ASU provided Google drives
ASURC Agave Data Directories: for access to
/data
mounts (project-based storage)ASURC Agave Mnt Directories: for access to legacy
/mnt
mounts
For each collection, only two fields have to be supplied:
the base directory: see the specific instructions section below (tl;dr:
/<username
for home and scratch,/
for Google drive, and be specific for the data and legacy mount collections).a display name:
<username>-agave-<collection_type>
is a recommend style, where<username>
should be replaced by your username on the Agave system (likely your asurite) and<collection_type>
should be replaced by eitherscratch
,home
,drive
,data
, orlegacymnt
.additionally, you’ll need to follow the on-screen instructions to provide Globus with formal permission to access your files and Google drive.
Specific instructions for “ASURC Agave Scratch” and “ASURC Agave Home”
For the base directory, specify /<username>
, where <username>
should be replaced by your username on the Agave system (likely your asurite).
Specific instructions for “ASURC Agave Google Drive”
For the base directory, specify /
, which will allow you to access your entire Google drive filesystem from within Globus, including your “My Drive” and “Team Drives” (shared drives).
Specific instructions for “ASURC Agave Data Directories” and the legacy mount
For the base directory, specify /<mount-name>
. For instance, if your lab has 50 TB of space in /data/mylab
, you may connect it with /mylab
specified as the base directory.
Post Configuration
Once created, a user may find their own collections through a variety of means, including through the File Manager
view and Bookmarks
view.
Finding Collections in the Bookmarks view
Navigate to the
Bookmarks
view by selecting theBookmarks
icon from the left navigation bar.Select the
Collections
tab.
Finding Collections in the File Manager view
Navigate to the
File Manager
view by selecting theFile Manager
icon from the left navigation bar.Click within the uppermost search bar, as indicated by “Collection” and a magnifying glass icon followed by the word, “Search”.
Find your collection within the
Collections
tab.
Time for Transfers
Select two collections within the
File Manager
view.Find the vertical menu item
Transfer or Sync to...
If just a single collection is active (single pane view), the option will be on the right of the screen
If two collections are active in a dual pane view, the option will be in between the collections
Select the files/directories from you want to transfer (single click to select, double click to navigate)
Select the
Transfer & Sync Options
(figure 2)SELECT OR VERIFY that
sync - only transfer new or changed files
is enabled (figure 3)Click
Start ->
to transfer from the “left” pane collection to the “right” or<- Start
for the opposite.Jump for Joy (optional)
Failing to ensure that the transfer is a sync
operation may result in files that were already transferred being re-transferred to the destination. Enabling sync
pragmatically improves transfer efficiency.
While transferring (syncing) data, do not delete or move files or directories out of the host filesystem. Such actions may slow an active transfer significantly. At the start of a transfer, Globus cultivates a list of files and directories to transfer from host to target. When paths within that list no longer exist, Globus throws a warning and seemingly loops in an attempt to find that path. If filesystem changes must be made, wait for the transfer to finish (or stop the transfer), make the filesystem changes, and then resubmit the transfer as a sync
.
Advanced Technical Notes
Globus provides a command-line tool that is powered by python. Instructions for the Globus command-line tool are provided here (https://docs.globus.org/cli/), but please use pip install globus-cli
from within an Anaconda environment /wiki/spaces/RC/pages/125829137.
Additional Help
If you require further assistance on this topic, please contact the Research Computing Team. To create a support ticket review our RTO Request Help page. For quick inquiries, reach out via our #rc-support Slack Channel or attend our office hours for live assistance. We also offer a series of Educational Opportunities and Workshops.