How-to: Install Globus CLI
- Lucas Crownover
- Mark Allen
What is Globus CLI?
Globus CLI allows you to programmatically transfer files. Globus CLI is installed on Talapas login nodes and accessed by running:
[marka@login2 ~]$ module load globus
You can also install Globus CLI on your laptop of lab server for use with Globus Personal Connect.
Below are instructions for installing on a Mac:
Globus CLI reference documentation, https://docs.globus.org/cli/reference/
Globus CLI installation documentation, https://docs.globus.org/cli/installation/
Install any prerequisites as needed. The installation uses pip and the full version of python3 is recommended, https://docs.globus.org/cli/installation/prereqs/
Here's the documentation to install python3 on a mac using the homebrew package manager, https://docs.python-guide.org/starting/install3/osx/#install3-osx
Install Globus CLI
pip install --upgrade --user globus-cli
Globus CLI examples
Globus Login
After running globus login in your terminal window, you will be directed to a web page to login with your UO credentials.
Marks-MacBook-Pro:~ marka$ globus login
You are running 'globus login', which should automatically open a browser window for you to login.
If this fails or you experience difficulty, try 'globus login --no-local-server'
---
You have successfully logged in to the Globus CLI!
You can check your primary identity with
globus whoami
For information on which of your identities are in session use
globus session show
Logout of the Globus CLI with
globus logout
Marks-MacBook-Pro:~ marka$ globus whoami
marka@uoregon.edu
Marks-MacBook-Pro:~ marka$ globus get-identities 'marka@uoregon.edu'
c7108429-4afb-44b0-9957-e28e56bdf396
List available commands
globus list-commands
Search for a Globus endpoint
Marks-MacBook-Pro:~ marka$ globus endpoint search Talapas
ID | Owner | Display Name
------------------------------------ | ------------------------------------------------------------ | ---------------
b4221f50-6dc5-11e9-bf46-0e4a062367b8 | uoregon@globusid.org | Talapas
Search for a Globus endpoint with filter
Display information about the Talapas endpoint
Activate/Authenticate against an endpoint
You will be directed to a web page to login with your UO credentials. Click 'Advanced' to enter credential lifetime.
Transfer file from one endpoint to another
For example, transfer a directory on my local macbook endpoint to an endpoint I've created on Talapas.
Note: A destination directory name is required. Also, $dest_ep has a 'Host Path' of /projects/hpcrcf/marka/testing/ this is not visible in the CLI command ouput 'globus endpoint show $dest_ep'
View tasks
globus task list
View only active tasks
globus task list --filter-status ACTIVE
Show details of a task