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, endpoints. In order to perform a file transfer from one location to another using the Globus service, both ends must have an endpoint. UCSF has a site license for Globus, and several UCSF departments and services, including the Wynton HPC environment, provide Globus endpoints. This will allow you to transfer and share data efficiently with any other Globus user in the world.

Setup of Globus endpoints #

Set up a Globus endpoint 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’ endpoint. 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 Endpoints menu on the left and click it. Then locate the ‘UCSF Wynton HPC’ endpoint 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 endpoint by clicking ‘Advanced’ and select the number of hours you want it to be valid, e.g. 2 hours.

  2. [online] Go to Endpoints, go to the recently activated ‘UCSF Wynton HPC’ endpoint, 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’ endpoint.

Set up a Globus endpoint for your local machine #

If you want to transfer files from or to your local machine, you need to set up a personal endpoint 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) endpoint for your local machine. Use one GCP endpoint 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 endpoint.

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

  5. [online] Go to Endpoints -> ‘Administered by You’, go to on your GCP endpoint, 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.

Transferring files #

To transfer files via the Globus network:

  1. Go to the Globus Online File Manager

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

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

Globus for PHI Users #

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

Instead of using the non-PHI-compliant endpoint ‘UCSF Wynton HPC’, all PHI data must use the PHI-approved Globus endpoint ‘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.

Endpoints of interest #