Globus Connect Personal enables you to share and transfer files to and from your Linux laptop or desktop computer — even if it’s behind a firewall. Follow the easy steps below to turn your machine into a full-fledged Globus endpoint.

Prerequisites

Installation

Click here to create a Globus Connect Personal endpoint and follow the instructions below.

gcp-install-1
  1. Enter a name for your endpoint. This name can be anything you choose, as long as you haven’t previously created another endpoint with the same name.

  2. Click “Generate Setup Key”.

  3. Select the generated key with your mouse and copy it to the clipboard.

    gcp-linux-2
  4. Click "for Linux" to download the installer tarball.

  5. Extract the files from the downloaded tarball and run the installer:

    $ tar xzf globusconnectpersonal-latest.tgz
    $ cd globusconnectpersonal-n.m
    $ ./globusconnect &
  6. Since this is the first time you are running Globus Connect Personal, you will see the Initial Setup window below where you are required to enter a setup key.

    gcp-linux-3
  7. Paste in the key you generated in step 2 above. The "OK" button will be enabled if the key is valid. Click "OK" to complete the installation. (If the "OK" button is not enabled, please ensure you have properly copied the entire key generated in step 2 above.

Note:The configuration for Globus Connect Personal is stored in ~/.globusonline/lta. The unique host certificate is stored here and must be kept private. By default, it is not readable by any other user.

Running

Once the installation is complete, click the 'Connect' button to establish connection to Globus. You should see the status reflected below.

gcp-linux-4

The green light indicates that Globus Connect Personal is running properly and is connected to Globus. If you have any problems connecting to Globus, you may start the application from the command line using the -debug option (see more information on running from the command line here). You may minimize or hide this status window once Globus Connect Personal has connected successfully.

Removing Globus Connect Personal

  1. Be sure that all running instances of Globus Connect Personal are terminated by running this command:

    $ killall gc-ctrl.py
  2. Delete the old Globus Connect Personal install directory.

  3. Delete the old Globus Connect Personal config with this command:

    $ rm -r ~/.globusonline/
  4. Globus Connect Personal is now removed from your system.


How To Install Globus Connect Personal for Linux Using the Command Line

You may install Globus Connect Personal for Linux using only the command line. To install Globus Connect Personal you will need to be logged into the Globus CLI. If you don’t already have the Globus CLI installed, consult the getting started section of the Globus CLI documentation for installation and login instructions.

Installation

  1. Download and unpack the Globus Connect Personal for Linux installer:

    $ wget https://s3.amazonaws.com/connect.globusonline.org/linux/stable/globusconnectpersonal-latest.tgz
    --2013-06-07 00:14:10-- https://s3.amazonaws.com/connect.globusonline.org/linux/stable/glob...
    Resolving s3.amazonaws.com (s3.amazonaws.com)... 72.21.214.199
    Connecting to s3.amazonaws.com (s3.amazonaws.com)|72.21.214.199|:443... connected.
    HTTP request sent, awaiting response... 200 OK
    Length: 8291206 (7.9M) [application/x-tar]
    Saving to: `globusconnectpersonal-latest.tgz'
    
    100%[==============================================================================>] 8,291,206 1010K/s in 8.0s
    
    2013-06-07 00:14:18 (1018 KB/s) - `globusconnectpersonal-latest.tgz' saved [8291206/8291206]
    $ tar xzf globusconnectpersonal-latest.tgz
    $ cd globusconnectpersonal-x.y.z
    Note:In the last line above, replace x.y.z with the version number from the downloaded file, e.g. globusconnectpersonal-2.0.2.
  2. Generate a setup key for your endpoint via the Globus command line interface. The example below shows an already logged in Globus user generating a setup key for an endpoint called my-linux-laptop:

    $ globus endpoint create --personal my-linux-laptop
    Message:     Endpoint created successfully
    Endpoint ID: b19b3b45-01ae-11e6-a71c-22000bf2d559
    Setup Key:   224532bb-8a4b-4d32-8995-e1fb442be98e
  3. Now run the following command to complete the installation (note that you will need to copy and paste the setup key generated in step 2 above):

    $ ./globusconnectpersonal -setup 224532bb-8a4b-4d32-8995-e1fb442be98e
    Configuration directory: /home/demodoc/.globusonline/lta
    Contacting relay.globusonline.org:2223
    Installing certificate and key
    Creating /home/demodoc/.globusonline/lta/gridmap
    Done!
  4. Globus Connect Personal is now installed and your endpoint is configured. You should see your endpoint and be able to get its ID if you search for endpoints you own:

    $ globus endpoint search --filter-scope my-endpoints
    ID                                   | Owner                | Display Name
    ------------------------------------ | -------------------- | ----------------------------
    b19b3b45-01ae-11e6-a71c-22000bf2d559 | demodoc@globusid.org | my-linux-laptop

Running Globus Connect

To transfer and share files using Globus, start Globus Connect Personal as follows:

$ ./globusconnectpersonal -start &
[1] 2965

Your endpoint is now running and fully usable, which you can confirm with a globus ls command using the endpoint’s ID from above. Note that you do not need to activate the endpoint as Globus Connect Personal endpoints accept automatic activation based on your Globus credentials.

$ globus ls b19b3b45-01ae-11e6-a71c-22000bf2d559:/
home/

The status of Globus Connect Personal running in the background can be controlled using the -status or -trace options. The -trace option provides more detailed information:

$ ./globusconnectpersonal -status
Globus Online: connected
Transfer Status: idle
$ ./globusconnectpersonal -trace
gridftp 1
#gsissh connected
#gridftp 1
#gsissh connected
#gridftp 1
[...]