Globus #

Globus is a non-profit service for moving, syncing, and sharing large amounts of data asynchronously in the background. Transfers are done from and to, so called, Collections. In order to perform a file transfer from one location to another using the Globus service, both ends must have a Collection. UCSF has a site license for Globus, and several UCSF departments and services, including the Wynton HPC environment, provide Globus Collection. This will allow you to transfer and share data efficiently with any other Globus user in the world.

Setup of Globus Collections #

Set up a Globus Collection for your Wynton account #

If you want to transfer files from or to your Wynton account, you need to set up the ‘UCSF Wynton HPC’ Collection. Below is an outline on how to do this.

  1. [online] Go to Globus.org and log in with your UCSF MyAccess credentials. Then find the Collections menu on the left and click it. Then locate the ‘UCSF Wynton HPC’ collection and click ‘Activate’. This will ask you to enter your Wynton credential, i.e. your Wynton username and password. Optionally, limit the lifetime of this Collection by clicking ‘Advanced’ and select the number of hours you want it to be valid, e.g. 2 hours.

  2. [online] Go to Collections, go to the recently activated ‘UCSF Wynton HPC’ Collection, and click on ‘Open in File Manager’. This will display the files and folders on your Wynton account. If you don’t see anything, make sure to enter ~/ as the ‘Path’.

  3. [online] When no longer needed, make sure to ‘Deactivate Credentials’ for your ‘UCSF Wynton HPC’ Collection.

Globus for PHI Users #

To use the PHI Compatible Globus ‘UCSF Wynton PDT’ Collection, you must be signed up for Wynton Two-Factor Authentication.

Instead of using the non-PHI-compliant Collection ‘UCSF Wynton HPC’, all PHI data must use the PHI-approved Globus Collection ‘UCSF Wynton PDT’, which is associated with the pdt1 and pdt2 data-transfer nodes.

  1. Log in to Globus with your UCSF Campus ID.
  2. On the next screen, you will be notified ‘Authentication Required’.
  3. Select your identity.
  4. This will take you to a screen where you are prompted to enter your Wynton Username and Password. Enter these.
  5. Your default Two-Factor Authentication will be notified.
  6. Approve, and Globus will continue to a screen representing the Wynton file system.

Set up a Globus Collection for your local machine #

If you want to transfer files from or to your local machine, you need to set up a personal Collection on that machine. Below is an outline on how to do this. For full details, see the Globus Docs How To.

  1. [local] Make sure Globus Connect Personal is installed on your local machine (available for macOS, Linux, and MS Windows)

  2. [local] (optional) The default is that Globus will have access to all of the content under your home directory, e.g. when connected to Globus you will be able to browse it from the Global website online. To limit this, create a folder to be used solely for Globus transfers, e.g. ~/globus/. Launch the ‘Globus Connect Personal’ software, go to ‘Preferences’ and change the ‘Access Path Configuration’ to ~/globus. Then, click ‘Save’.

  3. [online] Setup a Globus Connect Personal (GCP) Collection for your local machine. Use one GCP collection per machine. This step will produce a GCP Security Key for your local machine. Make sure to write it down in a safe place. If you lose it, you will have to create a new GCP collection.

  4. [local] Launch the ‘Globus Connect Personal’ software, and enter your GCP Security Key code to connect.

  5. [online] Go to Collection -> ‘Administered by You’, go to on your GCP Collection, and click on ‘Open in File Manager’. This will display the files and folders on your local computer. If you restricted access to ~/globus (Step 2), then it is only that folder that is accessible via Globus.

  6. [local] In the Globus Connect Personal software, make sure to disconnect when no longer needed.

Transfer between Wynton and UCSF Box using UCSF Wynton HPC Box Globus Connector #

Prerequisites #

You must have:

Set up #

  1. Go to Globus.org and log in with your UCSF MyAccess credentials.

  2. In the “Collections” search field enter “UCSF Wynton HPC Box Connector”.

  3. Select the “UCSF Wynton HPC Box Connector” collection.

  4. You will see a dialog “Authentication Required”, click “continue”.

  5. Next you will see a dialog “Identity Required”. Select your UCSF associated identity, (it will be something like “123456@ucsf.edu”).

  6. Authenticate with MyAccess.

  7. A representation of your UCSF Box files will appear in the Globus panel.

  8. Log in to another Globus Collection to transfer files to or from your UCSF Box file repository to another collection.

Troubleshooting:

Transferring files #

To transfer files via the Globus network:

  1. Go to the Globus Online File Manager

  2. Specify the two Collections you wish to transfer files from and to.

  3. Select the files and folders to be transferred and click ‘Start’.

Collections of interest #