Globus - Quick start

Body

Getting started with Globus

These instructions are intended to help one get started with the Globus client on a Linux server (or workstation) in the College of Medicine, allowing connections to Globus endpoints. In our examples here, we'll be using RCC's gpfs. Instructions are picked out of https://docs.globus.org/cli/ and https://docs.globus.org/cli/quickstart/, with our emphasis on getting started quickly.

If the first step (installing pipx) fails, ask IOPS to install pipx on the host in question. (This is installed on the Mousa lab server).

The Globus client should be installed per-user; this allows flexibility of installing packages without having to request intervention from the sysadmins.

  • Have you ever used Globus on this host before? If so, run pipx install globus-cli. (Running this command a second time will not harm anything).
  • If you run which globus, you'll see proof that the client is installed--and in your home directory (other users will not see this unless they also install it).
    • [mhohmeister@medbfs-p3a-001 ~]$ which globus
      ~/.local/bin/globus
  • Run globus by itself to see all possible commands.

Now we have to log into Globus.

  • Run globus login, and you'll be presented with a very long URL. Copy and paste this into any Web browser.

    • [mhohmeister@medbfs-p3a-001 ~]$ globus login
      Please authenticate with Globus here:
      ------------------------------------
      https://auth.globus.org/v2/oauth2/authorize?client_id=redacted&redirect_uri=https%3A%2F%2Fauth.globus.org%2Fv2%2Fweb%2Fauth-code&scope=openid+profile+email+urn%3Aglobus%3Aauth%3Ascope%3Aauth.globus.org%3Aview_identity_set+urn%3Aglobus%3Aauth%3Ascope%3Atransfer.api.globus.org%3Aall+urn%3Aglobus%3Aauth%3Ascope%3Agroups.api.globus.org%3Aall+urn%3Aglobus%3Aauth%3Ascope%3Asearch.api.globus.org%3Aall+https%3A%2F%2Fauth.globus.org%2Fscopes%2Fredacted%2Ftimer%5Burn%3Aglobus%3Aauth%3Ascope%3Atransfer.api.globus.org%3Aall%5D+https%3A%2F%2Fauth.globus.org%2Fscopes%2Fredacted%2Fmanage_flows+https%3A%2F%2Fauth.globus.org%2Fscopes%2Fredacted%2Fview_flows+https%3A%2F%2Fauth.globus.org%2Fscopes%2Fredacted%2Frun+https%3A%2F%2Fauth.globus.org%2Fscopes%2Fredacted%2Frun_status+https%3A%2F%2Fauth.globus.org%2Fscopes%2Fredacted%2Frun_manage&state=_default&response_type=code&access_type=offline&prompt=login
      ------------------------------------

      Enter the resulting Authorization Code here:

    • You'll be prompted to select your institution; use "Florida State University"; click Continue.

    • The browser will return a native app authorization code; copy and paste this into your terminal where prompted.

      • Tip: FSU's Globus login uses CAS. If your browser already has you authenticated via CAS, you'll be taken straight to the below screenshot; otherwise, you'll get the CAS login prompt. Use your FSUID, password, and 2FA.

    • If the login was successful, you'll be greeted with this and returned to a Linux command prompt:

      Enter the resulting Authorization Code here: skredactedmy

      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

    • Running the commands listed in the welcome message, you'll see proof that you're the logged-in user:

      [mhohmeister@medbfs-p3a-001 ~]$ globus whoami
      For information on which identities are in session see
        globus session show

      mhohmeis@fsu.edu
      [mhohmeister@medbfs-p3a-001 ~]$ globus session show
      For information on your primary identity or full identity set see
        globus whoami

      Username         | ID                                   | Auth Time
      ---------------- | ------------------------------------ | --------------------
      mhohmeis@fsu.edu | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx | 2025-04-04 11:56 EDT

Getting started with Globus Connect Personal

The above instructions for the Globus CLI are for endpoint-to-endpoint transfers. If we wish to download data to a server, we'll have to use Globus Personal, per these instructions (tailored to Linux command-line). Official instructions may be found at https://docs.globus.org/globus-connect-personal/install/linux/.

Download Globus Personal: wget https://downloads.globus.org/globus-connect-personal/linux/stable/globusconnectpersonal-latest.tgz

Extract the downloaded tarball: tar xzf globusconnectpersonal-latest.tgz

cd globusconnectpersonal-3.2.6/ (Version may vary)

Run ./globusconnectpersonal, and you'll be prompted to visit a specific URL for an auth code; do this.

You'll be prompted to Input a value for the Endpoint Name:; we recommend using the server name, such as medbfs-p3a-001.

You'll receive confirmation of a successful start:

registered new endpoint, id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
setup completed successfully

Will now start globusconnectpersonal in GUI mode
Graphical environment not detected

To launch Globus Connect Personal in CLI mode, use
  globusconnectpersonal -start

Or, if you want to force the use of the GUI, use
  globusconnectpersonal -gui

The machine we used to write these instructions has no GUI, so this is focused on the command line.

To run globusconnectpersonal, you'll have to either be in its directory, or type its path; for example: globusconnectpersonal-3.2.6/globusconnectpersonal. To start Globus Connect Personal, start it as a background process with &; for example, globusconnectpersonal-3.2.6/globusconnectpersonal -start &.

You may now test this with globus endpoint local-id, which will show you your endpoint ID; also, globus ls "$(globus endpoint local-id)" will show your local home directory.