Install Globus Connect Personal
Log into DataHub, choose your preferred notebook environment (you may see one listing, or many), click on Launch Environment.
Open a new Terminal window: New >> Terminal.
Get the latest version of Globus Connect Personal. Run the following command in the Terminal window:
wget https://downloads.globus.org/globus-connect-personal/linux/stable/globusconnectpersonal-latest.tgz
Untar the .tgz file. Run the following command in the Terminal window:
tar -zxf globusconnectpersonal-latest.tgz
Run the following command to look at the new folder name. You should see both the .tgz and the extracted files listed, as in the image below:
ls -ltr
Run the following setup command in the Terminal window. You will be presented with a link to log into Globus (the link is rather long and copying it can be tricky. Clicking on it in the Terminal window will not successfully open the page). Current release is 3.2.2, but that may change as Globus updates the Globus Connect Personal client.
./globusconnectpersonal-3.2.2/globusconnectpersonal -setup
Globus uses CILogon to authenticate UC San Diego constituents. Choose University of California-San Diego from the drop down menu on the login page and click on Continue. You will then be prompted to authenticate using UC San Diego Single-Sign On Active Directory (AD) credentials and Duo.
If you haven't logged into Globus with your UC San Diego account before, you will be prompted to create a new account. Check out the Globus documentation to learn more about this.
Once logged in, you will prompted to allow the setup tool to work with your Globus account. You may change the default label text, then click on Allow.
Globus will return a code used to setup the endpoint. Copy and paste this code into the Terminal window at the prompt "Enter the auth code."
During setup, you'll be prompted for an endpoint name ("Input a value for the Endpoint name") Enter something pertinent, like UC San Diego DataHub. The long string returned is the UUID of your endpoint; you might use this later for scripting Globus tasks.
After setup, start the endpoint by running the following command:
./globusconnectpersonal-3.2.2/globusconnectpersonal -start &
If you want Globus Personal Connect to start automatically each time you open a Terminal, run this command. This adds the startup command to your profile. Globus Connect Personal checks to see if it is running, so it will only start once.
echo '$HOME/globusconnectpersonal-3.2.2/globusconnectpersonal -start &' >> .bash_profile
Starting Your Endpoint on DataHub
To start your endpoint, log back into DataHub, launch your notebook environment and open a Terminal (as above). This will read the line in your .bash_profile and start your personal endpoint.
Check that Globus Connect Personal is Running
Go the Globus Endpoints page and then select the tab Administered By You. You can also get to this page in the Globus web interface by choosing Endpoints from the left navigation.
A green notification will alert you that it is running properly:
Good - Green means the endpoint is running
Not good - Red means the endpoint is stopped–time to log into DataHub.
Transferring Data
To learn more about transferring data with Globus, check out their how-to.
Contact
For UC San Diego-specific questions, like setting up a managed endpoint or enabling the Globus High Assurance features, please contact research-it@ucsd.edu. For general Globus usage contact contact Globus support.
Last edited: May 3, 2022